@elytracms/core 0.0.6

package/dist/export-sync/fixtures.js

@@ -0,0 +1,87 @@
+import { defineComponent } from '@elytracms/core/component-registry';
+import { sampleCollections, sampleLocaleConfig } from '@elytracms/core/cms-core';
+import { sampleSources } from '@elytracms/core/data-binding';
+import { emitTokensCss } from '@elytracms/core/design-tokens';
+import { validSampleGraph } from '@elytracms/core/project-graph';
+/**
+ * A deterministic reference export input (EC-113), assembled from the canonical sample fixtures.
+ * Used to test generation determinism and as a worked example — NOT a production seed.
+ *
+ * The component manifests are defined inline (rather than imported from the React renderer) so
+ * this logic package stays free of UI/React deps; they mirror the base primitives the sample
+ * graph uses, with prop/slot shapes the graph validator checks against. Props are field-defs
+ * (EC-190 "props as fields"): the record key is the prop name; each value is a `FieldDef` minus
+ * `name`, with `context: 'prop'`.
+ */
+/** The base primitives the reference graph (validSampleGraph) actually uses. */
+export const referenceManifests = [
+    defineComponent({
+        id: 'base.primitives.Container',
+        namespace: 'base.primitives',
+        title: 'Container',
+        props: {},
+        slots: [{ name: 'children' }, { name: 'outlet' }],
+    }),
+    defineComponent({
+        id: 'base.primitives.Stack',
+        namespace: 'base.primitives',
+        title: 'Stack',
+        props: { gap: { type: 'number', context: 'prop', default: 4, form: { label: 'Gap' } } },
+        slots: [{ name: 'children' }],
+    }),
+    defineComponent({
+        id: 'base.primitives.Heading',
+        namespace: 'base.primitives',
+        title: 'Heading',
+        props: {
+            text: { type: 'text', context: 'prop', default: '', form: { label: 'Text' } },
+            level: { type: 'number', context: 'prop', default: 2, form: { label: 'Level' } },
+        },
+        slots: [],
+    }),
+    defineComponent({
+        id: 'base.primitives.Text',
+        namespace: 'base.primitives',
+        title: 'Text',
+        props: { value: { type: 'text', context: 'prop', default: '', form: { label: 'Text' } } },
+        slots: [],
+    }),
+    defineComponent({
+        id: 'base.primitives.Repeater',
+        namespace: 'base.primitives',
+        title: 'Repeater',
+        // EC-190 DD7: the iterated `items` value (an array) has no static field-def type;
+        // it rides node.props undeclared. No editable static prop is exposed — keep `iterate`.
+        props: {},
+        slots: [{ name: 'item', required: true }],
+        iterate: { itemsProp: 'items', itemSlot: 'item' },
+    }),
+];
+/**
+ * Routes that all bind to a renderable document (EC-187): `/` → the `page/home`
+ * document (composition), `/blog/:slug` → a `post` document by slug. So the
+ * export validates and every route renders. `r-post` carries a dynamic `:slug`
+ * param to exercise param routing.
+ */
+export const referenceRoutes = [
+    { id: 'r-home', pattern: '/', locale: 'en', document: { collection: 'page', id: 'home' } },
+    { id: 'r-home-de', pattern: '/', locale: 'de', document: { collection: 'page', id: 'home' } },
+    { id: 'r-post', pattern: '/blog/:slug', locale: 'en', document: { collection: 'post', id: ':slug' } },
+];
+export const referenceRedirects = [
+    { id: 'rd-old-home', from: '/home', to: '/', permanent: true },
+];
+/** The full reference export input — deterministic. */
+export const referenceInput = {
+    projectName: 'Sample Project',
+    slug: 'sample-project',
+    graph: validSampleGraph,
+    routes: referenceRoutes,
+    redirects: referenceRedirects,
+    collections: [...sampleCollections],
+    manifests: referenceManifests,
+    sources: sampleSources,
+    localeConfig: sampleLocaleConfig,
+    tokensCss: emitTokensCss(),
+};
+//# sourceMappingURL=fixtures.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { ExportInput, GeneratedFile } from './core';
+/**
+ * Generate the full standalone Next.js App Router app for a project (EC-101–109, eject shape
+ * per EC-149). Deterministic: the same input always yields the same sorted file set. No
+ * component stubs are generated — project components are imported from the host repo.
+ */
+export declare function generateExport(input: ExportInput): GeneratedFile[];

