impact-ui 5.0.2-alpha.1 → 5.0.2-beta.1

package/dist/tokens/contrastDom.d.ts

@@ -0,0 +1,18 @@
+import { ImpactUiContrastLevel } from './impactUiPreferences';
+import { ImpactUiDomPersistOptions } from './interfaceStyleDom';
+
+export type { ImpactUiContrastLevel } from './impactUiPreferences';
+export declare const IU_CONTRAST_ATTR: "data-iu-contrast";
+export declare const IMPACT_UI_CONTRAST_CHANGE: "impact-ui-contrast-change";
+export interface ImpactUiContrastChangeDetail {
+    contrast: ImpactUiContrastLevel;
+}
+export declare function isImpactUiContrastLevel(value: string): value is ImpactUiContrastLevel;
+/** Committed contrast from `localStorage` (default `default`). */
+export declare function readImpactUiContrastFromStorage(): ImpactUiContrastLevel;
+/** Current contrast from DOM, then storage (SSR default: `default`). */
+export declare function readImpactUiContrastFromDom(): ImpactUiContrastLevel;
+export declare function applyImpactUiContrastToDom(contrast: ImpactUiContrastLevel, options?: ImpactUiDomPersistOptions): void;
+export declare function notifyImpactUiContrastChange(detail: ImpactUiContrastChangeDetail): void;
+export declare function setImpactUiContrast(contrast: ImpactUiContrastLevel, options?: ImpactUiDomPersistOptions): void;
+//# sourceMappingURL=contrastDom.d.ts.map

package/dist/tokens/contrastDom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrastDom.d.ts","sourceRoot":"","sources":["../../src/tokens/contrastDom.ts"],"names":[],"mappings":"AAAA,qHAAqH;AAErH,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAErE,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,eAAO,MAAM,gBAAgB,EAAG,kBAA2B,CAAC;AAE5D,eAAO,MAAM,yBAAyB,EAAG,2BAAoC,CAAC;AAE9E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAID,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,qBAAqB,CAErF;AAWD,kEAAkE;AAClE,wBAAgB,+BAA+B,IAAI,qBAAqB,CAEvE;AAED,wEAAwE;AACxE,wBAAgB,2BAA2B,IAAI,qBAAqB,CAKnE;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,GAAE,yBAA8B,GACtC,IAAI,CAgBN;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI,CAGvF;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,GAAE,yBAA8B,GACtC,IAAI,CAGN"}

package/dist/tokens/contrastDom.js

@@ -0,0 +1,34 @@
+import { patchImpactUiPreferences, readImpactUiPreferences } from "./impactUiPreferences.js";
+const IU_CONTRAST_ATTR = "data-iu-contrast";
+function readFromStorage() {
+  if (typeof localStorage === "undefined") return "default";
+  try {
+    return readImpactUiPreferences().contrast;
+  } catch {
+    return "default";
+  }
+}
+function readImpactUiContrastFromStorage() {
+  return readFromStorage();
+}
+function applyImpactUiContrastToDom(contrast, options = {}) {
+  if (typeof document === "undefined") return;
+  const root = document.documentElement;
+  if (contrast === "default") {
+    root.removeAttribute(IU_CONTRAST_ATTR);
+  } else {
+    root.setAttribute(IU_CONTRAST_ATTR, contrast);
+  }
+  if (options.persist === false) return;
+  if (typeof localStorage !== "undefined") {
+    try {
+      patchImpactUiPreferences({ contrast });
+    } catch {
+    }
+  }
+}
+export {
+  IU_CONTRAST_ATTR,
+  applyImpactUiContrastToDom,
+  readImpactUiContrastFromStorage
+};

package/dist/tokens/contrastDom.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contrastDom.test.d.ts.map

package/dist/tokens/contrastDom.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrastDom.test.d.ts","sourceRoot":"","sources":["../../src/tokens/contrastDom.test.ts"],"names":[],"mappings":""}

package/dist/tokens/createImpactUiMuiTheme.d.ts

@@ -0,0 +1,13 @@
+import { SxProps, Theme } from '@mui/material/styles';
+import { ThemeMode } from '../styles/tokens/tokens.generated';
+
+/** Drawer paper colors — follow `data-iu-theme` via CSS semantic vars. */
+export declare const impactUiDrawerSx: SxProps<Theme>;
+export declare function mergeImpactUiDrawerSx(overrides?: SxProps<Theme>): SxProps<Theme>;
+/**
+ * MUI theme whose palette uses resolved hex tokens (MUI cannot parse `var(--iu-*)`).
+ * Drawer/backdrop styleOverrides still use CSS vars so they follow `data-iu-theme`.
+ * Pair with `ImpactUiThemeProvider` + `import 'impact-ui/styles'`.
+ */
+export declare function createImpactUiMuiTheme(mode?: ThemeMode): Theme;
+//# sourceMappingURL=createImpactUiMuiTheme.d.ts.map

