@velastack/cms 0.4.0 → 0.5.1

package/README.md

@@ -201,13 +201,18 @@ If `endpoint` is omitted (e.g. when using `mockAdapter` for tests/demos), the pl
 
 ## CMS components
 
-All four included CMS components share the same prop shape:
+Every CMS component shares the same prop shape:
 
-| Prop       | Type               | Notes                                                                    |
-| ---------- | ------------------ | ------------------------------------------------------------------------ |
-| `name`     | `string`           | Field path inside this scope. Must be a static string at v1.             |
-| `fallback` | varies             | Rendered when no value is stored. `string` for text, HTML for rich text. |
-| `value`    | `unknown` (opt-in) | Per-item override used inside `<CmsRepeater/>`; bypasses scope lookup.   |
+| Prop       | Type               | Notes                                                                                                                                           |
+| ---------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| `name`     | `string`           | Field path inside this scope. Must be a static string at v1.                                                                                    |
+| `scope`    | `'root' \| string` | Read and write a value that lives in the root layout scope (`'root'`, i.e. `layout:/`) or another param-less layout scope (`layout:/(public)`). |
+| `fallback` | varies             | Rendered when **nothing** is stored. `string` for text, HTML for rich text, `{ url, alt }` or a URL for images.                                 |
+| `value`    | `unknown` (opt-in) | Per-item override; bypasses scope lookup and disables editing.                                                                                  |
+
+Two stored states are distinct: `undefined` (nothing stored) renders the fallback, `null` (the editor cleared the field) renders empty. Editables write `null` on clear, never drop the key, so a cleared field can't fall back to the template's demo copy after publish.
+
+`scope="root"` is how site-wide content — hours, contact, navigation, branding — is edited where it renders: put the component in the root `+layout.svelte` and reference the same `name` from any page with `scope="root"`. The payload already carries every enclosing layout tree, so no extra fetch happens.
 
 ### `<CmsText />`
 
@@ -233,22 +238,93 @@ Rendered with `{@html}`. Edit mode swaps for a `<textarea>`.
 
 Renders an `<img>`. Edit mode shows the current image plus a URL input.
 
-### `<CmsRepeater />`
+## Structured components
+
+Hours, navigation, a team, a price list: one value with a fixed shape, edited in a slot-anchored popover and rendered by the template through a snippet. Every structured component is headless: it reads the value at `name`, normalizes it, derives the view a template needs and hands it to `children`. It never emits markup of its own.
 
 ```svelte
-<CmsRepeater name="gallery.items">
-	{#snippet children(item)}
-		<figure>
-			<CmsImage name="src" value={item.src} alt={item.caption} />
-			<figcaption>
-				<CmsText name="caption" value={item.caption} />
-			</figcaption>
-		</figure>
+<script lang="ts">
+	import { CmsHours, CmsNav, isActive } from '@velastack/cms';
+</script>
+
+<!-- In the root layout: site-wide by construction. -->
+<CmsNav name="nav.primary">
+	{#snippet children(items)}
+		{#each items as item (item.id)}
+			<a href={item.href} aria-current={isActive(item, page.url) ? 'page' : undefined}
+				>{item.label}</a
+			>
+		{/each}
 	{/snippet}
-</CmsRepeater>
+</CmsNav>
+
+<!-- On the contact page: the same value, read and written through the root scope. -->
+<CmsHours name="hours" scope="root">
+	{#snippet children(h)}
+		<p>{h.today.label}: {h.today.text} · {h.status}</p>
+		{#each h.rows as row (row.id)}<dt>{row.days}</dt>
+			<dd>{row.text}</dd>{/each}
+	{/snippet}
+</CmsHours>
 ```
 
