@visual-platform/contracts 0.2.0 → 0.4.0

package/dist/app-sources.d.ts

@@ -0,0 +1,206 @@
+import { z } from "zod";
+import { type DataField } from "./data.js";
+import type { ParamBindings } from "./sources.js";
+/**
+ * App source registry (ADR-048 P2). `vp sources push` sends metadata only — name, params, fields,
+ * sample, visibility — never code or credentials. Studio lists them and lets editors pick one.
+ */
+export declare const SOURCE_NAME: RegExp;
+export declare const SOURCE_KINDS: readonly ["value", "sync", "async", "provided"];
+export declare const SOURCE_VISIBILITIES: readonly ["public", "segment", "private"];
+export declare const SOURCE_PARAM_TYPES: readonly ["text", "number", "boolean"];
+export declare const MAX_APP_SOURCES = 100;
+export declare const SourceParamSpecSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        boolean: "boolean";
+        number: "number";
+        text: "text";
+    }>;
+    required: z.ZodBoolean;
+    default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SourceParamSpec = z.infer<typeof SourceParamSpecSchema>;
+export declare const AppSourceManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<{
+        async: "async";
+        provided: "provided";
+        sync: "sync";
+        value: "value";
+    }>;
+    shape: z.ZodEnum<{
+        list: "list";
+        object: "object";
+    }>;
+    fields: z.ZodArray<z.ZodType<DataField, unknown, z.core.$ZodTypeInternals<DataField, unknown>>>;
+    sample: z.ZodOptional<z.ZodUnknown>;
+    params: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            boolean: "boolean";
+            number: "number";
+            text: "text";
+        }>;
+        required: z.ZodBoolean;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    visibility: z.ZodEnum<{
+        private: "private";
+        public: "public";
+        segment: "segment";
+    }>;
+    renamedFrom: z.ZodOptional<z.ZodString>;
+    untyped: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type AppSourceManifest = z.infer<typeof AppSourceManifestSchema>;
+/** An app action (ADR-048 P4): a Server Action Studio events can trigger by name (onAddToCart…). */
+export declare const AppActionManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    input: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            boolean: "boolean";
+            number: "number";
+            text: "text";
+        }>;
+        required: z.ZodBoolean;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    from: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    revalidates: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type AppActionManifest = z.infer<typeof AppActionManifestSchema>;
+export type AppActionRecord = AppActionManifest & {
+    status: "active" | "missing";
+    hash: string;
+    appVersion: string | null;
+    syncedAt: string;
+};
+export declare const AppSourcesPushSchema: z.ZodObject<{
+    sources: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<{
+            async: "async";
+            provided: "provided";
+            sync: "sync";
+            value: "value";
+        }>;
+        shape: z.ZodEnum<{
+            list: "list";
+            object: "object";
+        }>;
+        fields: z.ZodArray<z.ZodType<DataField, unknown, z.core.$ZodTypeInternals<DataField, unknown>>>;
+        sample: z.ZodOptional<z.ZodUnknown>;
+        params: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                boolean: "boolean";
+                number: "number";
+                text: "text";
+            }>;
+            required: z.ZodBoolean;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        visibility: z.ZodEnum<{
+            private: "private";
+            public: "public";
+            segment: "segment";
+        }>;
+        renamedFrom: z.ZodOptional<z.ZodString>;
+        untyped: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        input: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                boolean: "boolean";
+                number: "number";
+                text: "text";
+            }>;
+            required: z.ZodBoolean;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        from: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        revalidates: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>;
+    appVersion: z.ZodOptional<z.ZodString>;
+    origin: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AppSourcesPush = z.infer<typeof AppSourcesPushSchema>;
+/** A registry record as Studio sees it. */
+export type AppSourceRecord = AppSourceManifest & {
+    status: "active" | "missing";
+    hash: string;
+    appVersion: string | null;
+    syncedAt: string;
+};
+/** Brand set by `defineSource` in @visual-platform/next (a contract between SDK and CLI). */
+export declare const SOURCE_BRAND: unique symbol;
+/** Brand set by `defineAction`. */
+export declare const ACTION_BRAND: unique symbol;
+type JsonSchema = {
+    type?: string | string[];
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    enum?: unknown[];
+    default?: unknown;
+    format?: string;
+    anyOf?: JsonSchema[];
+    oneOf?: JsonSchema[];
+    title?: string;
+    description?: string;
+};
+/** JSON Schema of a Standard Schema (zod ≥ 4.2, valibot/arktype with the JSON Schema extension), or null. */
+export declare function jsonSchemaOf(schema: unknown, io: "input" | "output"): JsonSchema | null;
+/** DataField[] of an object JSON Schema (depth ≤ 3, ≤ 40 fields). */
+export declare function fieldsFromJsonSchema(s: JsonSchema, depth?: number): DataField[];
+/** Param specs of an object JSON Schema (input side: defaults make params optional). */
+export declare function paramsFromJsonSchema(s: JsonSchema): SourceParamSpec[];
+/**
+ * Metadata of the app's sources (what `vp sources push` sends). Never calls `resolve`.
+ * Shape: the `shape` schema, else the sample, else the value; params: the `params` schema.
+ */
+export declare function describeSources(entries: Record<string, unknown>): {
+    sources: AppSourceManifest[];
+    warnings: string[];
+};
+/** Metadata of the app's actions (what `vp sources push` sends). Never calls `run`. */
+export declare function describeActions(entries: Record<string, unknown>): {
+    actions: AppActionManifest[];
+    warnings: string[];
+};
+export type SourceBindingIssue = {
+    input: string;
+    code: "SOURCE_NOT_FOUND" | "SOURCE_MISSING" | "SOURCE_PARAM_INVALID";
+    message: string;
+};
+/** Check appSource inputs against the project's registry. */
+export declare function checkSourceBindings(inputs: readonly {
+    name: string;
+    source: string;
+    sourceRef?: string | undefined;
+    params?: ParamBindings | undefined;
+}[], registry: readonly Pick<AppSourceRecord, "name" | "status" | "params">[]): SourceBindingIssue[];
+export {};
+//# sourceMappingURL=app-sources.d.ts.map