package/dist/tokens/createImpactUiMuiTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createImpactUiMuiTheme.d.ts","sourceRoot":"","sources":["../../src/tokens/createImpactUiMuiTheme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,EAAmC,KAAK,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAEpG,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,EAAE,OAAO,CAAC,KAAK,CAK3C,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAQhF;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,SAAmB,SAsG/D"}

package/dist/tokens/createImpactUiMuiTheme.js

@@ -0,0 +1,122 @@
+import { getColorToken, semanticColorVar } from "../styles/tokens/tokens.generated.js";
+import createTheme from "../node_modules/@mui/material/styles/createTheme.js";
+const impactUiDrawerSx = {
+  "& .MuiDrawer-paper": {
+    backgroundColor: semanticColorVar("bg-surface-layer-bg"),
+    color: semanticColorVar("on-surface-body")
+  }
+};
+function mergeImpactUiDrawerSx(overrides) {
+  if (overrides == null) return impactUiDrawerSx;
+  if (Array.isArray(overrides)) {
+    const overrideList = overrides;
+    return [impactUiDrawerSx, ...overrideList];
+  }
+  return [impactUiDrawerSx, overrides];
+}
+const modalBackdrop = "var(--ia-modal-backdrop, var(--iu-effect-mix-modal-backdrop-80))";
+function createImpactUiMuiTheme(mode = "light") {
+  return createTheme({
+    palette: {
+      mode,
+      background: {
+        default: getColorToken(mode, "bg-surface-body-bg"),
+        paper: getColorToken(mode, "bg-surface-layer-bg")
+      },
+      text: {
+        primary: getColorToken(mode, "on-surface-body"),
+        secondary: getColorToken(mode, "on-surface-caption")
+      },
+      primary: {
+        main: getColorToken(mode, "bg-primary")
+      },
+      error: {
+        main: getColorToken(mode, "bg-error")
+      },
+      divider: getColorToken(mode, "border-default")
+    },
+    components: {
+      MuiButton: {
+        defaultProps: {
+          disableElevation: true
+        },
+        styleOverrides: {
+          root: {
+            "&.ia-btn": {
+              textTransform: "none",
+              boxShadow: "none"
+            }
+          }
+        }
+      },
+      MuiLink: {
+        styleOverrides: {
+          root: {
+            color: semanticColorVar("link-button-color"),
+            "&:hover": {
+              color: "var(--iu-link-button-hover)"
+            }
+          }
+        }
+      },
+      MuiDrawer: {
+        styleOverrides: {
+          paper: {
+            backgroundColor: semanticColorVar("bg-surface-layer-bg"),
+            color: semanticColorVar("on-surface-body")
+          }
+        }
+      },
+      MuiPopover: {
+        styleOverrides: {
+          paper: {
+            // Flat fill: `background` (not only backgroundColor) clears MUI Paper elevation gradients.
+            background: semanticColorVar("bg-surface-layer-bg"),
+            backgroundImage: "none",
+            border: `0.5px solid ${semanticColorVar("border-default")}`,
+            color: semanticColorVar("on-surface-body")
+          }
+        }
+      },
+      MuiTooltip: {
+        styleOverrides: {
+          tooltip: {
+            backgroundColor: semanticColorVar("bg-surface-overlay-bg"),
+            color: semanticColorVar("on-primary-text")
+          },
+          arrow: {
+            color: semanticColorVar("bg-surface-overlay-bg")
+          }
+        }
+      },
+      // Only tint visible backdrops (Modal / Dialog / Drawer).
+      // Menu / Popover / Select-like overlays use an invisible backdrop for
+      // click-away; painting those dark caused the intermittent dim overlay
+      // (e.g. CommentsPanel ⋮ menu).
+      MuiBackdrop: {
+        styleOverrides: {
+          root: ({ ownerState }) => ownerState.invisible ? { backgroundColor: "transparent" } : { backgroundColor: modalBackdrop }
+        }
+      },
+      MuiSlider: {
+        styleOverrides: {
+          valueLabel: {
+            backgroundColor: semanticColorVar("on-surface-title"),
+            color: semanticColorVar("bg-surface-layer-bg"),
+            "&::before": {
+              backgroundColor: semanticColorVar("on-surface-title")
+            },
+            "& .MuiSlider-valueLabelLabel": {
+              color: "inherit"
+            }
+          }
+        }
+      }
+    }
+  });
+}
+export {
+  createImpactUiMuiTheme,
+  impactUiDrawerSx,
+  mergeImpactUiDrawerSx
+};

package/dist/tokens/impactUiPreferences.d.ts

