@shoplix-ai/sdui-schema 1.0.0

package/dist/theme.js

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+import { SCHEMA_VERSION } from './version.js';
+import { localizedTextSchema } from './locale.js';
+import { themeTokensSchema } from './tokens.js';
+import { screenDocumentSchema } from './screen.js';
+/** How many tabs a tab bar holds; the same number the api and the editor enforce. */
+export const NAVIGATION_TAB_LIMITS = { min: 1, max: 5 };
+const navigationTabSchema = z.object({
+    screenId: z.uuid(),
+    label: localizedTextSchema,
+    icon: z.string().min(1).max(64),
+});
+export const navigationSchema = z.object({
+    tabs: z.array(navigationTabSchema).min(NAVIGATION_TAB_LIMITS.min).max(NAVIGATION_TAB_LIMITS.max),
+});
+export const themeDocumentSchema = z
+    .object({
+    schemaVersion: z.literal(SCHEMA_VERSION),
+    name: z.string().min(1).max(120),
+    tokens: themeTokensSchema,
+    navigation: navigationSchema,
+    screens: z.array(screenDocumentSchema).min(1),
+})
+    .superRefine((theme, ctx) => {
+    const screenIds = new Set();
+    const systemKinds = new Set();
+    const slugs = new Set();
+    theme.screens.forEach((screen, index) => {
+        if (screenIds.has(screen.id)) {
+            ctx.addIssue({
+                code: 'custom',
+                message: `duplicate screen id "${screen.id}"`,
+                path: ['screens', index, 'id'],
+            });
+        }
+        screenIds.add(screen.id);
+        if (screen.kind !== 'custom') {
+            if (systemKinds.has(screen.kind)) {
+                ctx.addIssue({
+                    code: 'custom',
+                    message: `a theme holds one "${screen.kind}" screen`,
+                    path: ['screens', index, 'kind'],
+                });
+            }
+            systemKinds.add(screen.kind);
+        }
+        if (screen.slug !== undefined) {
+            if (slugs.has(screen.slug)) {
+                ctx.addIssue({
+                    code: 'custom',
+                    message: `duplicate screen slug "${screen.slug}"`,
+                    path: ['screens', index, 'slug'],
+                });
+            }
+            slugs.add(screen.slug);
+        }
+    });
+    theme.navigation.tabs.forEach((tab, index) => {
+        if (!screenIds.has(tab.screenId)) {
+            ctx.addIssue({
+                code: 'custom',
+                message: 'tab targets a screen that is not in the theme',
+                path: ['navigation', 'tabs', index, 'screenId'],
+            });
+        }
+    });
+});
+//# sourceMappingURL=theme.js.map

package/dist/theme.js.map

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

package/dist/tokens.d.ts

