@wix/himalaya-cli 0.1022.0 → 0.1023.0

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

@@ -349,7 +349,39 @@ export interface Modifiers {
     /** RFC 0058 §3.1 — additive state that a single role cannot carry. A node may
      *  hold several. */
     accessibilityTraits?: AccessibilityTrait[];
-}
+    /** RFC 0058 §4 — explicit traversal index within the nearest focus group. Absent ⇒
+     *  the arm's visual / DOM order. The lower index is reached FIRST, which is why iOS
+     *  (whose `accessibilitySortPriority` is descending) negates it. */
+    focusOrder?: number;
+    /** RFC 0058 §4 — this node's subtree is ONE traversal scope: children are ordered
+     *  relative to each other, then the group takes its parent's slot (iOS
+     *  `shouldGroupAccessibilityChildren`, Android `isTraversalGroup`, ARIA grouping). */
+    focusGroup?: boolean;
+    /** RFC 0058 §4 — AT / keyboard focus lands here when the screen or a newly presented
+     *  modal appears. At most one per focus scope. */
+    initialFocus?: boolean;
+    /** RFC 0058 §4 — a general live-region announcement, on any node and any transition.
+     *  The generalization of `FragmentSlotCase.accessibilityAnnouncement`, which only ever
+     *  fired on a fragment-slot case swap. */
+    announce?: LiveRegion;
+}
+/** 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
+ *  whose text just changed need no authoring at all. */
+export interface LiveRegion {
+    /** Default `"polite"`. `"assertive"` interrupts, and is for errors and destructive
+     *  confirmations — the wrong default everywhere else. */
+    politeness?: LiveRegionPoliteness;
+    /** Explicit text; empty/absent ⇒ the node's own resolved name + value. */
+    text?: string;
+    /** Default `"on_change"`. `"none"` is the deliberate opt-out — an enum rather than a
+     *  flag pair precisely so a default of "on" can still be turned off. */
+    trigger?: LiveRegionTrigger;
+}
+/** RFC 0058 §4 — how hard an announcement pushes. */
+export type LiveRegionPoliteness = "polite" | "assertive";
+/** RFC 0058 §4 — when an announcement fires. */
+export type LiveRegionTrigger = "on_change" | "on_appear" | "both" | "none";
 /** RFC 0058 §3.2 — the role AT announces for a node. The union of what iOS,
  *  Android, web and React Native can express; an arm that cannot express a role
  *  exactly falls back to the nearest one it has. */