@@ -0,0 +1,25 @@
+import { ImpactUiThemeMode } from './theme.types';
+
+export type ImpactUiStoredInterfaceStyle = 'none' | 'laborDay' | 'halloween' | 'christmas';
+/** Single `localStorage` object for appearance settings (theme, interface style, etc.). */
+export declare const IU_PREFERENCES_STORAGE_KEY: "impact-ui-preferences";
+/** @deprecated Migrated into {@link IU_PREFERENCES_STORAGE_KEY}. */
+export declare const IU_THEME_STORAGE_KEY_LEGACY: "impact-ui-theme-preference";
+/** @deprecated Migrated into {@link IU_PREFERENCES_STORAGE_KEY}. */
+export declare const IU_INTERFACE_STYLE_STORAGE_KEY_LEGACY: "impact-ui-interface-style";
+export declare const IU_PREFERENCES_VERSION = 1;
+export type ImpactUiContrastLevel = 'subtle' | 'default' | 'dark';
+export type ImpactUiAccentColorId = 'blue' | 'pink' | 'ocean' | 'teal' | 'amethyst';
+export interface ImpactUiPreferencesV1 {
+    version: 1;
+    theme: ImpactUiThemeMode;
+    interfaceStyle: ImpactUiStoredInterfaceStyle;
+    accentColor?: ImpactUiAccentColorId;
+    contrast: ImpactUiContrastLevel;
+}
+export type ImpactUiPreferences = ImpactUiPreferencesV1;
+export declare function writeImpactUiPreferences(preferences: ImpactUiPreferencesV1): void;
+/** Read committed preferences; migrates legacy keys into the unified object once. */
+export declare function readImpactUiPreferences(): ImpactUiPreferencesV1;
+export declare function patchImpactUiPreferences(patch: Partial<Omit<ImpactUiPreferencesV1, 'version'>>): ImpactUiPreferencesV1;
+//# sourceMappingURL=impactUiPreferences.d.ts.map

package/dist/tokens/impactUiPreferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impactUiPreferences.d.ts","sourceRoot":"","sources":["../../src/tokens/impactUiPreferences.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAE3F,2FAA2F;AAC3F,eAAO,MAAM,0BAA0B,EAAG,uBAAgC,CAAC;AAE3E,oEAAoE;AACpE,eAAO,MAAM,2BAA2B,EAAG,4BAAqC,CAAC;AAEjF,oEAAoE;AACpE,eAAO,MAAM,qCAAqC,EAAG,2BAAoC,CAAC;AAE1F,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAElE,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;AAEpF,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,iBAAiB,CAAC;IACzB,cAAc,EAAE,4BAA4B,CAAC;IAC7C,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAED,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAyFxD,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,qBAAqB,GAAG,IAAI,CAQjF;AAED,qFAAqF;AACrF,wBAAgB,uBAAuB,IAAI,qBAAqB,CAoB/D;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC,GACrD,qBAAqB,CAIvB"}

package/dist/tokens/impactUiPreferences.js

