@velastack/cms 0.4.0 → 0.5.0

package/dist/editor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `@velastack/cms/editor` — the editing chrome a structured component's
+ * editable sibling imports lazily, so none of it reaches the public bundle:
+ *
+ * ```svelte
+ * {#await import('@velastack/cms/editor') then { StructuredEditorPopover, FieldInput, ReorderButtons }}
+ * ```
+ */
+export { default as StructuredEditorPopover } from './components/admin-bar/structured-editor-popover.svelte';
+export { default as FieldInput } from './components/admin-bar/field-input.svelte';
+export type { FieldInputType } from './components/admin-bar/field-input.svelte';
+export { default as ReorderButtons } from './components/admin-bar/reorder-buttons.svelte';
+export { default as CssRoot } from './components/admin-bar/css-root.svelte';
+export { Button } from './components/admin-bar/ui/button/index.js';
+export { Input } from './components/admin-bar/ui/input/index.js';
+export { Textarea } from './components/admin-bar/ui/textarea/index.js';
+export { Switch } from './components/admin-bar/ui/switch/index.js';
+export { Checkbox } from './components/admin-bar/ui/checkbox/index.js';
+export * as Popover from './components/admin-bar/ui/popover/index.js';
+export * as Tabs from './components/admin-bar/ui/tabs/index.js';
+export * as Sheet from './components/admin-bar/ui/sheet/index.js';
+export { default as CmsMediaPicker } from './components/cms/cms-media-picker.svelte';

package/dist/editor.js

@@ -0,0 +1,21 @@
+/**
+ * `@velastack/cms/editor` — the editing chrome a structured component's
+ * editable sibling imports lazily, so none of it reaches the public bundle:
+ *
+ * ```svelte
+ * {#await import('@velastack/cms/editor') then { StructuredEditorPopover, FieldInput, ReorderButtons }}
+ * ```
+ */
+export { default as StructuredEditorPopover } from './components/admin-bar/structured-editor-popover.svelte';
+export { default as FieldInput } from './components/admin-bar/field-input.svelte';
+export { default as ReorderButtons } from './components/admin-bar/reorder-buttons.svelte';
+export { default as CssRoot } from './components/admin-bar/css-root.svelte';
+export { Button } from './components/admin-bar/ui/button/index.js';
+export { Input } from './components/admin-bar/ui/input/index.js';
+export { Textarea } from './components/admin-bar/ui/textarea/index.js';
+export { Switch } from './components/admin-bar/ui/switch/index.js';
+export { Checkbox } from './components/admin-bar/ui/checkbox/index.js';
+export * as Popover from './components/admin-bar/ui/popover/index.js';
+export * as Tabs from './components/admin-bar/ui/tabs/index.js';
+export * as Sheet from './components/admin-bar/ui/sheet/index.js';
+export { default as CmsMediaPicker } from './components/cms/cms-media-picker.svelte';

package/dist/index.d.ts

@@ -7,21 +7,29 @@
 export { default as CmsText } from './components/cms/cms-text.svelte';
 export { default as CmsRichText } from './components/cms/cms-rich-text.svelte';
 export { default as CmsMarkdown } from './components/cms/cms-markdown.svelte';
-export { default as CmsImage } from './components/cms/cms-image.svelte';
+export { default as CmsImage, normalizeImage } from './components/cms/cms-image.svelte';
+export type { CmsImageValue } from './components/cms/cms-image.svelte';
 export { default as CmsBoolean } from './components/cms/cms-boolean.svelte';
 export { default as CmsNumber } from './components/cms/cms-number.svelte';
 export type { CmsNumberProps } from './components/cms/cms-number.svelte';
 export { default as CmsDateTime } from './components/cms/cms-date-time.svelte';
 export type { CmsDateTimeMode, CmsDateTimeProps } from './components/cms/cms-date-time.svelte';
