@wix/himalaya-cli 0.1308.0 → 0.1309.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (93) hide show
  1. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/dev-server/src/builder.d.ts +7 -0
  2. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/schema.d.ts +32 -0
  3. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/validator.d.ts +60 -0
  4. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/core.mjs +31 -0
  5. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/sdui.mjs +31 -0
  6. package/dist/cli.mjs +1305 -864
  7. package/dist/preview-assets.generated.bin +0 -0
  8. package/guides/app-config.md +2 -2
  9. package/guides/component-reference.json +2 -2
  10. package/guides/component-reference.md +10 -0
  11. package/guides/getting-started.md +40 -0
  12. package/guides/himi-skill.md +40 -0
  13. package/package.json +3 -2
  14. package/templates/beauty-salon/himalaya.content.json +86 -0
  15. package/templates/beauty-salon-owner/dev/index.ts +574 -181
  16. package/templates/beauty-salon-owner/himalaya.content.json +179 -0
  17. package/templates/beauty-salon-owner/tier5-src/_shared/aria-chat.ts +136 -12
  18. package/templates/beauty-salon-owner/tier5-src/_shared/aria-client-tools.ts +57 -9
  19. package/templates/beauty-salon-owner/tier5-src/_shared/aria-row-id.ts +14 -0
  20. package/templates/beauty-salon-owner/tier5-src/himi-owner-lite-aria/index.ts +3 -0
  21. package/templates/branded-lite/himalaya.content.json +254 -0
  22. package/templates/brandy/himalaya.content.json +18 -1
  23. package/templates/community-club/himalaya.content.json +68 -0
  24. package/templates/community-club-owner/dev/index.ts +574 -181
  25. package/templates/community-club-owner/himalaya.content.json +173 -0
  26. package/templates/community-club-owner/tier5-src/_shared/aria-chat.ts +136 -12
  27. package/templates/community-club-owner/tier5-src/_shared/aria-client-tools.ts +57 -9
  28. package/templates/community-club-owner/tier5-src/_shared/aria-row-id.ts +14 -0
  29. package/templates/community-club-owner/tier5-src/himi-owner-lite-aria/index.ts +3 -0
  30. package/templates/events-meetups/himalaya.content.json +62 -0
  31. package/templates/events-meetups-owner/dev/index.ts +574 -181
  32. package/templates/events-meetups-owner/himalaya.content.json +155 -0
  33. package/templates/events-meetups-owner/tier5-src/_shared/aria-chat.ts +136 -12
  34. package/templates/events-meetups-owner/tier5-src/_shared/aria-client-tools.ts +57 -9
  35. package/templates/events-meetups-owner/tier5-src/_shared/aria-row-id.ts +14 -0
  36. package/templates/events-meetups-owner/tier5-src/himi-owner-lite-aria/index.ts +3 -0
  37. package/templates/gym-fitness/himalaya.content.json +101 -0
  38. package/templates/gym-fitness-owner/dev/index.ts +574 -181
  39. package/templates/gym-fitness-owner/himalaya.content.json +188 -0
  40. package/templates/gym-fitness-owner/tier5-src/_shared/aria-chat.ts +136 -12
  41. package/templates/gym-fitness-owner/tier5-src/_shared/aria-client-tools.ts +57 -9
  42. package/templates/gym-fitness-owner/tier5-src/_shared/aria-row-id.ts +14 -0
  43. package/templates/gym-fitness-owner/tier5-src/himi-owner-lite-aria/index.ts +3 -0
  44. package/templates/himi-chat/himalaya.content.json +8 -0
  45. package/templates/nonprofit-cause/himalaya.content.json +74 -0
  46. package/templates/nonprofit-cause-owner/dev/index.ts +574 -181
  47. package/templates/nonprofit-cause-owner/himalaya.content.json +170 -0
  48. package/templates/nonprofit-cause-owner/tier5-src/_shared/aria-chat.ts +136 -12
  49. package/templates/nonprofit-cause-owner/tier5-src/_shared/aria-client-tools.ts +57 -9
  50. package/templates/nonprofit-cause-owner/tier5-src/_shared/aria-row-id.ts +14 -0
  51. package/templates/nonprofit-cause-owner/tier5-src/himi-owner-lite-aria/index.ts +3 -0
  52. package/templates/owner-lite/dev/index.ts +574 -181
  53. package/templates/owner-lite/himalaya.content.json +203 -0
  54. package/templates/owner-lite/tier5-src/_shared/aria-chat.ts +136 -12
  55. package/templates/owner-lite/tier5-src/_shared/aria-client-tools.ts +57 -9
  56. package/templates/owner-lite/tier5-src/_shared/aria-row-id.ts +14 -0
  57. package/templates/owner-lite/tier5-src/himi-owner-lite-aria/index.ts +3 -0
  58. package/templates/podcast-creator/himalaya.content.json +71 -0
  59. package/templates/podcast-creator-owner/dev/index.ts +574 -181
  60. package/templates/podcast-creator-owner/himalaya.content.json +173 -0
  61. package/templates/podcast-creator-owner/tier5-src/_shared/aria-chat.ts +136 -12
  62. package/templates/podcast-creator-owner/tier5-src/_shared/aria-client-tools.ts +57 -9
  63. package/templates/podcast-creator-owner/tier5-src/_shared/aria-row-id.ts +14 -0
  64. package/templates/podcast-creator-owner/tier5-src/himi-owner-lite-aria/index.ts +3 -0
  65. package/templates/portfolio-creative/himalaya.content.json +80 -0
  66. package/templates/portfolio-creative-owner/dev/index.ts +574 -181
  67. package/templates/portfolio-creative-owner/himalaya.content.json +179 -0
  68. package/templates/portfolio-creative-owner/tier5-src/_shared/aria-chat.ts +136 -12
  69. package/templates/portfolio-creative-owner/tier5-src/_shared/aria-client-tools.ts +57 -9
  70. package/templates/portfolio-creative-owner/tier5-src/_shared/aria-row-id.ts +14 -0
  71. package/templates/portfolio-creative-owner/tier5-src/himi-owner-lite-aria/index.ts +3 -0
  72. package/templates/restaurant/himalaya.content.json +65 -0
  73. package/templates/restaurant-owner/dev/index.ts +574 -181
  74. package/templates/restaurant-owner/himalaya.content.json +188 -0
  75. package/templates/restaurant-owner/tier5-src/_shared/aria-chat.ts +136 -12
  76. package/templates/restaurant-owner/tier5-src/_shared/aria-client-tools.ts +57 -9
  77. package/templates/restaurant-owner/tier5-src/_shared/aria-row-id.ts +14 -0
  78. package/templates/restaurant-owner/tier5-src/himi-owner-lite-aria/index.ts +3 -0
  79. package/templates/retail-store/himalaya.content.json +62 -0
  80. package/templates/retail-store-owner/dev/index.ts +574 -181
  81. package/templates/retail-store-owner/himalaya.content.json +164 -0
  82. package/templates/retail-store-owner/tier5-src/_shared/aria-chat.ts +136 -12
  83. package/templates/retail-store-owner/tier5-src/_shared/aria-client-tools.ts +57 -9
  84. package/templates/retail-store-owner/tier5-src/_shared/aria-row-id.ts +14 -0
  85. package/templates/retail-store-owner/tier5-src/himi-owner-lite-aria/index.ts +3 -0
  86. package/templates/surface-showcase/himalaya.content.json +11 -0
  87. package/templates/yoga-studio/himalaya.content.json +80 -0
  88. package/templates/yoga-studio-owner/dev/index.ts +574 -181
  89. package/templates/yoga-studio-owner/himalaya.content.json +170 -0
  90. package/templates/yoga-studio-owner/tier5-src/_shared/aria-chat.ts +136 -12
  91. package/templates/yoga-studio-owner/tier5-src/_shared/aria-client-tools.ts +57 -9
  92. package/templates/yoga-studio-owner/tier5-src/_shared/aria-row-id.ts +14 -0
  93. package/templates/yoga-studio-owner/tier5-src/himi-owner-lite-aria/index.ts +3 -0