@@ -0,0 +1,115 @@
+import { z } from 'zod';
+export declare const TOKEN_TYPES: readonly ["color", "dimension", "fontFamily", "fontWeight", "number"];
+export type TokenType = (typeof TOKEN_TYPES)[number];
+export interface DimensionValue {
+    value: number;
+    unit: 'px';
+}
+export type TokenValue = string | number | DimensionValue;
+/** DTCG leaf shape: `$value` plus `$type`, aliases as `{group.path}` strings. */
+export interface TokenLeaf {
+    $type: TokenType;
+    $value: TokenValue;
+}
+export type TokenGroup = {
+    [name: string]: TokenLeaf | TokenGroup;
+};
+/** Three tiers: raw palette, semantic roles, per-component overrides. */
+export interface ThemeTokens {
+    palette: TokenGroup;
+    semantic: TokenGroup;
+    component: TokenGroup;
+}
+export declare const themeTokensSchema: z.ZodObject<{
+    palette: z.ZodType<TokenGroup, unknown, z.core.$ZodTypeInternals<TokenGroup, unknown>>;
+    semantic: z.ZodType<TokenGroup, unknown, z.core.$ZodTypeInternals<TokenGroup, unknown>>;
+    component: z.ZodType<TokenGroup, unknown, z.core.$ZodTypeInternals<TokenGroup, unknown>>;
+}, z.core.$strip>;
+/**
+ * The semantic roles a merchant edits and every renderer reads. Each role
+ * names the palette leaf it reads by default and writes through, so one edit
+ * of "accent" moves every token aliased to it rather than one control.
+ */
+export interface SemanticTokenSpec {
+    readonly type: TokenType;
+    readonly palettePath: string;
+}
+export declare const SEMANTIC_TOKENS: {
+    readonly brand: {
+        readonly type: "color";
+        readonly palettePath: "palette.brand.primary";
+    };
+    readonly accent: {
+        readonly type: "color";
+        readonly palettePath: "palette.brand.accent";
+    };
+    readonly action: {
+        readonly type: "color";
+        readonly palettePath: "palette.brand.accent";
+    };
+    readonly surface: {
+        readonly type: "color";
+        readonly palettePath: "palette.neutral.background";
+    };
+    readonly elevated: {
+        readonly type: "color";
+        readonly palettePath: "palette.neutral.surface";
+    };
+    readonly text: {
+        readonly type: "color";
+        readonly palettePath: "palette.neutral.text";
+    };
+    readonly muted: {
+        readonly type: "color";
+        readonly palettePath: "palette.neutral.muted";
+    };
+    readonly heading: {
+        readonly type: "fontFamily";
+        readonly palettePath: "palette.typeface.heading";
+    };
+    readonly body: {
+        readonly type: "fontFamily";
+        readonly palettePath: "palette.typeface.body";
+    };
+    readonly radius: {
+        readonly type: "dimension";
+        readonly palettePath: "palette.radius.md";
+    };
+    readonly spacing: {
+        readonly type: "dimension";
+        readonly palettePath: "palette.spacing.md";
+    };
+};
+export type SemanticTokenKey = keyof typeof SEMANTIC_TOKENS;
+/** The semantic tier flattened into values a renderer can use without a resolver. */
+export interface ThemeStyle {
+    colors: Record<'brand' | 'accent' | 'action' | 'surface' | 'elevated' | 'text' | 'muted', string>;
+    fonts: Record<'heading' | 'body', string>;
+    radius: number;
+    spacing: number;
+}
+export declare const DEFAULT_THEME_STYLE: ThemeStyle;
+/**
+ * Where an alias chain ends. Two roles that answer the same path are the same
+ * value: that is what makes "action follows accent" a fact rather than a
+ * label, and what a write has to move so the change cascades.
+ */
+export declare function terminalTokenPath(tokens: unknown, path: string): string | null;
+/** The whole semantic tier resolved once, for a renderer that only wants values. */
+export declare function resolveThemeStyle(tokens: unknown): ThemeStyle;
+/**
+ * Sets one role, writing wherever its alias chain ends so every token pointed
+ * at the same leaf moves with it. A role a theme does not carry yet is created
+ * on its declared palette leaf, with the semantic alias added over it -- an old
+ * theme gains the role by being edited, never by a migration.
+ */
+export declare function writeSemanticToken(tokens: ThemeTokens, key: SemanticTokenKey, value: TokenValue): ThemeTokens;
+/**
+ * Points one role at another's value again. The pair the editor offers is
+ * action to accent: a merchant who set a one-off button colour gets back the
+ * cascade rather than having to retype the accent's hex.
+ */
+export declare function linkSemanticToken(tokens: ThemeTokens, key: SemanticTokenKey, to: SemanticTokenKey): ThemeTokens;
+/** Whether two roles resolve to the same leaf, i.e. one follows the other. */
+export declare function semanticTokensLinked(tokens: unknown, key: SemanticTokenKey, to: SemanticTokenKey): boolean;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,WAAW,uEAAwE,CAAC;AACjG,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC;AAE1D,iFAAiF;AACjF,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;CACxC,CAAC;AAEF,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,UAAU,CAAC;CACvB;AAsGD,eAAO,MAAM,iBAAiB;;;;iBA0C1B,CAAC;AAEL;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAY0B,CAAC;AAEvD,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,eAAe,CAAC;AAE5D,qFAAqF;AACrF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC;IAClG,KAAK,EAAE,MAAM,CAAC,SAAS,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,mBAAmB,EAAE,UAajC,CAAC;AAuBF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc9E;AAgED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAqB7D;AA4BD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,UAAU,GAChB,WAAW,CAWb;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,gBAAgB,EACrB,EAAE,EAAE,gBAAgB,GACnB,WAAW,CAoBb;AAED,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,gBAAgB,EACrB,EAAE,EAAE,gBAAgB,GACnB,OAAO,CAIT"}

