@shoplix-ai/sdui-schema 1.0.0

package/dist/definition-validator.js

@@ -0,0 +1,340 @@
+import { ROW_FIELD_TYPES, SETTING_TYPES, } from './block-definition.js';
+import { parseBlockDefinition } from './parse.js';
+import { definitionPathOf } from './path.js';
+import { composedBodyConditions, composedBodyItemUses, composedBodyReferences, composedBodyRepeaters, composedBodyShape, enumSlotValues, isTokenRole, nodeAtBodyPath, unknownPrimitivesOf, } from './primitives.js';
+import { SEMANTIC_TOKENS } from './tokens.js';
+/**
+ * What a pushed Block Definition is held to, wherever it is held: the api
+ * refuses with these, and a developer's own machine refuses the same way
+ * before anything leaves it.
+ */
+export const DEFINITION_LIMITS = {
+    maxDefinitionNodes: 200,
+    maxDefinitionDepth: 6,
+    maxDefinitionSettings: 40,
+    maxSettingRows: 20,
+    maxDefinitionBytes: 200_000,
+};
+export const DEFINITION_ISSUE = {
+    parse: 'SDUI_DEFINITION_PARSE',
+    unknownPrimitive: 'SDUI_DEFINITION_UNKNOWN_PRIMITIVE',
+    unknownSettingType: 'SDUI_DEFINITION_UNKNOWN_SETTING_TYPE',
+    unresolvedSetting: 'SDUI_DEFINITION_UNRESOLVED_SETTING',
+    unresolvedToken: 'SDUI_DEFINITION_UNRESOLVED_TOKEN',
+    unresolvedCondition: 'SDUI_DEFINITION_UNRESOLVED_CONDITION',
+    itemOutsideRepeater: 'SDUI_DEFINITION_ITEM_OUTSIDE_REPEATER',
+    repeaterWithoutBinding: 'SDUI_DEFINITION_REPEATER_WITHOUT_BINDING',
+    nestedRepeater: 'SDUI_DEFINITION_NESTED_REPEATER',
+    limitNodes: 'SDUI_LIMIT_DEFINITION_NODES',
+    limitDepth: 'SDUI_LIMIT_DEFINITION_DEPTH',
+    limitSettings: 'SDUI_LIMIT_DEFINITION_SETTINGS',
+    limitSettingRows: 'SDUI_LIMIT_SETTING_ROWS',
+    limitBytes: 'SDUI_LIMIT_DEFINITION_BYTES',
+};
+const ROOT = 'definition';
+const SETTING_TYPE_SET = new Set(SETTING_TYPES);
+const ROW_FIELD_TYPE_SET = new Set(ROW_FIELD_TYPES);
+/** Which setting types feed which value slots. */
+const FEEDS = {
+    text: ['text'],
+    boolean: ['toggle'],
+    enum: ['select'],
+    dimension: ['number'],
+    number: ['number'],
+    count: ['number'],
+    color: ['color'],
+    asset: ['image'],
+    action: ['action'],
+};
+const TOKEN_TYPE_OF_SLOT = {
+    color: 'color',
+    dimension: 'dimension',
+};
+/** A number setting feeding a sized slot must stay inside what the slot's literal accepts. */
+const NUMBER_SLOT_BOUNDS = {
+    dimension: { min: 0, max: 1000 },
+    number: { min: 0, max: 100 },
+    count: { min: 1, max: 24 },
+};
+function definitionPath(segments) {
+    return definitionPathOf([ROOT, ...segments]);
+}
+function outOfSlotBounds(setting, slot) {
+    const bounds = NUMBER_SLOT_BOUNDS[slot];
+    if (bounds === undefined)
+        return null;
+    if (setting.min === undefined || setting.max === undefined) {
+        return `needs both min and max, between ${bounds.min} and ${bounds.max}`;
+    }
+    if (setting.min < bounds.min || setting.max > bounds.max) {
+        return `must stay between ${bounds.min} and ${bounds.max}`;
+    }
+    return null;
+}
+function unknownTypeIssue(type, path, accepted) {
+    return {
+        code: DEFINITION_ISSUE.unknownSettingType,
+        path: definitionPath(path),
+        message: `unknown setting type "${type}": expected one of ${accepted.join(', ')}`,
+    };
+}
+/** A type outside the closed set, at the top level or one level down inside a row. */
+function unknownSettingTypeIssues(raw) {
+    const settings = raw?.settings;
+    if (!Array.isArray(settings))
+        return [];
+    const issues = [];
+    settings.forEach((setting, index) => {
+        const type = setting?.type;
+        if (typeof type !== 'string')
+            return;
+        if (!SETTING_TYPE_SET.has(type)) {
+            issues.push(unknownTypeIssue(type, ['settings', index, 'type'], SETTING_TYPES));
+            return;
+        }
+        if (type !== 'rows')
+            return;
+        const fields = setting.fields;
+        if (!Array.isArray(fields))
+            return;
+        fields.forEach((field, fieldIndex) => {
+            const fieldType = field?.type;
+            if (typeof fieldType !== 'string' || ROW_FIELD_TYPE_SET.has(fieldType))
+                return;
+            issues.push(unknownTypeIssue(fieldType, ['settings', index, 'fields', fieldIndex, 'type'], ROW_FIELD_TYPES));
+        });
+    });
+    return issues;
+}
+function settingReferenceIssue(definition, reference, key, settingsByKey) {
+    const path = definitionPath(['body', ...reference.path]);
+    const setting = settingsByKey.get(key);
+    if (setting === undefined) {
+        return {
+            code: DEFINITION_ISSUE.unresolvedSetting,
+            path,
+            message: `setting "${key}" is not declared`,
+        };
+    }
+    if (!FEEDS[reference.slot].includes(setting.type)) {
+        return {
+            code: DEFINITION_ISSUE.unresolvedSetting,
+            path,
+            message: `setting "${key}" is a ${setting.type} setting and cannot feed a ${reference.slot} value`,
+        };
+    }
+    if (setting.type === 'number') {
+        const problem = outOfSlotBounds(setting, reference.slot);
+        if (problem !== null) {
+            return {
+                code: DEFINITION_ISSUE.unresolvedSetting,
+                path,
+                message: `setting "${key}" feeds a ${reference.slot} value and ${problem}`,
+            };
+        }
+    }
+    if (setting.type === 'select') {
+        const node = nodeAtBodyPath(definition.body, reference.path);
+        const attribute = reference.path[reference.path.length - 1];
+        const accepted = node && typeof attribute === 'string' ? enumSlotValues(node, attribute) : null;
+        const stray = accepted
+            ? setting.options.filter((option) => !accepted.includes(option.value))
+            : [];
+        if (stray.length > 0) {
+            return {
+                code: DEFINITION_ISSUE.unresolvedSetting,
+                path,
+                message: `setting "${key}" offers ${stray.map((o) => `"${o.value}"`).join(', ')} which this value does not accept; expected ${accepted.map((v) => `"${v}"`).join(', ')}`,
+            };
+        }
+    }
+    return null;
+}
+function tokenReferenceIssue(reference, role) {
+    const path = definitionPath(['body', ...reference.path]);
+    if (!isTokenRole(role)) {
+        return {
+            code: DEFINITION_ISSUE.unresolvedToken,
+            path,
+            message: `token role "${role}" does not exist; expected one of ${Object.keys(SEMANTIC_TOKENS).join(', ')}`,
+        };
+    }
+    const spec = SEMANTIC_TOKENS[role];
+    const wanted = TOKEN_TYPE_OF_SLOT[reference.slot];
+    if (wanted === undefined || spec.type !== wanted) {
+        return {
+            code: DEFINITION_ISSUE.unresolvedToken,
+            path,
+            message: `token role "${role}" is a ${spec.type} token and cannot feed a ${reference.slot} value`,
+        };
+    }
+    return null;
+}
+function referenceIssues(definition) {
+    const settingsByKey = new Map(definition.settings.map((setting) => [setting.key, setting]));
+    const issues = [];
+    for (const reference of composedBodyReferences(definition.body)) {
+        const issue = 'setting' in reference.reference
+            ? settingReferenceIssue(definition, reference, reference.reference.setting, settingsByKey)
+            : tokenReferenceIssue(reference, reference.reference.token);
+        if (issue)
+            issues.push(issue);
+    }
+    return issues;
+}
+/** "show when" reads a setting the way a value does; only a toggle answers "is it on". */
+function conditionIssues(definition) {
+    const settingsByKey = new Map(definition.settings.map((setting) => [setting.key, setting]));
+    const issues = [];
+    for (const found of composedBodyConditions(definition.body)) {
+        if (found.condition.condition !== 'setting_on')
+            continue;
+        const key = found.condition.setting;
+        const setting = settingsByKey.get(key);
+        const path = definitionPath(['body', ...found.path]);
+        if (setting === undefined) {
+            issues.push({
+                code: DEFINITION_ISSUE.unresolvedCondition,
+                path,
+                message: `"show when" names setting "${key}", which is not declared`,
+            });
+            continue;
+        }
+        if (setting.type !== 'toggle') {
+            issues.push({
+                code: DEFINITION_ISSUE.unresolvedCondition,
+                path,
+                message: `"show when" names setting "${key}", which is a ${setting.type} setting and not a toggle`,
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * The current item exists only inside a repeater, a repeater only where a
+ * Binding is declared, and never inside another: that would be a nested
+ * Binding.
+ */
+function repeaterIssues(definition) {
+    const issues = [];
+    for (const repeater of composedBodyRepeaters(definition.body)) {
+        const path = definitionPath(['body', ...repeater.path]);
+        if (definition.binding.kind === 'none') {
+            issues.push({
+                code: DEFINITION_ISSUE.repeaterWithoutBinding,
+                path,
+                message: 'a repeater needs a Binding to repeat over; this definition declares none',
+            });
+        }
+        if (repeater.nested) {
+            issues.push({
+                code: DEFINITION_ISSUE.nestedRepeater,
+                path,
+                message: 'a repeater cannot stand inside another repeater',
+            });
+        }
+    }
+    for (const use of composedBodyItemUses(definition.body)) {
+        if (use.inRepeater)
+            continue;
+        issues.push({
+            code: DEFINITION_ISSUE.itemOutsideRepeater,
+            path: definitionPath(['body', ...use.path]),
+            message: `${use.use} reads the current item, which only a repeater sets`,
+        });
+    }
+    return issues;
+}
+function utf8Length(text) {
+    let bytes = 0;
+    for (const character of text) {
+        const point = character.codePointAt(0);
+        bytes += point < 0x80 ? 1 : point < 0x800 ? 2 : point < 0x10000 ? 3 : 4;
+    }
+    return bytes;
+}
+function limitIssues(definition) {
+    const issues = [];
+    definition.settings.forEach((setting, index) => {
+        if (setting.type !== 'rows' || setting.max <= DEFINITION_LIMITS.maxSettingRows)
+            return;
+        issues.push({
+            code: DEFINITION_ISSUE.limitSettingRows,
+            path: definitionPath(['settings', index, 'max']),
+            message: `a repeatable setting holds at most ${DEFINITION_LIMITS.maxSettingRows} rows`,
+        });
+    });
+    if (definition.settings.length > DEFINITION_LIMITS.maxDefinitionSettings) {
+        issues.push({
+            code: DEFINITION_ISSUE.limitSettings,
+            path: definitionPath(['settings']),
+            message: `a Block Definition holds at most ${DEFINITION_LIMITS.maxDefinitionSettings} settings`,
+        });
+    }
+    if (definition.kind === 'composed') {
+        const shape = composedBodyShape(definition.body);
+        if (shape.nodes > DEFINITION_LIMITS.maxDefinitionNodes) {
+            issues.push({
+                code: DEFINITION_ISSUE.limitNodes,
+                path: definitionPath(['body']),
+                message: `a composed body holds at most ${DEFINITION_LIMITS.maxDefinitionNodes} nodes`,
+            });
+        }
+        if (shape.depth > DEFINITION_LIMITS.maxDefinitionDepth) {
+            issues.push({
+                code: DEFINITION_ISSUE.limitDepth,
+                path: definitionPath(['body']),
+                message: `a composed body nests at most ${DEFINITION_LIMITS.maxDefinitionDepth} levels deep`,
+            });
+        }
+    }
+    if (utf8Length(JSON.stringify(definition)) > DEFINITION_LIMITS.maxDefinitionBytes) {
+        issues.push({
+            code: DEFINITION_ISSUE.limitBytes,
+            path: ROOT,
+            message: `a Block Definition stays under ${DEFINITION_LIMITS.maxDefinitionBytes} bytes`,
+        });
+    }
+    return issues;
+}
+/**
+ * The one validator a Block Definition meets, on the developer's machine and
+ * at the api's door alike. Each step runs only once the one before it found
+ * nothing, so a refusal names one cause.
+ */
+export function definitionIssues(raw) {
+    const body = raw?.body;
+    const named = [
+        ...unknownPrimitivesOf(body).map((found) => ({
+            code: DEFINITION_ISSUE.unknownPrimitive,
+            path: definitionPath(['body', ...found.path, 'primitive']),
+            message: `unknown Primitive "${found.primitive}"`,
+        })),
+        ...unknownSettingTypeIssues(raw),
+    ];
+    if (named.length > 0)
+        return { issues: named };
+    const parsed = parseBlockDefinition(raw);
+    if (!parsed.ok) {
+        return {
+            issues: parsed.issues.map((issue) => ({
+                code: DEFINITION_ISSUE.parse,
+                path: issue.path === '(root)' ? ROOT : `${ROOT}.${issue.path}`,
+                message: issue.message,
+            })),
+        };
+    }
+    const definition = parsed.value;
+    if (definition.kind === 'composed') {
+        for (const step of [referenceIssues, conditionIssues, repeaterIssues]) {
+            const issues = step(definition);
+            if (issues.length > 0)
+                return { issues };
+        }
+    }
+    const limits = limitIssues(definition);
+    if (limits.length > 0)
+        return { issues: limits };
+    return { issues: [], definition };
+}
+//# sourceMappingURL=definition-validator.js.map

package/dist/definition-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-validator.js","sourceRoot":"","sources":["../src/definition-validator.ts"],"names":[],"mappings":"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"}

package/dist/display.d.ts

@@ -0,0 +1,139 @@
+import { z } from 'zod';
+/**
+ * Display-only money: a ready-to-render string plus its currency code.
+ * Strict by construction — there is no numeric amount to compute with, and
+ * the charged price always comes from Shopify checkout.
+ */
+export declare const displayMoneySchema: z.ZodObject<{
+    formatted: z.ZodString;
+    currencyCode: z.ZodString;
+}, z.core.$strict>;
+export declare const displayImageSchema: z.ZodObject<{
+    url: z.ZodURL;
+    altText: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/** One choice a buyer makes on a product, and what it offers. */
+export declare const productOptionSchema: z.ZodObject<{
+    name: z.ZodString;
+    values: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * One purchasable variant of a product: the id a cart line names, the values
+ * that select it, and whether it can be bought right now.
+ */
+export declare const productVariantSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    selectedOptions: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strict>>;
+    available: z.ZodBoolean;
+}, z.core.$strict>;
+/**
+ * The flat shapes renderers consume and every Provider must produce.
+ * Renderers never see raw Storefront responses. The detail fields below the
+ * card set are optional: a Provider fills them only where a whole product is
+ * asked for, so a grid of twenty-four cards stays as light as it was.
+ */
+export declare const productDisplaySchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    handle: z.ZodString;
+    image: z.ZodOptional<z.ZodObject<{
+        url: z.ZodURL;
+        altText: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    price: z.ZodObject<{
+        formatted: z.ZodString;
+        currencyCode: z.ZodString;
+    }, z.core.$strict>;
+    compareAtPrice: z.ZodOptional<z.ZodObject<{
+        formatted: z.ZodString;
+        currencyCode: z.ZodString;
+    }, z.core.$strict>>;
+    available: z.ZodBoolean;
+    images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodURL;
+        altText: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    description: z.ZodOptional<z.ZodString>;
+    vendor: z.ZodOptional<z.ZodString>;
+    productType: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        values: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>;
+    variants: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        selectedOptions: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strict>>;
+        available: z.ZodBoolean;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const collectionDisplaySchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    handle: z.ZodString;
+    image: z.ZodOptional<z.ZodObject<{
+        url: z.ZodURL;
+        altText: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type DisplayMoney = z.infer<typeof displayMoneySchema>;
+export type DisplayImage = z.infer<typeof displayImageSchema>;
+export type ProductOption = z.infer<typeof productOptionSchema>;
+export type ProductVariantDisplay = z.infer<typeof productVariantSchema>;
+export type ProductDisplay = z.infer<typeof productDisplaySchema>;
+export type CollectionDisplay = z.infer<typeof collectionDisplaySchema>;
+/**
+ * What one Binding resolves to, by kind. A missing entity is an empty shape,
+ * null or an empty list, so a renderer collapses the block instead of erroring.
+ */
+export type BindingData = {
+    readonly kind: 'product';
+    readonly product: ProductDisplay | null;
+} | {
+    readonly kind: 'products';
+    readonly products: readonly ProductDisplay[];
+} | {
+    readonly kind: 'collection';
+    readonly collection: CollectionDisplay | null;
+} | {
+    readonly kind: 'collections';
+    readonly collections: readonly CollectionDisplay[];
+};
+/** One entry of what a Binding resolved to: what a repeater draws once per item. */
+export type BoundItem = ProductDisplay | CollectionDisplay;
+/**
+ * The Binding's items in order, whatever its kind. A single-entity Binding
+ * that resolved to nothing is an empty list, the same as an empty one, so a
+ * repeater has one rule to follow.
+ */
+export declare function bindingItems(data: BindingData | null | undefined): readonly BoundItem[];
+/**
+ * One text field off the current item, already in the buyer's language. A
+ * field the item does not carry — a collection has no vendor — reads as
+ * nothing, and the node that asked for it draws nothing.
+ */
+export declare function itemText(item: BoundItem, field: string): string | undefined;
+export declare function itemImage(item: BoundItem): DisplayImage | undefined;
+/** Whether the current item can be bought; undefined for an item that is not a product. */
+export declare function itemAvailable(item: BoundItem): boolean | undefined;
+/** The current item's price as the Provider formatted it; undefined for a collection. */
+export declare function itemPrice(item: BoundItem): {
+    price: DisplayMoney;
+    compareAtPrice?: DisplayMoney;
+} | undefined;
+//# sourceMappingURL=display.d.ts.map

package/dist/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../src/display.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;kBAG7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;kBAK7B,CAAC;AAEH,iEAAiE;AACjE,eAAO,MAAM,mBAAmB;;;kBAG9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;kBAK/B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAc/B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;kBAKlC,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACzE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE,GACrE;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,GAC3E;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAAE,GAC9E;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAAE,CAAC;AAEzF,oFAAoF;AACpF,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,iBAAiB,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,SAAS,EAAE,CAYvF;AAMD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAe3E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAEnE;AAED,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAElE;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CACvB,IAAI,EAAE,SAAS,GACd;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,cAAc,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG,SAAS,CAMpE"}

package/dist/display.js

@@ -0,0 +1,118 @@
+import { z } from 'zod';
+/**
+ * Display-only money: a ready-to-render string plus its currency code.
+ * Strict by construction — there is no numeric amount to compute with, and
+ * the charged price always comes from Shopify checkout.
+ */
+export const displayMoneySchema = z.strictObject({
+    formatted: z.string().min(1),
+    currencyCode: z.string().regex(/^[A-Z]{3}$/, 'expected an ISO 4217 currency code'),
+});
+export const displayImageSchema = z.strictObject({
+    url: z.url(),
+    altText: z.string().optional(),
+    width: z.number().int().positive().optional(),
+    height: z.number().int().positive().optional(),
+});
+/** One choice a buyer makes on a product, and what it offers. */
+export const productOptionSchema = z.strictObject({
+    name: z.string().min(1),
+    values: z.array(z.string().min(1)).min(1),
+});
+/**
+ * One purchasable variant of a product: the id a cart line names, the values
+ * that select it, and whether it can be bought right now.
+ */
+export const productVariantSchema = z.strictObject({
+    id: z.string().min(1),
+    title: z.string(),
+    selectedOptions: z.array(z.strictObject({ name: z.string().min(1), value: z.string().min(1) })),
+    available: z.boolean(),
+});
+/**
+ * The flat shapes renderers consume and every Provider must produce.
+ * Renderers never see raw Storefront responses. The detail fields below the
+ * card set are optional: a Provider fills them only where a whole product is
+ * asked for, so a grid of twenty-four cards stays as light as it was.
+ */
+export const productDisplaySchema = z.strictObject({
+    id: z.string().min(1),
+    title: z.string(),
+    handle: z.string().min(1),
+    image: displayImageSchema.optional(),
+    price: displayMoneySchema,
+    compareAtPrice: displayMoneySchema.optional(),
+    available: z.boolean(),
+    images: z.array(displayImageSchema).optional(),
+    description: z.string().optional(),
+    vendor: z.string().optional(),
+    productType: z.string().optional(),
+    options: z.array(productOptionSchema).optional(),
+    variants: z.array(productVariantSchema).optional(),
+});
+export const collectionDisplaySchema = z.strictObject({
+    id: z.string().min(1),
+    title: z.string(),
+    handle: z.string().min(1),
+    image: displayImageSchema.optional(),
+});
+/**
+ * The Binding's items in order, whatever its kind. A single-entity Binding
+ * that resolved to nothing is an empty list, the same as an empty one, so a
+ * repeater has one rule to follow.
+ */
+export function bindingItems(data) {
+    if (data === null || data === undefined)
+        return [];
+    switch (data.kind) {
+        case 'product':
+            return data.product === null ? [] : [data.product];
+        case 'products':
+            return data.products;
+        case 'collection':
+            return data.collection === null ? [] : [data.collection];
+        case 'collections':
+            return data.collections;
+    }
+}
+function asProduct(item) {
+    return 'price' in item ? item : undefined;
+}
+/**
+ * One text field off the current item, already in the buyer's language. A
+ * field the item does not carry — a collection has no vendor — reads as
+ * nothing, and the node that asked for it draws nothing.
+ */
+export function itemText(item, field) {
+    switch (field) {
+        case 'title':
+            return item.title;
+        case 'handle':
+            return item.handle;
+        case 'vendor':
+            return asProduct(item)?.vendor;
+        case 'product_type':
+            return asProduct(item)?.productType;
+        case 'description':
+            return asProduct(item)?.description;
+        default:
+            return undefined;
+    }
+}
+export function itemImage(item) {
+    return item.image;
+}
+/** Whether the current item can be bought; undefined for an item that is not a product. */
+export function itemAvailable(item) {
+    return asProduct(item)?.available;
+}
+/** The current item's price as the Provider formatted it; undefined for a collection. */
+export function itemPrice(item) {
+    const product = asProduct(item);
+    if (product === undefined)
+        return undefined;
+    return product.compareAtPrice === undefined
+        ? { price: product.price }
+        : { price: product.price, compareAtPrice: product.compareAtPrice };
+}
+//# sourceMappingURL=display.js.map

package/dist/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../src/display.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,YAAY,CAAC;IAC/C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,oCAAoC,CAAC;CACnF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,YAAY,CAAC;IAC/C,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE;IACZ,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC/C,CAAC,CAAC;AAEH,iEAAiE;AACjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,YAAY,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1C,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,YAAY,CAAC;IACjD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/F,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;CACvB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,YAAY,CAAC;IACjD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,KAAK,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACpC,KAAK,EAAE,kBAAkB;IACzB,cAAc,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IAC7C,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE;IAC9C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE;IAChD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,YAAY,CAAC;IACpD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,KAAK,EAAE,kBAAkB,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAsBH;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAoC;IAC/D,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrD,KAAK,UAAU;YACb,OAAO,IAAI,CAAC,QAAQ,CAAC;QACvB,KAAK,YAAY;YACf,OAAO,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3D,KAAK,aAAa;YAChB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAe;IAChC,OAAO,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAe,EAAE,KAAa;IACrD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACjC,KAAK,cAAc;YACjB,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;QACtC,KAAK,aAAa;YAChB,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;QACtC;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAe;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC;AACpB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,aAAa,CAAC,IAAe;IAC3C,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;AACpC,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,SAAS,CACvB,IAAe;IAEf,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,OAAO,OAAO,CAAC,cAAc,KAAK,SAAS;QACzC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;QAC1B,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;AACvE,CAAC"}