@@ -1109,6 +1141,11 @@ export interface AlertDialogProps {
     confirmLabel?: string;
     /** #1059 — cancel button label; overridable. Default "Cancel". */
     cancelLabel?: string;
+    /** RFC 0058 §4 — the overlay traps focus and hides the rest of the tree from AT while
+     *  presented (iOS `accessibilityViewIsModal`, Android `isTraversalGroup`, ARIA
+     *  `aria-modal`). TRI-STATE: absent takes this component's default (**true**), an
+     *  explicit `false` opts it out. */
+    modal?: boolean;
 }
 export type TextMark = "bold" | "italic" | "underline" | "code" | "link";
 export interface TextRun {
@@ -1195,6 +1232,11 @@ export interface BottomSheetProps {
     /** "$service:" binding → bool (overrides `presented`). */
     presentedPath?: string;
     edge?: "bottom" | "leading" | "trailing";
+    /** RFC 0058 §4 — the overlay traps focus and hides the rest of the tree from AT while
+     *  presented (iOS `accessibilityViewIsModal`, Android `isTraversalGroup`, ARIA
+     *  `aria-modal`). TRI-STATE: absent takes this component's default (**true**), an
+     *  explicit `false` opts it out. */
+    modal?: boolean;
 }
 export interface MenuItem {
     id: string;
@@ -1210,6 +1252,11 @@ export interface MenuProps {
     style?: "dropdown" | "context" | "action_sheet";
     /** "$service:" binding → MenuItem[]. */
     itemsPath?: string;
+    /** RFC 0058 §4 — the overlay traps focus and hides the rest of the tree from AT while
+     *  presented (iOS `accessibilityViewIsModal`, Android `isTraversalGroup`, ARIA
+     *  `aria-modal`). TRI-STATE: absent keeps today's NON-modal behaviour (flipping this
+     *  component's default to modal is #2900); `true` opts in, an explicit `false` stays out. */
+    modal?: boolean;
 }
 export interface TooltipProps {
     anchor?: Component;
@@ -1227,6 +1274,11 @@ export interface PopoverProps {
     presented?: boolean;
     presentedPath?: string;
     onDismiss?: Action;
+    /** RFC 0058 §4 — the overlay traps focus and hides the rest of the tree from AT while
+     *  presented (iOS `accessibilityViewIsModal`, Android `isTraversalGroup`, ARIA
+     *  `aria-modal`). TRI-STATE: absent keeps today's NON-modal behaviour (flipping this
+     *  component's default to modal is #2900); `true` opts in, an explicit `false` stays out. */
+    modal?: boolean;
 }
 export interface ChipProps {
     label?: string;

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

@@ -624,6 +624,32 @@ export declare const screenDescriptorSchema: {
                         readonly enum: readonly ["selected", "disabled", "updates_frequently", "plays_sound", "starts_media"];
                     };
                 };
+                readonly focusOrder: {
+                    readonly type: "integer";
+                };
+                readonly focusGroup: {
+                    readonly type: "boolean";
+                };
+                readonly initialFocus: {
+                    readonly type: "boolean";
+                };
+                readonly announce: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly politeness: {
+                            readonly type: "string";
+                            readonly enum: readonly ["polite", "assertive"];
+                        };
+                        readonly text: {
+                            readonly type: "string";
+                        };
+                        readonly trigger: {
+                            readonly type: "string";
+                            readonly enum: readonly ["on_change", "on_appear", "both", "none"];
+                        };
+                    };
+                };
                 readonly boxShadow: {
                     readonly type: "object";
                     readonly additionalProperties: false;
@@ -1541,6 +1567,32 @@ export declare const widgetSnapshotSchema: {
                         readonly enum: readonly ["selected", "disabled", "updates_frequently", "plays_sound", "starts_media"];
                     };
                 };
+                readonly focusOrder: {
+                    readonly type: "integer";
+                };
+                readonly focusGroup: {
+                    readonly type: "boolean";
+                };
+                readonly initialFocus: {
+                    readonly type: "boolean";
+                };
+                readonly announce: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly politeness: {
+                            readonly type: "string";
+                            readonly enum: readonly ["polite", "assertive"];
+                        };
+                        readonly text: {
+                            readonly type: "string";
+                        };
+                        readonly trigger: {
+                            readonly type: "string";
+                            readonly enum: readonly ["on_change", "on_appear", "both", "none"];
+                        };
+                    };
+                };
                 readonly boxShadow: {
                     readonly type: "object";
                     readonly additionalProperties: false;

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

@@ -8323,6 +8323,22 @@ var screenDescriptorSchema = {
             enum: ["selected", "disabled", "updates_frequently", "plays_sound", "starts_media"]
           }
         },
+        // RFC 0058 §4 — focus and announcement (core.proto Modifiers 70–73). `modifiers`
+        // is `additionalProperties: false`, so a descriptor carrying one of these would be
+        // REJECTED on every arm at once until the validator knows it — which makes this
+        // part of the vocabulary rather than a downstream consumer of it.
+        focusOrder: { type: "integer" },
+        focusGroup: { type: "boolean" },
+        initialFocus: { type: "boolean" },
+        announce: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            politeness: { type: "string", enum: ["polite", "assertive"] },
+            text: { type: "string" },
+            trigger: { type: "string", enum: ["on_change", "on_appear", "both", "none"] }
+          }
+        },
         // #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

@@ -7369,6 +7369,22 @@ var screenDescriptorSchema = {
             enum: ["selected", "disabled", "updates_frequently", "plays_sound", "starts_media"]
           }
         },
+        // RFC 0058 §4 — focus and announcement (core.proto Modifiers 70–73). `modifiers`
+        // is `additionalProperties: false`, so a descriptor carrying one of these would be
+        // REJECTED on every arm at once until the validator knows it — which makes this
+        // part of the vocabulary rather than a downstream consumer of it.
+        focusOrder: { type: "integer" },
+        focusGroup: { type: "boolean" },
+        initialFocus: { type: "boolean" },
+        announce: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            politeness: { type: "string", enum: ["polite", "assertive"] },
+            text: { type: "string" },
+            trigger: { type: "string", enum: ["on_change", "on_appear", "both", "none"] }
+          }
+        },
         // #1052 — explicit drop shadow (colour token + radius + offset), alongside the `shadow` token form.
         boxShadow: {
           type: "object",