@almadar/ui 6.29.0 → 6.30.0

package/dist/lib/index.cjs

@@ -2492,6 +2492,443 @@ function applyOperator(input) {
   }
 }
 
+// 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[`${LEGACY_PREFIXES.colors}${key}`] = value;
+    }
+    if (isDark && darkVariant?.colors && tokens.colors) {
+      for (const [key, value] of Object.entries(tokens.colors)) {
+        const varName = `${LEGACY_PREFIXES.colors}${key}`;
+        if (!(varName in vars)) vars[varName] = value;
+      }
+    }
+  }
+  const pickRadii = isDark && darkVariant?.radii ? darkVariant.radii : tokens.radii;
+  if (pickRadii) {
+    for (const [key, value] of Object.entries(pickRadii)) {
+      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[`${LEGACY_PREFIXES.spacing}${key}`] = value;
+    }
+  }
+  const pickTypography = isDark && darkVariant?.typography ? darkVariant.typography : tokens.typography;
+  if (pickTypography) {
+    for (const [key, value] of Object.entries(pickTypography)) {
+      vars[`--${key}`] = value;
+    }
+  }
+  const pickShadows = isDark && darkVariant?.shadows ? darkVariant.shadows : tokens.shadows;
+  if (pickShadows) {
+    for (const [key, value] of Object.entries(pickShadows)) {
+      vars[`${LEGACY_PREFIXES.shadows}${key}`] = value;
+    }
+  }
+  const pickDensity = isDark && darkVariant?.density ? darkVariant.density : tokens.density;
+  emitDensity(pickDensity, vars);
+  const pickTypeScale = isDark && darkVariant?.typeScale ? darkVariant.typeScale : tokens.typeScale;
+  emitTypeScale(pickTypeScale, vars);
+  const pickMotion = isDark && darkVariant?.motion ? darkVariant.motion : tokens.motion;
+  emitMotion(pickMotion, vars);
+  const pickIconography = isDark && darkVariant?.iconography ? darkVariant.iconography : tokens.iconography;
+  emitIconography(pickIconography, vars);
+  const pickElevation = isDark && darkVariant?.elevation ? darkVariant.elevation : tokens.elevation;
+  emitElevation(pickElevation, vars);
+  const pickGeometry = isDark && darkVariant?.geometry ? darkVariant.geometry : tokens.geometry;
+  emitGeometry(pickGeometry, vars);
+  return vars;
+}
+function emitDensity(density, vars) {
+  if (!density) return;
+  applyFlat(density.spacing, DENSITY_SPACING_VARS, vars);
+  applyFlat(density, DENSITY_ELEMENT_VARS, vars);
+}
+function typeSizeKeyStr(k) {
+  return k;
+}
+function typeWeightStr(w) {
+  return w;
+}
+function emitTypeIntent(name, intent, vars) {
+  const sizeKey = typeSizeKeyStr(intent.size);
+  const weight = typeWeightStr(intent.weight);
+  vars[`--intent-${name}-size`] = `var(--text-${sizeKey})`;
+  vars[`--intent-${name}-weight`] = `var(--font-weight-${weight})`;
+  vars[`--intent-${name}-leading`] = `var(--leading-${sizeKey})`;
+}
+function emitTypeScale(ts, vars) {
+  if (!ts) return;
+  applyFlat(ts, TYPE_FAMILY_VARS, vars);
+  if (ts.scale) {
+    const s = ts.scale;
+    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;
+      }
+    }
+  }
+  if (ts.intents) {
+    const i = ts.intents;
+    for (const { key, cssName } of TYPE_INTENT_VARS) {
+      const intent = i[key];
+      if (intent) emitTypeIntent(cssName, intent, vars);
+    }
+  }
+}
+function emitMotionIntent(name, intent, vars) {
+  vars[`--intent-${name}-duration`] = `var(--duration-${intent.duration})`;
+  vars[`--intent-${name}-easing`] = `var(--easing-${intent.easing})`;
+}
+function emitMotion(m, vars) {
+  if (!m) return;
+  if (m.durations) {
+    const d = m.durations;
+    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;
+    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;
+    for (const { key, cssName } of MOTION_INTENT_VARS) {
+      const intent = i[key];
+      if (intent) emitMotionIntent(cssName, intent, vars);
+    }
+  }
+}
+function emitIconography(i, vars) {
+  applyFlat(i, ICONOGRAPHY_VARS, vars);
+}
+function emitElevation(e, vars) {
+  applyFlat(e, ELEVATION_VARS, vars);
+}
+function emitGeometry(g, vars) {
+  applyFlat(g, GEOMETRY_VARS, vars);
+}
+function resolveThemeForRuntime(theme) {
+  if (theme === void 0) return void 0;
+  if (typeof theme === "string") return void 0;
+  return theme;
+}
+
+// lib/iconNativeMap.ts
+var ICON_FALLBACK = {
+  sfSymbol: "questionmark.circle",
+  materialSymbol: "help"
+};
+var ICON_NATIVE_MAP = {
+  // --- navigation & chrome ---
+  "home": { sfSymbol: "house", materialSymbol: "home" },
+  "menu": { sfSymbol: "line.3.horizontal", materialSymbol: "menu" },
+  "more-horizontal": { sfSymbol: "ellipsis", materialSymbol: "more_horiz" },
+  "more-vertical": { sfSymbol: "ellipsis", materialSymbol: "more_vert" },
+  "chevron-right": { sfSymbol: "chevron.right", materialSymbol: "chevron_right" },
+  "chevron-left": { sfSymbol: "chevron.left", materialSymbol: "chevron_left" },
+  "chevron-up": { sfSymbol: "chevron.up", materialSymbol: "keyboard_arrow_up" },
+  "chevron-down": { sfSymbol: "chevron.down", materialSymbol: "keyboard_arrow_down" },
+  "chevrons-left": { sfSymbol: "chevron.left.2", materialSymbol: "keyboard_double_arrow_left" },
+  "chevrons-right": { sfSymbol: "chevron.right.2", materialSymbol: "keyboard_double_arrow_right" },
+  "chevrons-up-down": { sfSymbol: "chevron.up.chevron.down", materialSymbol: "unfold_more" },
+  "arrow-left": { sfSymbol: "arrow.left", materialSymbol: "arrow_back" },
+  "arrow-right": { sfSymbol: "arrow.right", materialSymbol: "arrow_forward" },
+  "arrow-up": { sfSymbol: "arrow.up", materialSymbol: "arrow_upward" },
+  "arrow-down": { sfSymbol: "arrow.down", materialSymbol: "arrow_downward" },
+  "arrow-up-right": { sfSymbol: "arrow.up.right", materialSymbol: "north_east" },
+  "arrow-down-left": { sfSymbol: "arrow.down.left", materialSymbol: "south_west" },
+  "corner-up-left": { sfSymbol: "arrow.turn.up.left", materialSymbol: "subdirectory_arrow_left" },
+  "corner-down-right": { sfSymbol: "arrow.turn.down.right", materialSymbol: "subdirectory_arrow_right" },
+  "external-link": { sfSymbol: "arrow.up.forward.square", materialSymbol: "open_in_new" },
+  "log-out": { sfSymbol: "rectangle.portrait.and.arrow.right", materialSymbol: "logout" },
+  "log-in": { sfSymbol: "arrow.right.square", materialSymbol: "login" },
+  // `left_panel_open`/`right_panel_open` (Material Symbols) have no
+  // `Icons.Filled.*` member in androidx `material-icons-extended` (a newer
+  // Material-Symbols-only pair) — `first_page`/`last_page` are the closest
+  // directional stand-ins that actually compile (verified wave C5).
+  "panel-left": { sfSymbol: "sidebar.left", materialSymbol: "first_page" },
+  "panel-right": { sfSymbol: "sidebar.right", materialSymbol: "last_page" },
+  "sidebar": { sfSymbol: "sidebar.left", materialSymbol: "view_sidebar" },
+  "layout-grid": { sfSymbol: "square.grid.2x2", materialSymbol: "grid_view" },
+  "layout-list": { sfSymbol: "list.bullet", materialSymbol: "view_list" },
+  "grid": { sfSymbol: "square.grid.2x2", materialSymbol: "grid_view" },
+  "list": { sfSymbol: "list.bullet", materialSymbol: "list" },
+  // --- actions ---
+  "plus": { sfSymbol: "plus", materialSymbol: "add" },
+  "plus-circle": { sfSymbol: "plus.circle", materialSymbol: "add_circle" },
+  "minus": { sfSymbol: "minus", materialSymbol: "remove" },
+  "minus-circle": { sfSymbol: "minus.circle", materialSymbol: "remove_circle" },
+  "x": { sfSymbol: "xmark", materialSymbol: "close" },
+  "close": { sfSymbol: "xmark", materialSymbol: "close" },
+  "check": { sfSymbol: "checkmark", materialSymbol: "check" },
+  "check-circle": { sfSymbol: "checkmark.circle", materialSymbol: "check_circle" },
+  "check-square": { sfSymbol: "checkmark.square", materialSymbol: "check_box" },
+  "x-circle": { sfSymbol: "xmark.circle", materialSymbol: "cancel" },
+  "trash": { sfSymbol: "trash", materialSymbol: "delete" },
+  "trash-2": { sfSymbol: "trash", materialSymbol: "delete" },
+  "edit": { sfSymbol: "pencil", materialSymbol: "edit" },
+  "edit-2": { sfSymbol: "pencil", materialSymbol: "edit" },
+  "edit-3": { sfSymbol: "pencil", materialSymbol: "edit" },
+  "pencil": { sfSymbol: "pencil", materialSymbol: "edit" },
+  "copy": { sfSymbol: "doc.on.doc", materialSymbol: "content_copy" },
+  "clipboard": { sfSymbol: "clipboard", materialSymbol: "content_paste" },
+  "save": { sfSymbol: "square.and.arrow.down", materialSymbol: "save" },
+  "download": { sfSymbol: "arrow.down.circle", materialSymbol: "download" },
+  "upload": { sfSymbol: "arrow.up.circle", materialSymbol: "upload" },
+  "share": { sfSymbol: "square.and.arrow.up", materialSymbol: "share" },
+  "share-2": { sfSymbol: "square.and.arrow.up", materialSymbol: "share" },
+  "refresh-cw": { sfSymbol: "arrow.clockwise", materialSymbol: "refresh" },
+  "refresh": { sfSymbol: "arrow.clockwise", materialSymbol: "refresh" },
+  "rotate-cw": { sfSymbol: "arrow.clockwise", materialSymbol: "rotate_right" },
+  "rotate-ccw": { sfSymbol: "arrow.counterclockwise", materialSymbol: "rotate_left" },
+  "undo": { sfSymbol: "arrow.uturn.backward", materialSymbol: "undo" },
+  "redo": { sfSymbol: "arrow.uturn.forward", materialSymbol: "redo" },
+  "filter": { sfSymbol: "line.3.horizontal.decrease.circle", materialSymbol: "filter_list" },
+  "sliders": { sfSymbol: "slider.horizontal.3", materialSymbol: "tune" },
+  "search": { sfSymbol: "magnifyingglass", materialSymbol: "search" },
+  "zoom-in": { sfSymbol: "plus.magnifyingglass", materialSymbol: "zoom_in" },
+  "zoom-out": { sfSymbol: "minus.magnifyingglass", materialSymbol: "zoom_out" },
+  "settings": { sfSymbol: "gearshape", materialSymbol: "settings" },
+  "lock": { sfSymbol: "lock", materialSymbol: "lock" },
+  "unlock": { sfSymbol: "lock.open", materialSymbol: "lock_open" },
+  "eye": { sfSymbol: "eye", materialSymbol: "visibility" },
+  "eye-off": { sfSymbol: "eye.slash", materialSymbol: "visibility_off" },
+  "link": { sfSymbol: "link", materialSymbol: "link" },
+  "link-2": { sfSymbol: "link", materialSymbol: "link" },
+  "send": { sfSymbol: "paperplane", materialSymbol: "send" },
+  "power": { sfSymbol: "power", materialSymbol: "power_settings_new" },
+  "scissors": { sfSymbol: "scissors", materialSymbol: "content_cut" },
+  // `ink_eraser` has no `Icons.Filled.*` member in androidx
+  // `material-icons-extended` (newer Material-Symbols-only) — `backspace`
+  // is the closest "erase" glyph that actually compiles (verified wave C5).
+  "eraser": { sfSymbol: "eraser", materialSymbol: "backspace" },
+  "stop": { sfSymbol: "stop.fill", materialSymbol: "stop" },
+  "sort-asc": { sfSymbol: "arrow.up", materialSymbol: "arrow_upward" },
+  "sort-desc": { sfSymbol: "arrow.down", materialSymbol: "arrow_downward" },
+  // --- files ---
+  "file": { sfSymbol: "doc", materialSymbol: "description" },
+  "file-text": { sfSymbol: "doc.text", materialSymbol: "description" },
+  "file-plus": { sfSymbol: "doc.badge.plus", materialSymbol: "note_add" },
+  "file-minus": { sfSymbol: "doc.badge.minus", materialSymbol: "note" },
+  "folder": { sfSymbol: "folder", materialSymbol: "folder" },
+  "folder-open": { sfSymbol: "folder", materialSymbol: "folder_open" },
+  "paperclip": { sfSymbol: "paperclip", materialSymbol: "attach_file" },
+  "image": { sfSymbol: "photo", materialSymbol: "image" },
+  "archive": { sfSymbol: "archivebox", materialSymbol: "archive" },
+  "printer": { sfSymbol: "printer", materialSymbol: "print" },
+  "book": { sfSymbol: "book", materialSymbol: "menu_book" },
+  "bookmark": { sfSymbol: "bookmark", materialSymbol: "bookmark" },
+  // --- communication ---
+  "mail": { sfSymbol: "envelope", materialSymbol: "mail" },
+  "inbox": { sfSymbol: "tray", materialSymbol: "inbox" },
+  "message-circle": { sfSymbol: "bubble.left", materialSymbol: "chat_bubble" },
+  "message-square": { sfSymbol: "bubble.left", materialSymbol: "forum" },
+  "phone": { sfSymbol: "phone", materialSymbol: "call" },
+  "bell": { sfSymbol: "bell", materialSymbol: "notifications" },
+  "bell-off": { sfSymbol: "bell.slash", materialSymbol: "notifications_off" },
+  "user": { sfSymbol: "person", materialSymbol: "person" },
+  "users": { sfSymbol: "person.2", materialSymbol: "group" },
+  "user-plus": { sfSymbol: "person.badge.plus", materialSymbol: "person_add" },
+  "user-circle": { sfSymbol: "person.crop.circle", materialSymbol: "account_circle" },
+  // --- status ---
+  "info": { sfSymbol: "info.circle", materialSymbol: "info" },
+  "alert-circle": { sfSymbol: "exclamationmark.circle", materialSymbol: "error" },
+  "alert-triangle": { sfSymbol: "exclamationmark.triangle", materialSymbol: "warning" },
+  "help-circle": { sfSymbol: "questionmark.circle", materialSymbol: "help" },
+  "star": { sfSymbol: "star", materialSymbol: "star" },
+  "heart": { sfSymbol: "heart", materialSymbol: "favorite" },
+  "flag": { sfSymbol: "flag", materialSymbol: "flag" },
+  "tag": { sfSymbol: "tag", materialSymbol: "label" },
+  "clock": { sfSymbol: "clock", materialSymbol: "schedule" },
+  "calendar": { sfSymbol: "calendar", materialSymbol: "calendar_month" },
+  // `progress_activity` has no `Icons.Filled.*` member in androidx
+  // `material-icons-extended` (newer Material-Symbols-only) — `autorenew`
+  // is the closest spinner/loading glyph that actually compiles (verified
+  // wave C5).
+  "loader": { sfSymbol: "arrow.triangle.2.circlepath", materialSymbol: "autorenew" },
+  "loader-2": { sfSymbol: "arrow.triangle.2.circlepath", materialSymbol: "autorenew" },
+  "activity": { sfSymbol: "waveform.path.ecg", materialSymbol: "monitor_heart" },
+  "smile": { sfSymbol: "face.smiling", materialSymbol: "sentiment_satisfied" },
+  // --- media ---
+  "play": { sfSymbol: "play.fill", materialSymbol: "play_arrow" },
+  "pause": { sfSymbol: "pause.fill", materialSymbol: "pause" },
+  "skip-forward": { sfSymbol: "forward.fill", materialSymbol: "skip_next" },
+  "skip-back": { sfSymbol: "backward.fill", materialSymbol: "skip_previous" },
+  "volume-2": { sfSymbol: "speaker.wave.2", materialSymbol: "volume_up" },
+  "volume": { sfSymbol: "speaker.wave.2", materialSymbol: "volume_up" },
+  "volume-x": { sfSymbol: "speaker.slash", materialSymbol: "volume_off" },
+  "volume-off": { sfSymbol: "speaker.slash", materialSymbol: "volume_off" },
+  "camera": { sfSymbol: "camera", materialSymbol: "photo_camera" },
+  "mic": { sfSymbol: "mic", materialSymbol: "mic" },
+  "video": { sfSymbol: "video", materialSymbol: "videocam" },
+  // --- editing / typography ---
+  "type": { sfSymbol: "textformat", materialSymbol: "text_fields" },
+  "bold": { sfSymbol: "bold", materialSymbol: "format_bold" },
+  "italic": { sfSymbol: "italic", materialSymbol: "format_italic" },
+  "underline": { sfSymbol: "underline", materialSymbol: "format_underlined" },
+  "align-left": { sfSymbol: "text.alignleft", materialSymbol: "format_align_left" },
+  "align-center": { sfSymbol: "text.aligncenter", materialSymbol: "format_align_center" },
+  "align-right": { sfSymbol: "text.alignright", materialSymbol: "format_align_right" },
+  "indent": { sfSymbol: "increase.indent", materialSymbol: "format_indent_increase" },
+  // --- misc ---
+  "shopping-cart": { sfSymbol: "cart", materialSymbol: "shopping_cart" },
+  "credit-card": { sfSymbol: "creditcard", materialSymbol: "credit_card" },
+  "map-pin": { sfSymbol: "mappin", materialSymbol: "location_on" },
+  "globe": { sfSymbol: "globe", materialSymbol: "public" },
+  "wifi": { sfSymbol: "wifi", materialSymbol: "wifi" },
+  "battery": { sfSymbol: "battery.100", materialSymbol: "battery_full" },
+  "moon": { sfSymbol: "moon", materialSymbol: "dark_mode" },
+  "sun": { sfSymbol: "sun.max", materialSymbol: "light_mode" },
+  "square": { sfSymbol: "square", materialSymbol: "crop_square" },
+  "circle": { sfSymbol: "circle", materialSymbol: "circle" }
+};
+var ICON_ALIASES = [
+  "close",
+  "trash",
+  "loader",
+  "stop",
+  "volume",
+  "volume-off",
+  "refresh",
+  "share",
+  "sort-asc",
+  "sort-desc"
+];
+function resolveNativeIcon(name) {
+  const direct = ICON_NATIVE_MAP[name];
+  if (direct) return direct;
+  if (ICON_ALIASES.includes(name)) {
+    const aliased = ICON_NATIVE_MAP[name];
+    if (aliased) return aliased;
+  }
+  return ICON_FALLBACK;
+}
+
 Object.defineProperty(exports, "PERF_NAMESPACE", {
   enumerable: true,
   get: function () { return ui.PERF_NAMESPACE; }
@@ -2526,10 +2963,25 @@ Object.defineProperty(exports, "getNestedValue", {
 });
 exports.ApiError = ApiError;
 exports.DEFAULT_CONFIG = DEFAULT_CONFIG;
+exports.DENSITY_ELEMENT_VARS = DENSITY_ELEMENT_VARS;
+exports.DENSITY_SPACING_VARS = DENSITY_SPACING_VARS;
 exports.EDITOR_MOTIONS = EDITOR_MOTIONS;
 exports.EDITOR_OPERATORS = EDITOR_OPERATORS;
+exports.ELEVATION_VARS = ELEVATION_VARS;
+exports.GEOMETRY_VARS = GEOMETRY_VARS;
+exports.ICONOGRAPHY_VARS = ICONOGRAPHY_VARS;
+exports.ICON_ALIASES = ICON_ALIASES;
+exports.ICON_FALLBACK = ICON_FALLBACK;
+exports.ICON_NATIVE_MAP = ICON_NATIVE_MAP;
 exports.INDENT_UNIT = INDENT_UNIT;
 exports.JAZARI_COLORS = JAZARI_COLORS;
+exports.LEGACY_PREFIXES = LEGACY_PREFIXES;
+exports.MOTION_DURATION_KEYS = MOTION_DURATION_KEYS;
+exports.MOTION_EASING_KEYS = MOTION_EASING_KEYS;
+exports.MOTION_INTENT_VARS = MOTION_INTENT_VARS;
+exports.TYPE_FAMILY_VARS = TYPE_FAMILY_VARS;
+exports.TYPE_INTENT_VARS = TYPE_INTENT_VARS;
+exports.TYPE_SIZE_KEYS = TYPE_SIZE_KEYS;
 exports.apiClient = apiClient;
 exports.applyMotion = applyMotion;
 exports.applyOperator = applyOperator;
@@ -2628,6 +3080,8 @@ exports.renderStateMachineToDomData = renderStateMachineToDomData;
 exports.renderStateMachineToSvg = renderStateMachineToSvg;
 exports.resolveImageUrl = resolveImageUrl;
 exports.resolveKeyMapEvent = resolveKeyMapEvent;
+exports.resolveNativeIcon = resolveNativeIcon;
+exports.resolveThemeForRuntime = resolveThemeForRuntime;
 exports.setDebugEnabled = setDebugEnabled;
 exports.setEntityProvider = setEntityProvider;
 exports.setTickActive = setTickActive;
@@ -2637,6 +3091,7 @@ exports.subscribeToGuardChanges = subscribeToGuardChanges;
 exports.subscribeToTickChanges = subscribeToTickChanges;
 exports.subscribeToTraitChanges = subscribeToTraitChanges;
 exports.subscribeToVerification = subscribeToVerification;
+exports.themeTokensToCssVars = themeTokensToCssVars;
 exports.toggleDebug = toggleDebug;
 exports.unregisterTick = unregisterTick;
 exports.unregisterTrait = unregisterTrait;

package/dist/lib/index.d.cts

@@ -3,6 +3,7 @@ import { FieldValue, EntityRow, EventKey } from '@almadar/core';
 export { AssetLoadStatus, BridgeHealth, CheckStatus, EffectTrace, EventLogEntry, OrbitalVerificationAPI, ServerResponseTrace, TraitStateSnapshot, TransitionTrace, VerificationCheck, VerificationSnapshot, VerificationSummary, getNestedValue } from '@almadar/core';
 export { p as profilerOnRender, u as usePerfBuffer } from '../perf-DaVdsbU0.cjs';
 export { T as TraitSnapshotGetter, b as bindCanvasCapture, a as bindEventBus, c as bindLastDrawables, d as bindTraitStateGetter, e as clearVerification, g as getAllChecks, f as getBridgeHealth, h as getSnapshot, i as getSummary, j as getTraitSnapshots, k as getTransitions, l as getTransitionsForTrait, r as recordServerResponse, m as recordTransition, n as registerCheck, o as registerTraitSnapshot, s as subscribeToVerification, u as updateAssetStatus, p as updateBridgeHealth, q as updateCheck, w as waitForTransition } from '../verificationRegistry-DTrKDRoa.cjs';
+export { D as DENSITY_ELEMENT_VARS, a as DENSITY_SPACING_VARS, E as ELEVATION_VARS, F as FlatVarEntry, G as GEOMETRY_VARS, I as ICONOGRAPHY_VARS, L as LEGACY_PREFIXES, M as MOTION_DURATION_KEYS, b as MOTION_EASING_KEYS, c as MOTION_INTENT_VARS, S as StringValueKey, d as TYPE_FAMILY_VARS, e as TYPE_INTENT_VARS, f as TYPE_SIZE_KEYS, T as ThemeMode, r as resolveThemeForRuntime, t as themeTokensToCssVars } from '../themeTokens-DVRwufw8.cjs';
 export { PERF_NAMESPACE, PerfEntry, clearPerf, perfEnd, perfGauge, perfStart, perfTime, perfTimeAsync } from '@almadar/runtime/ui';
 import 'react';
 import 'clsx';
@@ -601,4 +602,44 @@ declare function eightPointedStarPath(cx: number, cy: number, outerR: number, in
  */
 declare function arrowheadPath(size: number): string;
 
-export { ApiError, type CommandSendPump, type DebugEvent, type DebugEventType, type EntitySnapshot, type EntityState, type GuardContext, type GuardEvaluation, JAZARI_COLORS, type JazariArmLayout, type JazariEffectInfo, type JazariGearLayout, type JazariGuardInfo, type JazariLayout, type KeyMap, type LayoutInput, type LayoutState, type LayoutTransition, type PersistentEntityInfo, type RuntimeEntity, type SortDirection, type TickExecution, type TickSendRelay, type TraitDebugInfo, type TraitGuard, type TraitTransition, type ValueFormat, apiClient, arrowheadPath, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, compareCellValues, computeJazariLayout, createCommandSendPump, createTickSendRelay, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, formatDate, formatDateTime, formatNestedFieldLabel, formatTime, formatValue, gearTeethPath, getAllTicks, getAllTraits, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, humanizeEnumValue, humanizeFieldName, initDebugShortcut, isDebugEnabled, isEditableTarget, keyMapCode, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, pipeIconPath, recordGuardEvaluation, registerTick, registerTrait, resolveImageUrl, resolveKeyMapEvent, setDebugEnabled, setEntityProvider, setTickActive, sortRows, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState };
+/**
+ * Lucide canonical icon name → native platform glyph (Layer 1 Iconography
+ * axis, native path). `lib/iconFamily.tsx` resolves a canonical name to a
+ * React component for the web/runtime path; this table is the same
+ * dispatch for the compiled iOS/Android shells, which have no React DOM to
+ * render into and instead need a platform symbol name.
+ *
+ * Hand-curated (no fuzzy matching — see `resolveNativeIcon`). Covers:
+ *   (a) every alias key in `components/core/atoms/Icon.tsx` `iconAliases`
+ *       and `lib/iconFamily.tsx` `lucideAliases`
+ *   (b) every icon name appearing as an icon-prop `default` or in an
+ *       icon-prop description's quoted examples in
+ *       `orbital-rust/crates/orbital-compiler/src/baked/patterns-registry.json`
+ *   (c) every icon name used by the wave-1 native pattern set's React
+ *       components under `components/core/**`
+ *   (d) the common Lucide vocabulary: navigation, actions, files,
+ *       communication, status, media, arrows, editing.
+ *
+ * `sfSymbol` values are real SF Symbols 5 names; `materialSymbol` values are
+ * real Material Symbols names. Consumed by `almadar-sync icon-map`, which
+ * emits `IconMap.swift`/`IconMap.kt` from this table — regenerate with
+ * `node tools/almadar-pattern-sync/dist/index.js icon-map` after editing.
+ */
+interface NativeIconGlyph {
+    sfSymbol: string;
+    materialSymbol: string;
+}
+declare const ICON_FALLBACK: NativeIconGlyph;
+declare const ICON_NATIVE_MAP: Readonly<Record<string, NativeIconGlyph>>;
+/**
+ * Every non-standard name from `iconAliases` (`components/core/atoms/Icon.tsx`)
+ * and `lucideAliases` (`lib/iconFamily.tsx`) — the names that don't kebab→Pascal
+ * to a real Lucide export. Each one is also a first-class `ICON_NATIVE_MAP` key
+ * (requirement (a)); exported so the alias set has one pinned source of truth
+ * a test can check against, independent of whatever else the map grows to cover.
+ */
+declare const ICON_ALIASES: ReadonlyArray<string>;
+/** Exact key match, then an `iconAliases` alias, then the deterministic fallback — no fuzzy matching. */
+declare function resolveNativeIcon(name: string): NativeIconGlyph;
+
+export { ApiError, type CommandSendPump, type DebugEvent, type DebugEventType, type EntitySnapshot, type EntityState, type GuardContext, type GuardEvaluation, ICON_ALIASES, ICON_FALLBACK, ICON_NATIVE_MAP, JAZARI_COLORS, type JazariArmLayout, type JazariEffectInfo, type JazariGearLayout, type JazariGuardInfo, type JazariLayout, type KeyMap, type LayoutInput, type LayoutState, type LayoutTransition, type NativeIconGlyph, type PersistentEntityInfo, type RuntimeEntity, type SortDirection, type TickExecution, type TickSendRelay, type TraitDebugInfo, type TraitGuard, type TraitTransition, type ValueFormat, apiClient, arrowheadPath, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, compareCellValues, computeJazariLayout, createCommandSendPump, createTickSendRelay, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, formatDate, formatDateTime, formatNestedFieldLabel, formatTime, formatValue, gearTeethPath, getAllTicks, getAllTraits, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, humanizeEnumValue, humanizeFieldName, initDebugShortcut, isDebugEnabled, isEditableTarget, keyMapCode, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, pipeIconPath, recordGuardEvaluation, registerTick, registerTrait, resolveImageUrl, resolveKeyMapEvent, resolveNativeIcon, setDebugEnabled, setEntityProvider, setTickActive, sortRows, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState };

package/dist/lib/index.d.ts

@@ -3,6 +3,7 @@ import { FieldValue, EntityRow, EventKey } from '@almadar/core';
 export { AssetLoadStatus, BridgeHealth, CheckStatus, EffectTrace, EventLogEntry, OrbitalVerificationAPI, ServerResponseTrace, TraitStateSnapshot, TransitionTrace, VerificationCheck, VerificationSnapshot, VerificationSummary, getNestedValue } from '@almadar/core';
 export { p as profilerOnRender, u as usePerfBuffer } from '../perf-DaVdsbU0.js';
 export { T as TraitSnapshotGetter, b as bindCanvasCapture, a as bindEventBus, c as bindLastDrawables, d as bindTraitStateGetter, e as clearVerification, g as getAllChecks, f as getBridgeHealth, h as getSnapshot, i as getSummary, j as getTraitSnapshots, k as getTransitions, l as getTransitionsForTrait, r as recordServerResponse, m as recordTransition, n as registerCheck, o as registerTraitSnapshot, s as subscribeToVerification, u as updateAssetStatus, p as updateBridgeHealth, q as updateCheck, w as waitForTransition } from '../verificationRegistry-Cwa52VyK.js';
+export { D as DENSITY_ELEMENT_VARS, a as DENSITY_SPACING_VARS, E as ELEVATION_VARS, F as FlatVarEntry, G as GEOMETRY_VARS, I as ICONOGRAPHY_VARS, L as LEGACY_PREFIXES, M as MOTION_DURATION_KEYS, b as MOTION_EASING_KEYS, c as MOTION_INTENT_VARS, S as StringValueKey, d as TYPE_FAMILY_VARS, e as TYPE_INTENT_VARS, f as TYPE_SIZE_KEYS, T as ThemeMode, r as resolveThemeForRuntime, t as themeTokensToCssVars } from '../themeTokens-DVRwufw8.js';
 export { PERF_NAMESPACE, PerfEntry, clearPerf, perfEnd, perfGauge, perfStart, perfTime, perfTimeAsync } from '@almadar/runtime/ui';
 import 'react';
 import 'clsx';
@@ -601,4 +602,44 @@ declare function eightPointedStarPath(cx: number, cy: number, outerR: number, in
  */
 declare function arrowheadPath(size: number): string;
 
-export { ApiError, type CommandSendPump, type DebugEvent, type DebugEventType, type EntitySnapshot, type EntityState, type GuardContext, type GuardEvaluation, JAZARI_COLORS, type JazariArmLayout, type JazariEffectInfo, type JazariGearLayout, type JazariGuardInfo, type JazariLayout, type KeyMap, type LayoutInput, type LayoutState, type LayoutTransition, type PersistentEntityInfo, type RuntimeEntity, type SortDirection, type TickExecution, type TickSendRelay, type TraitDebugInfo, type TraitGuard, type TraitTransition, type ValueFormat, apiClient, arrowheadPath, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, compareCellValues, computeJazariLayout, createCommandSendPump, createTickSendRelay, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, formatDate, formatDateTime, formatNestedFieldLabel, formatTime, formatValue, gearTeethPath, getAllTicks, getAllTraits, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, humanizeEnumValue, humanizeFieldName, initDebugShortcut, isDebugEnabled, isEditableTarget, keyMapCode, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, pipeIconPath, recordGuardEvaluation, registerTick, registerTrait, resolveImageUrl, resolveKeyMapEvent, setDebugEnabled, setEntityProvider, setTickActive, sortRows, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState };
+/**
+ * Lucide canonical icon name → native platform glyph (Layer 1 Iconography
+ * axis, native path). `lib/iconFamily.tsx` resolves a canonical name to a
+ * React component for the web/runtime path; this table is the same
+ * dispatch for the compiled iOS/Android shells, which have no React DOM to
+ * render into and instead need a platform symbol name.
+ *
+ * Hand-curated (no fuzzy matching — see `resolveNativeIcon`). Covers:
+ *   (a) every alias key in `components/core/atoms/Icon.tsx` `iconAliases`
+ *       and `lib/iconFamily.tsx` `lucideAliases`
+ *   (b) every icon name appearing as an icon-prop `default` or in an
+ *       icon-prop description's quoted examples in
+ *       `orbital-rust/crates/orbital-compiler/src/baked/patterns-registry.json`
+ *   (c) every icon name used by the wave-1 native pattern set's React
+ *       components under `components/core/**`
+ *   (d) the common Lucide vocabulary: navigation, actions, files,
+ *       communication, status, media, arrows, editing.
+ *
+ * `sfSymbol` values are real SF Symbols 5 names; `materialSymbol` values are
+ * real Material Symbols names. Consumed by `almadar-sync icon-map`, which
+ * emits `IconMap.swift`/`IconMap.kt` from this table — regenerate with
+ * `node tools/almadar-pattern-sync/dist/index.js icon-map` after editing.
+ */
+interface NativeIconGlyph {
+    sfSymbol: string;
+    materialSymbol: string;
+}
+declare const ICON_FALLBACK: NativeIconGlyph;
+declare const ICON_NATIVE_MAP: Readonly<Record<string, NativeIconGlyph>>;
+/**
+ * Every non-standard name from `iconAliases` (`components/core/atoms/Icon.tsx`)
+ * and `lucideAliases` (`lib/iconFamily.tsx`) — the names that don't kebab→Pascal
+ * to a real Lucide export. Each one is also a first-class `ICON_NATIVE_MAP` key
+ * (requirement (a)); exported so the alias set has one pinned source of truth
+ * a test can check against, independent of whatever else the map grows to cover.
+ */
+declare const ICON_ALIASES: ReadonlyArray<string>;
+/** Exact key match, then an `iconAliases` alias, then the deterministic fallback — no fuzzy matching. */
+declare function resolveNativeIcon(name: string): NativeIconGlyph;
+
+export { ApiError, type CommandSendPump, type DebugEvent, type DebugEventType, type EntitySnapshot, type EntityState, type GuardContext, type GuardEvaluation, ICON_ALIASES, ICON_FALLBACK, ICON_NATIVE_MAP, JAZARI_COLORS, type JazariArmLayout, type JazariEffectInfo, type JazariGearLayout, type JazariGuardInfo, type JazariLayout, type KeyMap, type LayoutInput, type LayoutState, type LayoutTransition, type NativeIconGlyph, type PersistentEntityInfo, type RuntimeEntity, type SortDirection, type TickExecution, type TickSendRelay, type TraitDebugInfo, type TraitGuard, type TraitTransition, type ValueFormat, apiClient, arrowheadPath, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, compareCellValues, computeJazariLayout, createCommandSendPump, createTickSendRelay, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, formatDate, formatDateTime, formatNestedFieldLabel, formatTime, formatValue, gearTeethPath, getAllTicks, getAllTraits, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, humanizeEnumValue, humanizeFieldName, initDebugShortcut, isDebugEnabled, isEditableTarget, keyMapCode, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, pipeIconPath, recordGuardEvaluation, registerTick, registerTrait, resolveImageUrl, resolveKeyMapEvent, resolveNativeIcon, setDebugEnabled, setEntityProvider, setTickActive, sortRows, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState };