@velastack/cms 0.1.0

package/plugin/dist/manifest.js

@@ -0,0 +1,367 @@
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { dirname, join, resolve, sep } from 'node:path';
+import { parseAstAsync } from 'vite';
+import { parseSvelteFile } from './parse-svelte.js';
+import { ancestorRouteIds, discoverRoutes, extractRouteParams } from './route-tree.js';
+/**
+ * Default page-metadata paths surfaced to the editor when a route has no
+ * explicit schema. Always live under the `metadata` branch.
+ */
+const DEFAULT_PAGE_METADATA_PATHS = [
+    'metadata.title',
+    'metadata.description',
+    'metadata.canonical',
+    'metadata.robots'
+];
+const tryStatFile = (path) => {
+    try {
+        return existsSync(path) && statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * Parse a `page.cms.ts` file and return whether its default export declares
+ * `creatable: true`. Robust against `satisfies`/`as` type assertions and the
+ * `definePage(...)` wrapper form. Returns `false` on parse failure or when
+ * the export is shaped in a way we don't recognize — the static-adapter
+ * post-pass treats `false` as "not in the manifest", which is the safe
+ * default.
+ */
+const parsePageCmsCreatable = async (filePath) => {
+    let source;
+    try {
+        source = readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return false;
+    }
+    let program;
+    try {
+        program = (await parseAstAsync(source, { lang: 'ts' }));
+    }
+    catch {
+        return false;
+    }
+    const defaultExport = program.body.find((n) => n.type === 'ExportDefaultDeclaration');
+    if (!defaultExport)
+        return false;
+    let expr = defaultExport.declaration;
+    for (let i = 0; i < 8 && expr; i++) {
+        if (expr.type === 'TSSatisfiesExpression' ||
+            expr.type === 'TSAsExpression' ||
+            expr.type === 'TSTypeAssertion' ||
+            expr.type === 'ParenthesizedExpression') {
+            expr = expr.expression;
+            continue;
+        }
+        if (expr.type === 'CallExpression' && expr.arguments && expr.arguments.length > 0) {
+            expr = expr.arguments[0];
+            continue;
+        }
+        break;
+    }
+    if (!expr || expr.type !== 'ObjectExpression' || !expr.properties)
+        return false;
+    for (const prop of expr.properties) {
+        if (prop.type !== 'Property')
+            continue;
+        const k = prop.key;
+        const isCreatableKey = (k?.type === 'Identifier' && k.name === 'creatable') ||
+            (k?.type === 'Literal' && k.value === 'creatable');
+        if (!isCreatableKey)
+            continue;
+        if (prop.value?.type === 'Literal' && prop.value.value === true)
+            return true;
+        return false;
+    }
+    return false;
+};
+/**
+ * Synchronous resolver for `$lib/...` and relative specifiers — the in-tree
+ * paths the plugin handles without any bundler context. Returns `null` for
+ * bare specifiers; callers fall through to the external resolver.
+ */
+const resolveLocal = (source, fromFile, libDir) => {
+    let base;
+    if (source.startsWith('$lib/'))
+        base = join(libDir, source.slice(5));
+    else if (source === '$lib')
+        base = libDir;
+    else if (source.startsWith('./') || source.startsWith('../'))
+        base = resolve(dirname(fromFile), source);
+    else
+        return null;
+    const candidates = [
+        base,
+        base.replace(/\.js$/, '.ts'),
+        base + '.svelte',
+        base + '.ts',
+        base + '.js',
+        join(base, 'index.ts'),
+        join(base, 'index.js'),
+        join(base, 'index.svelte')
+    ];
+    for (const c of candidates) {
+        if (tryStatFile(c))
+            return c;
+    }
+    return null;
+};
+const isCmsBarrelPath = (libDir, path) => {
+    const barrel = join(libDir, 'components', 'cms');
+    return path === join(barrel, 'index.ts') || path === join(barrel, 'index.js') || path === barrel;
+};
+const isCmsComponentFile = (libDir, path) => {
+    const dir = join(libDir, 'components', 'cms');
+    const rel = path.slice(dir.length + 1);
+    // Any .svelte file directly under <libDir>/components/cms/ — no allowlist of names.
+    return rel.length > 0 && !rel.includes(sep) && rel.endsWith('.svelte');
+};
+const isInVelacmsPackage = (path, roots) => {
+    for (const root of roots) {
+        const prefix = root.endsWith(sep) ? root : root + sep;
+        if (path === root || path.startsWith(prefix))
+            return true;
+    }
+    return false;
+};
+const matchTraverse = (source, patterns) => {
+    for (const pattern of patterns) {
+        if (typeof pattern === 'string') {
+            if (source === pattern || source.startsWith(pattern + '/'))
+                return true;
+        }
+        else if (pattern.test(source)) {
+            return true;
+        }
+    }
+    return false;
+};
+/**
+ * Try local resolution first, then fall back to the external resolver if the
+ * source matches a `traverse` pattern. Returns `null` when neither succeeds.
+ */
+const resolveOrExternal = async (source, fromFile, libDir, resolveExternal, traversePatterns) => {
+    const local = resolveLocal(source, fromFile, libDir);
+    if (local)
+        return local;
+    if (!resolveExternal)
+        return null;
+    if (!matchTraverse(source, traversePatterns))
+        return null;
+    return resolveExternal(source, fromFile);
+};
+/**
+ * Walk one entrypoint's static import graph (only `.svelte` files), collecting
+ * field names referenced by CMS component usages plus any `routeId=` literals
+ * that `<CmsEntries>`-shaped components carry. Classification iterates three
+ * rule sets per import: in-tree barrel/file, velacms package, then
+ * user-supplied spec map.
+ */
+const collectFieldsForEntry = async (entry, options) => {
+    const { libDir, velacmsRoots, specByResolvedPath, specBySource, traversePatterns, resolveExternal, cache, allVisited } = options;
+    const visited = new Set();
+    const fields = [];
+    const entriesRouteIds = [];
+    const classify = (spec, bindings, cmsLocals) => {
+        if ('default' in spec && spec.default) {
+            for (const b of bindings) {
+                if (b.imported === 'default')
+                    cmsLocals.add(b.local);
+            }
+        }
+        else if ('names' in spec) {
+            const set = new Set(spec.names);
+            for (const b of bindings) {
+                if (b.imported !== 'default' && set.has(b.imported))
+                    cmsLocals.add(b.local);
+            }
+        }
+    };
+    const walk = async (filePath) => {
+        if (visited.has(filePath))
+            return;
+        visited.add(filePath);
+        allVisited.add(filePath);
+        let parsed = cache.get(filePath);
+        if (!parsed) {
+            parsed = parseSvelteFile(filePath);
+            cache.set(filePath, parsed);
+        }
+        const resolvedByImport = new Map();
+        for (let i = 0; i < parsed.imports.length; i++) {
+            const imp = parsed.imports[i];
+            resolvedByImport.set(i, await resolveOrExternal(imp.source, filePath, libDir, resolveExternal, traversePatterns));
+        }
+        const cmsLocals = new Set();
+        for (let i = 0; i < parsed.imports.length; i++) {
+            const imp = parsed.imports[i];
+            const resolved = resolvedByImport.get(i) ?? null;
+            // Rule 1 + 2: in-tree barrel & files under <libDir>/components/cms/.
+            if (resolved && isCmsBarrelPath(libDir, resolved)) {
+                for (const b of imp.bindings) {
+                    if (b.imported !== 'default')
+                        cmsLocals.add(b.local);
+                }
+                continue;
+            }
+            if (resolved && isCmsComponentFile(libDir, resolved)) {
+                for (const b of imp.bindings) {
+                    if (b.imported === 'default')
+                        cmsLocals.add(b.local);
+                }
+                continue;
+            }
+            // Rule 3: any import resolving inside the velacms package itself.
+            if (resolved && velacmsRoots.length > 0 && isInVelacmsPackage(resolved, velacmsRoots)) {
+                for (const b of imp.bindings) {
+                    if (b.imported === 'default') {
+                        if (resolved.endsWith('.svelte'))
+                            cmsLocals.add(b.local);
+                    }
+                    else {
+                        cmsLocals.add(b.local);
+                    }
+                }
+                continue;
+            }
+            // Rule 4: user-supplied spec — match by resolved path first, then raw source.
+            let spec = resolved ? specByResolvedPath.get(resolved) : undefined;
+            if (!spec)
+                spec = specBySource.get(imp.source);
+            if (spec)
+                classify(spec, imp.bindings, cmsLocals);
+        }
+        for (const usage of parsed.componentUsages) {
+            if (!cmsLocals.has(usage.componentName))
+                continue;
+            if (usage.routeIdAttr)
+                entriesRouteIds.push(usage.routeIdAttr);
+            if (usage.hasValueAttr || !usage.fieldName)
+                continue;
+            fields.push(usage.fieldName);
+        }
+        for (let i = 0; i < parsed.imports.length; i++) {
+            const resolved = resolvedByImport.get(i) ?? null;
+            if (resolved && resolved.endsWith('.svelte'))
+                await walk(resolved);
+        }
+    };
+    await walk(entry);
+    return {
+        fields: [...new Set(fields)],
+        entriesRouteIds: [...new Set(entriesRouteIds)]
+    };
+};
+const buildScopeChain = async (leaf, byRouteId, collectOptions) => {
+    const scopes = [];
+    const entriesRouteIds = [];
+    for (const dir of ancestorRouteIds(leaf.routeId)) {
+        const dirNode = byRouteId.get(dir);
+        if (!dirNode?.layoutPath)
+            continue;
+        const collected = await collectFieldsForEntry(dirNode.layoutPath, collectOptions);
+        entriesRouteIds.push(...collected.entriesRouteIds);
+        scopes.push({
+            scopeId: 'layout:' + dir,
+            kind: 'layout',
+            routeId: dir,
+            ownedParams: extractRouteParams(dir),
+            fields: collected.fields
+        });
+    }
+    const pageCollected = await collectFieldsForEntry(leaf.pagePath, collectOptions);
+    entriesRouteIds.push(...pageCollected.entriesRouteIds);
+    const fieldsWithDefaults = Array.from(new Set([...pageCollected.fields, ...DEFAULT_PAGE_METADATA_PATHS]));
+    scopes.push({
+        scopeId: 'page:' + leaf.routeId,
+        kind: 'page',
+        routeId: leaf.routeId,
+        ownedParams: extractRouteParams(leaf.routeId),
+        fields: fieldsWithDefaults
+    });
+    const seen = new Set();
+    for (const scope of scopes) {
+        const owned = scope.ownedParams.filter((p) => !seen.has(p));
+        scope.ownedParams = owned;
+        for (const p of owned)
+            seen.add(p);
+    }
+    return { scopes, entriesRouteIds: [...new Set(entriesRouteIds)] };
+};
+export const buildManifest = async (options) => {
+    const { routesDir, libDir, velacmsRoots = [], components = [], traverse = [], resolveExternal } = options;
+    const nodes = discoverRoutes(routesDir);
+    const byRouteId = new Map(nodes.map((n) => [n.routeId, n]));
+    const cache = new Map();
+    const visitedFiles = new Set();
+    const scopeByEntryPath = new Map();
+    const routeIdByScriptPath = new Map();
+    // Auto-register every `components[].source` for traversal so users don't
+    // have to repeat themselves.
+    const traversePatterns = [...traverse, ...components.map((c) => c.source)];
+    // Pre-resolve user spec sources once. Build two lookup maps: by canonical
+    // resolved path (preferred) and by raw source string (fallback).
+    const specByResolvedPath = new Map();
+    const specBySource = new Map();
+    for (const spec of components) {
+        specBySource.set(spec.source, spec);
+        if (resolveExternal) {
+            const resolved = await resolveExternal(spec.source, undefined);
+            if (resolved)
+                specByResolvedPath.set(resolved, spec);
+        }
+    }
+    const collectOptions = {
+        libDir,
+        velacmsRoots,
+        specByResolvedPath,
+        specBySource,
+        traversePatterns,
+        resolveExternal,
+        cache,
+        allVisited: visitedFiles
+    };
+    const routes = {};
+    const pageCmsModules = [];
+    for (const node of nodes) {
+        if (!node.pagePath)
+            continue;
+        const { scopes, entriesRouteIds } = await buildScopeChain(node, byRouteId, collectOptions);
+        routes[node.routeId] = { scopes, entriesRouteIds };
+        // Index every entry path encountered while walking this leaf's chain so
+        // the transform hook can look up scope info by file path. Layouts may be
+        // indexed multiple times via different leaves — same scope, same entry,
+        // so the writes are idempotent.
+        for (const scope of scopes) {
+            const entryNode = byRouteId.get(scope.routeId);
+            const entryPath = scope.kind === 'layout' ? entryNode?.layoutPath : entryNode?.pagePath;
+            if (!entryPath)
+                continue;
+            scopeByEntryPath.set(entryPath, {
+                scopeId: scope.scopeId,
+                kind: scope.kind,
+                routeId: scope.routeId,
+                ownedParams: scope.ownedParams
+            });
+        }
+        if (node.pageScriptPath)
+            routeIdByScriptPath.set(node.pageScriptPath, node.routeId);
+        if (node.pageServerScriptPath)
+            routeIdByScriptPath.set(node.pageServerScriptPath, node.routeId);
+        if (node.pageCmsPath) {
+            const creatable = await parsePageCmsCreatable(node.pageCmsPath);
+            pageCmsModules.push({ routeId: node.routeId, path: node.pageCmsPath, creatable });
+        }
+    }
+    return {
+        manifest: { version: 1, routes },
+        visitedFiles: [...visitedFiles],
+        scopeByEntryPath,
+        routeIdByScriptPath,
+        pageCmsModules
+    };
+};
+//# sourceMappingURL=manifest.js.map

package/plugin/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,eAAe,EAAqB,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACN,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAElB,MAAM,iBAAiB,CAAC;AAczB;;;GAGG;AACH,MAAM,2BAA2B,GAAa;IAC7C,gBAAgB;IAChB,sBAAsB;IACtB,oBAAoB;IACpB,iBAAiB;CACjB,CAAC;AAmEF,MAAM,WAAW,GAAG,CAAC,IAAY,EAAW,EAAE;IAC7C,IAAI,CAAC;QACJ,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,qBAAqB,GAAG,KAAK,EAAE,QAAgB,EAAoB,EAAE;IAC1E,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACJ,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;IAED,IAAI,OAA4B,CAAC;IACjC,IAAI,CAAC;QACJ,OAAO,GAAG,CAAC,MAAM,aAAa,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAwB,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM,aAAa,GAAI,OAAO,CAAC,IAAgC,CAAC,IAAI,CACnE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,0BAA0B,CACJ,CAAC;IAC1C,IAAI,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IAajC,IAAI,IAAI,GAAG,aAAa,CAAC,WAAsB,CAAC;IAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IACC,IAAI,CAAC,IAAI,KAAK,uBAAuB;YACrC,IAAI,CAAC,IAAI,KAAK,gBAAgB;YAC9B,IAAI,CAAC,IAAI,KAAK,iBAAiB;YAC/B,IAAI,CAAC,IAAI,KAAK,yBAAyB,EACtC,CAAC;YACF,IAAI,GAAG,IAAI,CAAC,UAAqB,CAAC;YAClC,SAAS;QACV,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnF,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACzB,SAAS;QACV,CAAC;QACD,MAAM;IACP,CAAC;IAED,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,IAAI,CAAC,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAEhF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;YAAE,SAAS;QACvC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;QACnB,MAAM,cAAc,GACnB,CAAC,CAAC,EAAE,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;YACpD,CAAC,CAAC,EAAE,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC;QACpD,IAAI,CAAC,cAAc;YAAE,SAAS;QAC9B,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC7E,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,YAAY,GAAG,CAAC,MAAc,EAAE,QAAgB,EAAE,MAAc,EAAiB,EAAE;IACxF,IAAI,IAAY,CAAC;IACjB,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;SAChE,IAAI,MAAM,KAAK,MAAM;QAAE,IAAI,GAAG,MAAM,CAAC;SACrC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;QAC3D,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;;QACtC,OAAO,IAAI,CAAC;IAEjB,MAAM,UAAU,GAAG;QAClB,IAAI;QACJ,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;QAC5B,IAAI,GAAG,SAAS;QAChB,IAAI,GAAG,KAAK;QACZ,IAAI,GAAG,KAAK;QACZ,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;QACtB,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;QACtB,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC;KAC1B,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC5B,IAAI,WAAW,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,MAAc,EAAE,IAAY,EAAW,EAAE;IACjE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IACjD,OAAO,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,IAAI,KAAK,MAAM,CAAC;AAClG,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,MAAc,EAAE,IAAY,EAAW,EAAE;IACpE,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,oFAAoF;IACpF,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACxE,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAE,KAAe,EAAW,EAAE;IACrE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC;QACtD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;IAC3D,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,MAAc,EAAE,QAA6B,EAAW,EAAE;IAChF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YACjC,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,GAAG,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;QACzE,CAAC;aAAM,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,iBAAiB,GAAG,KAAK,EAC9B,MAAc,EACd,QAAgB,EAChB,MAAc,EACd,eAA2C,EAC3C,gBAAqC,EACZ,EAAE;IAC3B,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACrD,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,gBAAgB,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1D,OAAO,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,qBAAqB,GAAG,KAAK,EAClC,KAAa,EACb,OASC,EAC0D,EAAE;IAC7D,MAAM,EACL,MAAM,EACN,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,KAAK,EACL,UAAU,EACV,GAAG,OAAO,CAAC;IAEZ,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,MAAM,QAAQ,GAAG,CAChB,IAA8B,EAC9B,QAAqD,EACrD,SAAsB,EACf,EAAE;QACT,IAAI,SAAS,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBAC1B,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;oBAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACtD,CAAC;QACF,CAAC;aAAM,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBAC1B,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;oBAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAC7E,CAAC;QACF,CAAC;IACF,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,KAAK,EAAE,QAAgB,EAAiB,EAAE;QACtD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO;QAClC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtB,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEzB,IAAI,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;YACnC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7B,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAyB,CAAC;QAC1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC9B,gBAAgB,CAAC,GAAG,CACnB,CAAC,EACD,MAAM,iBAAiB,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,gBAAgB,CAAC,CACxF,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;YAEjD,qEAAqE;YACrE,IAAI,QAAQ,IAAI,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;gBACnD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;oBAC9B,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;wBAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBACtD,CAAC;gBACD,SAAS;YACV,CAAC;YACD,IAAI,QAAQ,IAAI,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;gBACtD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;oBAC9B,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;wBAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBACtD,CAAC;gBACD,SAAS;YACV,CAAC;YAED,kEAAkE;YAClE,IAAI,QAAQ,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,kBAAkB,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,CAAC;gBACvF,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;oBAC9B,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;wBAC9B,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;4BAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;oBAC1D,CAAC;yBAAM,CAAC;wBACP,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;oBACxB,CAAC;gBACF,CAAC;gBACD,SAAS;YACV,CAAC;YAED,8EAA8E;YAC9E,IAAI,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACnE,IAAI,CAAC,IAAI;gBAAE,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC/C,IAAI,IAAI;gBAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACnD,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YAC5C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC;gBAAE,SAAS;YAClD,IAAI,KAAK,CAAC,WAAW;gBAAE,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC/D,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,SAAS;gBAAE,SAAS;YACrD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;YACjD,IAAI,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpE,CAAC;IACF,CAAC,CAAC;IAEF,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO;QACN,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5B,eAAe,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;KAC9C,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,KAAK,EAC5B,IAAe,EACf,SAAiC,EACjC,cAA2D,EACU,EAAE;IACvE,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,KAAK,MAAM,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,UAAU;YAAE,SAAS;QACnC,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QAClF,eAAe,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC;YACX,OAAO,EAAE,SAAS,GAAG,GAAG;YACxB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,GAAG;YACZ,WAAW,EAAE,kBAAkB,CAAC,GAAG,CAAC;YACpC,MAAM,EAAE,SAAS,CAAC,MAAM;SACxB,CAAC,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,QAAkB,EAAE,cAAc,CAAC,CAAC;IAC3F,eAAe,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;IACvD,MAAM,kBAAkB,GAAG,KAAK,CAAC,IAAI,CACpC,IAAI,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,GAAG,2BAA2B,CAAC,CAAC,CAClE,CAAC;IACF,MAAM,CAAC,IAAI,CAAC;QACX,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC,OAAO;QAC/B,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW,EAAE,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC;QAC7C,MAAM,EAAE,kBAAkB;KAC1B,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC;QAC1B,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC;AACnE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EACjC,OAA6B,EACE,EAAE;IACjC,MAAM,EACL,SAAS,EACT,MAAM,EACN,YAAY,GAAG,EAAE,EACjB,UAAU,GAAG,EAAE,EACf,QAAQ,GAAG,EAAE,EACb,eAAe,EACf,GAAG,OAAO,CAAC;IAEZ,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC9C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAqB,CAAC;IACtD,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEtD,yEAAyE;IACzE,6BAA6B;IAC7B,MAAM,gBAAgB,GAAwB,CAAC,GAAG,QAAQ,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAEhG,0EAA0E;IAC1E,iEAAiE;IACjE,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAoC,CAAC;IACvE,MAAM,YAAY,GAAG,IAAI,GAAG,EAAoC,CAAC;IACjE,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC/B,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACpC,IAAI,eAAe,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAC/D,IAAI,QAAQ;gBAAE,kBAAkB,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC;IACF,CAAC;IAED,MAAM,cAAc,GAAgD;QACnE,MAAM;QACN,YAAY;QACZ,kBAAkB;QAClB,YAAY;QACZ,gBAAgB;QAChB,eAAe;QACf,KAAK;QACL,UAAU,EAAE,YAAY;KACxB,CAAC;IAEF,MAAM,MAAM,GAA0B,EAAE,CAAC;IACzC,MAAM,cAAc,GAA0C,EAAE,CAAC;IACjE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,SAAS;QAC7B,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;QAC3F,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;QAEnD,wEAAwE;QACxE,yEAAyE;QACzE,wEAAwE;QACxE,gCAAgC;QAChC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC;YACxF,IAAI,CAAC,SAAS;gBAAE,SAAS;YACzB,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE;gBAC/B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,WAAW,EAAE,KAAK,CAAC,WAAW;aAC9B,CAAC,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,cAAc;YAAE,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACpF,IAAI,IAAI,CAAC,oBAAoB;YAAE,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAChG,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAChE,cAAc,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;QACnF,CAAC;IACF,CAAC;IAED,OAAO;QACN,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE;QAChC,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC;QAC/B,gBAAgB;QAChB,mBAAmB;QACnB,cAAc;KACd,CAAC;AACH,CAAC,CAAC"}

package/plugin/dist/media.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Backend serves uploaded files at the endpoint origin (`/uploads/<filename>`)
+ * via SvelteKit's static handler — confirmed in `cms.velastack/_store.ts`. The
+ * project-scoped CMS endpoint (`/v1/projects/PID/cms`) only governs the API,
+ * not the upload path. So `uploadsBase` is the bare origin + `/uploads`.
+ */
+export declare const deriveUploadsBase: (endpoint: string) => string;
+/**
+ * Walk an arbitrary deserialized JSON value and collect every media filename
+ * referenced as a string — either as a relative `/uploads/<file>` path or an
+ * absolute `<uploadsBase>/<file>` URL. Cycle-safe via a WeakSet.
+ */
+export declare const extractMediaUrls: (value: unknown, uploadsBase: string) => Set<string>;
+/**
+ * Deep-clone `value` and replace every recognized media URL string with
+ * `${mediaPrefix}/<filename>`. Returns the cloned tree; the input is left
+ * untouched. Cycle-safe (cycles are flattened to a fresh object — payloads
+ * passed through `devalue` won't have cycles, but defensive).
+ */
+export declare const rewriteMediaUrls: <T>(value: T, uploadsBase: string, mediaPrefix: string) => T;
+export type DownloadResult = {
+    written: number;
+    skipped: number;
+    failed: Array<{
+        filename: string;
+        reason: string;
+    }>;
+};
+/**
+ * Download every filename in `filenames` from `${uploadsBase}/<filename>` into
+ * `destDir`. Files already on disk are skipped (no etag check — backend
+ * filenames are unique slugs, content is stable per name). Failures are
+ * logged and collected, never thrown — one missing image shouldn't break the
+ * build.
+ */
+export declare const downloadMedia: (filenames: Iterable<string>, uploadsBase: string, destDir: string) => Promise<DownloadResult>;

package/plugin/dist/media.js

@@ -0,0 +1,153 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Backend serves uploaded files at the endpoint origin (`/uploads/<filename>`)
+ * via SvelteKit's static handler — confirmed in `cms.velastack/_store.ts`. The
+ * project-scoped CMS endpoint (`/v1/projects/PID/cms`) only governs the API,
+ * not the upload path. So `uploadsBase` is the bare origin + `/uploads`.
+ */
+export const deriveUploadsBase = (endpoint) => {
+    const url = new URL(endpoint);
+    return `${url.origin}/uploads`;
+};
+const RELATIVE_UPLOADS_RE = /^\/uploads\/([^/?#]+)$/;
+/**
+ * Walk an arbitrary deserialized JSON value and collect every media filename
+ * referenced as a string — either as a relative `/uploads/<file>` path or an
+ * absolute `<uploadsBase>/<file>` URL. Cycle-safe via a WeakSet.
+ */
+export const extractMediaUrls = (value, uploadsBase) => {
+    const out = new Set();
+    const seen = new WeakSet();
+    const prefix = `${uploadsBase}/`;
+    const walk = (v) => {
+        if (typeof v === 'string') {
+            const m = RELATIVE_UPLOADS_RE.exec(v);
+            if (m) {
+                out.add(m[1]);
+                return;
+            }
+            if (v.startsWith(prefix)) {
+                const rest = v.slice(prefix.length).split(/[?#]/)[0];
+                if (rest && !rest.includes('/'))
+                    out.add(rest);
+            }
+            return;
+        }
+        if (!v || typeof v !== 'object')
+            return;
+        if (seen.has(v))
+            return;
+        seen.add(v);
+        if (Array.isArray(v)) {
+            for (const x of v)
+                walk(x);
+            return;
+        }
+        for (const k of Object.keys(v)) {
+            walk(v[k]);
+        }
+    };
+    walk(value);
+    return out;
+};
+/**
+ * Deep-clone `value` and replace every recognized media URL string with
+ * `${mediaPrefix}/<filename>`. Returns the cloned tree; the input is left
+ * untouched. Cycle-safe (cycles are flattened to a fresh object — payloads
+ * passed through `devalue` won't have cycles, but defensive).
+ */
+export const rewriteMediaUrls = (value, uploadsBase, mediaPrefix) => {
+    const seen = new WeakMap();
+    const prefix = `${uploadsBase}/`;
+    const normalizedMediaPrefix = mediaPrefix.replace(/\/$/, '');
+    const walk = (v) => {
+        if (typeof v === 'string') {
+            const m = RELATIVE_UPLOADS_RE.exec(v);
+            if (m)
+                return `${normalizedMediaPrefix}/${m[1]}`;
+            if (v.startsWith(prefix)) {
+                const rest = v.slice(prefix.length).split(/[?#]/)[0];
+                if (rest && !rest.includes('/'))
+                    return `${normalizedMediaPrefix}/${rest}`;
+            }
+            return v;
+        }
+        if (!v || typeof v !== 'object')
+            return v;
+        const cached = seen.get(v);
+        if (cached !== undefined)
+            return cached;
+        if (Array.isArray(v)) {
+            const arr = [];
+            seen.set(v, arr);
+            for (const x of v)
+                arr.push(walk(x));
+            return arr;
+        }
+        const obj = {};
+        seen.set(v, obj);
+        for (const k of Object.keys(v)) {
+            obj[k] = walk(v[k]);
+        }
+        return obj;
+    };
+    return walk(value);
+};
+const fileExists = (p) => {
+    try {
+        fs.accessSync(p, fs.constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const CONCURRENCY = 8;
+/**
+ * Download every filename in `filenames` from `${uploadsBase}/<filename>` into
+ * `destDir`. Files already on disk are skipped (no etag check — backend
+ * filenames are unique slugs, content is stable per name). Failures are
+ * logged and collected, never thrown — one missing image shouldn't break the
+ * build.
+ */
+export const downloadMedia = async (filenames, uploadsBase, destDir) => {
+    const list = [...new Set(filenames)];
+    const result = { written: 0, skipped: 0, failed: [] };
+    if (list.length === 0)
+        return result;
+    fs.mkdirSync(destDir, { recursive: true });
+    let cursor = 0;
+    const workers = [];
+    const next = async () => {
+        while (cursor < list.length) {
+            const filename = list[cursor++];
+            const target = path.join(destDir, filename);
+            if (fileExists(target)) {
+                result.skipped++;
+                continue;
+            }
+            try {
+                const res = await fetch(`${uploadsBase}/${filename}`);
+                if (!res.ok) {
+                    result.failed.push({ filename, reason: `HTTP ${res.status}` });
+                    continue;
+                }
+                const buf = Buffer.from(await res.arrayBuffer());
+                fs.writeFileSync(target, buf);
+                result.written++;
+            }
+            catch (e) {
+                result.failed.push({
+                    filename,
+                    reason: e instanceof Error ? e.message : String(e)
+                });
+            }
+        }
+    };
+    for (let i = 0; i < Math.min(CONCURRENCY, list.length); i++)
+        workers.push(next());
+    await Promise.all(workers);
+    return result;
+};
+//# sourceMappingURL=media.js.map

package/plugin/dist/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAgB,EAAU,EAAE;IAC7D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,OAAO,GAAG,GAAG,CAAC,MAAM,UAAU,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,wBAAwB,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAE,WAAmB,EAAe,EAAE;IACpF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;IACnC,MAAM,MAAM,GAAG,GAAG,WAAW,GAAG,CAAC;IACjC,MAAM,IAAI,GAAG,CAAC,CAAU,EAAQ,EAAE;QACjC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACd,OAAO;YACR,CAAC;YACD,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrD,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChD,CAAC;YACD,OAAO;QACR,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO;QACxC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAW,CAAC;YAAE,OAAO;QAClC,IAAI,CAAC,GAAG,CAAC,CAAW,CAAC,CAAC;QACtB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,KAAK,MAAM,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YAC3B,OAAO;QACR,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAA4B,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAE,CAA6B,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;IACF,CAAC,CAAC;IACF,IAAI,CAAC,KAAK,CAAC,CAAC;IACZ,OAAO,GAAG,CAAC;AACZ,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAI,KAAQ,EAAE,WAAmB,EAAE,WAAmB,EAAK,EAAE;IAC5F,MAAM,IAAI,GAAG,IAAI,OAAO,EAAmB,CAAC;IAC5C,MAAM,MAAM,GAAG,GAAG,WAAW,GAAG,CAAC;IACjC,MAAM,qBAAqB,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,CAAC,CAAU,EAAW,EAAE;QACpC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC;gBAAE,OAAO,GAAG,qBAAqB,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrD,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAAE,OAAO,GAAG,qBAAqB,IAAI,IAAI,EAAE,CAAC;YAC5E,CAAC;YACD,OAAO,CAAC,CAAC;QACV,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAW,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACxC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,MAAM,GAAG,GAAc,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,CAAW,EAAE,GAAG,CAAC,CAAC;YAC3B,KAAK,MAAM,CAAC,IAAI,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACrC,OAAO,GAAG,CAAC;QACZ,CAAC;QACD,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,CAAW,EAAE,GAAG,CAAC,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAA4B,CAAC,EAAE,CAAC;YAC3D,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAE,CAA6B,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC,CAAC;IACF,OAAO,IAAI,CAAC,KAAK,CAAM,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,CAAS,EAAW,EAAE;IACzC,IAAI,CAAC;QACJ,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,CAAC;AAQtB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EACjC,SAA2B,EAC3B,WAAmB,EACnB,OAAe,EACW,EAAE;IAC5B,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IACrC,MAAM,MAAM,GAAmB,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACtE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAErC,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;QACtC,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAChC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC5C,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,SAAS;YACV,CAAC;YACD,IAAI,CAAC;gBACJ,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,WAAW,IAAI,QAAQ,EAAE,CAAC,CAAC;gBACtD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACb,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBAC/D,SAAS;gBACV,CAAC;gBACD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;gBACjD,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAC9B,MAAM,CAAC,OAAO,EAAE,CAAC;YAClB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACZ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;oBAClB,QAAQ;oBACR,MAAM,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;iBAClD,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;IACF,CAAC,CAAC;IACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAClF,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC;AACf,CAAC,CAAC"}

package/plugin/dist/parse-svelte.d.ts

@@ -0,0 +1,35 @@
+export type ParsedImport = {
+    source: string;
+    bindings: Array<{
+        imported: string;
+        local: string;
+    }>;
+};
+export type ComponentUsage = {
+    /** Local binding name as used in the template, e.g. `CmsText` or `Title`. */
+    componentName: string;
+    /** Static value of the `name=` prop, or `null` if absent / non-static. */
+    fieldName: string | null;
+    /** Whether a `value=` prop was present (marks per-item overrides). */
+    hasValueAttr: boolean;
+    /** Static value of the `routeId=` prop, or `null` if absent / non-static. */
+    routeIdAttr: string | null;
+};
+export type InstanceScriptRange = {
+    /** Source offset where the inner script content begins (just after `<script ...>`). */
+    contentStart: number;
+    /** Source offset where the inner script content ends (just before `</script>`). */
+    contentEnd: number;
+};
+export type ParsedSvelte = {
+    /** Static imports declared in `<script>` / `<script context="module">`. */
+    imports: ParsedImport[];
+    /** Every `<Component>` usage in the template (CMS or otherwise). */
+    componentUsages: ComponentUsage[];
+    /** Position of the instance `<script>` block, or `null` if absent. */
+    instanceScript: InstanceScriptRange | null;
+    /** Source length, so callers don't have to keep the raw text around. */
+    sourceLength: number;
+};
+export declare const parseSvelteSource: (code: string, filename?: string) => ParsedSvelte;
+export declare const parseSvelteFile: (filePath: string) => ParsedSvelte;