@visual-platform/contracts 0.0.0-stage → 0.2.0

package/dist/published.js

@@ -0,0 +1,66 @@
+import { LocaleMapSchema } from "./locales.js";
+import { z } from "zod";
+import { PageDocumentSchema } from "./page-document.js";
+import { PageSeoSchema } from "./seo.js";
+import { DesignSnapshotSchema } from "./design.js";
+import { ComponentDocumentSchema } from "./component.js";
+/** Published API contract `/v1` (blueprint 71 §3). Shared by apps/delivery-api and the SDK. */
+export const PUBLISHED_API_VERSION = "v1";
+export const ReleaseRefSchema = z.object({
+    id: z.string(),
+    sequence: z.number().int(),
+    manifestHash: z.string(),
+});
+export const ResolvedPageSchema = z.object({
+    project: z.object({ id: z.string() }),
+    release: ReleaseRefSchema,
+    /** dir: text direction of the content locale (ADR-035); older releases omit it. */
+    locale: z.object({ requested: z.string(), content: z.string(), dir: z.enum(["ltr", "rtl"]).optional() }),
+    page: z.object({
+        pageKey: z.string(),
+        slug: z.string(),
+        artifactId: z.string(),
+        versionId: z.string(),
+        versionNumber: z.number().int(),
+        schemaVersion: z.number().int(),
+        document: PageDocumentSchema,
+    }),
+    seo: PageSeoSchema,
+    /** The same page in the release's other languages (hreflang, language switchers). */
+    alternates: z.array(z.object({ locale: z.string(), slug: z.string() })).optional(),
+    /** Project default language (hreflang x-default). */
+    defaultLocale: z.string().nullable().optional(),
+    /** Results of the page's data-table inputs (ADR-041), by input name. */
+    data: z.record(z.string(), z.unknown()).optional(),
+    /** Design pinned by the release (tokens, themes, fonts). Absent/null → SDK default tokens. */
+    design: DesignSnapshotSchema.nullable().optional(),
+    /** Compiled CSS for the Tailwind classes in the release, scoped to [data-vp-root] (ADR-029). */
+    styles: z.string().nullable().optional(),
+    compatibility: z.object({ schemaVersion: z.number().int(), minimumSdkVersion: z.string() }),
+});
+export const PageListSchema = z.object({
+    release: ReleaseRefSchema,
+    pages: z.array(z.object({ pageKey: z.string(), locale: z.string(), slug: z.string() })),
+});
+export const ApiErrorSchema = z.object({ error: z.object({ code: z.string(), message: z.string() }) });
+/** `GET /v1/projects/:projectId/components/:id/resolved` — a composed component pinned by the current release (ADR-028). */
+export const ResolvedComponentSchema = z.object({
+    project: z.object({ id: z.string() }),
+    release: ReleaseRefSchema,
+    component: z.object({ id: z.string(), versionId: z.string(), versionNumber: z.number().int(), document: ComponentDocumentSchema }),
+    design: DesignSnapshotSchema.nullable().optional(),
+    styles: z.string().nullable().optional(),
+    /** Locales of the release with their text direction (ADR-035). */
+    locales: z.lazy(() => LocaleMapSchema).nullable().optional(),
+    /** Results of the component's data-table inputs (ADR-041). */
+    data: z.record(z.string(), z.unknown()).optional(),
+});
+/** `GET /v1/projects/:projectId/classes` — Tailwind classes used by the current release (for apps that build their own CSS). */
+export const ReleaseClassesSchema = z.object({ release: ReleaseRefSchema, classes: z.array(z.string()) });
+/** `GET /v1/projects/:projectId/locales` — languages of the current release (ADR-035). */
+export const LocaleListSchema = z.object({
+    release: ReleaseRefSchema,
+    defaultLocale: z.string().nullable().optional(),
+    locales: z.array(z.object({ code: z.string(), name: z.string(), nativeName: z.string(), dir: z.enum(["ltr", "rtl"]) })),
+});
+//# sourceMappingURL=published.js.map

package/dist/published.js.map

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

