@velastack/cms 0.1.0

package/plugin/dist/adapter.js

@@ -0,0 +1,346 @@
+import staticAdapter from '@sveltejs/adapter-static';
+import * as devalue from 'devalue';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { minifySync } from 'vite';
+import { getPageCmsModules } from './build-state.js';
+const ROUTE_GROUP_RE = /^\([^)]+\)$/;
+const SHIM_PATH = fileURLToPath(new URL('./fallback-shim.js', import.meta.url));
+/**
+ * Read `fallback-shim.js` from disk and minify it via oxc (vite's bundled
+ * minifier). Cached for the lifetime of the process — the shim source is
+ * static, and the adapter may be invoked more than once during
+ * tooling-driven workflows.
+ *
+ * @returns {string}
+ */
+let __cachedShim = /** @type {string | null} */ (null);
+const loadMinifiedShim = () => {
+    if (__cachedShim !== null)
+        return __cachedShim;
+    const source = fs.readFileSync(SHIM_PATH, 'utf-8');
+    const result = minifySync(SHIM_PATH, source);
+    if (result.errors && result.errors.length > 0) {
+        // Surface oxc parse errors loudly — silent fallback to raw source
+        // would ship unminified bytes on every page.
+        throw new Error(`@velastack/cms-static: failed to minify fallback-shim.js: ${result.errors
+            .map((/** @type {any} */ e) => e.message ?? String(e))
+            .join('; ')}`);
+    }
+    __cachedShim = result.code.trim();
+    return __cachedShim;
+};
+/**
+ * @typedef {Parameters<typeof staticAdapter>[0]} StaticAdapterOptions
+ */
+/**
+ * Strip SvelteKit route groups (e.g. `(marketing)`) from a route id and return
+ * the remaining segments.
+ *
+ * @param {string} routeId
+ * @returns {string[]}
+ */
+const stripRouteGroups = (routeId) => routeId.split('/').filter((s) => s !== '' && !ROUTE_GROUP_RE.test(s));
+/**
+ * Decide where a `__fallback.json` should be emitted for `routeId`. Returns
+ * the URL directory (e.g. `/rooms` for `/(marketing)/rooms/[slug]`), or `null`
+ * if this route doesn't get a fallback.
+ *
+ * Only routes whose trailing segment is parameterized AND whose earlier
+ * segments are all static get a fallback — otherwise the parent directory
+ * doesn't exist as a real path in the build output.
+ *
+ * @param {string} routeId
+ * @returns {string | null}
+ */
+const fallbackUrlDirFor = (routeId) => {
+    const segments = stripRouteGroups(routeId);
+    if (segments.length === 0)
+        return null;
+    const last = segments[segments.length - 1];
+    if (!last.includes('['))
+        return null;
+    const earlier = segments.slice(0, -1);
+    if (earlier.some((s) => s.includes('[')))
+        return null;
+    return earlier.length === 0 ? '/' : '/' + earlier.join('/');
+};
+/**
+ * @param {string[]} paths
+ * @param {RegExp} pattern
+ */
+const findSamplePath = (paths, pattern) => {
+    for (const p of paths)
+        if (pattern.test(p))
+            return p;
+    return null;
+};
+/**
+ * Replace concrete params/docs/metadata in the deserialized payload with
+ * fallback placeholders, in place. References inside the data graph (e.g.
+ * `cms.page.params` and `cms.scopes['page:...'].params` pointing at the same
+ * object) are preserved by `devalue.unflatten`, so a single mutation updates
+ * every alias.
+ *
+ * @param {any} obj
+ */
+const transformPayload = (obj) => {
+    if (!obj || typeof obj !== 'object')
+        return;
+    const cms = obj.cms;
+    if (!cms || typeof cms !== 'object')
+        return;
+    const pageScopeId = cms.page && cms.page.scopeId;
+    if (pageScopeId && cms.docs && Object.prototype.hasOwnProperty.call(cms.docs, pageScopeId)) {
+        cms.docs[pageScopeId] = {};
+    }
+    cms.metadata = {};
+    if (cms.scopes && typeof cms.scopes === 'object') {
+        for (const scopeId of Object.keys(cms.scopes)) {
+            const scope = cms.scopes[scopeId];
+            if (scope && scope.params && typeof scope.params === 'object') {
+                for (const name of Object.keys(scope.params)) {
+                    scope.params[name] = `%${name}%`;
+                }
+            }
+        }
+    }
+    if (cms.page && cms.page.params && typeof cms.page.params === 'object') {
+        for (const name of Object.keys(cms.page.params)) {
+            cms.page.params[name] = `%${name}%`;
+        }
+    }
+};
+/**
+ * @typedef {{ kind: 'static'; value: string }
+ *   | { kind: 'dynamic'; name: string }
+ *   | { kind: 'rest'; name: string }
+ *   | { kind: 'optional'; name: string }
+ *   | { kind: 'unsupported' }} ParsedSegment
+ */
+/**
+ * Parse a SvelteKit route id into typed segments. Route groups
+ * (`(marketing)`) are stripped — they don't appear in URLs. Matchers
+ * (`[slug=type]`) and mixed brackets (`prefix-[id]`) are flagged as
+ * `unsupported`; the caller skips routes containing them.
+ *
+ * Exported for unit testing; not part of the package's public API.
+ *
+ * @param {string} routeId
+ * @returns {ParsedSegment[]}
+ */
+export const parseRouteSegments = (routeId) => {
+    const parts = routeId.split('/').filter((p) => p !== '' && !ROUTE_GROUP_RE.test(p));
+    /** @type {ParsedSegment[]} */
+    const out = [];
+    for (const p of parts) {
+        const opt = /^\[\[(\w+)\]\]$/.exec(p);
+        if (opt) {
+            out.push({ kind: 'optional', name: opt[1] });
+            continue;
+        }
+        const rest = /^\[\.\.\.(\w+)\]$/.exec(p);
+        if (rest) {
+            out.push({ kind: 'rest', name: rest[1] });
+            continue;
+        }
+        const dyn = /^\[(\w+)\]$/.exec(p);
+        if (dyn) {
+            out.push({ kind: 'dynamic', name: dyn[1] });
+            continue;
+        }
+        if (p.includes('[')) {
+            out.push({ kind: 'unsupported' });
+            continue;
+        }
+        out.push({ kind: 'static', value: p });
+    }
+    return out;
+};
+/**
+ * Build a URL → params extractor for a given parsed-segment list. Mirrors
+ * SvelteKit's own routing semantics: static segments must match, dynamic
+ * segments bind one URL part, `[[opt]]` may consume zero or one part,
+ * `[...rest]` consumes the remaining parts as a `/`-joined string.
+ *
+ * Returns `null` if the segments include any `unsupported` marker — the
+ * caller should skip those routes (and emit a build-log warning).
+ *
+ * Exported for unit testing; not part of the package's public API.
+ *
+ * @param {ParsedSegment[]} segments
+ * @returns {((url: string) => Record<string, string> | null) | null}
+ */
+export const buildParamExtractor = (segments) => {
+    if (segments.some((s) => s.kind === 'unsupported'))
+        return null;
+    return (url) => {
+        const parts = url.split('/').filter((p) => p !== '');
+        /** @type {Record<string, string>} */
+        const params = {};
+        let pi = 0;
+        for (const seg of segments) {
+            if (seg.kind === 'static') {
+                if (parts[pi] !== seg.value)
+                    return null;
+                pi++;
+            }
+            else if (seg.kind === 'rest') {
+                params[seg.name] = parts.slice(pi).join('/');
+                pi = parts.length;
+            }
+            else if (seg.kind === 'optional') {
+                if (pi < parts.length) {
+                    params[seg.name] = parts[pi];
+                    pi++;
+                }
+                else {
+                    params[seg.name] = '';
+                }
+            }
+            else {
+                if (pi >= parts.length)
+                    return null;
+                params[seg.name] = parts[pi];
+                pi++;
+            }
+        }
+        if (pi !== parts.length)
+            return null;
+        return params;
+    };
+};
+/**
+ * Read a SvelteKit `__data.json`, transform each `data` node via
+ * `devalue.unflatten` → mutate → `devalue.stringify`, and re-emit the wrapping
+ * `{type, nodes}` envelope.
+ *
+ * @param {string} jsonText
+ * @returns {string}
+ */
+const transformDataJson = (jsonText) => {
+    /** @type {{ type: string; nodes: Array<null | { type: string; data: any[]; uses?: any; slash?: any }> }} */
+    const parsed = JSON.parse(jsonText);
+    const nodes = parsed.nodes.map((node) => {
+        if (!node || node.type !== 'data' || !Array.isArray(node.data))
+            return node;
+        const obj = devalue.unflatten(node.data);
+        transformPayload(obj);
+        const newData = JSON.parse(devalue.stringify(obj));
+        return { ...node, data: newData };
+    });
+    return JSON.stringify({ ...parsed, nodes }) + '\n';
+};
+/**
+ * Wraps `@sveltejs/adapter-static`. After the inner adapter writes prerendered
+ * pages, scans `builder.routes` for parameterized routes and emits a
+ * `__fallback.json` next to each parent URL directory. The fallback is built
+ * from a real prerendered `__data.json` for that route, with `cms.metadata`
+ * and `cms.docs[pageScope]` cleared and every `params[name]` replaced by
+ * `%name%`. The runtime can fetch the fallback when navigating to a CMS page
+ * that wasn't prerendered, then substitute the actual params client-side.
+ *
+ * @param {StaticAdapterOptions} [options]
+ */
+export default function adapter(options) {
+    const inner = staticAdapter(options);
+    return {
+        name: '@velastack/cms-static',
+        /** @param {import('@sveltejs/kit').Builder} builder */
+        async adapt(builder) {
+            await inner.adapt(builder);
+            const pages = (options && /** @type {any} */ (options).pages) || 'build';
+            const buildDir = path.resolve(pages);
+            // `prerendered.paths` mixes html and data entries, so use the
+            // `pages` map (html only) for sampling.
+            const htmlPaths = [...builder.prerendered.pages.keys()];
+            let written = 0;
+            for (const route of builder.routes) {
+                const fallbackDir = fallbackUrlDirFor(route.id);
+                if (fallbackDir === null)
+                    continue;
+                const sample = findSamplePath(htmlPaths, route.pattern);
+                if (!sample)
+                    continue;
+                const sampleDataFile = path.join(buildDir, sample, '__data.json');
+                if (!fs.existsSync(sampleDataFile))
+                    continue;
+                const target = path.join(buildDir, fallbackDir, '__fallback.json');
+                const json = transformDataJson(fs.readFileSync(sampleDataFile, 'utf-8'));
+                fs.mkdirSync(path.dirname(target), { recursive: true });
+                fs.writeFileSync(target, json);
+                written++;
+                builder.log.minor(`@velastack/cms-static: wrote ${path.relative(buildDir, target)} (from ${sample})`);
+            }
+            if (written > 0) {
+                builder.log.minor(`@velastack/cms-static: wrote ${written} fallback file(s)`);
+            }
+            // Step 2: write `__velastack_manifest` into the SPA fallback. The
+            // admin bar uses this global to enumerate creatable-route entries
+            // when the page it lands on wasn't prerendered (newly created
+            // pages, navigation to routes that didn't exist at build time).
+            // Prerendered pages embed their own data via `__data.json`, so
+            // they don't need the global.
+            const fallbackName = options && /** @type {any} */ (options).fallback;
+            if (!fallbackName)
+                return;
+            const fallbackPath = path.join(buildDir, fallbackName);
+            if (!fs.existsSync(fallbackPath)) {
+                builder.log.warn(`@velastack/cms-static: configured fallback "${fallbackName}" not found at ${fallbackPath}; skipping manifest injection`);
+                return;
+            }
+            const creatableRouteIds = new Set(getPageCmsModules()
+                .filter((m) => m.creatable)
+                .map((m) => m.routeId));
+            if (creatableRouteIds.size === 0)
+                return;
+            /** @type {{ creatable: Record<string, { entries: Record<string, string>[] }> }} */
+            const manifest = { creatable: {} };
+            for (const route of builder.routes) {
+                if (!creatableRouteIds.has(route.id))
+                    continue;
+                const segments = parseRouteSegments(route.id);
+                const extract = buildParamExtractor(segments);
+                if (!extract) {
+                    builder.log.warn(`@velastack/cms-static: route ${route.id} uses an unsupported segment shape (matchers or mixed brackets); skipping in manifest`);
+                    continue;
+                }
+                /** @type {Record<string, string>[]} */
+                const entries = [];
+                for (const urlPath of htmlPaths) {
+                    const params = extract(urlPath);
+                    if (params)
+                        entries.push(params);
+                }
+                if (entries.length === 0)
+                    continue;
+                entries.sort((a, b) => {
+                    const sa = JSON.stringify(a);
+                    const sb = JSON.stringify(b);
+                    return sa < sb ? -1 : sa > sb ? 1 : 0;
+                });
+                manifest.creatable[route.id] = { entries };
+            }
+            if (Object.keys(manifest.creatable).length === 0)
+                return;
+            const fallbackHtml = fs.readFileSync(fallbackPath, 'utf-8');
+            if (fallbackHtml.includes('__velastack_manifest'))
+                return;
+            const headIdx = fallbackHtml.indexOf('</head>');
+            if (headIdx === -1) {
+                builder.log.warn(`@velastack/cms-static: fallback "${fallbackName}" has no </head>; skipping manifest injection`);
+                return;
+            }
+            const json = JSON.stringify(manifest).replace(/</g, '\\u003c');
+            const shim = loadMinifiedShim();
+            const tag = `<script>var __velastack_manifest = ${json};${shim}</script>`;
+            const next = fallbackHtml.slice(0, headIdx) + tag + fallbackHtml.slice(headIdx);
+            fs.writeFileSync(fallbackPath, next);
+            const routeCount = Object.keys(manifest.creatable).length;
+            const entryCount = Object.values(manifest.creatable).reduce((n, v) => n + v.entries.length, 0);
+            builder.log.minor(`@velastack/cms-static: injected __velastack_manifest into ${fallbackName} (${routeCount} route(s), ${entryCount} entry(ies))`);
+        }
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/plugin/dist/adapter.js.map

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

package/plugin/dist/build-state.d.ts

@@ -0,0 +1,10 @@
+export function setPageCmsModules(modules: PageCmsModule[]): void;
+export function getPageCmsModules(): PageCmsModule[];
+/**
+ * Module-level singleton bridging the
+ */
+export type PageCmsModule = {
+    routeId: string;
+    path: string;
+    creatable: boolean;
+};

package/plugin/dist/build-state.js

@@ -0,0 +1,26 @@
+/**
+ * Module-level singleton bridging the @velastack/cms Vite plugin and the
+ * @velastack/cms-static adapter. The plugin populates this during its build
+ * (`load` of `virtual:vela-cms/pages` ⇒ `setPageCmsModules`); the adapter
+ * reads it from `adapt()` to know which routes are creatable without
+ * re-walking `src/routes/` itself.
+ *
+ * Backed by `globalThis` because Vite's plugin context and SvelteKit's
+ * adapter context resolve `./build-state.js` through separate module
+ * caches in the same Node process — ESM-style module-scoped `let` would
+ * leave the adapter looking at a fresh, empty instance. `globalThis` is
+ * the one shared place both sides agree on.
+ *
+ * @typedef {{ routeId: string; path: string; creatable: boolean }} PageCmsModule
+ */
+const KEY = Symbol.for('@velastack/cms.buildState');
+/** @type {{ pageCmsModules: PageCmsModule[] }} */
+// @ts-ignore
+const store = /** @type {any} */ (globalThis[KEY] ??= { pageCmsModules: [] });
+/** @param {PageCmsModule[]} modules */
+export const setPageCmsModules = (modules) => {
+    store.pageCmsModules = modules;
+};
+/** @returns {PageCmsModule[]} */
+export const getPageCmsModules = () => store.pageCmsModules;
+//# sourceMappingURL=build-state.js.map

package/plugin/dist/build-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-state.js","sourceRoot":"","sources":["../src/build-state.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAEpD,kDAAkD;AAClD,aAAa;AACb,MAAM,KAAK,GAAG,kBAAkB,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC;AAE9E,uCAAuC;AACvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,EAAE;IAC5C,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC;AAChC,CAAC,CAAC;AAEF,iCAAiC;AACjC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC"}

package/plugin/dist/fallback-shim.js

@@ -0,0 +1,194 @@
+/**
+ * SPA fallback fetch shim. Inlined into the static adapter's fallback HTML
+ * (e.g. `200.html`) alongside `__velastack_manifest`. Loaded on every page
+ * served by the fallback — keep this minimal.
+ *
+ * Intercepts `*.__data.json` fetches that target a creatable route which
+ * isn't yet prerendered. When the URL also carries a `?preview=...` key,
+ * the shim fetches the matching draft from the CMS endpoint and splices
+ * the doc's tree (including its `metadata` branch) into the route's
+ * `__fallback.json`, returning the merged envelope as the response. All
+ * other fetches —
+ * including non-`__data.json` requests, prerendered entries, and any
+ * navigation without a preview key — fall through to the native fetch.
+ *
+ * IIFE'd, no globals leaked. References `window.__velastack_manifest`,
+ * which the adapter declares earlier in the same `<script>` tag.
+ */
+(function () {
+	var nativeFetch = window.fetch.bind(window);
+	var GROUP_RE = /^\([^)]+\)$/;
+
+	var stripGroups = function (rid) {
+		return rid.split('/').filter(function (x) {
+			return x && !GROUP_RE.test(x);
+		});
+	};
+
+	var matchRoute = function (rid, parts) {
+		var segs = stripGroups(rid);
+		var params = {};
+		var pi = 0;
+		for (var i = 0; i < segs.length; i++) {
+			var s = segs[i];
+			var m;
+			if ((m = /^\[\[(\w+)\]\]$/.exec(s))) {
+				params[m[1]] = pi < parts.length ? parts[pi++] : '';
+			} else if ((m = /^\[\.\.\.(\w+)\]$/.exec(s))) {
+				params[m[1]] = parts.slice(pi).join('/');
+				pi = parts.length;
+			} else if ((m = /^\[(\w+)\]$/.exec(s))) {
+				if (pi >= parts.length) return null;
+				params[m[1]] = parts[pi++];
+			} else if (s.indexOf('[') >= 0) {
+				return null;
+			} else {
+				if (parts[pi] !== s) return null;
+				pi++;
+			}
+		}
+		return pi === parts.length ? params : null;
+	};
+
+	// Append `value` (and recursively its children) to a devalue-flattened
+	// array `arr`, returning the index where the root of `value` was placed.
+	// Handles JSON primitives, plain objects, and arrays — which is the full
+	// shape of CMS docs returned from the `/docs` endpoint. No dedup.
+	var flatten = function (arr, value) {
+		if (value === null || typeof value !== 'object') {
+			return arr.push(value) - 1;
+		}
+		var idx = arr.push(null) - 1;
+		var encoded;
+		if (Array.isArray(value)) {
+			encoded = [];
+			for (var i = 0; i < value.length; i++) encoded.push(flatten(arr, value[i]));
+		} else {
+			encoded = {};
+			for (var k in value) encoded[k] = flatten(arr, value[k]);
+		}
+		arr[idx] = encoded;
+		return idx;
+	};
+
+	window.fetch = async function (input, init) {
+		var url = typeof input === 'string' ? input : input && input.url;
+		var manifest = window.__velastack_manifest;
+		if (!manifest || !url || url.indexOf('__data.json') < 0) {
+			return nativeFetch(input, init);
+		}
+
+		var parsedUrl;
+		try {
+			parsedUrl = new URL(url, location.origin);
+		} catch (e) {
+			return nativeFetch(input, init);
+		}
+
+		var routePath = parsedUrl.pathname.replace(/\/__data\.json$/, '') || '/';
+		var parts = routePath.split('/').filter(Boolean);
+
+		var matchedId = null;
+		var matchedParams = null;
+		for (var rid in manifest.creatable) {
+			var got = matchRoute(rid, parts);
+			if (got) {
+				matchedId = rid;
+				matchedParams = got;
+				break;
+			}
+		}
+		if (!matchedId) return nativeFetch(input, init);
+
+		var entriesKey = JSON.stringify(matchedParams);
+		var entries = manifest.creatable[matchedId].entries;
+		for (var i = 0; i < entries.length; i++) {
+			if (JSON.stringify(entries[i]) === entriesKey) return nativeFetch(input, init);
+		}
+
+		// Edit-mode gate: only intervene when the user is in a release
+		// preview. Without the preview key we can't authenticate against
+		// the CMS endpoint, so a 404 from the static server is the right
+		// outcome.
+		var previewKey = new URLSearchParams(location.search).get('preview');
+		if (!previewKey) return nativeFetch(input, init);
+
+		var earlier = stripGroups(matchedId).slice(0, -1);
+		var fallbackUrl = (earlier.length ? '/' + earlier.join('/') : '') + '/__fallback.json';
+
+		try {
+			var fallbackRes = await nativeFetch(fallbackUrl);
+			if (!fallbackRes.ok) return nativeFetch(input, init);
+			var envelope = await fallbackRes.json();
+			var data = envelope && envelope.nodes && envelope.nodes[0] && envelope.nodes[0].data;
+			if (!Array.isArray(data)) return nativeFetch(input, init);
+
+			var rootObj = data[0];
+			if (!rootObj || typeof rootObj !== 'object') return nativeFetch(input, init);
+			var cmsObj = data[rootObj.cms];
+			if (!cmsObj || typeof cmsObj !== 'object') return nativeFetch(input, init);
+			var endpoint = data[cmsObj.endpoint];
+			if (typeof endpoint !== 'string') return nativeFetch(input, init);
+
+			var qs = new URLSearchParams();
+			qs.set('kind', 'page');
+			qs.set('routeId', matchedId);
+			qs.set('params', JSON.stringify(matchedParams));
+			qs.set('preview', previewKey);
+			var apiRes = await nativeFetch(endpoint + '/docs?' + qs.toString());
+			if (!apiRes.ok) return nativeFetch(input, init);
+			var doc = await apiRes.json();
+			var contents = doc && doc.contents;
+			if (!contents || typeof contents !== 'object') return nativeFetch(input, init);
+
+			// Replace `%name%` placeholders left by the adapter with the
+			// actual URL-bound param values.
+			for (var i2 = 0; i2 < data.length; i2++) {
+				var v = data[i2];
+				if (typeof v !== 'string') continue;
+				var pm = /^%(\w+)%$/.exec(v);
+				if (pm && Object.prototype.hasOwnProperty.call(matchedParams, pm[1])) {
+					data[i2] = matchedParams[pm[1]];
+				}
+			}
+
+			// Splice the page doc's `metadata` branch into `cms.metadata`
+			// (currently `{}` at its index). Branch is just a sub-tree of `contents`.
+			var metaSrc =
+				contents.metadata &&
+				typeof contents.metadata === 'object' &&
+				!Array.isArray(contents.metadata)
+					? contents.metadata
+					: {};
+			var encodedMeta = {};
+			for (var mk in metaSrc) encodedMeta[mk] = flatten(data, metaSrc[mk]);
+			data[cmsObj.metadata] = encodedMeta;
+
+			// Splice the whole `contents` tree into `cms.docs[pageScopeId]`
+			// (also `{}` at its index). The `metadata` branch stays inside
+			// the doc — `cms.metadata` is just an alias.
+			var pageObj = data[cmsObj.page];
+			if (pageObj && typeof pageObj === 'object') {
+				var pageScopeId = data[pageObj.scopeId];
+				var docsObj = data[cmsObj.docs];
+				if (typeof pageScopeId === 'string' && docsObj && typeof docsObj === 'object') {
+					var pageDocIdx = docsObj[pageScopeId];
+					if (typeof pageDocIdx === 'number') {
+						var encodedDoc = {};
+						for (var ck in contents) {
+							encodedDoc[ck] = flatten(data, contents[ck]);
+						}
+						data[pageDocIdx] = encodedDoc;
+					}
+				}
+			}
+
+			return new Response(JSON.stringify(envelope), {
+				status: 200,
+				headers: { 'content-type': 'application/json' }
+			});
+		} catch (e) {
+			return nativeFetch(input, init);
+		}
+	};
+})();

package/plugin/dist/index.d.ts

@@ -0,0 +1,56 @@
+import { type Plugin } from 'vite';
+import { type ExternalCmsComponentSpec } from './manifest.js';
+export type CmsPluginOptions = {
+    /** Defaults to `src/routes` (relative to Vite root). */
+    routesDir?: string;
+    /** Defaults to `src/lib` (relative to Vite root). */
+    libDir?: string;
+    /**
+     * Third-party CMS components beyond the auto-discovered ones in
+     * `<libDir>/components/cms/` and the @velastack/cms package itself.
+     */
+    components?: ExternalCmsComponentSpec[];
+    /**
+     * Bare-specifier sources whose `.svelte` imports the walker should follow.
+     * Strings match `source === pattern || source.startsWith(pattern + '/')`.
+     * Auto-populated with every entry from `components`.
+     */
+    traverse?: (string | RegExp)[];
+    /**
+     * CMS API endpoint, same shape as `apiAdapter`'s. e.g.
+     * `'https://cms.example.com/v1/projects/p1/cms'`. When set, `vite build`
+     * downloads every media file referenced by published content into
+     * `mediaDir`, and `apiAdapter` rewrites URLs in fetched content from
+     * `<origin>/uploads/<file>` (or `/uploads/<file>`) to
+     * `<mediaPrefix>/<file>` so prerendered output references local paths.
+     * Omit (or use `mockAdapter`) to opt out — the build steps become no-ops.
+     */
+    endpoint?: string;
+    /**
+     * BCP-47 locales to walk during media discovery. Mirror this with
+     * `createCms({ locales })`. Defaults to `['en']`.
+     */
+    locales?: string[];
+    /** Local directory (relative to Vite root) to download media into. Defaults to `'static/cms-media'`. */
+    mediaDir?: string;
+    /** URL prefix used in rewritten content. Defaults to `'/cms-media'`. */
+    mediaPrefix?: string;
+};
+/**
+ * Vite plugin that scans SvelteKit route files, walks the static Svelte
+ * import graph from each entrypoint, and exposes a `cmsManifest` constant via
+ * `virtual:vela-cms/manifest`. Auto-injects `setContext(CMS_SCOPE, …)` into
+ * every `+layout.svelte` / `+page.svelte` so authors don't pass scope
+ * manually.
+ *
+ * Auto-discovers CMS components from:
+ *   - `<libDir>/components/cms/*.svelte` (default imports)
+ *   - `<libDir>/components/cms/index.{ts,js}` (every named export)
+ *   - any import resolving inside the @velastack/cms package itself
+ *
+ * Use `components` to declare third-party CMS component packs. Use `traverse`
+ * to walk into wrapper packages whose `.svelte` files contain CMS usages but
+ * aren't themselves CMS components.
+ */
+export declare const cms: (options?: CmsPluginOptions) => Plugin;
+export type { CmsManifest, CmsManifestScope, ExternalCmsComponentSpec } from './manifest.js';