package/dist/tokens.js

@@ -0,0 +1,349 @@
+import { z } from 'zod';
+export const TOKEN_TYPES = ['color', 'dimension', 'fontFamily', 'fontWeight', 'number'];
+const ALIAS_PATTERN = /^\{[a-zA-Z0-9_-]+(\.[a-zA-Z0-9_-]+)*\}$/;
+const HEX_COLOR_PATTERN = /^#(?:[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+function isAliasValue(value) {
+    return typeof value === 'string' && ALIAS_PATTERN.test(value);
+}
+const tokenNameSchema = z
+    .string()
+    .regex(/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/, 'token and group names are alphanumeric with "-" or "_"');
+const dimensionValueSchema = z.object({
+    value: z.number().finite(),
+    unit: z.literal('px'),
+});
+const tokenLeafSchema = z
+    .object({
+    $type: z.enum(TOKEN_TYPES),
+    $value: z.union([z.string(), z.number(), dimensionValueSchema]),
+})
+    .superRefine((leaf, ctx) => {
+    if (isAliasValue(leaf.$value))
+        return;
+    const bad = (message) => ctx.addIssue({ code: 'custom', message, path: ['$value'] });
+    switch (leaf.$type) {
+        case 'color':
+            if (typeof leaf.$value !== 'string' || !HEX_COLOR_PATTERN.test(leaf.$value)) {
+                bad('expected "#rrggbb", "#rrggbbaa" or an alias');
+            }
+            break;
+        case 'dimension':
+            if (typeof leaf.$value !== 'object') {
+                bad('expected { value, unit: "px" } or an alias');
+            }
+            break;
+        case 'fontFamily':
+            if (typeof leaf.$value !== 'string' || leaf.$value.length === 0) {
+                bad('expected a font family name or an alias');
+            }
+            break;
+        case 'fontWeight':
+            if (typeof leaf.$value !== 'number' ||
+                !Number.isInteger(leaf.$value) ||
+                leaf.$value < 100 ||
+                leaf.$value > 900) {
+                bad('expected an integer weight between 100 and 900 or an alias');
+            }
+            break;
+        case 'number':
+            if (typeof leaf.$value !== 'number') {
+                bad('expected a number or an alias');
+            }
+            break;
+    }
+});
+const tokenNodeSchema = z
+    .unknown()
+    .transform((value, ctx) => {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        ctx.addIssue({ code: 'custom', message: 'expected a token or a group of tokens' });
+        return z.NEVER;
+    }
+    const schema = '$value' in value || '$type' in value ? tokenLeafSchema : tokenGroupSchema;
+    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;
+});
+const tokenGroupSchema = z.lazy(() => z.record(tokenNameSchema, tokenNodeSchema));
+function isLeaf(node) {
+    return '$value' in node;
+}
+function flattenLeaves(group, path, out) {
+    for (const [name, node] of Object.entries(group)) {
+        const nodePath = [...path, name];
+        if (isLeaf(node)) {
+            out.set(nodePath.join('.'), { leaf: node, path: nodePath });
+        }
+        else {
+            flattenLeaves(node, nodePath, out);
+        }
+    }
+}
+export const themeTokensSchema = z
+    .object({
+    palette: tokenGroupSchema,
+    semantic: tokenGroupSchema,
+    component: tokenGroupSchema,
+})
+    .superRefine((tokens, ctx) => {
+    const leaves = new Map();
+    flattenLeaves(tokens.palette, ['palette'], leaves);
+    flattenLeaves(tokens.semantic, ['semantic'], leaves);
+    flattenLeaves(tokens.component, ['component'], leaves);
+    for (const [key, { leaf, path }] of leaves) {
+        if (!isAliasValue(leaf.$value))
+            continue;
+        const issue = (message) => ctx.addIssue({ code: 'custom', message, path: [...path, '$value'] });
+        const seen = new Set([key]);
+        let current = leaf;
+        let terminal;
+        while (true) {
+            if (!isAliasValue(current.$value)) {
+                terminal = current;
+                break;
+            }
+            const ref = current.$value.slice(1, -1);
+            const next = leaves.get(ref);
+            if (next === undefined) {
+                issue(`alias "{${ref}}" does not resolve to a token`);
+                break;
+            }
+            if (seen.has(ref)) {
+                issue(`alias cycle through "{${ref}}"`);
+                break;
+            }
+            seen.add(ref);
+            current = next.leaf;
+        }
+        if (terminal !== undefined && terminal.$type !== leaf.$type) {
+            issue(`alias resolves to a "${terminal.$type}" token but this token is "${leaf.$type}"`);
+        }
+    }
+});
+export const SEMANTIC_TOKENS = {
+    brand: { type: 'color', palettePath: 'palette.brand.primary' },
+    accent: { type: 'color', palettePath: 'palette.brand.accent' },
+    action: { type: 'color', palettePath: 'palette.brand.accent' },
+    surface: { type: 'color', palettePath: 'palette.neutral.background' },
+    elevated: { type: 'color', palettePath: 'palette.neutral.surface' },
+    text: { type: 'color', palettePath: 'palette.neutral.text' },
+    muted: { type: 'color', palettePath: 'palette.neutral.muted' },
+    heading: { type: 'fontFamily', palettePath: 'palette.typeface.heading' },
+    body: { type: 'fontFamily', palettePath: 'palette.typeface.body' },
+    radius: { type: 'dimension', palettePath: 'palette.radius.md' },
+    spacing: { type: 'dimension', palettePath: 'palette.spacing.md' },
+};
+export const DEFAULT_THEME_STYLE = {
+    colors: {
+        brand: '#111827',
+        accent: '#2563EB',
+        action: '#2563EB',
+        surface: '#FFFFFF',
+        elevated: '#F9FAFB',
+        text: '#111827',
+        muted: '#6B7280',
+    },
+    fonts: { heading: 'Inter', body: 'Inter' },
+    radius: 8,
+    spacing: 16,
+};
+function nodeAt(tokens, path) {
+    let node = tokens;
+    for (const key of path.split('.')) {
+        if (typeof node !== 'object' || node === null)
+            return undefined;
+        node = node[key];
+    }
+    if (typeof node !== 'object' || node === null || Array.isArray(node))
+        return undefined;
+    return node;
+}
+function leafAt(tokens, path) {
+    const node = nodeAt(tokens, path);
+    return node !== undefined && '$value' in node ? node : undefined;
+}
+function aliasTarget(value) {
+    if (typeof value !== 'string')
+        return null;
+    const match = ALIAS_PATTERN.exec(value);
+    return match ? value.slice(1, -1) : null;
+}
+/**
+ * Where an alias chain ends. Two roles that answer the same path are the same
+ * value: that is what makes "action follows accent" a fact rather than a
+ * label, and what a write has to move so the change cascades.
+ */
+export function terminalTokenPath(tokens, path) {
+    const seen = new Set();
+    let current = path;
+    while (!seen.has(current)) {
+        seen.add(current);
+        const leaf = leafAt(tokens, current);
+        if (leaf === undefined)
+            return null;
+        const next = aliasTarget(leaf.$value);
+        if (next === null)
+            return current;
+        current = next;
+    }
+    // A cycle. The contract refuses one, so this only answers a tree that has
+    // not been through the parser yet.
+    return null;
+}
+function terminalLeaf(tokens, path) {
+    const terminal = terminalTokenPath(tokens, path);
+    return terminal === null ? undefined : leafAt(tokens, terminal);
+}
+/**
+ * Where a role's value actually lives: its own chain, or -- for a theme
+ * written before the role existed -- the palette leaf it is declared against.
+ */
+function effectiveTerminal(tokens, key) {
+    return (terminalTokenPath(tokens, `semantic.${key}`) ??
+        terminalTokenPath(tokens, SEMANTIC_TOKENS[key].palettePath));
+}
+/**
+ * The role's value, read through its alias chain. A theme written before a
+ * role existed still answers: the palette leaf the role is declared against
+ * stands in, and the platform default behind that. Nothing is ever missing.
+ */
+function readRole(tokens, key) {
+    const spec = SEMANTIC_TOKENS[key];
+    const own = terminalLeaf(tokens, `semantic.${key}`);
+    if (own?.$type === spec.type)
+        return own.$value;
+    const fallback = terminalLeaf(tokens, spec.palettePath);
+    return fallback?.$type === spec.type ? fallback.$value : undefined;
+}
+/** The platform default for one role, in the role's own type. */
+function defaultRoleValue(key) {
+    const d = DEFAULT_THEME_STYLE;
+    switch (key) {
+        case 'heading':
+            return d.fonts.heading;
+        case 'body':
+            return d.fonts.body;
+        case 'radius':
+            return { value: d.radius, unit: 'px' };
+        case 'spacing':
+            return { value: d.spacing, unit: 'px' };
+        default:
+            return d.colors[key];
+    }
+}
+/** One role's value as it stands now, whichever tier it resolves through. */
+function roleValue(tokens, key) {
+    return readRole(tokens, key) ?? defaultRoleValue(key);
+}
+function pixels(value, fallback) {
+    if (typeof value === 'object' && value !== null && typeof value.value === 'number') {
+        return value.value;
+    }
+    return fallback;
+}
+function text(value, fallback) {
+    return typeof value === 'string' && value.length > 0 ? value : fallback;
+}
+/** The whole semantic tier resolved once, for a renderer that only wants values. */
+export function resolveThemeStyle(tokens) {
+    const d = DEFAULT_THEME_STYLE;
+    const color = (key) => text(readRole(tokens, key), d.colors[key]);
+    return {
+        colors: {
+            brand: color('brand'),
+            accent: color('accent'),
+            action: color('action'),
+            surface: color('surface'),
+            elevated: color('elevated'),
+            text: color('text'),
+            muted: color('muted'),
+        },
+        fonts: {
+            heading: text(readRole(tokens, 'heading'), d.fonts.heading),
+            body: text(readRole(tokens, 'body'), d.fonts.body),
+        },
+        radius: pixels(readRole(tokens, 'radius'), d.radius),
+        spacing: pixels(readRole(tokens, 'spacing'), d.spacing),
+    };
+}
+/** Token trees are plain JSON, so a round trip is a deep copy and nothing else. */
+function clone(tokens) {
+    return JSON.parse(JSON.stringify(tokens));
+}
+const TOKEN_NAME_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9_-]*$/;
+/**
+ * Writes one leaf at a dotted path, creating the groups on the way. Every
+ * segment is checked against the contract's own name rule first: the path can
+ * come from an alias inside a document, and walking an inherited key like
+ * `__proto__` would write somewhere no token lives.
+ */
+function putLeaf(tokens, path, leaf) {
+    const segments = path.split('.');
+    if (segments.length === 0 || !segments.every((name) => TOKEN_NAME_PATTERN.test(name)))
+        return;
+    const last = segments.pop();
+    let node = tokens;
+    for (const segment of segments) {
+        const next = node[segment];
+        if (next === undefined || '$value' in next)
+            node[segment] = {};
+        node = node[segment];
+    }
+    node[last] = leaf;
+}
+/**
+ * Sets one role, writing wherever its alias chain ends so every token pointed
+ * at the same leaf moves with it. A role a theme does not carry yet is created
+ * on its declared palette leaf, with the semantic alias added over it -- an old
+ * theme gains the role by being edited, never by a migration.
+ */
+export function writeSemanticToken(tokens, key, value) {
+    const spec = SEMANTIC_TOKENS[key];
+    const next = clone(tokens);
+    const terminal = terminalTokenPath(next, `semantic.${key}`);
+    if (terminal !== null) {
+        putLeaf(next, terminal, { $type: spec.type, $value: value });
+        return next;
+    }
+    putLeaf(next, spec.palettePath, { $type: spec.type, $value: value });
+    putLeaf(next, `semantic.${key}`, { $type: spec.type, $value: `{${spec.palettePath}}` });
+    return next;
+}
+/**
+ * Points one role at another's value again. The pair the editor offers is
+ * action to accent: a merchant who set a one-off button colour gets back the
+ * cascade rather than having to retype the accent's hex.
+ */
+export function linkSemanticToken(tokens, key, to) {
+    const spec = SEMANTIC_TOKENS[key];
+    const target = SEMANTIC_TOKENS[to];
+    // An alias whose target is another type is refused by the contract, so a
+    // link across two types is not a link, it is a broken document.
+    if (spec.type !== target.type)
+        return tokens;
+    const current = roleValue(tokens, to);
+    let next = clone(tokens);
+    if (terminalTokenPath(next, `semantic.${to}`) === null) {
+        next = writeSemanticToken(next, to, current);
+    }
+    putLeaf(next, `semantic.${key}`, { $type: spec.type, $value: `{semantic.${to}}` });
+    // Keep the declared palette leaf in the picture: a role that only ever
+    // existed as an alias would leave `target.palettePath` unwritten and the
+    // next reader falling through to the platform default.
+    if (leafAt(next, target.palettePath) === undefined) {
+        putLeaf(next, target.palettePath, { $type: target.type, $value: current });
+    }
+    return next;
+}
+/** Whether two roles resolve to the same leaf, i.e. one follows the other. */
+export function semanticTokensLinked(tokens, key, to) {
+    const a = effectiveTerminal(tokens, key);
+    const b = effectiveTerminal(tokens, to);
+    return a !== null && a === b;
+}
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+/**
+ * Bumped on every breaking change to the published schema set. Consumers
+ * (api validation, dashboard editor, mobile renderer) read it from here.
+ */
+export declare const SCHEMA_VERSION: 1;
+export declare const schemaVersionSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+}, z.core.$strip>;
+export type SchemaVersion = z.infer<typeof schemaVersionSchema>;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAG,CAAU,CAAC;AAEzC,eAAO,MAAM,mBAAmB;;iBAE9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/version.js

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+/**
+ * Bumped on every breaking change to the published schema set. Consumers
+ * (api validation, dashboard editor, mobile renderer) read it from here.
+ */
+export const SCHEMA_VERSION = 1;
+export const schemaVersionSchema = z.object({
+    schemaVersion: z.literal(SCHEMA_VERSION),
+});
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;CACzC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@shoplix-ai/sdui-schema",
+  "version": "1.0.0",
+  "description": "Zod source of truth for the Shoplix SDUI contract: documents, Bindings, tokens, block manifest, envelopes and display shapes. Consumers import parse helpers and inferred types; zod stays inside.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Rastova/shoplix.git",
+    "directory": "packages/sdui-schema"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=22.13"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./starters": {
+      "types": "./dist/starters/index.d.ts",
+      "default": "./dist/starters/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/fixtures.*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.1",
+    "globals": "^16.5.0",
+    "typescript": "5.9.2",
+    "typescript-eslint": "^8.50.0",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src/ tests/"
+  }
+}