package/dist/app-sources.d.ts.map

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

package/dist/app-sources.js

@@ -0,0 +1,287 @@
+import { z } from "zod";
+import { DataFieldSchema, inferFields } from "./data.js";
+/**
+ * App source registry (ADR-048 P2). `vp sources push` sends metadata only — name, params, fields,
+ * sample, visibility — never code or credentials. Studio lists them and lets editors pick one.
+ */
+export const SOURCE_NAME = /^[a-z][A-Za-z0-9]{0,39}$/;
+export const SOURCE_KINDS = ["value", "sync", "async", "provided"];
+export const SOURCE_VISIBILITIES = ["public", "segment", "private"];
+export const SOURCE_PARAM_TYPES = ["text", "number", "boolean"];
+export const MAX_APP_SOURCES = 100;
+export const SourceParamSpecSchema = z.object({
+    name: z.string().regex(/^[A-Za-z_][A-Za-z0-9_]{0,39}$/),
+    type: z.enum(SOURCE_PARAM_TYPES),
+    required: z.boolean(),
+    default: z.union([z.string().max(500), z.number(), z.boolean()]).optional(),
+    /** Allowed values (enum). */
+    options: z.array(z.union([z.string().max(100), z.number()])).max(50).optional(),
+    label: z.string().max(60).optional(),
+}).strict();
+export const AppSourceManifestSchema = z.object({
+    name: z.string().regex(SOURCE_NAME, "source names are camelCase, e.g. products"),
+    label: z.string().max(60).optional(),
+    description: z.string().max(300).optional(),
+    kind: z.enum(SOURCE_KINDS),
+    shape: z.enum(["list", "object"]),
+    fields: z.array(DataFieldSchema).max(40),
+    sample: z.unknown().optional(),
+    params: z.array(SourceParamSpecSchema).max(20),
+    visibility: z.enum(SOURCE_VISIBILITIES),
+    /** Keep the record (and every binding) when the source was renamed in code. */
+    renamedFrom: z.string().regex(SOURCE_NAME).optional(),
+    /** No shape/sample/value: Studio shows it untyped (free paths). */
+    untyped: z.boolean().optional(),
+}).strict().superRefine((s, ctx) => {
+    if (s.sample !== undefined && JSON.stringify(s.sample).length > 50_000)
+        ctx.addIssue({ code: "custom", path: ["sample"], message: "sample is limited to 50 KB" });
+    const names = new Set();
+    for (const p of s.params) {
+        if (names.has(p.name))
+            ctx.addIssue({ code: "custom", path: ["params"], message: `duplicate param "${p.name}"` });
+        names.add(p.name);
+    }
+});
+/** An app action (ADR-048 P4): a Server Action Studio events can trigger by name (onAddToCart…). */
+export const AppActionManifestSchema = z.object({
+    name: z.string().regex(/^on[A-Z][A-Za-z0-9]{0,47}$/, "action names are event names, e.g. onAddToCart"),
+    label: z.string().max(60).optional(),
+    description: z.string().max(300).optional(),
+    /** Typed input fields (from the input schema). */
+    input: z.array(SourceParamSpecSchema).max(20),
+    /** Input values the server reads from the block's data: field → path (item.id). */
+    from: z.record(z.string().regex(/^[A-Za-z_][A-Za-z0-9_]{0,39}$/), z.string().max(200)).optional(),
+    revalidates: z.array(z.string().regex(SOURCE_NAME)).max(20),
+}).strict();
+export const AppSourcesPushSchema = z.object({
+    sources: z.array(AppSourceManifestSchema).max(MAX_APP_SOURCES),
+    actions: z.array(AppActionManifestSchema).max(MAX_APP_SOURCES).optional(),
+    appVersion: z.string().max(60).optional(),
+    /** Commit or "local". */
+    origin: z.string().max(200).optional(),
+}).strict().superRefine((b, ctx) => {
+    const seen = new Set();
+    for (const s of b.sources) {
+        if (seen.has(s.name))
+            ctx.addIssue({ code: "custom", message: `duplicate source "${s.name}"` });
+        seen.add(s.name);
+    }
+    const acts = new Set();
+    for (const a of b.actions ?? []) {
+        if (acts.has(a.name))
+            ctx.addIssue({ code: "custom", message: `duplicate action "${a.name}"` });
+        acts.add(a.name);
+    }
+});
+// ---------- describing app sources (CLI side; no SDK import needed) ----------
+/** Brand set by `defineSource` in @visual-platform/next (a contract between SDK and CLI). */
+export const SOURCE_BRAND = Symbol.for("visual-platform.source");
+/** Brand set by `defineAction`. */
+export const ACTION_BRAND = Symbol.for("visual-platform.action");
+/** JSON Schema of a Standard Schema (zod ≥ 4.2, valibot/arktype with the JSON Schema extension), or null. */
+export function jsonSchemaOf(schema, io) {
+    const fn = schema?.["~standard"]?.jsonSchema?.[io];
+    if (typeof fn !== "function")
+        return null;
+    try {
+        return fn({ target: "draft-2020-12" });
+    }
+    catch {
+        return null;
+    }
+}
+const nonNull = (s) => {
+    const alts = s.anyOf ?? s.oneOf;
+    if (alts)
+        return alts.find((a) => a.type !== "null") ?? s;
+    if (Array.isArray(s.type))
+        return { ...s, type: s.type.find((t) => t !== "null") ?? "string" };
+    return s;
+};
+function fieldType(s) {
+    s = nonNull(s);
+    if (s.type === "array")
+        return "list";
+    if (s.type === "number" || s.type === "integer")
+        return "number";
+    if (s.type === "boolean")
+        return "boolean";
+    if (s.type === "object") {
+        const keys = Object.keys(s.properties ?? {});
+        return keys.includes("url") ? "image" : keys.includes("href") ? "link" : "object";
+    }
+    if (s.format === "date" || s.format === "date-time")
+        return "date";
+    if (s.format === "uri" || s.format === "url")
+        return "link";
+    return "text";
+}
+/** DataField[] of an object JSON Schema (depth ≤ 3, ≤ 40 fields). */
+export function fieldsFromJsonSchema(s, depth = 0) {
+    s = nonNull(s);
+    const out = [];
+    for (const [name, raw] of Object.entries(s.properties ?? {})) {
+        if (!/^[A-Za-z_][A-Za-z0-9_]{0,39}$/.test(name) || out.length >= 40)
+            continue;
+        const p = nonNull(raw);
+        const type = fieldType(p);
+        const f = { name, type };
+        if (p.title)
+            f.label = p.title.slice(0, 60);
+        if (depth < 3 && type === "list" && p.items)
+            f.fields = fieldsFromJsonSchema(p.items, depth + 1);
+        if (depth < 3 && type === "object")
+            f.fields = fieldsFromJsonSchema(p, depth + 1);
+        out.push(f);
+    }
+    return out;
+}
+/** Param specs of an object JSON Schema (input side: defaults make params optional). */
+export function paramsFromJsonSchema(s) {
+    s = nonNull(s);
+    const required = new Set(s.required ?? []);
+    return Object.entries(s.properties ?? {}).slice(0, 20).flatMap(([name, raw]) => {
+        if (!/^[A-Za-z_][A-Za-z0-9_]{0,39}$/.test(name))
+            return [];
+        const p = nonNull(raw);
+        const t = p.type === "number" || p.type === "integer" ? "number" : p.type === "boolean" ? "boolean" : "text";
+        const spec = { name, type: t, required: required.has(name) && p.default === undefined };
+        if (typeof p.default === "string" || typeof p.default === "number" || typeof p.default === "boolean")
+            spec.default = p.default;
+        const opts = p.enum?.filter((x) => typeof x === "string" || typeof x === "number");
+        if (opts?.length)
+            spec.options = opts.slice(0, 50);
+        if (p.title)
+            spec.label = p.title.slice(0, 60);
+        return [spec];
+    });
+}
+/**
+ * Metadata of the app's sources (what `vp sources push` sends). Never calls `resolve`.
+ * Shape: the `shape` schema, else the sample, else the value; params: the `params` schema.
+ */
+export function describeSources(entries) {
+    const sources = [];
+    const warnings = [];
+    for (const [name, entry] of Object.entries(entries)) {
+        if (!SOURCE_NAME.test(name)) {
+            warnings.push(`"${name}": names must be camelCase (skipped)`);
+            continue;
+        }
+        const branded = !!entry && typeof entry === "object" && entry[SOURCE_BRAND] === true;
+        const def = branded ? entry : typeof entry === "function" ? { resolve: entry } : { value: entry };
+        const kind = def.value !== undefined ? "value" : def.provided ? "provided" : "async";
+        const example = def.sample !== undefined ? def.sample : def.value;
+        const shapeJs = def.shape ? jsonSchemaOf(def.shape, "output") : null;
+        let shape = Array.isArray(example) ? "list" : "object";
+        let fields = [];
+        if (shapeJs) {
+            const s = nonNull(shapeJs);
+            shape = s.type === "array" ? "list" : "object";
+            fields = fieldsFromJsonSchema(s.type === "array" ? s.items ?? {} : s);
+        }
+        else if (example !== undefined && example !== null) {
+            fields = inferFields(Array.isArray(example) ? example.slice(0, 20) : [example]);
+        }
+        if (def.shape && !shapeJs)
+            warnings.push(`"${name}": its shape schema has no JSON Schema export — fields come from the sample`);
+        const untyped = !fields.length;
+        if (untyped)
+            warnings.push(`"${name}": no shape or sample — Studio shows it untyped (add shape or sample)`);
+        let params = [];
+        if (def.params) {
+            const js = jsonSchemaOf(def.params, "input");
+            if (js)
+                params = paramsFromJsonSchema(js);
+            else
+                warnings.push(`"${name}": its params schema has no JSON Schema export — Studio cannot offer its params`);
+        }
+        const vis = def.visibility === "segment" || def.visibility === "private" ? def.visibility : "public";
+        let sample = example;
+        if (vis === "private" && def.sample === undefined)
+            sample = undefined; // never push real per-user values
+        if (sample !== undefined && JSON.stringify(sample).length > 50_000) {
+            warnings.push(`"${name}": sample over 50 KB (not sent)`);
+            sample = undefined;
+        }
+        sources.push({
+            name, kind, shape, fields, params, visibility: vis,
+            ...(typeof def.label === "string" ? { label: def.label.slice(0, 60) } : {}),
+            ...(typeof def.description === "string" ? { description: def.description.slice(0, 300) } : {}),
+            ...(sample !== undefined ? { sample } : {}),
+            ...(typeof def.renamedFrom === "string" ? { renamedFrom: def.renamedFrom } : {}),
+            ...(untyped ? { untyped: true } : {}),
+        });
+    }
+    return { sources, warnings };
+}
+/** Metadata of the app's actions (what `vp sources push` sends). Never calls `run`. */
+export function describeActions(entries) {
+    const actions = [];
+    const warnings = [];
+    for (const [name, entry] of Object.entries(entries)) {
+        if (!/^on[A-Z][A-Za-z0-9]{0,47}$/.test(name)) {
+            warnings.push(`action "${name}": names are event names like onAddToCart (skipped)`);
+            continue;
+        }
+        if (!entry || typeof entry !== "object" || entry[ACTION_BRAND] !== true) {
+            warnings.push(`action "${name}": use defineAction() (skipped)`);
+            continue;
+        }
+        const a = entry;
+        let input = [];
+        if (a.input) {
+            const js = jsonSchemaOf(a.input, "input");
+            if (js)
+                input = paramsFromJsonSchema(js);
+            else
+                warnings.push(`action "${name}": its input schema has no JSON Schema export`);
+        }
+        const from = a.from && typeof a.from === "object" ? Object.fromEntries(Object.entries(a.from).filter((e) => typeof e[1] === "string")) : undefined;
+        actions.push({
+            name, input, revalidates: Array.isArray(a.revalidates) ? a.revalidates.filter((x) => typeof x === "string" && SOURCE_NAME.test(x)) : [],
+            ...(typeof a.label === "string" ? { label: a.label.slice(0, 60) } : {}),
+            ...(typeof a.description === "string" ? { description: a.description.slice(0, 300) } : {}),
+            ...(from && Object.keys(from).length ? { from } : {}),
+        });
+    }
+    return { actions, warnings };
+}
+/** Check appSource inputs against the project's registry. */
+export function checkSourceBindings(inputs, registry) {
+    const byName = new Map(registry.map((r) => [r.name, r]));
+    const issues = [];
+    for (const i of inputs) {
+        if (i.source !== "appSource" || !i.sourceRef)
+            continue;
+        const rec = byName.get(i.sourceRef);
+        if (!rec) {
+            issues.push({ input: i.name, code: "SOURCE_NOT_FOUND", message: `the app has no source "${i.sourceRef}" (run vp sources push)` });
+            continue;
+        }
+        if (rec.status === "missing") {
+            issues.push({ input: i.name, code: "SOURCE_MISSING", message: `source "${i.sourceRef}" was removed from the app` });
+            continue;
+        }
+        const specs = new Map(rec.params.map((p) => [p.name, p]));
+        for (const [pname, b] of Object.entries(i.params ?? {})) {
+            const spec = specs.get(pname);
+            if (!spec) {
+                issues.push({ input: i.name, code: "SOURCE_PARAM_INVALID", message: `source "${i.sourceRef}" has no param "${pname}"` });
+                continue;
+            }
+            if (b.kind === "literal" && b.value !== null) {
+                const ok = spec.type === "number" ? typeof b.value === "number" : spec.type === "boolean" ? typeof b.value === "boolean" : typeof b.value === "string";
+                if (!ok)
+                    issues.push({ input: i.name, code: "SOURCE_PARAM_INVALID", message: `param "${pname}" expects ${spec.type}` });
+                else if (spec.options && !spec.options.includes(b.value))
+                    issues.push({ input: i.name, code: "SOURCE_PARAM_INVALID", message: `param "${pname}" must be one of ${spec.options.join(", ")}` });
+            }
+        }
+        for (const spec of rec.params)
+            if (spec.required && !(spec.name in (i.params ?? {})))
+                issues.push({ input: i.name, code: "SOURCE_PARAM_INVALID", message: `param "${spec.name}" is required` });
+    }
+    return issues;
+}
+//# sourceMappingURL=app-sources.js.map