Binary file
@@ -2,8 +2,8 @@
2
2
 
3
3
  A content package configures itself in three layers:
4
4
 
5
- 1. **`himalaya.content.json`** — the package manifest. Only `name` is consumed today (it
6
- overrides the directory name as the app id); `himi init` writes `{ "name", "target": "prod" }`.
5
+ 1. **`himalaya.content.json`** — the package manifest. `name` overrides the directory
6
+ name as the app id. `screens` declares optional `displayName` and `viewId` fields per stable screen ID. An absent viewId means the screen’s own ID. Templates persist these names; AppSmith supplies them for blank scaffolds. Keep them current when adding or removing screens. This never changes descriptor titles.
7
7
  2. **`config.ts`** — `export default defineApp({ … })`, your app's `AppConfig`.
8
8
  3. **`dev/index.ts`** — the `AppDevModule` (screens + seed + `homeScreenId`). Its
9
9
  `screens` is `{ exact, templated? }`: `exact` maps each fixed screenId to a builder
@@ -1387,10 +1387,10 @@
1387
1387
  }
1388
1388
  ],
1389
1389
  "descriptor": {
1390
- "ScreenDescriptor": "export interface ScreenDescriptor {\n screenId: string;\n renderer: RendererKind;\n title?: string;\n /** Present when `renderer` is `sdui_intent` or `sdui_layout`. */\n payload?: Component;\n /** A component pinned ABOVE the scrolling payload (sticky tab-header / toolbar).\n * Rendered by the host outside the screen scroll, so it stays put as content\n * scrolls. Optional; absent = no sticky header. */\n stickyHeader?: Component;\n /** A component pinned BELOW the scrolling payload (sticky footer — price/confirm\n * bar, peeking bottom-sheet). Rendered outside the screen scroll by the host. */\n stickyFooter?: Component;\n /** When true, the host wraps the screen in a scroll that starts pinned to the\n * bottom and shows a floating \"jump to latest\" button whenever the user scrolls\n * up (a chat transcript). Tapping it animates back to the bottom. Absent/false =\n * a normal top-anchored scroll. Honored by the app host (Router). */\n scrollToBottom?: boolean;\n /** Present when `renderer` is `webview_native_bridge` or `webview_ds`. */\n url?: string;\n capabilitiesRequired?: string[];\n schemaVersion: number;\n togglesApplied?: string[];\n /** Per-session flag/experiment assignments baked in for this request. */\n assignments?: import(\"./flags.js\").Assignment[];\n /** Per-screen top bar (trailing actions +\n * leading/style override). Fully replaces `NavigationConfig.topBarDefault`. */\n topBar?: TopBarConfig;\n etag?: string;\n cacheControl?: CacheControl;\n telemetryScreenName?: string;\n bundleSri?: string;\n manifestVersion?: number;\n /**\n * Present on Tier-5 screens. The presence of this field is the tier-5\n * signal — there is no separate `tier: 5` flag.\n */\n logicBundle?: LogicBundleRef;\n /**\n * Static per-screen input injected as `globalThis.himalaya.input` before the\n * Tier-5 worker bundle evaluates — the worker reads it synchronously in `load()`\n * (e.g. `himalaya.input.id` for a detail screen, or a baked catalog like\n * `himalaya.input.cmsCollections`).\n *\n * A push merges its navigation parameters into this object on web, iOS, and Android.\n * For example, `himi.open({ screenId: \"event\", id: \"$item.id\" })` makes the id\n * available as `himalaya.input.id` in the pushed worker; static `input` remains the\n * fallback for values baked into a descriptor or a templated route. The host also\n * supplies `screenId`. See docs/tier-5-add-a-screen.md → \"Navigate to a detail screen\".\n *\n * Arbitrary JSON object; consumed by the web host (ScreenController) and the\n * native JSWorker.\n */\n input?: Record<string, unknown>;\n /**\n * Tier 3 / Tier 4 — behavior of the hosted WebView. Ignored by SDUI tiers.\n * Authored in the descriptor builder (git); served OTA verbatim.\n */\n webViewConfig?: WebViewConfig;\n}",
1390
+ "ScreenDescriptor": "export interface ScreenDescriptor {\n screenId: string;\n renderer: RendererKind;\n title?: string;\n /** Present when `renderer` is `sdui_intent` or `sdui_layout`. */\n payload?: Component;\n /** A component pinned ABOVE the scrolling payload (sticky tab-header / toolbar).\n * Rendered by the host outside the screen scroll, so it stays put as content\n * scrolls. Optional; absent = no sticky header. */\n stickyHeader?: Component;\n /** A component pinned BELOW the scrolling payload (sticky footer — price/confirm\n * bar, peeking bottom-sheet). Rendered outside the screen scroll by the host. */\n stickyFooter?: Component;\n /** When true, the host wraps the screen in a scroll that starts pinned to the\n * bottom and shows a floating \"jump to latest\" button whenever the user scrolls\n * up (a chat transcript). Tapping it animates back to the bottom. Absent/false =\n * a normal top-anchored scroll. Honored by the app host (Router). */\n scrollToBottom?: boolean;\n /** The chat transcript scroll policy. On a send the host pins the\n * named component near the top and reserves the space the reply grows into;\n * when the reply outgrows it the host follows the tail. A drag pauses\n * following, and only then is a jump-to-latest control shown. */\n transcriptScroll?: TranscriptScroll;\n /** Present when `renderer` is `webview_native_bridge` or `webview_ds`. */\n url?: string;\n capabilitiesRequired?: string[];\n schemaVersion: number;\n togglesApplied?: string[];\n /** Per-session flag/experiment assignments baked in for this request. */\n assignments?: import(\"./flags.js\").Assignment[];\n /** Per-screen top bar (trailing actions +\n * leading/style override). Fully replaces `NavigationConfig.topBarDefault`. */\n topBar?: TopBarConfig;\n etag?: string;\n cacheControl?: CacheControl;\n telemetryScreenName?: string;\n bundleSri?: string;\n manifestVersion?: number;\n /**\n * Present on Tier-5 screens. The presence of this field is the tier-5\n * signal — there is no separate `tier: 5` flag.\n */\n logicBundle?: LogicBundleRef;\n /**\n * Static per-screen input injected as `globalThis.himalaya.input` before the\n * Tier-5 worker bundle evaluates — the worker reads it synchronously in `load()`\n * (e.g. `himalaya.input.id` for a detail screen, or a baked catalog like\n * `himalaya.input.cmsCollections`).\n *\n * A push merges its navigation parameters into this object on web, iOS, and Android.\n * For example, `himi.open({ screenId: \"event\", id: \"$item.id\" })` makes the id\n * available as `himalaya.input.id` in the pushed worker; static `input` remains the\n * fallback for values baked into a descriptor or a templated route. The host also\n * supplies `screenId`. See docs/tier-5-add-a-screen.md → \"Navigate to a detail screen\".\n *\n * Arbitrary JSON object; consumed by the web host (ScreenController) and the\n * native JSWorker.\n */\n input?: Record<string, unknown>;\n /**\n * Tier 3 / Tier 4 — behavior of the hosted WebView. Ignored by SDUI tiers.\n * Authored in the descriptor builder (git); served OTA verbatim.\n */\n webViewConfig?: WebViewConfig;\n}",
1391
1391
  "Component": "export interface Component {\n id: string;\n body: ComponentBody;\n modifiers?: Modifiers;\n minVersion?: number;\n}",
1392
1392
  "LogicBundleRef": "export interface LogicBundleRef {\n url: string;\n /** \"sha256-...\" SRI string. */\n integrity: string;\n contentType?: string;\n /** SDK capability ids the bundle is permitted to import / invoke. */\n declaredCapabilities: string[];\n /** Bundle refuses to load on a binary older than this (semver). */\n minBinaryVersion?: string;\n /** Bundle's own semver. */\n bundleVersion?: string;\n /** Base64 detached publisher signature over the bundle bytes\n * (authenticity beyond SRI). Verified by a host-injected verifier when present;\n * unsigned bundles load as today. */\n signature?: string;\n /** The publisher key id a host pins, paired with `signature`. */\n keyId?: string;\n /** Ambient refresh (gap G2): the host invokes `action` (a `tier5.<svc>.<action>`\n * path) every `intervalMs` while the screen is visible — workers have no timer\n * of their own, so the host owns the cadence. */\n refresh?: { intervalMs: number; action: string };\n}",
1393
- "Modifiers": "export interface Modifiers {\n padding?: EdgeInsets;\n background?: TokenRef;\n cornerRadius?: number;\n /** Fixed intrinsic width (pt/dp/px). Honored by iOS (`FrameIfPresent`), Android\n * (frame) and web (`modifiers.ts`). With no `ScrollView` in the vocabulary and\n * regions clipped at `maxHeight`, `width`/`height`/`fillMaxWidth` are the main\n * sizing tools for embed/host content. */\n width?: number;\n /** Fixed intrinsic height (pt/dp/px). See `width`. */\n height?: number;\n /** Fill the available cross-axis width (keeps any fixed `height`). Mirrors\n * Compose `fillMaxWidth` / SwiftUI `.frame(maxWidth: .infinity)`. See `width`. */\n fillMaxWidth?: boolean;\n /** CAP the node's laid-out width at this many points. It CONSTRAINS, it\n * does not SET: a node narrower than the cap keeps its intrinsic width, so a\n * short chat bubble stays short while a long one stops at the cap — the\n * asymmetry `width` cannot express and `weight` cannot either (weights divide\n * the *available* space, so every child lands on the same fraction).\n * The cap covers the node's TOTAL width, padding + border included (CSS\n * `max-width` under `box-sizing: border-box`). `fillMaxWidth` grabs the axis but\n * THE CAP WINS — fill + cap is exactly `maxWidth` wide; a literal `width` larger\n * than the cap is clamped to it too. POINTS, not a fraction: a modifier is\n * resolved with no portable notion of \"the row\" on any renderer — compose a\n * percentage from a weighted sibling gap instead. `0`/absent = no cap. */\n maxWidth?: number;\n /** Flex weight along the parent stack's MAIN axis (HStack = width, VStack =\n * height). The stack measures its intrinsic (unweighted) children first, then\n * divides what is LEFT among the weighted ones in proportion to their weights:\n * two children at `1` split the leftover equally, `2` and `1` split it 2:1.\n * Absent (or <= 0) keeps the node at its intrinsic size. Use this — not\n * `fillMaxWidth` — when a node should claim the remaining space *beside* its\n * siblings; a full-bleed fill grabs the whole axis and starves them. Ignored\n * outside an HStack/VStack.\n * CAVEAT — row-sharing controls have NO intrinsic width to measure first: in an\n * HStack a `Button` and a `Toggle` are implicitly weighted, so they DIVIDE the\n * row with your weighted child instead of taking a width ahead of it —\n * `[VStack(weight:1), Button, Button]` is a three-way split, not \"the VStack gets\n * the remainder\". To opt a Button out on EVERY renderer set `fullWidth: false`\n * (an explicit flag wins in both directions; absent falls back to the style\n * default, which is \"share\" for every style but `tertiary`/`link`), or use\n * `iconOnly`. Otherwise give the actions their own row.\n * See `himi docs designing-himi-screens` §4. */\n weight?: number;\n /** RTL — pin the subtree's writing direction: `\"ltr\"` | `\"rtl\"` | `\"locale\"`\n * (inherit). The common RTL pattern is the inverse of `Text.textDirection`: pin a\n * container `ltr` (a logotype, an attachment-tile row, a composer button row)\n * inside an otherwise-RTL screen. Absent = inherit the ambient direction. #1060. */\n layoutDirection?: \"ltr\" | \"rtl\" | \"locale\";\n /** Absolute visual translation (pt/dp/px). Applied as the OUTERMOST transform so\n * it shifts the fully-styled node WITHOUT changing its layout footprint — lets a\n * ZStack place polar/absolute children (e.g. AgentOrbit). Negative allowed. */\n offsetX?: number;\n offsetY?: number;\n onTap?: Action;\n /** Double-tap gesture (e.g. Instagram double-tap-to-like). Distinct from onTap. */\n onDoubleTap?: Action;\n accessibilityLabel?: string;\n hidden?: boolean;\n /** Data-bound conditional visibility: a `\"$service:<svc>.<field>\"`\n * or `\"$item.<field>\"` sentinel resolving to a bool at render; when true the\n * subtree fully COLLAPSES (zero layout, like `hidden`), overriding the\n * literal `hidden`. */\n hiddenPath?: string;\n /** Long-press gesture modifier. */\n onLongPress?: Action;\n /** Fires once when the component first appears on screen. */\n onAppear?: Action;\n /** Scoped token overrides for the subtree. */\n theme?: ThemeOverrides;\n /** Names a token from the app's `shadows` registry. */\n shadow?: TokenRef;\n /** Names a token from the app's `gradients` registry (background fill). */\n backgroundGradient?: TokenRef;\n /** Value-driven gradient: a `$service:`/`$item.` path resolving to a gradient\n * TOKEN NAME used as the live background (e.g. weather sky day→night). */\n backgroundGradientPath?: string;\n /** Value-driven background COLOR: a `$service:`/`$item.` path resolving to a\n * color TOKEN NAME used as the live background. Honored on iOS + Android\n * (`BoundBackgroundIfPresent`); web render support is tracked in #1057. */\n backgroundColorPath?: string;\n /** Value-driven background IMAGE: a `$service:`/`$item.` path resolving to an\n * image URL used as the live background. Honored on iOS + Android; web render\n * support is tracked in #1057. */\n backgroundImagePath?: string;\n /** #1051 — MEASURE (publish): report this node's laid-out size into the renderer's\n * self-contained (worker-free) measure store under the named keys, so a SIBLING can\n * feed the number back into its own layout via a `$measure:<key>` binding. The SDUI\n * equivalent of SwiftUI `.onGeometryChange` / Compose `onGloballyPositioned`; the\n * canonical use is a pinned bottom bar whose measured height becomes a scroll view's\n * bottom inset (sticky-footer + scroll-inset, unrepresentable before — #1051). */\n onMeasure?: Measure;\n /** #1051 — bound height: a `\"$measure:<key>\"` (measure store) or\n * `\"$service:<svc>.<field>\"` / `\"$item.<field>\"` (worker/row state) sentinel resolving\n * to a NUMBER at render. Wins over the literal `height`. String path only, so a\n * binding can never blank the node (never overload the numeric `height`). */\n heightPath?: string;\n /** #1051 — bound width. See `heightPath`. Wins over the literal `width`. */\n widthPath?: string;\n /** #1051 — bound TOP inset (the header-height → top-inset idiom). A `$measure:`/\n * `$service:`/`$item.` sentinel resolving to a number; added as top padding. */\n paddingTopPath?: string;\n /** #1051 — bound BOTTOM inset (the sticky-footer-height → bottom-inset idiom). A\n * `$measure:`/`$service:`/`$item.` sentinel resolving to a number; added as bottom\n * padding so the last scroll row clears a pinned bottom bar. */\n paddingBottomPath?: string;\n /** #1053 — INLINE gradient background paint. Distinct from `backgroundGradient`\n * (which names a `gradients` registry token an embed host can't register): this\n * carries its stops/colours in the descriptor, so it works anywhere. Painted as\n * a surface (behind children), below `material`/`backgroundGradient` if those are\n * also set. */\n gradient?: Gradient;\n /** #1053 — gradient ALPHA MASK: the node shows through where the gradient is\n * opaque and fades where it's transparent (a transparent-token stop = fully\n * clear). The material-under-gradient-scrim / scroll-fade-out idiom. Mirrors iOS\n * `.mask()`, Android `BlendMode.DstIn`, web `mask-image`. */\n mask?: Gradient;\n /** Inline border/stroke. */\n border?: Border;\n /** Subtree alpha 0.0–1.0; absent = opaque. */\n opacity?: number;\n /** #433 — constrain the subtree to a width:height ratio (e.g. `1` = square,\n * `1.777` = 16:9). Width-driven: the height derives from the resolved width.\n * Lets a data-bound Grid cell / photo tile hold its shape at any width. */\n aspectRatio?: number;\n /** Names a token from the app's `motions` registry; the subtree\n * fades + slides up on first appearance. */\n appear?: TokenRef;\n /** Surface material token (flat/glass/frosted). */\n material?: TokenRef;\n /** Per-node construction-language override. */\n variant?: string;\n /** Per-node density / motion override. */\n density?: string;\n motion?: string;\n /** Motion grammar (Batch 1) — press/tap feedback style\n * (auto|none|scale|highlight|scaleHighlight|lift); timing comes from `motion`.\n * Applied only when the node is interactive. Unknown degrades to `auto`. */\n pressFeedback?: string;\n /** Motion grammar (Batch 1) — press-coupled haptic\n * (none|selection|light|medium|heavy|success|warning|error); fires with onTap.\n * Default none (opt-in). Web is a no-op. */\n haptic?: string;\n /** Motion grammar (Batch 1) — animate this container's size changes instead of\n * snapping (iOS `.animation(value:)`, Android `animateContentSize`, web height\n * transition). Curve from the active `motion` personality. */\n animateContentSize?: boolean;\n /** Motion grammar (Batch 1) — enter/exit transition; supersedes `appear` when\n * both are present. */\n transition?: Transition;\n /** Motion grammar (Batch 2, scroll-driven) — defer the `transition` enter until\n * the node first crosses into the scroll viewport (reveal-on-scroll). Gated by\n * reduced motion (shown immediately when reduced). */\n revealOnScroll?: boolean;\n /** Motion grammar (Batch 2, scroll-driven) — parallax factor: the node drifts\n * vertically at this fraction of the scroll delta as it moves through the\n * viewport. Gated by reduced motion. Generalizes CollapsingHeader parallaxFactor. */\n parallax?: number;\n /** Motion grammar (Batch 4, rich visual) — when a backgroundGradient is present,\n * continuously drift/rotate it (animated gradient). Gated by reduced motion. */\n animatedGradient?: boolean;\n /** Motion grammar (Batch 3, hero/nav) — shared-element key: a matching\n * transitionId on the source + destination screen morphs that element across\n * navigation (web View Transitions / iOS matchedTransitionSource / Android\n * SharedTransitionLayout). Gated by reduced motion. */\n transitionId?: string;\n /** Motion grammar (Batch 4, rich visual) — render the backgroundGradient as a\n * mesh (overlapping multi-point blend) rather than a linear sweep; combine with\n * animatedGradient to drift it. */\n meshGradient?: boolean;\n /** Motion grammar (Batch 4, celebration) — burst a one-shot confetti overlay\n * within the node on appear. Gated by reduced motion. */\n confetti?: boolean;\n /** Motion grammar (Batch 2, scroll-driven) — pin this node to the top of its\n * scroll container (sticky section header). Functional positioning; not gated\n * by reduced motion. */\n sticky?: boolean;\n /** Motion grammar (Batch 2, scroll-driven) — turn this thin node into a\n * reading-progress bar that fills left→right with scroll (scaleX). web reads\n * window scroll; native reads the host scroll fraction. Functional. */\n scrollProgress?: boolean;\n /** Motion grammar (Batch 4, rich vector) — a named built-in vector animation\n * (\"loader\" | \"success\" | \"pulse\"), dependency-free. Gated by reduced motion.\n * Arbitrary Lottie/Rive JSON is the lib-backed superset follow-up. */\n vectorAnim?: string;\n /** Motion grammar (Batch 1, choreography) — delay this node's ENTER transition\n * by N ms so a screen can SEQUENCE its entrance beyond list stagger (\"title\n * fades, subtitle slides in 100ms later\"). Adds to any list `staggerMs`. Gated\n * by reduced motion. 0/absent = no extra delay. */\n enterDelayMs?: number;\n /** Motion grammar (Phase-3, per-node MotionSpec) — overrides the PRESS-feedback\n * curve with a `motions`-registry token, mirroring `Transition.motion` for the\n * enter curve. Absent → press uses the global `motion` personality. */\n pressMotion?: TokenRef;\n /** Motion grammar (Phase-3, gesture-driven) — finger-tracked drag-to-dismiss; past\n * threshold along `direction` it animates off and fires `action`, else springs back. */\n swipeDismiss?: SwipeDismiss;\n /** Motion grammar (Phase-4, reduced-motion) — per-node escape from the reduced-motion\n * gate. Default true (respect). false = \"must move anyway\" (transition/press animate\n * even when reduced motion is on). */\n respectReducedMotion?: boolean;\n /** #1052 — uniform scale (1 = no change). */\n scale?: number;\n /** #1052 — rotation in DEGREES. */\n rotation?: number;\n /** #1052 — stacking order within a ZStack/overlay. */\n zIndex?: number;\n /** #1052 — gaussian blur radius (pt/dp/px). */\n blur?: number;\n /** #1052 — `false` = decorative (ignores taps, unlike `hidden` which stays hit-testable);\n * `true` = force hit-testable (a clear tap target). */\n hitTestable?: boolean;\n /** #1052 — explicit drop shadow (colour + radius + offset), for upward / multi-layer\n * shadows the `shadow` token can't express. */\n boxShadow?: Shadow;\n /** The role assistive technology should announce. Absent = the\n * renderer INFERS it from the component type, so an author never restates the\n * obvious. `\"decorative\"` is node-local: the node itself stops being an\n * accessibility element (no role, not a stop) while its children stay\n * traversable — the ARIA `role=\"presentation\"` semantic. To remove the subtree\n * too, use `accessibilityHidden`. */\n accessibilityRole?: AccessibilityRole;\n /** The supplementary \"what happens if I act\" phrase\n * (iOS `accessibilityHint`, Android `onClickLabel`, ARIA `aria-describedby`).\n * Never a substitute for `accessibilityLabel`: AT may not speak a hint at all. */\n accessibilityHint?: string;\n /** Remove this node AND its subtree from the accessibility tree.\n * Distinct from `hidden` (which removes it visually too) and from the\n * `\"decorative\"` role (node-local; children stay reachable). */\n accessibilityHidden?: boolean;\n /** Mark the node as a heading at level 1–6, for rotor / heading\n * navigation. Implies the `\"heading\"` role when `accessibilityRole` is absent.\n * The LEVEL reaches iOS and web only: Android (Compose `heading()`) and React Native\n * (`accessibilityRole: \"header\"`) have no level primitive and mark a plain heading. */\n headingLevel?: number;\n /** An explicit SPOKEN value where the visual and spoken values\n * differ (a rating \"3 of 5\", a gauge \"72 percent\"). Where the value is derivable\n * from a prop the renderer computes it and this override is unnecessary. */\n accessibilityValue?: string;\n /** Additive state that a single role cannot carry. A node may\n * hold several. */\n accessibilityTraits?: AccessibilityTrait[];\n /** Explicit traversal index within the nearest focus group. Absent ⇒\n * the arm's visual / DOM order. The lower index is reached FIRST, which is why iOS\n * (whose `accessibilitySortPriority` is descending) negates it. */\n focusOrder?: number;\n /** This node's subtree is ONE traversal scope: children are ordered\n * relative to each other, then the group takes its parent's slot (iOS\n * `shouldGroupAccessibilityChildren`, Android `isTraversalGroup`, ARIA grouping). */\n focusGroup?: boolean;\n /** AT / keyboard focus lands here when the screen or a newly presented\n * modal appears. At most one per focus scope. */\n initialFocus?: boolean;\n /** A general live-region announcement, on any node and any transition.\n * The generalization of `FragmentSlotCase.accessibilityAnnouncement`, which only ever\n * fired on a fragment-slot case swap. */\n announce?: LiveRegion;\n}",
1393
+ "Modifiers": "export interface Modifiers {\n padding?: EdgeInsets;\n background?: TokenRef;\n cornerRadius?: number;\n /** Fixed intrinsic width (pt/dp/px). Honored by iOS (`FrameIfPresent`), Android\n * (frame) and web (`modifiers.ts`). With no `ScrollView` in the vocabulary and\n * regions clipped at `maxHeight`, `width`/`height`/`fillMaxWidth` are the main\n * sizing tools for embed/host content. */\n width?: number;\n /** Fixed intrinsic height (pt/dp/px). See `width`. */\n height?: number;\n /** Fill the available cross-axis width (keeps any fixed `height`). Mirrors\n * Compose `fillMaxWidth` / SwiftUI `.frame(maxWidth: .infinity)`. See `width`. */\n fillMaxWidth?: boolean;\n /** CAP the node's laid-out width at this many points. It CONSTRAINS, it\n * does not SET: a node narrower than the cap keeps its intrinsic width, so a\n * short chat bubble stays short while a long one stops at the cap — the\n * asymmetry `width` cannot express and `weight` cannot either (weights divide\n * the *available* space, so every child lands on the same fraction).\n * The cap covers the node's TOTAL width, padding + border included (CSS\n * `max-width` under `box-sizing: border-box`). `fillMaxWidth` grabs the axis but\n * THE CAP WINS — fill + cap is exactly `maxWidth` wide; a literal `width` larger\n * than the cap is clamped to it too. POINTS, not a fraction: a modifier is\n * resolved with no portable notion of \"the row\" on any renderer — compose a\n * percentage from a weighted sibling gap instead. `0`/absent = no cap. */\n maxWidth?: number;\n /** Flex weight along the parent stack's MAIN axis (HStack = width, VStack =\n * height). The stack measures its intrinsic (unweighted) children first, then\n * divides what is LEFT among the weighted ones in proportion to their weights:\n * two children at `1` split the leftover equally, `2` and `1` split it 2:1.\n * Absent (or <= 0) keeps the node at its intrinsic size. Use this — not\n * `fillMaxWidth` — when a node should claim the remaining space *beside* its\n * siblings; a full-bleed fill grabs the whole axis and starves them. Ignored\n * outside an HStack/VStack.\n * CAVEAT — row-sharing controls have NO intrinsic width to measure first: in an\n * HStack a `Button` and a `Toggle` are implicitly weighted, so they DIVIDE the\n * row with your weighted child instead of taking a width ahead of it —\n * `[VStack(weight:1), Button, Button]` is a three-way split, not \"the VStack gets\n * the remainder\". To opt a Button out on EVERY renderer set `fullWidth: false`\n * (an explicit flag wins in both directions; absent falls back to the style\n * default, which is \"share\" for every style but `tertiary`/`link`), or use\n * `iconOnly`. Otherwise give the actions their own row.\n * See `himi docs designing-himi-screens` §4. */\n weight?: number;\n /** RTL — pin the subtree's writing direction: `\"ltr\"` | `\"rtl\"` | `\"locale\"`\n * (inherit). The common RTL pattern is the inverse of `Text.textDirection`: pin a\n * container `ltr` (a logotype, an attachment-tile row, a composer button row)\n * inside an otherwise-RTL screen. Absent = inherit the ambient direction. #1060. */\n layoutDirection?: \"ltr\" | \"rtl\" | \"locale\";\n /** Absolute visual translation (pt/dp/px). Applied as the OUTERMOST transform so\n * it shifts the fully-styled node WITHOUT changing its layout footprint — lets a\n * ZStack place polar/absolute children (e.g. AgentOrbit). Negative allowed. */\n offsetX?: number;\n offsetY?: number;\n onTap?: Action;\n /** Double-tap gesture (e.g. Instagram double-tap-to-like). Distinct from onTap. */\n onDoubleTap?: Action;\n accessibilityLabel?: string;\n hidden?: boolean;\n /** Data-bound conditional visibility: a `\"$service:<svc>.<field>\"`\n * or `\"$item.<field>\"` sentinel resolving to a bool at render; when true the\n * subtree fully COLLAPSES (zero layout, like `hidden`), overriding the\n * literal `hidden`. */\n hiddenPath?: string;\n /** Long-press gesture modifier. */\n onLongPress?: Action;\n /** Fires once when the component first appears on screen. */\n onAppear?: Action;\n /** Scoped token overrides for the subtree. */\n theme?: ThemeOverrides;\n /** Names a token from the app's `shadows` registry. */\n shadow?: TokenRef;\n /** Names a token from the app's `gradients` registry (background fill). */\n backgroundGradient?: TokenRef;\n /** Value-driven gradient: a `$service:`/`$item.` path resolving to a gradient\n * TOKEN NAME used as the live background (e.g. weather sky day→night). */\n backgroundGradientPath?: string;\n /** Value-driven background COLOR: a `$service:`/`$item.` path resolving to a\n * color TOKEN NAME used as the live background. Honored on iOS + Android\n * (`BoundBackgroundIfPresent`); web render support is tracked in #1057. */\n backgroundColorPath?: string;\n /** Value-driven background IMAGE: a `$service:`/`$item.` path resolving to an\n * image URL used as the live background. Honored on iOS + Android; web render\n * support is tracked in #1057. */\n backgroundImagePath?: string;\n /** #1051 — MEASURE (publish): report this node's laid-out size into the renderer's\n * self-contained (worker-free) measure store under the named keys, so a SIBLING can\n * feed the number back into its own layout via a `$measure:<key>` binding. The SDUI\n * equivalent of SwiftUI `.onGeometryChange` / Compose `onGloballyPositioned`; the\n * canonical use is a pinned bottom bar whose measured height becomes a scroll view's\n * bottom inset (sticky-footer + scroll-inset, unrepresentable before — #1051). */\n onMeasure?: Measure;\n /** #1051 — bound height: a `\"$measure:<key>\"` (measure store) or\n * `\"$service:<svc>.<field>\"` / `\"$item.<field>\"` (worker/row state) sentinel resolving\n * to a NUMBER at render. Wins over the literal `height`. String path only, so a\n * binding can never blank the node (never overload the numeric `height`). */\n heightPath?: string;\n /** #1051 — bound width. See `heightPath`. Wins over the literal `width`. */\n widthPath?: string;\n /** #1051 — bound TOP inset (the header-height → top-inset idiom). A `$measure:`/\n * `$service:`/`$item.` sentinel resolving to a number; added as top padding. */\n paddingTopPath?: string;\n /** #1051 — bound BOTTOM inset (the sticky-footer-height → bottom-inset idiom). A\n * `$measure:`/`$service:`/`$item.` sentinel resolving to a number; added as bottom\n * padding so the last scroll row clears a pinned bottom bar. */\n paddingBottomPath?: string;\n /** #1053 — INLINE gradient background paint. Distinct from `backgroundGradient`\n * (which names a `gradients` registry token an embed host can't register): this\n * carries its stops/colours in the descriptor, so it works anywhere. Painted as\n * a surface (behind children), below `material`/`backgroundGradient` if those are\n * also set. */\n gradient?: Gradient;\n /** #1053 — gradient ALPHA MASK: the node shows through where the gradient is\n * opaque and fades where it's transparent (a transparent-token stop = fully\n * clear). The material-under-gradient-scrim / scroll-fade-out idiom. Mirrors iOS\n * `.mask()`, Android `BlendMode.DstIn`, web `mask-image`. */\n mask?: Gradient;\n /** Inline border/stroke. */\n border?: Border;\n /** Subtree alpha 0.0–1.0; absent = opaque. */\n opacity?: number;\n /** #433 — constrain the subtree to a width:height ratio (e.g. `1` = square,\n * `1.777` = 16:9). Width-driven: the height derives from the resolved width.\n * Lets a data-bound Grid cell / photo tile hold its shape at any width. */\n aspectRatio?: number;\n /** Names a token from the app's `motions` registry; the subtree\n * fades + slides up on first appearance. */\n appear?: TokenRef;\n /** Surface material token (flat/glass/frosted). */\n material?: TokenRef;\n /** Per-node construction-language override. */\n variant?: string;\n /** Per-node density / motion override. */\n density?: string;\n motion?: string;\n /** Motion grammar (Batch 1) — press/tap feedback style\n * (auto|none|scale|highlight|scaleHighlight|lift); timing comes from `motion`.\n * Applied only when the node is interactive. Unknown degrades to `auto`. */\n pressFeedback?: string;\n /** Motion grammar (Batch 1) — press-coupled haptic\n * (none|selection|light|medium|heavy|success|warning|error); fires with onTap.\n * Default none (opt-in). Web is a no-op. */\n haptic?: string;\n /** Motion grammar (Batch 1) — animate this container's size changes instead of\n * snapping (iOS `.animation(value:)`, Android `animateContentSize`, web height\n * transition). Curve from the active `motion` personality. */\n animateContentSize?: boolean;\n /** Motion grammar (Batch 1) — enter/exit transition; supersedes `appear` when\n * both are present. */\n transition?: Transition;\n /** Motion grammar (Batch 2, scroll-driven) — defer the `transition` enter until\n * the node first crosses into the scroll viewport (reveal-on-scroll). Gated by\n * reduced motion (shown immediately when reduced). */\n revealOnScroll?: boolean;\n /** Motion grammar (Batch 2, scroll-driven) — parallax factor: the node drifts\n * vertically at this fraction of the scroll delta as it moves through the\n * viewport. Gated by reduced motion. Generalizes CollapsingHeader parallaxFactor. */\n parallax?: number;\n /** Motion grammar (Batch 4, rich visual) — when a backgroundGradient is present,\n * continuously drift/rotate it (animated gradient). Gated by reduced motion. */\n animatedGradient?: boolean;\n /** Motion grammar (Batch 3, hero/nav) — shared-element key: a matching\n * transitionId on the source + destination screen morphs that element across\n * navigation (web View Transitions / iOS matchedTransitionSource / Android\n * SharedTransitionLayout). Gated by reduced motion. */\n transitionId?: string;\n /** Motion grammar (Batch 4, rich visual) — render the backgroundGradient as a\n * mesh (overlapping multi-point blend) rather than a linear sweep; combine with\n * animatedGradient to drift it. */\n meshGradient?: boolean;\n /** Motion grammar (Batch 4, celebration) — burst a one-shot confetti overlay\n * within the node on appear. Gated by reduced motion. */\n confetti?: boolean;\n /** Motion grammar (Batch 2, scroll-driven) — pin this node to the top of its\n * scroll container (sticky section header). Functional positioning; not gated\n * by reduced motion. */\n sticky?: boolean;\n /** Motion grammar (Batch 2, scroll-driven) — turn this thin node into a\n * reading-progress bar that fills left→right with scroll (scaleX). web reads\n * window scroll; native reads the host scroll fraction. Functional. */\n scrollProgress?: boolean;\n /** Motion grammar (Batch 4, rich vector) — a named built-in vector animation\n * (\"loader\" | \"success\" | \"pulse\"), dependency-free. Gated by reduced motion.\n * Arbitrary Lottie/Rive JSON is the lib-backed superset follow-up. */\n vectorAnim?: string;\n /** Motion grammar (Batch 1, choreography) — delay this node's ENTER transition\n * by N ms so a screen can SEQUENCE its entrance beyond list stagger (\"title\n * fades, subtitle slides in 100ms later\"). Adds to any list `staggerMs`. Gated\n * by reduced motion. 0/absent = no extra delay. */\n enterDelayMs?: number;\n /** Motion grammar (Phase-3, per-node MotionSpec) — overrides the PRESS-feedback\n * curve with a `motions`-registry token, mirroring `Transition.motion` for the\n * enter curve. Absent → press uses the global `motion` personality. */\n pressMotion?: TokenRef;\n /** Motion grammar (Phase-3, gesture-driven) — finger-tracked drag-to-dismiss; past\n * threshold along `direction` it animates off and fires `action`, else springs back. */\n swipeDismiss?: SwipeDismiss;\n /** Motion grammar (Phase-4, reduced-motion) — per-node escape from the reduced-motion\n * gate. Default true (respect). false = \"must move anyway\" (transition/press animate\n * even when reduced motion is on). */\n respectReducedMotion?: boolean;\n /** #1052 — uniform scale (1 = no change). */\n scale?: number;\n /** #1052 — rotation in DEGREES. */\n rotation?: number;\n /** #1052 — stacking order within a ZStack/overlay. */\n zIndex?: number;\n /** #1052 — gaussian blur radius (pt/dp/px). */\n blur?: number;\n /** #1052 — `false` = decorative (ignores taps, unlike `hidden` which stays hit-testable);\n * `true` = force hit-testable (a clear tap target). */\n hitTestable?: boolean;\n /** #1052 — explicit drop shadow (colour + radius + offset), for upward / multi-layer\n * shadows the `shadow` token can't express. */\n boxShadow?: Shadow;\n /** The role assistive technology should announce. Absent = the\n * renderer INFERS it from the component type, so an author never restates the\n * obvious. `\"decorative\"` is node-local: the node itself stops being an\n * accessibility element (no role, not a stop) while its children stay\n * traversable — the ARIA `role=\"presentation\"` semantic. To remove the subtree\n * too, use `accessibilityHidden`. */\n accessibilityRole?: AccessibilityRole;\n /** The supplementary \"what happens if I act\" phrase\n * (iOS `accessibilityHint`, Android `onClickLabel`, ARIA `aria-describedby`).\n * Never a substitute for `accessibilityLabel`: AT may not speak a hint at all. */\n accessibilityHint?: string;\n /** Remove this node AND its subtree from the accessibility tree.\n * Distinct from `hidden` (which removes it visually too) and from the\n * `\"decorative\"` role (node-local; children stay reachable). */\n accessibilityHidden?: boolean;\n /** Mark the node as a heading at level 1–6, for rotor / heading\n * navigation. Implies the `\"heading\"` role when `accessibilityRole` is absent.\n * The LEVEL reaches iOS and web only: Android (Compose `heading()`) and React Native\n * (`accessibilityRole: \"header\"`) have no level primitive and mark a plain heading. */\n headingLevel?: number;\n /** An explicit SPOKEN value where the visual and spoken values\n * differ (a rating \"3 of 5\", a gauge \"72 percent\"). Where the value is derivable\n * from a prop the renderer computes it and this override is unnecessary. */\n accessibilityValue?: string;\n /** Additive state that a single role cannot carry. A node may\n * hold several. */\n accessibilityTraits?: AccessibilityTrait[];\n /** Explicit traversal index within the nearest focus group. Absent ⇒\n * the arm's visual / DOM order. The lower index is reached FIRST, which is why iOS\n * (whose `accessibilitySortPriority` is descending) negates it. */\n focusOrder?: number;\n /** This node's subtree is ONE traversal scope: children are ordered\n * relative to each other, then the group takes its parent's slot (iOS\n * `shouldGroupAccessibilityChildren`, Android `isTraversalGroup`, ARIA grouping). */\n focusGroup?: boolean;\n /** AT / keyboard focus lands here when the screen or a newly presented\n * modal appears. At most one per focus scope. */\n initialFocus?: boolean;\n /** A general live-region announcement, on any node and any transition.\n * The generalization of `FragmentSlotCase.accessibilityAnnouncement`, which only ever\n * fired on a fragment-slot case swap. */\n announce?: LiveRegion;\n /** A recurring, finite, transform-only motion on a decorative node: a\n * living character's idle `hop`, a `blink`, a working `breathe`. Never changes the\n * node's layout footprint. Stopped by reduced motion unless `respectReducedMotion`\n * is false. */\n ambientMotion?: AmbientMotion;\n}",
1394
1394
  "TokenRef": "export interface TokenRef {\n token: TokenName;\n}",
1395
1395
  "Action": "export interface Action {\n actionId: string;\n /** Backwards-compatible string-only params. Prefer `args` for typed payloads. */\n params?: Record<string, string>;\n /** Typed action args; nested objects/arrays preserved end-to-end. */\n args?: Record<string, Value>;\n /** Navigation hint for the router; ignored for non-nav actions. */\n presentation?: Presentation;\n}",
1396
1396
  "Presentation": "export type Presentation =\n | \"push\"\n | \"sheet\"\n | \"replace\"\n | \"dismiss\"\n | \"back\"\n | \"full_screen\"\n | \"alert\"\n | \"snackbar\";",
@@ -2246,6 +2246,11 @@ export interface ScreenDescriptor {
2246
2246
  * up (a chat transcript). Tapping it animates back to the bottom. Absent/false =
2247
2247
  * a normal top-anchored scroll. Honored by the app host (Router). */
2248
2248
  scrollToBottom?: boolean;
2249
+ /** The chat transcript scroll policy. On a send the host pins the
2250
+ * named component near the top and reserves the space the reply grows into;
2251
+ * when the reply outgrows it the host follows the tail. A drag pauses
2252
+ * following, and only then is a jump-to-latest control shown. */
2253
+ transcriptScroll?: TranscriptScroll;
2249
2254
  /** Present when `renderer` is `webview_native_bridge` or `webview_ds`. */
2250
2255
  url?: string;
2251
2256
  capabilitiesRequired?: string[];
@@ -2653,6 +2658,11 @@ export interface Modifiers {
2653
2658
  * The generalization of `FragmentSlotCase.accessibilityAnnouncement`, which only ever
2654
2659
  * fired on a fragment-slot case swap. */
2655
2660
  announce?: LiveRegion;
2661
+ /** A recurring, finite, transform-only motion on a decorative node: a
2662
+ * living character's idle `hop`, a `blink`, a working `breathe`. Never changes the
2663
+ * node's layout footprint. Stopped by reduced motion unless `respectReducedMotion`
2664
+ * is false. */
2665
+ ambientMotion?: AmbientMotion;
2656
2666
  }
2657
2667
 
2658
2668
  export interface TokenRef {
@@ -65,6 +65,46 @@ behavioral crawl: do not call the app fully validated or release-ready, and do n
65
65
  unsupported command. The customer-facing skill owns the plan; its approved `MOBILE-UX.md` remains
66
66
  the UX source of truth even if that guide is absent from the installed CLI.
67
67
 
68
+ ## Plan shared views and readable names
69
+
70
+ Plan screens by page layout and behavior, not by individual data records. Products using
71
+ one details layout use one stable screen (for example `himi_product`) and pass the
72
+ selected product ID as navigation input. Different layouts may use stable descriptive
73
+ screens such as `himi_product_DigitalProduct` and `himi_product_PhysicalProduct`.
74
+ A different product ID, title, image or price alone does not justify another view.
75
+
76
+ Declare meaningful names in `himalaya.content.json.screens`, keyed by stable screen IDs.
77
+ Each entry has optional `displayName` and `viewId` fields. New generated apps must supply
78
+ an explicit readable name for every screen, independent of native titles/navigation labels.
79
+ Infer the name from page purpose. Preserve any item ID in an existing title verbatim.
80
+ Omit `viewId` normally: it defaults to the screen's own ID. Only retained compatibility
81
+ instances sharing one layout set it to the representative screen ID:
82
+
83
+ ```json
84
+ "screens": {
85
+ "home": { "displayName": "Home" },
86
+ "himi_product": { "displayName": "Product Details" },
87
+ "himi_product_123": { "displayName": "Product Details", "viewId": "himi_product" },
88
+ "himi_product_DigitalProduct": { "displayName": "Digital Product Details" }
89
+ }
90
+ ```
91
+
92
+ Build puts these fields directly on `manifest.screens[id]`; there is no separate registry.
93
+ Known templated-route instances inherit their declared canonical screen's name and view ID;
94
+ exact screen metadata always wins. Different logical views must have distinct normalized
95
+ names; an explicit name must not collide with another view’s raw-ID fallback. If an instance
96
+ has a name, its representative must declare the same name. Explicit view IDs must point directly
97
+ to a built representative, never through alias chains. Editors request
98
+ `/v1/preview/a/<app>/screens?groupBy=view` to show one row per logical view.
99
+ Missing displayName uses the raw screen ID. Existing apps are not migrated or republished
100
+ solely to add names; titles and navigation labels are never runtime naming fallbacks.
101
+ Keep source screen metadata current after adding or trimming screens. `himi template screens
102
+ --add` maintains existing metadata; `--display-name "<meaningful name>"` sets the new name.
103
+ A blank scaffold remains valid with no metadata; the generating AI provides explicit names.
104
+ Name/group metadata changes require a full `himi push` (a draft is fine), not `--only`.
105
+ Partial patches preserve existing names; `--accept-partial` cannot bypass the full-publish
106
+ requirement for names/grouping.
107
+
68
108
  ## Author your first screen
69
109
 
70
110
  **Building a real app? Start from a full template**, not the blank scaffold:
@@ -88,6 +88,46 @@ behavioral crawl: do not call the app fully validated or release-ready, and do n
88
88
  unsupported command. The customer-facing skill owns the plan; its approved `MOBILE-UX.md` remains
89
89
  the UX source of truth even if that guide is absent from the installed CLI.
90
90
 
91
+ ## Plan shared views and readable names
92
+
93
+ Plan screens by page layout and behavior, not by individual data records. Products using
94
+ one details layout use one stable screen (for example `himi_product`) and pass the
95
+ selected product ID as navigation input. Different layouts may use stable descriptive
96
+ screens such as `himi_product_DigitalProduct` and `himi_product_PhysicalProduct`.
97
+ A different product ID, title, image or price alone does not justify another view.
98
+
99
+ Declare meaningful names in `himalaya.content.json.screens`, keyed by stable screen IDs.
100
+ Each entry has optional `displayName` and `viewId` fields. New generated apps must supply
101
+ an explicit readable name for every screen, independent of native titles/navigation labels.
102
+ Infer the name from page purpose. Preserve any item ID in an existing title verbatim.
103
+ Omit `viewId` normally: it defaults to the screen's own ID. Only retained compatibility
104
+ instances sharing one layout set it to the representative screen ID:
105
+
106
+ ```json
107
+ "screens": {
108
+ "home": { "displayName": "Home" },
109
+ "himi_product": { "displayName": "Product Details" },
110
+ "himi_product_123": { "displayName": "Product Details", "viewId": "himi_product" },
111
+ "himi_product_DigitalProduct": { "displayName": "Digital Product Details" }
112
+ }
113
+ ```
114
+
115
+ Build puts these fields directly on `manifest.screens[id]`; there is no separate registry.
116
+ Known templated-route instances inherit their declared canonical screen's name and view ID;
117
+ exact screen metadata always wins. Different logical views must have distinct normalized
118
+ names; an explicit name must not collide with another view’s raw-ID fallback. If an instance
119
+ has a name, its representative must declare the same name. Explicit view IDs must point directly
120
+ to a built representative, never through alias chains. Editors request
121
+ `/v1/preview/a/<app>/screens?groupBy=view` to show one row per logical view.
122
+ Missing displayName uses the raw screen ID. Existing apps are not migrated or republished
123
+ solely to add names; titles and navigation labels are never runtime naming fallbacks.
124
+ Keep source screen metadata current after adding or trimming screens. `himi template screens
125
+ --add` maintains existing metadata; `--display-name "<meaningful name>"` sets the new name.
126
+ A blank scaffold remains valid with no metadata; the generating AI provides explicit names.
127
+ Name/group metadata changes require a full `himi push` (a draft is fine), not `--only`.
128
+ Partial patches preserve existing names; `--accept-partial` cannot bypass the full-publish
129
+ requirement for names/grouping.
130
+
91
131
  ## Author your first screen
92
132
 
93
133
  **Building a real app? Start from a full template**, not the blank scaffold:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wix/himalaya-cli",
3
- "version": "0.1308.0",
3
+ "version": "0.1309.0",
4
4
  "type": "module",
5
5
  "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.",
6
6
  "keywords": [
@@ -48,6 +48,7 @@
48
48
  "react-dom": "^18.2.0",
49
49
  "tough-cookie": "^6.0.1",
50
50
  "typescript": "^5.6.3",
51
+ "unicode-case-folding": "1.1.1",
51
52
  "wawoff2": "^2.0.1",
52
53
  "zod": "^4.2.0"
53
54
  },
@@ -70,5 +71,5 @@
70
71
  "artifactId": "himalaya-cli"
71
72
  }
72
73
  },
73
- "falconPackageHash": "eba491049c4b6f346d6c4cb65f33adaa4e2245f1d9f161bd7a6487dc"
74
+ "falconPackageHash": "02386de50054fcafd66cc4c3c44d8c8a4e9cf5de47401215465be767"
74
75
  }
