react-native-terra-ui 0.7.1 → 0.8.0

package/lib/module/theme/resolve-config.js

@@ -0,0 +1,346 @@
+"use strict";
+
+/**
+ * Pure theme resolution — normalization, layer processing, derived values and
+ * theme creation. Shared by startup configuration, runtime accent changes and
+ * previews so every consumer sees the same colors for the same input.
+ *
+ * Precedence, identical for both schemes:
+ *
+ *   default tokens → shared → schemes[scheme]
+ *       → generated selected accent → selected accent explicit overrides
+ *
+ * This module must stay free of registry, provider, Unistyles and renderer
+ * imports so `createTerraThemes` works without any native configuration.
+ */
+import { checkAccentContrast, GENERATED_ACCENT_ROLES, generateAccentColors, isSupportedAccentSeed } from "../utils/accent-generator.js";
+import { deepMerge, isPlainObject } from "../utils/deep-merge.js";
+import { warnContrastDiagnostics } from "./diagnostics.js";
+import { TerraConfigError } from "./errors.js";
+import { normalizeTokenOverride } from "./legacy-tokens.js";
+import { buildRadiusScale, buildSpacingScale, createDefaultThemeSource, finalizeThemeSource } from "./theme.js";
+const SCHEMES = ["light", "dark"];
+const SURFACE_ROLES = ["surface.canvas", "surface.default", "surface.raised", "surface.sunken"];
+
+// ─── Layer state ─────────────────────────────────────────────────────────────
+
+/**
+ * A theme mid-resolution: its source form plus provenance for every elevation
+ * level whose `shadowColor` a layer pinned explicitly. Default shadow colors are
+ * derived, never pinned, so a later `color.shadow` override still moves them.
+ */
+
+/**
+ * Deep-copies an override, dropping `undefined` and `null` leaves (neither is
+ * an override; `null` is not a deletion mechanism). The copy means later
+ * mutation of caller data can never reach a normalized config or a theme.
+ */
+function sanitizeOverride(value) {
+  if (Array.isArray(value)) {
+    return value.map(item => sanitizeOverride(item));
+  }
+  if (isPlainObject(value)) {
+    const out = {};
+    for (const [key, item] of Object.entries(value)) {
+      if (item === undefined || item === null) continue;
+      out[key] = sanitizeOverride(item);
+    }
+    return out;
+  }
+  return value;
+}
+
+/**
+ * Applies one override layer onto `state` and returns the next state. Every
+ * layer — shared, scheme, generated accent, accent overrides, or a full accent
+ * patch — goes through here, so they all follow the same rules:
+ * - deprecated names are normalized within the layer (canonical wins);
+ * - `undefined`/`null` leaves are no override; arrays replace; objects merge;
+ * - `spacing.base` / `radius.base` regenerate their scale, then that layer's
+ *   explicit steps win over the regenerated values;
+ * - `elevation.<level>.shadowColor` pins that level (a later pin replaces an
+ *   earlier one); other elevation fields merge normally.
+ * Inputs are never mutated.
+ */
+export function applyThemeLayer(state, override) {
+  if (!override) return state;
+  const normalized = normalizeTokenOverride(sanitizeOverride(override));
+  if (!normalized) return state;
+  const {
+    radius,
+    spacing,
+    elevation,
+    ...rest
+  } = normalized;
+  let source = deepMerge(state.source, rest);
+  const pinnedShadowColors = {
+    ...state.pinnedShadowColors
+  };
+  if (radius) {
+    const {
+      base,
+      ...steps
+    } = radius;
+    if (base !== undefined) {
+      source = {
+        ...source,
+        radius: buildRadiusScale(base)
+      };
+    }
+    source = deepMerge(source, {
+      radius: steps
+    });
+  }
+  if (spacing) {
+    const {
+      base,
+      ...steps
+    } = spacing;
+    if (base !== undefined) {
+      source = {
+        ...source,
+        spacing: buildSpacingScale(base)
+      };
+    }
+    source = deepMerge(source, {
+      spacing: steps
+    });
+  }
+  if (elevation) {
+    const levels = {};
+    for (const [key, level] of Object.entries(elevation)) {
+      if (!level) continue;
+      const {
+        shadowColor,
+        ...fields
+      } = level;
+      if (shadowColor !== undefined) {
+        pinnedShadowColors[key] = shadowColor;
+      }
+      levels[key] = fields;
+    }
+    source = deepMerge(source, {
+      elevation: levels
+    });
+  }
+  return {
+    source,
+    pinnedShadowColors
+  };
+}
+
+// ─── Normalized configuration ────────────────────────────────────────────────
+
+/**
+ * A validated, immutable theme configuration. `base` is the fully layered
+ * `defaults → shared → scheme` state per scheme; every accent selection is
+ * re-resolved from it rather than from a previously resolved accent.
+ */
+
+export function normalizeAccentScheme(input, path) {
+  if (input === undefined || input === null) return {
+    kind: "none"
+  };
+  if (typeof input === "string") {
+    if (!isSupportedAccentSeed(input)) {
+      throw new TerraConfigError(`${path}.seed`, `Unsupported accent seed ${JSON.stringify(input)}; expected an opaque six-digit hex color (#rrggbb).`);
+    }
+    return {
+      kind: "seed",
+      seed: input.trim()
+    };
+  }
+  if (!isPlainObject(input)) {
+    throw new TerraConfigError(path, "Expected a color string, `{ seed, overrides }`, or a theme override object.");
+  }
+  if (!("seed" in input)) {
+    return {
+      kind: "patch",
+      patch: sanitizeOverride(input)
+    };
+  }
+  const extra = Object.keys(input).filter(key => key !== "seed" && key !== "overrides");
+  if (extra.length > 0) {
+    throw new TerraConfigError(path, `A seeded accent accepts only \`seed\` and \`overrides\`; found ${extra.map(key => `\`${key}\``).join(", ")}. Use \`{ seed, overrides: { ... } }\` for color exceptions, or drop \`seed\` for a full theme override.`);
+  }
+  const {
+    seed,
+    overrides
+  } = input;
+  if (!isSupportedAccentSeed(seed)) {
+    throw new TerraConfigError(`${path}.seed`, `Unsupported accent seed ${JSON.stringify(seed)}; expected an opaque six-digit hex color (#rrggbb).`);
+  }
+  if (overrides !== undefined && !isPlainObject(overrides)) {
+    throw new TerraConfigError(`${path}.overrides`, "Expected a flat semantic color patch object.");
+  }
+  return {
+    kind: "seed",
+    seed: seed.trim(),
+    ...(overrides ? {
+      overrides: sanitizeOverride(overrides)
+    } : {})
+  };
+}
+function normalizeAccentEntry(name, accent) {
+  const path = `accents.${name}`;
+  if (!isPlainObject(accent)) {
+    throw new TerraConfigError(path, "Expected an object with `light` and/or `dark` scheme inputs.");
+  }
+  return {
+    light: normalizeAccentScheme(accent.light, `${path}.light`),
+    dark: normalizeAccentScheme(accent.dark, `${path}.dark`)
+  };
+}
+function assertOverrideObject(value, path) {
+  if (value !== undefined && !isPlainObject(value)) {
+    throw new TerraConfigError(path, "Expected a theme override object.");
+  }
+}
+
+/**
+ * Validates a theme input and pre-computes the immutable per-scheme base
+ * (`defaults → shared → scheme`). Throws {@link TerraConfigError} for invalid
+ * input — before any state exists to mutate. Never mutates `input` or the
+ * exported defaults.
+ */
+export function normalizeThemeInput(input = {}) {
+  if (!isPlainObject(input)) {
+    throw new TerraConfigError("", "Expected a configuration object.");
+  }
+  assertOverrideObject(input.shared, "shared");
+  assertOverrideObject(input.schemes, "schemes");
+  assertOverrideObject(input.schemes?.light, "schemes.light");
+  assertOverrideObject(input.schemes?.dark, "schemes.dark");
+  if (input.accents !== undefined && !isPlainObject(input.accents)) {
+    throw new TerraConfigError("accents", "Expected a record of named accents.");
+  }
+  const accents = {};
+  for (const [name, accent] of Object.entries(input.accents ?? {})) {
+    accents[name] = normalizeAccentEntry(name, accent);
+  }
+  const accentNames = Object.keys(accents);
+  let defaultAccent = null;
+  if (input.defaultAccent !== undefined && input.defaultAccent !== null) {
+    if (typeof input.defaultAccent !== "string" || !Object.hasOwn(accents, input.defaultAccent)) {
+      throw new TerraConfigError("defaultAccent", `Unknown accent ${JSON.stringify(input.defaultAccent)}; declared accents: ${accentNames.length > 0 ? accentNames.map(n => `"${n}"`).join(", ") : "(none)"}.`);
+    }
+    defaultAccent = input.defaultAccent;
+  }
+  const base = {};
+  for (const scheme of SCHEMES) {
+    let state = {
+      source: createDefaultThemeSource(scheme),
+      pinnedShadowColors: {}
+    };
+    state = applyThemeLayer(state, input.shared);
+    state = applyThemeLayer(state, input.schemes?.[scheme]);
+    base[scheme] = state;
+  }
+  return {
+    accentNames,
+    defaultAccent,
+    base,
+    accents
+  };
+}
+
+// ─── Resolution ──────────────────────────────────────────────────────────────
+
+function getAccentEntry(config, accent) {
+  if (accent === null) return undefined;
+  const entry = config.accents[accent];
+  if (entry) return entry;
+  throw new TerraConfigError("accent", `Unknown accent ${JSON.stringify(accent)}; declared accents: ${config.accentNames.length > 0 ? config.accentNames.map(name => `"${name}"`).join(", ") : "(none)"}.`);
+}
+function accentContext(scheme, source) {
+  const surfaces = {};
+  for (const role of SURFACE_ROLES) {
+    surfaces[role] = source.color[role];
+  }
+  return {
+    scheme,
+    surfaces,
+    pressedOpacity: source.opacity.pressed
+  };
+}
+function pickGeneratedRoles(color) {
+  const out = {};
+  for (const role of GENERATED_ACCENT_ROLES) {
+    out[role] = color[role];
+  }
+  return out;
+}
+function resolveScheme(scheme, base, accent) {
+  let state = base;
+  let diagnostics = [];
+  if (accent.kind === "patch") {
+    state = applyThemeLayer(state, accent.patch);
+  } else if (accent.kind === "seed") {
+    const context = accentContext(scheme, state.source);
+    const generated = generateAccentColors(accent.seed, context);
+    state = applyThemeLayer(state, {
+      color: generated.colors
+    });
+    if (accent.overrides) {
+      state = applyThemeLayer(state, {
+        color: accent.overrides
+      });
+    }
+    // The post-override check is authoritative: it evaluates the colours that
+    // actually ship, so an override that fixes a pair leaves no stale report.
+    diagnostics = checkAccentContrast(pickGeneratedRoles(state.source.color), accentContext(scheme, state.source));
+  }
+  return {
+    theme: finalizeThemeSource(state.source, state.pinnedShadowColors),
+    diagnostics
+  };
+}
+
+/**
+ * Resolves both schemes for `accent` from the config's immutable base. `null`
+ * selects the base themes; an unknown name throws {@link TerraConfigError}.
+ * Returned themes are freshly built and independently owned.
+ */
+export function resolveThemes(config, accent) {
+  const entry = getAccentEntry(config, accent);
+  const themes = {};
+  const diagnostics = [];
+  for (const scheme of SCHEMES) {
+    const resolved = resolveScheme(scheme, config.base[scheme], entry?.[scheme] ?? {
+      kind: "none"
+    });
+    themes[scheme] = resolved.theme;
+    diagnostics.push(resolved.diagnostics);
+  }
+  return {
+    themes,
+    diagnostics: diagnostics.flat()
+  };
+}
+
+/** Resolves one scheme without generating and finalizing the other. */
+export function resolveThemeScheme(config, scheme, accent) {
+  const entry = getAccentEntry(config, accent);
+  return resolveScheme(scheme, config.base[scheme], entry?.[scheme] ?? {
+    kind: "none"
+  });
+}
+
+/**
+ * Pure theme creation — no Unistyles configuration or registry involved.
+ * `options.accent` omitted → the input's `defaultAccent`; `null` → the base
+ * themes. Invalid input and unknown accents throw {@link TerraConfigError}.
+ * In development, contrast diagnostics are reported once each via
+ * `console.warn`; requested colors are never altered.
+ */
+export function createTerraThemes(input, options) {
+  const config = normalizeThemeInput(input);
+  const accent = options?.accent === undefined ? config.defaultAccent : options.accent;
+  const {
+    themes,
+    diagnostics
+  } = resolveThemes(config, accent);
+  warnContrastDiagnostics(diagnostics);
+  return themes;
+}
+//# sourceMappingURL=resolve-config.js.map

