@wix/himalaya-cli 0.1559.0 → 0.1561.0

package/guides/component-reference.json

@@ -238,7 +238,8 @@
       "category": "Core",
       "propsType": "StepperProps",
       "bindings": [
-        "valuePath"
+        "valuePath",
+        "maxPath"
       ],
       "dispatches": [
         {
@@ -259,7 +260,7 @@
           ]
         }
       ],
-      "propsSource": "export interface StepperProps {\n  value: number;\n  /** `$service:`/`$item.` binding → a live integer (overrides `value`). */\n  valuePath?: string;\n  min?: number;\n  max?: number;\n  onChange?: Action;\n  /** \"plain\" draws exposed minus/value/plus controls; absent uses the default capsule. */\n  presentation?: \"plain\";\n}"
+      "propsSource": "export interface StepperProps {\n  value: number;\n  /** `$service:`/`$item.` binding → a live integer (overrides `value`). */\n  valuePath?: string;\n  min?: number;\n  max?: number;\n  /** `$service:`/`$item.` binding → integer maximum, overrides `max`. */\n  maxPath?: string;\n  onChange?: Action;\n  /** \"plain\" draws exposed minus/value/plus controls; absent uses the default capsule. */\n  presentation?: \"plain\";\n}"
     },
     {
       "name": "Avatar",

package/guides/component-reference.md

@@ -44,7 +44,7 @@ See also **[Modifiers](#modifiers)** (the `modifiers` block) and **[Actions](#ac
 | `Button` | Core | `disabledPath`, `title` |
 | `TextField` | Core | `valuePath`, `focusPath`, `errorPath` |
 | `Toggle` | Core | `valuePath` |
-| `Stepper` | Core | `valuePath` |
+| `Stepper` | Core | `valuePath`, `maxPath` |
 | `Avatar` | Core | `imageUrl`, `initials` |
 | `Badge` | Core | `tokenPath`, `text` |
 | `Tag` | Core | `tokenPath`, `text` |
@@ -684,6 +684,8 @@ export interface StepperProps {
   valuePath?: string;
   min?: number;
   max?: number;
+  /** `$service:`/`$item.` binding → integer maximum, overrides `max`. */
+  maxPath?: string;
   onChange?: Action;
   /** "plain" draws exposed minus/value/plus controls; absent uses the default capsule. */
   presentation?: "plain";

package/guides/one-app-to-himi-app.md

@@ -163,20 +163,45 @@ Apply these interpretation rules:
   a feature to account for; they do not alone prove visibility or access for every
   visitor or member. Resolve those rules separately. This check is specific to this
   migration workflow; it does not change the behavior of `himi validate`.
-- Before publishing, run the migration-only design check:
+- Apply the collected app theme before the first build: run
+  `himi one-app validate-design --evidence-dir .himi/one-app --content . --fix`,
+  resolve any remaining mismatches/unresolved values, then rebuild. The source is
+  `settings.theme`, not the website or the starter template. Before publishing,
+  run the migration-only design check:
   `himi one-app validate-design --evidence-dir .himi/one-app --content .`.
   It resolves the effective source theme with the reader the source app instance
-  actually uses, then compares the resolved primary, background and content colors
-  and each button's `borderRadius` and `outlineWidth` against the app's `tokens.json`.
+  actually uses, then compares the resolved primary, background and content colors,
+  each button's `borderRadius` and `outlineWidth`, and resolved heading/body font families
+  against the app's `tokens.json`.
   Hex case and shorthand are normalized; an absent button token is compared with the
   value the renderer draws (an outline only on `secondary`; a radius of `radius.pill`,
   else 24), not called a difference. A variant without its own radius must draw the
   source radius at every Button size. A descriptor's per-button `cornerRadius` overrides
-  the tokens and is not checked. `--fix` writes the mismatching source values into
+  the tokens and is not checked; descriptor/control-specific fill and label overrides
+  also need a rendered check. `--fix` writes the mismatching source values into
   `tokens.json` and pins the dark and high-contrast schemes to what they drew before,
   because a missing scheme falls back to the light value. Rebuild after `--fix`.
+  For Branded apps, known source typography IDs (for example `lato`) become family
+  names (`Lato`); tokens whose names contain title/heading/headline/display/hero use the heading family; other
+  typography tokens use the body family. Numeric metrics stay unchanged. Unknown IDs,
+  families outside the Himi font catalog, and missing target typography roles remain unresolved; resolve them before recording
+  a pass, even when the coverage ledger cites an adaptation. A deliberate difference
+  between resolved font roles can still be adapted. Build/font validation still has
+  to prove the font bytes are available. Unresolved fonts and contrast also fail
+  the plain check used by push, not only `--record`.
+  Branded accent text must reach 4.5:1: `textOnAccent` against the fill, and `accentText` against the target page and declared neutral
+  surfaces. `--fix` chooses readable ink and derives a same-hue text shade while
+  retaining the exact source accent fill. For example, `#D6BD07` needs dark labels;
+  `#7A6C00` is a readable accent text shade on white. Translucent target colors cannot earn
+  an opaque contrast claim; an explicitly adapted source color still needs independently
+  readable opaque target roles. Author `surfacePrimary` explicitly when absent: native
+  hosts do not share the web's white page fallback. Conflicting page/card backdrops with no derived shade
+  that clears every surface stay unresolved; use separate local text roles. A missing
+  or translucent target accent palette must be authored explicitly before `--fix`,
+  because its non-light appearance cannot be preserved safely. Source `system` font
+  IDs use the portable `$system` sentinel. Contrast failures cannot be waived by a ledger adaptation.
   The report names every theme pointer the check did not compare, including typography
-  kits and any button `uppercase`, which Himi tokens cannot carry; resolve those
+  kit IDs and any button `uppercase`, which Himi tokens cannot carry; resolve those
   explicitly rather than treating a pass as full design parity. A deliberate difference
   is waived only by a `design` coverage row with status `adapted` that cites the user's
   instruction and explains the change. This check compares values, not rendered screens.

package/guides/sdk-reference.json

@@ -18428,7 +18428,7 @@
         "name": "WixEventFieldset",
         "kind": "type",
         "jsdoc": "/** Events v3 response fieldsets (`RequestedFields`). A bare read returns the base fieldset;\n *  each value adds fields: `DETAILS` → `shortDescription`, `mainImage`, `calendarUrls`;\n *  `TEXTS` → the Ricos `description`; `REGISTRATION` → `registration`; `URLS` → `eventPageUrl`;\n *  `FORM` → `form`, the published registration controls and inputs. */",
-        "decl": "export type WixEventFieldset = \"DETAILS\" | \"TEXTS\" | \"REGISTRATION\" | \"URLS\" | \"FORM\";"
+        "decl": "export type WixEventFieldset = \"DETAILS\" | \"TEXTS\" | \"REGISTRATION\" | \"URLS\" | \"FORM\" | \"AGENDA\";"
       },
       {
         "name": "WixEventRichContent",
@@ -18439,7 +18439,7 @@
       {
         "name": "getEvent",
         "kind": "function",
-        "jsdoc": "/** Get one event — GET /events/v3/events/{eventId}. Response wraps as `{ event }`.\n *  NOTE: this GET returns the Events v3 BASE fieldset — slimmer than `queryEvents`,\n *  which returns the richer default (fields such as `registration` and `calendarUrls`\n *  are absent from a bare `getEvent`). If a detail screen needs those fields for one\n *  event, prefer `queryEvents` and pick the row by id over `getEvent`.\n *  `opts.fields` requests extra v3 fieldsets; `[\"TEXTS\"]` returns `description`. */",
+        "jsdoc": "/** Get one event — GET /events/v3/events/{eventId}. Response wraps as `{ event }`.\n *  This GET returns the Events v3 BASE fieldset, which is slimmer than `queryEvents`;\n *  fields such as `registration` and `calendarUrls` are absent from a bare `getEvent`.\n *  Use `opts.fields` to request fieldsets such as `DETAILS`, `TEXTS`, `REGISTRATION`,\n *  `URLS`, `FORM`, and `AGENDA` when a one-event read needs them. */",
         "decl": "export async function getEvent(eventId: string, opts: { fields?: WixEventFieldset[] } = {}, readOptions?: WixCallOptions): Promise<WixGetEventResponse>;",
         "http": "GET /events/v3/events/{…}{…}"
       },
@@ -18535,7 +18535,7 @@
         "name": "WixAvailableTicket",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixAvailableTicket {\n  id?: string;\n  eventId?: string;\n  name?: string;\n  description?: string;\n  price?: WixTicketPrice;\n  free?: boolean;\n  limitPerCheckout?: number;\n  orderIndex?: number;\n  saleStatus?: string;\n  state?: string[];\n  pricing?: { pricingType?: string; fixedPrice?: WixTicketPrice };\n  dashboard?: { hidden?: boolean };\n}"
+        "decl": "export interface WixAvailableTicket {\n  id?: string;\n  eventId?: string;\n  name?: string;\n  description?: string;\n  price?: WixTicketPrice;\n  free?: boolean;\n  limitPerCheckout?: number;\n  orderIndex?: number;\n  saleStatus?: string;\n  salesDetails?: { unsoldCount?: number; soldCount?: number; reservedCount?: number; soldOut?: boolean };\n  salePeriod?: { startDate?: string; endDate?: string };\n  state?: string[];\n  pricing?: { pricingType?: string; fixedPrice?: WixTicketPrice };\n  pricingOptions?: Array<{ id?: string; optionId?: string; name?: string; price?: { amount?: string; value?: string; currency?: string } }>;\n  pricingMethod?: { type?: string; pricingType?: string; free?: boolean; fixedPrice?: { value?: string; currency?: string }; guestPrice?: { value?: string; currency?: string }; pricingOptions?: { optionDetails?: Array<{ id?: string; optionId?: string; name?: string; price?: { amount?: string; value?: string; currency?: string } }> } };\n  policy?: string;\n  policyText?: string;\n  wixFeeConfig?: { type?: string };\n  dashboard?: { hidden?: boolean };\n}"
       },
       {
         "name": "WixQueryAvailableTicketsResponse",
@@ -18555,7 +18555,7 @@
         "name": "WixTicketQuantity",
         "kind": "interface",
         "jsdoc": "/** One tier's ask in a reservation — `{ticketDefinitionId, quantity}`. */",
-        "decl": "export interface WixTicketQuantity {\n  ticketDefinitionId: string;\n  quantity: number;\n}"
+        "decl": "export interface WixTicketQuantity {\n  ticketDefinitionId: string;\n  quantity: number;\n  priceOverride?: string;\n  ticketDetails?: Array<{ pricingOptionId?: string }>;\n}"
       },
       {
         "name": "WixReservationInvoice",
@@ -18590,9 +18590,9 @@
       {
         "name": "queryAvailableTickets",
         "kind": "function",
-        "jsdoc": "/** Buyer-visible ticket tiers for an event — POST /events/v1/checkout/available-tickets/query. */",
-        "decl": "export function queryAvailableTickets(eventId: string, limit = 100): Promise<WixQueryAvailableTicketsResponse>;",
-        "http": "POST /events/v1/checkout/available-tickets/query"
+        "jsdoc": "/** Buyer-visible ticket tiers for an event — visitor-readable Events ticket definitions v3. */",
+        "decl": "export async function queryAvailableTickets(eventId: string, limit = 100): Promise<WixQueryAvailableTicketsResponse>;",
+        "http": "POST /events-ticket-definitions/v3/ticket-definitions/available/query"
       },
       {
         "name": "createTicketReservation",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1559.0",
+  "version": "0.1561.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": [
@@ -71,5 +71,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "10b9cfbdf8247c393305b2341b984702640668ff76c32fbc09ae2d8e"
+  "falconPackageHash": "218dfa6fb52b7f6f3cd393536b9c163e3928bdf54eeb2c0020520fa5"
 }

package/templates/beauty-salon/tier5-src/_shared/engine-intl.ts

@@ -486,3 +486,21 @@ export function zoneOffsetAt(at: number, timeZone: string): number {
   }
   return NaN;
 }
+
+/** Long zone label plus its short offset, e.g. "Israel Standard Time (GMT+2)". An engine
+ *  without ECMA-402 has no zone database, so callers omit the supplementary label there. */
+export function formatTimeZoneLabel(date: Date, timeZone: string, locale = "en"): string {
+  if (hasIntl()) {
+    if (!timeZone) return "";
+    try {
+      const parts = new Intl.DateTimeFormat(locale, { timeZone, timeZoneName: "long" }).formatToParts(date);
+      const name = parts.find((part) => part.type === "timeZoneName")?.value || timeZone;
+      const offset = new Intl.DateTimeFormat(locale, { timeZone, timeZoneName: "shortOffset" })
+        .formatToParts(date).find((part) => part.type === "timeZoneName")?.value;
+      return offset ? `${name} (${offset.replace(/:00$/, "")})` : name;
+    } catch {
+      return timeZone;
+    }
+  }
+  return "";
+}

package/templates/beauty-salon/tier5-src/_shared/himi-events.ts

@@ -56,3 +56,10 @@ export function rememberRsvp(eventId: string): void {
   const next = [eventId, ...ids.filter((id) => id !== eventId)].slice(0, 50);
   try { storage()?.setItem(RSVP_KEY, JSON.stringify(next)); } catch { /* best-effort */ }
 }
+
+/** Remove a locally confirmed RSVP after Wix confirms its cancellation. */
+export function forgetRsvp(eventId: string): void {
+  if (!eventId) return;
+  const next = confirmedRsvpIds().filter((id) => id !== eventId);
+  try { storage()?.setItem(RSVP_KEY, JSON.stringify(next)); } catch { /* best-effort */ }
+}

package/templates/beauty-salon-owner/tier5-src/_shared/engine-intl.ts

@@ -486,3 +486,21 @@ export function zoneOffsetAt(at: number, timeZone: string): number {
   }
   return NaN;
 }
+
+/** Long zone label plus its short offset, e.g. "Israel Standard Time (GMT+2)". An engine
+ *  without ECMA-402 has no zone database, so callers omit the supplementary label there. */
+export function formatTimeZoneLabel(date: Date, timeZone: string, locale = "en"): string {
+  if (hasIntl()) {
+    if (!timeZone) return "";
+    try {
+      const parts = new Intl.DateTimeFormat(locale, { timeZone, timeZoneName: "long" }).formatToParts(date);
+      const name = parts.find((part) => part.type === "timeZoneName")?.value || timeZone;
+      const offset = new Intl.DateTimeFormat(locale, { timeZone, timeZoneName: "shortOffset" })
+        .formatToParts(date).find((part) => part.type === "timeZoneName")?.value;
+      return offset ? `${name} (${offset.replace(/:00$/, "")})` : name;
+    } catch {
+      return timeZone;
+    }
+  }
+  return "";
+}

package/templates/beauty-salon-owner/tier5-src/_shared/himi-events.ts

@@ -56,3 +56,10 @@ export function rememberRsvp(eventId: string): void {
   const next = [eventId, ...ids.filter((id) => id !== eventId)].slice(0, 50);
   try { storage()?.setItem(RSVP_KEY, JSON.stringify(next)); } catch { /* best-effort */ }
 }
+
+/** Remove a locally confirmed RSVP after Wix confirms its cancellation. */
+export function forgetRsvp(eventId: string): void {
+  if (!eventId) return;
+  const next = confirmedRsvpIds().filter((id) => id !== eventId);
+  try { storage()?.setItem(RSVP_KEY, JSON.stringify(next)); } catch { /* best-effort */ }
+}