@@ -0,0 +1,109 @@
+const IU_PREFERENCES_STORAGE_KEY = "impact-ui-preferences";
+const IU_THEME_STORAGE_KEY_LEGACY = "impact-ui-theme-preference";
+const IU_INTERFACE_STYLE_STORAGE_KEY_LEGACY = "impact-ui-interface-style";
+const VALID_THEMES = /* @__PURE__ */ new Set(["light", "dark", "system"]);
+const VALID_STYLES = /* @__PURE__ */ new Set([
+  "none",
+  "laborDay",
+  "halloween",
+  "christmas"
+]);
+const VALID_CONTRAST = /* @__PURE__ */ new Set(["subtle", "default", "dark"]);
+const VALID_ACCENT = /* @__PURE__ */ new Set(["blue", "pink", "ocean", "teal", "amethyst"]);
+const DEFAULT_PREFERENCES = {
+  version: 1,
+  theme: "light",
+  interfaceStyle: "none",
+  contrast: "default"
+};
+function normalizeContrast(value) {
+  if (value && VALID_CONTRAST.has(value)) {
+    return value;
+  }
+  return DEFAULT_PREFERENCES.contrast;
+}
+function normalizeAccent(value) {
+  if (value && VALID_ACCENT.has(value)) {
+    return value;
+  }
+  return "blue";
+}
+function normalizePreferences(raw) {
+  const theme = raw.theme && VALID_THEMES.has(raw.theme) ? raw.theme : DEFAULT_PREFERENCES.theme;
+  const interfaceStyle = raw.interfaceStyle && VALID_STYLES.has(raw.interfaceStyle) ? raw.interfaceStyle : DEFAULT_PREFERENCES.interfaceStyle;
+  const contrast = normalizeContrast(raw.contrast);
+  const accentColor = normalizeAccent(raw.accentColor);
+  return {
+    version: 1,
+    theme,
+    interfaceStyle,
+    contrast,
+    ...accentColor !== "blue" ? { accentColor } : {}
+  };
+}
+function readLegacyPreferences() {
+  let theme = DEFAULT_PREFERENCES.theme;
+  let interfaceStyle = DEFAULT_PREFERENCES.interfaceStyle;
+  if (typeof localStorage === "undefined") {
+    return { ...DEFAULT_PREFERENCES };
+  }
+  try {
+    const legacyTheme = localStorage.getItem(IU_THEME_STORAGE_KEY_LEGACY);
+    if (legacyTheme === "light" || legacyTheme === "dark" || legacyTheme === "system") {
+      theme = legacyTheme;
+    }
+    const legacyStyle = localStorage.getItem(IU_INTERFACE_STYLE_STORAGE_KEY_LEGACY);
+    if (legacyStyle && VALID_STYLES.has(legacyStyle)) {
+      interfaceStyle = legacyStyle;
+    }
+  } catch {
+  }
+  return normalizePreferences({ theme, interfaceStyle });
+}
+function removeLegacyPreferenceKeys() {
+  if (typeof localStorage === "undefined") return;
+  try {
+    localStorage.removeItem(IU_THEME_STORAGE_KEY_LEGACY);
+    localStorage.removeItem(IU_INTERFACE_STYLE_STORAGE_KEY_LEGACY);
+  } catch {
+  }
+}
+function writeImpactUiPreferences(preferences) {
+  if (typeof localStorage === "undefined") return;
+  try {
+    localStorage.setItem(IU_PREFERENCES_STORAGE_KEY, JSON.stringify(preferences));
+    removeLegacyPreferenceKeys();
+  } catch {
+  }
+}
+function readImpactUiPreferences() {
+  if (typeof localStorage === "undefined") {
+    return { ...DEFAULT_PREFERENCES };
+  }
+  try {
+    const raw = localStorage.getItem(IU_PREFERENCES_STORAGE_KEY);
+    if (raw) {
+      const parsed = JSON.parse(raw);
+      if (parsed.version === 1) {
+        return normalizePreferences(parsed);
+      }
+    }
+  } catch {
+  }
+  const migrated = readLegacyPreferences();
+  writeImpactUiPreferences(migrated);
+  return migrated;
+}
+function patchImpactUiPreferences(patch) {
+  const next = normalizePreferences({ ...readImpactUiPreferences(), ...patch });
+  writeImpactUiPreferences(next);
+  return next;
+}
+export {
+  IU_INTERFACE_STYLE_STORAGE_KEY_LEGACY,
+  IU_PREFERENCES_STORAGE_KEY,
+  IU_THEME_STORAGE_KEY_LEGACY,
+  patchImpactUiPreferences,
+  readImpactUiPreferences,
+  writeImpactUiPreferences
+};

package/dist/tokens/impactUiPreferences.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=impactUiPreferences.test.d.ts.map

package/dist/tokens/impactUiPreferences.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impactUiPreferences.test.d.ts","sourceRoot":"","sources":["../../src/tokens/impactUiPreferences.test.ts"],"names":[],"mappings":""}