package/dist/references.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+/** Reference to another artifact (blueprint 22 §2). `latest` is an alias policy, never a version. */
+export declare const ArtifactReferenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    mode: z.ZodLiteral<"fixed">;
+    artifactId: z.ZodString;
+    versionId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    mode: z.ZodLiteral<"alias">;
+    aliasKey: z.ZodString;
+}, z.core.$strict>], "mode">;
+export type ArtifactReference = z.infer<typeof ArtifactReferenceSchema>;
+/** Asset field value (blueprint 27, 32 field type `asset`). */
+export declare const AssetRefSchema: 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>;
+export type AssetRef = z.infer<typeof AssetRefSchema>;
+/** Link field value (blueprint 32 field type `link`, rule `link.protocol`). */
+export declare const LinkRefSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"page">;
+    pageKey: z.ZodString;
+    anchor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"url">;
+    href: z.ZodString;
+}, z.core.$strict>], "kind">;
+export type LinkRef = z.infer<typeof LinkRefSchema>;
+/**
+ * Icon field value (Lucide, ADR-026): the SVG geometry is embedded so customer apps need no icon
+ * library. Only plain shape elements with geometry attributes — no script, style, href or events.
+ */
+export declare const IconValueSchema: z.ZodObject<{
+    set: z.ZodLiteral<"lucide">;
+    name: z.ZodString;
+    nodes: z.ZodArray<z.ZodTuple<[z.ZodEnum<{
+        circle: "circle";
+        ellipse: "ellipse";
+        line: "line";
+        path: "path";
+        polygon: "polygon";
+        polyline: "polyline";
+        rect: "rect";
+    }>, z.ZodRecord<z.ZodString, z.ZodString>], null>>;
+}, z.core.$strict>;
+export type IconValue = z.infer<typeof IconValueSchema>;
+//# sourceMappingURL=references.d.ts.map

package/dist/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../src/references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qGAAqG;AACrG,eAAO,MAAM,uBAAuB;;;;;;;4BAGlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,+DAA+D;AAC/D,eAAO,MAAM,cAAc;;;;;;;;kBAOhB,CAAC;AACZ,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAItD,+EAA+E;AAC/E,eAAO,MAAM,aAAa;;;;;;;4BAGxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAGpD;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;kBAOjB,CAAC;AACZ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/references.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+/** Reference to another artifact (blueprint 22 §2). `latest` is an alias policy, never a version. */
+export const ArtifactReferenceSchema = z.discriminatedUnion("mode", [
+    z.object({ mode: z.literal("fixed"), artifactId: z.string().min(1), versionId: z.string().min(1) }).strict(),
+    z.object({ mode: z.literal("alias"), aliasKey: z.string().min(1) }).strict(),
+]);
+/** Asset field value (blueprint 27, 32 field type `asset`). */
+export const AssetRefSchema = z
+    .object({
+    assetId: z.string().min(1),
+    alt: z.record(z.string(), z.string()).optional(),
+    decorative: z.boolean().optional(),
+    focal: z.object({ x: z.number().min(0).max(1), y: z.number().min(0).max(1) }).strict().optional(),
+})
+    .strict();
+const SAFE_URL = /^(https:\/\/|mailto:|tel:)/i;
+/** Link field value (blueprint 32 field type `link`, rule `link.protocol`). */
+export const LinkRefSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("page"), pageKey: z.string().min(1), anchor: z.string().optional() }).strict(),
+    z.object({ kind: z.literal("url"), href: z.string().regex(SAFE_URL, "only https, mailto and tel links are allowed") }).strict(),
+]);
+const ICON_TAGS = ["path", "circle", "rect", "line", "polyline", "polygon", "ellipse"];
+/**
+ * Icon field value (Lucide, ADR-026): the SVG geometry is embedded so customer apps need no icon
+ * library. Only plain shape elements with geometry attributes — no script, style, href or events.
+ */
+export const IconValueSchema = z.object({
+    set: z.literal("lucide"),
+    name: z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/),
+    nodes: z.array(z.tuple([
+        z.enum(ICON_TAGS),
+        z.record(z.string().regex(/^(?:d|cx|cy|r|rx|ry|x|y|x1|y1|x2|y2|width|height|points)$/), z.string().regex(/^[0-9a-zA-Z .,-]{1,2000}$/)),
+    ])).min(1).max(40),
+}).strict();
+//# sourceMappingURL=references.js.map

