@number10/jsx-core 5.0.0

package/dist/primitive-contracts.d.ts

@@ -0,0 +1,186 @@
+import { BackgroundProps, GestureProps, LayoutProps, SizeValue, TransformProps } from './core-props';
+import { PropsContainerExtension, PropsDefaultExtension } from './types';
+/**
+ * Stable host-node type names for renderer-neutral primitives.
+ *
+ * These are the `type` values passed to `HostAdapter.create()` and used
+ * in JSX as lowercase tags (`<view/>`, `<text/>`, ...).
+ * Each renderer registers HostDescriptors for these names.
+ *
+ * Portable components MUST NOT use these directly in JSX.
+ * They use the uppercase wrappers from `@number10/jsx-components/primitives`.
+ */
+export declare const PRIMITIVE_NODES: {
+    readonly View: "view";
+    readonly Text: "text";
+    readonly Image: "image";
+    readonly Sprite: "sprite";
+    readonly VectorDrawContent: "vectorDraw";
+    readonly NineSlice: "nineslice";
+};
+/** Host-node type names for renderer-neutral primitives */
+export type PrimitiveNodeType = (typeof PRIMITIVE_NODES)[keyof typeof PRIMITIVE_NODES];
+/**
+ * Portable props for the View primitive.
+ * Every renderer must support: layout, transform, background styling, and alpha.
+ */
+export interface ViewPrimitiveProps extends TransformProps, LayoutProps, BackgroundProps, GestureProps {
+    /**
+     * Alpha transparency of the element.
+     * - 0: Fully transparent
+     * - 1: Fully opaque (default)
+     */
+    alpha?: number;
+}
+/**
+ * Complete View props including JSX extensions.
+ * The generic parameter allows renderers to specify their native node type for Refs.
+ *
+ * @typeParam TNode - The renderer's native node type (e.g., Phaser.GameObjects.Container)
+ */
+export interface ViewPrimitivePropsComplete<TNode = unknown> extends ViewPrimitiveProps, PropsDefaultExtension<TNode>, PropsContainerExtension {
+}
+/**
+ * Portable text style — renderer-neutral text formatting.
+ * Each renderer maps this to its native text style type.
+ */
+export interface PortableTextStyle {
+    fontSize?: string | number;
+    fontFamily?: string;
+    fontStyle?: string;
+    fontWeight?: string | number;
+    color?: string | number;
+    backgroundColor?: string | number;
+    align?: 'left' | 'center' | 'right' | 'justify';
+    lineHeight?: number;
+    shadow?: {
+        color?: string | number;
+        blur?: number;
+        offsetX?: number;
+        offsetY?: number;
+        alpha?: number;
+        fill?: boolean;
+        stroke?: boolean;
+    } | undefined;
+}
+/**
+ * Portable props for the Text primitive.
+ */
+export interface TextPrimitiveProps extends TransformProps, LayoutProps, GestureProps {
+    /** The text content to display */
+    text: string | undefined;
+    /** Maximum width for text wrapping */
+    maxWidth?: SizeValue;
+    /** Portable text style — renderer maps to native style. Named 'style' for compat with Phaser's TextProps. */
+    style?: PortableTextStyle | undefined;
+}
+/**
+ * Complete Text props including JSX extensions.
+ */
+export interface TextPrimitivePropsComplete<TNode = unknown> extends TextPrimitiveProps, PropsDefaultExtension<TNode>, PropsContainerExtension {
+}
+/**
+ * Portable props for the Image primitive.
+ */
+export interface ImagePrimitiveProps extends TransformProps, LayoutProps {
+    /** Texture key or URL */
+    texture: string;
+    /** Optional tint color */
+    tint?: number | undefined;
+    /** Optional frame from texture atlas */
+    frame?: string | undefined;
+    /**
+     * Optional explicit source region within the texture/frame.
+     *
+     * When set, the image only renders this sub-rectangle of the source
+     * texture. Coordinates are relative to the frame origin (if `frame`
+     * is specified) or the texture origin otherwise.
+     *
+     * Enables portable NineSlice: each slice cell is an `<Image>` with
+     * its own `sourceRect` computed from the frame geometry.
+     */
+    sourceRect?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    } | undefined;
+    /** Display width — scaled rendering size (defaults to texture width) */
+    displayWidth?: number | undefined;
+    /** Display height — scaled rendering size (defaults to texture height) */
+    displayHeight?: number | undefined;
+    /**
+     * How image fits within displayWidth/displayHeight bounds.
+     * - 'fill': Stretch to fill (default, may distort aspect ratio)
+     * - 'contain': Scale to fit within bounds, preserve aspect ratio
+     * - 'cover': Scale to cover bounds, preserve aspect ratio (may crop)
+     */
+    fit?: 'fill' | 'contain' | 'cover' | undefined;
+    /** Origin X anchor point (0-1, default 0.5 for headless, 0 for layout) */
+    originX?: number | undefined;
+    /** Origin Y anchor point (0-1, default 0.5 for headless, 0 for layout) */
+    originY?: number | undefined;
+}
+/**
+ * Complete Image props including JSX extensions.
+ */
+export interface ImagePrimitivePropsComplete<TNode = unknown> extends ImagePrimitiveProps, PropsDefaultExtension<TNode> {
+}
+/**
+ * Portable props for the Sprite primitive.
+ */
+export interface SpritePrimitiveProps extends TransformProps, LayoutProps {
+    /** Texture key or URL */
+    texture: string;
+    /** Optional tint color */
+    tint?: number;
+    /** Optional frame from texture atlas */
+    frame?: string;
+    /** Optional animation key to play on mount */
+    anim?: string;
+}
+/**
+ * Complete Sprite props including JSX extensions.
+ */
+export interface SpritePrimitivePropsComplete<TNode = unknown> extends SpritePrimitiveProps, PropsDefaultExtension<TNode> {
+}
+/**
+ * Portable Components MUST follow this import style:
+ *
+ * ```typescript
+ * // ✅ CORRECT — only Core imports
+ * import type { ViewPrimitiveProps, TextPrimitiveProps } from '@number10/jsx-core'
+ * import { useState, useEffect, useTheme } from '@number10/jsx-core'
+ * import type { LayoutProps, TransformProps } from '@number10/jsx-core'
+ * import type { VNode, Ref } from '@number10/jsx-core'
+ *
+ * // ✅ CORRECT — renderer provides the actual primitives
+ * // (imported by the app, passed via JSX or context, not imported in the component)
+ *
+ * // ❌ WRONG — Phaser-specific imports in portable components
+ * // import type { PhaserProps } from '@number10/jsx-phaser'
+ * // import { useScene } from '@number10/jsx-phaser'
+ * // import type * as Phaser from 'phaser'
+ * ```
+ */
+/**
+ * The following primitives are OPTIONAL capabilities. A renderer MAY support
+ * them. Portable components SHOULD NOT depend on them unless the capability
+ * is explicitly checked via `SurfaceContext.capabilities`.
+ *
+ * | Primitive   | Capability Key   | Type in PRIMITIVE_NODES | Notes |
+ * |-------------|-----------------|-------------------------|-------|
+ * | NineSlice   | `nineslice`     | `'nineslice'`           | First-class primitive in PRIMITIVE_NODES; single-node native 9-slice |
+ * | TileSprite  | `tilesprite`    | —                       | Tiled texture background |
+ * | VectorDraw  | `drawing`       | `'vectorDraw'`          | Portable imperative drawing API |
+ * | Particles   | `particles`     | —                       | Renderer-native particle system |
+ *
+ * Portable components that need these should:
+ * 1. Check `SurfaceContext.capabilities.has('nineslice')` before use
+ * 2. Provide a fallback (e.g., use View+Image instead of NineSlice)
+ * 3. OR accept them as optional child/overlay via props
+ */
+export { computeSourceSlices, computeTargetXs, computeTargetYs, deriveTargetRects, } from './nineslice-contract';
+export type { NineSlicePrimitiveProps, NineSlicePrimitivePropsComplete, SliceRect, } from './nineslice-contract';
+export type { VectorDrawContentPrimitivePropsComplete } from './vector-draw-context';
+//# sourceMappingURL=primitive-contracts.d.ts.map