package/dist/tokens/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Public design-token API for impact-ui consumers.
+ *
+ * - Import styles: `import 'impact-ui/styles'`
+ * - Theme: wrap with `ImpactUiThemeProvider`; DOM is source of truth (`data-iu-theme`)
+ * - CSS: `var(--iu-…)` / `semanticColorVar('bg-primary')`
+ */
+export { COLOR_TOKENS, PRIMITIVE_COLOR_TOKENS, IU_THEME_ATTR, semanticColorVar, primitiveColorVar, getColorToken, type ThemeMode, type ColorTokenName, type PrimitiveColorTokenName, } from '../styles/tokens/tokens.generated';
+export { ACCENT_PALETTE_IDS, ACCENT_PALETTE_STEPS, ACCENT_PALETTE_SWATCH_HEX, ACCENT_PALETTE_SWATCH_STEP, ACCENT_PALETTE_TOKENS, accentPaletteCssVar, type AccentPaletteId, type AccentPaletteStep, } from '../styles/tokens/accent-palettes.generated';
+export { EFFECT_SHADOWS, EFFECT_GRADIENTS, EFFECT_COLOR_MIX_CSS, EFFECT_THEMED_MIX, getEffectThemedMix, type EffectShadowName, type EffectGradientName, type EffectThemedMixName, } from '../styles/tokens/effects.generated';
+export { useImpactUiTheme } from './useImpactUiTheme';
+export { useImpactUiInterfaceStyle } from './useImpactUiInterfaceStyle';
+export { ImpactUiThemeProvider, ImpactUiThemeContext, DEFAULT_IMPACT_UI_THEME_MODE, type ImpactUiThemeProviderProps, } from './ImpactUiThemeProvider';
+export type { UseImpactUiThemeResult, ImpactUiThemeMode, ImpactUiThemeChangeDetail, } from './theme.types';
+export { applyImpactUiThemeToDom, readImpactUiThemeModeFromDom, readImpactUiThemePreferenceFromDom, getSemanticColorFromDom, resolveThemeAppearance, setImpactUiTheme, IU_THEME_MODE_ATTR, IU_THEME_STORAGE_KEY, IU_THEME_TRANSITION_CLASS, IMPACT_UI_THEME_CHANGE, } from './themeDom';
+export { applyImpactUiInterfaceStyleToDom, readImpactUiInterfaceStyleFromDom, readImpactUiInterfaceStyleFromStorage, setImpactUiInterfaceStyle, notifyImpactUiInterfaceStyleChange, IU_INTERFACE_STYLE_ATTR, IU_INTERFACE_STYLE_STORAGE_KEY, IMPACT_UI_INTERFACE_STYLE_CHANGE, type ImpactUiInterfaceStyleId, type ImpactUiInterfaceStyleChangeDetail, type ImpactUiDomPersistOptions, } from './interfaceStyleDom';
+export { IU_PREFERENCES_STORAGE_KEY, IU_PREFERENCES_VERSION, readImpactUiPreferences, patchImpactUiPreferences, type ImpactUiPreferences, type ImpactUiPreferencesV1, type ImpactUiStoredInterfaceStyle, type ImpactUiContrastLevel, type ImpactUiAccentColorId, } from './impactUiPreferences';
+export { applyImpactUiAccentToDom, readImpactUiAccentFromDom, readImpactUiAccentFromStorage, setImpactUiAccent, notifyImpactUiAccentChange, IU_ACCENT_ATTR, IMPACT_UI_ACCENT_CHANGE, type ImpactUiAccentChangeDetail, } from './accentDom';
+export { applyImpactUiContrastToDom, readImpactUiContrastFromDom, readImpactUiContrastFromStorage, setImpactUiContrast, notifyImpactUiContrastChange, IU_CONTRAST_ATTR, IMPACT_UI_CONTRAST_CHANGE, type ImpactUiContrastChangeDetail, } from './contrastDom';
+export { createImpactUiMuiTheme, impactUiDrawerSx, mergeImpactUiDrawerSx, } from './createImpactUiMuiTheme';
+export { ImpactUiAppProviders, type ImpactUiAppProvidersProps, type ImpactUiMuiIntegration, } from './ImpactUiAppProviders';
+//# sourceMappingURL=index.d.ts.map

package/dist/tokens/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tokens/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,uBAAuB,GAC7B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,4BAA4B,EAC5B,KAAK,0BAA0B,GAChC,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,sBAAsB,EACtB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,kCAAkC,EAClC,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gCAAgC,EAChC,iCAAiC,EACjC,qCAAqC,EACrC,yBAAyB,EACzB,kCAAkC,EAClC,uBAAuB,EACvB,8BAA8B,EAC9B,gCAAgC,EAChC,KAAK,wBAAwB,EAC7B,KAAK,kCAAkC,EACvC,KAAK,yBAAyB,GAC/B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,6BAA6B,EAC7B,iBAAiB,EACjB,0BAA0B,EAC1B,cAAc,EACd,uBAAuB,EACvB,KAAK,0BAA0B,GAChC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,+BAA+B,EAC/B,mBAAmB,EACnB,4BAA4B,EAC5B,gBAAgB,EAChB,yBAAyB,EACzB,KAAK,4BAA4B,GAClC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAC"}

package/dist/tokens/interfaceStyleDom.d.ts

@@ -0,0 +1,26 @@
+import { ImpactUiStoredInterfaceStyle } from './impactUiPreferences';
+
+export declare const IU_INTERFACE_STYLE_ATTR: "data-iu-interface-style";
+/**
+ * @deprecated Use {@link IU_PREFERENCES_STORAGE_KEY} (`impact-ui-preferences` JSON).
+ * Legacy scalar key is migrated automatically on read.
+ */
+export declare const IU_INTERFACE_STYLE_STORAGE_KEY: "impact-ui-interface-style";
+export declare const IMPACT_UI_INTERFACE_STYLE_CHANGE: "impact-ui-interface-style-change";
+export type ImpactUiInterfaceStyleId = ImpactUiStoredInterfaceStyle;
+export interface ImpactUiInterfaceStyleChangeDetail {
+    style: ImpactUiInterfaceStyleId;
+}
+export interface ImpactUiDomPersistOptions {
+    /** When `false`, only updates `<html>` (preview). Default `true` writes `localStorage`. */
+    persist?: boolean;
+}
+export declare function isImpactUiInterfaceStyleId(value: string): value is ImpactUiInterfaceStyleId;
+/** Committed style from `localStorage` (default `none`). */
+export declare function readImpactUiInterfaceStyleFromStorage(): ImpactUiInterfaceStyleId;
+/** Current style from DOM, then storage (SSR default: `none`). */
+export declare function readImpactUiInterfaceStyleFromDom(): ImpactUiInterfaceStyleId;
+export declare function applyImpactUiInterfaceStyleToDom(style: ImpactUiInterfaceStyleId, options?: ImpactUiDomPersistOptions): void;
+export declare function notifyImpactUiInterfaceStyleChange(detail: ImpactUiInterfaceStyleChangeDetail): void;
+export declare function setImpactUiInterfaceStyle(style: ImpactUiInterfaceStyleId, options?: ImpactUiDomPersistOptions): void;
+//# sourceMappingURL=interfaceStyleDom.d.ts.map

