gazetta 0.5.0 → 0.7.0

package/dist/assets/resolve.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Asset resolution — turn references stored in content JSON into the resolved
+ * shapes templates receive at render time.
+ *
+ * Dispatches by `manifest.kind` (per Q1 lock):
+ *   - embedded → `resolveEmbeddedRef`
+ *   - downloadable → `resolveDownloadableRef`
+ *   - font → `resolveFontRef`
+ *
+ * Locale + theme handled per Q3/Q4 locks:
+ *   - embedded/downloadable: walker reads each variant in the cross-dimension
+ *     chain (most-specific-first) and folds them onto the default with
+ *     `foldLocaleChain` (most-specific-LAST after reversing). Result is one
+ *     effective `Partial<AssetManifest>` passed to the kind resolver.
+ *   - font: walker enumerates every (locale, theme) cell in the site's
+ *     supported universe, reads each variant that exists, and passes the
+ *     full Map<Selector-key, FontLocaleAdditiveManifest> to the font
+ *     resolver. Fonts ADD variants (per Q3 lock); they don't override.
+ *
+ * # Why the walker enumerates the full universe for fonts
+ *
+ * The font resolver returns a union of `@font-face` declarations, each
+ * with its own `unicode-range`. The browser picks per character based on
+ * the active page's content. So at render time we don't know which
+ * locale's font variant will be needed — we expose ALL of them. The
+ * universe is the site's `themes.supported × locales.supported` cells;
+ * the walker tries each one and includes the variants that exist.
+ *
+ * # Graceful degradation
+ *
+ * When a referenced asset can't be resolved (manifest missing, corrupt,
+ * or storage failure), the walker returns a placeholder resolved shape
+ * and logs the error. Pages continue rendering; authors see degraded
+ * output instead of crashed pages (design-media.md → graceful
+ * degradation).
+ */
+import type { ResolvedDownloadableAsset, ResolvedEmbeddedAsset, ResolvedFontAsset } from '../schema/types.js';
+import type { StorageProvider } from '../types.js';
+import { type Selector, selectorsEqual } from '../schema/dimensions.js';
+import type { ResolvedLocales } from '../locale.js';
+import type { ResolvedThemes } from '../themes.js';
+import type { TransformAdapter } from '../transforms/adapter.js';
+/** Context needed to resolve a reference — shared across all refs in a render pass. */
+export interface AssetResolveContext {
+    /** The source target's storage provider (where manifests + bytes live). */
+    storage: StorageProvider;
+    /** Path prefix for assets within the storage root (typically `"assets"`). */
+    assetsRoot: string;
+    /**
+     * Site URL prefix for absolute URLs. When absent, URLs are root-relative.
+     * Used for targets served from a separate origin.
+     */
+    siteUrl?: string;
+    /** Active locale for this render pass. Absent = default-locale render. */
+    locale?: string;
+    /** Active theme for this render pass. Absent = default-theme render. */
+    theme?: string;
+    /**
+     * Resolved site-level locales. Required when `locale` is set; the chain
+     * builder needs the full config (default locale, fallbacks).
+     */
+    locales?: ResolvedLocales | null;
+    /**
+     * Resolved site-level themes. Required when `theme` is set OR for font
+     * resolution (fonts enumerate the supported theme set).
+     */
+    themes?: ResolvedThemes | null;
+    /**
+     * Transform adapter — required, but defaults to `sharpAdapter` when the
+     * caller doesn't supply one. The adapter owns URL composition, srcset
+     * generation, and cache policy. Per-target factory at boot picks the
+     * right adapter per `target.transforms` config.
+     */
+    transformAdapter?: TransformAdapter;
+}
+/** Shape of an embedded-asset reference as stored in content JSON. */
+interface EmbeddedRefShape {
+    _asset: string;
+    alt?: string;
+    focalPoint?: {
+        x: number;
+        y: number;
+    };
+}
+/** Shape of a downloadable-asset reference as stored in content JSON. */
+interface DownloadableRefShape {
+    _asset: string;
+    title?: string;
+    description?: string;
+}
+/** Shape of a font-asset reference as stored in content JSON. */
+interface FontRefShape {
+    _asset: string;
+}
+/**
+ * Resolve a single embedded-asset reference. Caller has already read the
+ * default + per-locale variant and folded the chain into one effective
+ * Partial. We merge that effective override on top of the default for
+ * field-level overrides; bytes-presence (hash on the override) shifts
+ * URL construction to the override's bytes.
+ *
+ * Throws on manifest not-found or corrupt — caller (the walker) catches
+ * and substitutes a placeholder.
+ */
+export declare function resolveEmbeddedRef(ref: EmbeddedRefShape, defaultManifest: import('../schema/types.js').AssetManifest, effectiveOverride: Partial<import('../schema/types.js').AssetManifest> | null, selector: Selector | null, ctx: AssetResolveContext): Promise<ResolvedEmbeddedAsset>;
+/**
+ * Resolve a single downloadable-asset reference. Same locale-merge
+ * semantics as embedded; different resolved shape (no srcset, no
+ * focal-point, has title/description).
+ */
+export declare function resolveDownloadableRef(ref: DownloadableRefShape, defaultManifest: import('../schema/types.js').AssetManifest, effectiveOverride: Partial<import('../schema/types.js').AssetManifest> | null, selector: Selector | null, ctx: AssetResolveContext): Promise<ResolvedDownloadableAsset>;
+/**
+ * Resolve a font-asset reference. Walker has already enumerated every
+ * locale/theme variant that exists; we receive them as a Map. The
+ * resolved shape carries the full union — templates emit one
+ * `@font-face` per variant.
+ *
+ * Today's manifest type doesn't yet carry font-specific fields
+ * (`cssName`, `format`, `weight`, `style`, `unicodeRange`) — those
+ * land when ingest learns to write fonts. Until then, we synthesize
+ * sensible defaults from the asset name and MIME. The shape and
+ * dispatch are correct from day one; the field set fills in
+ * incrementally.
+ */
+/** A font variant paired with the selector that addresses its bytes. */
+export interface FontVariantEntry {
+    selector: Selector;
+    manifest: import('../schema/types.js').FontLocaleAdditiveManifest;
+}
+export declare function resolveFontRef(_ref: FontRefShape, defaultManifest: import('../schema/types.js').AssetManifest, variants: readonly FontVariantEntry[], ctx: AssetResolveContext): Promise<ResolvedFontAsset>;
+/**
+ * Walk a content object and resolve every asset reference found. Returns a
+ * new content object with references swapped for resolved shapes; arrays and
+ * nested objects are recursed into. Non-ref values are copied unchanged.
+ *
+ * Graceful degradation: references that fail to resolve are replaced with a
+ * placeholder. Errors are logged but don't halt rendering.
+ */
+export declare function resolveAssetRefs(content: Record<string, unknown> | undefined, ctx: AssetResolveContext): Promise<Record<string, unknown> | undefined>;
+export { selectorsEqual };
+//# sourceMappingURL=resolve.d.ts.map