package/dist/primitive-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive-contracts.d.ts","sourceRoot":"","sources":["../src/primitive-contracts.ts"],"names":[],"mappings":"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"}

package/dist/primitive-contracts.js

@@ -0,0 +1,12 @@
+const PRIMITIVE_NODES = {
+  View: "view",
+  Text: "text",
+  Image: "image",
+  Sprite: "sprite",
+  VectorDrawContent: "vectorDraw",
+  NineSlice: "nineslice"
+};
+export {
+  PRIMITIVE_NODES
+};
+//# sourceMappingURL=primitive-contracts.js.map

package/dist/primitive-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive-contracts.js","sources":["../src/primitive-contracts.ts"],"sourcesContent":["/**\n * Portable Primitive Contracts — renderer-neutral prop interfaces for\n * View, Text, Image, and Sprite primitives.\n *\n * These contracts define the MINIMAL prop set that every renderer must\n * support. Each renderer package extends these with renderer-specific\n * props (e.g., Phaser adds PhaserProps and onReady).\n *\n * Portable Components MUST only import from this file and other Core modules.\n * They MUST NOT import from renderer-specific packages or Phaser directly.\n *\n * @migration(audit:scene-portal-mount) Phase 4B — defined in @number10/jsx-core.\n *   Renderer implementations live in the renderer package.\n */\n\nimport type {\n  BackgroundProps,\n  GestureProps,\n  LayoutProps,\n  SizeValue,\n  TransformProps,\n} from './core-props'\nimport type { PropsContainerExtension, PropsDefaultExtension } from './types'\n\n// ---------------------------------------------------------------------------\n// Primitive Host-Node Names\n// ---------------------------------------------------------------------------\n\n/**\n * Stable host-node type names for renderer-neutral primitives.\n *\n * These are the `type` values passed to `HostAdapter.create()` and used\n * in JSX as lowercase tags (`<view/>`, `<text/>`, ...).\n * Each renderer registers HostDescriptors for these names.\n *\n * Portable components MUST NOT use these directly in JSX.\n * They use the uppercase wrappers from `@number10/jsx-components/primitives`.\n */\nexport const PRIMITIVE_NODES = {\n  View: 'view',\n  Text: 'text',\n  Image: 'image',\n  Sprite: 'sprite',\n  VectorDrawContent: 'vectorDraw',\n  NineSlice: 'nineslice',\n} as const\n\n/** Host-node type names for renderer-neutral primitives */\nexport type PrimitiveNodeType = (typeof PRIMITIVE_NODES)[keyof typeof PRIMITIVE_NODES]\n\n// ---------------------------------------------------------------------------\n// View — the fundamental layout container\n// ---------------------------------------------------------------------------\n\n/**\n * Portable props for the View primitive.\n * Every renderer must support: layout, transform, background styling, and alpha.\n */\nexport interface ViewPrimitiveProps\n  extends TransformProps, LayoutProps, BackgroundProps, GestureProps {\n  /**\n   * Alpha transparency of the element.\n   * - 0: Fully transparent\n   * - 1: Fully opaque (default)\n   */\n  alpha?: number\n}\n\n/**\n * Complete View props including JSX extensions.\n * The generic parameter allows renderers to specify their native node type for Refs.\n *\n * @typeParam TNode - The renderer's native node type (e.g., Phaser.GameObjects.Container)\n */\nexport interface ViewPrimitivePropsComplete<TNode = unknown>\n  extends ViewPrimitiveProps, PropsDefaultExtension<TNode>, PropsContainerExtension {}\n\n// ---------------------------------------------------------------------------\n// Text — text rendering\n// ---------------------------------------------------------------------------\n\n/**\n * Portable text style — renderer-neutral text formatting.\n * Each renderer maps this to its native text style type.\n */\nexport interface PortableTextStyle {\n  fontSize?: string | number\n  fontFamily?: string\n  fontStyle?: string\n  fontWeight?: string | number\n  color?: string | number\n  backgroundColor?: string | number\n  align?: 'left' | 'center' | 'right' | 'justify'\n  lineHeight?: number\n  shadow?:\n    | {\n        color?: string | number\n        blur?: number\n        offsetX?: number\n        offsetY?: number\n        alpha?: number\n        fill?: boolean\n        stroke?: boolean\n      }\n    | undefined\n}\n\n/**\n * Portable props for the Text primitive.\n */\nexport interface TextPrimitiveProps extends TransformProps, LayoutProps, GestureProps {\n  /** The text content to display */\n  text: string | undefined\n  /** Maximum width for text wrapping */\n  maxWidth?: SizeValue\n  /** Portable text style — renderer maps to native style. Named 'style' for compat with Phaser's TextProps. */\n  style?: PortableTextStyle | undefined\n}\n\n/**\n * Complete Text props including JSX extensions.\n */\nexport interface TextPrimitivePropsComplete<TNode = unknown>\n  extends TextPrimitiveProps, PropsDefaultExtension<TNode>, PropsContainerExtension {}\n\n// ---------------------------------------------------------------------------\n// Image — texture-backed image display\n// ---------------------------------------------------------------------------\n\n/**\n * Portable props for the Image primitive.\n */\nexport interface ImagePrimitiveProps extends TransformProps, LayoutProps {\n  /** Texture key or URL */\n  texture: string\n  /** Optional tint color */\n  tint?: number | undefined\n  /** Optional frame from texture atlas */\n  frame?: string | undefined\n  /**\n   * Optional explicit source region within the texture/frame.\n   *\n   * When set, the image only renders this sub-rectangle of the source\n   * texture. Coordinates are relative to the frame origin (if `frame`\n   * is specified) or the texture origin otherwise.\n   *\n   * Enables portable NineSlice: each slice cell is an `<Image>` with\n   * its own `sourceRect` computed from the frame geometry.\n   */\n  sourceRect?: { x: number; y: number; w: number; h: number } | undefined\n  /** Display width — scaled rendering size (defaults to texture width) */\n  displayWidth?: number | undefined\n  /** Display height — scaled rendering size (defaults to texture height) */\n  displayHeight?: number | undefined\n  /**\n   * How image fits within displayWidth/displayHeight bounds.\n   * - 'fill': Stretch to fill (default, may distort aspect ratio)\n   * - 'contain': Scale to fit within bounds, preserve aspect ratio\n   * - 'cover': Scale to cover bounds, preserve aspect ratio (may crop)\n   */\n  fit?: 'fill' | 'contain' | 'cover' | undefined\n  /** Origin X anchor point (0-1, default 0.5 for headless, 0 for layout) */\n  originX?: number | undefined\n  /** Origin Y anchor point (0-1, default 0.5 for headless, 0 for layout) */\n  originY?: number | undefined\n}\n\n/**\n * Complete Image props including JSX extensions.\n */\nexport interface ImagePrimitivePropsComplete<TNode = unknown>\n  extends ImagePrimitiveProps, PropsDefaultExtension<TNode> {}\n\n// ---------------------------------------------------------------------------\n// Sprite — animated texture-backed display\n// ---------------------------------------------------------------------------\n\n/**\n * Portable props for the Sprite primitive.\n */\nexport interface SpritePrimitiveProps extends TransformProps, LayoutProps {\n  /** Texture key or URL */\n  texture: string\n  /** Optional tint color */\n  tint?: number\n  /** Optional frame from texture atlas */\n  frame?: string\n  /** Optional animation key to play on mount */\n  anim?: string\n}\n\n/**\n * Complete Sprite props including JSX extensions.\n */\nexport interface SpritePrimitivePropsComplete<TNode = unknown>\n  extends SpritePrimitiveProps, PropsDefaultExtension<TNode> {}\n\n// ---------------------------------------------------------------------------\n// Component Import Style — the contract for portable components\n// ---------------------------------------------------------------------------\n\n/**\n * Portable Components MUST follow this import style:\n *\n * ```typescript\n * // ✅ CORRECT — only Core imports\n * import type { ViewPrimitiveProps, TextPrimitiveProps } from '@number10/jsx-core'\n * import { useState, useEffect, useTheme } from '@number10/jsx-core'\n * import type { LayoutProps, TransformProps } from '@number10/jsx-core'\n * import type { VNode, Ref } from '@number10/jsx-core'\n *\n * // ✅ CORRECT — renderer provides the actual primitives\n * // (imported by the app, passed via JSX or context, not imported in the component)\n *\n * // ❌ WRONG — Phaser-specific imports in portable components\n * // import type { PhaserProps } from '@number10/jsx-phaser'\n * // import { useScene } from '@number10/jsx-phaser'\n * // import type * as Phaser from 'phaser'\n * ```\n */\n\n// ---------------------------------------------------------------------------\n// Optional Primitive Capabilities\n// ---------------------------------------------------------------------------\n\n/**\n * The following primitives are OPTIONAL capabilities. A renderer MAY support\n * them. Portable components SHOULD NOT depend on them unless the capability\n * is explicitly checked via `SurfaceContext.capabilities`.\n *\n * | Primitive   | Capability Key   | Type in PRIMITIVE_NODES | Notes |\n * |-------------|-----------------|-------------------------|-------|\n * | NineSlice   | `nineslice`     | `'nineslice'`           | First-class primitive in PRIMITIVE_NODES; single-node native 9-slice |\n * | TileSprite  | `tilesprite`    | —                       | Tiled texture background |\n * | VectorDraw  | `drawing`       | `'vectorDraw'`          | Portable imperative drawing API |\n * | Particles   | `particles`     | —                       | Renderer-native particle system |\n *\n * Portable components that need these should:\n * 1. Check `SurfaceContext.capabilities.has('nineslice')` before use\n * 2. Provide a fallback (e.g., use View+Image instead of NineSlice)\n * 3. OR accept them as optional child/overlay via props\n */\n\nexport {\n  computeSourceSlices,\n  computeTargetXs,\n  computeTargetYs,\n  deriveTargetRects,\n} from './nineslice-contract'\nexport type {\n  NineSlicePrimitiveProps,\n  NineSlicePrimitivePropsComplete,\n  SliceRect,\n} from './nineslice-contract'\n\nexport type { VectorDrawContentPrimitivePropsComplete } from './vector-draw-context'\n"],"names":[],"mappings":"AAsCO,MAAM,kBAAkB;AAAA,EAC7B,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,mBAAmB;AAAA,EACnB,WAAW;AACb;"}