-Iterates an array stored at `name`. Inside the snippet, pass per-item values via `value=` to bypass scope lookup. Edit mode renders the same snippet for each item plus add/remove controls and per-key inputs.
+| Component                                                                      | Value                                                                                                                                 | Snippet receives                                                                | Helpers                                                 |
+| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------- |
+| `CmsNav`                                                                       | `{ items: [{ id, label, link, children }] }`                                                                                          | items with resolved `href`                                                      | `isActive(item, url)`                                   |
+| `CmsHours`                                                                     | week grid, `exceptions`, `note`, `labels`, `timezone`                                                                                 | `rows`, `today`, `isOpenNow`, `status`, `exceptionRows` in the visitor's locale | `toOpeningHoursSpecification`                           |
+| `CmsContact`                                                                   | `name`, `address`, `phones`, `emails`, `whatsapp`, `directionsUrl`, `geo`, `labels`                                                   | plus `telHref`, `mailto`, `whatsappHref`, `mapsHref`, `formattedAddress`        | `toPostalAddress`                                       |
+| `CmsSocialLinks`                                                               | `{ items: [{ id, platform, url, label }] }`                                                                                           | items with `name` (label or platform name)                                      | `toSameAs`, `SOCIAL_PLATFORMS`                          |
+| `CmsCollection`                                                                | rooms, services, tours: title, summary, body, image, gallery, price, link, tags, features, `details` key-value list, featured, hidden | visible items with `href`; props `limit`, `featured`, `tag` slice them          | `formatCollectionPrice`, `collectionTags`, `toItemList` |
+| `CmsTeam`                                                                      | name, role, rich bio, photo, email, phone, profile links                                                                              | members                                                                         |                                                         |
+| `CmsTestimonials`                                                              | rich quote, author, role, company, photo, rating, source, date                                                                        | testimonials                                                                    | `toReview`                                              |
+| `CmsPricing`                                                                   | `currency`, `labels.custom`, tiers with a feature checklist and a CTA                                                                 | tiers with `priceText` and `href`                                               | `formatPrice`                                           |
+| `CmsFaq`                                                                       | question, rich answer                                                                                                                 | questions                                                                       | `toFaqPage`                                             |
+| `CmsStats`, `CmsSteps`, `CmsTimeline`, `CmsGallery`, `CmsLogos`, `CmsSchedule` | fixed list presets                                                                                                                    | items                                                                           | `logosView`, `scheduleByDay`                            |
+
+Templates use only these exports; there is no open item schema. A shape outside the presets is a new preset in the package. `fallback` takes the full value or a bare item list and is normalized like a stored value, so a hand-written seed with missing fields is safe. Prices, times, dates and day names format in the visitor's locale; `isOpenNow` is computed when the page renders, so a prerendered page shows the state at build time.
+
+Every value type (`CmsHoursValue`, `NavItem`, …), schema (`cmsHours`, …) and JSON-LD helper is exported from the package root.
+
+### Building one
+
+The package ships the pieces a structured component is made of, and the components above are built from nothing else.
+
+```ts
+// The value's rules: a versioned shape, its translatable strings, and the form the popover draws.
+import { defineForm, asItems, asString } from '@velastack/cms';
+
+export const cmsFaq = defineForm<CmsFaqValue>({
+	component: 'CmsFaq', // canonical export name, recorded in the manifest
+	label: 'FAQ', // popover header
+	version: 1, // written as `v` on every value
+	translatable: [], // root fields that translate (dotted paths allowed: 'labels.closed')
+	items: { key: 'items', translatable: ['question', 'answer'] }, // lists and their translatable fields; nest `items` for lists inside items
+	normalize: (raw) => ({ v: 1, items: asItems(raw?.items, …) }),
+	empty: () => ({ v: 1, items: [] }),
+	fields: [{ key: 'items', type: 'list', label: 'Questions', itemLabel: 'question', titleKey: 'question', blank: () => ({ question: '', answer: '' }), fields: [
+		{ key: 'question', label: 'Question', type: 'text' },
+		{ key: 'answer', label: 'Answer', type: 'html' }
+	] }]
+});
+```
+
+```svelte
+<!-- The display component, inside the package: the generic one, given the schema and a view function. -->
+<script lang="ts">
+	import Structured from './cms-structured.svelte'; // src/lib/components/cms, inside the package
+	let { name, scope, fallback, value, children } = $props();
+</script>
+
+<Structured schema={cmsFaq} {name} {scope} {fallback} {value} view={faqView} {children} />
+```
+
+Field types: `text`, `long-string`, `html` (TipTap), `number`, `boolean`, `date`, `time`, `url`, `image` and `images` (media picker, alt text), `enum`, `link` (page picker or URL, new tab), `strings` (one per line), `rating`, `list` (collapsible cards with reorder). `group` puts a field in a tab; `half` shares a row with the next field. A bespoke editor (the hours week grid) wraps `StructuredEditorPopover` from `@velastack/cms/editor` and renders `FieldsForm` for the rest; `FieldInput`, `ListField`, `LinkInput`, `RichTextInput`, `ReorderButtons` and the Popover / Tabs / Switch / Checkbox / Sheet primitives are exported there too. The popover commits on **Done**; edit mode is page-wide and the bar's Save flushes the draft.
+
+Rules every structured value follows (`core/structured.ts`):
+
+- **Whole-object writes, explicit `null` clears.** Components never patch a leaf; they write the full `{ v, … }` object. Cleared fields are `null`.
+- **List items carry a stable `id`** (`newItemId()`) at every nesting level; reorder and delete work because arrays replace wholesale on merge.
+- **Localisation is a string overlay.** The default locale stores the full value at `<name>`; every other locale stores only strings at `<name>.$t.<id>.<field>` (`_` is the id for root fields, `field` may be a dotted path, and a string array translates per index as `tags.0`). `read()` folds the overlay in, structure never forks between languages, and the popover's locale tabs write only the overlay. The Locales panel counts translatable strings per locale for every structured usage on the current route.
 
 ### `<CmsEntries />`
 