package/dist/tokens/interfaceStyleDom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaceStyleDom.d.ts","sourceRoot":"","sources":["../../src/tokens/interfaceStyleDom.ts"],"names":[],"mappings":"AAAA,sHAAsH;AAEtH,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,uBAAuB,EAAG,yBAAkC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,8BAA8B,EAAG,2BAAoC,CAAC;AAEnF,eAAO,MAAM,gCAAgC,EAAG,kCAA2C,CAAC;AAE5F,MAAM,MAAM,wBAAwB,GAAG,4BAA4B,CAAC;AAEpE,MAAM,WAAW,kCAAkC;IACjD,KAAK,EAAE,wBAAwB,CAAC;CACjC;AAED,MAAM,WAAW,yBAAyB;IACxC,2FAA2F;IAC3F,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,wBAAwB,CAE3F;AAED,4DAA4D;AAC5D,wBAAgB,qCAAqC,IAAI,wBAAwB,CAEhF;AAWD,kEAAkE;AAClE,wBAAgB,iCAAiC,IAAI,wBAAwB,CAK5E;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,wBAAwB,EAC/B,OAAO,GAAE,yBAA8B,GACtC,IAAI,CAgBN;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,kCAAkC,GACzC,IAAI,CAGN;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,wBAAwB,EAC/B,OAAO,GAAE,yBAA8B,GACtC,IAAI,CAGN"}

package/dist/tokens/interfaceStyleDom.js

@@ -0,0 +1,58 @@
+import { patchImpactUiPreferences, readImpactUiPreferences } from "./impactUiPreferences.js";
+const IU_INTERFACE_STYLE_ATTR = "data-iu-interface-style";
+const IMPACT_UI_INTERFACE_STYLE_CHANGE = "impact-ui-interface-style-change";
+const VALID_STYLES = /* @__PURE__ */ new Set(["none", "laborDay", "halloween", "christmas"]);
+function isImpactUiInterfaceStyleId(value) {
+  return VALID_STYLES.has(value);
+}
+function readImpactUiInterfaceStyleFromStorage() {
+  return readFromStorage();
+}
+function readFromStorage() {
+  if (typeof localStorage === "undefined") return "none";
+  try {
+    return readImpactUiPreferences().interfaceStyle;
+  } catch {
+    return "none";
+  }
+}
+function readImpactUiInterfaceStyleFromDom() {
+  if (typeof document === "undefined") return readFromStorage();
+  const attr = document.documentElement.getAttribute(IU_INTERFACE_STYLE_ATTR);
+  if (attr && isImpactUiInterfaceStyleId(attr)) return attr;
+  return readFromStorage();
+}
+function applyImpactUiInterfaceStyleToDom(style, options = {}) {
+  if (typeof document === "undefined") return;
+  const root = document.documentElement;
+  if (style === "none") {
+    root.removeAttribute(IU_INTERFACE_STYLE_ATTR);
+  } else {
+    root.setAttribute(IU_INTERFACE_STYLE_ATTR, style);
+  }
+  if (options.persist === false) return;
+  if (typeof localStorage !== "undefined") {
+    try {
+      patchImpactUiPreferences({ interfaceStyle: style });
+    } catch {
+    }
+  }
+}
+function notifyImpactUiInterfaceStyleChange(detail) {
+  if (typeof window === "undefined") return;
+  window.dispatchEvent(new CustomEvent(IMPACT_UI_INTERFACE_STYLE_CHANGE, { detail }));
+}
+function setImpactUiInterfaceStyle(style, options = {}) {
+  applyImpactUiInterfaceStyleToDom(style, options);
+  notifyImpactUiInterfaceStyleChange({ style });
+}
+export {
+  IMPACT_UI_INTERFACE_STYLE_CHANGE,
+  IU_INTERFACE_STYLE_ATTR,
+  applyImpactUiInterfaceStyleToDom,
+  isImpactUiInterfaceStyleId,
+  notifyImpactUiInterfaceStyleChange,
+  readImpactUiInterfaceStyleFromDom,
+  readImpactUiInterfaceStyleFromStorage,
+  setImpactUiInterfaceStyle
+};

package/dist/tokens/theme.types.d.ts

@@ -0,0 +1,19 @@
+import { ImpactUiDomPersistOptions } from './interfaceStyleDom';
+import { ColorTokenName, ThemeMode } from '../styles/tokens/tokens.generated';
+
+export type { ThemeMode };
+/** User preference: fixed light/dark or follow OS (`system`). */
+export type ImpactUiThemeMode = ThemeMode | 'system';
+export interface UseImpactUiThemeResult {
+    /** Selected preference (`light` | `dark` | `system`). */
+    mode: ImpactUiThemeMode;
+    /** Resolved appearance on `<html>` — use for labels and `getColorToken`. */
+    resolvedMode: ThemeMode;
+    setMode: (mode: ImpactUiThemeMode, options?: ImpactUiDomPersistOptions) => void;
+    getSemanticColor: (name: ColorTokenName) => string;
+}
+export interface ImpactUiThemeChangeDetail {
+    mode: ImpactUiThemeMode;
+    resolved: ThemeMode;
+}
+//# sourceMappingURL=theme.types.d.ts.map

package/dist/tokens/theme.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.types.d.ts","sourceRoot":"","sources":["../../src/tokens/theme.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAEnF,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,iEAAiE;AACjE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACrC,yDAAyD;IACzD,IAAI,EAAE,iBAAiB,CAAC;IACxB,4EAA4E;IAC5E,YAAY,EAAE,SAAS,CAAC;IACxB,OAAO,EAAE,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,yBAAyB,KAAK,IAAI,CAAC;IAChF,gBAAgB,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,MAAM,CAAC;CACpD;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,SAAS,CAAC;CACrB"}

package/dist/tokens/themeDom.d.ts

@@ -0,0 +1,34 @@
+import { IU_THEME_ATTR, ColorTokenName, ThemeMode } from '../styles/tokens/tokens.generated';
+import { ImpactUiDomPersistOptions } from './interfaceStyleDom';
+import { ImpactUiThemeChangeDetail, ImpactUiThemeMode } from './theme.types';
+
+export { IU_THEME_ATTR };
+/** Stores user preference (`light` | `dark` | `system`). Omitted when `light`. */
+export declare const IU_THEME_MODE_ATTR: "data-iu-theme-mode";
+/**
+ * @deprecated Use {@link IU_PREFERENCES_STORAGE_KEY} (`impact-ui-preferences` JSON).
+ * Legacy scalar key is migrated automatically on read.
+ */
+export declare const IU_THEME_STORAGE_KEY: "impact-ui-theme-preference";
+export declare const IMPACT_UI_THEME_CHANGE = "impact-ui-theme-change";
+/** @deprecated Theme color cross-fade is disabled; class is no longer applied on mode change. */
+export declare const IU_THEME_TRANSITION_CLASS: "ia-theme-changing";
+export declare function resolveThemeAppearance(preference: ImpactUiThemeMode): ThemeMode;
+/** Resolved light/dark from `<html data-iu-theme>` (SSR default: light). */
+export declare function readImpactUiThemeModeFromDom(): ThemeMode;
+/**
+ * Hex for a semantic token from the current DOM resolved mode — no React hook.
+ * Prefer CSS vars or `useImpactUiTheme().getSemanticColor` when UI must update on theme toggle.
+ */
+export declare function getSemanticColorFromDom(name: ColorTokenName): string;
+/**
+ * Preference from storage, then `<html data-iu-theme-mode>`, then resolved appearance, then `fallback`.
+ */
+export declare function readImpactUiThemePreferenceFromDom(fallback?: ImpactUiThemeMode): ImpactUiThemeMode;
+/** Apply preference + resolved appearance on `<html>`. */
+export declare function applyImpactUiThemeToDom(preference: ImpactUiThemeMode, resolved?: ThemeMode, options?: ImpactUiDomPersistOptions): void;
+export declare function notifyImpactUiThemeChange(detail: ImpactUiThemeChangeDetail): void;
+export declare function setImpactUiTheme(mode: ImpactUiThemeMode, options?: ImpactUiDomPersistOptions): void;
+export declare function subscribeSystemColorScheme(onChange: () => void): () => void;
+export declare function getSystemColorSchemeSnapshot(): ThemeMode;
+//# sourceMappingURL=themeDom.d.ts.map

package/dist/tokens/themeDom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeDom.d.ts","sourceRoot":"","sources":["../../src/tokens/themeDom.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,EAAG,oBAA6B,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAG,4BAAqC,CAAC;AAE1E,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAE/D,iGAAiG;AACjG,eAAO,MAAM,yBAAyB,EAAG,mBAA4B,CAAC;AAOtE,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,iBAAiB,GAAG,SAAS,CAG/E;AAED,4EAA4E;AAC5E,wBAAgB,4BAA4B,IAAI,SAAS,CAGxD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAEpE;AAoBD;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,QAAQ,GAAE,iBAA2B,GACpC,iBAAiB,CAcnB;AAED,0DAA0D;AAC1D,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,iBAAiB,EAC7B,QAAQ,GAAE,SAA8C,EACxD,OAAO,GAAE,yBAA8B,GACtC,IAAI,CAqBN;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,IAAI,CAGjF;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,iBAAiB,EACvB,OAAO,GAAE,yBAA8B,GACtC,IAAI,CAIN;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAO3E;AAED,wBAAgB,4BAA4B,IAAI,SAAS,CAExD"}

