@visual-platform/contracts 0.0.0-stage → 0.1.0

package/dist/page-document.d.ts

@@ -0,0 +1,202 @@
+import { z } from "zod";
+import { type DataInput, type NodeBindings } from "./data.js";
+/** Current canonical document schema version. Bump only through an RFC + migration. */
+export declare const PAGE_DOCUMENT_SCHEMA_VERSION: 1;
+/** Stable node id assigned by the server: `n_` + nanoid (blueprint 31 §5). */
+export declare const NodeIdSchema: z.ZodString;
+/**
+ * Plugin-owned data, namespaced by plugin id, each with its own schema version `v`
+ * (blueprint 35 §4). Stripped from published documents.
+ */
+export declare const ExtensionDataSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    v: z.ZodNumber;
+}, z.core.$loose>>;
+export type ExtensionData = z.infer<typeof ExtensionDataSchema>;
+export declare const NodeMetaSchema: z.ZodObject<{
+    origin: z.ZodOptional<z.ZodEnum<{
+        ai: "ai";
+        migration: "migration";
+        user: "user";
+    }>>;
+}, z.core.$strict>;
+export type ComponentNode = {
+    id: string;
+    type: string;
+    props: Record<string, unknown>;
+    /** Tailwind utility classes applied to the block's root element (ADR-029). */
+    className?: string | undefined;
+    /** Element events bound to app event names, e.g. { submit: "onSubscribe" } (ADR-032). */
+    events?: Partial<Record<"click" | "change" | "blur" | "enter" | "submit" | "reset" | "toggle", string>> | undefined;
+    /** Props bound to data fields, e.g. { title: { path: "item.name" } }; props keep the fallback (ADR-034). */
+    bind?: NodeBindings | undefined;
+    slots?: Record<string, ComponentNode[]> | undefined;
+    dataBinding?: Record<string, unknown> | undefined;
+    ext?: ExtensionData | undefined;
+    meta?: z.infer<typeof NodeMetaSchema> | undefined;
+};
+export declare const ComponentNodeSchema: z.ZodType<ComponentNode>;
+export declare const RootPropsSchema: z.ZodObject<{
+    seo: z.ZodObject<{
+        slug: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        canonical: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        robots: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            index: z.ZodBoolean;
+            follow: z.ZodBoolean;
+        }, z.core.$strict>>>;
+        og: z.ZodOptional<z.ZodObject<{
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            image: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+                url: z.ZodString;
+                alt: z.ZodOptional<z.ZodString>;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                assetId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                assetId: z.ZodString;
+                alt: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                decorative: z.ZodOptional<z.ZodBoolean>;
+                focal: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strict>>;
+            }, z.core.$strict>]>>>;
+        }, z.core.$strict>>;
+        structuredData: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            template: z.ZodEnum<{
+                Article: "Article";
+                BreadcrumbList: "BreadcrumbList";
+                Event: "Event";
+                FAQPage: "FAQPage";
+                Offer: "Offer";
+                Organization: "Organization";
+                Product: "Product";
+            }>;
+            fields: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    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>>>>;
+}, z.core.$catchall<z.ZodUnknown>>;
+export declare const PageDocumentSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    locale: z.ZodString;
+    root: z.ZodObject<{
+        props: z.ZodObject<{
+            seo: z.ZodObject<{
+                slug: z.ZodString;
+                title: z.ZodString;
+                description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                canonical: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                robots: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    index: z.ZodBoolean;
+                    follow: z.ZodBoolean;
+                }, z.core.$strict>>>;
+                og: z.ZodOptional<z.ZodObject<{
+                    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    image: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+                        url: z.ZodString;
+                        alt: z.ZodOptional<z.ZodString>;
+                        width: z.ZodOptional<z.ZodNumber>;
+                        height: z.ZodOptional<z.ZodNumber>;
+                        assetId: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>, z.ZodObject<{
+                        assetId: z.ZodString;
+                        alt: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                        decorative: z.ZodOptional<z.ZodBoolean>;
+                        focal: z.ZodOptional<z.ZodObject<{
+                            x: z.ZodNumber;
+                            y: z.ZodNumber;
+                        }, z.core.$strict>>;
+                    }, z.core.$strict>]>>>;
+                }, z.core.$strict>>;
+                structuredData: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    template: z.ZodEnum<{
+                        Article: "Article";
+                        BreadcrumbList: "BreadcrumbList";
+                        Event: "Event";
+                        FAQPage: "FAQPage";
+                        Offer: "Offer";
+                        Organization: "Organization";
+                        Product: "Product";
+                    }>;
+                    fields: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>;
+            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>>>>;
+        }, z.core.$catchall<z.ZodUnknown>>;
+        ext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            v: z.ZodNumber;
+        }, z.core.$loose>>>;
+    }, z.core.$strict>;
+    nodes: z.ZodArray<z.ZodType<ComponentNode, unknown, z.core.$ZodTypeInternals<ComponentNode, unknown>>>;
+}, z.core.$strict>;
+export type PageDocument = z.infer<typeof PageDocumentSchema>;
+export type { DataInput };
+/** Depth-first walk over every node, including nodes inside slots. */
+export declare function walkNodes(nodes: readonly ComponentNode[]): Generator<ComponentNode>;
+/** Remove all plugin `ext` data — used when building published documents (blueprint 52 Prepare step 10). */
+export declare function stripExtensions(doc: PageDocument): PageDocument;
+//# sourceMappingURL=page-document.d.ts.map

