@wix/himalaya-cli 0.1019.0 → 0.1021.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/preview-surfaces.d.ts

@@ -208,6 +208,13 @@ export interface PreviewSurface {
      * phone and tablet are always offered.
      */
     readonly platformKey: string | null;
+    /**
+     * RFC 0059 / #2927 — the native builds that draw this surface, which is what a null
+     * `platformKey` leaves implicit. The web host offers each one's idiom as a preview
+     * (`IDIOM_CONTEXTS`: `ios` wears `ios`, `android` wears `material`), and side by side.
+     * Absent ⇒ none: the surface previews in its own look only.
+     */
+    readonly idiomPlatforms?: readonly ("ios" | "android")[];
     readonly gate: SurfaceGate;
 }
 /**

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/tokens.d.ts

@@ -18,6 +18,8 @@ export interface DesignTokens {
     motions?: Record<string, MotionToken>;
     /** RFC 0021 — named surface materials (flat / glass / frosted). */
     materials?: Record<string, MaterialToken>;
+    /** RFC 0059 / #2931 — named surface elevations, paint only. A `Card` wears `card`. */
+    elevations?: Record<string, ElevationToken>;
     /** RFC 0021 (bottom-nav extension) — kit-driven tab bar styling. */
     tabBar?: TabBarStyle;
     /** RFC 0010/0021 — kit-driven slide-in drawer styling. */
@@ -264,6 +266,40 @@ export interface ShadowToken {
     x?: number;
     y?: number;
 }
+/**
+ * RFC 0059 / #2931 — how raised a surface is, as PAINT: nothing here moves a box, so the
+ * structural diff stays blind to it. A `Card` wears the `card` elevation; declare none and every
+ * Card stays flat, as before. Each field is drawn the same way on every renderer — what makes a
+ * Card read as Material on Android and as iOS on an iPhone is the idiom overlay choosing different
+ * fields for the one token:
+ *
+ *   "elevations": { "card": {} },
+ *   "idiom": {
+ *     "material": { "elevations": { "card": { "level": 1 } } },
+ *     "ios":      { "elevations": { "card": { "border": { "color": "border" }, "shadow": "card" } } }
+ *   }
+ */
+export interface ElevationToken {
+    /** Material 3 tonal elevation, 0–5: the surface is tinted with `tint` at M3's alpha for that
+     *  level (1 → 5%, 2 → 8%, 3 → 11%, 4 → 12%, 5 → 14% — `TONAL_ELEVATION_ALPHA`). 0 = none. */
+    level?: number;
+    /** The tonal tint — a colour token, M3's surfaceTint. Default `accentPrimary`. */
+    tint?: string;
+    /** A `shadows` token drawn behind the surface, in the surface's own shape. */
+    shadow?: string;
+    /** A hairline drawn just inside the surface's edge, so it never grows the box. `width` in
+     *  points, default 0.5; 0 = none. */
+    border?: {
+        color: string;
+        width?: number;
+    };
+}
+/** M3's tonal-elevation tint alpha by level (0–5), as `surfaceColorAtElevation` computes it for
+ *  levels 1–5 (1, 3, 6, 8, 12 dp). Mirrored by Tokens.swift and Tokens.kt. */
+export declare const TONAL_ELEVATION_ALPHA: readonly number[];
+/** The tint alpha an `ElevationToken.level` asks for: rounded and clamped to 0–5; anything
+ *  non-numeric is 0 (no tint). */
+export declare function tonalElevationAlpha(level: number | undefined): number;
 /** RFC 0020 — a linear gradient. `colors` are color-token NAMES (theme-aware);
  *  `angle` is degrees clockwise from top (0 = top→bottom, 90 = left→right).
  *  `locations` (0..1) optionally positions each stop. */

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/core.mjs

@@ -7796,6 +7796,11 @@ function resolveResponsiveSize(rs, width) {
   return rs.base;
 }
 var SYSTEM_FONT_FAMILY = "$system";
+var TONAL_ELEVATION_ALPHA = [0, 0.05, 0.08, 0.11, 0.12, 0.14];
+function tonalElevationAlpha(level) {
+  if (typeof level !== "number" || !Number.isFinite(level)) return 0;
+  return TONAL_ELEVATION_ALPHA[Math.min(5, Math.max(0, Math.round(level)))];
+}
 function buildTokenRegistry(tokens) {
   return {
     colors: new Set(Object.keys(tokens.colors ?? {})),
@@ -9227,7 +9232,8 @@ var PREVIEW_SURFACES = [
     // iPhone 14/15 logical points
     orientations: ["portrait"],
     platformKey: null,
-    // iOS/Android are implicit
+    // iOS/Android are implicit — named explicitly in idiomPlatforms
+    idiomPlatforms: ["ios", "android"],
     gate: { kind: "none" }
   },
   {
@@ -9242,6 +9248,7 @@ var PREVIEW_SURFACES = [
     // iPad Pro 11" logical points
     orientations: ["portrait", "landscape"],
     platformKey: null,
+    idiomPlatforms: ["ios", "android"],
     gate: { kind: "none" }
   },
   {
@@ -12975,6 +12982,7 @@ export {
   SURFACE_GROUPS,
   SURFACE_VIEW_LADDER,
   SYSTEM_FONT_FAMILY,
+  TONAL_ELEVATION_ALPHA,
   UNIVERSAL_LAUNCH_NAMESPACES,
   WIDGET_COMPONENTS,
   WIDGET_FAMILIES,
@@ -13047,6 +13055,7 @@ export {
   surfaceFrozenFamily,
   surfaceRenderMode,
   surfacesForApp,
+  tonalElevationAlpha,
   validate,
   validateAll,
   validateDistribution,

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/sdui.mjs

@@ -7661,7 +7661,8 @@ var PREVIEW_SURFACES = [
     // iPhone 14/15 logical points
     orientations: ["portrait"],
     platformKey: null,
-    // iOS/Android are implicit
+    // iOS/Android are implicit — named explicitly in idiomPlatforms
+    idiomPlatforms: ["ios", "android"],
     gate: { kind: "none" }
   },
   {
@@ -7676,6 +7677,7 @@ var PREVIEW_SURFACES = [
     // iPad Pro 11" logical points
     orientations: ["portrait", "landscape"],
     platformKey: null,
+    idiomPlatforms: ["ios", "android"],
     gate: { kind: "none" }
   },
   {