package/dist/theme.cjs

@@ -0,0 +1,332 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const colorPresets = require("./colors/color-presets.cjs");
+const devConfig = require("./dev-config.cjs");
+function extractNestedThemes(props, knownComponents) {
+  const ownProps = { ...props };
+  const nestedThemes = {};
+  for (const key of knownComponents) {
+    if (key in ownProps) {
+      nestedThemes[key] = ownProps[key];
+      delete ownProps[key];
+    }
+  }
+  return {
+    ownProps,
+    nestedThemes
+  };
+}
+function deepMergeDefined(base, override) {
+  const result = { ...base };
+  for (const key of Object.keys(override)) {
+    const overrideVal = override[key];
+    if (overrideVal === void 0) continue;
+    if (isPlainObject(overrideVal) && isPlainObject(result[key])) {
+      result[key] = deepMergeDefined(result[key], overrideVal);
+    } else {
+      result[key] = overrideVal;
+    }
+  }
+  return result;
+}
+const PRIMITIVE_THEME_COMPONENT_NAMES = {
+  view: "View",
+  text: "Text",
+  image: "Image",
+  sprite: "Sprite"
+};
+function normalizeThemeComponentName(componentName) {
+  return PRIMITIVE_THEME_COMPONENT_NAMES[componentName] ?? componentName;
+}
+function mergeThemes(base, override) {
+  if (!base) return override ?? {};
+  if (!override) return base;
+  const result = { ...base };
+  for (const key of Object.keys(override)) {
+    const overrideVal = override[key];
+    if (overrideVal === void 0) continue;
+    if (isPlainObject(overrideVal) && isPlainObject(result[key])) {
+      result[key] = deepMergeDefined(result[key], overrideVal);
+    } else {
+      result[key] = overrideVal;
+    }
+  }
+  return result;
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function resolveThemeComponentTheme(theme, componentName) {
+  if (!theme) return {};
+  const normalizedName = normalizeThemeComponentName(componentName);
+  const candidates = normalizedName === componentName ? [componentName] : [normalizedName, componentName];
+  let merged = {};
+  for (const candidate of candidates) {
+    const entry = theme[candidate];
+    if (!entry) continue;
+    merged = deepMergeDefined(merged, entry);
+  }
+  return merged;
+}
+function resolveComponentTheme(options) {
+  const { componentName, globalTheme, localTheme, explicitProps = {}, knownComponents } = options;
+  const normalizedComponentName = normalizeThemeComponentName(componentName);
+  const componentSet = knownComponents ?? /* @__PURE__ */ new Set();
+  const globalComponentTheme = resolveThemeComponentTheme(globalTheme, normalizedComponentName);
+  const { ownProps: globalOwnProps, nestedThemes: globalNested } = extractNestedThemes(
+    globalComponentTheme,
+    componentSet
+  );
+  const localComponentTheme = resolveThemeComponentTheme(localTheme, normalizedComponentName);
+  const { ownProps: localOwnProps, nestedThemes: localNested } = extractNestedThemes(
+    localComponentTheme,
+    componentSet
+  );
+  const { nestedThemes: localThemeNested } = extractNestedThemes(
+    localTheme ?? {},
+    componentSet
+  );
+  const { ownProps: explicitOwnProps, nestedThemes: explicitNested } = extractNestedThemes(
+    explicitProps,
+    componentSet
+  );
+  const mergedProps = deepMergeDefined(
+    deepMergeDefined(globalOwnProps, localOwnProps),
+    explicitOwnProps
+  );
+  const mergedNested = mergeThemes(
+    mergeThemes(mergeThemes(globalNested, localNested), localThemeNested),
+    explicitNested
+  );
+  return { props: mergedProps, nestedTheme: mergedNested };
+}
+const _themeDefaults = {};
+const _themeDefaultProviders = {};
+let themeRemountHandler = null;
+function assignThemeDefaults(target, source) {
+  for (const key of Object.keys(target)) {
+    delete target[key];
+  }
+  Object.assign(target, source);
+  return target;
+}
+function providerFromInput(input) {
+  return typeof input === "function" ? input : () => input;
+}
+function rebuildRegisteredDefaults(presetName = "oceanBlue", mode = "light") {
+  const preset = colorPresets.getPresetWithMode(presetName, mode);
+  return assignThemeDefaults(_themeDefaults, createDefaultTheme(presetName, mode, preset.colors));
+}
+function setThemeRemountHandler(handler) {
+  themeRemountHandler = handler;
+}
+const KNOWN_COMPONENTS = /* @__PURE__ */ new Set(["View", "Text", "Icon", "Image", "Sprite"]);
+function registerComponentThemeDefaults(componentName, defaults) {
+  _themeDefaultProviders[componentName] = providerFromInput(defaults);
+  KNOWN_COMPONENTS.add(componentName);
+  rebuildRegisteredDefaults();
+}
+function registerComponentDefaults(componentName, defaults) {
+  registerComponentThemeDefaults(componentName, defaults);
+}
+function registerComponentDefaultsIfMissing(componentName, defaults) {
+  if (_themeDefaultProviders[componentName]) {
+    KNOWN_COMPONENTS.add(componentName);
+    return;
+  }
+  registerComponentThemeDefaults(componentName, defaults);
+}
+function createDefaultTheme(presetName = "oceanBlue", mode = "light", colors = colorPresets.getPresetWithMode(presetName, mode).colors) {
+  const theme = {};
+  for (const [componentName, provider] of Object.entries(_themeDefaultProviders)) {
+    theme[componentName] = provider(colors);
+  }
+  return theme;
+}
+const defaultTheme = _themeDefaults;
+class ThemeRegistry {
+  globalTheme = void 0;
+  customThemes = /* @__PURE__ */ new Map();
+  colorTokens = void 0;
+  colorMode = "light";
+  currentPresetName = void 0;
+  listeners = /* @__PURE__ */ new Set();
+  cachedComponentNames = null;
+  invalidateComponentNamesCache() {
+    this.cachedComponentNames = null;
+  }
+  getAllComponentNames() {
+    if (this.cachedComponentNames) return this.cachedComponentNames;
+    const internalPrimitiveNames = /* @__PURE__ */ new Set([
+      "view",
+      "text",
+      "nineslice",
+      "sprite",
+      "image",
+      "graphics",
+      "vectorDraw",
+      "tilesprite",
+      "particles"
+    ]);
+    this.cachedComponentNames = new Set(
+      Object.keys(this.getGlobalTheme()).concat(Array.from(this.customThemes.keys())).filter((key) => key !== "__colorPreset" && !internalPrimitiveNames.has(key))
+    );
+    return this.cachedComponentNames;
+  }
+  getGlobalTheme() {
+    return {
+      ...defaultTheme,
+      ...this.globalTheme ?? {},
+      ...Object.fromEntries(this.customThemes)
+    };
+  }
+  updateGlobalTheme(theme) {
+    const nextTheme = { ...this.globalTheme ?? {} };
+    for (const [component, styles] of Object.entries(theme)) {
+      if (component === "__colorPreset") {
+        nextTheme[component] = styles;
+        continue;
+      }
+      const existing = nextTheme[component] ?? this.getGlobalTheme()[component] ?? {};
+      nextTheme[component] = deepMergeDefined(existing, styles ?? {});
+      devConfig.DebugLogger.log("theme", `Updated ${component} theme:`, nextTheme[component]);
+    }
+    this.globalTheme = nextTheme;
+    this.notifyListeners();
+    this.invalidateComponentNamesCache();
+  }
+  setGlobalTheme(theme) {
+    this.globalTheme = { ...theme };
+    this.invalidateComponentNamesCache();
+  }
+  resetGlobalTheme() {
+    this.globalTheme = void 0;
+    this.customThemes.clear();
+    this.invalidateComponentNamesCache();
+  }
+  registerCustomComponent(componentName, defaultStyles) {
+    this.customThemes.set(componentName, defaultStyles);
+    KNOWN_COMPONENTS.add(componentName);
+    this.invalidateComponentNamesCache();
+  }
+  getComponentTheme(componentName) {
+    return this.getGlobalTheme()[componentName] ?? this.customThemes.get(componentName) ?? {};
+  }
+  getCustomComponentNames() {
+    return new Set(this.customThemes.keys());
+  }
+  setColorTokens(colors) {
+    this.colorTokens = colors;
+  }
+  getColorTokens() {
+    return this.colorTokens;
+  }
+  getColorMode() {
+    return this.colorMode;
+  }
+  setColorMode(mode) {
+    if (this.colorMode === mode) return;
+    this.colorMode = mode;
+    if (this.currentPresetName) {
+      const preset = colorPresets.getPresetWithMode(this.currentPresetName, mode);
+      this.colorTokens = preset.colors;
+      rebuildRegisteredDefaults(this.currentPresetName, mode);
+      this.setGlobalTheme(createDefaultTheme(this.currentPresetName, mode, preset.colors));
+    }
+    setTimeout(() => {
+      themeRemountHandler?.();
+    }, 0);
+    this.notifyListeners();
+  }
+  getCurrentPresetName() {
+    return this.currentPresetName;
+  }
+  setCurrentPresetName(name, skipNotify = false) {
+    if (this.currentPresetName === name) return;
+    this.currentPresetName = name;
+    if (!skipNotify) {
+      this.notifyListeners();
+    }
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  notifyListeners() {
+    this.listeners.forEach((listener) => listener());
+  }
+}
+const themeRegistry = new ThemeRegistry();
+function createTheme(theme, colorPreset) {
+  if (colorPreset) {
+    themeRegistry.setColorTokens(colorPreset.colors);
+    return {
+      ...theme,
+      __colorPreset: {
+        name: colorPreset.name,
+        mode: colorPreset.mode ?? "light"
+      }
+    };
+  }
+  return theme;
+}
+function getThemedProps(componentName, localTheme, explicitProps) {
+  return resolveComponentTheme({
+    componentName: normalizeThemeComponentName(componentName),
+    globalTheme: themeRegistry.getGlobalTheme(),
+    localTheme,
+    explicitProps,
+    knownComponents: themeRegistry.getAllComponentNames()
+  });
+}
+function setColorPreset(presetName, colorMode) {
+  const targetMode = colorMode ?? themeRegistry.getColorMode();
+  const preset = colorPresets.getPresetWithMode(presetName, targetMode);
+  themeRegistry.setColorTokens(preset.colors);
+  rebuildRegisteredDefaults(presetName, targetMode);
+  themeRegistry.setGlobalTheme(createDefaultTheme(presetName, targetMode, preset.colors));
+  themeRegistry.setCurrentPresetName(presetName, true);
+  if (colorMode && themeRegistry.getColorMode() !== colorMode) {
+    themeRegistry.setColorMode(colorMode);
+  } else {
+    setTimeout(() => {
+      themeRemountHandler?.();
+    }, 0);
+    themeRegistry.notifyListeners();
+  }
+}
+function getCurrentPreset() {
+  return themeRegistry.getCurrentPresetName();
+}
+function setColorMode(mode) {
+  themeRegistry.setColorMode(mode);
+}
+function getAvailablePresets() {
+  return Object.keys(colorPresets.presets);
+}
+function getGlobalThemeDefaults() {
+  return _themeDefaults;
+}
+exports.KNOWN_COMPONENTS = KNOWN_COMPONENTS;
+exports.createDefaultTheme = createDefaultTheme;
+exports.createTheme = createTheme;
+exports.deepMergeDefined = deepMergeDefined;
+exports.defaultTheme = defaultTheme;
+exports.extractNestedThemes = extractNestedThemes;
+exports.getAvailablePresets = getAvailablePresets;
+exports.getCurrentPreset = getCurrentPreset;
+exports.getGlobalThemeDefaults = getGlobalThemeDefaults;
+exports.getThemedProps = getThemedProps;
+exports.mergeThemes = mergeThemes;
+exports.normalizeThemeComponentName = normalizeThemeComponentName;
+exports.registerComponentDefaults = registerComponentDefaults;
+exports.registerComponentDefaultsIfMissing = registerComponentDefaultsIfMissing;
+exports.registerComponentThemeDefaults = registerComponentThemeDefaults;
+exports.resolveComponentTheme = resolveComponentTheme;
+exports.setColorMode = setColorMode;
+exports.setColorPreset = setColorPreset;
+exports.setThemeRemountHandler = setThemeRemountHandler;
+exports.themeRegistry = themeRegistry;
+//# sourceMappingURL=theme.cjs.map

package/dist/theme.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.cjs","sources":["../src/theme.ts"],"sourcesContent":["/**\n * Theme type helpers — renderer-neutral theme system contracts.\n *\n * These generic types form the foundation of the theme system. Each renderer\n * package defines its own ComponentThemes with renderer-specific prop types.\n *\n * @migration(audit:scene-portal-mount) Phase 3D — extracted from packages/ui/src/theme-base.ts.\n *   Generic type helpers live here. Component-specific theme interfaces\n *   (ViewTheme, TextTheme, ...) remain in the renderer package.\n */\nimport { getPresetWithMode, presets, type ColorTokens, type PresetName } from './colors'\nimport { DebugLogger } from './dev-config'\n\n// ---------------------------------------------------------------------------\n// Generic theme types\n// ---------------------------------------------------------------------------\n\n/**\n * Partial theme — allows overriding specific component styles.\n * Generic over the component theme map type.\n *\n * @example\n * ```ts\n * const theme: PartialTheme<PhaserComponentThemes> = {\n *   View: { backgroundColor: 0xff0000 },\n *   Text: { fontSize: 20 }\n * }\n * ```\n */\ntype ComponentThemeMap<T> = { [K in keyof T]: object }\n\n/**\n * Augmentable portable custom component theme map.\n *\n * Apps can extend this via:\n * `declare module '@number10/jsx-core' { interface CustomComponentThemes { ... } }`\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface CustomComponentThemes {}\n\nexport type PartialTheme<T extends ComponentThemeMap<T> = Record<string, object>> = {\n  [K in keyof T]?: Partial<T[K]>\n} & {\n  /** Optional color preset configuration */\n  __colorPreset?: {\n    name: string\n    mode?: 'light' | 'dark'\n  }\n}\n\n/**\n * Complete theme with all component styles defined.\n * Built-in components are required, custom components are optional.\n *\n * @param TBuiltIn - Required built-in component themes\n * @param TCustom - Optional custom component themes (defaults to empty object)\n */\nexport type Theme<\n  TBuiltIn extends Record<string, Record<string, unknown>>,\n  TCustom extends Record<string, Record<string, unknown>> = Record<string, never>,\n> = {\n  [K in keyof TBuiltIn]: TBuiltIn[K]\n} & {\n  [K in keyof TCustom]?: TCustom[K]\n}\n\n/**\n * Type helper for nested component themes.\n * Allows a component theme to include nested themes for child components.\n *\n * @param TComponentThemes - The full component theme map\n * @param TExclude - Keys to exclude (e.g., lowercase primitives)\n */\nexport type NestedComponentThemes<\n  TComponentThemes extends ComponentThemeMap<TComponentThemes>,\n  TExclude extends keyof TComponentThemes = never,\n> = {\n  [K in Exclude<keyof TComponentThemes, TExclude>]?: Partial<TComponentThemes[K]>\n}\n\n// ---------------------------------------------------------------------------\n// Theme utility types\n// ---------------------------------------------------------------------------\n\n/**\n * Extract nested theme keys from a props object.\n * Keys that match known component names are treated as nested themes.\n *\n * @param props - The props object to scan\n * @param knownComponents - Set of known component names\n * @returns Tuple of [ownProps, nestedThemes]\n */\nexport function extractNestedThemes<T extends Record<string, unknown>>(\n  props: T,\n  knownComponents: ReadonlySet<string>\n): { ownProps: Partial<T>; nestedThemes: PartialTheme } {\n  const ownProps: Record<string, unknown> = { ...props }\n  const nestedThemes: Record<string, unknown> = {}\n\n  for (const key of knownComponents) {\n    if (key in ownProps) {\n      nestedThemes[key] = ownProps[key]\n      delete ownProps[key]\n    }\n  }\n\n  return {\n    ownProps: ownProps as Partial<T>,\n    nestedThemes: nestedThemes as PartialTheme,\n  }\n}\n\n/**\n * Deep-merge two objects, only overwriting defined values (not undefined).\n */\nexport function deepMergeDefined<T extends object>(base: T, override: Partial<T>): T {\n  const result = { ...base }\n\n  for (const key of Object.keys(override) as (keyof T)[]) {\n    const overrideVal = override[key]\n    if (overrideVal === undefined) continue\n\n    if (isPlainObject(overrideVal) && isPlainObject(result[key])) {\n      result[key] = deepMergeDefined(result[key] as object, overrideVal as object) as T[keyof T]\n    } else {\n      result[key] = overrideVal as T[keyof T]\n    }\n  }\n\n  return result\n}\n\nconst PRIMITIVE_THEME_COMPONENT_NAMES: Record<string, string> = {\n  view: 'View',\n  text: 'Text',\n  image: 'Image',\n  sprite: 'Sprite',\n}\n\n/**\n * Normalize primitive host-node names to their canonical theme component names.\n * Non-primitive component names pass through unchanged.\n */\nexport function normalizeThemeComponentName(componentName: string): string {\n  return PRIMITIVE_THEME_COMPONENT_NAMES[componentName] ?? componentName\n}\n\n/**\n * Merge theme objects (nested themes). Shallow merge for each component key.\n */\nexport function mergeThemes(\n  base: PartialTheme | undefined,\n  override: PartialTheme | undefined\n): PartialTheme {\n  if (!base) return override ?? ({} as PartialTheme)\n  if (!override) return base\n\n  const result: Record<string, unknown> = { ...base }\n\n  for (const key of Object.keys(override)) {\n    const overrideVal = override[key]\n    if (overrideVal === undefined) continue\n\n    if (isPlainObject(overrideVal) && isPlainObject(result[key])) {\n      result[key] = deepMergeDefined(result[key] as object, overrideVal as object)\n    } else {\n      result[key] = overrideVal\n    }\n  }\n\n  return result as PartialTheme\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\n// ---------------------------------------------------------------------------\n// Portable component theme resolution\n// ---------------------------------------------------------------------------\n\n/**\n * Options for `resolveComponentTheme`.\n */\nexport interface ResolveComponentThemeOptions {\n  /** The component's name (e.g., 'Badge', 'ProgressBar', 'View') */\n  componentName: string\n  /** The component's global theme defaults (from the theme registry) */\n  globalTheme?: PartialTheme | undefined\n  /** The local theme context (propagated from parent or __theme) */\n  localTheme?: PartialTheme | undefined\n  /** Explicit props passed to the component */\n  explicitProps?: Record<string, unknown> | undefined\n  /** Set of known component names for nested theme detection */\n  knownComponents?: ReadonlySet<string> | undefined\n}\n\nfunction resolveThemeComponentTheme(\n  theme: PartialTheme | undefined,\n  componentName: string\n): Record<string, unknown> {\n  if (!theme) return {}\n\n  const normalizedName = normalizeThemeComponentName(componentName)\n  const candidates =\n    normalizedName === componentName ? [componentName] : [normalizedName, componentName]\n\n  let merged: Record<string, unknown> = {}\n\n  for (const candidate of candidates) {\n    const entry = theme[candidate] as Record<string, unknown> | undefined\n    if (!entry) continue\n    merged = deepMergeDefined(merged, entry)\n  }\n\n  return merged\n}\n\n/**\n * Resolves themed props for a portable component.\n *\n * Merges global theme defaults, local theme context, and explicit props\n * in priority order: global < local < explicit. Only defined values overwrite.\n *\n * Also extracts nested component themes for propagation to children.\n *\n * @returns Themed props and nested theme for children.\n *\n * @example\n * ```ts\n * const { props, nestedTheme } = resolveComponentTheme({\n *   componentName: 'Badge',\n *   globalTheme: { Badge: { backgroundColor: 0xeeeeee, Icon: { size: 16 } } },\n *   localTheme: theme,  // from useTheme()\n *   explicitProps: { tone: 'primary' },\n *   knownComponents: new Set(['View', 'Text', 'Icon', 'Badge'])\n * })\n * // props = { backgroundColor: 0xeeeeee, tone: 'primary' }\n * // nestedTheme = { Icon: { size: 16 } }\n * ```\n */\nexport function resolveComponentTheme<T extends object = Record<string, unknown>>(\n  options: ResolveComponentThemeOptions\n): {\n  props: T\n  nestedTheme: PartialTheme\n} {\n  const { componentName, globalTheme, localTheme, explicitProps = {}, knownComponents } = options\n  const normalizedComponentName = normalizeThemeComponentName(componentName)\n  const componentSet = knownComponents ?? new Set()\n\n  // 1. Start with global theme for this component\n  const globalComponentTheme = resolveThemeComponentTheme(globalTheme, normalizedComponentName)\n  const { ownProps: globalOwnProps, nestedThemes: globalNested } = extractNestedThemes(\n    globalComponentTheme,\n    componentSet\n  )\n\n  // 2. Apply local theme override\n  const localComponentTheme = resolveThemeComponentTheme(localTheme, normalizedComponentName)\n  const { ownProps: localOwnProps, nestedThemes: localNested } = extractNestedThemes(\n    localComponentTheme,\n    componentSet\n  )\n\n  // 3. Also extract nested themes directly from localTheme (for __theme propagation)\n  const { nestedThemes: localThemeNested } = extractNestedThemes(\n    (localTheme ?? {}) as Record<string, unknown>,\n    componentSet\n  )\n\n  // 4. Extract nested themes from explicit props\n  const { ownProps: explicitOwnProps, nestedThemes: explicitNested } = extractNestedThemes(\n    explicitProps,\n    componentSet\n  )\n\n  // 5. Merge: global < local < explicit\n  const mergedProps = deepMergeDefined(\n    deepMergeDefined(globalOwnProps as object, localOwnProps),\n    explicitOwnProps\n  ) as T\n\n  // 6. Merge nested themes: global < localComponent < localTheme < explicit\n  const mergedNested = mergeThemes(\n    mergeThemes(mergeThemes(globalNested, localNested), localThemeNested),\n    explicitNested\n  )\n\n  return { props: mergedProps, nestedTheme: mergedNested }\n}\n\n// ---------------------------------------------------------------------------\n// Global theme defaults registry\n// ---------------------------------------------------------------------------\n\ntype ThemeDefaults = Record<string, Record<string, unknown>>\nexport type ComponentThemeDefaultsProvider = (colors: ColorTokens) => object\nexport type ComponentThemeDefaultsInput = object | ComponentThemeDefaultsProvider\n\nconst _themeDefaults: ThemeDefaults = {}\nconst _themeDefaultProviders: Record<string, ComponentThemeDefaultsProvider> = {}\n\nlet themeRemountHandler: (() => void) | null = null\n\nfunction assignThemeDefaults(target: ThemeDefaults, source: ThemeDefaults): ThemeDefaults {\n  for (const key of Object.keys(target)) {\n    delete target[key]\n  }\n\n  Object.assign(target, source)\n  return target\n}\n\nfunction providerFromInput(input: ComponentThemeDefaultsInput): ComponentThemeDefaultsProvider {\n  return typeof input === 'function' ? (input as ComponentThemeDefaultsProvider) : () => input\n}\n\nfunction rebuildRegisteredDefaults(\n  presetName: PresetName = 'oceanBlue',\n  mode: 'light' | 'dark' = 'light'\n): ThemeDefaults {\n  const preset = getPresetWithMode(presetName, mode)\n  return assignThemeDefaults(_themeDefaults, createDefaultTheme(presetName, mode, preset.colors))\n}\n\nexport function setThemeRemountHandler(handler: (() => void) | null): void {\n  themeRemountHandler = handler\n}\n\n/**\n * Set of known component names. Components register themselves here\n * so resolveComponentTheme can detect nested component themes.\n */\nexport const KNOWN_COMPONENTS = new Set<string>(['View', 'Text', 'Icon', 'Image', 'Sprite'])\n\n/**\n * Register preset-aware defaults for a component.\n *\n * Renderer-agnostic components register from @number10/jsx-components.\n * Renderer packages register their own host/component defaults as side effects.\n */\nexport function registerComponentThemeDefaults(\n  componentName: string,\n  defaults: ComponentThemeDefaultsInput\n): void {\n  _themeDefaultProviders[componentName] = providerFromInput(defaults)\n  KNOWN_COMPONENTS.add(componentName)\n  rebuildRegisteredDefaults()\n}\n\n/**\n * Register global theme defaults for a component.\n * Also adds the component name to KNOWN_COMPONENTS.\n */\nexport function registerComponentDefaults(\n  componentName: string,\n  defaults: Record<string, unknown>\n): void {\n  registerComponentThemeDefaults(componentName, defaults)\n}\n\n/**\n * Register component defaults only when no defaults exist yet.\n * Useful for portable fallback themes that must not override\n * renderer-provided defaults registered later in the stack.\n */\nexport function registerComponentDefaultsIfMissing(\n  componentName: string,\n  defaults: Record<string, unknown>\n): void {\n  if (_themeDefaultProviders[componentName]) {\n    KNOWN_COMPONENTS.add(componentName)\n    return\n  }\n\n  registerComponentThemeDefaults(componentName, defaults)\n}\n\n/**\n * Create a default theme from all currently registered component defaults.\n */\nexport function createDefaultTheme(\n  presetName: PresetName = 'oceanBlue',\n  mode: 'light' | 'dark' = 'light',\n  colors: ColorTokens = getPresetWithMode(presetName, mode).colors\n): ThemeDefaults {\n  const theme: ThemeDefaults = {}\n\n  for (const [componentName, provider] of Object.entries(_themeDefaultProviders)) {\n    theme[componentName] = provider(colors) as Record<string, unknown>\n  }\n\n  return theme\n}\n\n/**\n * Mutable default theme cache for the default oceanBlue/light preset.\n * It is updated as component packages register their defaults.\n */\nexport const defaultTheme: ThemeDefaults = _themeDefaults\n\nclass ThemeRegistry {\n  private globalTheme: PartialTheme | undefined = undefined\n  private customThemes: Map<string, Record<string, unknown>> = new Map()\n  private colorTokens: ColorTokens | undefined = undefined\n  private colorMode: 'light' | 'dark' = 'light'\n  private currentPresetName: PresetName | undefined = undefined\n  private listeners: Set<() => void> = new Set()\n  private cachedComponentNames: Set<string> | null = null\n\n  private invalidateComponentNamesCache(): void {\n    this.cachedComponentNames = null\n  }\n\n  getAllComponentNames(): Set<string> {\n    if (this.cachedComponentNames) return this.cachedComponentNames\n\n    const internalPrimitiveNames = new Set([\n      'view',\n      'text',\n      'nineslice',\n      'sprite',\n      'image',\n      'graphics',\n      'vectorDraw',\n      'tilesprite',\n      'particles',\n    ])\n\n    this.cachedComponentNames = new Set(\n      Object.keys(this.getGlobalTheme())\n        .concat(Array.from(this.customThemes.keys()))\n        .filter((key) => key !== '__colorPreset' && !internalPrimitiveNames.has(key))\n    )\n    return this.cachedComponentNames\n  }\n\n  getGlobalTheme(): Readonly<PartialTheme> {\n    return {\n      ...defaultTheme,\n      ...(this.globalTheme ?? {}),\n      ...Object.fromEntries(this.customThemes),\n    } as PartialTheme\n  }\n\n  updateGlobalTheme(theme: PartialTheme): void {\n    const nextTheme = { ...(this.globalTheme ?? {}) } as Record<string, unknown>\n\n    for (const [component, styles] of Object.entries(theme)) {\n      if (component === '__colorPreset') {\n        nextTheme[component] = styles\n        continue\n      }\n\n      const existing =\n        (nextTheme[component] as object | undefined) ??\n        (this.getGlobalTheme()[component] as object | undefined) ??\n        {}\n      nextTheme[component] = deepMergeDefined(existing, (styles ?? {}) as object)\n      DebugLogger.log('theme', `Updated ${component} theme:`, nextTheme[component])\n    }\n\n    this.globalTheme = nextTheme as PartialTheme\n    this.notifyListeners()\n    this.invalidateComponentNamesCache()\n  }\n\n  setGlobalTheme(theme: PartialTheme): void {\n    this.globalTheme = { ...theme }\n    this.invalidateComponentNamesCache()\n  }\n\n  resetGlobalTheme(): void {\n    this.globalTheme = undefined\n    this.customThemes.clear()\n    this.invalidateComponentNamesCache()\n  }\n\n  registerCustomComponent<T extends Record<string, unknown>>(\n    componentName: string,\n    defaultStyles: T\n  ): void {\n    this.customThemes.set(componentName, defaultStyles)\n    KNOWN_COMPONENTS.add(componentName)\n    this.invalidateComponentNamesCache()\n  }\n\n  getComponentTheme<T extends object = Record<string, unknown>>(componentName: string): T {\n    return ((this.getGlobalTheme()[componentName] as T | undefined) ??\n      this.customThemes.get(componentName) ??\n      {}) as T\n  }\n\n  getCustomComponentNames(): Set<string> {\n    return new Set(this.customThemes.keys())\n  }\n\n  setColorTokens(colors: ColorTokens | undefined): void {\n    this.colorTokens = colors\n  }\n\n  getColorTokens(): ColorTokens | undefined {\n    return this.colorTokens\n  }\n\n  getColorMode(): 'light' | 'dark' {\n    return this.colorMode\n  }\n\n  setColorMode(mode: 'light' | 'dark'): void {\n    if (this.colorMode === mode) return\n\n    this.colorMode = mode\n\n    if (this.currentPresetName) {\n      const preset = getPresetWithMode(this.currentPresetName, mode)\n      this.colorTokens = preset.colors\n      rebuildRegisteredDefaults(this.currentPresetName, mode)\n      this.setGlobalTheme(createDefaultTheme(this.currentPresetName, mode, preset.colors))\n    }\n\n    setTimeout(() => {\n      themeRemountHandler?.()\n    }, 0)\n\n    this.notifyListeners()\n  }\n\n  getCurrentPresetName(): string | undefined {\n    return this.currentPresetName\n  }\n\n  setCurrentPresetName(name: string | undefined, skipNotify = false): void {\n    if (this.currentPresetName === name) return\n\n    this.currentPresetName = name as PresetName | undefined\n    if (!skipNotify) {\n      this.notifyListeners()\n    }\n  }\n\n  subscribe(listener: () => void): () => void {\n    this.listeners.add(listener)\n    return () => {\n      this.listeners.delete(listener)\n    }\n  }\n\n  notifyListeners(): void {\n    this.listeners.forEach((listener) => listener())\n  }\n}\n\nexport const themeRegistry = new ThemeRegistry()\n\nexport function createTheme(\n  theme: PartialTheme,\n  colorPreset?: { name: string; colors: ColorTokens; mode?: 'light' | 'dark' }\n): PartialTheme {\n  if (colorPreset) {\n    themeRegistry.setColorTokens(colorPreset.colors)\n\n    return {\n      ...theme,\n      __colorPreset: {\n        name: colorPreset.name,\n        mode: colorPreset.mode ?? 'light',\n      },\n    }\n  }\n\n  return theme\n}\n\nexport function getThemedProps<T extends object = Record<string, unknown>>(\n  componentName: string,\n  localTheme: PartialTheme | undefined,\n  explicitProps: Record<string, unknown>\n): { props: T; nestedTheme: PartialTheme } {\n  return resolveComponentTheme<T>({\n    componentName: normalizeThemeComponentName(componentName),\n    globalTheme: themeRegistry.getGlobalTheme(),\n    localTheme,\n    explicitProps,\n    knownComponents: themeRegistry.getAllComponentNames(),\n  })\n}\n\nexport function setColorPreset(presetName: PresetName, colorMode?: 'light' | 'dark'): void {\n  const targetMode = colorMode ?? themeRegistry.getColorMode()\n  const preset = getPresetWithMode(presetName, targetMode)\n\n  themeRegistry.setColorTokens(preset.colors)\n  rebuildRegisteredDefaults(presetName, targetMode)\n  themeRegistry.setGlobalTheme(createDefaultTheme(presetName, targetMode, preset.colors))\n  themeRegistry.setCurrentPresetName(presetName, true)\n\n  if (colorMode && themeRegistry.getColorMode() !== colorMode) {\n    themeRegistry.setColorMode(colorMode)\n  } else {\n    setTimeout(() => {\n      themeRemountHandler?.()\n    }, 0)\n    themeRegistry.notifyListeners()\n  }\n}\n\nexport function getCurrentPreset(): string | undefined {\n  return themeRegistry.getCurrentPresetName()\n}\n\nexport function setColorMode(mode: 'light' | 'dark'): void {\n  themeRegistry.setColorMode(mode)\n}\n\nexport function getAvailablePresets(): PresetName[] {\n  return Object.keys(presets) as PresetName[]\n}\n\n/**\n * Get all registered global theme defaults as a PartialTheme-like record.\n */\nexport function getGlobalThemeDefaults(): Record<string, Record<string, unknown>> {\n  return _themeDefaults\n}\n"],"names":["getPresetWithMode","DebugLogger","presets"],"mappings":"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"}