package/dist/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../src/references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qGAAqG;AACrG,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAClE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5G,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;CAC7E,CAAC,CAAC;AAGH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAChD,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClG,CAAC;KACD,MAAM,EAAE,CAAC;AAGZ,MAAM,QAAQ,GAAG,6BAA6B,CAAC;AAE/C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACxD,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACzG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,8CAA8C,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;CAChI,CAAC,CAAC;AAGH,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAChG;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,4BAA4B,CAAC;IACpD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QACrB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;QACjB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,2DAA2D,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;KACvI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;CACnB,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/responsive.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+/** Breakpoint keys come from the design system (blueprint 26 §3). `base` is mandatory there. */
+export declare const BreakpointKeySchema: z.ZodString;
+export type BreakpointKey = z.infer<typeof BreakpointKeySchema>;
+/**
+ * A prop value that may vary per breakpoint (blueprint 26 §4):
+ *   T | { "$responsive": { base?: T, md?: T, ... } }
+ * Missing breakpoints inherit from the nearest smaller one.
+ */
+export declare function responsive<T extends z.ZodType>(value: T): z.ZodUnion<readonly [T, z.ZodObject<{
+    $responsive: z.ZodRecord<z.ZodString, T>;
+}, z.core.$strict>]>;
+export type ResponsiveValue<T> = T | {
+    $responsive: Partial<Record<BreakpointKey, T>>;
+};
+export declare function isResponsive<T>(v: ResponsiveValue<T>): v is {
+    $responsive: Partial<Record<BreakpointKey, T>>;
+};
+//# sourceMappingURL=responsive.d.ts.map

package/dist/responsive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsive.d.ts","sourceRoot":"","sources":["../src/responsive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gGAAgG;AAChG,eAAO,MAAM,mBAAmB,aAAsE,CAAC;AACvG,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;;qBAKvD;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC;AAExF,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI;IAAE,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAA;CAAE,CAE9G"}

package/dist/responsive.js

@@ -0,0 +1,18 @@
+import { z } from "zod";
+/** Breakpoint keys come from the design system (blueprint 26 §3). `base` is mandatory there. */
+export const BreakpointKeySchema = z.string().regex(/^[a-z0-9]+$/, "breakpoint key must be [a-z0-9]+");
+/**
+ * A prop value that may vary per breakpoint (blueprint 26 §4):
+ *   T | { "$responsive": { base?: T, md?: T, ... } }
+ * Missing breakpoints inherit from the nearest smaller one.
+ */
+export function responsive(value) {
+    return z.union([
+        value,
+        z.object({ $responsive: z.record(BreakpointKeySchema, value) }).strict(),
+    ]);
+}
+export function isResponsive(v) {
+    return typeof v === "object" && v !== null && "$responsive" in v;
+}
+//# sourceMappingURL=responsive.js.map

package/dist/responsive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsive.js","sourceRoot":"","sources":["../src/responsive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gGAAgG;AAChG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,kCAAkC,CAAC,CAAC;AAGvG;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAsB,KAAQ;IACtD,OAAO,CAAC,CAAC,KAAK,CAAC;QACb,KAAK;QACL,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;KACzE,CAAC,CAAC;AACL,CAAC;AAID,MAAM,UAAU,YAAY,CAAI,CAAqB;IACnD,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,aAAa,IAAI,CAAC,CAAC;AACnE,CAAC"}