-export { default as CmsLink } from './components/cms/cms-link.svelte';
+export { default as CmsLink, normalizeLink } from './components/cms/cms-link.svelte';
 export type { CmsLinkValue, CmsLinkRenderProps } from './components/cms/cms-link.svelte';
 export { default as CmsRepeater } from './components/cms/cms-repeater.svelte';
 export { default as CmsEntries } from './components/cms/cms-entries.svelte';
 export { default as AdminBar } from './components/admin-bar/admin-bar.svelte';
-export { definePage } from './components/admin-bar/page-config.js';
+export { useCmsField, resolveScopeRef, ROOT_SCOPE_ID } from './components/cms/use-cms-field.svelte.js';
+export type { CmsField, CmsFieldInput } from './components/cms/use-cms-field.svelte.js';
+export { defineStructured, applyTranslations, countTranslations, extractTranslations, stripTranslations, translatableFields, translationPath, asBoolean, asItems, asNumber, asString, newItemId, ROOT_ID, TRANSLATIONS_KEY } from './core/structured.js';
+export type { Structured, StructuredItem, StructuredSchema, TranslatableField, TranslationOverlay } from './core/structured.js';
+export { registerStructured, getStructured } from './components/cms/structured-registry.js';
+export { toMetaTags } from './core/metadata.js';
+export type { MetaTagsOptions, MetaTagsOutput } from './core/metadata.js';
+export { definePage, DEFAULT_METADATA_SCHEMA, metadataSchemaFor } from './components/admin-bar/page-config.js';
 export type { CmsPageConfig, CmsCreatablePageConfig, CmsStaticPageConfig, CmsPageField, CmsPageMetadataSchema, MetadataFieldSchema, MetadataPrimitive } from './components/admin-bar/page-config.js';
 export { cmsStore } from './components/cms/cms-store.svelte.js';
 export { cms } from './components/cms/cms-store.svelte.js';
 export { CMS_SCOPE, getCmsScope, getCmsValue, getPageScope } from './components/cms/scope.js';
 export { installCmsScope } from './components/cms/install-scope.svelte.js';
-export type { CmsEntry, CmsManifest, CmsManifestRoute, CmsManifestScope, CmsPayload, CmsScope, CmsScopeEntry } from './components/cms/scope.js';
+export type { CmsEntry, CmsManifest, CmsManifestRoute, CmsManifestScope, CmsManifestUsage, CmsPayload, CmsScope, CmsScopeEntry, SiteFieldSchema, SiteFieldType, SiteSchema } from './components/cms/scope.js';

package/dist/index.js

@@ -8,17 +8,27 @@
 export { default as CmsText } from './components/cms/cms-text.svelte';
 export { default as CmsRichText } from './components/cms/cms-rich-text.svelte';
 export { default as CmsMarkdown } from './components/cms/cms-markdown.svelte';
-export { default as CmsImage } from './components/cms/cms-image.svelte';
+export { default as CmsImage, normalizeImage } from './components/cms/cms-image.svelte';
 export { default as CmsBoolean } from './components/cms/cms-boolean.svelte';
 export { default as CmsNumber } from './components/cms/cms-number.svelte';
 export { default as CmsDateTime } from './components/cms/cms-date-time.svelte';
-export { default as CmsLink } from './components/cms/cms-link.svelte';
+export { default as CmsLink, normalizeLink } from './components/cms/cms-link.svelte';
 export { default as CmsRepeater } from './components/cms/cms-repeater.svelte';
 export { default as CmsEntries } from './components/cms/cms-entries.svelte';
 // Admin bar (sync wrapper; admin-bar-internal + seo-panel are async chunks)
 export { default as AdminBar } from './components/admin-bar/admin-bar.svelte';