package/dist/page-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-document.d.ts","sourceRoot":"","sources":["../src/page-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAwC,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAEpG,uFAAuF;AACvF,eAAO,MAAM,4BAA4B,EAAG,CAAU,CAAC;AAEvD,8EAA8E;AAC9E,eAAO,MAAM,YAAY,aAA+E,CAAC;AAEzG;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;kBAG/B,CAAC;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,cAAc;;;;;;kBAEhB,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,yFAAyF;IACzF,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IACpH,4GAA4G;IAC5G,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,GAAG,SAAS,CAAC;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAClD,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,GAAG,SAAS,CAAC;CACnD,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAexD,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAOJ,CAAC;AAEzB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAOpB,CAAC;AACZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,sEAAsE;AACtE,wBAAiB,SAAS,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,CAAC,aAAa,CAAC,CAKpF;AAED,4GAA4G;AAC5G,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAW/D"}

package/dist/page-document.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { PageSeoSchema } from "./seo.js";
+import { ClassNameSchema } from "./classes.js";
+import { EventBindingsSchema } from "./events.js";
+import { DataInputsSchema, NodeBindingsSchema } from "./data.js";
+/** Current canonical document schema version. Bump only through an RFC + migration. */
+export const PAGE_DOCUMENT_SCHEMA_VERSION = 1;
+/** Stable node id assigned by the server: `n_` + nanoid (blueprint 31 §5). */
+export const NodeIdSchema = z.string().regex(/^n_[A-Za-z0-9_-]{6,}$/, "node id must look like n_xxxxxx");
+/**
+ * Plugin-owned data, namespaced by plugin id, each with its own schema version `v`
+ * (blueprint 35 §4). Stripped from published documents.
+ */
+export const ExtensionDataSchema = z.record(z.string().regex(/^[a-z][a-z0-9-]*(\.[a-z][a-z0-9-]*)+$/, "ext key must be a plugin id like group.name"), z.looseObject({ v: z.number().int().positive() }));
+export const NodeMetaSchema = z
+    .object({ origin: z.enum(["user", "ai", "migration"]).optional() })
+    .strict();
+export const ComponentNodeSchema = z.lazy(() => z
+    .object({
+    id: NodeIdSchema,
+    type: z.string().regex(/^[A-Z][A-Za-z0-9]*$/, "component type must be PascalCase"),
+    props: z.record(z.string(), z.unknown()),
+    className: z.lazy(() => ClassNameSchema).optional(),
+    events: z.lazy(() => EventBindingsSchema).optional(),
+    bind: z.lazy(() => NodeBindingsSchema).optional(),
+    slots: z.record(z.string(), z.array(ComponentNodeSchema)).optional(),
+    dataBinding: z.record(z.string(), z.unknown()).optional(),
+    ext: ExtensionDataSchema.optional(),
+    meta: NodeMetaSchema.optional(),
+})
+    .strict());
+export const RootPropsSchema = z
+    .object({
+    seo: PageSeoSchema,
+    theme: z.string().optional(),
+    /** Data inputs this page reads (ADR-034). */
+    data: z.lazy(() => DataInputsSchema).optional(),
+})
+    .catchall(z.unknown());
+export const PageDocumentSchema = z
+    .object({
+    schemaVersion: z.literal(PAGE_DOCUMENT_SCHEMA_VERSION),
+    locale: z.string().regex(/^[a-z]{2,3}(-[A-Z]{2})?$/, "locale must look like vi or en-SG"),
+    root: z.object({ props: RootPropsSchema, ext: ExtensionDataSchema.optional() }).strict(),
+    nodes: z.array(ComponentNodeSchema),
+})
+    .strict();
+/** Depth-first walk over every node, including nodes inside slots. */
+export function* walkNodes(nodes) {
+    for (const node of nodes) {
+        yield node;
+        if (node.slots)
+            for (const children of Object.values(node.slots))
+                yield* walkNodes(children);
+    }
+}
+/** Remove all plugin `ext` data — used when building published documents (blueprint 52 Prepare step 10). */
+export function stripExtensions(doc) {
+    const strip = (n) => {
+        const { ext: _ext, slots, ...rest } = n;
+        return slots
+            ? { ...rest, slots: Object.fromEntries(Object.entries(slots).map(([k, v]) => [k, v.map(strip)])) }
+            : rest;
+    };
+    const { ext: _rootExt, ...root } = doc.root;
+    // Data samples are for the editor only (ADR-034).
+    if (Array.isArray(root.props.data))
+        root.props = { ...root.props, data: root.props.data.map(({ sample: _s, ...d }) => d) };
+    return { ...doc, root, nodes: doc.nodes.map(strip) };
+}
+//# sourceMappingURL=page-document.js.map

