@wix/himalaya-cli 0.1409.0 → 0.1410.0

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

@@ -744,6 +744,12 @@ export declare function statefulSection(props: {
         retry?: ActionShape;
     };
     data?: Component;
+    /** A loading state that settles inside this many ms never paints its skeleton. 0/absent ⇒
+     *  the platform default (200) while `kit.motionDefaults` is on; negative ⇒ no grace. */
+    loadingGraceMs?: number;
+    /** Once painted, the skeleton is held at least this long. 0/absent ⇒ default (600);
+     *  negative ⇒ no floor. */
+    loadingFloorMs?: number;
 }, opts?: {
     id?: string;
 }): Component;

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

@@ -5,6 +5,10 @@ import type { Component } from "../../dev-server/src/builder.js";
  * #2738 — `id` used to be emitted as `accessibilityLabel`, so a screen reader announced
  * "himi_branded_home.hero_skeleton" and read three shimmer boxes aloud during every load.
  * A skeleton is decorative: it carries an id for tests and no accessible name at all.
+ *
+ * S1 — it is a real `Skeleton` now, not a flat bordered ZStack, so every caller gets the
+ * renderers' shimmer (gated on `kit.motionDefaults` + reduce motion) for free. Same contract:
+ * full width, `height` tall, radius 8, the id on the node.
  */
 export declare function skRect(height: number, id: string): Component;
 /** Options for the standard empty-state block. */
@@ -30,3 +34,9 @@ export interface EmptyBlockOptions {
  *  Hidden while the worker reports `<service>.noEmpty`. `titlePath` is usually
  *  a `$service:` path so the copy is worker-driven. */
 export declare function emptyBlock(service: string, titlePath: string, ctaTitle: string, ctaScreen: string, iconName: string, id: string, opts?: EmptyBlockOptions): Component;
+/** S4 — the transition a state block (empty / retry) wears, so a loading → empty → error →
+ *  content swap animates rather than cuts. Shared so every app's state blocks agree. */
+export declare const STATE_SWAP_TRANSITION: {
+    readonly enter: "fade";
+    readonly exit: "fade";
+};

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

@@ -26,7 +26,11 @@ export interface Action {
     actionId: string;
     /** Backwards-compatible string-only params. Prefer `args` for typed payloads. */
     params?: Record<string, string>;
-    /** Typed action args; nested objects/arrays preserved end-to-end. */
+    /** Typed action args; nested objects/arrays preserved end-to-end. With `presentation: "sheet"`,
+     *  `args.detents` (fractions of the height in (0, 1], e.g. `[0.5, 1]`) sizes the presented
+     *  sheet; absent ⇒ the default sheet. Applies on iOS, Android and web; a macOS (and tvOS)
+     *  screen sheet is a window-modal panel sized to its content, so there it is accepted and
+     *  ignored, as for the BottomSheet component. */
     args?: Record<string, Value>;
     /** Navigation hint for the router; ignored for non-nav actions. */
     presentation?: Presentation;
@@ -1084,6 +1088,11 @@ export interface StatefulSectionProps {
     empty?: EmptyStateProps;
     error?: StatefulErrorProps;
     data?: Component;
+    /** A loading state that settles inside this many ms never paints its skeleton. 0/absent ⇒ 200
+     *  while `kit.motionDefaults` is on; negative ⇒ no grace. */
+    loadingGraceMs?: number;
+    /** A painted skeleton is held at least this long. 0/absent ⇒ 600; negative ⇒ no floor. */
+    loadingFloorMs?: number;
 }
 /** RFC 0045 — one named descriptor-shipped structural variant. */
 export interface FragmentSlotCase {

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

@@ -130,6 +130,17 @@ export interface KitBlock {
      *  override and the OS high-contrast setting still win over it. Read from this top-level
      *  block only — an idiom overlay cannot set it. Mirror of iOS/Android `KitBlock.colorScheme`. */
     colorScheme?: "system" | "light" | "dark";
+    /** Reduced-motion policy: "system" (default) follows the OS setting; "always" / "never" pin
+     *  it. Every renderer funnels its motion through this gate. */
+    reduceMotion?: "system" | "always" | "never";
+    /** The motion the renderers add with no descriptor asking — StatefulSection loading grace
+     *  (200 ms) / floor (600 ms) + cross-fade, skeleton shimmer, a remote image's first-load fade,
+     *  value/icon content transitions, default exits, semantic haptics. "subtle" (or absent /
+     *  unknown) is the default; "none" opts the app out (today's look); "expressive" lengthens the
+     *  same motions a little. Visual motion still yields to reduce motion; haptics only to "none".
+     *  Read from this top-level block only. Mirror of iOS `Tokens.motionDefaults` / Android
+     *  `Tokens.activeMotionDefaults`. */
+    motionDefaults?: "none" | "subtle" | "expressive";
 }
 /** RFC 0021 (bottom-nav extension) — kit-driven tab bar styling. All fields
  *  optional; a kit omitting `tabBar` falls back to the flat default bar. */

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

@@ -255,6 +255,31 @@ export declare const screenDescriptorSchema: {
                     readonly enum: readonly ["push", "sheet", "replace", "dismiss", "back", "full_screen", "alert", "snackbar"];
                 };
             };
+            readonly if: {
+                readonly properties: {
+                    readonly presentation: {
+                        readonly const: "sheet";
+                    };
+                };
+                readonly required: readonly ["presentation"];
+            };
+            readonly then: {
+                readonly properties: {
+                    readonly args: {
+                        readonly properties: {
+                            readonly detents: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "number";
+                                    readonly exclusiveMinimum: 0;
+                                    readonly maximum: 1;
+                                };
+                                readonly minItems: 1;
+                            };
+                        };
+                    };
+                };
+            };
         };
         readonly topBarConfig: {
             readonly type: "object";
@@ -1418,6 +1443,31 @@ export declare const widgetSnapshotSchema: {
                     readonly enum: readonly ["push", "sheet", "replace", "dismiss", "back", "full_screen", "alert", "snackbar"];
                 };
             };