+// Building blocks for structured components: the field hook, the value
+// rules (versioned shapes, `$t` overlay) and the registry the Locales panel
+// reads. The editor popover and field inputs are admin-bar chunks, imported
+// lazily by editable siblings:
+//   `import('@velastack/cms/editor')`
+export { useCmsField, resolveScopeRef, ROOT_SCOPE_ID } from './components/cms/use-cms-field.svelte.js';
+export { defineStructured, applyTranslations, countTranslations, extractTranslations, stripTranslations, translatableFields, translationPath, asBoolean, asItems, asNumber, asString, newItemId, ROOT_ID, TRANSLATIONS_KEY } from './core/structured.js';
+export { registerStructured, getStructured } from './components/cms/structured-registry.js';
+// Page metadata → svelte-meta-tags props.
+export { toMetaTags } from './core/metadata.js';
 // Per-route page configuration — declare in `page.cms.ts` next to `+page.svelte`.
-export { definePage } from './components/admin-bar/page-config.js';
+export { definePage, DEFAULT_METADATA_SCHEMA, metadataSchemaFor } from './components/admin-bar/page-config.js';
 // Edit-mode store
 export { cmsStore } from './components/cms/cms-store.svelte.js';
 // Merged CMS read view (server payload + client overlay), shaped like CmsPayload

package/dist/server/load-cms.js

@@ -61,6 +61,7 @@ export const resolveCmsPayload = async (args) => {
             routeId: scope.routeId,
             params: scopeParams,
             fields: scope.fields,
+            ...(scope.usages ? { usages: scope.usages } : {}),
             locale: forLocale
         };
     });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@velastack/cms",
-	"version": "0.4.0",
+	"version": "0.5.0",
 	"description": "A scope-aware CMS for SvelteKit, for static or dynamic sites.",
 	"keywords": [
 		"svelte",
@@ -57,6 +57,11 @@
 			"svelte": "./dist/index.js",
 			"default": "./dist/index.js"
 		},
+		"./editor": {
+			"types": "./dist/editor.d.ts",
+			"svelte": "./dist/editor.js",
+			"default": "./dist/editor.js"
+		},
 		"./server": {
 			"types": "./dist/server/index.d.ts",
 			"default": "./dist/server/index.js"
@@ -72,6 +77,10 @@
 		"./adapter": {
 			"types": "./plugin/dist/adapter.d.ts",
 			"default": "./plugin/dist/adapter.js"
+		},
+		"./build": {
+			"types": "./plugin/dist/build.d.ts",
+			"default": "./plugin/dist/build.js"
 		}
 	},
 	"peerDependencies": {
@@ -110,7 +119,7 @@
 		"tw-animate-css": "^1.4.0",
 		"typescript": "^6.0.3",
 		"vite": "^8.2.2",
-		"vitest": "^4.1.11"
+		"vitest": "^5.0.1"
 	},
 	"dependencies": {
 		"@sveltejs/adapter-static": "^3.0.10",
@@ -119,7 +128,7 @@
 		"@tiptap/pm": "^3.30.6",
 		"@tiptap/starter-kit": "^3.30.6",
 		"bits-ui": "^2.19.0",
-		"devalue": "^5.9.2",
+		"devalue": "^6.0.0",
 		"tailwind-merge": "^3.6.0"
 	}
 }

package/plugin/README.md

@@ -31,6 +31,11 @@ type CmsPluginOptions = {
 	libDir?: string; // default: 'src/lib'
 	components?: ExternalCmsComponentSpec[];
 	traverse?: (string | RegExp)[];
+	endpoint?: string; // media download at build time
+	locales?: string[]; // default: ['en']; locales[0] is the default locale
+	mediaDir?: string;
+	mediaPrefix?: string;
+	content?: string | false; // default: 'content' — see "Content manifest"
 };
 
 type ExternalCmsComponentSpec =
@@ -48,6 +53,14 @@ type ExternalCmsComponentSpec =
   `source === pattern || source.startsWith(pattern + '/')`. Auto-populated with
   every `components[].source`.
 