package/dist/section.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { type ComponentNode } from "./page-document.js";
+/** Reusable section stored at Project scope (blueprint 22, 24). No SEO/locale: pages own those. */
+export declare const SectionDocumentSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    nodes: z.ZodArray<z.ZodType<ComponentNode, unknown, z.core.$ZodTypeInternals<ComponentNode, unknown>>>;
+}, z.core.$strict>;
+export type SectionDocument = z.infer<typeof SectionDocumentSchema>;
+/** Node type that places a shared section on a page. */
+export declare const SECTION_REF_TYPE = "SectionRef";
+/**
+ * `follow`: use the section's latest published version at each release of the page's site (alias-like).
+ * `fixed`: pin one immutable version.
+ */
+export declare const SectionRefPropsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    mode: z.ZodLiteral<"follow">;
+    sectionId: z.ZodString;
+}, z.core.$loose>, z.ZodObject<{
+    mode: z.ZodLiteral<"fixed">;
+    sectionId: z.ZodString;
+    versionId: z.ZodString;
+}, z.core.$loose>], "mode">;
+export type SectionRefProps = z.infer<typeof SectionRefPropsSchema>;
+export declare function sectionRefs(nodes: readonly ComponentNode[]): {
+    nodeId: string;
+    props: SectionRefProps | null;
+}[];
+/**
+ * Replace SectionRef nodes with the section's nodes (delivery-time expansion). Child ids are
+ * namespaced with the ref id so they stay unique when a section is used twice on a page.
+ */
+export declare function expandSectionRefs(nodes: readonly ComponentNode[], resolve: (ref: SectionRefProps) => ComponentNode[] | null): ComponentNode[];
+//# sourceMappingURL=section.d.ts.map

package/dist/section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.d.ts","sourceRoot":"","sources":["../src/section.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAgE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEtH,mGAAmG;AACnG,eAAO,MAAM,qBAAqB;;;kBAO9B,CAAC;AACL,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,wDAAwD;AACxD,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;2BAGhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;CAAE,EAAE,CAQhH;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,aAAa,EAAE,GAAG,IAAI,GAAG,aAAa,EAAE,CAgB7I"}