@@ -296,7 +372,7 @@ A component is treated as a CMS component if **any** of the following hold:
 
 2. **It's a named export from your local `src/lib/components/cms/index.{ts,js}` barrel.** Re-export your component there if you prefer a single import path..
 
-3. **It's imported from the `@velastack/cms` package itself.** The four built-ins (`CmsText`, `CmsRichText`, `CmsImage`, `CmsRepeater`) work this way: any import resolving inside the installed `@velastack/cms` package is auto-classified.
+3. **It's imported from the `@velastack/cms` package itself.** Every named import from `@velastack/cms` is a CMS component, whether or not the bundler resolved the package.
 
 ### Third-party packs (opt-in)
 
@@ -332,13 +408,12 @@ String patterns match `source === pattern || source.startsWith(pattern + '/')`.
 
 A CMS component should:
 
-- Accept `{ name: string; fallback?: string; value?: unknown }` props (and any extras you need).
-- Call `getCmsScope()` from `cms` to find its scope.
-- Read drafts via `cmsStore.hasDraft(scopeKey, name)` / `cmsStore.getValue(scopeKey, name)` when `cmsStore.isEditing` is true; fall back to `page.data.cms.docs[scopeKey][name]` otherwise.
-- Skip scope lookup when `value !== undefined` — that prop is the per-item override used inside `<CmsRepeater/>`.
-- Optionally provide an editable sibling that's dynamically `import()`'d when `cmsStore.isEditing` flips on, so editing code doesn't ship to public visitors.
+- Accept `{ name: string; scope?: string; fallback?: …; value?: unknown }` props (and any extras you need).
+- Call `useCmsField(() => ({ name, scope, value }), read)` once at init. It resolves the scope (context, `'root'`, or an explicit id), reads the merged value, reports `editable`, and exposes `set` / `clear`.
+- Treat `undefined` as "render the fallback" and `null` as "render empty" in `read`.
+- Optionally provide an editable sibling that's dynamically `import()`'d when `field.editable` flips on, so editing code doesn't ship to public visitors.
 
-The four built-ins are reference implementations; copy `src/lib/components/cms/cms-text.svelte` (or one of the other built-ins with a paired `*-editable.svelte` sibling) as a starting point.
+The built-ins are reference implementations; copy `src/lib/components/cms/cms-text.svelte` (or one of the others with a paired `*-editable.svelte` sibling) as a starting point.
 
 ## Architecture
 
@@ -399,7 +474,7 @@ Display components prefer drafts over published values when `isEditing` is true.
 
 ### Page metadata
 
-Page scopes carry an editable metadata field list (default: `title`, `description`, `canonical`, `robots`). Resolution order, per design:
+Every page scope carries the full metadata set by default — `title`, `description`, `ogTitle`, `ogDescription`, `ogImage`, `twitterCard`, `canonical`, `noindex` — and a route's `page.cms.ts` `metadata` schema adds to or overrides it. The SEO panel previews the search snippet and the share card; blank share fields reuse the search fields. Resolution order, per design:
 
 ```
 editable page metadata (cms.metadata)
@@ -407,7 +482,19 @@ editable page metadata (cms.metadata)
   → static site defaults (defineBaseMetaTags)
 ```
 