package/dist/page-document.js.map

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

package/dist/published.d.ts

@@ -0,0 +1,353 @@
+import { z } from "zod";
+/** Published API contract `/v1` (blueprint 71 §3). Shared by apps/delivery-api and the SDK. */
+export declare const PUBLISHED_API_VERSION: "v1";
+export declare const ReleaseRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    sequence: z.ZodNumber;
+    manifestHash: z.ZodString;
+}, z.core.$strip>;
+export declare const ResolvedPageSchema: z.ZodObject<{
+    project: z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$strip>;
+    release: z.ZodObject<{
+        id: z.ZodString;
+        sequence: z.ZodNumber;
+        manifestHash: z.ZodString;
+    }, z.core.$strip>;
+    locale: z.ZodObject<{
+        requested: z.ZodString;
+        content: z.ZodString;
+        dir: z.ZodOptional<z.ZodEnum<{
+            ltr: "ltr";
+            rtl: "rtl";
+        }>>;
+    }, z.core.$strip>;
+    page: z.ZodObject<{
+        pageKey: z.ZodString;
+        slug: z.ZodString;
+        artifactId: z.ZodString;
+        versionId: z.ZodString;
+        versionNumber: z.ZodNumber;
+        schemaVersion: z.ZodNumber;
+        document: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            locale: z.ZodString;
+            root: z.ZodObject<{
+                props: z.ZodObject<{
+                    seo: z.ZodObject<{
+                        slug: z.ZodString;
+                        title: z.ZodString;
+                        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        canonical: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        robots: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                            index: z.ZodBoolean;
+                            follow: z.ZodBoolean;
+                        }, z.core.$strict>>>;
+                        og: z.ZodOptional<z.ZodObject<{
+                            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            image: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+                                url: z.ZodString;
+                                alt: z.ZodOptional<z.ZodString>;
+                                width: z.ZodOptional<z.ZodNumber>;
+                                height: z.ZodOptional<z.ZodNumber>;
+                                assetId: z.ZodOptional<z.ZodString>;
+                            }, z.core.$strict>, z.ZodObject<{
+                                assetId: z.ZodString;
+                                alt: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                                decorative: z.ZodOptional<z.ZodBoolean>;
+                                focal: z.ZodOptional<z.ZodObject<{
+                                    x: z.ZodNumber;
+                                    y: z.ZodNumber;
+                                }, z.core.$strict>>;
+                            }, z.core.$strict>]>>>;
+                        }, z.core.$strict>>;
+                        structuredData: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            template: z.ZodEnum<{
+                                Article: "Article";
+                                BreadcrumbList: "BreadcrumbList";
+                                Event: "Event";
+                                FAQPage: "FAQPage";
+                                Offer: "Offer";
+                                Organization: "Organization";
+                                Product: "Product";
+                            }>;
+                            fields: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                        }, z.core.$strict>>>;
+                    }, z.core.$strict>;
+                    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>>>>;
+                }, z.core.$catchall<z.ZodUnknown>>;
+                ext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    v: z.ZodNumber;
+                }, z.core.$loose>>>;
+            }, z.core.$strict>;
+            nodes: z.ZodArray<z.ZodType<import("./page-document.js").ComponentNode, unknown, z.core.$ZodTypeInternals<import("./page-document.js").ComponentNode, unknown>>>;
+        }, z.core.$strict>;
+    }, z.core.$strip>;
+    seo: z.ZodObject<{
+        slug: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        canonical: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        robots: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            index: z.ZodBoolean;
+            follow: z.ZodBoolean;
+        }, z.core.$strict>>>;
+        og: z.ZodOptional<z.ZodObject<{
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            image: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+                url: z.ZodString;
+                alt: z.ZodOptional<z.ZodString>;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                assetId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                assetId: z.ZodString;
+                alt: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                decorative: z.ZodOptional<z.ZodBoolean>;
+                focal: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strict>>;
+            }, z.core.$strict>]>>>;
+        }, z.core.$strict>>;
+        structuredData: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            template: z.ZodEnum<{
+                Article: "Article";
+                BreadcrumbList: "BreadcrumbList";
+                Event: "Event";
+                FAQPage: "FAQPage";
+                Offer: "Offer";
+                Organization: "Organization";
+                Product: "Product";
+            }>;
+            fields: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    alternates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        locale: z.ZodString;
+        slug: z.ZodString;
+    }, z.core.$strip>>>;
+    defaultLocale: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    design: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        vars: z.ZodRecord<z.ZodString, z.ZodString>;
+        themes: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>;
+        fonts: z.ZodArray<z.ZodObject<{
+            family: z.ZodString;
+            faces: z.ZodArray<z.ZodObject<{
+                weight: z.ZodNumber;
+                style: z.ZodEnum<{
+                    italic: "italic";
+                    normal: "normal";
+                }>;
+                url: z.ZodString;
+                format: z.ZodEnum<{
+                    opentype: "opentype";
+                    truetype: "truetype";
+                    woff: "woff";
+                    woff2: "woff2";
+                }>;
+                unicodeRange: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    styles: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    compatibility: z.ZodObject<{
+        schemaVersion: z.ZodNumber;
+        minimumSdkVersion: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ResolvedPage = z.infer<typeof ResolvedPageSchema>;
+export declare const PageListSchema: z.ZodObject<{
+    release: z.ZodObject<{
+        id: z.ZodString;
+        sequence: z.ZodNumber;
+        manifestHash: z.ZodString;
+    }, z.core.$strip>;
+    pages: z.ZodArray<z.ZodObject<{
+        pageKey: z.ZodString;
+        locale: z.ZodString;
+        slug: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PageList = z.infer<typeof PageListSchema>;
+export declare const ApiErrorSchema: z.ZodObject<{
+    error: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** `GET /v1/projects/:projectId/components/:id/resolved` — a composed component pinned by the current release (ADR-028). */
+export declare const ResolvedComponentSchema: z.ZodObject<{
+    project: z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$strip>;
+    release: z.ZodObject<{
+        id: z.ZodString;
+        sequence: z.ZodNumber;
+        manifestHash: z.ZodString;
+    }, z.core.$strip>;
+    component: z.ZodObject<{
+        id: z.ZodString;
+        versionId: z.ZodString;
+        versionNumber: z.ZodNumber;
+        document: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            nodes: z.ZodArray<z.ZodType<import("./page-document.js").ComponentNode, unknown, z.core.$ZodTypeInternals<import("./page-document.js").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>;
+    }, z.core.$strip>;
+    design: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        vars: z.ZodRecord<z.ZodString, z.ZodString>;
+        themes: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>;
+        fonts: z.ZodArray<z.ZodObject<{
+            family: z.ZodString;
+            faces: z.ZodArray<z.ZodObject<{
+                weight: z.ZodNumber;
+                style: z.ZodEnum<{
+                    italic: "italic";
+                    normal: "normal";
+                }>;
+                url: z.ZodString;
+                format: z.ZodEnum<{
+                    opentype: "opentype";
+                    truetype: "truetype";
+                    woff: "woff";
+                    woff2: "woff2";
+                }>;
+                unicodeRange: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    styles: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    locales: z.ZodOptional<z.ZodNullable<z.ZodLazy<z.ZodRecord<z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        nativeName: z.ZodString;
+        dir: z.ZodEnum<{
+            ltr: "ltr";
+            rtl: "rtl";
+        }>;
+    }, z.core.$strip>>>>>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ResolvedComponent = z.infer<typeof ResolvedComponentSchema>;
+/** `GET /v1/projects/:projectId/classes` — Tailwind classes used by the current release (for apps that build their own CSS). */
+export declare const ReleaseClassesSchema: z.ZodObject<{
+    release: z.ZodObject<{
+        id: z.ZodString;
+        sequence: z.ZodNumber;
+        manifestHash: z.ZodString;
+    }, z.core.$strip>;
+    classes: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type ReleaseClasses = z.infer<typeof ReleaseClassesSchema>;
+/** `GET /v1/projects/:projectId/locales` — languages of the current release (ADR-035). */
+export declare const LocaleListSchema: z.ZodObject<{
+    release: z.ZodObject<{
+        id: z.ZodString;
+        sequence: z.ZodNumber;
+        manifestHash: z.ZodString;
+    }, z.core.$strip>;
+    defaultLocale: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    locales: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        name: z.ZodString;
+        nativeName: z.ZodString;
+        dir: z.ZodEnum<{
+            ltr: "ltr";
+            rtl: "rtl";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LocaleList = z.infer<typeof LocaleListSchema>;
+//# sourceMappingURL=published.d.ts.map

package/dist/published.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"published.d.ts","sourceRoot":"","sources":["../src/published.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,+FAA+F;AAC/F,eAAO,MAAM,qBAAqB,EAAG,IAAa,CAAC;AAEnD,eAAO,MAAM,gBAAgB;;;;iBAI3B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0B7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,cAAc;;;;;;;;;;;iBAGzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,cAAc;;;;;iBAA2E,CAAC;AAEvG,4HAA4H;AAC5H,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,gIAAgI;AAChI,eAAO,MAAM,oBAAoB;;;;;;;iBAAwE,CAAC;AAC1G,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;iBAI3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}