+- `content` — directory of per-locale content manifests. See below.
+
+## Content manifest
+
+When `<content>/<defaultLocale>.json` exists, the plugin reads it — an object keyed by scope id (`layout:/`, `page:/(public)/about`, `site`) — and injects each usage's value as a `fallback={…}` prop (`initial` for `CmsBoolean`) into every walked `.svelte` file, route entrypoints and shared components alike. A `scope="root"` usage reads `layout:/`; any other usage reads the scopes that reach its file, leaf first. Components in source stay name-only; the value the visitor sees before the CMS answers comes from the manifest. The file is watched, so edits apply in dev.
+
+The same operation is available to other tooling from `@velastack/cms/build` (`scanUsages`, `injectFallbacks` / `inlineFallbacks`, `buildManifest`, `fallbackResolverFor`), so `pack` and `verify` in a templates repo share this parser instead of carrying their own.
+
 ## Virtual modules
 
 ### `virtual:vela-cms/manifest`
@@ -57,6 +70,7 @@ import { cmsManifest } from 'virtual:vela-cms/manifest';
 
 type CmsManifest = {
 	version: 1;
+	// each scope lists `fields` (names) and `usages` ({ name, component, preset? })
 	routes: Record<string, { scopes: CmsManifestScope[] }>;
 };
 
@@ -107,6 +121,8 @@ For each route entrypoint (`+page.svelte` or `+layout.svelte`), the plugin
 parses with `svelte/compiler` and follows static imports of `.svelte` files.
 Imports get classified as CMS components by:
 
+0. **`@velastack/cms` by name** — every named import from the package
+   specifier, with no resolver needed.
 1. **In-tree barrel** — anything from `<libDir>/components/cms/index.{ts,js}`.
    Named imports are CMS components; default isn't.
 2. **In-tree files** — `.svelte` files directly under `<libDir>/components/cms/`.
@@ -116,8 +132,12 @@ Imports get classified as CMS components by:
 4. **External `components` spec** — user-declared packs.
 
 Component usages with a `name=<static>` prop are recorded as field
-references; `value=<…>` opts the call out (it's a runtime override, not a
-field). Dynamic `name={expr}` props are ignored.
+references with their component type; `value=<…>` opts the call out (it's a
+runtime override, not a field). A `scope="root"` (or `scope="layout:/x"`)
+attribute records the usage under that layout scope instead of the file's
+own. Dynamic `name={expr}` props and `scope=` attributes naming a scope
+outside the route's chain are reported as warnings on the build result and
+logged by the plugin.
 
 ## HMR
 

package/plugin/dist/build.d.ts

