@wix/himalaya-cli 0.1031.0 → 0.1032.0

package/dist/cli.mjs

@@ -1264,6 +1264,26 @@ var init_compiler_options = __esm({
 import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync3, existsSync as existsSync2, readdirSync as readdirSync2, readFileSync as readFileSync3, statSync, lstatSync, copyFileSync } from "node:fs";
 import { resolve as resolve2, join as join3, dirname as dirname2 } from "node:path";
 import { fileURLToPath } from "node:url";
+function keptPlanNote(kept) {
+  if (!kept?.length) return void 0;
+  const pronoun = kept.length === 1 ? "it" : "them";
+  return `kept your existing ${kept.join(" and ")} \u2014 init did not overwrite ${pronoun}. Check ${pronoun} against \`himi docs mobile-ux\` (the headings \`validate --strict\` requires) before implementing.`;
+}
+function gitignoreKey(line) {
+  return line.trim().replace(/^\//, "").replace(/\/$/, "");
+}
+function ensurePackageGitignore(res) {
+  const dest = join3(res.dir, ".gitignore");
+  const existing = existsSync2(dest) ? readFileSync3(dest, "utf8") : null;
+  const present = new Set((existing ?? "").split(/\r?\n/).map(gitignoreKey));
+  const missing = PACKAGE_GITIGNORE.filter((entry) => !present.has(gitignoreKey(entry)));
+  if (missing.length === 0) return res;
+  const prefix = existing === null ? "" : existing.length === 0 || existing.endsWith("\n") ? existing : `${existing}
+`;
+  writeFileSync3(dest, `${prefix}${missing.join("\n")}
+`);
+  return res.files.includes(".gitignore") ? res : { ...res, files: [...res.files, ".gitignore"].sort() };
+}
 function defaultPackageJson(name) {
   return JSON.stringify(
     {
@@ -1364,9 +1384,14 @@ function sentinelizeArchive(raw, fallbackName) {
 }
 function materializeSource(files, name, destDir, slug = name) {
   const written = [];
+  const kept = [];
   for (const [rel, body] of Object.entries(files)) {
     if (rel === TEMPLATE_META_FILE) continue;
     const dest = join3(destDir, rel);
+    if (PLAN_FILES.has(rel) && existsSync2(dest)) {
+      kept.push(rel);
+      continue;
+    }
     mkdirSync3(resolve2(dest, ".."), { recursive: true });
     const materialized = substituteIdentity(body, name, slug);
     writeFileSync3(dest, MODULE_SOURCE_FILE.test(rel) ? offRepoImports(materialized) : materialized);
@@ -1375,6 +1400,10 @@ function materializeSource(files, name, destDir, slug = name) {
   for (const [rel, body] of [["SPEC.md", SPEC_TEMPLATE], ["MOBILE-UX.md", MOBILE_UX_TEMPLATE]]) {
     if (Object.prototype.hasOwnProperty.call(files, rel)) continue;
     const dest = join3(destDir, rel);
+    if (existsSync2(dest)) {
+      kept.push(rel);
+      continue;
+    }
     mkdirSync3(resolve2(dest, ".."), { recursive: true });
     writeFileSync3(dest, body);
     written.push(rel);
@@ -1390,19 +1419,20 @@ function materializeSource(files, name, destDir, slug = name) {
     written.push("tsconfig.json");
   }
   written.sort();
-  return { dir: destDir, files: written };
+  return { dir: destDir, files: written, ...kept.length ? { kept: kept.sort() } : {} };
 }
-function finishScaffold(res, template) {
+function finishScaffold(scaffolded, template) {
+  const res = ensurePackageGitignore(scaffolded);
   if (!template) return res;
   const dest = join3(res.dir, "icon.png");
   if (existsSync2(dest)) {
     if (res.files.includes("icon.png")) return res;
-    return { dir: res.dir, files: [...res.files, "icon.png"].sort() };
+    return { ...res, files: [...res.files, "icon.png"].sort() };
   }
   const src = templateIconPath(template);
   if (!src) return res;
   copyFileSync(src, dest);
-  return { dir: res.dir, files: [...res.files, "icon.png"].sort() };
+  return { ...res, files: [...res.files, "icon.png"].sort() };
 }
 function isBinaryTemplateFile(rel) {
   return BINARY_EXTENSIONS.has(extOf(rel));
@@ -1448,8 +1478,13 @@ function scaffoldContentPackage(name, parentDir, template) {
   const idSeg = name.replace(/[^a-z0-9]/gi, "").toLowerCase() || "app";
   const appId2 = `com.example.${idSeg}`;
   const files = [];
+  const kept = [];
   const write2 = (rel, body) => {
     const p = join3(dir, rel);
+    if (PLAN_FILES.has(rel) && existsSync2(p)) {
+      kept.push(rel);
+      return;
+    }
     mkdirSync3(resolve2(p, ".."), { recursive: true });
     writeFileSync3(p, body);
     files.push(rel);
@@ -1641,14 +1676,16 @@ A per-app \`npm i @wix/himalaya\` is optional and only buys your editor local ty
     himi agent-init                # seed this dir with HIMALAYA.md + reference + example
 `
   );
-  return { dir, files };
+  return finishScaffold({ dir, files, ...kept.length ? { kept: kept.sort() } : {} });
 }
-var MODULE_SOURCE_FILE, TEMPLATES_DIR, SHOWCASE_TEMPLATES_DIR, SHOWCASE_TEMPLATE_NAMES, TEMPLATE_META_FILE, TEMPLATE_ICONS_DIR, HEX_COLOR, PALETTE_KEYS, IDENTITY_SENTINELS, escapeRe, NAME_FIELDS, IDENTITY_FILES, DOTID_RE, BINARY_EXTENSIONS, extOf;
+var PLAN_FILES, PACKAGE_GITIGNORE, MODULE_SOURCE_FILE, TEMPLATES_DIR, SHOWCASE_TEMPLATES_DIR, SHOWCASE_TEMPLATE_NAMES, TEMPLATE_META_FILE, TEMPLATE_ICONS_DIR, HEX_COLOR, PALETTE_KEYS, IDENTITY_SENTINELS, escapeRe, NAME_FIELDS, IDENTITY_FILES, DOTID_RE, BINARY_EXTENSIONS, extOf;
 var init_scaffold = __esm({
   "src/scaffold.ts"() {
     init_source_deny();
     init_mobile_ux_contract();
     init_compiler_options();
+    PLAN_FILES = /* @__PURE__ */ new Set(["SPEC.md", "MOBILE-UX.md"]);
+    PACKAGE_GITIGNORE = [".himi/", "dist/", "node_modules/"];
     MODULE_SOURCE_FILE = /\.(?:[cm]?[jt]sx?)$/i;
     TEMPLATES_DIR = resolve2(dirname2(fileURLToPath(import.meta.url)), "../templates");
     SHOWCASE_TEMPLATES_DIR = resolve2(dirname2(fileURLToPath(import.meta.url)), "../showcase-apps");
@@ -24467,11 +24504,11 @@ function withExtras(name, render) {
     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;
+    const selfRenderedLeaf = el.props[SELF_RENDERED_LEAF] === true;
     const roleWhenNamed = el.props[ROLE_WHEN_NAMED];
     if (!Object.keys(pass).length) {
-      if (inferredDecorative || iconGlyph2 || roleWhenNamed != null) {
-        return React5.cloneElement(el, { [INFERRED_DECORATIVE]: void 0, [ICON_GLYPH]: void 0, [ROLE_WHEN_NAMED]: void 0, ...additive ? { style: additive } : {} });
+      if (inferredDecorative || selfRenderedLeaf || roleWhenNamed != null) {
+        return React5.cloneElement(el, { [INFERRED_DECORATIVE]: void 0, [SELF_RENDERED_LEAF]: void 0, [ROLE_WHEN_NAMED]: void 0, [PENDING_RANGE]: void 0, ...additive ? { style: additive } : {} });
       }
       return additive ? React5.cloneElement(el, { style: additive }) : /* @__PURE__ */ jsx6(Fragment3, { children: el });
     }
@@ -24495,13 +24532,29 @@ function withExtras(name, render) {
         next.role = roleWhenNamed;
       }
     }
-    if (iconGlyph2) {
-      next[ICON_GLYPH] = void 0;
+    const pendingRange = prev[PENDING_RANGE];
+    if (pendingRange != null) {
+      next[PENDING_RANGE] = void 0;
+      const finalRole = next.role ?? pass.role ?? prev.role;
+      if (typeof finalRole === "string" && RANGE_ROLES.has(finalRole) && typeof pendingRange === "object") Object.assign(next, pendingRange);
+    }
+    if (selfRenderedLeaf) {
+      next[SELF_RENDERED_LEAF] = void 0;
+      if (prev.role === "progressbar" && typeof pass.role === "string" && !RANGE_ROLES.has(pass.role)) {
+        next["aria-valuenow"] = void 0;
+        next["aria-valuemin"] = void 0;
+        next["aria-valuemax"] = void 0;
+        next["aria-valuetext"] = 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;
+        next["aria-valuenow"] = void 0;
+        next["aria-valuemin"] = void 0;
+        next["aria-valuemax"] = void 0;
+        next["aria-valuetext"] = void 0;
       }
     }
     const roleIsSynthetic = next[SYNTHETIC_TAP_ROLE] === true;
@@ -26006,7 +26059,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, SYNTHETIC_TAP_ROLE, SYNTHETIC_TABINDEX, INFERRED_DECORATIVE, ICON_GLYPH, ROLE_WHEN_NAMED, AUTHORED_ROLE, 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, RATING_METRICS, ratingMetrics, 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, initialFocusScheduled, initialFocusSeen, PRESENTED_SCOPE, presentedOpeners, presentedObserver, A11yHintDescription, 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, SYNTHETIC_TABINDEX, INFERRED_DECORATIVE, SELF_RENDERED_LEAF, ROLE_WHEN_NAMED, AUTHORED_ROLE, PENDING_RANGE, RANGE_ROLES, 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, RATING_METRICS, ratingMetrics, 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, initialFocusScheduled, initialFocusSeen, PRESENTED_SCOPE, presentedOpeners, presentedObserver, A11yHintDescription, WebRenderer;
 var init_renderNode = __esm({
   "../../core/web-renderer/src/renderNode.tsx"() {
     "use strict";
@@ -27570,9 +27623,11 @@ var init_renderNode = __esm({
     SYNTHETIC_TAP_ROLE = "data-hm-synthetic-role";
     SYNTHETIC_TABINDEX = "data-hm-synthetic-tabindex";
     INFERRED_DECORATIVE = "data-hm-inferred-decorative";
-    ICON_GLYPH = "data-hm-icon-glyph";
+    SELF_RENDERED_LEAF = "data-hm-self-rendered-leaf";
     ROLE_WHEN_NAMED = "data-hm-role-when-named";
     AUTHORED_ROLE = "data-hm-authored-role";
+    PENDING_RANGE = "data-hm-pending-range";
+    RANGE_ROLES = /* @__PURE__ */ new Set(["progressbar", "slider", "scrollbar", "spinbutton", "meter"]);
     INTERACTIVE_ROLES = /* @__PURE__ */ new Set([
       "button",
       "checkbox",
@@ -27754,7 +27809,11 @@ var init_renderNode = __esm({
         }
         return /* @__PURE__ */ jsx6("img", { src, alt: asText2(boundAlt), style: { width: w, height: boxHeight, aspectRatio: ar, objectFit, borderRadius: r, display: "block", flex: "none", background: ph, ...wrap } });
       }
-      if (imgInitials && typeof imgInitials === "string") return avatarCircle(String(imgInitials), typeof w === "number" ? w : 40, C, false, bodyFont(ctx));
+      if (imgInitials && typeof imgInitials === "string") {
+        const alt = asText2(boundAlt).trim();
+        const circle = avatarCircle(String(imgInitials), typeof w === "number" ? w : 40, C, false, bodyFont(ctx));
+        return React5.cloneElement(circle, alt ? { role: "img", "aria-label": alt, [SELF_RENDERED_LEAF]: true } : { [ROLE_WHEN_NAMED]: "img", [SELF_RENDERED_LEAF]: true });
+      }
       if (props.icon != null && props.url == null && props.asset == null && imgInitials == null) {
         const side2 = typeof w === "number" ? w : 40;
         return /* @__PURE__ */ jsx6("div", { style: { width: side2, height: side2, borderRadius: "50%", background: ph ?? C("surfaceTertiary", "#e6e6e6"), display: "grid", placeItems: "center", flex: "none", ...wrap }, children: iconSvg(props.icon, { size: Math.max(14, Math.round(side2 * 0.5)), color: C("accentPrimary", "#116DFF") }) });
@@ -27780,7 +27839,7 @@ var init_renderNode = __esm({
       const iconName = isBinding(props.name) ? String(bound ?? "") : props.name;
       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, [ROLE_WHEN_NAMED]: "img" };
+      const a11y = described ? { role: "img", "aria-label": String(contentDescription), [SELF_RENDERED_LEAF]: true } : { "aria-hidden": "true", [INFERRED_DECORATIVE]: true, [SELF_RENDERED_LEAF]: true, [ROLE_WHEN_NAMED]: "img" };
       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 }) => {
@@ -27906,7 +27965,19 @@ var init_renderNode = __esm({
       const numP = typeof rawP === "number" ? rawP : typeof rawP === "string" && rawP.trim() !== "" && Number.isFinite(Number(rawP)) ? Number(rawP) : void 0;
       const p = numP !== void 0 ? Math.max(0, Math.min(1, numP)) : props.indeterminate ? 0.4 : null;
       const animatedFill = props.animated === true && !ctx.reduceMotion();
-      return /* @__PURE__ */ jsx6("div", { style: { width: "100%", height: 6, borderRadius: 999, background: C(boundTokenName(props.trackColorPath, props.trackColor, ctx) ?? "surfaceTertiary", "#eee"), overflow: "hidden", ...wrap }, children: /* @__PURE__ */ jsx6("div", { style: { width: `${Math.round((p ?? 0.4) * 100)}%`, height: "100%", borderRadius: 999, background: C(boundTokenName(props.tintPath, props.tint, ctx) ?? "accentPrimary", "#116DFF"), opacity: p == null ? 0.45 : 1, ...animatedFill ? { transition: ctx.motionTransition(ctx.kit?.motion) } : {} } }) });
+      const a11y = {
+        role: "progressbar",
+        "aria-valuemin": 0,
+        "aria-valuemax": 100,
+        // `Number.isFinite`, not `!== undefined`: a worker's NaN (done/total, total 0) is a number
+        // too, and would be announced as aria-valuenow="NaN".
+        // A number wins over `indeterminate`, in the announcement as in the fill painted above:
+        // `indeterminate` is "DEPRECATED web-only; not read by the native decoders" (core.proto),
+        // so iOS and Android draw and speak the number.
+        ...numP !== void 0 && Number.isFinite(numP) && p != null ? { "aria-valuenow": Math.round(p * 100) } : {},
+        [SELF_RENDERED_LEAF]: true
+      };
+      return /* @__PURE__ */ jsx6("div", { ...a11y, style: { width: "100%", height: 6, borderRadius: 999, background: C(boundTokenName(props.trackColorPath, props.trackColor, ctx) ?? "surfaceTertiary", "#eee"), overflow: "hidden", ...wrap }, children: /* @__PURE__ */ jsx6("div", { style: { width: `${Math.round((p ?? 0.4) * 100)}%`, height: "100%", borderRadius: 999, background: C(boundTokenName(props.tintPath, props.tint, ctx) ?? "accentPrimary", "#116DFF"), opacity: p == null ? 0.45 : 1, ...animatedFill ? { transition: ctx.motionTransition(ctx.kit?.motion) } : {} } }) });
     });
     ActivityIndicatorNode = withExtras("ActivityIndicatorNode", ({ props, ctx, wrap }) => {
       const C = ctx.color;
@@ -27991,11 +28062,11 @@ var init_renderNode = __esm({
     GaugeRing = ({ ring, ctx, index, size, step, thick, track }) => {
       const bound = useResolvedScalar(ring?.valuePath, ctx);
       const rv = ring?.valuePath != null ? bound : ring?.value;
-      const rp = Math.max(0, Math.min(1, typeof rv === "number" ? rv : 0));
+      const rp = Math.max(0, Math.min(1, typeof rv === "number" && Number.isFinite(rv) ? rv : 0));
       const rt = ctx.color(ring?.tint ?? "accentPrimary", "#116DFF");
       const d = size - index * step, off = (size - d) / 2;
       const mask = `radial-gradient(farthest-side, transparent calc(100% - ${thick}px), #000 calc(100% - ${thick}px))`;
-      return /* @__PURE__ */ jsx6("div", { style: { position: "absolute", top: off, left: off, width: d, height: d, borderRadius: "50%", background: `conic-gradient(${rt} ${rp * 360}deg, ${track} 0deg)`, WebkitMask: mask, mask } });
+      return /* @__PURE__ */ jsx6("div", { "aria-hidden": "true", style: { position: "absolute", top: off, left: off, width: d, height: d, borderRadius: "50%", background: `conic-gradient(${rt} ${rp * 360}deg, ${track} 0deg)`, WebkitMask: mask, mask } });
     };
     GaugeNode = withExtras("GaugeNode", ({ props, ctx, wrap }) => {
       const C = ctx.color;
@@ -28007,19 +28078,25 @@ var init_renderNode = __esm({
       const tint = C(props.tint ?? "accentPrimary", "#116DFF");
       const track = C("surfaceTertiary", "#e3e6ea");
       const gaugeAnim = props.animated === true && !ctx.reduceMotion() ? { transition: ctx.motionTransition(ctx.kit?.motion) } : {};
+      const labelName = useBoundString(props.label, ctx).trim();
+      const hasValue = typeof gRaw === "number" && Number.isFinite(gRaw);
+      const named = labelName ? { "aria-label": labelName } : hasValue && max > min ? { "aria-label": `${Math.round(pct * 100)}%` } : {};
+      const fractionScale = min === 0 && max === 1;
+      const range = max > min ? { "aria-valuemin": min, "aria-valuemax": max, ...hasValue ? { "aria-valuenow": Math.max(min, Math.min(max, v)), ...fractionScale ? { "aria-valuetext": `${Math.round(pct * 100)}%` } : {} } : {} } : {};
+      const a11y = labelName || hasValue && max > min ? { role: "progressbar", ...named, ...range, [SELF_RENDERED_LEAF]: true } : { "aria-hidden": "true", [INFERRED_DECORATIVE]: true, [ROLE_WHEN_NAMED]: "progressbar", [PENDING_RANGE]: range, [SELF_RENDERED_LEAF]: true };
       if (Array.isArray(props.rings) && props.rings.length) {
         const size = 96, thick = 9, step = 22;
-        return /* @__PURE__ */ jsx6("div", { style: { position: "relative", width: size, height: size, ...wrap }, children: props.rings.map((r, i) => /* @__PURE__ */ jsx6(GaugeRing, { ring: r, ctx, index: i, size, step, thick, track }, i)) });
+        return /* @__PURE__ */ jsx6("div", { role: "group", ...named, ...{ [SELF_RENDERED_LEAF]: true }, style: { position: "relative", width: size, height: size, ...wrap }, children: props.rings.map((r, i) => /* @__PURE__ */ jsx6(GaugeRing, { ring: r, ctx, index: i, size, step, thick, track }, i)) });
       }
       if (props.kind === "linear") {
-        return /* @__PURE__ */ jsxs3("div", { style: { width: "100%", ...wrap }, children: [
+        return /* @__PURE__ */ jsxs3("div", { ...a11y, style: { width: "100%", ...wrap }, children: [
           props.label != null && /* @__PURE__ */ jsx6("div", { style: { fontFamily: bodyFont(ctx), fontSize: 13, color: C("textSecondary", "#636b78"), marginBottom: 4 }, children: txt(props.label, ctx) }),
           /* @__PURE__ */ jsx6("div", { style: { width: "100%", height: 8, borderRadius: 999, background: track, overflow: "hidden" }, children: /* @__PURE__ */ jsx6("div", { style: { width: `${pct * 100}%`, height: "100%", background: tint, ...gaugeAnim } }) })
         ] });
       }
       const ringMask = "radial-gradient(farthest-side, transparent calc(100% - 8px), #000 calc(100% - 8px))";
       const capF = ctx.font("caption");
-      return /* @__PURE__ */ jsx6("div", { style: { display: "inline-flex", flexDirection: "column", alignItems: "center", gap: 4, ...wrap }, children: /* @__PURE__ */ jsxs3("div", { style: { position: "relative", width: 72, height: 72 }, children: [
+      return /* @__PURE__ */ jsx6("div", { ...a11y, style: { display: "inline-flex", flexDirection: "column", alignItems: "center", gap: 4, ...wrap }, children: /* @__PURE__ */ jsxs3("div", { style: { position: "relative", width: 72, height: 72 }, children: [
         /* @__PURE__ */ jsx6("div", { style: { width: 72, height: 72, borderRadius: "50%", background: `conic-gradient(${tint} ${pct * 360}deg, ${track} 0deg)`, WebkitMask: ringMask, mask: ringMask, ...gaugeAnim } }),
         /* @__PURE__ */ jsx6("div", { style: { position: "absolute", inset: 0, display: "grid", placeItems: "center", fontFamily: fontStack(capF.family, ctx.idiom), fontSize: capF.remSize, fontWeight: capF.weight, color: C("textPrimary", "#13171e") }, children: txt(props.label, ctx) || `${Math.round(pct * 100)}%` })
       ] }) });
@@ -49498,21 +49575,21 @@ var init_preview_assets_generated = __esm({
   "../../packages/serve/src/preview-assets.generated.ts"() {
     init_preview_assets_format();
     PREVIEW_ASSET_MANIFEST = [
-      { key: "assets/index-VOdBPMHE.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 1048280, sha256: "7351282bf52e78ef541a7dabe577e46b46daafe19a730aaff590c027ab919818" },
-      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 1048288, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
-      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 1052898, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
-      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 1541482, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
-      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 1632406, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
-      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 1723390, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
-      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 1814370, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
-      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 1905242, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
-      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 1996222, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
-      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 2104858, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
-      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 2213942, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
-      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 2322990, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
-      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 2430690, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
-      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 2518798, length: 4947, sha256: "5bdaf36e319850247a522b19051ace779fb34d67f14211c3197761610d3a81e6" },
-      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 2523745, length: 17209, sha256: "dffc9718e2faa63ae2cc919e0a842f585ed565aaaa7c53778e90379442c731b6" }
+      { key: "assets/index-CGsR5F0F.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 1049558, sha256: "591c0803688d9807699f9ba9452bb09b73f05ffb51675e199287b6c8885cfeb7" },
+      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 1049566, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
+      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 1054176, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
+      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 1542760, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
+      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 1633684, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
+      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 1724668, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
+      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 1815648, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
+      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 1906520, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
+      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 1997500, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
+      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 2106136, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
+      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 2215220, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
+      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 2324268, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
+      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 2431968, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
+      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 2520076, length: 4947, sha256: "98dd4bdbeaa0bdbabf0f9df5b37a3408dec1e7e40d67dd39a89f64932c2c7a59" },
+      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 2525023, length: 17209, sha256: "dffc9718e2faa63ae2cc919e0a842f585ed565aaaa7c53778e90379442c731b6" }
     ];
   }
 });
@@ -61657,8 +61734,21 @@ function committedIdentity(root) {
     const records = raw === null ? null : committedRecords(raw);
     if (records !== null) return `base\0${base}\0${records}`;
   }
-  const tree = tryGit(["rev-parse", "HEAD^{tree}"], root)?.trim();
-  return tree ? `tree\0${tree}\0` : `commit\0${head}\0`;
+  const listing = tryGit(["ls-tree", "-rz", "--full-tree", "HEAD"], root);
+  const tree = listing === null ? null : treeRecords(listing);
+  return tree !== null ? `tree-listing\0${tree}` : `commit\0${head}\0`;
+}
+function treeRecords(listing) {
+  const records = [];
+  for (const record2 of listing.split("\0")) {
+    if (record2 === "") continue;
+    const tab = record2.indexOf("	");
+    if (tab <= 0 || tab === record2.length - 1) return null;
+    const path2 = record2.slice(tab + 1);
+    if (isValidationMetadata(path2)) continue;
+    records.push(`${Buffer.byteLength(path2)}:${path2}\0${record2.slice(0, tab)}\0`);
+  }
+  return records.sort().join("");
 }
 function treeEntries(output, index = false) {
   const entries = /* @__PURE__ */ new Map();
@@ -61689,14 +61779,15 @@ function blobOid(contents, algorithm) {
 }
 function validationDiffHash(cwd = process.cwd()) {
   const root = resolveRepoRoot(cwd);
-  const staged = git(["diff", "--cached", "--name-only", "--no-renames", "-z", "HEAD"], {
+  const born = tryGit(["rev-parse", "--verify", "--quiet", "HEAD^{commit}"], root) !== null;
+  const staged = git(["diff", "--cached", "--name-only", "--no-renames", "-z", ...born ? ["HEAD"] : []], {
     cwd: root
   }).split("\0").filter(Boolean);
   const unstaged = git(["diff", "--name-only", "--no-renames", "-z"], { cwd: root }).split("\0").filter(Boolean);
   const untracked = git(["ls-files", "--others", "--exclude-standard", "-z"], {
     cwd: root
   }).split("\0").filter(Boolean);
-  const headEntries = treeEntries(git(["ls-tree", "-rz", "--full-tree", "HEAD"], { cwd: root }));
+  const headEntries = born ? treeEntries(git(["ls-tree", "-rz", "--full-tree", "HEAD"], { cwd: root })) : /* @__PURE__ */ new Map();
   const indexEntries = treeEntries(git(["ls-files", "--stage", "-z"], { cwd: root }), true);
   const objectAlgorithm = git(["rev-parse", "--show-object-format"], { cwd: root }).trim();
   let trustFilesystemMode = true;
@@ -61955,10 +62046,13 @@ function selfHashFor(attestation) {
 }
 function repoRoot(contentDir2) {
   try {
-    return execFileSync2("git", ["-C", contentDir2, "rev-parse", "--show-toplevel"], {
+    const root = execFileSync2("git", ["-C", contentDir2, "rev-parse", "--show-toplevel"], {
       encoding: "utf8",
       stdio: ["ignore", "pipe", "ignore"]
     }).trim();
+    if (!root) return null;
+    execFileSync2("git", ["-C", root, "rev-parse", "--verify", "--quiet", "HEAD^{commit}"], { stdio: "ignore" });
+    return root;
   } catch {
     return null;
   }
@@ -65892,6 +65986,10 @@ function writePngFile(path2, base64) {
   writeFileSync28(path2, Buffer.from(base64, "base64"));
   return path2;
 }
+function keptPlan(kept) {
+  const note = keptPlanNote(kept);
+  return note ? { kept, note } : {};
+}
 async function initFromRemoteTemplate(name, parentDir, template, c) {
   const dir = resolve47(parentDir, name);
   if (existsSync61(join58(dir, "himalaya.content.json"))) {
@@ -66737,7 +66835,7 @@ himi v${cliVersion()} \u2014 run \`himi --version\`. If authoring commands fail
           try {
             const res2 = await initFromRemoteTemplate(name, parentDir, template, client2());
             const pushSetup2 = await offerPushSetup2({ contentDir: res2.dir, flags, io });
-            print({ ok: true, app: name, dir: res2.dir, template, source: "remote", files: res2.files, pushSetup: pushSetup2 });
+            print({ ok: true, app: name, dir: res2.dir, template, source: "remote", files: res2.files, ...keptPlan(res2.kept), pushSetup: pushSetup2 });
             return 0;
           } catch (e) {
             if (!availableTemplates().includes(template)) {
@@ -66749,7 +66847,7 @@ himi v${cliVersion()} \u2014 run \`himi --version\`. If authoring commands fail
         }
         const res = scaffoldContentPackage(name, parentDir, template);
         const pushSetup = await offerPushSetup2({ contentDir: res.dir, flags, io });
-        print({ ok: true, app: name, dir: res.dir, ...template ? { template, source: "embedded" } : {}, files: res.files, pushSetup });
+        print({ ok: true, app: name, dir: res.dir, ...template ? { template, source: "embedded" } : {}, files: res.files, ...keptPlan(res.kept), pushSetup });
         return 0;
       }
       case "template": {

package/guides/mobile-ux.md

@@ -199,8 +199,9 @@ tried in this order:
   `--width`/`--device` records nothing on purpose: without one the PNG viewport is the headless
   browser's desktop default, and writing that down would manufacture the very expanded render the
   marker exists to prove. Recording never fails or slows a render — if the file cannot be written
-  the render still succeeds, and the paths below still apply. `.himi/` is gitignored, so this is
-  evidence about your checkout rather than something a pull request carries.
+  the render still succeeds, and the paths below still apply. `.himi/` is gitignored (`himi init`
+  writes that rule into the package's `.gitignore`; add it yourself to a package made another way),
+  so this is evidence about your checkout rather than something a pull request carries.
 
 - Or name two pixel widths in the document, spanning compact → wider,
   **each spelled as a width on itself**, within about 400 characters of each other so they read as

package/guides/qa-builds.md

@@ -958,10 +958,12 @@ Two details that are easy to get wrong, both verified against a real baked seed
 
 Known edges, stated rather than implied: `seed-data.json` (entity snapshots) is **not** release
 content — it comes from the app's source module, so the pool copies it when the checkout has the
-app and otherwise ships `{}`, and those screens show empty states until the first sync. The icon
-and widget snapshots are single-slot per app with no release id, so a pinned release gets whatever
-is live; the envelope hashes the live bytes against the manifest's `iconHash`/per-widget
-`contentEtag` and **warns** on drift while still baking the live asset.
+app and otherwise ships `{}`, and those screens show empty states until the first sync. The widget
+snapshots are single-slot per app with no release id, so a pinned release gets whatever is live;
+the icon is too, but only for an older release published before releases kept their own icon —
+every later one, draft included, bakes its own content-addressed copy. On that live-slot path the envelope hashes the live bytes
+against the manifest's `iconHash`/per-widget `contentEtag` and **warns** on drift while still
+baking the live asset.
 
 ## The install link
 
@@ -999,11 +1001,16 @@ is live; the envelope hashes the live bytes against the manifest's `iconHash`/pe
   `identity.appName`, `native.androidApplicationId`, `native.urlScheme` and `native.appLinkHost`
   with unchecked `as String`, so a missing one fails during configure with no mention of branding —
   a test pins that the projection always emits all four.
-- **No icon in the release?** `/v1/dist/contract` projects a published release and `putIcon` is
-  live-only single-slot, so a **draft** release (what `--release` usually points at) has no icon and
-  the served contract's `appIconPath` is empty — which `prepare:customer` rejects on purpose. The
-  pool fills it from the shell's own committed `provisioning.json`, so the build degrades to the
-  shell's artwork instead of failing over branding.
+- **Which icon does the build get?** The pinned release's **own**, draft or live. Publish keeps a
+  content-addressed copy of the launcher icon under the release's `iconHash`, and both
+  `/v1/dist/contract` and `/v1/dist/seed` read that copy first — so a QA build of an approved
+  **draft** carries the customer's icon without promoting anything live. Only an older release,
+  published before that copy existed, falls back to the app's single live icon slot (`putIcon`), and
+  the seed then warns if the live icon is not the one the release recorded.
+- **No icon at all?** When neither the release nor the live slot has one, the served contract's
+  `appIconPath` is empty — which `prepare:customer` rejects on purpose. The pool fills it from the
+  shell's own committed `provisioning.json`, so the build degrades to the shell's artwork instead
+  of failing over branding.
 
 ## Where the baked seed comes from
 
@@ -1034,10 +1041,12 @@ Two honest edges:
   never served over OTA — it is a build-time input from the app's own source module. The pool copies
   it when this checkout happens to have the app, else ships `{}` and those screens show empty states
   until the first sync.
-- **The icon and widget snapshots are single-slot per app** (`put/getIcon`, `put/getWidget`) with no
-  release id, so a pinned release cannot read "its own" copy — it gets whatever is live. The
-  endpoint hashes the live bytes against the manifest's `iconHash` / per-widget `contentEtag` and
-  **warns** when they differ; the build still bakes the live asset, but the drift is in the log.
+- **The widget snapshots are single-slot per app** (`put/getWidget`) with no release id, so a
+  pinned release cannot read "its own" copy — it gets whatever is live. The icon reads the
+  release's own content-addressed copy (under `iconHash`) first and falls back to the single live
+  slot (`put/getIcon`) only for an older release published before that copy existed. On a live-slot read the endpoint
+  hashes the bytes against the manifest's `iconHash` / per-widget `contentEtag` and **warns** when
+  they differ; the build still bakes the live asset, but the drift is in the log.
 
 Source-built seeding remains the fallback for the Falcon `[dist]` path, which has no job token and
 therefore no seed endpoint to call.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1031.0",
+  "version": "0.1032.0",
   "type": "module",
   "description": "himi — the Himalaya authoring CLI. Build a Tier-5 content package on your own machine, push it to the production serve as a draft, preview it on web + Himi Player, and read worker logs back — the remote dev loop. Wraps @himalaya/serve-cli for transport.",
   "keywords": [
@@ -65,5 +65,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "b2432c45ff8926fa8325d6f05d7cfaddf683708c33a4537c34b9fa45"
+  "falconPackageHash": "5af127baf2b3845fd3e463154eecf88bb68a58849427ab3778d5627a"
 }

package/templates/surface-showcase/dev/index.ts

@@ -579,7 +579,7 @@ const SCREENS = runtimeSetting({
                 "package": "himalaya",
                 "type": "Gauge",
                 "props": {
-                  "value": 68,
+                  "value": 0.68,
                   "label": "Goal"
                 }
               }