package/dist/assets/resolve.d.ts.map

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

package/dist/assets/resolve.js

@@ -0,0 +1,381 @@
+import { buildSelector, selectorsEqual } from '../schema/dimensions.js';
+import { crossDimensionFallbackChain } from '../selector-chain.js';
+import { sharpAdapter } from '../transforms/sharp.js';
+import { AssetManifestCorruptError, AssetManifestNotFoundError } from './errors.js';
+import { foldLocaleChain } from './manifest-merge.js';
+import { readDefaultManifest } from './manifest-default.js';
+import { localeManifestVariantFor } from './manifest-locale.js';
+import { extFromMime } from './url.js';
+// ---------- Per-kind resolvers ----------
+/**
+ * Resolve a single embedded-asset reference. Caller has already read the
+ * default + per-locale variant and folded the chain into one effective
+ * Partial. We merge that effective override on top of the default for
+ * field-level overrides; bytes-presence (hash on the override) shifts
+ * URL construction to the override's bytes.
+ *
+ * Throws on manifest not-found or corrupt — caller (the walker) catches
+ * and substitutes a placeholder.
+ */
+export async function resolveEmbeddedRef(ref, defaultManifest, effectiveOverride, selector, ctx) {
+    // Bytes source: when the effective override has a hash, the locale
+    // has its own bytes — URL points at the locale-bytes path. Otherwise
+    // URL points at the default bytes.
+    const overrideHasBytes = effectiveOverride !== null && typeof effectiveOverride.hash === 'string';
+    const bytesSource = overrideHasBytes ? effectiveOverride : defaultManifest;
+    const bytesSelector = overrideHasBytes ? selector : null;
+    // The merged manifest is "default with override fields applied" for
+    // field reads (alt, width, height, variants, mime). Override-wins on
+    // any non-undefined field.
+    const merged = {
+        ...defaultManifest,
+        ...(effectiveOverride ?? {}),
+    };
+    const ext = extFromMime(merged.mime);
+    if (!ext) {
+        throw new AssetManifestCorruptError(`${ctx.assetsRoot}/${defaultManifest.name}.asset.json`, new Error(`No extension known for MIME ${merged.mime}`));
+    }
+    const adapter = ctx.transformAdapter ?? sharpAdapter;
+    const adapterInput = {
+        name: defaultManifest.name,
+        hash: bytesSource.hash,
+        ext,
+        selector: bytesSelector,
+        siteUrl: ctx.siteUrl,
+        variants: (bytesSource.variants ?? []),
+        width: merged.width,
+        height: merged.height,
+    };
+    const url = adapter.primaryUrl(adapterInput);
+    const srcset = adapter.srcset(adapterInput);
+    // Per-ref override > merged manifest's alt > '' (decorative).
+    const alt = ref.alt ?? merged.alt ?? '';
+    return {
+        url,
+        srcset,
+        width: merged.width,
+        height: merged.height,
+        duration: null,
+        animated: false,
+        poster: null,
+        alt,
+        focalPoint: ref.focalPoint ?? null,
+        mime: merged.mime,
+    };
+}
+/**
+ * Resolve a single downloadable-asset reference. Same locale-merge
+ * semantics as embedded; different resolved shape (no srcset, no
+ * focal-point, has title/description).
+ */
+export async function resolveDownloadableRef(ref, defaultManifest, effectiveOverride, selector, ctx) {
+    const overrideHasBytes = effectiveOverride !== null && typeof effectiveOverride.hash === 'string';
+    const bytesSource = overrideHasBytes ? effectiveOverride : defaultManifest;
+    const bytesSelector = overrideHasBytes ? selector : null;
+    const merged = {
+        ...defaultManifest,
+        ...(effectiveOverride ?? {}),
+    };
+    const ext = extFromMime(merged.mime);
+    if (!ext) {
+        throw new AssetManifestCorruptError(`${ctx.assetsRoot}/${defaultManifest.name}.asset.json`, new Error(`No extension known for MIME ${merged.mime}`));
+    }
+    const adapter = ctx.transformAdapter ?? sharpAdapter;
+    const url = adapter.primaryUrl({
+        name: defaultManifest.name,
+        hash: bytesSource.hash,
+        ext,
+        selector: bytesSelector,
+        siteUrl: ctx.siteUrl,
+        variants: [], // downloadable assets don't have a srcset ladder
+        width: null,
+        height: null,
+    });
+    // Title fallback chain: per-ref → merged manifest title → asset name.
+    // (Today's manifest type doesn't carry `title`; step 24/post-v1 will
+    // add it. Until then, the asset name is the human-readable fallback.)
+    const title = ref.title ?? merged.title ?? defaultManifest.name;
+    const description = ref.description ?? merged.description ?? null;
+    return {
+        url,
+        title,
+        description,
+        size: merged.size ?? null,
+        mime: merged.mime,
+    };
+}
+export async function resolveFontRef(_ref, defaultManifest, variants, ctx) {
+    const ext = extFromMime(defaultManifest.mime);
+    if (!ext) {
+        throw new AssetManifestCorruptError(`${ctx.assetsRoot}/${defaultManifest.name}.asset.json`, new Error(`No extension known for MIME ${defaultManifest.mime}`));
+    }
+    // CSS family name: stable per asset (Gazetta-owned identifier per
+    // design-media.md). Today's manifest doesn't carry `cssName`, so
+    // derive from the asset name.
+    const cssName = defaultManifest.name;
+    const adapter = ctx.transformAdapter ?? sharpAdapter;
+    // Default variant is always present in the union — every font has
+    // its default file.
+    const resolved = [
+        {
+            url: adapter.primaryUrl({
+                name: defaultManifest.name,
+                hash: defaultManifest.hash,
+                ext,
+                selector: null,
+                siteUrl: ctx.siteUrl,
+                variants: [],
+                width: null,
+                height: null,
+            }),
+            format: deriveFontFormat(ext),
+            weight: 400,
+            style: 'normal',
+            unicodeRange: null,
+            mime: defaultManifest.mime,
+        },
+    ];
+    // Add each locale/theme variant. URL embeds the variant's selector so
+    // the bytes file for that variant resolves correctly.
+    for (const { selector, manifest: variant } of variants) {
+        const variantExt = extFromMime(variant.mime) ?? ext;
+        resolved.push({
+            url: adapter.primaryUrl({
+                name: defaultManifest.name,
+                hash: variant.hash,
+                ext: variantExt,
+                selector,
+                siteUrl: ctx.siteUrl,
+                variants: [],
+                width: null,
+                height: null,
+            }),
+            format: variant.format,
+            weight: variant.weight,
+            style: variant.style,
+            unicodeRange: variant.unicodeRange,
+            mime: variant.mime,
+        });
+    }
+    return {
+        cssName,
+        variants: resolved,
+    };
+}
+function deriveFontFormat(ext) {
+    switch (ext) {
+        case 'woff2':
+            return 'woff2';
+        case 'woff':
+            return 'woff';
+        case 'ttf':
+            return 'ttf';
+        case 'otf':
+            return 'otf';
+        default:
+            return 'woff2';
+    }
+}
+// ---------- Walker ----------
+/** Placeholder returned when a reference can't be resolved. */
+const EMBEDDED_PLACEHOLDER = {
+    url: '/assets/__missing__.svg',
+    srcset: null,
+    width: null,
+    height: null,
+    duration: null,
+    animated: false,
+    poster: null,
+    alt: '',
+    focalPoint: null,
+    mime: 'image/svg+xml',
+};
+const DOWNLOADABLE_PLACEHOLDER = {
+    url: '/assets/__missing__',
+    title: '(missing asset)',
+    description: null,
+    size: null,
+    mime: 'application/octet-stream',
+};
+const FONT_PLACEHOLDER = {
+    cssName: '__missing__',
+    variants: [],
+};
+/** Structural check — is this value an asset reference (any kind)? */
+function isAssetRef(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const v = value;
+    return typeof v._asset === 'string';
+}
+/**
+ * Walk a content object and resolve every asset reference found. Returns a
+ * new content object with references swapped for resolved shapes; arrays and
+ * nested objects are recursed into. Non-ref values are copied unchanged.
+ *
+ * Graceful degradation: references that fail to resolve are replaced with a
+ * placeholder. Errors are logged but don't halt rendering.
+ */
+export async function resolveAssetRefs(content, ctx) {
+    if (!content)
+        return content;
+    return (await walk(content, ctx));
+}
+async function walk(value, ctx) {
+    if (isAssetRef(value)) {
+        try {
+            return await resolveOne(value, ctx);
+        }
+        catch (err) {
+            if (err instanceof AssetManifestNotFoundError || err instanceof AssetManifestCorruptError) {
+                // eslint-disable-next-line no-console
+                console.warn(`[asset-resolver] ${err.message}`);
+                // Return the most generic placeholder — the walker can't know
+                // the kind without successfully reading the manifest. Embedded's
+                // placeholder shape carries the most fields, so it satisfies any
+                // template that conditionally checks fields like `srcset`.
+                return EMBEDDED_PLACEHOLDER;
+            }
+            throw err;
+        }
+    }
+    if (Array.isArray(value)) {
+        return Promise.all(value.map(item => walk(item, ctx)));
+    }
+    if (value && typeof value === 'object') {
+        const result = {};
+        for (const [key, v] of Object.entries(value)) {
+            result[key] = await walk(v, ctx);
+        }
+        return result;
+    }
+    return value;
+}
+/**
+ * Resolve one asset reference. Reads default first to discover kind,
+ * then dispatches to the kind-specific path with appropriate locale/
+ * theme handling.
+ */
+async function resolveOne(ref, ctx) {
+    const defaultManifest = await readDefaultManifest(ctx.storage, ctx.assetsRoot, ref._asset);
+    switch (defaultManifest.kind) {
+        case 'font': {
+            const variants = await readAllFontVariants(defaultManifest.name, ctx);
+            return resolveFontRef(ref, defaultManifest, variants, ctx);
+        }
+        case 'downloadable': {
+            const { effective, selector } = await readEffectiveLocaleOverride(defaultManifest.name, 'downloadable', ctx);
+            return resolveDownloadableRef(ref, defaultManifest, effective, selector, ctx);
+        }
+        case 'embedded':
+        default: {
+            const { effective, selector } = await readEffectiveLocaleOverride(defaultManifest.name, 'embedded', ctx);
+            return resolveEmbeddedRef(ref, defaultManifest, effective, selector, ctx);
+        }
+    }
+}
+/**
+ * Read the cross-dimension fallback chain for an asset's name + kind,
+ * fold the per-field overrides onto a fresh base, and return the
+ * effective override along with the selector that produced bytes (if
+ * any).
+ *
+ * Returns:
+ *   - effective: Partial<AssetManifest> — undefined-shaped fields show
+ *     "no override"; defined fields show "this locale wins."
+ *   - selector: the most-specific selector that contributed bytes (i.e.
+ *     had a `hash`); null if no override has bytes.
+ */
+async function readEffectiveLocaleOverride(name, kind, ctx) {
+    const chain = crossDimensionFallbackChain({
+        locale: ctx.locale,
+        theme: ctx.theme,
+        locales: ctx.locales ?? null,
+        themes: ctx.themes ?? null,
+    });
+    if (chain.length === 0) {
+        return { effective: null, selector: null };
+    }
+    // Read each variant in the chain. `crossDimensionFallbackChain` returns
+    // most-specific-FIRST. `foldLocaleChain` expects most-specific-LAST,
+    // so we reverse before fold (and pick the first hash-carrying entry,
+    // also walking most-specific-first, for the bytes selector).
+    const variant = localeManifestVariantFor(kind);
+    const overrides = [];
+    for (const sel of chain) {
+        const manifest = (await variant.read(ctx.storage, ctx.assetsRoot, name, sel));
+        overrides.push({ selector: sel, manifest });
+    }
+    // Pick the bytes selector — first override (most-specific) with a hash.
+    let bytesSelector = null;
+    for (const o of overrides) {
+        if (o.manifest && typeof o.manifest.hash === 'string') {
+            bytesSelector = o.selector;
+            break;
+        }
+    }
+    // Fold: reverse so least-specific applies first; most-specific overwrites.
+    const reversed = overrides
+        .slice()
+        .reverse()
+        .map(o => o.manifest);
+    const effective = foldLocaleChain({}, reversed);
+    return { effective: Object.keys(effective).length > 0 ? effective : null, selector: bytesSelector };
+}
+/**
+ * Read every locale/theme font variant that exists. Walker enumerates
+ * the site's `themes.supported × locales.supported` cells (excluding
+ * the all-default cell, which is the default manifest read separately)
+ * and collects the variants returned non-null.
+ *
+ * Returns a Map keyed by selector identity (built from JSON.stringify
+ * of the selector entries) for downstream iteration. Today's caller
+ * just iterates the values — the key is for de-duplication only.
+ */
+async function readAllFontVariants(name, ctx) {
+    const out = [];
+    const variant = localeManifestVariantFor('font');
+    // Universe = configured (locale, theme) cells. Default-locale +
+    // default-theme is excluded — that's the default manifest, read
+    // separately. When neither dimension is configured, there are no
+    // variants to look up.
+    const localeCells = ctx.locales?.supported ?? [];
+    const themeCells = ctx.themes?.supported ?? [];
+    const candidates = [];
+    for (const loc of localeCells) {
+        if (loc === ctx.locales?.default)
+            continue;
+        const sel = buildSelector({ locale: loc });
+        if (sel)
+            candidates.push(sel);
+    }
+    for (const th of themeCells) {
+        if (th === ctx.themes?.default)
+            continue;
+        const sel = buildSelector({ theme: th });
+        if (sel)
+            candidates.push(sel);
+    }
+    for (const loc of localeCells) {
+        if (loc === ctx.locales?.default)
+            continue;
+        for (const th of themeCells) {
+            if (th === ctx.themes?.default)
+                continue;
+            const sel = buildSelector({ locale: loc, theme: th });
+            if (sel)
+                candidates.push(sel);
+        }
+    }
+    for (const sel of candidates) {
+        const m = await variant.read(ctx.storage, ctx.assetsRoot, name, sel);
+        if (m) {
+            out.push({ selector: sel, manifest: m });
+        }
+    }
+    return out;
+}
+// Re-export so external callers continue to import `selectorsEqual`-style
+// helpers from this module if needed for tests. Pure pass-through.
+export { selectorsEqual };
+//# sourceMappingURL=resolve.js.map

