Theme bridge to v5.0.0

apps/css-workshop/astro.config.mjs

@@ -1,5 +1,6 @@
 import { defineConfig } from 'astro/config';
 import relativeLinks from 'astro-relative-links';
+import react from '@astrojs/react';
 
 // https://astro.build/config
 export default defineConfig({
@@ -13,5 +14,5 @@ export default defineConfig({
   server: {
     port: 3050,
   },
-  integrations: [relativeLinks()],
+  integrations: [relativeLinks(), react()],
 });

apps/css-workshop/package.json

@@ -11,7 +11,12 @@
     "astro": "^4",
     "astro-relative-links": "^0.3.7",
     "backstopjs": "~6.2.1",
-    "npm-run-all": "^4.1.5"
+    "npm-run-all": "^4.1.5",
+    "@astrojs/react": "^4.1.2",
+    "@types/react": "^18",
+    "@types/react-dom": "^18",
+    "react": "^18",
+    "react-dom": "^18"
   },
   "scripts": {
     "dev": "astro dev",

apps/css-workshop/src/components/theme.js

@@ -19,6 +19,8 @@ class ThemeButton extends HTMLElement {
             <label tabindex="-1"><input type="radio" name="theme" value="dark" /><span>Dark</span></label>
             <label tabindex="-1"><input type="radio" name="theme" value="light-hc" /><span>High contrast light</span></label>
             <label tabindex="-1"><input type="radio" name="theme" value="dark-hc" /><span>High contrast dark</span></label>
+            <br />
+            <label tabindex="-1"><input type="checkbox" name="theme-bridge" /><span>Theme Bridge</span></label>
           </fieldset>
 
           <fieldset>
@@ -137,16 +139,26 @@ class ThemeButton extends HTMLElement {
     this.shadowRoot.querySelector(
       `input[value=${prefersDark ? 'dark' : 'light'}${prefersHC ? '-hc' : ''}`,
     ).checked = true;
-    document.body.dataset.iuiTheme = prefersDark ? 'dark' : 'light';
-    document.body.dataset.iuiContrast = prefersHC ? 'high' : undefined;
-    document.body.classList.toggle('iui-root', true);
+
+    const root = document.body;
+    const v5Root = document.documentElement;
+    const theme = prefersDark ? 'dark' : 'light';
+
+    root.dataset.iuiTheme = theme;
+    v5Root.dataset.colorScheme = theme;
+    root.dataset.iuiContrast = prefersHC ? 'high' : undefined;
+    root.classList.toggle('iui-root', true);
   }
 
   changeTheme = ({ target: { value: _theme } }) => {
+    const root = document.body;
+    const v5Root = document.documentElement;
+
     const isHighContrast = _theme.endsWith('-hc');
     const theme = isHighContrast ? _theme.split('-')[0] : _theme;
-    document.body.dataset.iuiTheme = theme;
-    document.body.dataset.iuiContrast = isHighContrast ? 'high' : undefined;
+    root.dataset.iuiTheme = theme;
+    v5Root.dataset.colorScheme = theme;
+    root.dataset.iuiContrast = isHighContrast ? 'high' : undefined;
     this.shadowRoot.querySelector('#theme-color-scheme').innerHTML = `
       :host {
         color-scheme: ${theme.includes('light') ? 'light' : 'dark'};
@@ -162,6 +174,10 @@ class ThemeButton extends HTMLElement {
     }
   };
 
+  changeBridge = ({ target: { checked } }) => {
+    document.body.dataset.iuiBridge = checked ? 'true' : 'false';
+  };
+
   connectedCallback() {
     this.shadowRoot.querySelectorAll('input[name="theme"]').forEach((radio) => {
       radio.addEventListener('change', this.changeTheme);
@@ -170,6 +186,10 @@ class ThemeButton extends HTMLElement {
     this.shadowRoot.querySelectorAll('input[name="background"]').forEach((radio) => {
       radio.addEventListener('change', this.changeBackground);
     });
+
+    this.shadowRoot
+      .querySelector('input[name="theme-bridge"]')
+      .addEventListener('change', this.changeBridge);
   }
 
   disconnectedCallback() {
@@ -180,6 +200,10 @@ class ThemeButton extends HTMLElement {
     this.shadowRoot.querySelectorAll('input[name="background"]').forEach((radio) => {
       radio.removeEventListener('change', this.changeBackground);
     });
+
+    this.shadowRoot
+      .querySelector('input[name="theme-bridge"]')
+      .removeEventListener('change', this.changeBridge);
   }
 }
 customElements.define('theme-button', ThemeButton);

apps/css-workshop/src/pages/_layout.astro

@@ -1,4 +1,6 @@
 ---
+import { Root as ITwinUIV5Root } from '@itwin/itwinui-react-v5/bricks';
+
 type Props = { title?: string };
 const { title } = Astro.props;
 
@@ -39,6 +41,7 @@ const slug = Astro.url.pathname.replace('/', '');
     <link rel='canonical' href=`https://itwin.github.io/iTwinUI/${slug}` />
 
     <style is:global>
+      @layer reset, kiwi, variables, itwinui;
       @import '/assets/demo.css' layer(demo);
       @import '@itwin/itwinui-variables' layer(variables);
       @import '@itwin/itwinui-css/css/all.css';
@@ -51,6 +54,7 @@ const slug = Astro.url.pathname.replace('/', '');
   </head>
 
   <body class='iui-root' data-iui-theme>
+    <ITwinUIV5Root client:load colorScheme='dark' density='dense' />
     <theme-button></theme-button>
     <slot />
   </body>

apps/css-workshop/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "astro/tsconfigs/base",
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "jsxImportSource": "react"
+  }
+}

apps/react-workshop/.ladle/components.tsx

@@ -3,23 +3,24 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
-import { ThemeProvider } from '@itwin/itwinui-react';
 import {
   useLadleContext,
   ActionType,
   ThemeState,
   type GlobalProvider,
 } from '@ladle/react';
-import '@itwin/itwinui-variables';
-import '@itwin/itwinui-react/styles.css';
 import './global.css';
+import '@itwin/itwinui-react/styles.css';
+import { ThemeProvider } from '@itwin/itwinui-react';
+import { Root as ITwinUiV5Root } from '@itwin/itwinui-react-v5/bricks';
 
 const prefersDark = matchMedia('(prefers-color-scheme: dark)').matches;
 
 export const Provider: GlobalProvider = ({ children }) => {
   const { globalState, dispatch } = useLadleContext();
   const theme = globalState.theme === 'dark' ? 'dark' : 'light';
   const highContrast = globalState.control?.['high-contrast']?.value;
+  const futureThemeBridge = globalState.control?.['future.themeBridge']?.value;
 
   // default to OS theme
   React.useLayoutEffect(() => {
@@ -31,11 +32,12 @@ export const Provider: GlobalProvider = ({ children }) => {
 
   // propagate theme to <html> element for page background
   React.useLayoutEffect(() => {
+    document.documentElement.dataset.colorScheme = theme;
     document.documentElement.dataset.iuiTheme = theme;
     document.documentElement.dataset.iuiContrast = highContrast
       ? 'high'
       : 'default';
-  }, [theme, highContrast]);
+  }, [theme, highContrast, futureThemeBridge]);
 
   // redirect old storybook paths to new ones
   React.useEffect(() => {
@@ -51,12 +53,20 @@ export const Provider: GlobalProvider = ({ children }) => {
 
   return (
     <React.StrictMode>
-      <ThemeProvider
-        theme={theme}
-        themeOptions={{ applyBackground: false, highContrast }}
-      >
-        {children}
-      </ThemeProvider>
+      <ITwinUiV5Root colorScheme={theme} density='dense'>
+        <ThemeProvider
+          theme={theme}
+          themeOptions={{
+            applyBackground: false,
+            highContrast,
+          }}
+          future={{
+            themeBridge: futureThemeBridge,
+          }}
+        >
+          {children}
+        </ThemeProvider>
+      </ITwinUiV5Root>
     </React.StrictMode>
   );
 };
@@ -74,4 +84,8 @@ export const argTypes = {
     control: { type: 'boolean' },
     defaultValue: false,
   },
+  'future.themeBridge': {
+    control: { type: 'boolean' },
+    defaultValue: false,
+  },
 };

apps/react-workshop/.ladle/global.css

@@ -3,6 +3,10 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 
+@layer reset, kiwi, variables, itwinui;
+
+@import '@itwin/itwinui-variables' layer(variables);
+
 @import '@fontsource/noto-sans';
 @import '@fontsource/noto-sans-mono';
 @import '@fontsource/noto-sans/400-italic.css';

apps/react-workshop/package.json

@@ -8,6 +8,7 @@
     "@fontsource/noto-sans-mono": "5",
     "@itwin/itwinui-icons-react": "2.8.0",
     "@itwin/itwinui-variables": "*",
+    "@itwin/itwinui-react-v5": "npm:@itwin/[email protected]",
     "@itwin/itwinui-react": "*",
     "@ladle/react": "^4.1.2",
     "@types/node": "*",

packages/itwinui-css/src/all.scss

@@ -57,3 +57,7 @@
   @include meta.load-css('utils/utils');
   @include meta.load-css('workflow-diagram/workflow-diagram');
 }
+
+@layer itwinui.bridge {
+  @include meta.load-css('./bridge');
+}

packages/itwinui-css/src/breadcrumbs/breadcrumbs.scss

@@ -6,7 +6,6 @@
 
 .iui-breadcrumbs {
   --_iui-breadcrumbs-height: var(--iui-component-height);
-  --_iui-breadcrumbs-content-color-default: var(--iui-color-text-accent);
 
   @include mixins.iui-reset;
   display: flex;
@@ -57,7 +56,7 @@
   &:where(button, :any-link) {
     @include base.iui-button;
     @include borderless.iui-button-borderless;
-    color: var(--_iui-breadcrumbs-content-color-default);
+    color: var(--iui-color-text-accent);
 
     &[aria-current] {
       color: var(--iui-color-text);