-Hand `cms.metadata` directly to `definePageMetaTags(...)` from `svelte-meta-tags` and you're done.
+`toMetaTags(cms.metadata, { siteName })` turns the branch into `svelte-meta-tags` props, with the title template and Open Graph site name from the root layout's `branding.name`:
+
+```svelte
+<script lang="ts">
+	import { cms, toMetaTags } from '@velastack/cms';
+	const siteName = $derived(cms.docs['layout:/']?.branding?.name as string | undefined);
+	const metaTags = $derived(deepMerge(data.baseMetaTags, toMetaTags(cms.metadata, { siteName })));
+</script>
+```
+
+### Site options
+
+`createCms({ site })` declares the **Site Options** panel: project-wide values that never render on the page — the schema.org type (`enum`), the default share image (`image`), which locales are enabled (`boolean`). Field types are `text`, `markdown`, `number`, `datetime`, `url`, `color`, `image`, `enum` (with `values`) and `boolean`. Anything a visitor sees belongs in the root layout scope, edited in place with `scope="root"`; the site tree is one non-localised tree per project.
 
 ## Adapters
 
@@ -578,6 +665,24 @@ cms.locale; // 'es'
 cms.locales; // ['en', 'es', 'fr']
 ```
 
+## Seeding a project
+
+A fresh project should open with content, not a blank site. The backend accepts a project's whole published state as one object and returns it in the same shape:
+
+```ts
+type CmsSeed = {
+	layouts?: Record<locale, Record<routeId, Tree>>;
+	pages?: Record<locale, Record<routeId, Tree | PageEntry[]>>; // a bare tree is a static page
+	site?: Tree;
+};
+```
+
+- `POST /seed` with a `CmsSeed` (plus `force?: true`) writes the published rows directly, outside the release flow. It answers `409 { ok: false, reason: 'already-seeded' }` when the project already has published rows unless `force` is set, so it can never silently overwrite edits. Image values are seeded as URLs; nothing is uploaded.
+- `GET /export` returns the published rows as a `CmsSeed` (tombstoned pages omitted).
+- In-process: `backend.store.seed(projectId, seed, { force })` and `backend.store.exportPublished(projectId)`.
+
+Both routes require an editor session. A host that creates projects (velastack.dev's `/setup`) reads the template's published `content/` and calls `store.seed` right after creating the project, in the locales the owner enabled.
+
 ## Redirects & tombstones
 
 Pages can be deleted with three different outcomes:
@@ -611,17 +716,24 @@ cms({
 	endpoint: 'https://cms.example.com/v1/projects/p1/cms',
 	locales: ['en'], // mirror createCms({ locales })
 	mediaDir: 'static/cms-media', // download target (default)
-	mediaPrefix: '/cms-media' // URL prefix in rewritten content (default)
+	mediaPrefix: '/cms-media', // URL prefix in rewritten content (default)
+
+	// Content manifest: `content/<locale>.json` keyed by scope id. When the
+	// default locale's file exists its values are injected as `fallback`
+	// props into every walked .svelte file, so components stay name-only.
+	content: 'content' // default; `false` disables
 });
 ```
 
