@almadar/ui 6.29.0 → 6.31.0

package/dist/providers/index.js

@@ -13789,11 +13789,10 @@ var init_HeroSection = __esm({
     };
     backgroundStyles = {
       dark: "bg-foreground text-background",
-      gradient: [
-        "bg-[radial-gradient(ellipse_at_top,var(--color-primary)/0.08,transparent_60%),",
-        "radial-gradient(ellipse_at_bottom_right,var(--color-accent)/0.06,transparent_50%)]",
-        "bg-background"
-      ].join(" "),
+      // A single bracket value: joining this as two array entries put a space
+      // inside the class (Tailwind splits utilities on whitespace), so neither
+      // half was a valid utility and the gradient rendered as nothing.
+      gradient: "bg-[radial-gradient(ellipse_at_top,var(--color-primary)/0.08,transparent_60%),radial-gradient(ellipse_at_bottom_right,var(--color-accent)/0.06,transparent_50%)] bg-background",
       subtle: "bg-muted/30"
     };
     MarketingImage = ({ src, alt, className }) => /* @__PURE__ */ jsx(
@@ -54123,17 +54122,127 @@ function OrbitalProvider({
 OrbitalProvider.displayName = "OrbitalProvider";
 
 // lib/themeTokens.ts
+function applyFlat(obj, table, vars) {
+  if (!obj) return;
+  for (const { cssVar, key } of table) {
+    const value = obj[key];
+    if (value !== void 0) vars[cssVar] = value;
+  }
+}
+var DENSITY_SPACING_VARS = [
+  { cssVar: "--space-0", key: "space0" },
+  { cssVar: "--space-1", key: "space1" },
+  { cssVar: "--space-2", key: "space2" },
+  { cssVar: "--space-3", key: "space3" },
+  { cssVar: "--space-4", key: "space4" },
+  { cssVar: "--space-5", key: "space5" },
+  { cssVar: "--space-6", key: "space6" },
+  { cssVar: "--space-7", key: "space7" },
+  { cssVar: "--space-8", key: "space8" },
+  { cssVar: "--space-9", key: "space9" },
+  { cssVar: "--space-10", key: "space10" },
+  { cssVar: "--space-11", key: "space11" },
+  { cssVar: "--space-12", key: "space12" }
+];
+var DENSITY_ELEMENT_VARS = [
+  { cssVar: "--button-height-sm", key: "buttonHeightSm" },
+  { cssVar: "--button-height-md", key: "buttonHeightMd" },
+  { cssVar: "--button-height-lg", key: "buttonHeightLg" },
+  { cssVar: "--input-height-sm", key: "inputHeightSm" },
+  { cssVar: "--input-height-md", key: "inputHeightMd" },
+  { cssVar: "--input-height-lg", key: "inputHeightLg" },
+  { cssVar: "--row-height-compact", key: "rowHeightCompact" },
+  { cssVar: "--row-height-normal", key: "rowHeightNormal" },
+  { cssVar: "--row-height-spacious", key: "rowHeightSpacious" },
+  { cssVar: "--card-padding-sm", key: "cardPaddingSm" },
+  { cssVar: "--card-padding-md", key: "cardPaddingMd" },
+  { cssVar: "--card-padding-lg", key: "cardPaddingLg" },
+  { cssVar: "--dialog-padding", key: "dialogPadding" },
+  { cssVar: "--section-gap", key: "sectionGap" }
+];
+var TYPE_FAMILY_VARS = [
+  { cssVar: "--font-family-display", key: "displayFamily" },
+  { cssVar: "--font-family-body", key: "bodyFamily" },
+  { cssVar: "--font-family-mono", key: "monoFamily" }
+];
+var TYPE_SIZE_KEYS = [
+  "xs",
+  "sm",
+  "base",
+  "lg",
+  "xl",
+  "2xl",
+  "3xl",
+  "4xl",
+  "display-1",
+  "display-2"
+];
+var TYPE_INTENT_VARS = [
+  { key: "headingMajor", cssName: "heading-major" },
+  { key: "headingMinor", cssName: "heading-minor" },
+  { key: "bodyEmphasis", cssName: "body-emphasis" },
+  { key: "bodyDefault", cssName: "body-default" },
+  { key: "bodyQuiet", cssName: "body-quiet" },
+  { key: "caption", cssName: "caption" },
+  { key: "numeric", cssName: "numeric" }
+];
+var MOTION_DURATION_KEYS = [
+  "instant",
+  "fast",
+  "normal",
+  "slow",
+  "dramatic"
+];
+var MOTION_EASING_KEYS = [
+  "linear",
+  "standard",
+  "emphasized",
+  "spring"
+];
+var MOTION_INTENT_VARS = [
+  { key: "enter", cssName: "enter" },
+  { key: "exit", cssName: "exit" },
+  { key: "hover", cssName: "hover" },
+  { key: "press", cssName: "press" },
+  { key: "expand", cssName: "expand" },
+  { key: "transition", cssName: "transition" }
+];
+var ICONOGRAPHY_VARS = [
+  { cssVar: "--icon-family", key: "family" },
+  { cssVar: "--icon-stroke-width", key: "strokeWidth" },
+  { cssVar: "--icon-default-size", key: "defaultSize" }
+];
+var ELEVATION_VARS = [
+  { cssVar: "--elevation-card", key: "cardElevation" },
+  { cssVar: "--elevation-popover", key: "popoverElevation" },
+  { cssVar: "--elevation-dialog", key: "dialogElevation" },
+  { cssVar: "--elevation-toast", key: "toastElevation" }
+];
+var GEOMETRY_VARS = [
+  { cssVar: "--radius-container", key: "radiusContainer" },
+  { cssVar: "--radius-interactive", key: "radiusInteractive" },
+  { cssVar: "--radius-pill", key: "radiusPill" },
+  { cssVar: "--border-hairline", key: "borderHairline" },
+  { cssVar: "--border-standard", key: "borderStandard" },
+  { cssVar: "--border-heavy", key: "borderHeavy" }
+];
+var LEGACY_PREFIXES = {
+  colors: "--color-",
+  radii: "--radius-",
+  spacing: "--space-",
+  shadows: "--shadow-"
+};
 function themeTokensToCssVars(tokens, mode = "light", darkVariant) {
   const vars = {};
   const isDark = mode === "dark";
   const pickColors = isDark && darkVariant?.colors ? darkVariant.colors : tokens.colors;
   if (pickColors) {
     for (const [key, value] of Object.entries(pickColors)) {
-      vars[`--color-${key}`] = value;
+      vars[`${LEGACY_PREFIXES.colors}${key}`] = value;
     }
     if (isDark && darkVariant?.colors && tokens.colors) {
       for (const [key, value] of Object.entries(tokens.colors)) {
-        const varName = `--color-${key}`;
+        const varName = `${LEGACY_PREFIXES.colors}${key}`;
         if (!(varName in vars)) vars[varName] = value;
       }
     }
@@ -54141,13 +54250,13 @@ function themeTokensToCssVars(tokens, mode = "light", darkVariant) {
   const pickRadii = isDark && darkVariant?.radii ? darkVariant.radii : tokens.radii;
   if (pickRadii) {
     for (const [key, value] of Object.entries(pickRadii)) {
-      vars[`--radius-${key}`] = value;
+      vars[`${LEGACY_PREFIXES.radii}${key}`] = value;
     }
   }
   const pickSpacing = isDark && darkVariant?.spacing ? darkVariant.spacing : tokens.spacing;
   if (pickSpacing) {
     for (const [key, value] of Object.entries(pickSpacing)) {
-      vars[`--space-${key}`] = value;
+      vars[`${LEGACY_PREFIXES.spacing}${key}`] = value;
     }
   }
   const pickTypography = isDark && darkVariant?.typography ? darkVariant.typography : tokens.typography;
@@ -54159,7 +54268,7 @@ function themeTokensToCssVars(tokens, mode = "light", darkVariant) {
   const pickShadows = isDark && darkVariant?.shadows ? darkVariant.shadows : tokens.shadows;
   if (pickShadows) {
     for (const [key, value] of Object.entries(pickShadows)) {
-      vars[`--shadow-${key}`] = value;
+      vars[`${LEGACY_PREFIXES.shadows}${key}`] = value;
     }
   }
   const pickDensity = isDark && darkVariant?.density ? darkVariant.density : tokens.density;
@@ -54178,46 +54287,8 @@ function themeTokensToCssVars(tokens, mode = "light", darkVariant) {
 }
 function emitDensity(density, vars) {
   if (!density) return;
-  if (density.spacing) {
-    const s = density.spacing;
-    const pairs2 = [
-      ["0", s.space0],
-      ["1", s.space1],
-      ["2", s.space2],
-      ["3", s.space3],
-      ["4", s.space4],
-      ["5", s.space5],
-      ["6", s.space6],
-      ["7", s.space7],
-      ["8", s.space8],
-      ["9", s.space9],
-      ["10", s.space10],
-      ["11", s.space11],
-      ["12", s.space12]
-    ];
-    for (const [k, v] of pairs2) {
-      if (v !== void 0) vars[`--space-${k}`] = v;
-    }
-  }
-  const pairs = [
-    ["button-height-sm", density.buttonHeightSm],
-    ["button-height-md", density.buttonHeightMd],
-    ["button-height-lg", density.buttonHeightLg],
-    ["input-height-sm", density.inputHeightSm],
-    ["input-height-md", density.inputHeightMd],
-    ["input-height-lg", density.inputHeightLg],
-    ["row-height-compact", density.rowHeightCompact],
-    ["row-height-normal", density.rowHeightNormal],
-    ["row-height-spacious", density.rowHeightSpacious],
-    ["card-padding-sm", density.cardPaddingSm],
-    ["card-padding-md", density.cardPaddingMd],
-    ["card-padding-lg", density.cardPaddingLg],
-    ["dialog-padding", density.dialogPadding],
-    ["section-gap", density.sectionGap]
-  ];
-  for (const [k, v] of pairs) {
-    if (v !== void 0) vars[`--${k}`] = v;
-  }
+  applyFlat(density.spacing, DENSITY_SPACING_VARS, vars);
+  applyFlat(density, DENSITY_ELEMENT_VARS, vars);
 }
 function typeSizeKeyStr(k) {
   return k;
@@ -54234,24 +54305,11 @@ function emitTypeIntent(name, intent, vars) {
 }
 function emitTypeScale(ts, vars) {
   if (!ts) return;
-  if (ts.displayFamily !== void 0) vars["--font-family-display"] = ts.displayFamily;
-  if (ts.bodyFamily !== void 0) vars["--font-family-body"] = ts.bodyFamily;
-  if (ts.monoFamily !== void 0) vars["--font-family-mono"] = ts.monoFamily;
+  applyFlat(ts, TYPE_FAMILY_VARS, vars);
   if (ts.scale) {
     const s = ts.scale;
-    const pairs = [
-      ["xs", s.xs],
-      ["sm", s.sm],
-      ["base", s.base],
-      ["lg", s.lg],
-      ["xl", s.xl],
-      ["2xl", s["2xl"]],
-      ["3xl", s["3xl"]],
-      ["4xl", s["4xl"]],
-      ["display-1", s["display-1"]],
-      ["display-2", s["display-2"]]
-    ];
-    for (const [k, entry] of pairs) {
+    for (const k of TYPE_SIZE_KEYS) {
+      const entry = s[k];
       if (entry !== void 0) {
         vars[`--text-${k}`] = entry.size;
         vars[`--leading-${k}`] = entry.lineHeight;
@@ -54260,13 +54318,10 @@ function emitTypeScale(ts, vars) {
   }
   if (ts.intents) {
     const i = ts.intents;
-    if (i.headingMajor) emitTypeIntent("heading-major", i.headingMajor, vars);
-    if (i.headingMinor) emitTypeIntent("heading-minor", i.headingMinor, vars);
-    if (i.bodyEmphasis) emitTypeIntent("body-emphasis", i.bodyEmphasis, vars);
-    if (i.bodyDefault) emitTypeIntent("body-default", i.bodyDefault, vars);
-    if (i.bodyQuiet) emitTypeIntent("body-quiet", i.bodyQuiet, vars);
-    if (i.caption) emitTypeIntent("caption", i.caption, vars);
-    if (i.numeric) emitTypeIntent("numeric", i.numeric, vars);
+    for (const { key, cssName } of TYPE_INTENT_VARS) {
+      const intent = i[key];
+      if (intent) emitTypeIntent(cssName, intent, vars);
+    }
   }
 }
 function emitMotionIntent(name, intent, vars) {
@@ -54277,60 +54332,34 @@ function emitMotion(m, vars) {
   if (!m) return;
   if (m.durations) {
     const d = m.durations;
-    const pairs = [
-      ["instant", d.instant],
-      ["fast", d.fast],
-      ["normal", d.normal],
-      ["slow", d.slow],
-      ["dramatic", d.dramatic]
-    ];
-    for (const [k, v] of pairs) {
+    for (const k of MOTION_DURATION_KEYS) {
+      const v = d[k];
       if (v !== void 0) vars[`--duration-${k}`] = v;
     }
   }
   if (m.easings) {
     const e = m.easings;
-    const pairs = [
-      ["linear", e.linear],
-      ["standard", e.standard],
-      ["emphasized", e.emphasized],
-      ["spring", e.spring]
-    ];
-    for (const [k, v] of pairs) {
+    for (const k of MOTION_EASING_KEYS) {
+      const v = e[k];
       if (v !== void 0) vars[`--easing-${k}`] = v;
     }
   }
   if (m.intents) {
     const i = m.intents;
-    if (i.enter) emitMotionIntent("enter", i.enter, vars);
-    if (i.exit) emitMotionIntent("exit", i.exit, vars);
-    if (i.hover) emitMotionIntent("hover", i.hover, vars);
-    if (i.press) emitMotionIntent("press", i.press, vars);
-    if (i.expand) emitMotionIntent("expand", i.expand, vars);
-    if (i.transition) emitMotionIntent("transition", i.transition, vars);
+    for (const { key, cssName } of MOTION_INTENT_VARS) {
+      const intent = i[key];
+      if (intent) emitMotionIntent(cssName, intent, vars);
+    }
   }
 }
 function emitIconography(i, vars) {
-  if (!i) return;
-  if (i.family !== void 0) vars["--icon-family"] = i.family;
-  if (i.strokeWidth !== void 0) vars["--icon-stroke-width"] = i.strokeWidth;
-  if (i.defaultSize !== void 0) vars["--icon-default-size"] = i.defaultSize;
+  applyFlat(i, ICONOGRAPHY_VARS, vars);
 }
 function emitElevation(e, vars) {
-  if (!e) return;
-  if (e.cardElevation !== void 0) vars["--elevation-card"] = e.cardElevation;
-  if (e.popoverElevation !== void 0) vars["--elevation-popover"] = e.popoverElevation;
-  if (e.dialogElevation !== void 0) vars["--elevation-dialog"] = e.dialogElevation;
-  if (e.toastElevation !== void 0) vars["--elevation-toast"] = e.toastElevation;
+  applyFlat(e, ELEVATION_VARS, vars);
 }
 function emitGeometry(g, vars) {
-  if (!g) return;
-  if (g.radiusContainer !== void 0) vars["--radius-container"] = g.radiusContainer;
-  if (g.radiusInteractive !== void 0) vars["--radius-interactive"] = g.radiusInteractive;
-  if (g.radiusPill !== void 0) vars["--radius-pill"] = g.radiusPill;
-  if (g.borderHairline !== void 0) vars["--border-hairline"] = g.borderHairline;
-  if (g.borderStandard !== void 0) vars["--border-standard"] = g.borderStandard;
-  if (g.borderHeavy !== void 0) vars["--border-heavy"] = g.borderHeavy;
+  applyFlat(g, GEOMETRY_VARS, vars);
 }
 function resolveThemeForRuntime(theme) {
   if (theme === void 0) return void 0;
@@ -54934,8 +54963,8 @@ function ServerBridgeProvider({
           dataEntities,
           data: responseData,
           entityByTrait: result.entityByTrait,
-          emittedEvents: result.emittedEvents?.map((e) => e.event) ?? [],
-          emitted: result.emittedEvents?.map((e) => ({ event: e.event, ...e.payload !== void 0 && { payload: e.payload } })) ?? [],
+          emittedEvents: result.emittedEvents.map((e) => e.event),
+          emitted: result.emittedEvents.map((e) => ({ event: e.event, ...e.payload !== void 0 && { payload: e.payload } })),
           effectResults: result.effectResults,
           error: result.error
         };
@@ -54970,10 +54999,8 @@ function ServerBridgeProvider({
               effects.push({ type: "navigate-back", traitName });
             }
           }
-          if (result.emittedEvents) {
-            for (const emitted of stampLocallyDeliveredEchoes(event, result.emittedEvents, locallyEmitted ?? [])) {
-              reEmitServerEvent(eventBus, emitted, orbitalName);
-            }
+          for (const emitted of stampLocallyDeliveredEchoes(event, result.emittedEvents, locallyEmitted ?? [])) {
+            reEmitServerEvent(eventBus, emitted, orbitalName);
           }
         } else if (result.error) {
           xOrbitalLog.warn("response:fail", {

package/dist/runtime/index.cjs

@@ -13942,11 +13942,10 @@ var init_HeroSection = __esm({
     };
     backgroundStyles = {
       dark: "bg-foreground text-background",
-      gradient: [
-        "bg-[radial-gradient(ellipse_at_top,var(--color-primary)/0.08,transparent_60%),",
-        "radial-gradient(ellipse_at_bottom_right,var(--color-accent)/0.06,transparent_50%)]",
-        "bg-background"
-      ].join(" "),
+      // A single bracket value: joining this as two array entries put a space
+      // inside the class (Tailwind splits utilities on whitespace), so neither
+      // half was a valid utility and the gradient rendered as nothing.
+      gradient: "bg-[radial-gradient(ellipse_at_top,var(--color-primary)/0.08,transparent_60%),radial-gradient(ellipse_at_bottom_right,var(--color-accent)/0.06,transparent_50%)] bg-background",
       subtle: "bg-muted/30"
     };
     MarketingImage = ({ src, alt, className }) => /* @__PURE__ */ jsxRuntime.jsx(
@@ -54981,7 +54980,7 @@ function normalizeChild(child) {
 function effectResultsToTraces(results) {
   if (!results) return [];
   return results.map((r) => {
-    const resultId = r.data !== void 0 && r.data !== null && "id" in r.data && typeof r.data.id === "string" ? r.data.id : void 0;
+    const resultId = typeof r.data === "object" && r.data !== null && !Array.isArray(r.data) && "id" in r.data && typeof r.data.id === "string" ? r.data.id : void 0;
     const outcome = r.denied ? "denied" : r.success ? "success" : "failed";
     return {
       type: r.effect,

package/dist/runtime/index.d.cts

@@ -5,8 +5,8 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, TransitionResult, EffectHandlers } from '@almadar/runtime';
 import { K as KeyCaptureTable } from '../useKeyboardRouter-CVn8lfiX.cjs';
 import { c as useUISlots } from '../UISlotContext-BlRDbHDy.cjs';
-import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-UyeCfEBS.cjs';
-export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-UyeCfEBS.cjs';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-ChCONv2W.cjs';
+export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-ChCONv2W.cjs';
 import '../verificationRegistry-DTrKDRoa.cjs';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ReactNode } from 'react';

package/dist/runtime/index.d.ts

@@ -5,8 +5,8 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, TransitionResult, EffectHandlers } from '@almadar/runtime';
 import { K as KeyCaptureTable } from '../useKeyboardRouter-B1pIi9jo.js';
 import { c as useUISlots } from '../UISlotContext-CB89mv7N.js';
-import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-UyeCfEBS.js';
-export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-UyeCfEBS.js';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-ChCONv2W.js';
+export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-ChCONv2W.js';
 import '../verificationRegistry-Cwa52VyK.js';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ReactNode } from 'react';

package/dist/runtime/index.js

@@ -13868,11 +13868,10 @@ var init_HeroSection = __esm({
     };
     backgroundStyles = {
       dark: "bg-foreground text-background",
-      gradient: [
-        "bg-[radial-gradient(ellipse_at_top,var(--color-primary)/0.08,transparent_60%),",
-        "radial-gradient(ellipse_at_bottom_right,var(--color-accent)/0.06,transparent_50%)]",
-        "bg-background"
-      ].join(" "),
+      // A single bracket value: joining this as two array entries put a space
+      // inside the class (Tailwind splits utilities on whitespace), so neither
+      // half was a valid utility and the gradient rendered as nothing.
+      gradient: "bg-[radial-gradient(ellipse_at_top,var(--color-primary)/0.08,transparent_60%),radial-gradient(ellipse_at_bottom_right,var(--color-accent)/0.06,transparent_50%)] bg-background",
       subtle: "bg-muted/30"
     };
     MarketingImage = ({ src, alt, className }) => /* @__PURE__ */ jsx(
@@ -54907,7 +54906,7 @@ function normalizeChild(child) {
 function effectResultsToTraces(results) {
   if (!results) return [];
   return results.map((r) => {
-    const resultId = r.data !== void 0 && r.data !== null && "id" in r.data && typeof r.data.id === "string" ? r.data.id : void 0;
+    const resultId = typeof r.data === "object" && r.data !== null && !Array.isArray(r.data) && "id" in r.data && typeof r.data.id === "string" ? r.data.id : void 0;
     const outcome = r.denied ? "denied" : r.success ? "success" : "failed";
     return {
       type: r.effect,

package/dist/themeTokens-DVRwufw8.d.cts

@@ -0,0 +1,112 @@
+import { ThemeRef, ThemeDefinition, ThemeTokens, ThemeVariant, DensityTokens, ElevationTokens, GeometryTokens, IconographyTokens, MotionDurationKey, MotionEasingKey, MotionIntentMap, TypeScaleTokens, TypeIntentMap, TypeSizeKey } from '@almadar/core';
+
+/**
+ * themeTokens — runtime mirror of the orbital compiler's theme codegen.
+ *
+ * The compile path (orbital-rust/crates/orbital-shell-typescript/src/codegen/theme.rs)
+ * reads `OrbitalDefinition.theme.tokens` and emits CSS custom-property
+ * declarations into a `[data-theme="<name>-<mode>"]` block. The runtime
+ * does not parse compiled CSS — it reads the same `tokens` object directly
+ * and produces the same `{ '--color-primary': '…', '--radius-md': '…' }` map
+ * that the compiler emits.
+ *
+ * Keeping the two paths byte-identical at the variable level is the contract:
+ * editing tokens via the Studio Design System tab must produce the exact
+ * same rendered result as editing them in source and running `orbital
+ * compile`. The mapping rules here mirror `generate_tokens_css` /
+ * `generate_tokens_css_dark` (theme.rs:122–351).
+ *
+ * Compile vs runtime difference (intentional):
+ * - Compile emits the FULL set: schema overrides on top of defaults. This is
+ *   needed because the compiled CSS replaces the theme entirely.
+ * - Runtime emits ONLY the keys present in `tokens` (and `variants.dark`).
+ *   Missing keys cascade from the parent `[data-theme]` rule on the document
+ *   element. The provider scopes overrides to an orbital subtree without
+ *   shadowing inherited defaults.
+ *
+ * The per-axis var tables below (`DENSITY_SPACING_VARS`, `TYPE_INTENT_VARS`, …)
+ * are the ONE mapping between a typed-axis field and its CSS variable name.
+ * `themeTokensToCssVars` reads them forward (token → CSS); `almadar-core`'s
+ * one-time `scripts/migrate-css-themes.ts` reads them in reverse (CSS →
+ * token) to build `packages/almadar-core/themes/*.json` from the checked-in
+ * preset CSS — see that script for the inverse direction.
+ *
+ * @packageDocumentation
+ */
+
+/** Resolved color mode. Mirrors `ThemeContext.resolvedMode`. */
+type ThemeMode = 'light' | 'dark';
+/** The keys of `T` whose value is a plain (optional) string — excludes
+ * nested-object fields like `DensityTokens['spacing']` or
+ * `TypeScaleTokens['scale']`, which are never single CSS values. */
+type StringValueKey<T> = {
+    [K in keyof T]-?: T[K] extends string | undefined ? K : never;
+}[keyof T] & string;
+/** One flat scalar field on an axis object and the CSS var name it maps to. */
+interface FlatVarEntry<T> {
+    readonly cssVar: string;
+    readonly key: StringValueKey<T>;
+}
+/** Density axis — spacing scale steps (`density.spacing.space<N>` → `--space-<N>`). */
+declare const DENSITY_SPACING_VARS: ReadonlyArray<FlatVarEntry<NonNullable<DensityTokens['spacing']>>>;
+/** Density axis — per-element heights + paddings. */
+declare const DENSITY_ELEMENT_VARS: ReadonlyArray<FlatVarEntry<DensityTokens>>;
+/** Type axis — family triplet. */
+declare const TYPE_FAMILY_VARS: ReadonlyArray<FlatVarEntry<TypeScaleTokens>>;
+/** Type axis — size scale keys, ordered exactly as emitted. Each pairs `--text-<k>` / `--leading-<k>`. */
+declare const TYPE_SIZE_KEYS: ReadonlyArray<TypeSizeKey>;
+/** Type axis — intent names, ordered exactly as emitted. Each is 3 vars: `-size` / `-weight` / `-leading`. */
+declare const TYPE_INTENT_VARS: ReadonlyArray<{
+    key: keyof TypeIntentMap & string;
+    cssName: string;
+}>;
+/** Motion axis — duration palette keys, ordered exactly as emitted. */
+declare const MOTION_DURATION_KEYS: ReadonlyArray<MotionDurationKey>;
+/** Motion axis — easing palette keys, ordered exactly as emitted. */
+declare const MOTION_EASING_KEYS: ReadonlyArray<MotionEasingKey>;
+/** Motion axis — intent names, ordered exactly as emitted. Each is 2 vars: `-duration` / `-easing`. */
+declare const MOTION_INTENT_VARS: ReadonlyArray<{
+    key: keyof MotionIntentMap & string;
+    cssName: string;
+}>;
+/** Iconography axis — flat fields. */
+declare const ICONOGRAPHY_VARS: ReadonlyArray<FlatVarEntry<IconographyTokens>>;
+/** Elevation axis — flat fields. */
+declare const ELEVATION_VARS: ReadonlyArray<FlatVarEntry<ElevationTokens>>;
+/** Geometry axis — flat fields. */
+declare const GEOMETRY_VARS: ReadonlyArray<FlatVarEntry<GeometryTokens>>;
+/** Legacy free-form map prefixes (`ThemeTokens.colors`/`radii`/`spacing`/`shadows`). `typography` has no prefix — see below. */
+declare const LEGACY_PREFIXES: {
+    readonly colors: "--color-";
+    readonly radii: "--radius-";
+    readonly spacing: "--space-";
+    readonly shadows: "--shadow-";
+};
+/**
+ * Convert `ThemeTokens` (+ optional dark variant) into a CSS custom-property
+ * map keyed by variable name (e.g. `--color-primary`).
+ *
+ * Mapping rules (mirror theme.rs):
+ * - `tokens.colors.<k>`     → `--color-<k>`
+ * - `tokens.radii.<k>`      → `--radius-<k>`
+ * - `tokens.spacing.<k>`    → `--space-<k>`
+ * - `tokens.typography.<k>` → `--<k>` (keys already include their `font-`/
+ *                                       `letter-`/`line-` prefix)
+ * - `tokens.shadows.<k>`    → `--shadow-<k>` (schema key has no prefix)
+ *
+ * In `'dark'` mode, the `darkVariant` overrides are merged on top of the
+ * base tokens per category — same precedence the Rust compiler uses
+ * (`generate_tokens_css_dark`). Categories not present in `darkVariant` fall
+ * back to the base tokens.
+ */
+declare function themeTokensToCssVars(tokens: ThemeTokens, mode?: ThemeMode, darkVariant?: ThemeVariant): Record<string, string>;
+/**
+ * `ThemeRef` is `ThemeDefinition | string`. When it's a string, it's an
+ * unresolved import reference (e.g. `"Ocean.theme"`) that should have been
+ * inlined by the compiler's import phase before runtime. If we still see a
+ * string here, the upstream resolution path didn't run — return `undefined`
+ * rather than guess. `OrbitalThemeProvider` falls through to passthrough.
+ */
+declare function resolveThemeForRuntime(theme: ThemeRef | undefined): ThemeDefinition | undefined;
+
+export { DENSITY_ELEMENT_VARS as D, ELEVATION_VARS as E, type FlatVarEntry as F, GEOMETRY_VARS as G, ICONOGRAPHY_VARS as I, LEGACY_PREFIXES as L, MOTION_DURATION_KEYS as M, type StringValueKey as S, type ThemeMode as T, DENSITY_SPACING_VARS as a, MOTION_EASING_KEYS as b, MOTION_INTENT_VARS as c, TYPE_FAMILY_VARS as d, TYPE_INTENT_VARS as e, TYPE_SIZE_KEYS as f, resolveThemeForRuntime as r, themeTokensToCssVars as t };