@@ -0,0 +1,74 @@
+import { buildManifest, resolveScopeAttr, ROOT_SCOPE_ID, type BuildManifestOptions, type BuildManifestResult, type CmsManifest, type CmsManifestScope, type CmsManifestUsage } from './manifest.js';
+export { buildManifest, resolveScopeAttr, ROOT_SCOPE_ID };
+export type Tree = Record<string, unknown>;
+export type { BuildManifestOptions, BuildManifestResult, CmsManifest, CmsManifestScope, CmsManifestUsage };
+export type CmsUsage = {
+    /** Static `name=` literal, or `null` when absent or dynamic. */
+    name: string | null;
+    /** Canonical exported component name (`CmsText`, `CmsHours`, …). */
+    component: string;
+    /** Local binding used in the template. */
+    local: string;
+    /** Resolved scope id from `scope=`, or `null` for the enclosing route scope. */
+    scope: string | null;
+    preset: string | null;
+    /** `name=` was present but not a static string. */
+    dynamic: boolean;
+    hasValue: boolean;
+    hasFallback: boolean;
+    line: number;
+    /** Source offsets of the component node. */
+    start: number;
+    end: number;
+};
+export type ScanOptions = {
+    filename?: string;
+    /**
+     * Extra local names to treat as CMS components, for wrappers a template
+     * declares itself. Package imports and `$lib/components/cms/*` are always
+     * recognized.
+     */
+    components?: string[];
+};
+export type ScanResult = {
+    usages: CmsUsage[];
+    /** Dynamic names, which no manifest can record. */
+    warnings: string[];
+};
+/** Every CMS component usage in one `.svelte` source. */
+export declare const scanUsages: (source: string, options?: ScanOptions) => ScanResult;
+/** Returns the value to inject for a usage, or `undefined` to leave it alone. */
+export type FallbackResolver = (usage: CmsUsage) => unknown;
+export type InjectOptions = ScanOptions & {
+    /** Replace an existing `fallback` / `initial` prop instead of skipping it. */
+    overwrite?: boolean;
+};
+export type InjectResult = {
+    code: string;
+    /** Names that received a fallback. */
+    injected: string[];
+    /** Static names the resolver had no value for. */
+    missing: string[];
+};
+/**
+ * Write values into a file's CMS usages as `fallback={…}` props (the JSON
+ * literal of the value), leaving the source otherwise untouched. `resolve`
+ * is a content tree keyed by name, or a function for callers that know
+ * which scope each usage's value lives in (see {@link fallbackResolverFor}).
+ *
+ * Usages with a `value=` prop, a dynamic name, or (unless `overwrite`) an
+ * existing fallback are skipped. The plugin calls this in memory at build
+ * time in the templates repo; `pack` calls it to write the tarball's
+ * components, which is why it is also exported as {@link inlineFallbacks}.
+ */
+export declare const injectFallbacks: (source: string, resolve: Tree | FallbackResolver, options?: InjectOptions) => InjectResult;
+/** Same operation as {@link injectFallbacks}, named for the `pack` step that
+ * writes the result to disk. */
+export declare const inlineFallbacks: (source: string, resolve: Tree | FallbackResolver, options?: InjectOptions) => InjectResult;
+/**
+ * A resolver for one file, given a built manifest and a content manifest
+ * keyed by scope id (`layout:/`, `page:/(public)/about`, …). A usage with
+ * `scope=` reads that scope; otherwise the scopes that reach the file are
+ * tried leaf first, and the first one holding the value wins.
+ */
+export declare const fallbackResolverFor: (result: Pick<BuildManifestResult, "scopesByFile">, file: string, content: Record<string, Tree>) => FallbackResolver;

package/plugin/dist/build.js

