@number10/jsx-core 5.0.0

package/dist/theme.d.ts

@@ -0,0 +1,204 @@
+import { ColorTokens, PresetName } from './colors';
+/**
+ * Partial theme — allows overriding specific component styles.
+ * Generic over the component theme map type.
+ *
+ * @example
+ * ```ts
+ * const theme: PartialTheme<PhaserComponentThemes> = {
+ *   View: { backgroundColor: 0xff0000 },
+ *   Text: { fontSize: 20 }
+ * }
+ * ```
+ */
+type ComponentThemeMap<T> = {
+    [K in keyof T]: object;
+};
+/**
+ * Augmentable portable custom component theme map.
+ *
+ * Apps can extend this via:
+ * `declare module '@number10/jsx-core' { interface CustomComponentThemes { ... } }`
+ */
+export interface CustomComponentThemes {
+}
+export type PartialTheme<T extends ComponentThemeMap<T> = Record<string, object>> = {
+    [K in keyof T]?: Partial<T[K]>;
+} & {
+    /** Optional color preset configuration */
+    __colorPreset?: {
+        name: string;
+        mode?: 'light' | 'dark';
+    };
+};
+/**
+ * Complete theme with all component styles defined.
+ * Built-in components are required, custom components are optional.
+ *
+ * @param TBuiltIn - Required built-in component themes
+ * @param TCustom - Optional custom component themes (defaults to empty object)
+ */
+export type Theme<TBuiltIn extends Record<string, Record<string, unknown>>, TCustom extends Record<string, Record<string, unknown>> = Record<string, never>> = {
+    [K in keyof TBuiltIn]: TBuiltIn[K];
+} & {
+    [K in keyof TCustom]?: TCustom[K];
+};
+/**
+ * Type helper for nested component themes.
+ * Allows a component theme to include nested themes for child components.
+ *
+ * @param TComponentThemes - The full component theme map
+ * @param TExclude - Keys to exclude (e.g., lowercase primitives)
+ */
+export type NestedComponentThemes<TComponentThemes extends ComponentThemeMap<TComponentThemes>, TExclude extends keyof TComponentThemes = never> = {
+    [K in Exclude<keyof TComponentThemes, TExclude>]?: Partial<TComponentThemes[K]>;
+};
+/**
+ * Extract nested theme keys from a props object.
+ * Keys that match known component names are treated as nested themes.
+ *
+ * @param props - The props object to scan
+ * @param knownComponents - Set of known component names
+ * @returns Tuple of [ownProps, nestedThemes]
+ */
+export declare function extractNestedThemes<T extends Record<string, unknown>>(props: T, knownComponents: ReadonlySet<string>): {
+    ownProps: Partial<T>;
+    nestedThemes: PartialTheme;
+};
+/**
+ * Deep-merge two objects, only overwriting defined values (not undefined).
+ */
+export declare function deepMergeDefined<T extends object>(base: T, override: Partial<T>): T;
+/**
+ * Normalize primitive host-node names to their canonical theme component names.
+ * Non-primitive component names pass through unchanged.
+ */
+export declare function normalizeThemeComponentName(componentName: string): string;
+/**
+ * Merge theme objects (nested themes). Shallow merge for each component key.
+ */
+export declare function mergeThemes(base: PartialTheme | undefined, override: PartialTheme | undefined): PartialTheme;
+/**
+ * Options for `resolveComponentTheme`.
+ */
+export interface ResolveComponentThemeOptions {
+    /** The component's name (e.g., 'Badge', 'ProgressBar', 'View') */
+    componentName: string;
+    /** The component's global theme defaults (from the theme registry) */
+    globalTheme?: PartialTheme | undefined;
+    /** The local theme context (propagated from parent or __theme) */
+    localTheme?: PartialTheme | undefined;
+    /** Explicit props passed to the component */
+    explicitProps?: Record<string, unknown> | undefined;
+    /** Set of known component names for nested theme detection */
+    knownComponents?: ReadonlySet<string> | undefined;
+}
+/**
+ * Resolves themed props for a portable component.
+ *
+ * Merges global theme defaults, local theme context, and explicit props
+ * in priority order: global < local < explicit. Only defined values overwrite.
+ *
+ * Also extracts nested component themes for propagation to children.
+ *
+ * @returns Themed props and nested theme for children.
+ *
+ * @example
+ * ```ts
+ * const { props, nestedTheme } = resolveComponentTheme({
+ *   componentName: 'Badge',
+ *   globalTheme: { Badge: { backgroundColor: 0xeeeeee, Icon: { size: 16 } } },
+ *   localTheme: theme,  // from useTheme()
+ *   explicitProps: { tone: 'primary' },
+ *   knownComponents: new Set(['View', 'Text', 'Icon', 'Badge'])
+ * })
+ * // props = { backgroundColor: 0xeeeeee, tone: 'primary' }
+ * // nestedTheme = { Icon: { size: 16 } }
+ * ```
+ */
+export declare function resolveComponentTheme<T extends object = Record<string, unknown>>(options: ResolveComponentThemeOptions): {
+    props: T;
+    nestedTheme: PartialTheme;
+};
+type ThemeDefaults = Record<string, Record<string, unknown>>;
+export type ComponentThemeDefaultsProvider = (colors: ColorTokens) => object;
+export type ComponentThemeDefaultsInput = object | ComponentThemeDefaultsProvider;
+export declare function setThemeRemountHandler(handler: (() => void) | null): void;
+/**
+ * Set of known component names. Components register themselves here
+ * so resolveComponentTheme can detect nested component themes.
+ */
+export declare const KNOWN_COMPONENTS: Set<string>;
+/**
+ * Register preset-aware defaults for a component.
+ *
+ * Renderer-agnostic components register from @number10/jsx-components.
+ * Renderer packages register their own host/component defaults as side effects.
+ */
+export declare function registerComponentThemeDefaults(componentName: string, defaults: ComponentThemeDefaultsInput): void;
+/**
+ * Register global theme defaults for a component.
+ * Also adds the component name to KNOWN_COMPONENTS.
+ */
+export declare function registerComponentDefaults(componentName: string, defaults: Record<string, unknown>): void;
+/**
+ * Register component defaults only when no defaults exist yet.
+ * Useful for portable fallback themes that must not override
+ * renderer-provided defaults registered later in the stack.
+ */
+export declare function registerComponentDefaultsIfMissing(componentName: string, defaults: Record<string, unknown>): void;
+/**
+ * Create a default theme from all currently registered component defaults.
+ */
+export declare function createDefaultTheme(presetName?: PresetName, mode?: 'light' | 'dark', colors?: ColorTokens): ThemeDefaults;
+/**
+ * Mutable default theme cache for the default oceanBlue/light preset.
+ * It is updated as component packages register their defaults.
+ */
+export declare const defaultTheme: ThemeDefaults;
+declare class ThemeRegistry {
+    private globalTheme;
+    private customThemes;
+    private colorTokens;
+    private colorMode;
+    private currentPresetName;
+    private listeners;
+    private cachedComponentNames;
+    private invalidateComponentNamesCache;
+    getAllComponentNames(): Set<string>;
+    getGlobalTheme(): Readonly<PartialTheme>;
+    updateGlobalTheme(theme: PartialTheme): void;
+    setGlobalTheme(theme: PartialTheme): void;
+    resetGlobalTheme(): void;
+    registerCustomComponent<T extends Record<string, unknown>>(componentName: string, defaultStyles: T): void;
+    getComponentTheme<T extends object = Record<string, unknown>>(componentName: string): T;
+    getCustomComponentNames(): Set<string>;
+    setColorTokens(colors: ColorTokens | undefined): void;
+    getColorTokens(): ColorTokens | undefined;
+    getColorMode(): 'light' | 'dark';
+    setColorMode(mode: 'light' | 'dark'): void;
+    getCurrentPresetName(): string | undefined;
+    setCurrentPresetName(name: string | undefined, skipNotify?: boolean): void;
+    subscribe(listener: () => void): () => void;
+    notifyListeners(): void;
+}
+export declare const themeRegistry: ThemeRegistry;
+export declare function createTheme(theme: PartialTheme, colorPreset?: {
+    name: string;
+    colors: ColorTokens;
+    mode?: 'light' | 'dark';
+}): PartialTheme;
+export declare function getThemedProps<T extends object = Record<string, unknown>>(componentName: string, localTheme: PartialTheme | undefined, explicitProps: Record<string, unknown>): {
+    props: T;
+    nestedTheme: PartialTheme;
+};
+export declare function setColorPreset(presetName: PresetName, colorMode?: 'light' | 'dark'): void;
+export declare function getCurrentPreset(): string | undefined;
+export declare function setColorMode(mode: 'light' | 'dark'): void;
+export declare function getAvailablePresets(): PresetName[];
+/**
+ * Get all registered global theme defaults as a PartialTheme-like record.
+ */
+export declare function getGlobalThemeDefaults(): Record<string, Record<string, unknown>>;
+export {};
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

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

package/dist/theme.js

@@ -0,0 +1,332 @@
+import { getPresetWithMode, presets } from "./colors/color-presets.js";
+import { DebugLogger } from "./dev-config.js";
+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 = 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 = 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 ?? {});
+      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 = 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 = 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(presets);
+}
+function getGlobalThemeDefaults() {
+  return _themeDefaults;
+}
+export {
+  KNOWN_COMPONENTS,
+  createDefaultTheme,
+  createTheme,
+  deepMergeDefined,
+  defaultTheme,
+  extractNestedThemes,
+  getAvailablePresets,
+  getCurrentPreset,
+  getGlobalThemeDefaults,
+  getThemedProps,
+  mergeThemes,
+  normalizeThemeComponentName,
+  registerComponentDefaults,
+  registerComponentDefaultsIfMissing,
+  registerComponentThemeDefaults,
+  resolveComponentTheme,
+  setColorMode,
+  setColorPreset,
+  setThemeRemountHandler,
+  themeRegistry
+};
+//# sourceMappingURL=theme.js.map

package/dist/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","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":[],"mappings":"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"}