@visual-platform/contracts 0.0.0-stage → 0.1.0

package/dist/classes.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+import { type ComponentNode } from "./page-document.js";
+export declare const MAX_CLASSES = 60;
+export declare function splitClasses(value: string): string[];
+export declare function invalidClasses(value: string): string[];
+export declare const ClassNameSchema: z.ZodString;
+/** Every class used by these documents (for CSS compilation and `vp classes pull`). */
+export declare function collectClasses(documents: {
+    nodes: readonly ComponentNode[];
+}[]): string[];
+//# sourceMappingURL=classes.d.ts.map

package/dist/classes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classes.d.ts","sourceRoot":"","sources":["../src/classes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AASnE,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEpD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEtD;AAED,eAAO,MAAM,eAAe,aAI1B,CAAC;AAEH,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,SAAS,EAAE;IAAE,KAAK,EAAE,SAAS,aAAa,EAAE,CAAA;CAAE,EAAE,GAAG,MAAM,EAAE,CAIzF"}

package/dist/classes.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { walkNodes } from "./page-document.js";
+/**
+ * Tailwind utility classes on a block (ADR-029). Only utility syntax: letters, digits and the
+ * punctuation used by variants/arbitrary values. No quotes, backslashes, url()/image-set() (no
+ * external loads), no @import/expression.
+ */
+const TOKEN = /^[A-Za-z0-9_:\-[\].\/#%(),!@&*+>~=]{1,120}$/;
+const FORBIDDEN = /url\(|image-set\(|expression\(|@import|javascript:/i;
+export const MAX_CLASSES = 60;
+export function splitClasses(value) {
+    return value.split(/\s+/).filter(Boolean);
+}
+export function invalidClasses(value) {
+    return splitClasses(value).filter((t) => !TOKEN.test(t) || FORBIDDEN.test(t));
+}
+export const ClassNameSchema = z.string().max(600).superRefine((v, ctx) => {
+    const bad = invalidClasses(v);
+    if (bad.length)
+        ctx.addIssue({ code: "custom", message: `not allowed: ${bad.slice(0, 3).join(" ")}` });
+    if (splitClasses(v).length > MAX_CLASSES)
+        ctx.addIssue({ code: "custom", message: `at most ${MAX_CLASSES} classes per block` });
+});
+/** Every class used by these documents (for CSS compilation and `vp classes pull`). */
+export function collectClasses(documents) {
+    const out = new Set();
+    for (const d of documents)
+        for (const n of walkNodes(d.nodes))
+            if (n.className)
+                for (const c of splitClasses(n.className))
+                    out.add(c);
+    return [...out].sort();
+}
+//# sourceMappingURL=classes.js.map

package/dist/classes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classes.js","sourceRoot":"","sources":["../src/classes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAsB,MAAM,oBAAoB,CAAC;AAEnE;;;;GAIG;AACH,MAAM,KAAK,GAAG,6CAA6C,CAAC;AAC5D,MAAM,SAAS,GAAG,qDAAqD,CAAC;AACxE,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAE9B,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;IACxE,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,GAAG,CAAC,MAAM;QAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IACvG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,WAAW;QAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,WAAW,oBAAoB,EAAE,CAAC,CAAC;AAClI,CAAC,CAAC,CAAC;AAEH,uFAAuF;AACvF,MAAM,UAAU,cAAc,CAAC,SAAgD;IAC7E,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,CAAC,SAAS;gBAAE,KAAK,MAAM,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;oBAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACtI,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/component.d.ts

@@ -0,0 +1,135 @@
+import { z } from "zod";
+import { type ComponentNode } from "./page-document.js";
+/**
+ * Composed component (ADR-028): built in the editor from built-in basic/container blocks, stored at
+ * Project scope with draft/versions. `props` expose chosen inner fields to whoever places it; text is
+ * translated per locale inside the component (structure is shared by all languages).
+ */
+export declare const COMPONENT_REF_TYPE = "ComponentRef";
+/** Internal wrapper the renderer understands natively: applies a design-system theme to its children. */
+export declare const THEME_SCOPE_TYPE = "VisualThemeScope";
+export declare const COMPONENT_PROP_TYPES: readonly ["text", "textarea", "image", "link", "icon", "number", "boolean", "select"];
+export declare const ComponentPropSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodEnum<{
+        boolean: "boolean";
+        icon: "icon";
+        image: "image";
+        link: "link";
+        number: "number";
+        select: "select";
+        text: "text";
+        textarea: "textarea";
+    }>;
+    binds: z.ZodArray<z.ZodObject<{
+        nodeId: z.ZodString;
+        prop: z.ZodString;
+    }, z.core.$strict>>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type ComponentProp = z.infer<typeof ComponentPropSchema>;
+export declare const ComponentDocumentSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    nodes: z.ZodArray<z.ZodType<ComponentNode, unknown, z.core.$ZodTypeInternals<ComponentNode, unknown>>>;
+    props: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<{
+            boolean: "boolean";
+            icon: "icon";
+            image: "image";
+            link: "link";
+            number: "number";
+            select: "select";
+            text: "text";
+            textarea: "textarea";
+        }>;
+        binds: z.ZodArray<z.ZodObject<{
+            nodeId: z.ZodString;
+            prop: z.ZodString;
+        }, z.core.$strict>>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+    defaultLocale: z.ZodString;
+    translations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
+    theme: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        source: z.ZodDefault<z.ZodEnum<{
+            app: "app";
+            table: "table";
+        }>>;
+        shape: z.ZodEnum<{
+            list: "list";
+            object: "object";
+        }>;
+        fields: z.ZodArray<z.ZodType<import("./data.js").DataField, unknown, z.core.$ZodTypeInternals<import("./data.js").DataField, unknown>>>;
+        sample: z.ZodOptional<z.ZodUnknown>;
+        query: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+            table: z.ZodString;
+            where: z.ZodOptional<z.ZodType<import("./tables.js").Filter, unknown, z.core.$ZodTypeInternals<import("./tables.js").Filter, unknown>>>;
+            sort: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                field: z.ZodString;
+                dir: z.ZodDefault<z.ZodEnum<{
+                    asc: "asc";
+                    desc: "desc";
+                }>>;
+            }, z.core.$strict>>>;
+            limit: z.ZodDefault<z.ZodNumber>;
+            offset: z.ZodDefault<z.ZodNumber>;
+            include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            locale: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        single: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>>;
+    disabledLocales: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    childrenSlot: z.ZodOptional<z.ZodObject<{
+        nodeId: z.ZodString;
+        slot: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ComponentDocument = z.infer<typeof ComponentDocumentSchema>;
+export declare const ComponentRefPropsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    dataMap: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    eventMap: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    mode: z.ZodLiteral<"follow">;
+    componentId: z.ZodString;
+}, z.core.$loose>, z.ZodObject<{
+    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    dataMap: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    eventMap: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    mode: z.ZodLiteral<"fixed">;
+    componentId: z.ZodString;
+    versionId: z.ZodString;
+}, z.core.$loose>], "mode">;
+export type ComponentRefProps = z.infer<typeof ComponentRefPropsSchema>;
+export declare function componentRefs(nodes: readonly ComponentNode[]): {
+    nodeId: string;
+    props: ComponentRefProps | null;
+}[];
+/**
+ * The component's nodes for one locale with prop values applied:
+ * base content → translations of `locale` → values passed by the page/app (values win).
+ * Bindings to nodes that no longer exist are ignored.
+ */
+export declare function applyComponent(doc: ComponentDocument, opts?: {
+    locale?: string | undefined;
+    values?: Record<string, unknown> | undefined;
+}): ComponentNode[];
+/** Wrap nodes in a theme scope when the component pins a theme. */
+export declare function withTheme(nodes: ComponentNode[], theme: string | undefined, id: string): ComponentNode[];
+/** Is the component switched on for this locale (exact code or its base language)? */
+export declare function componentEnabledFor(doc: Pick<ComponentDocument, "disabledLocales">, locale: string | undefined): boolean;
+/** Apply a placement's dataMap/eventMap to a component's nodes (ADR-036). */
+export declare function applyPlacement(nodes: readonly ComponentNode[], dataMap?: Record<string, string>, eventMap?: Record<string, string>): ComponentNode[];
+/**
+ * Replace ComponentRef nodes with the component's nodes (delivery time), using the page's locale and
+ * the values stored on the ref. Ids are namespaced with the ref id (a component may appear twice).
+ */
+export declare function expandComponentRefs(nodes: readonly ComponentNode[], locale: string, resolve: (ref: ComponentRefProps) => ComponentDocument | null, depth?: number, seen?: ReadonlySet<string>): ComponentNode[];
+//# sourceMappingURL=component.d.ts.map

package/dist/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAgE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKtH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AACjD,yGAAyG;AACzG,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAGnD,eAAO,MAAM,oBAAoB,YAAI,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAE1H,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;kBASrB,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAKhE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0BlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAYxE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;2BAGlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAAE,EAAE,CAKpH;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAAO,GAAG,aAAa,EAAE,CAgBhK;AAED,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,EAAE,CAExG;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,IAAI,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGxH;AASD,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,EAAE,CAWpJ;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,iBAAiB,GAAG,IAAI,EAAE,KAAK,SAAI,EAAE,IAAI,GAAE,WAAW,CAAC,MAAM,CAAa,GAAG,aAAa,EAAE,CA4BrN"}

package/dist/component.js

@@ -0,0 +1,176 @@
+import { z } from "zod";
+import { ComponentNodeSchema, PAGE_DOCUMENT_SCHEMA_VERSION, walkNodes } from "./page-document.js";
+import { SECTION_REF_TYPE } from "./section.js";
+import { DataInputsSchema, DataPathSchema, REPEAT_TYPE } from "./data.js";
+import { EventNameSchema } from "./events.js";
+/**
+ * Composed component (ADR-028): built in the editor from built-in basic/container blocks, stored at
+ * Project scope with draft/versions. `props` expose chosen inner fields to whoever places it; text is
+ * translated per locale inside the component (structure is shared by all languages).
+ */
+export const COMPONENT_REF_TYPE = "ComponentRef";
+/** Internal wrapper the renderer understands natively: applies a design-system theme to its children. */
+export const THEME_SCOPE_TYPE = "VisualThemeScope";
+const LOCALE = z.string().regex(/^[a-z]{2,3}(-[A-Z]{2})?$/);
+export const COMPONENT_PROP_TYPES = ["text", "textarea", "image", "link", "icon", "number", "boolean", "select"];
+export const ComponentPropSchema = z.object({
+    name: z.string().regex(/^[a-z][a-zA-Z0-9]{0,39}$/, "prop names are camelCase, e.g. title or ctaLabel"),
+    label: z.string().min(1).max(60),
+    type: z.enum(COMPONENT_PROP_TYPES),
+    /** Inner fields this prop writes to (one prop may drive several fields). */
+    binds: z.array(z.object({ nodeId: z.string().min(1), prop: z.string().min(1).max(60) }).strict()).min(1).max(10),
+    required: z.boolean().optional(),
+    /** select props: the allowed values (from the bound field). */
+    options: z.array(z.string()).max(100).optional(),
+}).strict();
+/** `${nodeId}.${prop}` → translated text, per locale. */
+const TranslationsSchema = z.record(LOCALE, z.record(z.string().regex(/^[A-Za-z0-9_]+\.[A-Za-z0-9_]+$/), z.string().max(5000)));
+export const ComponentDocumentSchema = z.object({
+    schemaVersion: z.literal(PAGE_DOCUMENT_SCHEMA_VERSION),
+    nodes: z.array(ComponentNodeSchema).min(1, "a component needs at least one block"),
+    props: z.array(ComponentPropSchema).max(30).default([]),
+    defaultLocale: LOCALE,
+    translations: TranslationsSchema.default({}),
+    /** Design-system theme for this component (e.g. "dark"); omitted → the page's theme. */
+    theme: z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/).optional(),
+    /** Data inputs the component reads (ADR-034); inside a page they come from the page's data by name. */
+    data: z.lazy(() => DataInputsSchema).optional(),
+    /** Languages this component is switched off for (ADR-038): it is not rendered on pages in them. */
+    disabledLocales: z.array(LOCALE).max(50).optional(),
+    /** The inner slot that receives the blocks placed inside the component on a page (ADR-043). */
+    childrenSlot: z.object({ nodeId: z.string().min(1), slot: z.string().min(1).max(60) }).strict().optional(),
+}).strict().superRefine((doc, ctx) => {
+    if (doc.disabledLocales?.includes(doc.defaultLocale))
+        ctx.addIssue({ code: "custom", path: ["disabledLocales"], message: "the source language cannot be switched off" });
+    for (const n of walkNodes(doc.nodes)) {
+        // Components may contain other components (ADR-043; cycles are refused when saving), not shared sections.
+        if (n.type === SECTION_REF_TYPE)
+            ctx.addIssue({ code: "custom", path: ["nodes"], message: "components cannot contain shared sections" });
+    }
+    if (doc.childrenSlot && ![...walkNodes(doc.nodes)].some((n) => n.id === doc.childrenSlot.nodeId))
+        ctx.addIssue({ code: "custom", path: ["childrenSlot"], message: "children slot block not found" });
+    const names = new Set();
+    for (const p of doc.props) {
+        if (names.has(p.name))
+            ctx.addIssue({ code: "custom", path: ["props"], message: `duplicate prop "${p.name}"` });
+        names.add(p.name);
+    }
+});
+/**
+ * Per placement (ADR-036): `dataMap` feeds a component data input from a page data path
+ * ({ products: "menu.items" }); `eventMap` renames the component's handlers for this placement
+ * ({ onBuy: "onBuyHero" }). Without them a component reads page data and fires events by the same name.
+ */
+const PlacementSchema = {
+    values: z.record(z.string(), z.unknown()).optional(),
+    dataMap: z.record(z.string().regex(/^[a-z][A-Za-z0-9]{0,39}$/), DataPathSchema).optional(),
+    eventMap: z.record(EventNameSchema, EventNameSchema).optional(),
+};
+export const ComponentRefPropsSchema = z.discriminatedUnion("mode", [
+    z.object({ mode: z.literal("follow"), componentId: z.string().uuid(), ...PlacementSchema }).passthrough(),
+    z.object({ mode: z.literal("fixed"), componentId: z.string().uuid(), versionId: z.string().uuid(), ...PlacementSchema }).passthrough(),
+]);
+export function componentRefs(nodes) {
+    return [...walkNodes(nodes)].filter((n) => n.type === COMPONENT_REF_TYPE).map((n) => {
+        const r = ComponentRefPropsSchema.safeParse(n.props);
+        return { nodeId: n.id, props: r.success ? r.data : null };
+    });
+}
+/**
+ * The component's nodes for one locale with prop values applied:
+ * base content → translations of `locale` → values passed by the page/app (values win).
+ * Bindings to nodes that no longer exist are ignored.
+ */
+export function applyComponent(doc, opts = {}) {
+    const tr = opts.locale && opts.locale !== doc.defaultLocale ? (doc.translations[opts.locale] ?? doc.translations[opts.locale.split("-")[0]] ?? {}) : {};
+    const writes = new Map();
+    const put = (nodeId, prop, v) => { (writes.get(nodeId) ?? writes.set(nodeId, {}).get(nodeId))[prop] = v; };
+    for (const [key, text] of Object.entries(tr)) {
+        const [nodeId, prop] = key.split(".");
+        put(nodeId, prop, text);
+    }
+    for (const p of doc.props) {
+        const v = opts.values?.[p.name];
+        if (v === undefined || v === null || v === "")
+            continue;
+        for (const b of p.binds)
+            put(b.nodeId, b.prop, v);
+    }
+    const walk = (list) => list.map((n) => {
+        const w = writes.get(n.id);
+        const slots = n.slots ? Object.fromEntries(Object.entries(n.slots).map(([k, v]) => [k, walk(v)])) : undefined;
+        return { ...n, props: w ? { ...n.props, ...w } : n.props, ...(slots ? { slots } : {}) };
+    });
+    return walk(doc.nodes);
+}
+/** Wrap nodes in a theme scope when the component pins a theme. */
+export function withTheme(nodes, theme, id) {
+    return theme ? [{ id: `${id}_theme`, type: THEME_SCOPE_TYPE, props: { theme }, slots: { children: nodes } }] : nodes;
+}
+/** Is the component switched on for this locale (exact code or its base language)? */
+export function componentEnabledFor(doc, locale) {
+    if (!locale || !doc.disabledLocales?.length)
+        return true;
+    return !doc.disabledLocales.includes(locale) && !doc.disabledLocales.includes(locale.split("-")[0]);
+}
+/** Rewrite a data path whose first segment is a mapped input (products.0.name → menu.items.0.name). */
+function remap(path, dataMap) {
+    const [root, ...rest] = path.split(".");
+    const to = dataMap[root];
+    return to ? [to, ...rest].join(".") : path;
+}
+/** Apply a placement's dataMap/eventMap to a component's nodes (ADR-036). */
+export function applyPlacement(nodes, dataMap, eventMap) {
+    if (!dataMap && !eventMap)
+        return [...nodes];
+    const walk = (n) => {
+        const out = { ...n };
+        if (dataMap && n.bind)
+            out.bind = Object.fromEntries(Object.entries(n.bind).map(([k, b]) => [k, { ...b, path: remap(b.path, dataMap) }]));
+        if (dataMap && n.type === REPEAT_TYPE && typeof n.props.source === "string")
+            out.props = { ...n.props, source: remap(n.props.source, dataMap) };
+        if (eventMap && n.events)
+            out.events = Object.fromEntries(Object.entries(n.events).map(([k, v]) => [k, v && eventMap[v] ? eventMap[v] : v]));
+        if (n.slots)
+            out.slots = Object.fromEntries(Object.entries(n.slots).map(([k, v]) => [k, v.map(walk)]));
+        return out;
+    };
+    return nodes.map(walk);
+}
+/**
+ * Replace ComponentRef nodes with the component's nodes (delivery time), using the page's locale and
+ * the values stored on the ref. Ids are namespaced with the ref id (a component may appear twice).
+ */
+export function expandComponentRefs(nodes, locale, resolve, depth = 0, seen = new Set()) {
+    const prefix = (refId, n) => {
+        const slots = n.slots ? Object.fromEntries(Object.entries(n.slots).map(([k, v]) => [k, v.map((c) => prefix(refId, c))])) : undefined;
+        return { ...n, id: `${refId}_${n.id.replace(/^n_/, "")}`, ...(slots ? { slots } : {}) };
+    };
+    const walk = (list) => list.flatMap((n) => {
+        if (n.type === COMPONENT_REF_TYPE) {
+            const r = ComponentRefPropsSchema.safeParse(n.props);
+            // Nested components (ADR-043): at most 5 levels, never the same component inside itself.
+            if (!r.success || depth >= 5 || seen.has(r.data.componentId))
+                return [];
+            const doc = resolve(r.data);
+            if (!doc)
+                return [];
+            if (!componentEnabledFor(doc, locale))
+                return []; // switched off for this language (ADR-038)
+            let inner = applyPlacement(applyComponent(doc, { locale, values: r.data.values }), r.data.dataMap, r.data.eventMap);
+            // Children placed inside the component on the page go into its children slot.
+            const children = n.slots?.children;
+            if (doc.childrenSlot && children?.length) {
+                const put = (list2) => list2.map((x) => x.id === doc.childrenSlot.nodeId
+                    ? { ...x, slots: { ...(x.slots ?? {}), [doc.childrenSlot.slot]: [...(x.slots?.[doc.childrenSlot.slot] ?? []), ...walk(children)] } }
+                    : x.slots ? { ...x, slots: Object.fromEntries(Object.entries(x.slots).map(([k, v]) => [k, put(v)])) } : x);
+                inner = put(inner);
+            }
+            inner = expandComponentRefs(inner, locale, resolve, depth + 1, new Set([...seen, r.data.componentId]));
+            return withTheme(inner.map((c) => prefix(n.id, c)), doc.theme, n.id);
+        }
+        return n.slots ? [{ ...n, slots: Object.fromEntries(Object.entries(n.slots).map(([k, v]) => [k, walk(v)])) }] : [n];
+    });
+    return walk(nodes);
+}
+//# sourceMappingURL=component.js.map

package/dist/component.js.map

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

package/dist/data.d.ts

@@ -0,0 +1,152 @@
+import { z } from "zod";
+import { type ComponentNode } from "./page-document.js";
+/**
+ * Data binding (ADR-034). A block prop is either its static value (props) or bound to a field of a
+ * data input: node.bind = { title: { path: "item.name" } }. The static value stays as the fallback.
+ * Phase A source: "app" — the customer app passes the data when rendering.
+ */
+export declare const REPEAT_TYPE = "Repeat";
+/** "app": passed by the customer app; "table": a project data table query (ADR-041). */
+export declare const DATA_SOURCES: readonly ["app", "table"];
+export declare const DATA_FIELD_TYPES: readonly ["text", "number", "boolean", "image", "link", "date", "list", "object"];
+export type DataFieldType = (typeof DATA_FIELD_TYPES)[number];
+export declare const BIND_FORMATS: readonly ["number", "currency", "date", "datetime", "upper", "lower"];
+export type BindFormat = (typeof BIND_FORMATS)[number];
+/** products · products.0.name · item.price · item.variants — dotted names/indexes only, no expressions. */
+export declare const DataPathSchema: z.ZodString;
+export type DataField = {
+    name: string;
+    type: DataFieldType;
+    label?: string | undefined;
+    fields?: DataField[] | undefined;
+    localized?: boolean | undefined;
+};
+export declare const DataFieldSchema: z.ZodType<DataField>;
+export declare const DataInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    source: z.ZodDefault<z.ZodEnum<{
+        app: "app";
+        table: "table";
+    }>>;
+    shape: z.ZodEnum<{
+        list: "list";
+        object: "object";
+    }>;
+    fields: z.ZodArray<z.ZodType<DataField, unknown, z.core.$ZodTypeInternals<DataField, unknown>>>;
+    sample: z.ZodOptional<z.ZodUnknown>;
+    query: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+        table: z.ZodString;
+        where: z.ZodOptional<z.ZodType<import("./tables.js").Filter, unknown, z.core.$ZodTypeInternals<import("./tables.js").Filter, unknown>>>;
+        sort: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            dir: z.ZodDefault<z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>>;
+        }, z.core.$strict>>>;
+        limit: z.ZodDefault<z.ZodNumber>;
+        offset: z.ZodDefault<z.ZodNumber>;
+        include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        locale: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    single: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type DataInput = z.infer<typeof DataInputSchema>;
+export declare const DataInputsSchema: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    source: z.ZodDefault<z.ZodEnum<{
+        app: "app";
+        table: "table";
+    }>>;
+    shape: z.ZodEnum<{
+        list: "list";
+        object: "object";
+    }>;
+    fields: z.ZodArray<z.ZodType<DataField, unknown, z.core.$ZodTypeInternals<DataField, unknown>>>;
+    sample: z.ZodOptional<z.ZodUnknown>;
+    query: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+        table: z.ZodString;
+        where: z.ZodOptional<z.ZodType<import("./tables.js").Filter, unknown, z.core.$ZodTypeInternals<import("./tables.js").Filter, unknown>>>;
+        sort: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            dir: z.ZodDefault<z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>>;
+        }, z.core.$strict>>>;
+        limit: z.ZodDefault<z.ZodNumber>;
+        offset: z.ZodDefault<z.ZodNumber>;
+        include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        locale: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    single: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>>;
+export declare const BindingSchema: z.ZodObject<{
+    path: z.ZodString;
+    format: z.ZodOptional<z.ZodEnum<{
+        currency: "currency";
+        date: "date";
+        datetime: "datetime";
+        lower: "lower";
+        number: "number";
+        upper: "upper";
+    }>>;
+    currency: z.ZodOptional<z.ZodString>;
+    prefix: z.ZodOptional<z.ZodString>;
+    suffix: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type Binding = z.infer<typeof BindingSchema>;
+export declare const NodeBindingsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    path: z.ZodString;
+    format: z.ZodOptional<z.ZodEnum<{
+        currency: "currency";
+        date: "date";
+        datetime: "datetime";
+        lower: "lower";
+        number: "number";
+        upper: "upper";
+    }>>;
+    currency: z.ZodOptional<z.ZodString>;
+    prefix: z.ZodOptional<z.ZodString>;
+    suffix: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+export type NodeBindings = z.infer<typeof NodeBindingsSchema>;
+/** Field types a definition field can receive from data. */
+export declare const BINDABLE_FIELD_TYPES: readonly ["text", "textarea", "number", "boolean", "select", "image", "link"];
+/** { vi: "…", en: "…" } — every key a language code, every value a string. */
+export declare const isLocalizedValue: (v: unknown) => v is Record<string, string>;
+/** Fields of an object (merging keys of several samples, e.g. all items of a list). */
+export declare function inferFields(samples: unknown[], depth?: number): DataField[];
+/** A data input from a pasted sample: a list (array) or an object. */
+export declare function inferDataInput(name: string, sample: unknown): DataInput;
+/** Read a dotted path from a scope ({ products, item, index }). Unknown segments → undefined. */
+export declare function readPath(scope: Record<string, unknown>, path: string, locale?: string): unknown;
+/**
+ * Convert a data value to what a definition field expects. Returns undefined when it does not fit
+ * (the static value is then kept).
+ */
+export declare function coerceBound(v: unknown, fieldType: string, b: Binding, opts?: {
+    locale?: string | undefined;
+    options?: readonly string[] | undefined;
+}): unknown;
+/** The list a Repeat iterates (props.source path); non-arrays → []. Honors props.limit. */
+export declare function repeatItems(node: ComponentNode, scope: Record<string, unknown>): unknown[];
+/** Names of data inputs a set of nodes reads (first path segment, excluding item/index). */
+export declare function usedDataInputs(nodes: readonly ComponentNode[]): string[];
+/** Paths a picker can offer for a scope: inputs (and item fields inside a Repeat). */
+export type DataPathOption = {
+    path: string;
+    type: DataFieldType;
+    list: boolean;
+    localized?: boolean;
+};
+export declare function dataPaths(inputs: readonly DataInput[], itemFields?: readonly DataField[]): DataPathOption[];
+/** Item fields of a list path (to type `item.*` inside a Repeat over it). */
+export declare function listItemFields(inputs: readonly DataInput[], path: string, outerItem?: readonly DataField[]): DataField[] | undefined;
+/** Can a data field of this type feed a definition field of that type? (pickers) */
+export declare function bindingFits(fieldType: string, data: DataFieldType): boolean;
+/** Example data for a set of fields (editor preview when the user defines fields by hand). */
+export declare function sampleFromFields(fields: readonly DataField[], locales?: readonly string[], depth?: number): Record<string, unknown>;
+//# sourceMappingURL=data.d.ts.map

package/dist/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnE;;;;GAIG;AACH,eAAO,MAAM,WAAW,WAAW,CAAC;AACpC,wFAAwF;AACxF,eAAO,MAAM,YAAY,YAAI,KAAK,EAAE,OAAO,CAAU,CAAC;AACtD,eAAO,MAAM,gBAAgB,YAAI,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAClH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9D,eAAO,MAAM,YAAY,YAAI,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC;AAClG,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAGvD,2GAA2G;AAC3G,eAAO,MAAM,cAAc,aAAgK,CAAC;AAE5L,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,CAAC;AAC7J,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAUhD,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgB1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAG3B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;kBAOf,CAAC;AACZ,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;mBACkD,CAAC;AAClF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,YAAI,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAKlH,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,MAAO,OAAO,KAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAC4F,CAAC;AAerK,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,SAAI,GAAG,SAAS,EAAE,CAgBtE;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,CAGvE;AAID,iGAAiG;AACjG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAe/F;AAmBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CAAO,GAAG,OAAO,CAqBnK;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAwB1F;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,EAAE,CAQxE;AAED,sFAAsF;AACtF,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AACvG,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,cAAc,EAAE,CAgB3G;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,EAAE,GAAG,SAAS,CAepI;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAS3E;AAED,8FAA8F;AAC9F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,OAAO,GAAE,SAAS,MAAM,EAAW,EAAE,KAAK,SAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAetI"}