package/dist/app-sources.js.map

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

package/dist/component.d.ts

@@ -8,6 +8,11 @@ import { type ComponentNode } from "./page-document.js";
 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";
+/**
+ * Wrapper of a component placed on a page (ADR-052): `display: contents` (layout unchanged) carrying the
+ * placement's lifecycle and animation (+ the component's own defaults). Inserted at expansion only when used.
+ */
+export declare const COMPONENT_SCOPE_TYPE = "VisualComponentScope";
 export declare const COMPONENT_PROP_TYPES: readonly ["text", "textarea", "image", "link", "icon", "number", "boolean", "select"];
 export declare const ComponentPropSchema: z.ZodObject<{
     name: z.ZodString;
@@ -56,11 +61,13 @@ export declare const ComponentDocumentSchema: z.ZodObject<{
     defaultLocale: z.ZodString;
     translations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
     theme: z.ZodOptional<z.ZodString>;
+    designSystemId: 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";
+            appSource: "appSource";
             table: "table";
         }>>;
         shape: z.ZodEnum<{
@@ -85,7 +92,96 @@ export declare const ComponentDocumentSchema: z.ZodObject<{
             locale: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>>;
         single: z.ZodOptional<z.ZodBoolean>;
+        sourceRef: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodLazy<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"literal">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"page-locale">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"route-param">;
+            name: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"query-param">;
+            name: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"context">;
+            key: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"source">;
+            path: z.ZodString;
+        }, z.core.$strict>], "kind">>>>;
+        fallback: z.ZodOptional<z.ZodLazy<z.ZodEnum<{
+            empty: "empty";
+            hide: "hide";
+            sample: "sample";
+        }>>>;
     }, z.core.$strict>>>>;