@@ -0,0 +1,210 @@
+/**
+ * `@velastack/cms/build` — the one Svelte parser for build tooling.
+ *
+ * The templates repo's `pack` and `verify` steps, and this package's own Vite
+ * plugin, all need the same three things: which CMS components a `.svelte`
+ * file uses ({@link scanUsages}), how to write a content manifest's values
+ * into those usages as `fallback` props ({@link injectFallbacks}), and which
+ * scope a file's values live in ({@link fallbackResolverFor}, on top of
+ * {@link buildManifest}). Keeping them here means no consumer carries a Svelte
+ * parser of its own.
+ */
+import { basename } from 'node:path';
+import { parseSvelteSource } from './parse-svelte.js';
+import { buildManifest, isPackageSource, resolveScopeAttr, ROOT_SCOPE_ID } from './manifest.js';
+export { buildManifest, resolveScopeAttr, ROOT_SCOPE_ID };
+/** Dot-path read, the same rule as `core/path.ts` (numeric segments index arrays). */
+const get = (tree, path) => {
+    let cur = tree;
+    for (const seg of path.split('.')) {
+        if (cur == null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[seg];
+    }
+    return cur;
+};
+const IN_TREE_CMS_DIR = '$lib/components/cms';
+/**
+ * Classify a single file's imports without a bundler: the package by name,
+ * the in-tree `$lib/components/cms` barrel or files, and the caller's own
+ * list. Returns local binding → canonical component name.
+ */
+const classifyImports = (imports, extra) => {
+    const out = new Map();
+    for (const imp of imports) {
+        const source = imp.source;
+        if (isPackageSource(source) ||
+            source === IN_TREE_CMS_DIR ||
+            source === IN_TREE_CMS_DIR + '/index.js') {
+            for (const b of imp.bindings)
+                if (b.imported !== 'default')
+                    out.set(b.local, b.imported);
+            continue;
+        }
+        if (source.startsWith(IN_TREE_CMS_DIR + '/') && source.endsWith('.svelte')) {
+            for (const b of imp.bindings) {
+                if (b.imported === 'default')
+                    out.set(b.local, basename(source, '.svelte'));
+            }
+        }
+    }
+    for (const name of extra)
+        if (!out.has(name))
+            out.set(name, name);
+    return out;
+};
+const toUsage = (u, component) => ({
+    name: u.fieldName,
+    component,
+    local: u.componentName,
+    scope: u.scopeAttr ? resolveScopeAttr(u.scopeAttr) : null,
+    preset: u.presetAttr,
+    dynamic: u.dynamicName,
+    hasValue: u.hasValueAttr,
+    hasFallback: u.hasFallbackAttr,
+    line: u.line,
+    start: u.start,
+    end: u.end
+});
+/** Every CMS component usage in one `.svelte` source. */
+export const scanUsages = (source, options = {}) => {
+    const parsed = parseSvelteSource(source, options.filename);
+    const locals = classifyImports(parsed.imports, options.components ?? []);
+    const usages = [];
+    const warnings = [];
+    const where = options.filename ?? '<source>';
+    for (const u of parsed.componentUsages) {
+        const component = locals.get(u.componentName);
+        if (!component)
+            continue;
+        const usage = toUsage(u, component);
+        usages.push(usage);
+        if (usage.dynamic) {
+            warnings.push(`${where}:${u.line} <${u.componentName}> has a dynamic name`);
+        }
+    }
+    return { usages, warnings };
+};
+/** Components whose fallback prop is not called `fallback`. */
+const FALLBACK_PROP = { CmsBoolean: 'initial' };
+/**
+ * Write values into a file's CMS usages as `fallback={…}` props (the JSON
+ * literal of the value), leaving the source otherwise untouched. `resolve`
+ * is a content tree keyed by name, or a function for callers that know
+ * which scope each usage's value lives in (see {@link fallbackResolverFor}).
+ *
+ * Usages with a `value=` prop, a dynamic name, or (unless `overwrite`) an
+ * existing fallback are skipped. The plugin calls this in memory at build
+ * time in the templates repo; `pack` calls it to write the tarball's
+ * components, which is why it is also exported as {@link inlineFallbacks}.
+ */
+export const injectFallbacks = (source, resolve, options = {}) => {
+    const parsed = parseSvelteSource(source, options.filename);
+    const locals = classifyImports(parsed.imports, options.components ?? []);
+    const resolver = typeof resolve === 'function' ? resolve : (u) => (u.name ? get(resolve, u.name) : undefined);
+    const edits = [];
+    const injected = [];
+    const missing = [];
+    for (const u of parsed.componentUsages) {
+        const component = locals.get(u.componentName);
+        if (!component || !u.fieldName || u.hasValueAttr || u.nameAttrEnd === null)
+            continue;
+        if (u.hasFallbackAttr && !options.overwrite)
+            continue;
+        const value = resolver(toUsage(u, component));
+        if (value === undefined) {
+            missing.push(u.fieldName);
+            continue;
+        }
+        const prop = FALLBACK_PROP[component] ?? 'fallback';
+        const literal = JSON.stringify(value);
+        if (u.hasFallbackAttr) {
+            const existing = findAttr(source, u.start, u.end, prop);
+            if (existing)
+                edits.push({ at: existing[0], text: `${prop}={${literal}}`, replace: existing });
+            else
+                edits.push({ at: u.nameAttrEnd, text: ` ${prop}={${literal}}` });
+        }
+        else {
+            edits.push({ at: u.nameAttrEnd, text: ` ${prop}={${literal}}` });
+        }
+        injected.push(u.fieldName);
+    }
+    // Apply from the end so earlier offsets stay valid.
+    edits.sort((a, b) => b.at - a.at);
+    let code = source;
+    for (const e of edits) {
+        if (e.replace)
+            code = code.slice(0, e.replace[0]) + e.text + code.slice(e.replace[1]);
+        else
+            code = code.slice(0, e.at) + e.text + code.slice(e.at);
+    }
+    return { code, injected, missing };
+};
+/** Same operation as {@link injectFallbacks}, named for the `pack` step that
+ * writes the result to disk. */
+export const inlineFallbacks = injectFallbacks;
+/** Locate `prop=` inside a component node's source. Returns `[start, end]`. */
+const findAttr = (source, start, end, prop) => {
+    const re = new RegExp(`\\s${prop}\\s*=`, 'g');
+    const slice = source.slice(start, end);
+    const m = re.exec(slice);
+    if (!m)
+        return null;
+    const attrStart = start + m.index + 1;
+    // Find the matching end: either a quoted string or a balanced `{…}`.
+    let i = start + m.index + m[0].length;
+    while (i < end && /\s/.test(source[i]))
+        i++;
+    if (source[i] === '"' || source[i] === "'") {
+        const q = source[i];
+        i++;
+        while (i < end && source[i] !== q)
+            i++;
+        return [attrStart, i + 1];
+    }
+    if (source[i] === '{') {
+        let depth = 0;
+        for (; i < end; i++) {
+            const c = source[i];
+            if (c === '{')
+                depth++;
+            else if (c === '}') {
+                depth--;
+                if (depth === 0)
+                    return [attrStart, i + 1];
+            }
+            else if (c === '"' || c === "'" || c === '`') {
+                const q = c;
+                i++;
+                while (i < end && source[i] !== q) {
+                    if (source[i] === '\\')
+                        i++;
+                    i++;
+                }
+            }
+        }
+    }
+    return null;
+};
+/**
+ * A resolver for one file, given a built manifest and a content manifest
+ * keyed by scope id (`layout:/`, `page:/(public)/about`, …). A usage with
+ * `scope=` reads that scope; otherwise the scopes that reach the file are
+ * tried leaf first, and the first one holding the value wins.
+ */
+export const fallbackResolverFor = (result, file, content) => {
+    const reach = result.scopesByFile.get(file) ?? [];
+    return (usage) => {
+        if (!usage.name)
+            return undefined;
+        const candidates = usage.scope ? [usage.scope] : reach;
+        for (const scopeId of candidates) {
+            const v = get(content[scopeId], usage.name);
+            if (v !== undefined)
+                return v;
+        }
+        return undefined;
+    };
+};
+//# sourceMappingURL=build.js.map

package/plugin/dist/build.js.map

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

package/plugin/dist/index.d.ts

@@ -35,6 +35,15 @@ export type CmsPluginOptions = {
     mediaDir?: string;
     /** URL prefix used in rewritten content. Defaults to `'/cms-media'`. */
     mediaPrefix?: string;
+    /**
+     * Directory of per-locale content manifests, `content/<locale>.json`,
+     * keyed by scope id (`layout:/`, `page:/(public)/about`, `site`). When the
+     * default locale's file exists (`locales[0]`, else `en`), its values are
+     * injected into every walked `.svelte` file as `fallback` props, so
+     * components stay name-only in source. Relative to the Vite root; defaults
+     * to `'content'`. Pass `false` to disable.
+     */
+    content?: string | false;
 };
 /**
  * Vite plugin that scans SvelteKit route files, walks the static Svelte
@@ -53,4 +62,4 @@ export type CmsPluginOptions = {
  * aren't themselves CMS components.
  */
 export declare const cms: (options?: CmsPluginOptions) => Plugin;
-export type { CmsManifest, CmsManifestScope, ExternalCmsComponentSpec } from './manifest.js';
+export type { CmsManifest, CmsManifestScope, CmsManifestUsage, ExternalCmsComponentSpec } from './manifest.js';