package/dist/assets/resolve.js.map

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

package/dist/assets/rewrite-manifest-asset-ref.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Rewrite every reference to an asset inside one manifest, returning a
+ * new deeply-cloned manifest with the refs updated. Pure (no I/O); the
+ * caller decides what to do with the result.
+ *
+ * Two consumers:
+ *   - `replace.ts` — the orchestrator for "replace asset A with asset B
+ *     across the whole site" uses this to transform each referencing
+ *     manifest before writing it back.
+ *   - Future rename operation — same semantic (rewrite asset-name refs),
+ *     just different caller intent.
+ *
+ * Pairs with `scan-manifest-for-asset.ts`: scan emits locations where
+ * refs live; rewrite produces a new manifest with those locations
+ * updated. Keeping them separate modules is deliberate SRP — scanning
+ * is read-only, rewriting mutates (a copy of) the tree.
+ *
+ * Per-reference override semantics:
+ *   When we rewrite `{ _asset: "hero", alt: "..." }` → target `banner`,
+ *   we preserve the override fields (`alt`, `focalPoint`, etc.). The
+ *   author's per-reference override is authored-intent, not asset-intent;
+ *   it stays when the underlying asset changes. Design-media.md: "Preserve
+ *   per-reference overrides when the author re-picks."
+ */
+import type { ComponentManifest } from '../types.js';
+export interface RewriteInput {
+    readonly manifest: ComponentManifest;
+    readonly fromAssetName: string;
+    readonly toAssetName: string;
+}
+export interface RewriteResult {
+    /** The new manifest with refs rewritten. Structurally cloned, so
+     *  callers can freely mutate or serialize without affecting the input. */
+    readonly manifest: ComponentManifest;
+    /** How many `{ _asset: fromAssetName }` references were rewritten.
+     *  Zero is a valid result (manifest didn't reference the asset). */
+    readonly rewriteCount: number;
+}
+/**
+ * Rewrite every `{ _asset: fromAssetName }` ref in `manifest` to point
+ * at `toAssetName` instead. Returns a deep clone — input is untouched.
+ */
+export declare function rewriteManifestAssetRef(input: RewriteInput): RewriteResult;
+//# sourceMappingURL=rewrite-manifest-asset-ref.d.ts.map

