@wix/himalaya-cli 0.1307.0 → 0.1309.0

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

@@ -50,6 +50,9 @@ export interface ScreenDescriptor {
      *  ScreenDescriptor.sticky_header / sticky_footer in core.proto. */
     stickyHeader?: Component;
     stickyFooter?: Component;
+    /** RFC 0069 — the chat transcript scroll policy. Mirror of
+     *  ScreenDescriptor.transcript_scroll in core.proto. */
+    transcriptScroll?: import("@wix/himalaya/core").TranscriptScroll;
 }
 /** Tier 3/4 + embeddable WebView behavior. Mirror of WebViewConfig in core.proto
  *  (RFC 0038). All fields optional; zero values reproduce legacy behavior. */
@@ -148,8 +151,12 @@ export declare function vstack(props: {
 }, opts?: {
     id?: string;
 }): Component;
+/** `alignment` is the HStack's CROSS axis — vertical — and is worth setting whenever the
+ *  children differ in height: unset is centre on iOS but TOP on Android
+ *  (`toComposeVertical`), which put the Aria header's History label above its pencil. */
 export declare function hstack(props: {
     spacing?: number;
+    alignment?: "leading" | "center" | "trailing";
     children: Component[];
 }, opts?: {
     id?: string;

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

@@ -364,6 +364,21 @@ export interface Modifiers {
      *  The generalization of `FragmentSlotCase.accessibilityAnnouncement`, which only ever
      *  fired on a fragment-slot case swap. */
     announce?: LiveRegion;
+    /** RFC 0069 — a recurring, finite, transform-only motion on a decorative node: a
+     *  living character's idle `hop`, a `blink`, a working `breathe`. Never changes the
+     *  node's layout footprint. Stopped by reduced motion unless `respectReducedMotion`
+     *  is false. */
+    ambientMotion?: AmbientMotion;
+}
+/** RFC 0069 — `Modifiers.ambientMotion`. */
+export interface AmbientMotion {
+    /** `"hop"` | `"blink"` | `"breathe"`; anything else renders no motion. */
+    kind?: string;
+    /** hop/blink: the shortest rest between two reactions (defaults 3000 / 2200);
+     *  breathe: the half-period (default 550). */
+    minGapMs?: number;
+    /** hop/blink: the longest rest (defaults 7000 / 5500). Ignored by breathe. */
+    maxGapMs?: number;
 }
 /** RFC 0058 §4 — a screen-change / state-change announcement. `text` EMPTY means
  *  "announce this node's own resolved name + value", which is what makes a status line
@@ -3176,6 +3191,18 @@ export interface WebViewProps {
     config?: WebViewConfig;
     capabilitiesRequired?: string[];
 }
+/** RFC 0069 — `ScreenDescriptor.transcriptScroll`. */
+export interface TranscriptScroll {
+    /** `$service:` path to a SEND TOKEN. Each new non-empty value is a send; an
+     *  empty one resets the policy (a new conversation rests at the top). */
+    sendPath: string;
+    /** `$service:` path to the id of the component to pin. It may change while
+     *  the pin is held (an optimistic row replaced by the server's copy) without
+     *  starting a new pin. Empty = follow the tail with nothing pinned. */
+    anchorPath?: string;
+    /** Accessible name of the jump-to-latest control. Default "Jump to latest". */
+    jumpLabel?: string;
+}
 export interface ScreenDescriptor {
     screenId: string;
     renderer: RendererKind;
@@ -3194,6 +3221,11 @@ export interface ScreenDescriptor {
      *  up (a chat transcript). Tapping it animates back to the bottom. Absent/false =
      *  a normal top-anchored scroll. Honored by the app host (Router). */
     scrollToBottom?: boolean;
+    /** RFC 0069 — the chat transcript scroll policy. On a send the host pins the
+     *  named component near the top and reserves the space the reply grows into;
+     *  when the reply outgrows it the host follows the tail. A drag pauses
+     *  following, and only then is a jump-to-latest control shown. */
+    transcriptScroll?: TranscriptScroll;
     /** Present when `renderer` is `webview_native_bridge` or `webview_ds`. */
     url?: string;
     capabilitiesRequired?: string[];

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

@@ -6,6 +6,14 @@ export declare const screenDescriptorSchema: {
     readonly type: "object";
     readonly additionalProperties: false;
     readonly required: readonly ["screenId", "renderer", "schemaVersion"];
+    readonly not: {
+        readonly required: readonly ["transcriptScroll", "scrollToBottom"];
+        readonly properties: {
+            readonly scrollToBottom: {
+                readonly const: true;
+            };
+        };
+    };
     readonly properties: {
         readonly screenId: {
             readonly type: "string";
@@ -30,6 +38,24 @@ export declare const screenDescriptorSchema: {
         readonly scrollToBottom: {
             readonly type: "boolean";
         };
+        readonly transcriptScroll: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["sendPath"];
+            readonly properties: {
+                readonly sendPath: {
+                    readonly type: "string";
+                    readonly pattern: "^\\$service:";
+                };
+                readonly anchorPath: {
+                    readonly type: "string";
+                    readonly pattern: "^$|^\\$service:";
+                };
+                readonly jumpLabel: {
+                    readonly type: "string";
+                };
+            };
+        };
         readonly url: {
             readonly type: "string";
             readonly format: "uri";
@@ -650,6 +676,23 @@ export declare const screenDescriptorSchema: {
                         };
                     };
                 };
+                readonly ambientMotion: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly kind: {
+                            readonly type: "string";
+                        };
+                        readonly minGapMs: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly maxGapMs: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                    };
+                };
                 readonly boxShadow: {
                     readonly type: "object";
                     readonly additionalProperties: false;
@@ -1621,6 +1664,23 @@ export declare const widgetSnapshotSchema: {
                         };
                     };
                 };
+                readonly ambientMotion: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly kind: {
+                            readonly type: "string";
+                        };
+                        readonly minGapMs: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly maxGapMs: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                    };
+                };
                 readonly boxShadow: {
                     readonly type: "object";
                     readonly additionalProperties: false;

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

@@ -8082,6 +8082,12 @@ var screenDescriptorSchema = {
   type: "object",
   additionalProperties: false,
   required: ["screenId", "renderer", "schemaVersion"],
+  // RFC 0069 replaces the legacy policy; combining both selects different
+  // host implementations, so reject that ambiguous descriptor.
+  not: {
+    required: ["transcriptScroll", "scrollToBottom"],
+    properties: { scrollToBottom: { const: true } }
+  },
   properties: {
     screenId: { type: "string", minLength: 1 },
     renderer: {
@@ -8097,6 +8103,19 @@ var screenDescriptorSchema = {
     // Chat-transcript scroll: host pins the scroll to the bottom with a
     // floating "jump to latest" affordance. Absent/false = top-anchored.
     scrollToBottom: { type: "boolean" },
+    // RFC 0069 — the chat transcript scroll policy (pin the sent turn, follow the
+    // reply). Both paths are `$service:` sentinels: a literal token could never
+    // change, so the policy would never fire.
+    transcriptScroll: {
+      type: "object",
+      additionalProperties: false,
+      required: ["sendPath"],
+      properties: {
+        sendPath: { type: "string", pattern: "^\\$service:" },
+        anchorPath: { type: "string", pattern: "^$|^\\$service:" },
+        jumpLabel: { type: "string" }
+      }
+    },
     url: { type: "string", format: "uri" },
     capabilitiesRequired: {
       type: "array",
@@ -8511,6 +8530,18 @@ var screenDescriptorSchema = {
             trigger: { type: "string", enum: ["on_change", "on_appear", "both", "none"] }
           }
         },
+        // RFC 0069 — recurring, finite, transform-only motion on a decorative node. `kind`
+        // is an open string: an unknown kind renders no motion, so an older validator must
+        // not reject a newer one.
+        ambientMotion: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            kind: { type: "string" },
+            minGapMs: { type: "integer", minimum: 0 },
+            maxGapMs: { type: "integer", minimum: 0 }
+          }
+        },
         // #1052 — explicit drop shadow (colour token + radius + offset), alongside the `shadow` token form.
         boxShadow: {
           type: "object",

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

@@ -6961,6 +6961,12 @@ var screenDescriptorSchema = {
   type: "object",
   additionalProperties: false,
   required: ["screenId", "renderer", "schemaVersion"],
+  // RFC 0069 replaces the legacy policy; combining both selects different
+  // host implementations, so reject that ambiguous descriptor.
+  not: {
+    required: ["transcriptScroll", "scrollToBottom"],
+    properties: { scrollToBottom: { const: true } }
+  },
   properties: {
     screenId: { type: "string", minLength: 1 },
     renderer: {
@@ -6976,6 +6982,19 @@ var screenDescriptorSchema = {
     // Chat-transcript scroll: host pins the scroll to the bottom with a
     // floating "jump to latest" affordance. Absent/false = top-anchored.
     scrollToBottom: { type: "boolean" },
+    // RFC 0069 — the chat transcript scroll policy (pin the sent turn, follow the
+    // reply). Both paths are `$service:` sentinels: a literal token could never
+    // change, so the policy would never fire.
+    transcriptScroll: {
+      type: "object",
+      additionalProperties: false,
+      required: ["sendPath"],
+      properties: {
+        sendPath: { type: "string", pattern: "^\\$service:" },
+        anchorPath: { type: "string", pattern: "^$|^\\$service:" },
+        jumpLabel: { type: "string" }
+      }
+    },
     url: { type: "string", format: "uri" },
     capabilitiesRequired: {
       type: "array",
@@ -7390,6 +7409,18 @@ var screenDescriptorSchema = {
             trigger: { type: "string", enum: ["on_change", "on_appear", "both", "none"] }
           }
         },
+        // RFC 0069 — recurring, finite, transform-only motion on a decorative node. `kind`
+        // is an open string: an unknown kind renders no motion, so an older validator must
+        // not reject a newer one.
+        ambientMotion: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            kind: { type: "string" },
+            minGapMs: { type: "integer", minimum: 0 },
+            maxGapMs: { type: "integer", minimum: 0 }
+          }
+        },
         // #1052 — explicit drop shadow (colour token + radius + offset), alongside the `shadow` token form.
         boxShadow: {
           type: "object",