+Build tooling that needs the same parser — a `pack` step inlining fallbacks into a tarball, a `verify` step checking usages against a content manifest — imports it from `@velastack/cms/build`: `scanUsages(source)`, `injectFallbacks(source, treeOrResolver)` / `inlineFallbacks`, `buildManifest(...)` and `fallbackResolverFor(result, file, content)`. The manifest records each usage's component type (`scope.usages`), and the walk reports dynamic `name`s and out-of-chain `scope=` attributes as warnings instead of dropping them silently.
+
 The plugin also exposes `virtual:vela-cms/manifest` (typed via the package's ambient declaration). You almost never need to import it directly — `loadCms` does that internally — but it's there if you want to introspect the manifest at build time.
 
 ## Constraints (v1)
 
 Static analysis is conservative on purpose:
 
-- `name=` props must be string literals or `name={'literal'}`. Computed names are not extracted.
+- `name=` props must be string literals or `name={'literal'}`. Computed names are not extracted; the plugin warns about each one.
 - Only static `import` of `.svelte` files is followed when walking the component graph. Bare specifiers (npm packages) are skipped unless they're the @velastack/cms package itself, are listed under `components`, or match a `traverse` pattern.
 - `<svelte:component this={…} />` and dynamic component selection are not traced.
 - Layout reset segments (`+page@layout.svelte`) are not yet supported.

package/dist/backend/index.d.ts

@@ -49,6 +49,6 @@ export type { CmsStore } from './store/queries.js';
 export type { SqliteDb, SqliteStatement } from './store/sqlite.js';
 export type { Migration } from './store/migrations/index.js';
 export { MIGRATIONS } from './store/migrations/index.js';
-export type { DocsResponse, MediaItem, OpenRelease, PageMapEntry, PageMapRoute, PagesResponse, PagesRoute, PublishedRelease, ReleaseItem, ReleasePublisher, SiteResponse } from '../core/wire.js';
+export type { CmsSeed, DocsResponse, MediaItem, OpenRelease, PageMapEntry, PageMapRoute, PagesResponse, PagesRoute, PublishedRelease, ReleaseItem, ReleasePublisher, SeedRequest, SeedResponse, SeedSummary, SiteResponse } from '../core/wire.js';
 export type { PageDeleteOutcome, PageEntry } from '../core/page-entry.js';
 export type { Tree } from '../core/path.js';

package/dist/backend/routes/seed.d.ts

@@ -0,0 +1,6 @@
+import type { CmsSeed } from '../../core/wire.js';
+import { type RouteCtx } from './context.js';
+/** Validate a request body into a {@link CmsSeed}, or explain why not. */
+export declare const parseSeed: (body: unknown) => CmsSeed | string;
+export declare const postSeed: (ctx: RouteCtx) => Promise<Response>;
+export declare const getExport: (ctx: RouteCtx) => Response;

package/dist/backend/routes/seed.js

@@ -0,0 +1,96 @@
+import { badRequest, isObjectRecord, isStringRecord, readJson } from './context.js';
+const parseEntries = (raw) => {
+    const out = [];
+    for (const e of raw) {
+        if (!isObjectRecord(e))
+            return 'page entries must be objects';
+        if (!isStringRecord(e.params))
+            return 'page entry params must be a string-keyed object';
+        if (!isObjectRecord(e.published))
+            return 'page entry published must be an object';
+        const entry = { params: e.params, published: e.published };
+        const t = e.tombstone;
+        if (isObjectRecord(t)) {
+            if (t.kind === 'gone')
+                entry.tombstone = { kind: 'gone' };
+            else if (t.kind === 'redirect' && typeof t.to === 'string') {
+                entry.tombstone = { kind: 'redirect', to: t.to };
+            }
+            else
+                return 'page entry tombstone must be gone or redirect';
+        }
+        out.push(entry);
+    }
+    return out;
+};
+/** Validate a request body into a {@link CmsSeed}, or explain why not. */
+export const parseSeed = (body) => {
+    if (!isObjectRecord(body))
+        return 'object body required';
+    const seed = {};
+    if (body.layouts !== undefined) {
+        if (!isObjectRecord(body.layouts))
+            return 'layouts must be keyed by locale';
+        seed.layouts = {};
+        for (const [locale, byRoute] of Object.entries(body.layouts)) {
+            if (!isObjectRecord(byRoute))
+                return `layouts.${locale} must be keyed by route id`;
+            const bucket = {};
+            for (const [routeId, tree] of Object.entries(byRoute)) {
+                if (!routeId.startsWith('/'))
+                    return `layouts.${locale}: "${routeId}" is not a route id`;
+                if (!isObjectRecord(tree))
+                    return `layouts.${locale}.${routeId} must be an object`;
+                bucket[routeId] = tree;
+            }
+            seed.layouts[locale] = bucket;
+        }
+    }
+    if (body.pages !== undefined) {
+        if (!isObjectRecord(body.pages))
+            return 'pages must be keyed by locale';
+        seed.pages = {};
+        for (const [locale, byRoute] of Object.entries(body.pages)) {
+            if (!isObjectRecord(byRoute))
+                return `pages.${locale} must be keyed by route id`;
+            const bucket = {};
+            for (const [routeId, value] of Object.entries(byRoute)) {
+                if (!routeId.startsWith('/'))
+                    return `pages.${locale}: "${routeId}" is not a route id`;
+                if (Array.isArray(value)) {
+                    const entries = parseEntries(value);
+                    if (typeof entries === 'string')
+                        return `pages.${locale}.${routeId}: ${entries}`;
+                    bucket[routeId] = entries;
+                }
+                else if (isObjectRecord(value)) {
+                    bucket[routeId] = value;
+                }
+                else
+                    return `pages.${locale}.${routeId} must be an object or an entry list`;
+            }
+            seed.pages[locale] = bucket;
+        }
+    }
+    if (body.site !== undefined) {
+        if (!isObjectRecord(body.site))
+            return 'site must be an object';
+        seed.site = body.site;
+    }
+    return seed;
+};
+export const postSeed = async (ctx) => {
+    const body = await readJson(ctx.event);
+    if (body === undefined)
+        return badRequest('invalid json');
+    const seed = parseSeed(body);
+    if (typeof seed === 'string')
+        return badRequest(seed);
+    const force = isObjectRecord(body) && body.force === true;
+    const result = ctx.store.seed(ctx.projectId, seed, { force });
+    if (!result.ok)
+        return Response.json(result, { status: 409 });
+    ctx.cache.clear();
+    return Response.json(result);
+};
+export const getExport = (ctx) => Response.json(ctx.store.exportPublished(ctx.projectId));

package/dist/backend/routes/table.js

@@ -6,6 +6,7 @@ import { getLogin, getLoginSuccess, postLogin } from './login.js';
 import { deleteReleaseItems, getRelease, getReleaseHistory, postReleaseDiscard, postReleaseHistoryPreviewKey, postReleaseItems, postReleasePreviewKey, postReleasePublish, postReleaseRevert } from './release.js';
 import { deleteMediaItem, getMedia, getUpload, postMedia } from './media.js';
 import { getDeploy, postDeploy } from './deploy.js';
+import { getExport, postSeed } from './seed.js';
 import { postTestReset } from './test-reset.js';
 export const ROUTES = [
     { method: 'GET', segments: ['docs'], auth: 'public', handler: getDocs },
@@ -65,6 +66,8 @@ export const ROUTES = [
     },
     { method: 'GET', segments: ['deploy'], auth: 'required', handler: getDeploy },
     { method: 'POST', segments: ['deploy'], auth: 'required', handler: postDeploy },
+    { method: 'POST', segments: ['seed'], auth: 'required', handler: postSeed },
+    { method: 'GET', segments: ['export'], auth: 'required', handler: getExport },
     { method: 'GET', segments: ['media'], auth: 'required', handler: getMedia },
     { method: 'POST', segments: ['media'], auth: 'required', handler: postMedia },
     { method: 'DELETE', segments: ['media', ':id'], auth: 'required', handler: deleteMediaItem },

package/dist/backend/store/queries.d.ts

@@ -1,6 +1,6 @@
 import { type PageEntry, type PageDeleteOutcome } from '../../core/page-entry.js';
 import { type Tree } from '../../core/path.js';
-import type { AddReleaseItemInput, CreatePageResult, DiscardItemTarget, ListMediaOptions, ListMediaResult, MediaItem, OpenRelease, PageMapRoute, PublishedRelease, ReleaseItem, RenamePageResult, StagePageDeleteResult } from '../../core/wire.js';
+import type { AddReleaseItemInput, CmsSeed, CreatePageResult, DiscardItemTarget, ListMediaOptions, ListMediaResult, MediaItem, OpenRelease, PageMapRoute, PublishedRelease, ReleaseItem, RenamePageResult, SeedResponse, StagePageDeleteResult } from '../../core/wire.js';
 import type { SqliteDb } from './sqlite.js';
 import type { CmsEditor } from '../types.js';
 /** The locale a request falls back to when it names none. */
@@ -33,6 +33,7 @@ export declare const createStore: (db: SqliteDb) => {
     createPage: (projectId: string, userId: string, routeId: string, locale: string, params: Record<string, string>, metadata?: Record<string, unknown>) => CreatePageResult;
     deleteMediaItem: (projectId: string, id: string) => MediaItem | null;
     discardOpenRelease: (projectId: string, userId: string) => boolean;
+    exportPublished: (projectId: string) => CmsSeed;
     discardReleaseItem: (projectId: string, userId: string, target: DiscardItemTarget) => boolean;
     findMediaItem: (projectId: string, id: string) => MediaItem | null;
     findOpenReleaseByPreviewKey: (projectId: string, key: string) => OpenRelease | null;
@@ -44,6 +45,7 @@ export declare const createStore: (db: SqliteDb) => {
     getPublishedPageEntry: (projectId: string, locale: string, routeId: string, params: Record<string, string>) => PageEntry | null;
     getPublishedSiteTree: (projectId: string) => Tree;
     getReleaseHistory: (projectId: string) => PublishedRelease[];
+    hasPublishedContent: (projectId: string) => boolean;
     listAllPages: (projectId: string, userId: string, locale: string) => PageMapRoute[];
     listMediaItems: (projectId: string, { offset, limit }?: ListMediaOptions) => ListMediaResult;
     listPageParamValues: (projectId: string, routeId: string, param: string) => string[];
@@ -62,6 +64,9 @@ export declare const createStore: (db: SqliteDb) => {
         toUrl: string;
     }) => RenamePageResult;
     revertRelease: (projectId: string, releaseId: string, user: CmsEditor) => PublishedRelease | null;
+    seed: (projectId: string, input: CmsSeed, opts?: {
+        force?: boolean;
+    }) => SeedResponse;
     seedPublishedDocs: (projectId: string, layouts: Record<string, Record<string, Tree>>, pages: Record<string, Record<string, PageEntry[]>>) => void;
     stagePageDelete: (projectId: string, userId: string, routeId: string, locale: string, params: Record<string, string>, outcome?: PageDeleteOutcome) => StagePageDeleteResult;
 };

package/dist/backend/store/queries.js

@@ -1177,6 +1177,92 @@ export const createStore = (db) => {
         });
         tx();
     };