package/dist/tokens/themeDom.js

@@ -0,0 +1,97 @@
+import { patchImpactUiPreferences, readImpactUiPreferences } from "./impactUiPreferences.js";
+import { IU_THEME_ATTR, getColorToken } from "../styles/tokens/tokens.generated.js";
+const IU_THEME_MODE_ATTR = "data-iu-theme-mode";
+const IMPACT_UI_THEME_CHANGE = "impact-ui-theme-change";
+function getSystemAppearance() {
+  if (typeof window === "undefined") return "light";
+  return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
+}
+function resolveThemeAppearance(preference) {
+  if (preference === "system") return getSystemAppearance();
+  return preference;
+}
+function readImpactUiThemeModeFromDom() {
+  if (typeof document === "undefined") return "light";
+  return document.documentElement.getAttribute(IU_THEME_ATTR) === "dark" ? "dark" : "light";
+}
+function getSemanticColorFromDom(name) {
+  return getColorToken(readImpactUiThemeModeFromDom(), name);
+}
+function readStoredThemePreference() {
+  if (typeof window === "undefined") return null;
+  try {
+    return readImpactUiPreferences().theme;
+  } catch {
+    return null;
+  }
+}
+function persistThemePreference(preference) {
+  if (typeof window === "undefined") return;
+  try {
+    patchImpactUiPreferences({ theme: preference });
+  } catch {
+  }
+}
+function readImpactUiThemePreferenceFromDom(fallback = "light") {
+  if (typeof document === "undefined") return fallback;
+  const fromStorage = readStoredThemePreference();
+  if (fromStorage != null) return fromStorage;
+  const root = document.documentElement;
+  const stored = root.getAttribute(IU_THEME_MODE_ATTR);
+  if (stored === "dark" || stored === "system") return stored;
+  if (stored === "light") return "light";
+  if (readImpactUiThemeModeFromDom() === "dark") return "dark";
+  return fallback;
+}
+function applyImpactUiThemeToDom(preference, resolved = resolveThemeAppearance(preference), options = {}) {
+  if (typeof document === "undefined") return;
+  const root = document.documentElement;
+  if (preference === "light") {
+    root.removeAttribute(IU_THEME_MODE_ATTR);
+  } else {
+    root.setAttribute(IU_THEME_MODE_ATTR, preference);
+  }
+  if (resolved === "light") {
+    root.removeAttribute(IU_THEME_ATTR);
+  } else {
+    root.setAttribute(IU_THEME_ATTR, resolved);
+  }
+  root.style.colorScheme = resolved;
+  if (options.persist !== false) {
+    persistThemePreference(preference);
+  }
+}
+function notifyImpactUiThemeChange(detail) {
+  if (typeof window === "undefined") return;
+  window.dispatchEvent(new CustomEvent(IMPACT_UI_THEME_CHANGE, { detail }));
+}
+function setImpactUiTheme(mode, options = {}) {
+  const resolved = resolveThemeAppearance(mode);
+  applyImpactUiThemeToDom(mode, resolved, options);
+  notifyImpactUiThemeChange({ mode, resolved });
+}
+function subscribeSystemColorScheme(onChange) {
+  if (typeof window === "undefined") return () => void 0;
+  const mq = window.matchMedia("(prefers-color-scheme: dark)");
+  mq.addEventListener("change", onChange);
+  return () => {
+    mq.removeEventListener("change", onChange);
+  };
+}
+function getSystemColorSchemeSnapshot() {
+  return getSystemAppearance();
+}
+export {
+  IMPACT_UI_THEME_CHANGE,
+  IU_THEME_ATTR,
+  IU_THEME_MODE_ATTR,
+  applyImpactUiThemeToDom,
+  getSemanticColorFromDom,
+  getSystemColorSchemeSnapshot,
+  notifyImpactUiThemeChange,
+  readImpactUiThemeModeFromDom,
+  readImpactUiThemePreferenceFromDom,
+  resolveThemeAppearance,
+  setImpactUiTheme,
+  subscribeSystemColorScheme
+};

package/dist/tokens/useImpactUiInterfaceStyle.d.ts

@@ -0,0 +1,7 @@
+import { ImpactUiInterfaceStyleId } from './interfaceStyleDom';
+
+/**
+ * Subscribes to `setImpactUiInterfaceStyle` / ThemingPanel (same event as DOM `data-iu-interface-style`).
+ */
+export declare function useImpactUiInterfaceStyle(): ImpactUiInterfaceStyleId;
+//# sourceMappingURL=useImpactUiInterfaceStyle.d.ts.map

package/dist/tokens/useImpactUiInterfaceStyle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImpactUiInterfaceStyle.d.ts","sourceRoot":"","sources":["../../src/tokens/useImpactUiInterfaceStyle.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,wBAAwB,CAepE"}