package/dist/assets/rewrite-manifest-asset-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrite-manifest-asset-ref.d.ts","sourceRoot":"","sources":["../../src/assets/rewrite-manifest-asset-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B;8EAC0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IACpC;wEACoE;IACpE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CAQ1E"}

package/dist/assets/rewrite-manifest-asset-ref.js

@@ -0,0 +1,51 @@
+/**
+ * Rewrite every `{ _asset: fromAssetName }` ref in `manifest` to point
+ * at `toAssetName` instead. Returns a deep clone — input is untouched.
+ */
+export function rewriteManifestAssetRef(input) {
+    // Deep clone so the walker can mutate freely. JSON round-trip is safe
+    // for manifests — they're JSON already (content is Record<string,
+    // unknown> with JSON-serializable values per the schema).
+    const cloned = JSON.parse(JSON.stringify(input.manifest));
+    const counter = { n: 0 };
+    walkComponent(cloned, input.fromAssetName, input.toAssetName, counter);
+    return { manifest: cloned, rewriteCount: counter.n };
+}
+/** Walk a component (page/fragment manifest or inline child). */
+function walkComponent(comp, from, to, counter) {
+    if (comp.content)
+        rewriteValue(comp.content, from, to, counter);
+    if (comp.components) {
+        for (const child of comp.components) {
+            if (typeof child === 'string')
+                continue;
+            walkComponent(child, from, to, counter);
+        }
+    }
+}
+/**
+ * Recursively walk a value looking for `{ _asset: from, ... }` objects.
+ * When found, update `_asset` to `to` and count. Does NOT early-return —
+ * a ref object can itself contain nested refs (e.g. a future composite
+ * template puts one asset ref inside another's override fields).
+ */
+function rewriteValue(value, from, to, counter) {
+    if (value === null || typeof value !== 'object')
+        return;
+    if (Array.isArray(value)) {
+        for (const item of value)
+            rewriteValue(item, from, to, counter);
+        return;
+    }
+    const obj = value;
+    if (typeof obj._asset === 'string' && obj._asset === from) {
+        obj._asset = to;
+        counter.n++;
+    }
+    for (const [key, child] of Object.entries(obj)) {
+        if (key === '_asset')
+            continue;
+        rewriteValue(child, from, to, counter);
+    }
+}
+//# sourceMappingURL=rewrite-manifest-asset-ref.js.map