+    // ---------------------------------------------------------------------------
+    // Seed / export
+    // ---------------------------------------------------------------------------
+    const countPublishedStmt = () => db.prepare(`SELECT (SELECT COUNT(*) FROM published_pages WHERE project_id = ?)
+			      + (SELECT COUNT(*) FROM published_layouts WHERE project_id = ?)
+			      + (SELECT COUNT(*) FROM published_site WHERE project_id = ?) AS n`);
+    /** Whether the project holds any published page, layout or site row. */
+    const hasPublishedContent = (projectId) => (countPublishedStmt().get(projectId, projectId, projectId)?.n ?? 0) > 0;
+    /**
+     * Seed a project's published content from a {@link CmsSeed} — a template's
+     * `content/` at project creation, or an export of another project. Writes
+     * the published rows directly, outside the release flow: there is no editor
+     * and nothing to revert to. Refuses when the project already has published
+     * rows unless `force`, so a second run cannot silently overwrite edits.
+     * Rows a forced seed does not name are left alone. Bumps `cms_version` so
+     * cached public reads are invalidated.
+     */
+    const seed = (projectId, input, opts = {}) => {
+        const tx = db.transaction(() => {
+            if (!opts.force && hasPublishedContent(projectId)) {
+                return { ok: false, reason: 'already-seeded' };
+            }
+            ensureProjectState(projectId);
+            const seedReleaseId = `seed-${projectId}`;
+            const at = nowIso();
+            const locales = new Set();
+            let layouts = 0;
+            let pages = 0;
+            for (const [locale, byRoute] of Object.entries(input.layouts ?? {})) {
+                for (const [routeId, tree] of Object.entries(byRoute)) {
+                    locales.add(locale);
+                    layouts += 1;
+                    upsertPublishedLayoutStmt().run(projectId, locale, routeId, JSON.stringify(tree), at, seedReleaseId);
+                }
+            }
+            for (const [locale, byRoute] of Object.entries(input.pages ?? {})) {
+                for (const [routeId, value] of Object.entries(byRoute)) {
+                    const entries = Array.isArray(value)
+                        ? value
+                        : [{ params: {}, published: value }];
+                    for (const entry of entries) {
+                        locales.add(locale);
+                        pages += 1;
+                        upsertPublishedPageStmt().run(projectId, locale, routeId, paramsHash(entry.params), JSON.stringify(entry.params), JSON.stringify(entry.published), entry.tombstone ? JSON.stringify(entry.tombstone) : null, at, seedReleaseId);
+                    }
+                }
+            }
+            const site = !!input.site;
+            if (input.site) {
+                upsertPublishedSiteStmt().run(projectId, JSON.stringify(input.site), at, seedReleaseId);
+            }
+            bumpProjectVersionStmt().run(projectId);
+            return { ok: true, seeded: { locales: [...locales].sort(), layouts, pages, site } };
+        });
+        return tx();
+    };
+    /**
+     * Every published row, in the shape {@link seed} accepts. Tombstoned pages
+     * are omitted: a seed describes content, not deletions.
+     */
+    const exportPublished = (projectId) => {
+        const out = { layouts: {}, pages: {} };
+        for (const { locale } of allLocalesForProjectStmt().all(projectId, projectId)) {
+            const layouts = {};
+            for (const r of allLayoutsByLocaleStmt().all(projectId, locale)) {
+                layouts[r.route_id] = parseTree(r.tree) ?? {};
+            }
+            if (Object.keys(layouts).length > 0)
+                out.layouts[locale] = layouts;
+            const pages = {};
+            for (const r of allPagesByLocaleStmt().all(projectId, locale)) {
+                if (parseOutcome(r.tombstone))
+                    continue;
+                (pages[r.route_id] ??= []).push({
+                    params: parseParams(r.params),
+                    published: parseTree(r.tree) ?? {}
+                });
+            }
+            if (Object.keys(pages).length > 0)
+                out.pages[locale] = pages;
+        }
+        const site = getPublishedSiteTree(projectId);
+        if (Object.keys(site).length > 0)
+            out.site = site;
+        return out;
+    };
     return {
         __resetProjectForTests,
         addReleaseItems,
@@ -1186,6 +1272,7 @@ export const createStore = (db) => {
         createPage,
         deleteMediaItem,
         discardOpenRelease,
+        exportPublished,
         discardReleaseItem,
         findMediaItem,
         findOpenReleaseByPreviewKey,
@@ -1197,6 +1284,7 @@ export const createStore = (db) => {
         getPublishedPageEntry,
         getPublishedSiteTree,
         getReleaseHistory,
+        hasPublishedContent,
         listAllPages,
         listMediaItems,
         listPageParamValues,
@@ -1206,6 +1294,7 @@ export const createStore = (db) => {
         regeneratePublishedPreviewKey,
         renamePage,
         revertRelease,
+        seed,
         seedPublishedDocs,
         stagePageDelete
     };

package/dist/cms.js

@@ -3,27 +3,24 @@ import { locales } from '../locales/data.js';
 export const { load: loadCms, generateEntries } = createCms({
     adapter: apiAdapter({ endpoint: 'https://velastack.dev/v1/projects/velastack-cms/cms' }),
     locales,
+    // Site options: values that never render on the page. Branding, contact
+    // and social links live in the root layout scope and are edited in place.
     site: {
-        branding: {
-            label: 'Branding',
+        seo: {
+            label: 'Search & sharing',
             fields: {
-                name: { type: 'text', label: 'Business name' },
-                tagline: { type: 'text', label: 'Tagline' },
-                logo: { type: 'image', label: 'Logo' }
+                schemaType: {
+                    type: 'enum',
+                    label: 'Business type (schema.org)',
+                    values: ['LocalBusiness', 'Restaurant', 'Hotel', 'Store', 'ProfessionalService']
+                },
+                shareImage: { type: 'image', label: 'Default share image' }
             }
         },
-        contact: {
-            label: 'Contact',
+        locales: {
+            label: 'Languages',
             fields: {
-                email: { type: 'text', label: 'Email', placeholder: 'hello@example.com' },
-                phone: { type: 'text', label: 'Phone' }
-            }
-        },
-        social: {
-            label: 'Social',
-            fields: {
-                twitter: { type: 'url', label: 'Twitter / X' },
-                instagram: { type: 'url', label: 'Instagram' }
+                es: { type: 'boolean', label: 'Spanish (es) enabled' }
             }
         }
     }

package/dist/components/admin-bar/admin-bar-internal.svelte

@@ -1041,7 +1041,7 @@
 		siteSettingsOpen = true;
 	};
 
-	// Mirrors `onSaveSeo`: flush the site-settings draft as part of the open
+	// Mirrors `onSaveSeo`: flush the site-options draft as part of the open
 	// release, refresh overlays so the just-saved values show via the
 	// preview-overlay path on the live page.
 	const onSaveSiteSettings = async () => {
@@ -1440,7 +1440,7 @@
 
 							<Menubar.Label class={menuLabelClass}>Settings</Menubar.Label>
 							<Menubar.Item class={menuItemClass} onSelect={onOpenSiteSettings}>
-								Site Settings
+								Site Options
 								<KbdShortcut keys="⌘," class={menuShortcutClass} />
 							</Menubar.Item>
 						</Menubar.Content>
@@ -1662,8 +1662,8 @@
 		{/if}
 
 		{#if siteSettingsOpen}
-			{#await import('./site-settings-panel.svelte') then { default: SiteSettingsPanel }}
-				<SiteSettingsPanel onClose={() => (siteSettingsOpen = false)} onSave={onSaveSiteSettings} />
+			{#await import('./site-options-panel.svelte') then { default: SiteOptionsPanel }}
+				<SiteOptionsPanel onClose={() => (siteSettingsOpen = false)} onSave={onSaveSiteSettings} />
 			{/await}
 		{/if}