package/dist/export-sync/generate.js

@@ -0,0 +1,505 @@
+import { namespaceOf } from '@elytracms/core/component-registry';
+import { serializeProjectGraph } from '@elytracms/core/project-graph';
+import { DEFAULT_COMPONENTS_IMPORT, generatedBanner, sortFiles, stableJson } from './core';
+/** Canonical graph JSON (validated by the serializer), pretty-printed for review. */
+function graphJson(graph) {
+    return JSON.stringify(JSON.parse(serializeProjectGraph(graph)), null, 2);
+}
+/**
+ * Next.js App Router code generation (EC-101–109, ejected shape per EC-149). Each function emits
+ * one readable file. The output is a standalone app that depends only on the published
+ * `@elytracms/*` runtime packages (never builder-only code), reads its content from the JSON
+ * snapshot generated alongside it (zero runtime dependency on the builder backend), and renders
+ * the canonical graph through the runtime renderer. Project components are NOT generated — they
+ * are real code in the host repo (vision AD-2) that the generated registry imports.
+ */
+// ---------------------------------------------------------------------------
+// Content data (EC-101/104) — the canonical model serialized as JSON the app reads.
+// ---------------------------------------------------------------------------
+function contentFiles(input) {
+    return [
+        { path: 'content/graph.json', contents: graphJson(input.graph) },
+        { path: 'content/routes.json', contents: stableJson(input.routes) },
+        { path: 'content/redirects.json', contents: stableJson(input.redirects) },
+        { path: 'content/collections.json', contents: stableJson(input.collections) },
+        { path: 'content/sources.json', contents: stableJson(input.sources) },
+        { path: 'content/locales.json', contents: stableJson(input.localeConfig) },
+    ];
+}
+// ---------------------------------------------------------------------------
+// Registry (EC-102/149) — wire component ids → implementations, namespace-correct.
+// Project components are real code in the host repo (vision AD-2): the registry IMPORTS them
+// from the configured components module instead of generating stubs.
+// ---------------------------------------------------------------------------
+function registryFile(input) {
+    const projectIds = input.manifests
+        .map((m) => m.id)
+        .filter((id) => namespaceOf(id) !== 'base.primitives')
+        .sort();
+    const componentsImport = input.componentsImport ?? DEFAULT_COMPONENTS_IMPORT;
+    const contents = projectIds.length === 0
+        ? `${generatedBanner('lib/registry.ts')}
+import { ComponentRegistry } from '@elytracms/core/component-registry'
+import { basePrimitives } from '@elytracms/core/runtime-renderer'
+import type { ComponentImplementations } from '@elytracms/core/runtime-renderer'
+
+// Platform primitives (base.primitives.*) ship with the runtime renderer.
+// This project uses only base primitives — no host components module is imported.
+const base = basePrimitives()
+
+/** The ejected app's component registry. */
+export const registry = new ComponentRegistry(base.manifests)
+
+export const implementations: ComponentImplementations = base.implementations
+`
+        : `${generatedBanner('lib/registry.ts')}
+import { ComponentRegistry } from '@elytracms/core/component-registry'
+import { basePrimitives } from '@elytracms/core/runtime-renderer'
+import type { ComponentImplementations } from '@elytracms/core/runtime-renderer'
+// Your REAL components, from the host repo (configure with \`builder eject --components <specifier>\`).
+// The module must export \`projectManifests\` (ComponentManifest[]) and
+// \`projectImplementations\` (ComponentImplementations) — see README.md.
+import { projectManifests, projectImplementations } from ${JSON.stringify(componentsImport)}
+
+// Platform primitives (base.primitives.*) ship with the runtime renderer.
+const base = basePrimitives()
+
+/** The ejected app's component registry — base primitives + this project's components. */
+export const registry = new ComponentRegistry([...base.manifests, ...projectManifests])
+
+export const implementations: ComponentImplementations = {
+  ...base.implementations,
+  ...projectImplementations,
+}
+
+// Project components this graph references (expected from ${JSON.stringify(componentsImport)}):
+${projectIds.map((id) => `//   - ${id}`).join('\n')}
+`;
+    return { path: 'lib/registry.ts', contents };
+}
+// ---------------------------------------------------------------------------
+// Renderer (EC-103) — server-safe re-export, no builder-only deps.
+// ---------------------------------------------------------------------------
+function rendererFile() {
+    const contents = `${generatedBanner('lib/renderer.ts')}
+import { renderCompositionInLayout } from '@elytracms/core/runtime-renderer'
+import type { ProjectGraph } from '@elytracms/core/project-graph'
+import type { ReactNode } from 'react'
+import { registry, implementations } from './registry'
+import { resolveBinding } from './cms-client'
+import type { RepeaterItem } from './cms-client'
+
+/**
+ * Render a page-collection document's \`body\` composition into its \`layoutId\`
+ * layout (EC-187), server-side. Bindings resolve through the CMS client
+ * (published or draft, per request). No builder-only code is imported.
+ */
+export function renderPage(
+  graph: ProjectGraph,
+  body: unknown,
+  layoutId: string | undefined,
+  payloads: Record<string, unknown>,
+): ReactNode {
+  return renderCompositionInLayout(graph, layoutId, body, {
+    registry,
+    implementations,
+    resolveBinding: (ref, item?: RepeaterItem) => resolveBinding(payloads, ref, item),
+  })
+}
+`;
+    return { path: 'lib/renderer.ts', contents };
+}
+// ---------------------------------------------------------------------------
+// CMS adapter client (EC-104) — provider-neutral content + binding resolution.
+// ---------------------------------------------------------------------------
+function cmsClientFile() {
+    const contents = `${generatedBanner('lib/cms-client.ts')}
+import { resolveBinding as resolve } from '@elytracms/core/data-binding'
+import type { BindingReference, JsonValue } from '@elytracms/core/project-graph'
+import { SourceRegistry } from '@elytracms/core/data-binding'
+import sources from '../content/sources.json'
+
+export interface RepeaterItem {
+  item: unknown
+  index: number
+}
+
+/**
+ * The content/data adapter for the ejected app. Provider-neutral: by default it reads the
+ * payloads snapshotted into content/sources.json at eject time (no builder backend needed),
+ * but you can swap \`fetchPayloads\` to hit your live backend (Convex / REST / CMS) and choose
+ * published vs draft via \`mode\`.
+ */
+export type ContentMode = 'published' | 'draft'
+
+const registry = SourceRegistry.from(sources as never)
+
+/** Build the payload store for a request. Replace with live fetching as needed. */
+export async function fetchPayloads(_mode: ContentMode = 'published'): Promise<Record<string, JsonValue>> {
+  const payloads: Record<string, JsonValue> = {}
+  for (const source of registry.list()) {
+    if (source.sample !== undefined) payloads[source.id] = source.sample
+  }
+  return payloads
+}
+
+/**
+ * The shape of a routed page-collection document (EC-187): \`body\` is the canvas
+ * composition, \`layoutId\` selects the wrapping layout. Content collections that
+ * are not pages are rendered by your own route components.
+ */
+export interface PageDocument {
+  body: unknown
+  layoutId?: string
+}
+
+/**
+ * Fetch the routed \`page\`-collection document. STUB: wire this to your content
+ * backend (Convex / REST / CMS) — return the page document for the resolved
+ * route ref + params, or \`null\` for a 404. The CLI export ships the route table
+ * and the layout graph; the page documents live in your CMS.
+ */
+export async function fetchPageDocument(
+  _ref: { collection: string; id: string },
+  _params: Record<string, string>,
+): Promise<PageDocument | null> {
+  return null
+}
+
+/** Resolve a single binding against the request's payloads (used by the renderer). */
+export function resolveBinding(
+  payloads: Record<string, unknown>,
+  ref: BindingReference,
+  item?: RepeaterItem,
+): unknown {
+  const resolution = resolve(ref, { payloads: payloads as Record<string, JsonValue>, registry }, item as never)
+  switch (resolution.kind) {
+    case 'value':
+      return resolution.value
+    case 'props':
+      return resolution.props
+    case 'condition':
+      return resolution.pass
+    default:
+      return undefined
+  }
+}
+`;
+    return { path: 'lib/cms-client.ts', contents };
+}
+// ---------------------------------------------------------------------------
+// Route resolver integration (EC-105) — App Router wiring with redirects/fallbacks/locale.
+// ---------------------------------------------------------------------------
+function routesFile() {
+    const contents = `${generatedBanner('lib/routes.ts')}
+import { createRouter } from '@elytracms/core/cms-core'
+import type { ResolveResult } from '@elytracms/core/cms-core'
+import routes from '../content/routes.json'
+import redirects from '../content/redirects.json'
+import locales from '../content/locales.json'
+
+const config = locales as { default: string; locales: string[] }
+const router = createRouter(routes as never, redirects as never, { defaultLocale: config.default })
+
+/**
+ * Derive the request locale from a leading URL segment (the \`/de/about\` strategy) and return the
+ * remaining path. Falls back to the default locale when no locale prefix is present (EC-105).
+ */
+export function splitLocale(url: string): { locale: string; path: string } {
+  const segments = url.split('/').filter((s) => s.length > 0)
+  const first = segments[0]
+  if (first && first !== config.default && config.locales.includes(first)) {
+    return { locale: first, path: '/' + segments.slice(1).join('/') }
+  }
+  return { locale: config.default, path: url }
+}
+
+/** Resolve a request URL to a page + params, honoring redirects, fallbacks and locale (EC-105). */
+export function resolveRoute(url: string, locale?: string): ResolveResult {
+  return router.resolveUrl(url, locale)
+}
+
+/** Follow a redirect chain to its terminus. */
+export function resolveRedirect(from: string) {
+  return router.followRedirects(from)
+}
+`;
+    return { path: 'lib/routes.ts', contents };
+}
+// ---------------------------------------------------------------------------
+// Image & asset adapter (EC-106).
+// ---------------------------------------------------------------------------
+function assetsFile() {
+    const contents = `${generatedBanner('lib/assets.ts')}
+/**
+ * Asset URL resolution + image optimization hook points (EC-106). Storage-adapter neutral:
+ * point \`ASSET_BASE_URL\` at your CDN/storage, or replace \`assetUrl\` entirely.
+ */
+const ASSET_BASE_URL = process.env.NEXT_PUBLIC_ASSET_BASE_URL ?? ''
+
+/** Resolve an asset id/path to a fully-qualified URL. */
+export function assetUrl(idOrPath: string): string {
+  if (/^https?:\\/\\//.test(idOrPath)) return idOrPath
+  const base = ASSET_BASE_URL.replace(/\\/$/, '')
+  const path = idOrPath.replace(/^\\//, '')
+  return base ? \`\${base}/\${path}\` : \`/\${path}\`
+}
+
+/** A next/image loader hook — wire your provider's transform params here. */
+export function imageLoader({ src, width, quality }: { src: string; width: number; quality?: number }): string {
+  const url = assetUrl(src)
+  const sep = url.includes('?') ? '&' : '?'
+  return \`\${url}\${sep}w=\${width}&q=\${quality ?? 75}\`
+}
+`;
+    return { path: 'lib/assets.ts', contents };
+}
+// ---------------------------------------------------------------------------
+// App Router pages (EC-101/105).
+// ---------------------------------------------------------------------------
+function appFiles(input) {
+    const layout = {
+        path: 'app/layout.tsx',
+        contents: `${generatedBanner('app/layout.tsx')}
+import type { ReactNode } from 'react'
+import './globals.css'
+
+export const metadata = { title: ${JSON.stringify(input.projectName)} }
+
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang={${JSON.stringify(input.localeConfig.default)}} className="dark">
+      <body>{children}</body>
+    </html>
+  )
+}
+`,
+    };
+    const catchAll = {
+        path: 'app/[[...slug]]/page.tsx',
+        contents: `${generatedBanner('app/[[...slug]]/page.tsx')}
+import { notFound, redirect } from 'next/navigation'
+import type { ProjectGraph } from '@elytracms/core/project-graph'
+import graphData from '../../content/graph.json'
+import { resolveRoute, splitLocale } from '../../lib/routes'
+import { renderPage } from '../../lib/renderer'
+import { fetchPayloads, fetchPageDocument } from '../../lib/cms-client'
+
+const graph = graphData as unknown as ProjectGraph
+
+/**
+ * The single catch-all route (EC-101/105, EC-187): derive the locale, resolve the URL through the
+ * canonical route resolver (honoring redirects, fallbacks and locale) to a document ref, fetch the
+ * matched \`page\`-collection document, and render its \`body\` composition into its \`layoutId\`
+ * layout with the route's dynamic params available to bindings. A miss is a real 404.
+ */
+export default async function Page({ params }: { params: Promise<{ slug?: string[] }> }) {
+  const { slug } = await params
+  const url = '/' + (slug ?? []).join('/')
+  const { locale, path } = splitLocale(url)
+
+  const result = resolveRoute(path, locale)
+  if (result.status === 'redirect' && result.redirectTarget) {
+    redirect(result.redirectTarget)
+  }
+  if (result.status !== 'ok' || !result.documentRef) {
+    notFound()
+  }
+
+  // Fetch the routed page document (its \`body\` is the composition, \`layoutId\` the layout).
+  const doc = await fetchPageDocument(result.documentRef, result.dynamicParams)
+  if (!doc) {
+    notFound()
+  }
+
+  // Route params are exposed to bindings under the reserved \`params\` source (e.g. /params/slug).
+  const payloads = { ...(await fetchPayloads('published')), params: result.dynamicParams }
+  const layoutId = typeof doc.layoutId === 'string' ? doc.layoutId : undefined
+  return <>{renderPage(graph, doc.body, layoutId, payloads)}</>
+}
+`,
+    };
+    const notFoundFile = {
+        path: 'app/not-found.tsx',
+        contents: `${generatedBanner('app/not-found.tsx')}
+export default function NotFound() {
+  return (
+    <main style={{ padding: '4rem', fontFamily: 'system-ui' }}>
+      <h1>404 — Not found</h1>
+      <p>No route matched this URL.</p>
+    </main>
+  )
+}
+`,
+    };
+    return [layout, catchAll, notFoundFile];
+}
+function globalsCss(input) {
+    return {
+        path: 'app/globals.css',
+        contents: `/* Generated design tokens — from @elytracms/design-tokens. Edit tokens in the builder. */
+${input.tokensCss}
+:root { color-scheme: dark; }
+body { margin: 0; background: var(--background); color: var(--foreground); }
+`,
+    };
+}
+// ---------------------------------------------------------------------------
+// Scaffold (EC-107/108/109, eject shape per EC-149) — package.json, tsconfig, next.config,
+// vercel, env, README. The ejected app builds from its committed content snapshot: no pull
+// step, no builder credentials, zero runtime dependency on the builder backend.
+// ---------------------------------------------------------------------------
+function scaffoldFiles(input) {
+    const componentsImport = input.componentsImport ?? DEFAULT_COMPONENTS_IMPORT;
+    const hasProjectComponents = input.manifests.some((m) => namespaceOf(m.id) !== 'base.primitives');
+    const pkg = {
+        name: input.slug,
+        version: '0.0.0',
+        private: true,
+        type: 'module',
+        scripts: {
+            // The app builds from its committed content snapshot — no builder access needed (EC-149).
+            dev: 'next dev',
+            build: 'next build',
+            start: 'next start',
+        },
+        dependencies: {
+            // EC-265: the renderer closure is one package now (subpath imports in the
+            // generated code resolve through @elytracms/core's exports map).
+            '@elytracms/core': 'workspace:*',
+            next: '^15.0.0',
+            react: '^19.0.0',
+            'react-dom': '^19.0.0',
+        },
+    };
+    const envExample = `# Environment for ${input.projectName} (EC-107/149)
+# The ejected app has NO builder backend dependency: content is snapshotted into content/*.json.
+# Only configure what your own infrastructure needs.
+
+# Asset storage (EC-106) — base URL for asset/image resolution
+NEXT_PUBLIC_ASSET_BASE_URL=
+`;
+    const vercel = {
+        $schema: 'https://openapi.vercel.sh/vercel.json',
+        framework: 'nextjs',
+        installCommand: 'pnpm install',
+    };
+    const nextConfig = `${generatedBanner('next.config.mjs')}
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  // Allow the components module to live outside the app directory (e.g. elsewhere in your repo).
+  experimental: { externalDir: true },
+}
+export default nextConfig
+`;
+    const tsconfig = {
+        compilerOptions: {
+            target: 'ES2022',
+            lib: ['dom', 'dom.iterable', 'ES2022'],
+            module: 'ESNext',
+            moduleResolution: 'Bundler',
+            jsx: 'preserve',
+            strict: true,
+            esModuleInterop: true,
+            resolveJsonModule: true,
+            noEmit: true,
+            plugins: [{ name: 'next' }],
+        },
+        include: ['app', 'lib', 'content', 'next-env.d.ts'],
+    };
+    const componentsSection = hasProjectComponents
+        ? `## Your components (the one thing eject does not generate)
+
+Project components are **real code in your repo** — they were never builder-generated. The
+generated \`lib/registry.ts\` imports them from:
+
+\`\`\`ts
+import { projectManifests, projectImplementations } from ${JSON.stringify(componentsImport)}
+\`\`\`
+
+That module is yours and must export:
+
+- \`projectManifests: ComponentManifest[]\` — the same manifests you push with \`builder push\`
+- \`projectImplementations: ComponentImplementations\` — component id → React implementation
+
+Relative specifiers resolve from \`lib/registry.ts\` (the default, \`${DEFAULT_COMPONENTS_IMPORT}\`,
+is a \`components/\` module at the app root); a bare specifier must be a dependency of this app.
+Re-run \`builder eject --components <specifier>\` to point the registry somewhere else.
+\`next.config.mjs\` sets \`experimental.externalDir\` so the module may live outside the app
+directory.
+`
+        : `## Your components
+
+This project uses only platform primitives (\`base.primitives.*\`), which ship with
+\`@elytracms/runtime-renderer\` — no host components module is imported. If you add project
+components later, re-run \`builder eject --components <specifier>\` to wire in the module that
+exports \`projectManifests\` and \`projectImplementations\`.
+`;
+    const readme = `# ${input.projectName}
+
+Ejected from **Elytra** (\`builder eject\`, \`@elytracms/export-sync\`). A standalone
+Next.js App Router app that renders the project's canonical graph — the exit guarantee: you can
+leave the platform anytime with a working app.
+
+**Zero builder dependency:** the canonical model (graph, routes, redirects, collections, sources,
+locales) is snapshotted into \`content/*.json\` at eject time. Building and serving this app needs
+no builder backend and no network access to Elytra.
+
+## Structure (EC-109/149)
+
+| Path | What it is |
+| --- | --- |
+| \`app/\` | App Router: a single catch-all that resolves URLs via the route resolver |
+| \`app/globals.css\` | Design tokens (generated from \`@elytracms/design-tokens\`) |
+| \`lib/registry.ts\` | Component registry — base primitives + your components, imported from your repo |
+| \`lib/renderer.ts\` | Server-safe page renderer |
+| \`lib/cms-client.ts\` | Content/data adapter (reads the embedded snapshot by default) |
+| \`lib/routes.ts\` | Route resolver (redirects, fallbacks, locale) |
+| \`lib/assets.ts\` | Asset URL + image optimization hooks |
+| \`content/*.json\` | The snapshotted canonical model (graph, routes, schemas, sources) |
+
+No builder-only runtime code is included. Every file is readable and yours to edit.
+
+${componentsSection}
+## Develop & deploy
+
+\`\`\`bash
+pnpm install
+pnpm dev          # or: pnpm build && pnpm start
+\`\`\`
+
+To refresh the snapshot from the builder before you leave for good, re-run \`builder eject\`:
+it validates first and refuses to write a broken app (missing components, broken bindings,
+route conflicts, redirect loops all fail the eject).
+
+To serve live content instead of the snapshot, replace \`fetchPayloads\` in \`lib/cms-client.ts\`
+with your own backend fetch — the renderer and routing are backend-agnostic.
+`;
+    return [
+        { path: 'package.json', contents: stableJson(pkg) + '\n' },
+        { path: '.env.example', contents: envExample },
+        { path: 'vercel.json', contents: stableJson(vercel) + '\n' },
+        { path: 'next.config.mjs', contents: nextConfig },
+        { path: 'tsconfig.json', contents: stableJson(tsconfig) + '\n' },
+        { path: 'README.md', contents: readme },
+    ];
+}
+/**
+ * Generate the full standalone Next.js App Router app for a project (EC-101–109, eject shape
+ * per EC-149). Deterministic: the same input always yields the same sorted file set. No
+ * component stubs are generated — project components are imported from the host repo.
+ */
+export function generateExport(input) {
+    return sortFiles([
+        ...appFiles(input),
+        globalsCss(input),
+        registryFile(input),
+        rendererFile(),
+        cmsClientFile(),
+        routesFile(),
+        assetsFile(),
+        ...contentFiles(input),
+        ...scaffoldFiles(input),
+    ]);
+}
+//# sourceMappingURL=generate.js.map

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * @elytracms/export-sync — the `builder` CLI surfaces around the canonical project model.
+ *
+ * EC-147 (vision AD-2): `builder push` discovers component manifests in the host repo,
+ * validates them, and syncs them up into builder registry persistence — with watch mode for
+ * local dev and an all-or-nothing CI mode. This is the day-to-day workflow: the embedded
+ * runtime renders the graph in the user's own app.
+ *
+ * EC-148 (vision AD-2/AD-4): `builder typegen` emits the per-collection delivery-shape +
+ * accessor types (EC-142/EC-143 codegen) into the host repo as a committed, deterministic
+ * module; `builder check` is the CI gate that verifies code and builder state agree —
+ * manifest drift both ways, graph↔code component coverage, type drift, and the canonical
+ * validation (route conflicts, broken bindings) surfaced through the CLI.
+ *
+ * EC-149 (vision AD-1): `builder eject` is the exit guarantee — a pure, deterministic
+ * generation (brief §4.9, EC-101–113) of a standalone Next.js App Router app with the model
+ * snapshotted in and the host repo's real components imported (never stubbed). The export-era
+ * `pull`/`validate` surface remains for validation and drift checks; `pull` is deprecated.
+ */
+export declare const PACKAGE = "@elytracms/core/export-sync";
+export * from './core';
+export * from './validate';
+export * from './generate';
+export * from './sync';
+export * from './eject';
+export * from './cli';
+export * from './fixtures';
+export * from './manifest-host';
+export * from './registry-sync-client';
+export * from './builder-source';
+export * from './push';
+export * from './watch';
+export * from './typegen';
+export * from './check';
+export * from './init';
+export { defineElytraConfig, elytraConfigInputSchema, extractWorkspaceConfigExport, resolveWorkspaceConfig, toProjectSettings, WORKSPACE_CONFIG_FILE, WORKSPACE_CONFIG_FILES, } from '@elytracms/core/studio-core';
+export type { ElytraConfigInput, ResolvedWorkspaceProject, WorkspaceConfigIssue, WorkspaceConfigIssueCode, WorkspaceConfigResult, } from '@elytracms/core/studio-core';