@elytracms/core 0.0.6

package/dist/design-tokens/tokens.d.ts

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+export declare const tokenValueSchema: z.ZodUnion<readonly [z.ZodObject<{
+    value: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    ref: z.ZodString;
+}, z.core.$strip>]>;
+export type TokenValue = z.infer<typeof tokenValueSchema>;
+/** A semantic colour role with its light and dark resolutions. */
+export declare const colorTokenSchema: z.ZodObject<{
+    name: z.ZodString;
+    role: z.ZodString;
+    light: z.ZodUnion<readonly [z.ZodObject<{
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        ref: z.ZodString;
+    }, z.core.$strip>]>;
+    dark: z.ZodUnion<readonly [z.ZodObject<{
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        ref: z.ZodString;
+    }, z.core.$strip>]>;
+}, z.core.$strip>;
+export type ColorToken = z.infer<typeof colorTokenSchema>;
+/**
+ * The semantic colour roles. Order is meaningful: it drives the emitted CSS-variable order and
+ * the style-guide swatch order. Cool-slate neutrals + a confident cobalt primary; monospace and
+ * status colours (success/warning/destructive/info) are first-class.
+ */
+export declare const colorTokens: readonly ColorToken[];
+/** A scale step (radius, font size, spacing) — a name mapped to a CSS length. */
+export declare const scaleStepSchema: z.ZodObject<{
+    name: z.ZodString;
+    value: z.ZodString;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ScaleStep = z.infer<typeof scaleStepSchema>;
+/** Base radius; the Tailwind theme derives sm/md/lg/xl from it. */
+export declare const radiusBase = "0.5rem";
+/** The type scale (Tailwind's default rem steps), documented for the style guide. */
+export declare const typeScale: readonly ScaleStep[];
+/** The spacing scale used by the named layout primitives (Stack/Row/Grid `gap`). */
+export declare const spacingScale: readonly ScaleStep[];
+/** The radius scale derived from {@link radiusBase}. */
+export declare const radiusScale: readonly ScaleStep[];
+/** The fonts the system standardises on. */
+export declare const fonts: {
+    readonly sans: "'Hanken Grotesk Variable', ui-sans-serif, system-ui, sans-serif";
+    readonly mono: "'JetBrains Mono Variable', ui-monospace, 'SF Mono', monospace";
+};
+/** The full token set — the single source of truth. */
+export declare const designTokens: {
+    readonly colors: readonly {
+        name: string;
+        role: string;
+        light: {
+            ref: string;
+        } | {
+            value: string;
+        };
+        dark: {
+            ref: string;
+        } | {
+            value: string;
+        };
+    }[];
+    readonly radiusBase: "0.5rem";
+    readonly typeScale: readonly {
+        name: string;
+        value: string;
+        note?: string | undefined;
+    }[];
+    readonly spacingScale: readonly {
+        name: string;
+        value: string;
+        note?: string | undefined;
+    }[];
+    readonly radiusScale: readonly {
+        name: string;
+        value: string;
+        note?: string | undefined;
+    }[];
+    readonly fonts: {
+        readonly sans: "'Hanken Grotesk Variable', ui-sans-serif, system-ui, sans-serif";
+        readonly mono: "'JetBrains Mono Variable', ui-monospace, 'SF Mono', monospace";
+    };
+};
+export type DesignTokens = typeof designTokens;
+/** A colour mode. */
+export type ColorMode = 'light' | 'dark';

package/dist/design-tokens/tokens.js

@@ -0,0 +1,112 @@
+import { z } from 'zod';
+/**
+ * Canonical design tokens (brief §8, EC-091/092). One typed source of truth for the visual
+ * system: semantic color roles with light/dark values, plus radius, type scale and spacing
+ * scale. The Studio's Tailwind theme, the generated CSS-variable export (EC-093) and the visual
+ * style guide (EC-094) all derive from these — so there is no drift between them.
+ *
+ * Colours are OKLCH (perceptually uniform; predictable light/dark pairs). A token value is
+ * either a literal colour or a reference to another token (so `*-foreground` roles can track
+ * `foreground` without duplicating its value).
+ */
+const colorRefSchema = z.object({ ref: z.string().min(1) });
+const colorLiteralSchema = z.object({ value: z.string().min(1) });
+export const tokenValueSchema = z.union([colorLiteralSchema, colorRefSchema]);
+/** A semantic colour role with its light and dark resolutions. */
+export const colorTokenSchema = z.object({
+    name: z.string().min(1),
+    /** Human description of the role — surfaced in the style guide. */
+    role: z.string(),
+    light: tokenValueSchema,
+    dark: tokenValueSchema,
+});
+const lit = (value) => ({ value });
+const ref = (name) => ({ ref: name });
+/**
+ * The semantic colour roles. Order is meaningful: it drives the emitted CSS-variable order and
+ * the style-guide swatch order. Cool-slate neutrals + a confident cobalt primary; monospace and
+ * status colours (success/warning/destructive/info) are first-class.
+ */
+export const colorTokens = [
+    { name: 'background', role: 'App canvas background', light: lit('oklch(0.985 0.002 250)'), dark: lit('oklch(0.176 0.012 264)') },
+    { name: 'foreground', role: 'Primary text', light: lit('oklch(0.21 0.02 264)'), dark: lit('oklch(0.95 0.005 250)') },
+    { name: 'card', role: 'Card surface', light: lit('oklch(1 0 0)'), dark: lit('oklch(0.205 0.013 264)') },
+    { name: 'card-foreground', role: 'Text on cards', light: ref('foreground'), dark: ref('foreground') },
+    { name: 'panel', role: 'Inspector / rail surface', light: lit('oklch(0.974 0.003 255)'), dark: lit('oklch(0.196 0.013 264)') },
+    { name: 'panel-foreground', role: 'Text on panels', light: ref('foreground'), dark: ref('foreground') },
+    { name: 'popover', role: 'Floating surface', light: lit('oklch(1 0 0)'), dark: lit('oklch(0.214 0.013 264)') },
+    { name: 'popover-foreground', role: 'Text on popovers', light: ref('foreground'), dark: ref('foreground') },
+    { name: 'muted', role: 'Subtle fill', light: lit('oklch(0.955 0.004 255)'), dark: lit('oklch(0.256 0.013 264)') },
+    { name: 'muted-foreground', role: 'Secondary text', light: lit('oklch(0.5 0.018 260)'), dark: lit('oklch(0.66 0.02 258)') },
+    { name: 'border', role: 'Hairline borders', light: lit('oklch(0.908 0.005 260)'), dark: lit('oklch(0.278 0.013 264)') },
+    { name: 'input', role: 'Form control borders', light: lit('oklch(0.908 0.005 260)'), dark: lit('oklch(0.3 0.013 264)') },
+    { name: 'ring', role: 'Focus ring', light: lit('oklch(0.55 0.17 256)'), dark: lit('oklch(0.66 0.16 256)') },
+    { name: 'primary', role: 'Primary action (cobalt)', light: lit('oklch(0.55 0.17 256)'), dark: lit('oklch(0.66 0.16 256)') },
+    { name: 'primary-foreground', role: 'Text on primary', light: lit('oklch(0.99 0.005 250)'), dark: lit('oklch(0.16 0.02 264)') },
+    { name: 'secondary', role: 'Secondary action', light: lit('oklch(0.955 0.004 255)'), dark: lit('oklch(0.256 0.013 264)') },
+    { name: 'secondary-foreground', role: 'Text on secondary', light: lit('oklch(0.3 0.02 264)'), dark: lit('oklch(0.92 0.005 250)') },
+    { name: 'accent', role: 'Selected / emphasis fill', light: lit('oklch(0.95 0.022 256)'), dark: lit('oklch(0.288 0.03 256)') },
+    { name: 'accent-foreground', role: 'Text on accent', light: lit('oklch(0.36 0.07 256)'), dark: lit('oklch(0.88 0.03 256)') },
+    { name: 'success', role: 'Success / valid', light: lit('oklch(0.58 0.13 150)'), dark: lit('oklch(0.7 0.14 150)') },
+    { name: 'success-foreground', role: 'Text on success', light: lit('oklch(0.99 0.01 150)'), dark: lit('oklch(0.16 0.03 150)') },
+    { name: 'warning', role: 'Warning', light: lit('oklch(0.68 0.14 70)'), dark: lit('oklch(0.79 0.14 75)') },
+    { name: 'warning-foreground', role: 'Text on warning', light: lit('oklch(0.24 0.04 70)'), dark: lit('oklch(0.2 0.04 75)') },
+    { name: 'destructive', role: 'Error / destructive', light: lit('oklch(0.57 0.2 27)'), dark: lit('oklch(0.67 0.18 25)') },
+    { name: 'destructive-foreground', role: 'Text on destructive', light: lit('oklch(0.99 0.01 27)'), dark: lit('oklch(0.16 0.03 25)') },
+    { name: 'info', role: 'Informational / bound', light: lit('oklch(0.56 0.12 248)'), dark: lit('oklch(0.7 0.13 245)') },
+    { name: 'info-foreground', role: 'Text on info', light: lit('oklch(0.99 0.01 248)'), dark: lit('oklch(0.16 0.03 245)') },
+    { name: 'grid-line', role: 'Canvas grid lines', light: lit('oklch(0.8 0.01 260 / 0.5)'), dark: lit('oklch(0.5 0.012 264 / 0.32)') },
+];
+/** A scale step (radius, font size, spacing) — a name mapped to a CSS length. */
+export const scaleStepSchema = z.object({
+    name: z.string(),
+    value: z.string(),
+    /** Optional note shown in the style guide. */
+    note: z.string().optional(),
+});
+/** Base radius; the Tailwind theme derives sm/md/lg/xl from it. */
+export const radiusBase = '0.5rem';
+/** The type scale (Tailwind's default rem steps), documented for the style guide. */
+export const typeScale = [
+    { name: 'xs', value: '0.75rem', note: 'Captions, code chips' },
+    { name: 'sm', value: '0.875rem', note: 'Body small, labels' },
+    { name: 'base', value: '1rem', note: 'Body' },
+    { name: 'lg', value: '1.125rem', note: 'Lead' },
+    { name: 'xl', value: '1.25rem', note: 'H4' },
+    { name: '2xl', value: '1.5rem', note: 'H3' },
+    { name: '3xl', value: '1.875rem', note: 'H2' },
+    { name: '4xl', value: '2.25rem', note: 'H1' },
+    { name: '5xl', value: '3rem', note: 'Display' },
+];
+/** The spacing scale used by the named layout primitives (Stack/Row/Grid `gap`). */
+export const spacingScale = [
+    { name: 'px', value: '1px' },
+    { name: '1', value: '0.25rem' },
+    { name: '2', value: '0.5rem' },
+    { name: '3', value: '0.75rem' },
+    { name: '4', value: '1rem' },
+    { name: '6', value: '1.5rem' },
+    { name: '8', value: '2rem' },
+];
+/** The radius scale derived from {@link radiusBase}. */
+export const radiusScale = [
+    { name: 'sm', value: 'calc(0.5rem - 4px)' },
+    { name: 'md', value: 'calc(0.5rem - 2px)' },
+    { name: 'lg', value: '0.5rem' },
+    { name: 'xl', value: 'calc(0.5rem + 4px)' },
+];
+/** The fonts the system standardises on. */
+export const fonts = {
+    sans: "'Hanken Grotesk Variable', ui-sans-serif, system-ui, sans-serif",
+    mono: "'JetBrains Mono Variable', ui-monospace, 'SF Mono', monospace",
+};
+/** The full token set — the single source of truth. */
+export const designTokens = {
+    colors: colorTokens,
+    radiusBase,
+    typeScale,
+    spacingScale,
+    radiusScale,
+    fonts,
+};
+//# sourceMappingURL=tokens.js.map

package/dist/design-tokens/tokens.js.map

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

package/dist/export-sync/builder-source.d.ts

@@ -0,0 +1,85 @@
+import { z } from 'zod';
+import type { ComponentManifest } from '@elytracms/core/component-registry';
+import type { RedirectRecord, RouteRecord } from '@elytracms/core/cms-core';
+import type { DataSource } from '@elytracms/core/data-binding';
+import type { ExportMode } from './core';
+import type { ExportSource } from './sync';
+/**
+ * Wire shape of `GET …/registry-sync/snapshot` (served by the builder's Convex
+ * deployment). EC-207: routes/redirects are config-sourced (authored in
+ * `elytra.config.ts`), so the snapshot no longer carries them — the schema omits
+ * them entirely and the source reads routes/redirects from the resolved config.
+ */
+export declare const builderSnapshotSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    mode: z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+    }>;
+    environment: z.ZodString;
+    project: z.ZodNullable<z.ZodObject<{
+        name: z.ZodString;
+        slug: z.ZodString;
+    }, z.core.$strip>>;
+    localeConfig: z.ZodObject<{
+        default: z.ZodString;
+        locales: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    collections: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodDefault<z.ZodEnum<{
+            asset: "asset";
+            document: "document";
+        }>>;
+        fields: z.ZodDefault<z.ZodArray<z.ZodType<import("@elytracms/core/cms-core").FieldDef, unknown, z.core.$ZodTypeInternals<import("@elytracms/core/cms-core").FieldDef, unknown>>>>;
+        form: z.ZodOptional<z.ZodObject<{
+            label: z.ZodOptional<z.ZodString>;
+            labelSingular: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            groups: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            tabs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        localized: z.ZodOptional<z.ZodBoolean>;
+        titleField: z.ZodOptional<z.ZodString>;
+        singleton: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    graph: z.ZodNullable<z.ZodObject<{
+        revision: z.ZodNumber;
+        serializedGraph: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type BuilderSnapshot = z.infer<typeof builderSnapshotSchema>;
+export interface HttpBuilderSourceConfig {
+    /** Builder deployment origin serving the HTTP actions, e.g. `https://<name>.convex.site`. */
+    baseUrl: string;
+    projectId: string;
+    /** Bearer CLI token (EC-150) — same token the registry sync client uses. */
+    token?: string;
+    /** Publishing environment whose pinned revision serves `published` mode (default: `production`). */
+    environment?: string;
+    /** Code-owned component manifests (primitives + project manifests) with their real schemas. */
+    manifests?: readonly ComponentManifest[];
+    /** Host-declared data sources (not persisted builder-side in v1). */
+    sources?: readonly DataSource[];
+    /**
+     * Config-sourced route table (EC-207): the resolved `elytra.config.ts`
+     * `routes` array. Authoritative when non-empty; when omitted/empty the source
+     * synthesizes the `/` → `page/home` fallback per locale.
+     */
+    routes?: readonly RouteRecord[];
+    /** Config-sourced redirects (EC-207): the resolved config's `redirects` array. */
+    redirects?: readonly RedirectRecord[];
+    /** Import specifier for the host repo's components module (eject wiring). */
+    componentsImport?: string;
+    /** Injected for tests; defaults to global `fetch`. */
+    fetchImpl?: typeof fetch;
+}
+/** Fetch + validate one snapshot. Exposed for hosts that want the raw payload. */
+export declare function fetchBuilderSnapshot(config: Pick<HttpBuilderSourceConfig, 'baseUrl' | 'projectId' | 'token' | 'environment' | 'fetchImpl'>, mode: ExportMode): Promise<BuilderSnapshot>;
+/**
+ * Create the HTTP-backed {@link ExportSource}. `loadInput` throws a
+ * {@link RegistrySyncTransportError} with a structured message on transport/auth
+ * failures, a malformed snapshot, or a mode with no graph revision to serve —
+ * everything else is data the canonical validators report on.
+ */
+export declare function createHttpBuilderSource(config: HttpBuilderSourceConfig): ExportSource;

package/dist/export-sync/builder-source.js

@@ -0,0 +1,124 @@
+import { z } from 'zod';
+import { collectionDefSchema, localeConfigSchema } from '@elytracms/core/cms-core';
+import { emitTokensCss } from '@elytracms/core/design-tokens';
+import { parseProjectGraph } from '@elytracms/core/project-graph';
+import { registrySyncEndpoints, registrySyncRequest, RegistrySyncTransportError, } from './registry-sync-client';
+/**
+ * The live builder {@link ExportSource} (EC-157): `builder typegen` and `builder check`
+ * read the canonical model from the builder deployment's snapshot endpoint
+ * (`GET …/registry-sync/snapshot`, Bearer CLI token) instead of a fixture. The
+ * snapshot carries only what the builder persists as data: the graph revision for the
+ * requested mode (published = the publishing-state-pinned revision per environment,
+ * draft = latest), plus locale config as a placeholder.
+ *
+ * Several inputs are config-sourced / host-supplied, NOT carried by the snapshot
+ * (mirroring `@elytracms/next`'s live content wiring — the backend does not persist
+ * them):
+ *
+ * - `routes` / `redirects` — authored in `elytra.config.ts` and resolved by
+ *   studio-core (EC-207). They are config, never backend data: the bin feeds the
+ *   resolved config's `routes`/`redirects` arrays here. The snapshot no longer
+ *   carries a route table (its `routes`/`redirects` fields are optional/ignored).
+ * - `sources` — data-source declarations bindings resolve against. Without them
+ *   every graph binding reports `unresolved-binding`, so a host whose graph binds
+ *   data MUST declare its sources.
+ * - `manifests` — the component manifests are code-owned (defined in TS next to the
+ *   components), not persisted builder-side, so the host supplies the full set
+ *   (`basePrimitives().manifests` plus the project's own manifests) with their REAL
+ *   prop schemas. The builder snapshot no longer carries manifest records.
+ *
+ * Route fallback: when no config routes are supplied the source maps `/` to the
+ * conventional home page document (`page/home`) for every configured locale — the
+ * same convention as the example host's live content source (EC-187: pages are
+ * documents). Config routes, when present, are authoritative and replace the fallback.
+ */
+const graphRevisionPayloadSchema = z.object({
+    revision: z.number(),
+    serializedGraph: z.string(),
+});
+/**
+ * Wire shape of `GET …/registry-sync/snapshot` (served by the builder's Convex
+ * deployment). EC-207: routes/redirects are config-sourced (authored in
+ * `elytra.config.ts`), so the snapshot no longer carries them — the schema omits
+ * them entirely and the source reads routes/redirects from the resolved config.
+ */
+export const builderSnapshotSchema = z.object({
+    projectId: z.string().min(1),
+    mode: z.enum(['published', 'draft']),
+    environment: z.string().min(1),
+    project: z.object({ name: z.string(), slug: z.string() }).nullable(),
+    localeConfig: localeConfigSchema,
+    collections: z.array(collectionDefSchema),
+    /** `null` when the requested mode/environment has no graph revision to serve. */
+    graph: graphRevisionPayloadSchema.nullable(),
+});
+/** Default-route fallback when the config supplies no route records (see module doc). */
+function fallbackRoutes(snapshot) {
+    return snapshot.localeConfig.locales.map((locale) => ({
+        id: `route-home-${locale}`,
+        pattern: '/',
+        locale,
+        document: { collection: 'page', id: 'home' },
+    }));
+}
+/** Fetch + validate one snapshot. Exposed for hosts that want the raw payload. */
+export async function fetchBuilderSnapshot(config, mode) {
+    const endpoints = registrySyncEndpoints(config.baseUrl, config.projectId);
+    const environment = config.environment ?? 'production';
+    const url = `${endpoints.snapshot}?mode=${mode}&environment=${encodeURIComponent(environment)}`;
+    const payload = await registrySyncRequest(config.fetchImpl ?? fetch, url, 'GET', config.token);
+    const parsed = builderSnapshotSchema.safeParse(payload);
+    if (!parsed.success) {
+        throw new RegistrySyncTransportError(`Builder snapshot from ${url} is malformed: ${parsed.error.issues[0]?.message ?? 'unknown error'}.`);
+    }
+    return parsed.data;
+}
+/**
+ * Create the HTTP-backed {@link ExportSource}. `loadInput` throws a
+ * {@link RegistrySyncTransportError} with a structured message on transport/auth
+ * failures, a malformed snapshot, or a mode with no graph revision to serve —
+ * everything else is data the canonical validators report on.
+ */
+export function createHttpBuilderSource(config) {
+    return {
+        async loadInput(mode) {
+            const snapshot = await fetchBuilderSnapshot(config, mode);
+            if (snapshot.graph === null) {
+                throw new RegistrySyncTransportError(mode === 'published'
+                    ? `Project "${snapshot.projectId}" has no published revision pinned for environment "${snapshot.environment}" — publish first, or run with --mode draft.`
+                    : `Project "${snapshot.projectId}" has no graph revisions yet.`);
+            }
+            const parsedGraph = parseProjectGraph(snapshot.graph.serializedGraph);
+            if (!parsedGraph.ok) {
+                throw new RegistrySyncTransportError(`Builder graph revision ${snapshot.graph.revision} failed to parse: ${parsedGraph.error.issues[0]?.message ?? 'unknown error'}.`);
+            }
+            // Component manifests are code-owned and host-supplied (primitives + project).
+            const manifestsById = new Map();
+            for (const manifest of config.manifests ?? []) {
+                manifestsById.set(manifest.id, manifest);
+            }
+            const graph = parsedGraph.graph;
+            // EC-207: routes/redirects come from the resolved config, not the snapshot.
+            // Config routes are authoritative; the `/` → page/home fallback fills only
+            // when the config supplies none.
+            const configRoutes = config.routes ?? [];
+            const routes = configRoutes.length > 0 ? [...configRoutes] : fallbackRoutes(snapshot);
+            return {
+                projectName: snapshot.project?.name ?? snapshot.projectId,
+                slug: snapshot.project?.slug ?? snapshot.projectId,
+                graph,
+                routes,
+                redirects: [...(config.redirects ?? [])],
+                collections: snapshot.collections,
+                manifests: [...manifestsById.values()],
+                sources: [...(config.sources ?? [])],
+                localeConfig: snapshot.localeConfig,
+                tokensCss: emitTokensCss(),
+                ...(config.componentsImport !== undefined
+                    ? { componentsImport: config.componentsImport }
+                    : {}),
+            };
+        },
+    };
+}
+//# sourceMappingURL=builder-source.js.map

package/dist/export-sync/builder-source.js.map

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

package/dist/export-sync/check.d.ts

@@ -0,0 +1,61 @@
+import type { ProjectGraph } from '@elytracms/core/project-graph';
+import type { ExportMode } from './core';
+import type { ManifestHost } from './manifest-host';
+import type { PushIssueCode } from './push';
+import type { ExportSource, FileIO } from './sync';
+import type { ExportIssueCode } from './validate';
+/**
+ * `builder check` (EC-148): the CI gate that verifies code and builder state agree
+ * before anything ships. Four checks, each individually reportable:
+ *
+ * 1. `manifest-discovery` — local manifest validation (the EC-147 discovery pass):
+ *    fs/load problems, structural problems, and EC-011 invalid/duplicate ids.
+ * 2. `graph-components` — components the published graph references that have no
+ *    manifest in code (`graph-component-missing`): the page would render the
+ *    missing-component fallback in the embedded runtime. Component manifests are
+ *    code-owned, so this is a direct code↔graph check (no DB registry to diff).
+ * 3. `types` — the committed `builder typegen` output is stale vs. the current
+ *    collection schemas (`type-drift`): regenerated in memory and byte-compared.
+ * 4. `validation` — the EC-047/EC-111 canonical validators surfaced through the CLI:
+ *    route conflicts, redirect loops, broken bindings, invalid props, missing slots.
+ *
+ * Failure semantics mirror push: every problem is a structured {@link CheckIssue},
+ * never a throw; output is machine-parseable issue lines (the push line format) plus
+ * a readable per-check summary; any error-severity issue fails the run (exit 1).
+ * Check is inherently non-interactive — there is no separate CI mode.
+ */
+/** Which of the four checks an issue belongs to. */
+export type CheckSection = 'manifest-discovery' | 'graph-components' | 'types' | 'validation';
+export type CheckIssueCode = PushIssueCode | 'graph-component-missing' | 'type-drift' | ExportIssueCode;
+export interface CheckIssue {
+    section: CheckSection;
+    code: CheckIssueCode;
+    severity: 'error' | 'warning';
+    message: string;
+    /** Locator: manifest module path, component id, route id, output path, … */
+    ref?: string;
+}
+export interface CheckOptions {
+    /** Host-repo scan root for `*.manifest.ts(x)` modules. */
+    root: string;
+    /** Content state to check (default flows from the CLI: published). */
+    mode: ExportMode;
+    /** The committed typegen output path to drift-check (default: {@link DEFAULT_TYPEGEN_PATH}). */
+    out?: string;
+}
+export interface CheckResult {
+    mode: ExportMode;
+    issues: CheckIssue[];
+    /** True when no error-severity issue exists (warnings never fail the gate). */
+    ok: boolean;
+}
+/** The machine-parseable issue line (same shape as the EC-147 push issue lines). */
+export declare function formatCheckIssue(issue: CheckIssue): string;
+/**
+ * All component ids referenced in the graph's layouts, deduped (EC-187: the
+ * graph is layouts-only; page composition component usage lives in `page`
+ * collection documents, walked separately by the reference index).
+ */
+export declare function collectGraphComponentIds(graph: ProjectGraph): Set<string>;
+/** Run a check. Returns a structured result and never throws; issues are data. */
+export declare function runCheck(source: ExportSource, host: ManifestHost, io: FileIO, options: CheckOptions): Promise<CheckResult>;

package/dist/export-sync/check.js

@@ -0,0 +1,126 @@
+import { isPrimitive } from '@elytracms/core/component-registry';
+import { discoverManifests } from './push';
+import { DEFAULT_TYPEGEN_PATH, generateTypesFile } from './typegen';
+import { validateExport } from './validate';
+/** The machine-parseable issue line (same shape as the EC-147 push issue lines). */
+export function formatCheckIssue(issue) {
+    return `  ${issue.severity} [${issue.code}]${issue.ref ? ` ${issue.ref}` : ''} — ${issue.message}`;
+}
+function walkComponentIds(node, out) {
+    out.add(node.componentId);
+    for (const children of Object.values(node.slots ?? {})) {
+        for (const child of children)
+            walkComponentIds(child, out);
+    }
+}
+/**
+ * All component ids referenced in the graph's layouts, deduped (EC-187: the
+ * graph is layouts-only; page composition component usage lives in `page`
+ * collection documents, walked separately by the reference index).
+ */
+export function collectGraphComponentIds(graph) {
+    const ids = new Set();
+    for (const layout of graph.layouts)
+        walkComponentIds(layout.root, ids);
+    return ids;
+}
+const SECTIONS = [
+    'manifest-discovery',
+    'graph-components',
+    'types',
+    'validation',
+];
+/** Run a check. Returns a structured result and never throws; issues are data. */
+export async function runCheck(source, host, io, options) {
+    const out = options.out ?? DEFAULT_TYPEGEN_PATH;
+    const issues = [];
+    const notes = {};
+    // --- 1. manifest-discovery: local manifest validation ------------------------
+    const local = await discoverManifests(host, options.root);
+    for (const issue of local.issues) {
+        issues.push({
+            section: 'manifest-discovery',
+            code: issue.code,
+            severity: issue.severity,
+            message: issue.message,
+            ...((issue.file ?? issue.componentId)
+                ? { ref: [issue.file, issue.componentId].filter(Boolean).join(' ') }
+                : {}),
+        });
+    }
+    /** Complete local view — graph↔code conclusions are only safe when nothing failed to load. */
+    const localComplete = local.issues.length === 0;
+    // --- 2.–4. share one canonical-model load ------------------------------------
+    const input = await source.loadInput(options.mode);
+    // 2. graph-components: graph references with no manifest in code. Component
+    //    manifests are code-owned, so this is a direct code↔graph check. Primitives
+    //    are platform-owned (they ship with the runtime), so only project components count.
+    if (localComplete) {
+        for (const id of [...collectGraphComponentIds(input.graph)].sort()) {
+            if (!isPrimitive(id) && !local.manifests.has(id)) {
+                issues.push({
+                    section: 'graph-components',
+                    code: 'graph-component-missing',
+                    severity: 'error',
+                    ref: id,
+                    message: `The graph references component "${id}" but no manifest for it exists in code under ${options.root} — the page renders the missing-component fallback.`,
+                });
+            }
+        }
+    }
+    else {
+        notes['graph-components'] =
+            '  note: local manifests failed to load — graph↔code coverage was not evaluated.';
+    }
+    // 3. types: regenerate in memory and byte-compare against the committed file.
+    const expected = generateTypesFile(input.collections, out);
+    const actual = io.read(out);
+    if (actual === undefined) {
+        issues.push({
+            section: 'types',
+            code: 'type-drift',
+            severity: 'error',
+            ref: out,
+            message: `Generated types file ${out} is missing — run \`builder typegen\` and commit it.`,
+        });
+    }
+    else if (actual !== expected) {
+        issues.push({
+            section: 'types',
+            code: 'type-drift',
+            severity: 'error',
+            ref: out,
+            message: `Generated types file ${out} is stale relative to the collection schemas — re-run \`builder typegen\` and commit the result.`,
+        });
+    }
+    // 4. validation: the EC-047/EC-111 canonical validators, surfaced through the CLI.
+    for (const issue of validateExport(input)) {
+        issues.push({
+            section: 'validation',
+            code: issue.code,
+            severity: issue.severity,
+            message: issue.message,
+            ...(issue.ref ? { ref: issue.ref } : {}),
+        });
+    }
+    // --- Report: per-check summary + machine-parseable lines ----------------------
+    io.log(`Check (${options.mode}): ${options.root} against the builder state.`);
+    for (const section of SECTIONS) {
+        const sectionIssues = issues.filter((i) => i.section === section);
+        const errors = sectionIssues.filter((i) => i.severity === 'error').length;
+        const warnings = sectionIssues.length - errors;
+        io.log(`check ${section}: ${sectionIssues.length === 0 ? 'ok' : `${errors} error(s), ${warnings} warning(s)`}`);
+        for (const issue of sectionIssues)
+            io.log(formatCheckIssue(issue));
+        const note = notes[section];
+        if (note)
+            io.log(note);
+    }
+    const errorCount = issues.filter((i) => i.severity === 'error').length;
+    const ok = errorCount === 0;
+    io.log(ok
+        ? `Check passed (${SECTIONS.length} checks).`
+        : `Check failed: ${errorCount} error(s) across ${SECTIONS.length} checks.`);
+    return { mode: options.mode, issues, ok };
+}
+//# sourceMappingURL=check.js.map

package/dist/export-sync/check.js.map

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