@shoplix-ai/sdui-schema 1.0.0

package/dist/primitives.d.ts.map

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

package/dist/primitives.js

@@ -0,0 +1,631 @@
+import { z } from 'zod';
+import { actionSchema } from './action.js';
+import { ICON_NAMES } from './icons.js';
+import { localeCodeSchema, localizedTextSchema } from './locale.js';
+import { SEMANTIC_TOKENS } from './tokens.js';
+/** The closed vocabulary a Composed Block may use. */
+export const PRIMITIVE_TYPES = [
+    'stack',
+    'row',
+    'grid',
+    'spacer',
+    'divider',
+    'text',
+    'image',
+    'icon',
+    'badge',
+    'button',
+    'repeater',
+    'price',
+    'availability',
+];
+export const SETTING_KEY_PATTERN = /^[a-z][a-z0-9_]{0,63}$/;
+export const settingKeySchema = z
+    .string()
+    .regex(SETTING_KEY_PATTERN, 'expected a setting key of lowercase letters, digits and underscores');
+export const HEX_COLOR_PATTERN = /^#(?:[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+export const hexColorSchema = z
+    .string()
+    .regex(HEX_COLOR_PATTERN, 'expected "#rrggbb" or "#rrggbbaa"');
+/** A reference to one of the Shop's semantic token roles, by role name. */
+export const tokenReferenceSchema = z.strictObject({ token: z.string().min(1).max(64) });
+/** The fields of the repeater's current item a text value may read. */
+export const ITEM_TEXT_FIELDS = [
+    'title',
+    'handle',
+    'vendor',
+    'product_type',
+    'description',
+];
+/** The one field of the current item an image value may read. */
+export const ITEM_IMAGE_FIELD = 'image';
+function valueOf(literal, forms) {
+    const variants = [z.strictObject({ literal })];
+    if (forms.setting)
+        variants.push(z.strictObject({ setting: settingKeySchema }));
+    if (forms.token)
+        variants.push(tokenReferenceSchema);
+    if (forms.item)
+        variants.push(z.strictObject({ item: z.enum(forms.item) }));
+    return z.union(variants);
+}
+const dimensionValue = valueOf(z.number().min(0).max(1000), { setting: true, token: true });
+const colorValue = valueOf(hexColorSchema, { setting: true, token: true });
+const textValue = valueOf(localizedTextSchema, {
+    setting: true,
+    token: false,
+    item: ITEM_TEXT_FIELDS,
+});
+const booleanValue = valueOf(z.boolean(), { setting: true, token: false });
+const numberValue = valueOf(z.number().positive().max(100), { setting: true, token: false });
+const countValue = valueOf(z.int().min(1).max(24), { setting: true, token: false });
+const assetValue = valueOf(z.uuid(), { setting: true, token: false, item: [ITEM_IMAGE_FIELD] });
+const actionValue = valueOf(actionSchema, { setting: true, token: false });
+const enumValue = (values) => valueOf(z.enum(values), { setting: true, token: false });
+/**
+ * "show when" on any node: one member of a closed condition union, never an
+ * expression. A node whose condition is false draws nothing, and neither do
+ * its children.
+ */
+export const SHOW_WHEN_CONDITIONS = [
+    'setting_on',
+    'item_has_image',
+    'item_available',
+    'language_is',
+];
+export const showWhenSchema = z.discriminatedUnion('condition', [
+    z.strictObject({ condition: z.literal('setting_on'), setting: settingKeySchema }),
+    z.strictObject({ condition: z.literal('item_has_image') }),
+    z.strictObject({ condition: z.literal('item_available') }),
+    z.strictObject({ condition: z.literal('language_is'), language: localeCodeSchema }),
+]);
+/** The two conditions that read the repeater's current item. */
+export function readsItem(condition) {
+    return condition.condition === 'item_has_image' || condition.condition === 'item_available';
+}
+export const LAYOUT_ALIGNMENTS = ['start', 'center', 'end', 'stretch'];
+export const TEXT_SIZES = ['sm', 'md', 'lg', 'xl'];
+export const TEXT_WEIGHTS = ['regular', 'medium', 'bold'];
+export const TEXT_ALIGNMENTS = ['start', 'center', 'end'];
+export const IMAGE_SHAPES = ['square', 'rounded', 'circle'];
+/** How many columns a grid lays out; named as text so a select setting can feed it. */
+export const GRID_COLUMNS = ['2', '3'];
+export const BUTTON_STYLES = ['solid', 'outline', 'ghost'];
+const borderSchema = z.strictObject({ width: dimensionValue, color: colorValue });
+/** Padding, gap, alignment, background, radius and border: what every layout Primitive takes. */
+const layoutAttributes = {
+    padding: dimensionValue.optional(),
+    gap: dimensionValue.optional(),
+    width: dimensionValue.optional(),
+    align: enumValue(LAYOUT_ALIGNMENTS).optional(),
+    background: colorValue.optional(),
+    radius: dimensionValue.optional(),
+    border: borderSchema.optional(),
+    when: showWhenSchema.optional(),
+};
+const textStyleAttributes = {
+    size: enumValue(TEXT_SIZES).optional(),
+    weight: enumValue(TEXT_WEIGHTS).optional(),
+    align: enumValue(TEXT_ALIGNMENTS).optional(),
+    color: colorValue.optional(),
+};
+/** A row may run off the side; with snap on, each child settles under the finger. */
+const rowAttributes = {
+    ...layoutAttributes,
+    scroll: booleanValue.optional(),
+    snap: booleanValue.optional(),
+};
+const gridAttributes = {
+    ...layoutAttributes,
+    columns: enumValue(GRID_COLUMNS).optional(),
+};
+export const spacerPrimitiveSchema = z.strictObject({
+    primitive: z.literal('spacer'),
+    size: dimensionValue.optional(),
+    when: showWhenSchema.optional(),
+});
+/** A hairline across the parent's width; thickness and color, nothing else. */
+export const dividerPrimitiveSchema = z.strictObject({
+    primitive: z.literal('divider'),
+    thickness: dimensionValue.optional(),
+    color: colorValue.optional(),
+    when: showWhenSchema.optional(),
+});
+/** One glyph out of the app's icon set, sized and tinted like the text beside it. */
+export const iconPrimitiveSchema = z.strictObject({
+    primitive: z.literal('icon'),
+    name: enumValue(ICON_NAMES),
+    size: dimensionValue.optional(),
+    color: colorValue.optional(),
+    when: showWhenSchema.optional(),
+});
+/** Text over a background: the small pill a card carries for "new" or "-20%". */
+export const badgePrimitiveSchema = z.strictObject({
+    primitive: z.literal('badge'),
+    text: textValue,
+    ...textStyleAttributes,
+    uppercase: booleanValue.optional(),
+    background: colorValue.optional(),
+    padding: dimensionValue.optional(),
+    radius: dimensionValue.optional(),
+    when: showWhenSchema.optional(),
+});
+/**
+ * A label the buyer taps, dressed from the Shop's tokens, carrying one member
+ * of the closed action set. The runtime hands the action to the same router a
+ * platform block's action goes through, so a button opens a screen, the cart
+ * or a link and nothing else.
+ */
+export const buttonPrimitiveSchema = z.strictObject({
+    primitive: z.literal('button'),
+    label: textValue,
+    action: actionValue,
+    style: enumValue(BUTTON_STYLES).optional(),
+    size: enumValue(TEXT_SIZES).optional(),
+    background: colorValue.optional(),
+    color: colorValue.optional(),
+    padding: dimensionValue.optional(),
+    radius: dimensionValue.optional(),
+    when: showWhenSchema.optional(),
+});
+export const textPrimitiveSchema = z.strictObject({
+    primitive: z.literal('text'),
+    text: textValue,
+    ...textStyleAttributes,
+    uppercase: booleanValue.optional(),
+    when: showWhenSchema.optional(),
+});
+export const imagePrimitiveSchema = z.strictObject({
+    primitive: z.literal('image'),
+    asset: assetValue,
+    shape: enumValue(IMAGE_SHAPES).optional(),
+    aspectRatio: numberValue.optional(),
+    when: showWhenSchema.optional(),
+});
+/**
+ * The current item's price as the Provider formatted it, in the buyer's
+ * country and language. The compare-at price rides alongside when the item
+ * carries one and the body asks for it.
+ */
+export const pricePrimitiveSchema = z.strictObject({
+    primitive: z.literal('price'),
+    ...textStyleAttributes,
+    compareAt: booleanValue.optional(),
+    compareAtColor: colorValue.optional(),
+    when: showWhenSchema.optional(),
+});
+/**
+ * The current item's availability as a label the definition supplies in
+ * every language; the runtime picks which of the two to draw.
+ */
+export const availabilityPrimitiveSchema = z.strictObject({
+    primitive: z.literal('availability'),
+    inStock: textValue,
+    soldOut: textValue,
+    ...textStyleAttributes,
+    soldOutColor: colorValue.optional(),
+    when: showWhenSchema.optional(),
+});
+const repeaterAttributes = {
+    limit: countValue.optional(),
+    when: showWhenSchema.optional(),
+};
+const stackPrimitiveSchema = z.lazy(() => z.strictObject({
+    primitive: z.literal('stack'),
+    ...layoutAttributes,
+    children: z.array(primitiveNodeSchema),
+}));
+const rowPrimitiveSchema = z.lazy(() => z.strictObject({
+    primitive: z.literal('row'),
+    ...rowAttributes,
+    children: z.array(primitiveNodeSchema),
+}));
+const gridPrimitiveSchema = z.lazy(() => z.strictObject({
+    primitive: z.literal('grid'),
+    ...gridAttributes,
+    children: z.array(primitiveNodeSchema),
+}));
+const repeaterPrimitiveSchema = z.lazy(() => z.strictObject({
+    primitive: z.literal('repeater'),
+    ...repeaterAttributes,
+    children: z.array(primitiveNodeSchema),
+    empty: z.array(primitiveNodeSchema).optional(),
+}));
+/**
+ * Discriminated on the `primitive` tag so later vocabulary is one more member,
+ * never a rewrite. A tag outside the vocabulary is refused at parse.
+ */
+export const primitiveNodeSchema = z.lazy(() => z.discriminatedUnion('primitive', [
+    stackPrimitiveSchema,
+    rowPrimitiveSchema,
+    gridPrimitiveSchema,
+    repeaterPrimitiveSchema,
+    spacerPrimitiveSchema,
+    dividerPrimitiveSchema,
+    textPrimitiveSchema,
+    imagePrimitiveSchema,
+    iconPrimitiveSchema,
+    badgePrimitiveSchema,
+    buttonPrimitiveSchema,
+    pricePrimitiveSchema,
+    availabilityPrimitiveSchema,
+]));
+const KNOWN_PRIMITIVES = new Set(PRIMITIVE_TYPES);
+const envelopeChildrenSchema = z.lazy(() => z.array(envelopePrimitiveNodeSchema));
+const envelopeStackPrimitiveSchema = z.strictObject({
+    primitive: z.literal('stack'),
+    ...layoutAttributes,
+    children: envelopeChildrenSchema,
+});
+const envelopeRowPrimitiveSchema = z.strictObject({
+    primitive: z.literal('row'),
+    ...rowAttributes,
+    children: envelopeChildrenSchema,
+});
+const envelopeGridPrimitiveSchema = z.strictObject({
+    primitive: z.literal('grid'),
+    ...gridAttributes,
+    children: envelopeChildrenSchema,
+});
+const envelopeRepeaterPrimitiveSchema = z.strictObject({
+    primitive: z.literal('repeater'),
+    ...repeaterAttributes,
+    children: envelopeChildrenSchema,
+    empty: envelopeChildrenSchema.optional(),
+});
+const unlistedPrimitiveNodeSchema = z.looseObject({ primitive: z.string().min(1).max(64) });
+const ENVELOPE_NODE_SCHEMAS = {
+    stack: envelopeStackPrimitiveSchema,
+    row: envelopeRowPrimitiveSchema,
+    grid: envelopeGridPrimitiveSchema,
+    repeater: envelopeRepeaterPrimitiveSchema,
+    spacer: spacerPrimitiveSchema,
+    divider: dividerPrimitiveSchema,
+    text: textPrimitiveSchema,
+    image: imagePrimitiveSchema,
+    icon: iconPrimitiveSchema,
+    badge: badgePrimitiveSchema,
+    button: buttonPrimitiveSchema,
+    price: pricePrimitiveSchema,
+    availability: availabilityPrimitiveSchema,
+};
+/**
+ * Known tags parse strictly; an unknown tag falls back to the tolerant shape.
+ * A malformed known node never slips through as unknown.
+ */
+export const envelopePrimitiveNodeSchema = z
+    .unknown()
+    .transform((value, ctx) => {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        ctx.addIssue({ code: 'custom', message: 'expected a Primitive node' });
+        return z.NEVER;
+    }
+    const tag = value.primitive;
+    const schema = typeof tag === 'string' && KNOWN_PRIMITIVES.has(tag)
+        ? ENVELOPE_NODE_SCHEMAS[tag]
+        : unlistedPrimitiveNodeSchema;
+    const parsed = schema.safeParse(value);
+    if (!parsed.success) {
+        for (const issue of parsed.error.issues) {
+            ctx.addIssue({ code: 'custom', message: issue.message, path: [...issue.path] });
+        }
+        return z.NEVER;
+    }
+    return parsed.data;
+});
+export function isListedPrimitive(tag) {
+    return KNOWN_PRIMITIVES.has(tag);
+}
+/** The two slots a node holds other nodes in; both walk the same way. */
+const CHILD_SLOTS = ['children', 'empty'];
+/** Which slots each Primitive holds other nodes in; a leaf holds none. */
+export const PRIMITIVE_CHILD_SLOTS = {
+    stack: ['children'],
+    row: ['children'],
+    grid: ['children'],
+    repeater: ['children', 'empty'],
+    spacer: [],
+    divider: [],
+    text: [],
+    image: [],
+    icon: [],
+    badge: [],
+    button: [],
+    price: [],
+    availability: [],
+};
+function childNodesOf(node) {
+    const found = [];
+    for (const slot of CHILD_SLOTS) {
+        const nodes = node[slot];
+        if (Array.isArray(nodes)) {
+            nodes.forEach((child, index) => found.push({ slot, index, node: child }));
+        }
+    }
+    return found;
+}
+/**
+ * Every node whose tag is outside the vocabulary, walked over the raw body
+ * before any parse so the refusal can name the tag and where it sits.
+ */
+export function unknownPrimitivesOf(body) {
+    const found = [];
+    const walk = (node, path) => {
+        if (typeof node !== 'object' || node === null || Array.isArray(node))
+            return;
+        const tag = node.primitive;
+        if (typeof tag === 'string' && !KNOWN_PRIMITIVES.has(tag)) {
+            found.push({ path, primitive: tag });
+        }
+        for (const child of childNodesOf(node)) {
+            walk(child.node, [...path, child.slot, child.index]);
+        }
+    };
+    walk(body, []);
+    return found;
+}
+const SLOT_OF = {
+    padding: 'dimension',
+    gap: 'dimension',
+    radius: 'dimension',
+    size: 'dimension',
+    width: 'dimension',
+    thickness: 'dimension',
+    background: 'color',
+    color: 'color',
+    compareAtColor: 'color',
+    soldOutColor: 'color',
+    text: 'text',
+    label: 'text',
+    inStock: 'text',
+    soldOut: 'text',
+    uppercase: 'boolean',
+    compareAt: 'boolean',
+    scroll: 'boolean',
+    snap: 'boolean',
+    align: 'enum',
+    weight: 'enum',
+    shape: 'enum',
+    columns: 'enum',
+    style: 'enum',
+    name: 'enum',
+    aspectRatio: 'number',
+    limit: 'count',
+    asset: 'asset',
+    action: 'action',
+};
+/** The Primitives styled like text; their `size` and `align` are the text ones. */
+const TEXT_STYLED = new Set([
+    'text',
+    'price',
+    'availability',
+    'badge',
+    'button',
+]);
+/** The text Primitive's `size` is an enum; the spacer's is a dimension. */
+function slotFor(node, attribute) {
+    if (attribute === 'size' && TEXT_STYLED.has(node.primitive))
+        return 'enum';
+    return SLOT_OF[attribute] ?? 'enum';
+}
+function isReference(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    return 'setting' in value || 'token' in value;
+}
+function itemFieldOf(value) {
+    if (typeof value !== 'object' || value === null || !('item' in value))
+        return undefined;
+    const field = value.item;
+    return typeof field === 'string' ? field : undefined;
+}
+/**
+ * One pass over the body, carrying whether a repeater stands above each node.
+ * A repeater's `empty` slot is outside its own item scope: there is no
+ * current item when the Binding resolved to nothing.
+ */
+function walkBody(body, visit) {
+    const walk = (node, state) => {
+        visit(node, state);
+        const under = state.underRepeater || node.primitive === 'repeater';
+        const item = state.inRepeater || node.primitive === 'repeater';
+        for (const child of childNodesOf(node)) {
+            walk(child.node, {
+                path: [...state.path, child.slot, child.index],
+                inRepeater: child.slot === 'empty' ? false : item,
+                underRepeater: under,
+            });
+        }
+    };
+    walk(body, { path: [], inRepeater: false, underRepeater: false });
+}
+/** Every setting and token the body reads, with the slot each feeds. */
+export function composedBodyReferences(body) {
+    const found = [];
+    walkBody(body, (node, position) => {
+        for (const [attribute, value] of Object.entries(node)) {
+            if (attribute === 'primitive' || attribute === 'when')
+                continue;
+            if (CHILD_SLOTS.includes(attribute))
+                continue;
+            if (attribute === 'border' && typeof value === 'object' && value !== null) {
+                for (const [part, partValue] of Object.entries(value)) {
+                    if (isReference(partValue)) {
+                        found.push({
+                            path: [...position.path, 'border', part],
+                            inRepeater: position.inRepeater,
+                            reference: partValue,
+                            slot: slotFor(node, part),
+                        });
+                    }
+                }
+                continue;
+            }
+            if (isReference(value)) {
+                found.push({
+                    path: [...position.path, attribute],
+                    inRepeater: position.inRepeater,
+                    reference: value,
+                    slot: slotFor(node, attribute),
+                });
+            }
+        }
+    });
+    return found;
+}
+/**
+ * Every place the body reads the repeater's current item: a value naming one
+ * of its fields, a commerce leaf, or a condition asking about it.
+ */
+export function composedBodyItemUses(body) {
+    const found = [];
+    walkBody(body, (node, position) => {
+        if (node.primitive === 'price' || node.primitive === 'availability') {
+            found.push({
+                path: position.path,
+                inRepeater: position.inRepeater,
+                use: `the ${node.primitive} Primitive`,
+            });
+        }
+        if (node.when !== undefined && readsItem(node.when)) {
+            found.push({
+                path: [...position.path, 'when'],
+                inRepeater: position.inRepeater,
+                use: `the "${node.when.condition}" condition`,
+            });
+        }
+        for (const [attribute, value] of Object.entries(node)) {
+            if (attribute === 'when')
+                continue;
+            const field = itemFieldOf(value);
+            if (field !== undefined) {
+                found.push({
+                    path: [...position.path, attribute],
+                    inRepeater: position.inRepeater,
+                    use: `the item's "${field}"`,
+                });
+            }
+        }
+    });
+    return found;
+}
+/** Every "show when" the body carries, with where it sits. */
+export function composedBodyConditions(body) {
+    const found = [];
+    walkBody(body, (node, position) => {
+        if (node.when === undefined)
+            return;
+        found.push({
+            path: [...position.path, 'when'],
+            inRepeater: position.inRepeater,
+            condition: node.when,
+        });
+    });
+    return found;
+}
+/** Every repeater the body carries; `nested` marks one standing inside another. */
+export function composedBodyRepeaters(body) {
+    const found = [];
+    walkBody(body, (node, state) => {
+        if (node.primitive !== 'repeater')
+            return;
+        found.push({
+            path: state.path,
+            inRepeater: state.inRepeater,
+            nested: state.underRepeater,
+        });
+    });
+    return found;
+}
+/** The options an enum slot accepts, for a select setting bound to it. */
+export function enumSlotValues(node, attribute) {
+    const textStyled = TEXT_STYLED.has(node.primitive);
+    if (attribute === 'align')
+        return textStyled ? TEXT_ALIGNMENTS : LAYOUT_ALIGNMENTS;
+    if (attribute === 'weight')
+        return TEXT_WEIGHTS;
+    if (attribute === 'shape')
+        return IMAGE_SHAPES;
+    if (attribute === 'columns')
+        return GRID_COLUMNS;
+    if (attribute === 'style')
+        return BUTTON_STYLES;
+    if (attribute === 'name')
+        return ICON_NAMES;
+    if (attribute === 'size' && textStyled)
+        return TEXT_SIZES;
+    return null;
+}
+/** Every asset the body names outright, with the path of the attribute naming it. */
+export function composedBodyAssetReferences(body) {
+    const found = [];
+    const walk = (node, path) => {
+        if (typeof node !== 'object' || node === null || Array.isArray(node))
+            return;
+        const asset = node.asset;
+        if (typeof asset === 'object' && asset !== null && 'literal' in asset) {
+            const id = asset.literal;
+            if (typeof id === 'string')
+                found.push({ assetId: id, path: [...path, 'asset'] });
+        }
+        for (const child of childNodesOf(node))
+            walk(child.node, [...path, child.slot, child.index]);
+    };
+    walk(body, []);
+    return found;
+}
+export function composedBodyAssetIds(body) {
+    return composedBodyAssetReferences(body).map((reference) => reference.assetId);
+}
+export function composedBodyShape(body) {
+    let nodes = 0;
+    let depth = 0;
+    const walk = (node, level) => {
+        nodes += 1;
+        if (level > depth)
+            depth = level;
+        for (const child of childNodesOf(node))
+            walk(child.node, level + 1);
+    };
+    walk(body, 1);
+    return { nodes, depth };
+}
+/** The node at a body path, for a caller holding a reference's path. */
+export function nodeAtBodyPath(body, path) {
+    let node = body;
+    for (let i = 0; i < path.length; i += 1) {
+        const slot = path[i];
+        if (typeof slot !== 'string' || !CHILD_SLOTS.includes(slot))
+            break;
+        const index = path[i + 1];
+        const children = node[slot];
+        if (typeof index !== 'number' || !Array.isArray(children))
+            return undefined;
+        const child = children[index];
+        if (child === undefined)
+            return undefined;
+        node = child;
+        i += 1;
+    }
+    return node;
+}
+export function isTokenRole(role) {
+    return Object.prototype.hasOwnProperty.call(SEMANTIC_TOKENS, role);
+}
+/** One role's value off a resolved theme style; undefined for a role that is not one. */
+export function tokenRoleValue(style, role) {
+    if (!isTokenRole(role))
+        return undefined;
+    switch (role) {
+        case 'heading':
+        case 'body':
+            return style.fonts[role];
+        case 'radius':
+            return style.radius;
+        case 'spacing':
+            return style.spacing;
+        default:
+            return style.colors[role];
+    }
+}
+//# sourceMappingURL=primitives.js.map