package/dist/section.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import { ComponentNodeSchema, PAGE_DOCUMENT_SCHEMA_VERSION, walkNodes } from "./page-document.js";
+/** Reusable section stored at Project scope (blueprint 22, 24). No SEO/locale: pages own those. */
+export const SectionDocumentSchema = z
+    .object({ schemaVersion: z.literal(PAGE_DOCUMENT_SCHEMA_VERSION), nodes: z.array(ComponentNodeSchema).min(1, "a section needs at least one block") })
+    .strict()
+    .superRefine((doc, ctx) => {
+    for (const n of walkNodes(doc.nodes)) {
+        if (n.type === SECTION_REF_TYPE)
+            ctx.addIssue({ code: "custom", path: ["nodes"], message: "sections cannot contain other sections (no nesting in v1)" });
+    }
+});
+/** Node type that places a shared section on a page. */
+export const SECTION_REF_TYPE = "SectionRef";
+/**
+ * `follow`: use the section's latest published version at each release of the page's site (alias-like).
+ * `fixed`: pin one immutable version.
+ */
+export const SectionRefPropsSchema = z.discriminatedUnion("mode", [
+    z.object({ mode: z.literal("follow"), sectionId: z.string().uuid() }).passthrough(),
+    z.object({ mode: z.literal("fixed"), sectionId: z.string().uuid(), versionId: z.string().uuid() }).passthrough(),
+]);
+export function sectionRefs(nodes) {
+    const out = [];
+    for (const n of walkNodes(nodes)) {
+        if (n.type !== SECTION_REF_TYPE)
+            continue;
+        const r = SectionRefPropsSchema.safeParse(n.props);
+        out.push({ nodeId: n.id, props: r.success ? r.data : null });
+    }
+    return out;
+}
+/**
+ * Replace SectionRef nodes with the section's nodes (delivery-time expansion). Child ids are
+ * namespaced with the ref id so they stay unique when a section is used twice on a page.
+ */
+export function expandSectionRefs(nodes, resolve) {
+    const prefix = (refId, n) => {
+        const id = `${refId}_${n.id.replace(/^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, ...(slots ? { slots } : {}) };
+    };
+    const walk = (list) => list.flatMap((n) => {
+        if (n.type === SECTION_REF_TYPE) {
+            const r = SectionRefPropsSchema.safeParse(n.props);
+            const resolved = r.success ? resolve(r.data) : null;
+            return resolved ? resolved.map((c) => prefix(n.id, c)) : [];
+        }
+        return n.slots ? [{ ...n, slots: Object.fromEntries(Object.entries(n.slots).map(([k, v]) => [k, walk(v)])) }] : [n];
+    });
+    return walk(nodes);
+}
+//# sourceMappingURL=section.js.map

package/dist/section.js.map

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

package/dist/seo.d.ts

@@ -0,0 +1,98 @@
+import { z } from "zod";
+/** Allowlisted JSON-LD templates (blueprint 51 §A3). Free-form JSON-LD is not allowed. */
+export declare const StructuredDataTemplateSchema: z.ZodEnum<{
+    Article: "Article";
+    BreadcrumbList: "BreadcrumbList";
+    Event: "Event";
+    FAQPage: "FAQPage";
+    Offer: "Offer";
+    Organization: "Organization";
+    Product: "Product";
+}>;
+export declare const RobotsSchema: z.ZodObject<{
+    index: z.ZodBoolean;
+    follow: z.ZodBoolean;
+}, z.core.$strict>;
+/** Social image by URL (https; usually from the asset library, which also records assetId/size). */
+export declare const SeoImageSchema: 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>;
+export type SeoImage = z.infer<typeof SeoImageSchema>;
+/**
+ * JSON-LD block from an allowlisted schema.org type (blueprint 51 §A3): `fields` become the object's
+ * properties, `@context`/`@type` are added on output. Plain JSON only, at most 20 KB.
+ */
+export declare const StructuredDataSchema: 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>;
+export type StructuredData = z.infer<typeof StructuredDataSchema>;
+/** The JSON-LD object for one block (escape `<` when embedding in HTML). */
+export declare const jsonLd: (b: StructuredData) => {
+    "@context": string;
+    "@type": "Article" | "BreadcrumbList" | "Event" | "FAQPage" | "Offer" | "Organization" | "Product";
+};
+/**
+ * All blocks of a page as ONE JSON-LD document (one `<script>`): a single block is returned as is,
+ * several become `{ "@context", "@graph": [...] }` (schema.org's way to describe several things).
+ * Null when the page has none.
+ */
+export declare const jsonLdDocument: (blocks: readonly StructuredData[] | undefined | null) => Record<string, unknown> | null;
+/** Starter fields per template, for editors. */
+export declare const STRUCTURED_DATA_STARTERS: Record<z.infer<typeof StructuredDataTemplateSchema>, Record<string, unknown>>;
+/** Page-level SEO at `root.props.seo`. `null` means "inherit from site defaults". */
+export declare const PageSeoSchema: 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>;
+export type PageSeo = z.infer<typeof PageSeoSchema>;
+//# sourceMappingURL=seo.d.ts.map

package/dist/seo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,0FAA0F;AAC1F,eAAO,MAAM,4BAA4B;;;;;;;;EAEvC,CAAC;AAEH,eAAO,MAAM,YAAY;;;kBAAiE,CAAC;AAE3F,oGAAoG;AACpG,eAAO,MAAM,cAAc;;;;;;kBAMhB,CAAC;AACZ,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;kBAK7B,CAAC;AACL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,4EAA4E;AAC5E,eAAO,MAAM,MAAM,MAAO,cAAc;;;CAA6E,CAAC;AAEtH;;;;GAIG;AACH,eAAO,MAAM,cAAc,WAAY,SAAS,cAAc,EAAE,GAAG,SAAS,GAAG,IAAI,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAI/G,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQlH,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAiBf,CAAC;AACZ,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/seo.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { AssetRefSchema } from "./references.js";
+/** Allowlisted JSON-LD templates (blueprint 51 §A3). Free-form JSON-LD is not allowed. */
+export const StructuredDataTemplateSchema = z.enum([
+    "Article", "Product", "Offer", "FAQPage", "BreadcrumbList", "Organization", "Event",
+]);
+export const RobotsSchema = z.object({ index: z.boolean(), follow: z.boolean() }).strict();
+/** Social image by URL (https; usually from the asset library, which also records assetId/size). */
+export const SeoImageSchema = z.object({
+    url: z.string().regex(/^https:\/\/\S+$/, "the image must be an https URL"),
+    alt: z.string().max(200).optional(),
+    width: z.number().int().positive().optional(),
+    height: z.number().int().positive().optional(),
+    assetId: z.string().optional(),
+}).strict();
+/**
+ * JSON-LD block from an allowlisted schema.org type (blueprint 51 §A3): `fields` become the object's
+ * properties, `@context`/`@type` are added on output. Plain JSON only, at most 20 KB.
+ */
+export const StructuredDataSchema = z.object({ template: StructuredDataTemplateSchema, fields: z.record(z.string(), z.unknown()) }).strict()
+    .superRefine((b, ctx) => {
+    const text = JSON.stringify(b.fields);
+    if (text.length > 20_000)
+        ctx.addIssue({ code: "custom", message: "structured data is limited to 20 KB" });
+    if (Object.keys(b.fields).some((k) => k.startsWith("@") && k !== "@id"))
+        ctx.addIssue({ code: "custom", message: "@context and @type are added automatically" });
+});
+/** The JSON-LD object for one block (escape `<` when embedding in HTML). */
+export const jsonLd = (b) => ({ "@context": "https://schema.org", "@type": b.template, ...b.fields });
+/**
+ * All blocks of a page as ONE JSON-LD document (one `<script>`): a single block is returned as is,
+ * several become `{ "@context", "@graph": [...] }` (schema.org's way to describe several things).
+ * Null when the page has none.
+ */
+export const jsonLdDocument = (blocks) => {
+    if (!blocks?.length)
+        return null;
+    if (blocks.length === 1)
+        return jsonLd(blocks[0]);
+    return { "@context": "https://schema.org", "@graph": blocks.map((b) => ({ "@type": b.template, ...b.fields })) };
+};
+/** Starter fields per template, for editors. */
+export const STRUCTURED_DATA_STARTERS = {
+    Article: { headline: "", description: "", image: "", datePublished: "", author: { "@type": "Organization", name: "" } },
+    Product: { name: "", description: "", image: "", brand: { "@type": "Brand", name: "" }, offers: { "@type": "Offer", price: "", priceCurrency: "VND", availability: "https://schema.org/InStock" } },
+    Offer: { name: "", price: "", priceCurrency: "VND", availability: "https://schema.org/InStock", url: "" },
+    FAQPage: { mainEntity: [{ "@type": "Question", name: "", acceptedAnswer: { "@type": "Answer", text: "" } }] },
+    BreadcrumbList: { itemListElement: [{ "@type": "ListItem", position: 1, name: "", item: "" }] },
+    Organization: { name: "", url: "", logo: "", sameAs: [] },
+    Event: { name: "", startDate: "", endDate: "", location: { "@type": "Place", name: "", address: "" }, image: "", description: "" },
+};
+/** Page-level SEO at `root.props.seo`. `null` means "inherit from site defaults". */
+export const PageSeoSchema = z
+    .object({
+    slug: z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "slug must be lowercase kebab-case"),
+    title: z.string().min(1).max(120),
+    description: z.string().max(320).nullable().optional(),
+    canonical: z.string().url().nullable().optional(),
+    robots: RobotsSchema.nullable().optional(),
+    og: z
+        .object({
+        title: z.string().nullable().optional(),
+        description: z.string().nullable().optional(),
+        image: z.union([SeoImageSchema, AssetRefSchema]).nullable().optional(),
+    })
+        .strict()
+        .optional(),
+    structuredData: z.array(StructuredDataSchema).max(10).optional(),
+})
+    .strict();
+//# sourceMappingURL=seo.js.map

package/dist/seo.js.map

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