package/dist/assets/rewrite-manifest-asset-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrite-manifest-asset-ref.js","sourceRoot":"","sources":["../../src/assets/rewrite-manifest-asset-ref.ts"],"names":[],"mappings":"AAyCA;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAmB;IACzD,sEAAsE;IACtE,kEAAkE;IAClE,0DAA0D;IAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAsB,CAAA;IAC9E,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;IACxB,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,EAAE,CAAA;AACtD,CAAC;AAED,iEAAiE;AACjE,SAAS,aAAa,CACpB,IAAyF,EACzF,IAAY,EACZ,EAAU,EACV,OAAsB;IAEtB,IAAI,IAAI,CAAC,OAAO;QAAE,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;IAC/D,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,SAAQ;YACvC,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;QACzC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,KAAc,EAAE,IAAY,EAAE,EAAU,EAAE,OAAsB;IACpF,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAM;IAEvD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;QAC/D,OAAM;IACR,CAAC;IAED,MAAM,GAAG,GAAG,KAAgC,CAAA;IAC5C,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC1D,GAAG,CAAC,MAAM,GAAG,EAAE,CAAA;QACf,OAAO,CAAC,CAAC,EAAE,CAAA;IACb,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,GAAG,KAAK,QAAQ;YAAE,SAAQ;QAC9B,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;IACxC,CAAC;AACH,CAAC"}