package/lib/module/theme/resolve-config.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["checkAccentContrast","GENERATED_ACCENT_ROLES","generateAccentColors","isSupportedAccentSeed","deepMerge","isPlainObject","warnContrastDiagnostics","TerraConfigError","normalizeTokenOverride","buildRadiusScale","buildSpacingScale","createDefaultThemeSource","finalizeThemeSource","SCHEMES","SURFACE_ROLES","sanitizeOverride","value","Array","isArray","map","item","out","key","Object","entries","undefined","applyThemeLayer","state","override","normalized","radius","spacing","elevation","rest","source","pinnedShadowColors","base","steps","levels","level","shadowColor","fields","normalizeAccentScheme","input","path","kind","JSON","stringify","seed","trim","patch","extra","keys","filter","length","join","overrides","normalizeAccentEntry","name","accent","light","dark","assertOverrideObject","normalizeThemeInput","shared","schemes","accents","accentNames","defaultAccent","hasOwn","n","scheme","getAccentEntry","config","entry","accentContext","surfaces","role","color","pressedOpacity","opacity","pressed","pickGeneratedRoles","resolveScheme","diagnostics","context","generated","colors","theme","resolveThemes","themes","resolved","push","flat","resolveThemeScheme","createTerraThemes","options"],"sourceRoot":"../../../src","sources":["theme/resolve-config.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/theme/runtime.js

@@ -1,25 +1,70 @@
 "use strict";
 
-import { UnistylesRuntime } from "react-native-unistyles";
-import { getRegistry, resolveTheme } from "./registry.js";
-/** Apply a named accent at runtime by updating both registered themes. */
+/**
+ * Runtime selection commands — accent and theme mode — plus the subscribed
+ * selection snapshot consumed by `useTheme()`.
+ *
+ * Every accent change re-resolves both schemes from the installed, immutable
+ * configuration (never from the previously resolved accent), hands them to
+ * Unistyles, and only then publishes the new selection. A rejected or failed
+ * change leaves both the native themes and the published selection untouched.
+ */
+import { warnContrastDiagnostics } from "./diagnostics.js";
+import { resolveThemes } from "./resolve-config.js";
+import { getInstalledConfig, getThemeSelection, publishThemeSelection } from "./selection-store.js";
+import { applyMode, updateThemes } from "./unistyles-adapter.js";
+export { getThemeSelection, subscribeThemeSelection } from "./selection-store.js";
+
+/**
+ * Apply a registered accent (`null` restores the base themes) by updating both
+ * registered themes. An unknown name warns in development and changes nothing.
+ *
+ * If the native update fails part-way (see `updateThemes` in the adapter), the
+ * error propagates and the previous selection stays published; calling
+ * `applyAccent(getCurrentAccent() ?? null)` rewrites both themes.
+ */
 export function applyAccent(name) {
-  const registry = getRegistry();
-  if (!registry.accents[name]) {
+  const config = getInstalledConfig();
+  if (name !== null && !config.accentNames.includes(name)) {
     if (__DEV__) {
       console.warn(`[react-native-terra-ui] Unknown accent "${name}".`);
     }
     return;
   }
-  registry.currentAccent = name;
-  UnistylesRuntime.updateTheme("light", () => resolveTheme("light", name));
-  UnistylesRuntime.updateTheme("dark", () => resolveTheme("dark", name));
+  const {
+    themes,
+    diagnostics
+  } = resolveThemes(config, name);
+  updateThemes(themes);
+  publishThemeSelection({
+    accent: name ?? undefined
+  });
+  warnContrastDiagnostics(diagnostics);
 }
-export const getCurrentAccent = () => getRegistry().currentAccent;
 
-/** Switch the active color scheme, disabling adaptive (system) theming. */
+/** The applied accent name, or `undefined` for the base themes. */
+export const getCurrentAccent = () => getThemeSelection().accent;
+
+/**
+ * Choose how the active scheme is selected: `system` follows the OS appearance;
+ * `light` / `dark` pin a scheme until the next call.
+ */
+export function setThemeMode(mode) {
+  applyMode(mode);
+  publishThemeSelection({
+    mode
+  });
+}
+
+/** The current theme mode. A system appearance change does not change it. */
+export const getThemeMode = () => getThemeSelection().mode;
+
+/**
+ * Pin the active color scheme, disabling adaptive (system) theming.
+ * Compatibility wrapper for `setThemeMode(scheme)`; use `setThemeMode("system")`
+ * to return to the OS preference.
+ */
 export function applyScheme(scheme) {
-  UnistylesRuntime.setAdaptiveThemes(false);
-  UnistylesRuntime.setTheme(scheme);
+  setThemeMode(scheme);
 }
 //# sourceMappingURL=runtime.js.map

package/lib/module/theme/runtime.js.map

@@ -1 +1 @@
-{"version":3,"names":["UnistylesRuntime","getRegistry","resolveTheme","applyAccent","name","registry","accents","__DEV__","console","warn","currentAccent","updateTheme","getCurrentAccent","applyScheme","scheme","setAdaptiveThemes","setTheme"],"sourceRoot":"../../../src","sources":["theme/runtime.ts"],"mappings":";;AAAA,SAASA,gBAAgB,QAAQ,wBAAwB;AAEzD,SAASC,WAAW,EAAEC,YAAY;AAGlC;AACA,OAAO,SAASC,WAAWA,CAACC,IAAY,EAAQ;EAC9C,MAAMC,QAAQ,GAAGJ,WAAW,CAAC,CAAC;EAC9B,IAAI,CAACI,QAAQ,CAACC,OAAO,CAACF,IAAI,CAAC,EAAE;IAC3B,IAAIG,OAAO,EAAE;MACXC,OAAO,CAACC,IAAI,CAAC,2CAA2CL,IAAI,IAAI,CAAC;IACnE;IACA;EACF;EACAC,QAAQ,CAACK,aAAa,GAAGN,IAAI;EAC7BJ,gBAAgB,CAACW,WAAW,CAAC,OAAO,EAAE,MAAMT,YAAY,CAAC,OAAO,EAAEE,IAAI,CAAC,CAAC;EACxEJ,gBAAgB,CAACW,WAAW,CAAC,MAAM,EAAE,MAAMT,YAAY,CAAC,MAAM,EAAEE,IAAI,CAAC,CAAC;AACxE;AAEA,OAAO,MAAMQ,gBAAgB,GAAGA,CAAA,KAA0BX,WAAW,CAAC,CAAC,CAACS,aAAa;;AAErF;AACA,OAAO,SAASG,WAAWA,CAACC,MAAc,EAAQ;EAChDd,gBAAgB,CAACe,iBAAiB,CAAC,KAAK,CAAC;EACzCf,gBAAgB,CAACgB,QAAQ,CAACF,MAAM,CAAC;AACnC","ignoreList":[]}
+{"version":3,"names":["warnContrastDiagnostics","resolveThemes","getInstalledConfig","getThemeSelection","publishThemeSelection","applyMode","updateThemes","subscribeThemeSelection","applyAccent","name","config","accentNames","includes","__DEV__","console","warn","themes","diagnostics","accent","undefined","getCurrentAccent","setThemeMode","mode","getThemeMode","applyScheme","scheme"],"sourceRoot":"../../../src","sources":["theme/runtime.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,uBAAuB;AAChC,SAASC,aAAa;AACtB,SAASC,kBAAkB,EAAEC,iBAAiB,EAAEC,qBAAqB;AAErE,SAASC,SAAS,EAAEC,YAAY;AAGhC,SAASH,iBAAiB,EAAEI,uBAAuB;;AAEnD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAACC,IAAmB,EAAQ;EACrD,MAAMC,MAAM,GAAGR,kBAAkB,CAAC,CAAC;EACnC,IAAIO,IAAI,KAAK,IAAI,IAAI,CAACC,MAAM,CAACC,WAAW,CAACC,QAAQ,CAACH,IAAI,CAAC,EAAE;IACvD,IAAII,OAAO,EAAE;MACXC,OAAO,CAACC,IAAI,CAAC,2CAA2CN,IAAI,IAAI,CAAC;IACnE;IACA;EACF;EAEA,MAAM;IAAEO,MAAM;IAAEC;EAAY,CAAC,GAAGhB,aAAa,CAACS,MAAM,EAAED,IAAI,CAAC;EAC3DH,YAAY,CAACU,MAAM,CAAC;EACpBZ,qBAAqB,CAAC;IAAEc,MAAM,EAAET,IAAI,IAAIU;EAAU,CAAC,CAAC;EACpDnB,uBAAuB,CAACiB,WAAW,CAAC;AACtC;;AAEA;AACA,OAAO,MAAMG,gBAAgB,GAAGA,CAAA,KAA0BjB,iBAAiB,CAAC,CAAC,CAACe,MAAM;;AAEpF;AACA;AACA;AACA;AACA,OAAO,SAASG,YAAYA,CAACC,IAAe,EAAQ;EAClDjB,SAAS,CAACiB,IAAI,CAAC;EACflB,qBAAqB,CAAC;IAAEkB;EAAK,CAAC,CAAC;AACjC;;AAEA;AACA,OAAO,MAAMC,YAAY,GAAGA,CAAA,KAAiBpB,iBAAiB,CAAC,CAAC,CAACmB,IAAI;;AAErE;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,WAAWA,CAACC,MAAc,EAAQ;EAChDJ,YAAY,CAACI,MAAM,CAAC;AACtB","ignoreList":[]}

package/lib/module/theme/screen-margin.js

@@ -1,17 +1,9 @@
 "use strict";
 
-import { resolveBreakpointValue } from "./breakpoints.js";
-/**
- * Resolves both axes of `theme.layout.screen.margin` for the current runtime
- * breakpoint in one call — nearly every consumer needs both axes, so this
- * saves calling `resolveBreakpointValue` twice. Call inside a
- * `StyleSheet.create` factory (passing `rt.breakpoint`) so the result stays
- * reactive to breakpoint changes; outside one, use {@link useScreenMargin}.
- */
-export function resolveScreenMargin(theme, breakpoint) {
-  return {
-    x: resolveBreakpointValue(theme.layout.screen.margin.x, breakpoint),
-    y: resolveBreakpointValue(theme.layout.screen.margin.y, breakpoint)
-  };
-}
+import { resolveScreenPadding } from "./screen-padding.js";
+
+/** @deprecated Use ResolvedScreenPadding. */
+
+/** @deprecated Use resolveScreenPadding. */
+export const resolveScreenMargin = resolveScreenPadding;
 //# sourceMappingURL=screen-margin.js.map

package/lib/module/theme/screen-margin.js.map

@@ -1 +1 @@
-{"version":3,"names":["resolveBreakpointValue","resolveScreenMargin","theme","breakpoint","x","layout","screen","margin","y"],"sourceRoot":"../../../src","sources":["theme/screen-margin.ts"],"mappings":";;AAEA,SAASA,sBAAsB;AAQ/B;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CACjCC,KAAiB,EACjBC,UAAkD,EAC5B;EACtB,OAAO;IACLC,CAAC,EAAEJ,sBAAsB,CAACE,KAAK,CAACG,MAAM,CAACC,MAAM,CAACC,MAAM,CAACH,CAAC,EAAED,UAAU,CAAC;IACnEK,CAAC,EAAER,sBAAsB,CAACE,KAAK,CAACG,MAAM,CAACC,MAAM,CAACC,MAAM,CAACC,CAAC,EAAEL,UAAU;EACpE,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["resolveScreenPadding","resolveScreenMargin"],"sourceRoot":"../../../src","sources":["theme/screen-margin.ts"],"mappings":";;AACA,SAASA,oBAAoB;;AAE7B;;AAEA;AACA,OAAO,MAAMC,mBAAmB,GAAGD,oBAAoB","ignoreList":[]}

package/lib/module/theme/screen-padding.js

@@ -0,0 +1,17 @@
+"use strict";
+
+import { resolveBreakpointValue } from "./breakpoints.js";
+/**
+ * Resolves both axes of `theme.layout.screen.padding` for the current runtime
+ * breakpoint in one call — nearly every consumer needs both axes, so this
+ * saves calling `resolveBreakpointValue` twice. Call inside a
+ * `StyleSheet.create` factory (passing `rt.breakpoint`) so the result stays
+ * reactive to breakpoint changes; outside one, use {@link useScreenPadding}.
+ */
+export function resolveScreenPadding(theme, breakpoint) {
+  return {
+    x: resolveBreakpointValue(theme.layout.screen.padding.x, breakpoint),
+    y: resolveBreakpointValue(theme.layout.screen.padding.y, breakpoint)
+  };
+}
+//# sourceMappingURL=screen-padding.js.map

package/lib/module/theme/screen-padding.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["resolveBreakpointValue","resolveScreenPadding","theme","breakpoint","x","layout","screen","padding","y"],"sourceRoot":"../../../src","sources":["theme/screen-padding.ts"],"mappings":";;AAEA,SAASA,sBAAsB;AAQ/B;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAClCC,KAAiB,EACjBC,UAAkD,EAC3B;EACvB,OAAO;IACLC,CAAC,EAAEJ,sBAAsB,CAACE,KAAK,CAACG,MAAM,CAACC,MAAM,CAACC,OAAO,CAACH,CAAC,EAAED,UAAU,CAAC;IACpEK,CAAC,EAAER,sBAAsB,CAACE,KAAK,CAACG,MAAM,CAACC,MAAM,CAACC,OAAO,CAACC,CAAC,EAAEL,UAAU;EACrE,CAAC;AACH","ignoreList":[]}

package/lib/module/theme/selection-store.js

@@ -0,0 +1,75 @@
+"use strict";
+
+/**
+ * Internal runtime state shared by `registry.ts` (installation) and
+ * `runtime.ts` (selection commands). Lives in its own module so neither of
+ * those has to import the other.
+ *
+ * Holds two things, both private to `theme/`:
+ * - the installed {@link NormalizedThemeConfig} — immutable; every accent
+ *   selection is re-resolved from it, never layered on a previous result;
+ * - the selection snapshot (`accent`, `mode`) behind a `useSyncExternalStore`
+ *   compatible subscribe/get pair. The snapshot object keeps its identity until
+ *   a value actually changes, so subscribers only re-render on real changes.
+ *
+ * Nothing here touches Unistyles. Callers publish *after* native work succeeds.
+ */
+import { normalizeThemeInput } from "./resolve-config.js";
+// ─── Installed configuration ─────────────────────────────────────────────────
+
+/**
+ * Before any configure call the built-in defaults are "installed", matching
+ * the previous behaviour where `resolveTheme` worked pre-configuration.
+ */
+let installedConfig = normalizeThemeInput({});
+
+/** @internal Read-only handle on the installed config. */
+export const getInstalledConfig = () => installedConfig;
+
+/** @internal Replaces the installed config; only `registry.ts` should call this. */
+export function setInstalledConfig(config) {
+  installedConfig = config;
+}
+
+// ─── Selection snapshot ──────────────────────────────────────────────────────
+
+/** The current runtime selection: which accent is applied and how the scheme is chosen. */
+
+let selection = Object.freeze({
+  accent: undefined,
+  mode: "system"
+});
+const listeners = new Set();
+
+/**
+ * Current selection snapshot. Stable identity: the same object is returned
+ * until {@link publishThemeSelection} commits a real change, which makes it a
+ * valid `getSnapshot` for `useSyncExternalStore`.
+ */
+export const getThemeSelection = () => selection;
+
+/** Subscribe to selection changes. Returns the unsubscribe function. */
+export function subscribeThemeSelection(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
+/**
+ * @internal Commits a (partial) selection change and notifies subscribers.
+ * A no-op — same snapshot identity, no notification — when nothing changed.
+ */
+export function publishThemeSelection(next) {
+  const accent = "accent" in next ? next.accent : selection.accent;
+  const mode = next.mode ?? selection.mode;
+  if (accent === selection.accent && mode === selection.mode) return;
+  selection = Object.freeze({
+    accent,
+    mode
+  });
+  for (const listener of listeners) {
+    listener();
+  }
+}
+//# sourceMappingURL=selection-store.js.map

package/lib/module/theme/selection-store.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["normalizeThemeInput","installedConfig","getInstalledConfig","setInstalledConfig","config","selection","Object","freeze","accent","undefined","mode","listeners","Set","getThemeSelection","subscribeThemeSelection","listener","add","delete","publishThemeSelection","next"],"sourceRoot":"../../../src","sources":["theme/selection-store.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAqCA,mBAAmB;AAGxD;;AAEA;AACA;AACA;AACA;AACA,IAAIC,eAAsC,GAAGD,mBAAmB,CAAC,CAAC,CAAC,CAAC;;AAEpE;AACA,OAAO,MAAME,kBAAkB,GAAGA,CAAA,KAA6BD,eAAe;;AAE9E;AACA,OAAO,SAASE,kBAAkBA,CAACC,MAA6B,EAAQ;EACtEH,eAAe,GAAGG,MAAM;AAC1B;;AAEA;;AAEA;;AAQA,IAAIC,SAAyB,GAAGC,MAAM,CAACC,MAAM,CAAC;EAAEC,MAAM,EAAEC,SAAS;EAAEC,IAAI,EAAE;AAAsB,CAAC,CAAC;AAEjG,MAAMC,SAAS,GAAG,IAAIC,GAAG,CAAa,CAAC;;AAEvC;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAAGA,CAAA,KAAsBR,SAAS;;AAEhE;AACA,OAAO,SAASS,uBAAuBA,CAACC,QAAoB,EAAc;EACxEJ,SAAS,CAACK,GAAG,CAACD,QAAQ,CAAC;EACvB,OAAO,MAAM;IACXJ,SAAS,CAACM,MAAM,CAACF,QAAQ,CAAC;EAC5B,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASG,qBAAqBA,CAACC,IAA6B,EAAQ;EACzE,MAAMX,MAAM,GAAG,QAAQ,IAAIW,IAAI,GAAGA,IAAI,CAACX,MAAM,GAAGH,SAAS,CAACG,MAAM;EAChE,MAAME,IAAI,GAAGS,IAAI,CAACT,IAAI,IAAIL,SAAS,CAACK,IAAI;EACxC,IAAIF,MAAM,KAAKH,SAAS,CAACG,MAAM,IAAIE,IAAI,KAAKL,SAAS,CAACK,IAAI,EAAE;EAE5DL,SAAS,GAAGC,MAAM,CAACC,MAAM,CAAC;IAAEC,MAAM;IAAEE;EAAK,CAAC,CAAC;EAC3C,KAAK,MAAMK,QAAQ,IAAIJ,SAAS,EAAE;IAChCI,QAAQ,CAAC,CAAC;EACZ;AACF","ignoreList":[]}