@wix/himalaya-cli 0.1095.0 → 0.1097.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/stores-v1/src/display.d.ts

@@ -66,6 +66,17 @@ export interface StoreProduct {
             currency?: string;
         };
     };
+    /** Option groups, both spellings: V1 `productOptions`, V3 `options`. Declared
+     *  because the wire carries them on BOTH catalogs and this type denying them is
+     *  what let every template product screen drop the colour/size picker. Shapes
+     *  differ per catalog, so read them with `productOptions()` from ./options. */
+    productOptions?: unknown[];
+    options?: unknown[];
+    /** V3 purchasable variants. The cart addresses a V3 option choice by `variantId`,
+     *  which `cartOptionsPayload()` resolves out of this. */
+    variantsInfo?: {
+        variants?: unknown[];
+    };
 }
 export interface StoreProductsResponse {
     products?: StoreProduct[];

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/stores-v1/src/extensions.d.ts

@@ -43,6 +43,7 @@ export declare function queryInventory(productId: string): Promise<WixQueryInven
  *  Only the supplied fields change (e.g. trackQuantity + a variant's quantity). */
 export declare function updateInventory(inventoryItemId: string, inventoryItem: WixInventoryItemWrite): Promise<WixUpdateInventoryResponse>;
 export * from "./display.js";
+export * from "./options.js";
 /** Forget the resolved Stores catalog version, in this worker and app-wide.
  *  Call this when the app points itself at a DIFFERENT Wix site. */
 export declare function forgetCatalogVersion(): void;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/stores-v1/src/options.d.ts

@@ -0,0 +1,74 @@
+import type { StoreProduct } from "./display.js";
+import { type WixImageSize } from "@wix/himalaya/wix-media";
+/** One selectable choice inside an option group. */
+export interface StoreOptionChoice {
+    /** Stable id within the group. V3: the `choiceId`. V1: the choice's own label,
+     *  which is what V1 has and what its cart payload carries. */
+    id: string;
+    /** What the shopper reads on the chip — "BEIGE", "M". */
+    label: string;
+    /** Is at least one variant carrying this choice in stock? */
+    inStock: boolean;
+    /** HEX swatch the site configured for this choice ("#e1bfc5"), or "" — a colour
+     *  group carries one, a size group does not. */
+    colorCode: string;
+    /** Choice-linked image, sized, or "" when the choice has none. */
+    image: string;
+}
+/** One option group, e.g. `COLOR` with `BEIGE` / `PINK`. */
+export interface StoreOption {
+    /** V3: the option id, used to resolve the variant. V1: the option name. */
+    id: string;
+    name: string;
+    /** `color` groups are the ones worth rendering as swatches — the choices carry
+     *  a `colorCode`. Everything else is a list of words. */
+    kind: "color" | "list";
+    choices: StoreOptionChoice[];
+}
+/** The shopper's pick: option id → choice id. A group the shopper has not chosen
+ *  yet is absent (or maps to ""). */
+export type StoreOptionSelection = Record<string, string>;
+/**
+ * Every offerable option group on a product, in site order, from either catalog.
+ *
+ * `[]` for a product with no options — the common case, so a caller must render
+ * nothing rather than an empty picker.
+ *
+ * `size` sizes the per-choice swatch image, like `productImage`; pass `null` for
+ * the stored original.
+ */
+export declare function productOptions(product: StoreProduct | undefined, size?: WixImageSize | null): StoreOption[];
+/** The choice to preselect for a group: the only one when there is exactly one,
+ *  otherwise "" so the shopper picks deliberately. */
+export declare function defaultChoice(option: StoreOption): string;
+/** A selection with every single-choice group pre-filled — what a product screen
+ *  starts from. */
+export declare function defaultSelection(options: StoreOption[]): StoreOptionSelection;
+/** Has the shopper chosen in EVERY group? Add to cart stays disabled until this
+ *  is true — a half-chosen product is the unfulfillable order. */
+export declare function isSelectionComplete(options: StoreOption[], selection: StoreOptionSelection): boolean;
+/** Human summary of the current selection, e.g. "BEIGE · M" ("" when nothing is
+ *  chosen). Labels, not ids — this is shopper-facing text. */
+export declare function selectionSummary(options: StoreOption[], selection: StoreOptionSelection): string;
+/**
+ * The V3 variant matching the shopper's choices, or "" when none does.
+ *
+ * Set equality on `{optionId, choiceId}` pairs, not order — V3 does not promise
+ * the variant's `choices` array is in the product's option order, and a positional
+ * compare passes on a two-option product until the day the site reorders it.
+ */
+export declare function resolveVariantId(product: StoreProduct | undefined, selection: StoreOptionSelection): string;
+/**
+ * The `catalogReference.options` value for `addToCurrentCart`, built for whichever
+ * catalog this product came from — V3 `{ variantId }`, V1 `{ options: {…} }`.
+ *
+ * `undefined` for a product with no options at all, which is what the cart wants
+ * (the line needs no `options` object).
+ *
+ * THROWS on V3 when the selection matches no variant, rather than returning a
+ * payload that adds an un-fulfillable line. The two ways to get here are a
+ * selection that is still incomplete (guard with `isSelectionComplete`) and a read
+ * whose `variantsInfo` did not come back — both are the caller's to fix, and both
+ * are invisible if this returns a plausible-looking payload instead.
+ */
+export declare function cartOptionsPayload(product: StoreProduct | undefined, options: StoreOption[], selection: StoreOptionSelection): Record<string, unknown> | undefined;

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

@@ -577,6 +577,131 @@ function plainText(value) {
   return (value || "").replace(/<[^>]+>/g, "").replace(/\s+/g, " ").trim();
 }
 
+// ../../stdlib/wix-sdk/stores-v1/src/options.ts
+function str(v) {
+  return typeof v === "string" ? v.trim() : "";
+}
+function choiceImage(raw, size) {
+  const m = raw;
+  const slot = m?.mainMedia ?? m?.items?.[0] ?? raw;
+  return slot ? mediaSlotUrl(slot, size) : "";
+}
+function hex(raw) {
+  const v = str(raw);
+  return /^#[0-9a-fA-F]{3}([0-9a-fA-F]{3})?$/.test(v) ? v.toLowerCase() : "";
+}
+function v1Choices(raw, size) {
+  const out = [];
+  for (const c of Array.isArray(raw) ? raw : []) {
+    const o = c;
+    if (o.visible === false) continue;
+    const label = str(o.description) || str(o.value);
+    if (!label || out.some((x) => x.id === label)) continue;
+    out.push({
+      id: label,
+      label,
+      inStock: o.inStock !== false,
+      colorCode: hex(o.value),
+      image: choiceImage(o.media, size)
+    });
+  }
+  return out;
+}
+function v3Choices(raw, size) {
+  const settings = raw;
+  const out = [];
+  for (const c of Array.isArray(settings?.choices) ? settings.choices : []) {
+    const o = c;
+    if (o.visible === false) continue;
+    const label = str(o.name) || str(o.key);
+    const id = str(o.choiceId);
+    if (!id || !label || out.some((x) => x.id === id)) continue;
+    const linked = Array.isArray(o.linkedMedia) ? o.linkedMedia[0] : void 0;
+    out.push({
+      id,
+      label,
+      inStock: o.inStock !== false,
+      colorCode: hex(o.colorCode) || hex(o.value?.colorCode),
+      image: choiceImage(o.displayImage ?? linked, size)
+    });
+  }
+  return out;
+}
+function kindOf(raw) {
+  const v = str(raw).toUpperCase();
+  return v.includes("COLOR") || v.includes("COLOUR") || v === "SWATCH_CHOICES" ? "color" : "list";
+}
+function productOptions(product, size = WIX_LIST_IMAGE) {
+  const p = product;
+  const out = [];
+  for (const raw of Array.isArray(p?.productOptions) ? p.productOptions : []) {
+    const o = raw;
+    const name = str(o.name);
+    const choices = v1Choices(o.choices, size);
+    if (name) out.push({ id: name, name, kind: kindOf(o.optionType), choices });
+  }
+  if (out.length) return out;
+  for (const raw of Array.isArray(p?.options) ? p.options : []) {
+    const o = raw;
+    const name = str(o.name);
+    const id = str(o.id) || name;
+    const choices = v3Choices(o.choicesSettings, size);
+    if (name) out.push({ id, name, kind: kindOf(o.optionRenderType), choices });
+  }
+  return out;
+}
+function defaultChoice(option) {
+  return option.choices.length === 1 ? option.choices[0].id : "";
+}
+function defaultSelection(options) {
+  const out = {};
+  for (const o of options) {
+    const choice = defaultChoice(o);
+    if (choice) out[o.id] = choice;
+  }
+  return out;
+}
+function isSelectionComplete(options, selection) {
+  return options.every((o) => !!selection[o.id]);
+}
+function selectionSummary(options, selection) {
+  return options.map((o) => o.choices.find((c) => c.id === selection[o.id])?.label ?? "").filter(Boolean).join(" \xB7 ");
+}
+function isV3(p) {
+  return Array.isArray(p.options) || !!p.variantsInfo;
+}
+function resolveVariantId(product, selection) {
+  const p = product;
+  const variants = p?.variantsInfo?.variants ?? [];
+  const want = Object.entries(selection).filter(([, choice]) => !!choice);
+  for (const v of variants) {
+    if (v.visible === false) continue;
+    const pairs = (v.choices ?? []).map((c) => [str(c.optionChoiceIds?.optionId), str(c.optionChoiceIds?.choiceId)]);
+    if (pairs.length !== want.length) continue;
+    if (want.every(([optionId, choiceId]) => pairs.some(([o, c]) => o === optionId && c === choiceId))) {
+      return str(v.id);
+    }
+  }
+  return "";
+}
+function cartOptionsPayload(product, options, selection) {
+  const p = product ?? {};
+  if (isV3(p)) {
+    const variantId = resolveVariantId(product, selection);
+    if (variantId) return { variantId };
+    if (options.length === 0) return void 0;
+    throw new Error(
+      "cartOptionsPayload: no Catalog V3 variant matches the chosen options \u2014 check every option group has a choice (isSelectionComplete) and that the product was read with its variantsInfo."
+    );
+  }
+  const picked = {};
+  for (const o of options) {
+    const choice = selection[o.id];
+    if (choice) picked[o.name] = choice;
+  }
+  return Object.keys(picked).length ? { options: picked } : void 0;
+}
+
 // ../../stdlib/wix-sdk/stores-v1/src/extensions.ts
 function queryProducts(req = {}) {
   return readWithCatalogFallback(async (v) => {
@@ -685,21 +810,28 @@ export {
   WIX_DETAIL_IMAGE,
   WIX_LIST_IMAGE,
   addProductMedia,
+  cartOptionsPayload,
   createProduct,
+  defaultChoice,
+  defaultSelection,
   deleteProduct,
   forgetCatalogVersion2 as forgetCatalogVersion,
   getProduct,
   getStoreProduct,
+  isSelectionComplete,
   isUnsizedWixMedia,
   mediaSlotUrl,
   plainText,
   productGallery,
   productImage,
+  productOptions,
   productPrice,
   queryInventory,
   queryProducts,
   queryStoreProducts,
+  resolveVariantId,
   searchStoreProducts,
+  selectionSummary,
   updateInventory,
   updateProduct,
   wixCall,

package/dist/cli.mjs

@@ -24584,6 +24584,7 @@ function shouldRevealError(args) {
 var EMAIL_RE, URL_HOST_RE, INTEGER_RE, NUMBER_RE;
 var init_validation = __esm({
   "../../core/ts/src/validation.ts"() {
+    "use strict";
     EMAIL_RE = /^[A-Za-z0-9._%+-]+@[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*\.[A-Za-z]{2,}$/;
     URL_HOST_RE = /^[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*(:[0-9]+)?$/;
     INTEGER_RE = /^[+-]?[0-9]+$/;
@@ -28204,6 +28205,7 @@ function validateWorkerSubtree(raw, slotId, policy, actionCatalog) {
 var WORKER_SUBTREE_CEILINGS, ID_PART, ACTION_ID;
 var init_worker_subtree = __esm({
   "../../core/ts/src/worker-subtree.ts"() {
+    "use strict";
     init_worker_subtree_safe_types_generated();
     WORKER_SUBTREE_CEILINGS = Object.freeze({
       maxEncodedBytes: 65536,
@@ -55228,10 +55230,41 @@ function assetBytes(asset) {
     `preview asset (${asset.contentType}) has neither bytes nor base64 \u2014 exactly one must be set by the producer`
   );
 }
-function bytes(asset, cacheControl) {
+function bytes(asset, cacheControl, cors = false) {
   return new Response(assetBytes(asset), {
     status: 200,
-    headers: { "content-type": asset.contentType, "cache-control": cacheControl }
+    headers: {
+      "content-type": asset.contentType,
+      "cache-control": cacheControl,
+      // #3425 — an EMBEDDED boot loads the bundle and its fonts from another origin: a module
+      // script and an @font-face are always fetched in CORS mode. Public, content-addressed (or
+      // shell) bytes with no credential attached, so `*` — never a reflected origin, never
+      // Allow-Credentials.
+      ...cors ? { "access-control-allow-origin": "*" } : {}
+    }
+  });
+}
+function embedManifest(assets) {
+  const index = assets.get("index.html");
+  if (!index) {
+    return new Response(JSON.stringify({ error: "preview_not_built" }), {
+      status: 503,
+      headers: { "content-type": "application/json; charset=utf-8", "access-control-allow-origin": "*" }
+    });
+  }
+  const html = new TextDecoder().decode(assetBytes(index)).replace(/(=|url\()(["']?)\/preview\//g, "$1$2");
+  const attr = (tag, name) => tag.match(new RegExp(`\\s${name}=["']([^"']+)["']`, "i"))?.[1];
+  const script = [...html.matchAll(/<script\b[^>]*>/gi)].map((m) => m[0]).filter((t) => /type=["']module["']/i.test(t)).map((t) => attr(t, "src")).find(Boolean);
+  const styles = [...html.matchAll(/<link\b[^>]*>/gi)].map((m) => m[0]).filter((t) => /rel=["']stylesheet["']/i.test(t)).map((t) => attr(t, "href")).filter((h) => !!h);
+  const css = [...html.matchAll(/<style\b[^>]*>([\s\S]*?)<\/style>/gi)].map((m) => m[1]).join("\n");
+  return new Response(JSON.stringify({ v: 1, base: "preview/", script: script ?? null, styles, css, frame: "t5-frame.html" }), {
+    status: 200,
+    headers: {
+      "content-type": "application/json; charset=utf-8",
+      // It changes on every artifact deploy (new hashed entry), so it is never cached as immutable.
+      "cache-control": "no-cache",
+      "access-control-allow-origin": "*"
+    }
   });
 }
 function scriptNonce() {
@@ -55289,6 +55322,7 @@ function indexHtml(asset, pathname, creds, handoverAttempted = false) {
 }
 function previewResponse(pathname, assets, mount = "/preview", creds, handoverAttempted = false) {
   const key2 = pathname.replace(MOUNT_STRIP[mount], "") || "index.html";
+  if (key2 === "embed.json") return embedManifest(assets);
   const hit = assets.get(key2);
   if (hit) {
     if (key2 === "index.html") return indexHtml(hit, pathname, creds, handoverAttempted);
@@ -55305,8 +55339,8 @@ function previewResponse(pathname, assets, mount = "/preview", creds, handoverAt
       });
     }
     const immutable = key2.startsWith("assets/");
-    if (key2.startsWith("fonts/")) return bytes(hit, "public, max-age=86400, stale-while-revalidate=604800");
-    return bytes(hit, immutable ? "public, max-age=31536000, immutable" : "no-cache");
+    if (key2.startsWith("fonts/")) return bytes(hit, "public, max-age=86400, stale-while-revalidate=604800", true);
+    return bytes(hit, immutable ? "public, max-age=31536000, immutable" : "no-cache", immutable);
   }
   if (key2.startsWith("assets/") || key2.startsWith("__himi/")) {
     return new Response(JSON.stringify({ error: "preview_asset_not_found", key: key2 }), {
@@ -55613,21 +55647,21 @@ var init_preview_assets_generated = __esm({
   "../../packages/serve/src/preview-assets.generated.ts"() {
     init_preview_assets_format();
     PREVIEW_ASSET_MANIFEST = [
-      { key: "assets/index-BtkpizCd.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 1084929, sha256: "31c667f8a14df2ebf95ca6f3c8d16763cc48e4c4a687efc97f8e7e13a90d71fa" },
-      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 1084937, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
-      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 1089547, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
-      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 1578131, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
-      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 1669055, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
-      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 1760039, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
-      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 1851019, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
-      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 1941891, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
-      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 2032871, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
-      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 2141507, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
-      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 2250591, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
-      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 2359639, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
-      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 2467339, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
-      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 2555447, length: 4947, sha256: "6b533f016eba30621c9c3e7dc26c86c26031f1663b5f107249fe3e848b7d785d" },
-      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 2560394, length: 17209, sha256: "dffc9718e2faa63ae2cc919e0a842f585ed565aaaa7c53778e90379442c731b6" }
+      { key: "assets/index-CkJJIVgC.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 1086565, sha256: "23abe36ec66a0951f04e69988f44efc2bebcf316b5e62c106b189b3c98c43833" },
+      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 1086573, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
+      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 1091183, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
+      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 1579767, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
+      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 1670691, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
+      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 1761675, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
+      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 1852655, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
+      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 1943527, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
+      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 2034507, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
+      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 2143143, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
+      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 2252227, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
+      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 2361275, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
+      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 2468975, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
+      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 2557083, length: 4947, sha256: "000fae927c619a62d02eac8479271fdfbe65747b09affafd58490063eaaf614a" },
+      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 2562030, length: 17209, sha256: "dffc9718e2faa63ae2cc919e0a842f585ed565aaaa7c53778e90379442c731b6" }
     ];
   }
 });

package/guides/sdk-reference.json

@@ -21651,7 +21651,7 @@
         "name": "StoreProduct",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface StoreProduct {\n  id?: string;\n  name?: string;\n  slug?: string;\n  description?: string;\n  plainDescription?: string;\n  /** Both gallery layouts: V1 `mainMedia`/`items`, V3 `main`/`itemsInfo.items`. */\n  media?: {\n    mainMedia?: WixMediaSlot;\n    main?: WixMediaSlot;\n    items?: WixMediaSlot[];\n    itemsInfo?: { items?: WixMediaSlot[] };\n  };\n  price?: { formatted?: { price?: string }; price?: number; currency?: string };\n  priceData?: { formatted?: { price?: string }; price?: number; currency?: string };\n  currency?: string;\n  actualPriceRange?: {\n    minValue?: { amount?: string; formattedAmount?: string; currency?: string };\n    maxValue?: { amount?: string; formattedAmount?: string; currency?: string };\n  };\n}"
+        "decl": "export interface StoreProduct {\n  id?: string;\n  name?: string;\n  slug?: string;\n  description?: string;\n  plainDescription?: string;\n  /** Both gallery layouts: V1 `mainMedia`/`items`, V3 `main`/`itemsInfo.items`. */\n  media?: {\n    mainMedia?: WixMediaSlot;\n    main?: WixMediaSlot;\n    items?: WixMediaSlot[];\n    itemsInfo?: { items?: WixMediaSlot[] };\n  };\n  price?: { formatted?: { price?: string }; price?: number; currency?: string };\n  priceData?: { formatted?: { price?: string }; price?: number; currency?: string };\n  currency?: string;\n  actualPriceRange?: {\n    minValue?: { amount?: string; formattedAmount?: string; currency?: string };\n    maxValue?: { amount?: string; formattedAmount?: string; currency?: string };\n  };\n  /** Option groups, both spellings: V1 `productOptions`, V3 `options`. Declared\n   *  because the wire carries them on BOTH catalogs and this type denying them is\n   *  what let every template product screen drop the colour/size picker. Shapes\n   *  differ per catalog, so read them with `productOptions()` from ./options. */\n  productOptions?: unknown[];\n  options?: unknown[];\n  /** V3 purchasable variants. The cart addresses a V3 option choice by `variantId`,\n   *  which `cartOptionsPayload()` resolves out of this. */\n  variantsInfo?: { variants?: unknown[] };\n}"
       },
       {
         "name": "StoreProductsResponse",
@@ -21696,6 +21696,66 @@
         "jsdoc": "",
         "decl": "export function plainText(value?: string): string;"
       },
+      {
+        "name": "StoreOptionChoice",
+        "kind": "interface",
+        "jsdoc": "/** One selectable choice inside an option group. */",
+        "decl": "export interface StoreOptionChoice {\n  /** Stable id within the group. V3: the `choiceId`. V1: the choice's own label,\n   *  which is what V1 has and what its cart payload carries. */\n  id: string;\n  /** What the shopper reads on the chip — \"BEIGE\", \"M\". */\n  label: string;\n  /** Is at least one variant carrying this choice in stock? */\n  inStock: boolean;\n  /** HEX swatch the site configured for this choice (\"#e1bfc5\"), or \"\" — a colour\n   *  group carries one, a size group does not. */\n  colorCode: string;\n  /** Choice-linked image, sized, or \"\" when the choice has none. */\n  image: string;\n}"
+      },
+      {
+        "name": "StoreOption",
+        "kind": "interface",
+        "jsdoc": "/** One option group, e.g. `COLOR` with `BEIGE` / `PINK`. */",
+        "decl": "export interface StoreOption {\n  /** V3: the option id, used to resolve the variant. V1: the option name. */\n  id: string;\n  name: string;\n  /** `color` groups are the ones worth rendering as swatches — the choices carry\n   *  a `colorCode`. Everything else is a list of words. */\n  kind: \"color\" | \"list\";\n  choices: StoreOptionChoice[];\n}"
+      },
+      {
+        "name": "StoreOptionSelection",
+        "kind": "type",
+        "jsdoc": "/** The shopper's pick: option id → choice id. A group the shopper has not chosen\n *  yet is absent (or maps to \"\"). */",
+        "decl": "export type StoreOptionSelection = Record<string, string>;"
+      },
+      {
+        "name": "productOptions",
+        "kind": "function",
+        "jsdoc": "/**\n * Every offerable option group on a product, in site order, from either catalog.\n *\n * `[]` for a product with no options — the common case, so a caller must render\n * nothing rather than an empty picker.\n *\n * `size` sizes the per-choice swatch image, like `productImage`; pass `null` for\n * the stored original.\n */",
+        "decl": "export function productOptions(\n  product: StoreProduct | undefined,\n  size: WixImageSize | null = WIX_LIST_IMAGE,\n): StoreOption[];"
+      },
+      {
+        "name": "defaultChoice",
+        "kind": "function",
+        "jsdoc": "/** The choice to preselect for a group: the only one when there is exactly one,\n *  otherwise \"\" so the shopper picks deliberately. */",
+        "decl": "export function defaultChoice(option: StoreOption): string;"
+      },
+      {
+        "name": "defaultSelection",
+        "kind": "function",
+        "jsdoc": "/** A selection with every single-choice group pre-filled — what a product screen\n *  starts from. */",
+        "decl": "export function defaultSelection(options: StoreOption[]): StoreOptionSelection;"
+      },
+      {
+        "name": "isSelectionComplete",
+        "kind": "function",
+        "jsdoc": "/** Has the shopper chosen in EVERY group? Add to cart stays disabled until this\n *  is true — a half-chosen product is the unfulfillable order. */",
+        "decl": "export function isSelectionComplete(options: StoreOption[], selection: StoreOptionSelection): boolean;"
+      },
+      {
+        "name": "selectionSummary",
+        "kind": "function",
+        "jsdoc": "/** Human summary of the current selection, e.g. \"BEIGE · M\" (\"\" when nothing is\n *  chosen). Labels, not ids — this is shopper-facing text. */",
+        "decl": "export function selectionSummary(options: StoreOption[], selection: StoreOptionSelection): string;"
+      },
+      {
+        "name": "resolveVariantId",
+        "kind": "function",
+        "jsdoc": "/**\n * The V3 variant matching the shopper's choices, or \"\" when none does.\n *\n * Set equality on `{optionId, choiceId}` pairs, not order — V3 does not promise\n * the variant's `choices` array is in the product's option order, and a positional\n * compare passes on a two-option product until the day the site reorders it.\n */",
+        "decl": "export function resolveVariantId(product: StoreProduct | undefined, selection: StoreOptionSelection): string;"
+      },
+      {
+        "name": "cartOptionsPayload",
+        "kind": "function",
+        "jsdoc": "/**\n * The `catalogReference.options` value for `addToCurrentCart`, built for whichever\n * catalog this product came from — V3 `{ variantId }`, V1 `{ options: {…} }`.\n *\n * `undefined` for a product with no options at all, which is what the cart wants\n * (the line needs no `options` object).\n *\n * THROWS on V3 when the selection matches no variant, rather than returning a\n * payload that adds an un-fulfillable line. The two ways to get here are a\n * selection that is still incomplete (guard with `isSelectionComplete`) and a read\n * whose `variantsInfo` did not come back — both are the caller's to fix, and both\n * are invisible if this returns a plausible-looking payload instead.\n */",
+        "decl": "export function cartOptionsPayload(\n  product: StoreProduct | undefined,\n  options: StoreOption[],\n  selection: StoreOptionSelection,\n): Record<string, unknown> | undefined;"
+      },
       {
         "name": "forgetCatalogVersion",
         "kind": "function",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1095.0",
+  "version": "0.1097.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": [
@@ -67,5 +67,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "3bc088681bc2460aba97337c0ea933769ccdab5b89076e5c716775a1"
+  "falconPackageHash": "a14970a4ab0b5e14659e9a75dc3d4ddbcaa2a0955fc287caf553d82c"
 }