+    flows: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            type: z.ZodEnum<{
+                boolean: "boolean";
+                number: "number";
+                text: "text";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        steps: z.ZodArray<z.ZodType<import("./flows.js").FlowStep, unknown, z.core.$ZodTypeInternals<import("./flows.js").FlowStep, unknown>>>;
+        onError: z.ZodOptional<z.ZodArray<z.ZodType<import("./flows.js").FlowStep, unknown, z.core.$ZodTypeInternals<import("./flows.js").FlowStep, unknown>>>>;
+    }, z.core.$strict>>>>;
+    lifecycle: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+        mount: z.ZodOptional<z.ZodString>;
+        unmount: z.ZodOptional<z.ZodString>;
+        visible: z.ZodOptional<z.ZodString>;
+        leave: z.ZodOptional<z.ZodString>;
+        visibleOnce: z.ZodOptional<z.ZodBoolean>;
+        every: z.ZodOptional<z.ZodObject<{
+            run: z.ZodString;
+            ms: z.ZodNumber;
+            max: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+    animation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+        entrance: z.ZodOptional<z.ZodObject<{
+            duration: z.ZodOptional<z.ZodNumber>;
+            delay: z.ZodOptional<z.ZodNumber>;
+            easing: z.ZodOptional<z.ZodString>;
+            preset: z.ZodString;
+            trigger: z.ZodOptional<z.ZodEnum<{
+                mount: "mount";
+                visible: "visible";
+            }>>;
+            once: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        hover: z.ZodOptional<z.ZodObject<{
+            preset: z.ZodString;
+            duration: z.ZodOptional<z.ZodNumber>;
+            easing: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        loop: z.ZodOptional<z.ZodObject<{
+            duration: z.ZodOptional<z.ZodNumber>;
+            delay: z.ZodOptional<z.ZodNumber>;
+            easing: z.ZodOptional<z.ZodString>;
+            preset: z.ZodString;
+            iterations: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"infinite">]>>;
+        }, z.core.$strict>>;
+        scroll: z.ZodOptional<z.ZodObject<{
+            preset: z.ZodString;
+            range: z.ZodOptional<z.ZodEnum<{
+                cover: "cover";
+                enter: "enter";
+                exit: "exit";
+            }>>;
+        }, z.core.$strict>>;
+        stagger: z.ZodOptional<z.ZodObject<{
+            ms: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
     disabledLocales: z.ZodOptional<z.ZodArray<z.ZodString>>;
     childrenSlot: z.ZodOptional<z.ZodObject<{
         nodeId: z.ZodString;
@@ -122,7 +218,7 @@ export declare function applyComponent(doc: ComponentDocument, opts?: {
     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[];
+export declare function withTheme(nodes: ComponentNode[], theme: string | undefined, id: string, designSystemId?: 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). */