@@ -1,5 +1,91 @@
1
1
  {
2
2
  "name": "__HIMI_APP_NAME__",
3
+ "screens": {
4
+ "himi_account": {
5
+ "displayName": "Profile"
6
+ },
7
+ "himi_app_info": {
8
+ "displayName": "App Info"
9
+ },
10
+ "himi_app_language": {
11
+ "displayName": "App Language"
12
+ },
13
+ "himi_appearance": {
14
+ "displayName": "Appearance"
15
+ },
16
+ "himi_blog": {
17
+ "displayName": "Blog"
18
+ },
19
+ "himi_blog_post": {
20
+ "displayName": "Post"
21
+ },
22
+ "himi_bookings": {
23
+ "displayName": "Bookings"
24
+ },
25
+ "himi_branded_home": {
26
+ "displayName": "Home"
27
+ },
28
+ "himi_cart": {
29
+ "displayName": "Cart"
30
+ },
31
+ "himi_collection": {
32
+ "displayName": "Collection"
33
+ },
34
+ "himi_collections": {
35
+ "displayName": "Collections"
36
+ },
37
+ "himi_create_post": {
38
+ "displayName": "Create Post"
39
+ },
40
+ "himi_delete_account": {
41
+ "displayName": "Delete Account"
42
+ },
43
+ "himi_my_subscriptions": {
44
+ "displayName": "My Subscriptions"
45
+ },
46
+ "himi_order": {
47
+ "displayName": "Order"
48
+ },
49
+ "himi_orders": {
50
+ "displayName": "Orders"
51
+ },
52
+ "himi_plan": {
53
+ "displayName": "Plan"
54
+ },
55
+ "himi_plans": {
56
+ "displayName": "Packages"
57
+ },
58
+ "himi_product": {
59
+ "displayName": "Product"
60
+ },
61
+ "himi_saved": {
62
+ "displayName": "Saved"
63
+ },
64
+ "himi_saved_products": {
65
+ "displayName": "Saved Products"
66
+ },
67
+ "himi_service": {
68
+ "displayName": "Service"
69
+ },
70
+ "himi_services": {
71
+ "displayName": "Book"
72
+ },
73
+ "himi_shop": {
74
+ "displayName": "Shop"
75
+ },
76
+ "himi_subscription": {
77
+ "displayName": "Subscription"
78
+ },
79
+ "himi_time": {
80
+ "displayName": "Choose a Time"
81
+ },
82
+ "himi_view_profile": {
83
+ "displayName": "View Profile"
84
+ },
85
+ "himi_whats_new": {
86
+ "displayName": "Whats New"
87
+ }
88
+ },
3
89
  "icon": "icon.png",
4
90
  "target": "prod",
5
91
  "shell": "branded-lite"