+            readonly if: {
+                readonly properties: {
+                    readonly presentation: {
+                        readonly const: "sheet";
+                    };
+                };
+                readonly required: readonly ["presentation"];
+            };
+            readonly then: {
+                readonly properties: {
+                    readonly args: {
+                        readonly properties: {
+                            readonly detents: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "number";
+                                    readonly exclusiveMinimum: 0;
+                                    readonly maximum: 1;
+                                };
+                                readonly minItems: 1;
+                            };
+                        };
+                    };
+                };
+            };
         };
         readonly topBarConfig: {
             readonly type: "object";

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

@@ -8260,6 +8260,20 @@ var screenDescriptorSchema = {
             "snackbar"
           ]
         }
+      },
+      // A SHEET's `args.detents` (fractions of the screen height, (0, 1]) is the one typed args
+      // key: every router reads it as numbers, so a string list would silently present the default
+      // sheet. Only a sheet reads it — on any other action `detents` is opaque payload, like the
+      // rest of `args`, and must not reject the descriptor.
+      if: { properties: { presentation: { const: "sheet" } }, required: ["presentation"] },
+      then: {
+        properties: {
+          args: {
+            properties: {
+              detents: { type: "array", items: { type: "number", exclusiveMinimum: 0, maximum: 1 }, minItems: 1 }
+            }
+          }
+        }
       }
     },
     // RFC 0010 (top-bar amendment) — shell-owned top bar + its trailing actions.

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

@@ -7130,6 +7130,20 @@ var screenDescriptorSchema = {
             "snackbar"
           ]
         }
+      },
+      // A SHEET's `args.detents` (fractions of the screen height, (0, 1]) is the one typed args
+      // key: every router reads it as numbers, so a string list would silently present the default
+      // sheet. Only a sheet reads it — on any other action `detents` is opaque payload, like the
+      // rest of `args`, and must not reject the descriptor.
+      if: { properties: { presentation: { const: "sheet" } }, required: ["presentation"] },
+      then: {
+        properties: {
+          args: {
+            properties: {
+              detents: { type: "array", items: { type: "number", exclusiveMinimum: 0, maximum: 1 }, minItems: 1 }
+            }
+          }
+        }
       }
     },
     // RFC 0010 (top-bar amendment) — shell-owned top bar + its trailing actions.
@@ -9226,11 +9240,13 @@ function servedPush(push) {
 
 // ../../core/sdui/src/screen-kit.ts
 function skRect(height, id) {
-  return withId(withModifiers(zstack({ alignment: "center", children: [] }), {
+  return withId(withModifiers(skeleton({ height, cornerRadius: 8 }), {
     height,
+    // The box the shimmer sits on: it still paints its own surface, so a layout that keeps a
+    // surface's inset (home's #3000 gap sibling) treats it as one.
     background: { token: "surfaceSecondary" },
-    border: { width: 1, color: { token: "border" } },
-    cornerRadius: 8
+    cornerRadius: 8,
+    accessibilityRole: "decorative"
   }), id);
 }
 function emptyBlock(service, titlePath, ctaTitle, ctaScreen, iconName, id, opts = {}) {
@@ -9246,12 +9262,17 @@ function emptyBlock(service, titlePath, ctaTitle, ctaScreen, iconName, id, opts
   );
   return hiddenWhen(
     withModifiers(vstack({ spacing: 12, alignment: "center", children }), {
-      padding: { leading: 24, trailing: 24, top: 24, bottom: 24 }
+      padding: { leading: 24, trailing: 24, top: 24, bottom: 24 },
+      // S4 — the swap content → empty (and back) fades instead of cutting; the renderers play
+      // the exit through the same hidden gate (RFC 0037, gated on reduce motion).
+      transition: STATE_SWAP_TRANSITION
     }),
     `$service:${service}.noEmpty`
   );
 }
+var STATE_SWAP_TRANSITION = { enter: "fade", exit: "fade" };
 export {
+  STATE_SWAP_TRANSITION,
   activityIndicator,
   agenda,
   agendaList,