@wix/himalaya-cli 0.1000.0 → 0.1001.0

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

@@ -322,7 +322,40 @@ export interface Modifiers {
     /** #1052 — explicit drop shadow (colour + radius + offset), for upward / multi-layer
      *  shadows the `shadow` token can't express. */
     boxShadow?: Shadow;
-}
+    /** RFC 0058 §3.1 — the role assistive technology should announce. Absent = the
+     *  renderer INFERS it from the component type, so an author never restates the
+     *  obvious. `"decorative"` is node-local: the node itself stops being an
+     *  accessibility element (no role, not a stop) while its children stay
+     *  traversable — the ARIA `role="presentation"` semantic. To remove the subtree
+     *  too, use `accessibilityHidden`. */
+    accessibilityRole?: AccessibilityRole;
+    /** RFC 0058 §3.1 — the supplementary "what happens if I act" phrase
+     *  (iOS `accessibilityHint`, Android `onClickLabel`, ARIA `aria-describedby`).
+     *  Never a substitute for `accessibilityLabel`: AT may not speak a hint at all. */
+    accessibilityHint?: string;
+    /** RFC 0058 §3.1 — remove this node AND its subtree from the accessibility tree.
+     *  Distinct from `hidden` (which removes it visually too) and from the
+     *  `"decorative"` role (node-local; children stay reachable). */
+    accessibilityHidden?: boolean;
+    /** RFC 0058 §3.1 — mark the node as a heading at level 1–6, for rotor / heading
+     *  navigation. Implies the `"heading"` role when `accessibilityRole` is absent.
+     *  The LEVEL reaches iOS and web only: Android (Compose `heading()`) and React Native
+     *  (`accessibilityRole: "header"`) have no level primitive and mark a plain heading. */
+    headingLevel?: number;
+    /** RFC 0058 §3.1 — an explicit SPOKEN value where the visual and spoken values
+     *  differ (a rating "3 of 5", a gauge "72 percent"). Where the value is derivable
+     *  from a prop the renderer computes it and this override is unnecessary. */
+    accessibilityValue?: string;
+    /** RFC 0058 §3.1 — additive state that a single role cannot carry. A node may
+     *  hold several. */
+    accessibilityTraits?: AccessibilityTrait[];
+}
+/** 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. */
+export type AccessibilityRole = "decorative" | "text" | "heading" | "image" | "button" | "link" | "toggle" | "checkbox" | "radio" | "tab" | "tablist" | "adjustable" | "search" | "textfield" | "combobox" | "list" | "listitem" | "menu" | "menuitem" | "dialog" | "alert" | "progressbar" | "summary" | "status" | "group" | "grid" | "gridcell";
+/** RFC 0058 §3.2 — additive, orthogonal state a single role cannot carry. */
+export type AccessibilityTrait = "selected" | "disabled" | "updates_frequently" | "plays_sound" | "starts_media";
 /** Motion grammar (Phase-3) — drag-to-dismiss config (see `Modifiers.swipeDismiss`). */
 export interface SwipeDismiss {
     action: Action;
@@ -606,6 +639,11 @@ export interface IconProps {
     name: IconRef;
     size?: number;
     tint?: TokenName;
+    /** RFC 0058 §3.1 — the spoken name for a MEANINGFUL icon, mirroring
+     *  `ImageProps.contentDescription`. Absent (and with no enclosing labelled
+     *  control) the icon is decorative and stays OUT of the accessibility tree,
+     *  rather than being announced by its raw glyph name. */
+    contentDescription?: string;
 }
 export interface ButtonProps {
     /** Button label — binding-aware ("$item."/"$service:") on web, iOS and Android. */

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

@@ -599,6 +599,31 @@ export declare const screenDescriptorSchema: {
                 readonly hitTestable: {
                     readonly type: "boolean";
                 };
+                readonly accessibilityRole: {
+                    readonly type: "string";
+                    readonly enum: readonly ["decorative", "text", "heading", "image", "button", "link", "toggle", "checkbox", "radio", "tab", "tablist", "adjustable", "search", "textfield", "combobox", "list", "listitem", "menu", "menuitem", "dialog", "alert", "progressbar", "summary", "status", "group", "grid", "gridcell"];
+                };
+                readonly accessibilityHint: {
+                    readonly type: "string";
+                };
+                readonly accessibilityHidden: {
+                    readonly type: "boolean";
+                };
+                readonly headingLevel: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 6;
+                };
+                readonly accessibilityValue: {
+                    readonly type: "string";
+                };
+                readonly accessibilityTraits: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly enum: readonly ["selected", "disabled", "updates_frequently", "plays_sound", "starts_media"];
+                    };
+                };
                 readonly boxShadow: {
                     readonly type: "object";
                     readonly additionalProperties: false;
@@ -1491,6 +1516,31 @@ export declare const widgetSnapshotSchema: {
                 readonly hitTestable: {
                     readonly type: "boolean";
                 };
+                readonly accessibilityRole: {
+                    readonly type: "string";
+                    readonly enum: readonly ["decorative", "text", "heading", "image", "button", "link", "toggle", "checkbox", "radio", "tab", "tablist", "adjustable", "search", "textfield", "combobox", "list", "listitem", "menu", "menuitem", "dialog", "alert", "progressbar", "summary", "status", "group", "grid", "gridcell"];
+                };
+                readonly accessibilityHint: {
+                    readonly type: "string";
+                };
+                readonly accessibilityHidden: {
+                    readonly type: "boolean";
+                };
+                readonly headingLevel: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 6;
+                };
+                readonly accessibilityValue: {
+                    readonly type: "string";
+                };
+                readonly accessibilityTraits: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly enum: readonly ["selected", "disabled", "updates_frequently", "plays_sound", "starts_media"];
+                    };
+                };
                 readonly boxShadow: {
                     readonly type: "object";
                     readonly additionalProperties: false;

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

@@ -8251,6 +8251,52 @@ var screenDescriptorSchema = {
         zIndex: { type: "integer" },
         blur: { type: "integer", minimum: 0 },
         hitTestable: { type: "boolean" },
+        // RFC 0058 §3.1 — the accessibility grammar (core.proto Modifiers 63–68).
+        // `accessibilityLabel` (field 5, above) is the NAME; these carry role, hint,
+        // tree membership, heading structure, spoken value and additive state.
+        accessibilityRole: {
+          type: "string",
+          enum: [
+            "decorative",
+            "text",
+            "heading",
+            "image",
+            "button",
+            "link",
+            "toggle",
+            "checkbox",
+            "radio",
+            "tab",
+            "tablist",
+            "adjustable",
+            "search",
+            "textfield",
+            "combobox",
+            "list",
+            "listitem",
+            "menu",
+            "menuitem",
+            "dialog",
+            "alert",
+            "progressbar",
+            "summary",
+            "status",
+            "group",
+            "grid",
+            "gridcell"
+          ]
+        },
+        accessibilityHint: { type: "string" },
+        accessibilityHidden: { type: "boolean" },
+        headingLevel: { type: "integer", minimum: 1, maximum: 6 },
+        accessibilityValue: { type: "string" },
+        accessibilityTraits: {
+          type: "array",
+          items: {
+            type: "string",
+            enum: ["selected", "disabled", "updates_frequently", "plays_sound", "starts_media"]
+          }
+        },
         // #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

@@ -7323,6 +7323,52 @@ var screenDescriptorSchema = {
         zIndex: { type: "integer" },
         blur: { type: "integer", minimum: 0 },
         hitTestable: { type: "boolean" },
+        // RFC 0058 §3.1 — the accessibility grammar (core.proto Modifiers 63–68).
+        // `accessibilityLabel` (field 5, above) is the NAME; these carry role, hint,
+        // tree membership, heading structure, spoken value and additive state.
+        accessibilityRole: {
+          type: "string",
+          enum: [
+            "decorative",
+            "text",
+            "heading",
+            "image",
+            "button",
+            "link",
+            "toggle",
+            "checkbox",
+            "radio",
+            "tab",
+            "tablist",
+            "adjustable",
+            "search",
+            "textfield",
+            "combobox",
+            "list",
+            "listitem",
+            "menu",
+            "menuitem",
+            "dialog",
+            "alert",
+            "progressbar",
+            "summary",
+            "status",
+            "group",
+            "grid",
+            "gridcell"
+          ]
+        },
+        accessibilityHint: { type: "string" },
+        accessibilityHidden: { type: "boolean" },
+        headingLevel: { type: "integer", minimum: 1, maximum: 6 },
+        accessibilityValue: { type: "string" },
+        accessibilityTraits: {
+          type: "array",
+          items: {
+            type: "string",
+            enum: ["selected", "disabled", "updates_frequently", "plays_sound", "starts_media"]
+          }
+        },
         // #1052 — explicit drop shadow (colour token + radius + offset), alongside the `shadow` token form.
         boxShadow: {
           type: "object",

package/dist/cli.mjs

@@ -5913,6 +5913,52 @@ var init_validator = __esm({
             zIndex: { type: "integer" },
             blur: { type: "integer", minimum: 0 },
             hitTestable: { type: "boolean" },
+            // RFC 0058 §3.1 — the accessibility grammar (core.proto Modifiers 63–68).
+            // `accessibilityLabel` (field 5, above) is the NAME; these carry role, hint,
+            // tree membership, heading structure, spoken value and additive state.
+            accessibilityRole: {
+              type: "string",
+              enum: [
+                "decorative",
+                "text",
+                "heading",
+                "image",
+                "button",
+                "link",
+                "toggle",
+                "checkbox",
+                "radio",
+                "tab",
+                "tablist",
+                "adjustable",
+                "search",
+                "textfield",
+                "combobox",
+                "list",
+                "listitem",
+                "menu",
+                "menuitem",
+                "dialog",
+                "alert",
+                "progressbar",
+                "summary",
+                "status",
+                "group",
+                "grid",
+                "gridcell"
+              ]
+            },
+            accessibilityHint: { type: "string" },
+            accessibilityHidden: { type: "boolean" },
+            headingLevel: { type: "integer", minimum: 1, maximum: 6 },
+            accessibilityValue: { type: "string" },
+            accessibilityTraits: {
+              type: "array",
+              items: {
+                type: "string",
+                enum: ["selected", "disabled", "updates_frequently", "plays_sound", "starts_media"]
+              }
+            },
             // #1052 — explicit drop shadow (colour token + radius + offset), alongside the `shadow` token form.
             boxShadow: {
               type: "object",
@@ -8683,7 +8729,9 @@ var init_validate_descriptor_core = __esm({
         staggerMs: "number"
       },
       HStack: { alignment: "string", children: "array", spacing: "number" },
-      Icon: { name: "string", size: "number", tint: "string" },
+      // RFC 0058 §3.1 — `contentDescription` names a MEANINGFUL icon (mirroring Image);
+      // its absence is what marks an icon decorative.
+      Icon: { contentDescription: "string", name: "string", size: "number", tint: "string" },
       Image: {
         aspectRatio: "number",
         asset: "string",
@@ -9279,6 +9327,7 @@ var init_validate_descriptor_core = __esm({
       "blur",
       "cornerRadius",
       "enterDelayMs",
+      "headingLevel",
       "height",
       "maxWidth",
       "offsetX",
@@ -23572,19 +23621,44 @@ function withExtras(name, render) {
     const el = render({ props, ctx, wrap, nodeId, gap });
     if (!React5.isValidElement(el)) return /* @__PURE__ */ jsx6(Fragment3, { children: el });
     const additive = addIntrinsicPadding(el.props.style, wrap ?? {});
+    const inferredDecorative = el.props[INFERRED_DECORATIVE] === true;
+    const iconGlyph2 = el.props[ICON_GLYPH] === true;
     if (!Object.keys(pass).length) {
+      if (inferredDecorative || iconGlyph2) {
+        return React5.cloneElement(el, { [INFERRED_DECORATIVE]: void 0, [ICON_GLYPH]: void 0, ...additive ? { style: additive } : {} });
+      }
       return additive ? React5.cloneElement(el, { style: additive }) : /* @__PURE__ */ jsx6(Fragment3, { children: el });
     }
     const prev = el.props;
     const next = { ...pass };
+    if (inferredDecorative) {
+      next[INFERRED_DECORATIVE] = void 0;
+      const passRole = typeof pass.role === "string" ? pass.role : void 0;
+      const nodeSpeaksForItself = pass["aria-label"] != null || passRole != null && passRole !== "presentation" && passRole !== "none" || typeof pass.onClick === "function" || typeof pass.onDoubleClick === "function";
+      if (pass["aria-hidden"] == null && nodeSpeaksForItself) next["aria-hidden"] = void 0;
+    }
+    if (iconGlyph2) {
+      next[ICON_GLYPH] = void 0;
+      if (pass.role === "presentation" && typeof pass.onClick !== "function" && typeof pass.onDoubleClick !== "function") {
+        next["aria-hidden"] = "true";
+        next["aria-label"] = void 0;
+        next.title = void 0;
+        next.role = void 0;
+      }
+    }
+    const roleIsSynthetic = next[SYNTHETIC_TAP_ROLE] === true;
+    delete next[SYNTHETIC_TAP_ROLE];
     if (additive) next.style = additive;
     const ownsInteractiveSemantics = isNativeInteractiveElement(el) || hasInteractiveReactDescendant(el);
     if (ownsInteractiveSemantics) {
-      delete next.role;
+      if (roleIsSynthetic) delete next.role;
       delete next.tabIndex;
       delete next.onKeyDown;
     }
     if (pass.style) next.style = { ...additive ?? prev.style ?? {}, ...pass.style };
+    if (typeof pass["aria-describedby"] === "string" && typeof prev["aria-describedby"] === "string") {
+      next["aria-describedby"] = `${prev["aria-describedby"]} ${pass["aria-describedby"]}`;
+    }
     if (typeof pass.onClick === "function" && typeof prev.onClick === "function") {
       next.onClick = (e) => {
         prev.onClick(e);
@@ -24014,6 +24088,63 @@ function calKeyActivate(enabled, activate) {
     activate();
   };
 }
+function applyA11ySemantics(node, ctx, extra) {
+  const m = node?.modifiers;
+  if (!m) return void 0;
+  const str6 = (v) => {
+    if (v == null) return void 0;
+    const r = resolveScalarStatic(v, ctx);
+    const s = r == null ? "" : String(r).trim();
+    return s === "" ? void 0 : s;
+  };
+  if ((m.accessibilityHidden ?? m.accessibility_hidden) === true) {
+    extra["aria-hidden"] = "true";
+    extra.inert = "";
+    return void 0;
+  }
+  const role = str6(m.accessibilityRole ?? m.accessibility_role);
+  const headingLevel = m.headingLevel ?? m.heading_level;
+  const tappable = Boolean((m.onTap ?? m.on_tap ?? m.onDoubleTap ?? m.on_double_tap) && ctx.onAction);
+  if (role === "decorative" && !tappable) {
+    extra.role = "presentation";
+    delete extra["aria-label"];
+    return void 0;
+  } else if (role != null && role !== "decorative" && ARIA_ROLE[role]) {
+    extra.role = ARIA_ROLE[role];
+  } else if (typeof headingLevel === "number" && headingLevel >= 1 && headingLevel <= 6) {
+    extra.role = "heading";
+  }
+  if (typeof headingLevel === "number" && headingLevel >= 1 && headingLevel <= 6) {
+    extra["aria-level"] = String(headingLevel);
+  }
+  const hint = str6(m.accessibilityHint ?? m.accessibility_hint);
+  const value = str6(m.accessibilityValue ?? m.accessibility_value);
+  if (value) extra["aria-valuetext"] = value;
+  const traits = m.accessibilityTraits ?? m.accessibility_traits;
+  if (Array.isArray(traits)) {
+    for (const t of traits) {
+      switch (t) {
+        case "selected":
+          extra["aria-selected"] = "true";
+          break;
+        case "disabled":
+          extra["aria-disabled"] = "true";
+          break;
+        // `updates_frequently` means "do not announce every tick" — on web that is an
+        // explicit `aria-live="off"`, which overrides an ancestor live region.
+        case "updates_frequently":
+          extra["aria-live"] = "off";
+          break;
+        // `plays_sound` / `starts_media` are iOS speech-behaviour traits with no ARIA
+        // counterpart; §3.2 says an arm falls back to the nearest thing it HAS, and ARIA
+        // has nothing here, so they are ignored rather than approximated.
+        default:
+          break;
+      }
+    }
+  }
+  return hint;
+}
 function renderNodeInner(node, ctx) {
   if (ctx.previewSurface && node && typeof node === "object") {
     const { type } = normalize(node);
@@ -24088,6 +24219,8 @@ function renderNodeInner(node, ctx) {
       if (resolved2 != null && String(resolved2).trim()) extra["aria-label"] = String(resolved2);
     }
   }
+  const a11yHint = applyA11ySemantics(node, ctx, extra);
+  const a11yHidden = extra["aria-hidden"] === "true";
   const tap = node?.modifiers?.onTap ?? node?.modifiers?.on_tap;
   const tapDisabled = normalize(node).props?.disabled === true || normalize(node).props?.loading === true || node?.modifiers?.disabled === true || node?.modifiers?.hitTestable === false || node?.modifiers?.hit_testable === false;
   if (tap && ctx.onAction && !tapDisabled) {
@@ -24097,8 +24230,11 @@ function renderNodeInner(node, ctx) {
       prevOnClick?.(e);
       ctx.onAction(resolveItemDeep2(tap, ctx));
     };
-    if (!isNativeInteractiveElement(el) && !hasInteractiveDescendant(node)) {
-      extra.role = "button";
+    if (!a11yHidden && !isNativeInteractiveElement(el) && !hasInteractiveDescendant(node)) {
+      if (extra.role == null) {
+        extra.role = "button";
+        if (typeof el.type !== "string") extra[SYNTHETIC_TAP_ROLE] = true;
+      }
       extra.tabIndex = 0;
       const prevOnKeyDown = el.props.onKeyDown;
       extra.onKeyDown = (e) => {
@@ -24145,7 +24281,10 @@ function renderNodeInner(node, ctx) {
       if (composed) extra.style = composed;
     }
   }
-  const out = Object.keys(extra).length ? React5.cloneElement(el, extra) : el;
+  let out = Object.keys(extra).length ? React5.cloneElement(el, extra) : el;
+  if (a11yHint) {
+    out = /* @__PURE__ */ jsx6(A11yHintDescription, { hint: a11yHint, idBase: componentId, children: out });
+  }
   const sd = node?.modifiers?.swipeDismiss ?? node?.modifiers?.swipe_dismiss;
   if (sd?.action && ctx.onAction) {
     return /* @__PURE__ */ jsx6(SwipeDismissWrap, { action: sd.action, direction: sd.direction, onAction: ctx.onAction, children: out });
@@ -24853,7 +24992,7 @@ function renderInner(node, ctx) {
     }
   }
 }
-var useIsomorphicLayoutEffect, ResponsiveGrid, SPLIT_EXPANDED_MIN_WIDTH, SPLIT_COLUMN_GAP, ResponsiveSplitView, ABSOLUTE_URL_RE, appearKeyframesInjected, pressStylesInjected, FOCUS_RING_CSS, focusStylesInjected, HLIST_CHILD_CSS, hListStylesInjected, listAnimateRuntimeInstalled, transitionKeyframesInjected, countUpRuntimeInjected, MEASURE_PREFIX, measureRuntimeInjected, revealRuntimeInjected, vectorAnimStylesInjected, scrollProgressRuntimeInjected, confettiRuntimeInjected, lottieRuntimeInjected, riveRuntimeInjected, gradientKeyframesInjected, parallaxRuntimeInjected, spinKeyframesInjected, marqueeKeyframesInjected, alignItems, zJustifyItems, hAlignItems, bodyFont, kids, rowKids, staggeredKids, asTextL10n, asBoundText, useBoundString, InterpolatedTextView, txt, selectFragmentCase, fragmentValueHash, fragmentSlotContent, FragmentSlotNode, WorkerSubtreeNode, resolveItemDeep2, resolveSwipeActions, resolveModBindings, resolvedComponentId, directServiceBindings, ReactiveDirectScalars, HiddenGate, KEYBOARD_INPUT_MODES, AUTOCAPITALIZE_VALUES, ENTER_KEY_HINTS, AUTOGROW_CEILING, EditableField, MenuNode, LoadMoreSentinel, FieldErrorNode, FormView, MediaSlotProvider, MEDIA_ITEM_BINDABLE, MediaPlayerView, VideoNode, PdfViewNode, WebViewNode, InteractivePicker, InteractiveDatePicker, InteractiveSearchField, InteractiveStepper, INTERACTIVE_ROLES, ALWAYS_INTERACTIVE_COMPONENT_TYPES, controlNode, ToggleNode, SliderNode, SelectionControlNode, TabsNode, SegmentedControlNode, DisclosureGroupNode, GridNode, SplitViewNode, TextNode, ImageNode, AvatarNode, IconNode, ButtonNode, OtpInputNode, ProgressBarNode, ActivityIndicatorNode, BottomSheetNode, ChipsInputNode, ChipNode, TableNode, GaugeRing, GaugeNode, RatingNode, AvatarStripNode, CHART_STROKE_CYCLE, chartStrokeAt, chartBarCenter, ChartNode, donutSliceOpacity, DonutChartNode, LegendMarker, LegendNode, cellAlign, DataTableNode, voiceNoteState, voiceNoteDelivery, VOICE_NOTE_DEFAULT_BARS, clampBarCount, VoiceNoteNode, TimelineNode, WheelPickerNode, ColorPickerNode, FilterChipsNode, TILE_PX, MAX_MERCATOR_LAT, DEFAULT_TILE_MAX_ZOOM, CIRCLE_SEGMENTS, METRES_PER_DEG_LAT, MARKER_HIT_RADIUS, SHAPE_HIT_RADIUS, MapNode, CollapsingHeaderNode, UnsupportedOnSurface, CALENDAR_DATE_ONLY_RE, CAL_DEFAULT_MAX_DOTS, CAL_AGENDA_INITIAL_DAYS, CAL_AGENDA_PAGE_DAYS, CAL_DEFAULT_SNAP_MINUTES, CAL_UNASSIGNED_LANE_ID, MonthCalendarNode, TimeGridNode, AgendaNode, WebRenderer;
+var useIsomorphicLayoutEffect, ResponsiveGrid, SPLIT_EXPANDED_MIN_WIDTH, SPLIT_COLUMN_GAP, ResponsiveSplitView, ABSOLUTE_URL_RE, appearKeyframesInjected, pressStylesInjected, FOCUS_RING_CSS, focusStylesInjected, HLIST_CHILD_CSS, hListStylesInjected, listAnimateRuntimeInstalled, transitionKeyframesInjected, countUpRuntimeInjected, MEASURE_PREFIX, measureRuntimeInjected, revealRuntimeInjected, vectorAnimStylesInjected, scrollProgressRuntimeInjected, confettiRuntimeInjected, lottieRuntimeInjected, riveRuntimeInjected, gradientKeyframesInjected, parallaxRuntimeInjected, spinKeyframesInjected, marqueeKeyframesInjected, alignItems, zJustifyItems, hAlignItems, bodyFont, kids, rowKids, staggeredKids, asTextL10n, asBoundText, useBoundString, InterpolatedTextView, txt, selectFragmentCase, fragmentValueHash, fragmentSlotContent, FragmentSlotNode, WorkerSubtreeNode, resolveItemDeep2, resolveSwipeActions, resolveModBindings, resolvedComponentId, directServiceBindings, ReactiveDirectScalars, HiddenGate, KEYBOARD_INPUT_MODES, AUTOCAPITALIZE_VALUES, ENTER_KEY_HINTS, AUTOGROW_CEILING, EditableField, MenuNode, LoadMoreSentinel, FieldErrorNode, FormView, MediaSlotProvider, MEDIA_ITEM_BINDABLE, MediaPlayerView, VideoNode, PdfViewNode, WebViewNode, InteractivePicker, InteractiveDatePicker, InteractiveSearchField, InteractiveStepper, SYNTHETIC_TAP_ROLE, INFERRED_DECORATIVE, ICON_GLYPH, INTERACTIVE_ROLES, ALWAYS_INTERACTIVE_COMPONENT_TYPES, controlNode, ToggleNode, SliderNode, SelectionControlNode, TabsNode, SegmentedControlNode, DisclosureGroupNode, GridNode, SplitViewNode, TextNode, ImageNode, AvatarNode, IconNode, ButtonNode, OtpInputNode, ProgressBarNode, ActivityIndicatorNode, BottomSheetNode, ChipsInputNode, ChipNode, TableNode, GaugeRing, GaugeNode, RatingNode, AvatarStripNode, CHART_STROKE_CYCLE, chartStrokeAt, chartBarCenter, ChartNode, donutSliceOpacity, DonutChartNode, LegendMarker, LegendNode, cellAlign, DataTableNode, voiceNoteState, voiceNoteDelivery, VOICE_NOTE_DEFAULT_BARS, clampBarCount, VoiceNoteNode, TimelineNode, WheelPickerNode, ColorPickerNode, FilterChipsNode, TILE_PX, MAX_MERCATOR_LAT, DEFAULT_TILE_MAX_ZOOM, CIRCLE_SEGMENTS, METRES_PER_DEG_LAT, MARKER_HIT_RADIUS, SHAPE_HIT_RADIUS, MapNode, CollapsingHeaderNode, UnsupportedOnSurface, CALENDAR_DATE_ONLY_RE, CAL_DEFAULT_MAX_DOTS, CAL_AGENDA_INITIAL_DAYS, CAL_AGENDA_PAGE_DAYS, CAL_DEFAULT_SNAP_MINUTES, CAL_UNASSIGNED_LANE_ID, MonthCalendarNode, TimeGridNode, AgendaNode, ARIA_ROLE, A11yHintDescription, WebRenderer;
 var init_renderNode = __esm({
   "../../core/web-renderer/src/renderNode.tsx"() {
     "use strict";
@@ -26327,6 +26466,9 @@ var init_renderNode = __esm({
         /* @__PURE__ */ jsx6("button", { type: "button", "aria-label": "Increase", disabled: disabled("max"), onClick: () => bump(step), style: { ...btn("max"), font: "inherit" }, children: "+" })
       ] });
     });
+    SYNTHETIC_TAP_ROLE = "data-hm-synthetic-role";
+    INFERRED_DECORATIVE = "data-hm-inferred-decorative";
+    ICON_GLYPH = "data-hm-icon-glyph";
     INTERACTIVE_ROLES = /* @__PURE__ */ new Set([
       "button",
       "checkbox",
@@ -26532,7 +26674,10 @@ var init_renderNode = __esm({
       const size = props.size ?? 22;
       const bound = useResolvedScalar(isBinding(props.name) ? props.name : void 0, ctx);
       const iconName = isBinding(props.name) ? String(bound ?? "") : props.name;
-      return /* @__PURE__ */ jsx6("span", { title: iconName, style: { display: "inline-grid", placeItems: "center", width: size + 6, height: size + 6, lineHeight: 1, flex: "none", ...wrap }, children: iconSvg(iconName, { size, color: C(resolveScalarStatic(props.tint, ctx) ?? "textPrimary", "#636b78") }) });
+      const contentDescription = useResolvedScalar(props.contentDescription, ctx);
+      const described = contentDescription != null && String(contentDescription).trim() !== "";
+      const a11y = described ? { role: "img", "aria-label": String(contentDescription), [ICON_GLYPH]: true } : { "aria-hidden": "true", [INFERRED_DECORATIVE]: true, [ICON_GLYPH]: true };
+      return /* @__PURE__ */ jsx6("span", { ...a11y, style: { display: "inline-grid", placeItems: "center", width: size + 6, height: size + 6, lineHeight: 1, flex: "none", ...wrap }, children: iconSvg(iconName, { size, color: C(resolveScalarStatic(props.tint, ctx) ?? "textPrimary", "#636b78") }) });
     });
     ButtonNode = withExtras("ButtonNode", ({ props, ctx, wrap }) => {
       const C = ctx.color;
@@ -28185,6 +28330,46 @@ var init_renderNode = __esm({
         )
       ] });
     });
+    ARIA_ROLE = {
+      text: "",
+      // no ARIA role — plain text is already exposed as text
+      heading: "heading",
+      image: "img",
+      button: "button",
+      link: "link",
+      toggle: "switch",
+      checkbox: "checkbox",
+      radio: "radio",
+      tab: "tab",
+      tablist: "tablist",
+      adjustable: "slider",
+      search: "searchbox",
+      textfield: "textbox",
+      combobox: "combobox",
+      list: "list",
+      listitem: "listitem",
+      menu: "menu",
+      menuitem: "menuitem",
+      dialog: "dialog",
+      alert: "alert",
+      progressbar: "progressbar",
+      summary: "group",
+      status: "status",
+      group: "group",
+      grid: "grid",
+      gridcell: "gridcell"
+    };
+    A11yHintDescription = ({ hint, idBase, children, ...forwarded }) => {
+      const descId = `${idBase ?? "hm"}__hint${React5.useId()}`;
+      const own2 = children.props;
+      const next = { ...forwarded };
+      if (forwarded.style) next.style = { ...own2.style ?? {}, ...forwarded.style };
+      next["aria-describedby"] = [own2["aria-describedby"], descId].filter(Boolean).join(" ");
+      return /* @__PURE__ */ jsxs3(Fragment3, { children: [
+        React5.cloneElement(children, next),
+        /* @__PURE__ */ jsx6("span", { id: descId, hidden: true, "data-hm-a11y-hint": "", children: hint })
+      ] });
+    };
     WebRenderer = ({ node, tokens, scheme = "light", opts }) => {
       return /* @__PURE__ */ jsx6(Fragment3, { children: renderNode(node, makeCtx(tokens, scheme, opts)) });
     };
@@ -45119,19 +45304,19 @@ var init_preview_assets_generated = __esm({
   "../../packages/serve/src/preview-assets.generated.ts"() {
     init_preview_assets_format();
     PREVIEW_ASSET_MANIFEST = [
-      { key: "assets/index-DDTP2AZP.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 1006262, sha256: "a58db7c122941f1b116a9f14d311e8a7215b9f2cfa89aed7c948c894613753d9" },
-      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 1006270, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
-      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 1097194, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
-      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 1188178, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
-      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 1279158, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
-      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 1370030, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
-      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 1461010, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
-      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 1569646, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
-      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 1678730, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
-      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 1787778, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
-      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 1895478, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
-      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 1983586, length: 4448, sha256: "65ea76642aa529b3a8f3826561ee9627fe9cde9d249abc1bba3e6a9b462ac25c" },
-      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 1988034, length: 17209, sha256: "dffc9718e2faa63ae2cc919e0a842f585ed565aaaa7c53778e90379442c731b6" }
+      { key: "assets/index-H72XVDeZ.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 1009153, sha256: "494ebf398dfe5604666d1699bc6209b584a78a6a85d33a55553eca57124fe04c" },
+      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 1009161, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
+      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 1100085, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
+      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 1191069, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
+      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 1282049, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
+      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 1372921, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
+      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 1463901, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
+      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 1572537, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
+      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 1681621, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
+      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 1790669, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
+      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 1898369, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
+      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 1986477, length: 4448, sha256: "375c26618baf6332437220049558fe0694b614fa92018d237a5c5c22ee5b3bde" },
+      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 1990925, length: 17209, sha256: "dffc9718e2faa63ae2cc919e0a842f585ed565aaaa7c53778e90379442c731b6" }
     ];
   }
 });