gazetta 0.4.0 → 0.5.0

package/dist/compare.js

@@ -1,6 +1,8 @@
+import { join } from 'node:path';
 import { loadSite } from './site-loader.js';
-import { hashManifest, parseSidecarName } from './hash.js';
+import { hashManifest } from './hash.js';
 import { scanTemplates, templateHashesFrom } from './templates-scan.js';
+import { listSidecars } from './sidecars.js';
 /**
  * Compare local source state against a published target.
  *
@@ -13,30 +15,56 @@ import { scanTemplates, templateHashesFrom } from './templates-scan.js';
  */
 export async function compareTargets(opts) {
     // 1. Validate + hash templates
-    const templateInfos = await scanTemplates(opts.templatesDir, opts.projectRoot);
+    const scan = opts.scanTemplates ?? scanTemplates;
+    const templateInfos = await scan(opts.templatesDir, opts.projectRoot);
     const invalidTemplates = templateInfos.filter(t => !t.valid)
         .map(t => ({ name: t.name, errors: t.errors }));
     const templateHashes = templateHashesFrom(templateInfos);
-    // 2. Load local site, compute manifest hashes
+    // 2. Load local site, compute manifest hashes.
+    // Source-side sidecars (written on save) let us skip re-hashing for items
+    // whose manifest + templates haven't changed since the last save. Fall
+    // back to hashManifest for items without a source sidecar.
     const site = await loadSite({ siteDir: opts.siteDir, storage: opts.source, templatesDir: opts.templatesDir });
+    const [sourcePagesSidecars, sourceFragmentsSidecars] = await Promise.all([
+        listSidecars(opts.source, join(opts.siteDir, 'pages')),
+        listSidecars(opts.source, join(opts.siteDir, 'fragments')),
+    ]);
+    // Hash fragments first (they don't depend on page hashes). Static-mode
+    // page hashes include fragment hashes so a fragment content change
+    // invalidates every page that bakes it in.
+    const fragmentHashes = new Map();
+    for (const [name, frag] of site.fragments) {
+        const cached = sourceFragmentsSidecars.get(name)?.hash;
+        fragmentHashes.set(name, cached ?? hashManifest(frag, { templateHashes }));
+    }
     const local = new Map();
+    const pageHashOpts = opts.publishMode === 'static'
+        ? { templateHashes, fragmentHashes }
+        : { templateHashes };
     for (const [name, page] of site.pages) {
-        local.set(`pages/${name}`, hashManifest(page, { templateHashes }));
+        // Source sidecars are written without fragmentHashes (source doesn't
+        // know target's publish mode). For static targets we must re-hash.
+        const cached = opts.publishMode === 'static' ? null : sourcePagesSidecars.get(name)?.hash;
+        local.set(`pages/${name}`, cached ?? hashManifest(page, pageHashOpts));
     }
     // Static-mode targets bake fragments into pages — no fragment sidecars exist
     // on the target, and publishing @header/@footer is a no-op server-side. Omit
     // them from local so they don't appear as perpetually "added".
     if (opts.publishMode !== 'static') {
-        for (const [name, frag] of site.fragments) {
-            local.set(`fragments/${name}`, hashManifest(frag, { templateHashes }));
+        for (const [name, hash] of fragmentHashes) {
+            local.set(`fragments/${name}`, hash);
         }
     }
-    // 3. List target sidecars
+    // 3. List target sidecars — one pass per root, parallel inside.
     const target = new Map();
-    await collectSidecars(opts.target, 'pages', target);
-    if (opts.publishMode !== 'static') {
-        await collectSidecars(opts.target, 'fragments', target);
-    }
+    const [pagesSidecars, fragmentsSidecars] = await Promise.all([
+        listSidecars(opts.target, 'pages'),
+        opts.publishMode !== 'static' ? listSidecars(opts.target, 'fragments') : Promise.resolve(new Map()),
+    ]);
+    for (const [k, s] of pagesSidecars)
+        target.set(`pages/${k}`, s.hash);
+    for (const [k, s] of fragmentsSidecars)
+        target.set(`fragments/${k}`, s.hash);
     // 4. Diff
     const result = {
         added: [],
@@ -61,33 +89,4 @@ export async function compareTargets(opts) {
     }
     return result;
 }
-/**
- * Walk `pages/` or `fragments/` looking for `.{8hex}.hash` sidecar files.
- * Records `pages/home` → `abc12345` for each found.
- */
-async function collectSidecars(storage, rootDir, out, prefix = rootDir) {
-    let entries;
-    try {
-        entries = await storage.readDir(rootDir);
-    }
-    catch {
-        return;
-    }
-    let foundSidecar = null;
-    for (const e of entries) {
-        if (!e.isDirectory) {
-            const hash = parseSidecarName(e.name);
-            if (hash)
-                foundSidecar = hash;
-        }
-    }
-    if (foundSidecar) {
-        out.set(prefix, foundSidecar);
-    }
-    for (const e of entries) {
-        if (e.isDirectory) {
-            await collectSidecars(storage, `${rootDir}/${e.name}`, out, `${prefix}/${e.name}`);
-        }
-    }
-}
 //# sourceMappingURL=compare.js.map

package/dist/compare.js.map

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

package/dist/concurrency.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Bounded-concurrency helpers. Use these instead of `Promise.all` when the
+ * input list can be large (site walks, sidecar listings, per-item publish
+ * renders). Unbounded Promise.all hits three real limits at 10k items:
+ *
+ *   1. File-descriptor limits (macOS 256, Linux 1024) → EMFILE
+ *   2. Cloud-storage rate limits (S3 3500 PUT/s, R2 Class A throttles)
+ *   3. Memory — thousands of live promise chains + closures
+ *
+ * Default concurrency 20 balances throughput against those limits for both
+ * local filesystem and cloud storage. Tune per-call via the second arg.
+ */
+export declare const DEFAULT_CONCURRENCY = 20;
+/**
+ * Memoize a zero-arg async function until invalidate() is called. Concurrent
+ * callers share a single in-flight promise (no thundering herd on cold
+ * start). A failed call is NOT cached — the next call retries.
+ *
+ * Typical shape: a server owns the cache and exposes invalidate() to its
+ * file watcher. Keeps the underlying scanner pure — no module-level state,
+ * no surprise caching semantics when called from tests or the CLI.
+ */
+export interface Memoized<T> {
+    get(): Promise<T>;
+    invalidate(): void;
+}
+export declare function memoizeAsync<T>(fn: () => Promise<T>): Memoized<T>;
+/**
+ * Run `fn` on every item with at most `limit` in flight at once. Results
+ * are returned in input order. Errors reject immediately (like Promise.all)
+ * but in-flight work still completes in the background.
+ *
+ * Preserves order even though completion order varies.
+ */
+export declare function mapLimit<T, U>(items: readonly T[], fn: (item: T, index: number) => Promise<U>, limit?: number): Promise<U[]>;
+/**
+ * Run `fn` on every item with at most `limit` in flight, yielding each
+ * result as it completes — in completion order, not input order. Use when
+ * the caller wants to react to each completion as it happens (e.g. emit
+ * a progress event mid-stream). For collect-all-then-return semantics,
+ * mapLimit is simpler.
+ *
+ * Each yield includes the original `index` so the consumer can reconstruct
+ * input order if needed.
+ */
+export declare function mapLimitStream<T, U>(items: readonly T[], fn: (item: T, index: number) => Promise<U>, limit?: number): AsyncGenerator<{
+    item: T;
+    result: U;
+    index: number;
+}>;
+/**
+ * Like mapLimit but doesn't throw on individual failures — returns a parallel
+ * array of { ok: true, value } or { ok: false, error } per input. Useful
+ * when a single bad manifest shouldn't abort a whole site walk.
+ */
+export declare function mapLimitSettled<T, U>(items: readonly T[], fn: (item: T, index: number) => Promise<U>, limit?: number): Promise<Array<{
+    ok: true;
+    value: U;
+} | {
+    ok: false;
+    error: unknown;
+}>>;
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../src/concurrency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,CAAA;IACjB,UAAU,IAAI,IAAI,CAAA;CACnB;AACD,wBAAgB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CA0BjE;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,CAAC,EACjC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,KAAK,SAAsB,GAC1B,OAAO,CAAC,CAAC,EAAE,CAAC,CAqBd;AAED;;;;;;;;;GASG;AACH,wBAAuB,cAAc,CAAC,CAAC,EAAE,CAAC,EACxC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,KAAK,SAAsB,GAC1B,cAAc,CAAC;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BvD;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,CAAC,EACxC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,KAAK,SAAsB,GAC1B,OAAO,CAAC,KAAK,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CAmBxE"}

package/dist/concurrency.js

@@ -0,0 +1,134 @@
+/**
+ * Bounded-concurrency helpers. Use these instead of `Promise.all` when the
+ * input list can be large (site walks, sidecar listings, per-item publish
+ * renders). Unbounded Promise.all hits three real limits at 10k items:
+ *
+ *   1. File-descriptor limits (macOS 256, Linux 1024) → EMFILE
+ *   2. Cloud-storage rate limits (S3 3500 PUT/s, R2 Class A throttles)
+ *   3. Memory — thousands of live promise chains + closures
+ *
+ * Default concurrency 20 balances throughput against those limits for both
+ * local filesystem and cloud storage. Tune per-call via the second arg.
+ */
+export const DEFAULT_CONCURRENCY = 20;
+export function memoizeAsync(fn) {
+    let pending = null;
+    let result = null;
+    let hasResult = false;
+    return {
+        async get() {
+            if (hasResult)
+                return result;
+            if (pending)
+                return pending;
+            pending = (async () => {
+                try {
+                    const v = await fn();
+                    result = v;
+                    hasResult = true;
+                    return v;
+                }
+                finally {
+                    pending = null;
+                }
+            })();
+            return pending;
+        },
+        invalidate() {
+            hasResult = false;
+            result = null;
+            pending = null;
+        },
+    };
+}
+/**
+ * Run `fn` on every item with at most `limit` in flight at once. Results
+ * are returned in input order. Errors reject immediately (like Promise.all)
+ * but in-flight work still completes in the background.
+ *
+ * Preserves order even though completion order varies.
+ */
+export async function mapLimit(items, fn, limit = DEFAULT_CONCURRENCY) {
+    const results = new Array(items.length);
+    let cursor = 0;
+    let firstError = null;
+    async function worker() {
+        while (cursor < items.length && firstError === null) {
+            const i = cursor++;
+            try {
+                results[i] = await fn(items[i], i);
+            }
+            catch (err) {
+                if (firstError === null)
+                    firstError = err;
+                return;
+            }
+        }
+    }
+    const workerCount = Math.min(limit, items.length);
+    await Promise.all(Array.from({ length: workerCount }, worker));
+    if (firstError !== null)
+        throw firstError;
+    return results;
+}
+/**
+ * Run `fn` on every item with at most `limit` in flight, yielding each
+ * result as it completes — in completion order, not input order. Use when
+ * the caller wants to react to each completion as it happens (e.g. emit
+ * a progress event mid-stream). For collect-all-then-return semantics,
+ * mapLimit is simpler.
+ *
+ * Each yield includes the original `index` so the consumer can reconstruct
+ * input order if needed.
+ */
+export async function* mapLimitStream(items, fn, limit = DEFAULT_CONCURRENCY) {
+    // Each task gets a unique id — lets us remove from `active` by lookup
+    // without relying on Promise identity (which Promise.race doesn't give
+    // us directly).
+    const active = new Map();
+    let next = 0;
+    function start() {
+        if (next >= items.length)
+            return;
+        const i = next++;
+        const item = items[i];
+        const self = Symbol();
+        const p = fn(item, i).then((result) => ({ item, result, index: i, self }));
+        active.set(self, p);
+    }
+    for (let i = 0; i < Math.min(limit, items.length); i++)
+        start();
+    while (active.size > 0) {
+        // Promise.race resolves with the first settled value (and rejects on
+        // the first rejection — so errors propagate naturally).
+        const settled = await Promise.race(active.values());
+        active.delete(settled.self);
+        yield { item: settled.item, result: settled.result, index: settled.index };
+        start();
+    }
+}
+/**
+ * Like mapLimit but doesn't throw on individual failures — returns a parallel
+ * array of { ok: true, value } or { ok: false, error } per input. Useful
+ * when a single bad manifest shouldn't abort a whole site walk.
+ */
+export async function mapLimitSettled(items, fn, limit = DEFAULT_CONCURRENCY) {
+    const results = new Array(items.length);
+    let cursor = 0;
+    async function worker() {
+        while (cursor < items.length) {
+            const i = cursor++;
+            try {
+                const value = await fn(items[i], i);
+                results[i] = { ok: true, value };
+            }
+            catch (error) {
+                results[i] = { ok: false, error };
+            }
+        }
+    }
+    const workerCount = Math.min(limit, items.length);
+    await Promise.all(Array.from({ length: workerCount }, worker));
+    return results;
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/concurrency.js.map

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

package/dist/hash.d.ts

@@ -1,8 +1,23 @@
 import type { FragmentManifest, PageManifest } from './types.js';
 export declare function sidecarNameFor(hash: string): string;
 export declare function parseSidecarName(entryName: string): string | null;
+/**
+ * Filename-safe encoding for fragment/template names. Fragments can be
+ * subfolder-qualified (e.g. "buttons/primary"); we replace / with __ so the
+ * name works as a filename component and stays readable in listings.
+ */
+export declare function encodeRefName(name: string): string;
+export declare function decodeRefName(name: string): string;
+/** `.uses-header` for a page/fragment that references @header. */
+export declare function usesSidecarNameFor(fragmentName: string): string;
+export declare function parseUsesSidecarName(entryName: string): string | null;
+/** `.tpl-page-default` for a page/fragment rendered with that template. */
+export declare function templateSidecarNameFor(templateName: string): string;
+export declare function parseTemplateSidecarName(entryName: string): string | null;
 export interface HashManifestOptions {
     templateHashes: Map<string, string>;
+    /** Fragment content hashes — include only for static-mode page hashing. */
+    fragmentHashes?: Map<string, string>;
 }
 /**
  * Compute the content hash for a page or fragment manifest.

package/dist/hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAIhF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGjE;AAuBD,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACpC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,YAAY,GAAG,gBAAgB,EACzC,IAAI,EAAE,mBAAmB,GACxB,MAAM,CASR"}
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAMhF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AACD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE/D;AACD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGrE;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEnE;AACD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzE;AAmCD,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,2EAA2E;IAC3E,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,YAAY,GAAG,gBAAgB,EACzC,IAAI,EAAE,mBAAmB,GACxB,MAAM,CASR"}

package/dist/hash.js

@@ -1,5 +1,7 @@
 import { createHash } from 'node:crypto';
 const SIDECAR_RE = /^\.([0-9a-f]{8})\.hash$/;
+const USES_SIDECAR_RE = /^\.uses-(.+)$/;
+const TPL_SIDECAR_RE = /^\.tpl-(.+)$/;
 export function sidecarNameFor(hash) {
     return `.${hash}.hash`;
 }
@@ -8,21 +10,59 @@ export function parseSidecarName(entryName) {
     return m ? m[1] : null;
 }
 /**
- * Walk the component tree and substitute `template: "name"` with `template: "name#hash"`
- * using the provided template hashes. Returns a new normalized structure — input is not mutated.
+ * Filename-safe encoding for fragment/template names. Fragments can be
+ * subfolder-qualified (e.g. "buttons/primary"); we replace / with __ so the
+ * name works as a filename component and stays readable in listings.
  */
-function substituteTemplateHashes(components, templateHashes) {
+export function encodeRefName(name) {
+    return name.replace(/\//g, '__');
+}
+export function decodeRefName(name) {
+    return name.replace(/__/g, '/');
+}
+/** `.uses-header` for a page/fragment that references @header. */
+export function usesSidecarNameFor(fragmentName) {
+    return `.uses-${encodeRefName(fragmentName)}`;
+}
+export function parseUsesSidecarName(entryName) {
+    const m = USES_SIDECAR_RE.exec(entryName);
+    return m ? decodeRefName(m[1]) : null;
+}
+/** `.tpl-page-default` for a page/fragment rendered with that template. */
+export function templateSidecarNameFor(templateName) {
+    return `.tpl-${encodeRefName(templateName)}`;
+}
+export function parseTemplateSidecarName(entryName) {
+    const m = TPL_SIDECAR_RE.exec(entryName);
+    return m ? decodeRefName(m[1]) : null;
+}
+/**
+ * Walk the component tree and substitute template/fragment refs with their
+ * hashed forms (`"name#hash"`) using the provided maps. Returns a new
+ * normalized structure — input is not mutated.
+ *
+ * `fragmentHashes` is only provided for static-mode targets where fragments
+ * are baked into pages at publish time — a fragment content change must
+ * invalidate every page that uses it. In ESI mode fragments are published
+ * separately, so pages don't need fragment hashes in their own hash.
+ */
+function substituteHashes(components, templateHashes, fragmentHashes) {
     if (!components)
         return undefined;
     return components.map(entry => {
-        if (typeof entry === 'string')
-            return entry;
+        if (typeof entry === 'string') {
+            if (!fragmentHashes || !entry.startsWith('@'))
+                return entry;
+            const name = entry.slice(1);
+            const h = fragmentHashes.get(name);
+            return h ? `@${name}#${h}` : entry;
+        }
         const hash = templateHashes.get(entry.template);
         return {
             name: entry.name,
             template: hash ? `${entry.template}#${hash}` : entry.template,
             content: entry.content,
-            components: substituteTemplateHashes(entry.components, templateHashes),
+            components: substituteHashes(entry.components, templateHashes, fragmentHashes),
         };
     });
 }
@@ -39,7 +79,7 @@ export function hashManifest(manifest, opts) {
     const normalized = {
         template: rootHash ? `${manifest.template}#${rootHash}` : manifest.template,
         content: manifest.content ?? null,
-        components: substituteTemplateHashes(manifest.components, opts.templateHashes) ?? null,
+        components: substituteHashes(manifest.components, opts.templateHashes, opts.fragmentHashes) ?? null,
     };
     const json = JSON.stringify(normalized, sortedReplacer);
     return createHash('md5').update(json).digest('hex').slice(0, 8);

package/dist/hash.js.map

@@ -1 +1 @@
-{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC,MAAM,UAAU,GAAG,yBAAyB,CAAA;AAE5C,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,IAAI,OAAO,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACpC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACxB,CAAC;AAED;;;GAGG;AACH,SAAS,wBAAwB,CAC/B,UAAwC,EACxC,cAAmC;IAEnC,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAA;IACjC,OAAO,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAA;QAC3C,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QAC/C,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ;YAC7D,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,wBAAwB,CAAC,KAAK,CAAC,UAAU,EAAE,cAAc,CAAC;SACvE,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAMD;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAyC,EACzC,IAAyB;IAEzB,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAC3D,MAAM,UAAU,GAAG;QACjB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ;QAC3E,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,IAAI;QACjC,UAAU,EAAE,wBAAwB,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,IAAI;KACvF,CAAA;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;IACvD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AACjE,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,KAAc;IAClD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,GAAG,GAA4B,EAAE,CAAA;QACvC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACrE,GAAG,CAAC,CAAC,CAAC,GAAI,KAAiC,CAAC,CAAC,CAAC,CAAA;QAChD,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"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"}

package/dist/publish-rendered.d.ts

@@ -1,10 +1,11 @@
 import type { StorageProvider, PurgeStrategy, CacheConfig } from './types.js';
+import type { Site } from './site-loader.js';
 /**
  * Publish a page as HTML with ESI placeholders for fragments.
  * Local components are baked in. Fragment markup is replaced at request time by the worker.
  * CSS is stored as separate hashed files for immutable caching.
  */
-export declare function publishPageRendered(pageName: string, sourceStorage: StorageProvider, sourceDir: string, targetStorage: StorageProvider, targetCache?: CacheConfig, templatesDir?: string, manifestHash?: string): Promise<{
+export declare function publishPageRendered(pageName: string, sourceStorage: StorageProvider, sourceDir: string, targetStorage: StorageProvider, targetCache?: CacheConfig, templatesDir?: string, manifestHash?: string, preloadedSite?: Site): Promise<{
     files: number;
     removed: number;
 }>;
@@ -13,26 +14,26 @@ export declare function publishPageRendered(pageName: string, sourceStorage: Sto
  * All components (including fragments) are baked in. CSS/JS inline.
  * For static hosting: GitHub Pages, Netlify, Vercel, any file server.
  */
-export declare function publishPageStatic(pageName: string, sourceStorage: StorageProvider, sourceDir: string, targetStorage: StorageProvider, templatesDir?: string, manifestHash?: string): Promise<{
+export declare function publishPageStatic(pageName: string, sourceStorage: StorageProvider, sourceDir: string, targetStorage: StorageProvider, templatesDir?: string, manifestHash?: string, preloadedSite?: Site): Promise<{
     files: number;
 }>;
 /**
  * Publish a fragment as HTML with a <head> section for CSS/JS.
  * The worker injects <head> content before </head> and body content at the ESI placeholder.
  */
-export declare function publishFragmentRendered(fragmentName: string, sourceStorage: StorageProvider, sourceDir: string, targetStorage: StorageProvider, templatesDir?: string, manifestHash?: string): Promise<{
+export declare function publishFragmentRendered(fragmentName: string, sourceStorage: StorageProvider, sourceDir: string, targetStorage: StorageProvider, templatesDir?: string, manifestHash?: string, preloadedSite?: Site): Promise<{
     files: number;
     removed: number;
 }>;
 /**
  * Publish site manifest (stripped of targets config).
  */
-export declare function publishSiteManifest(sourceStorage: StorageProvider, sourceDir: string, targetStorage: StorageProvider): Promise<void>;
+export declare function publishSiteManifest(sourceStorage: StorageProvider, sourceDir: string, targetStorage: StorageProvider, preloadedSite?: Site): Promise<void>;
 /**
  * Build and store reverse fragment index.
  * Maps each fragment to the list of page routes that use it.
  */
-export declare function publishFragmentIndex(sourceStorage: StorageProvider, sourceDir: string, targetStorage: StorageProvider): Promise<Record<string, string[]>>;
+export declare function publishFragmentIndex(sourceStorage: StorageProvider, sourceDir: string, targetStorage: StorageProvider, preloadedSite?: Site): Promise<Record<string, string[]>>;
 /** Purge via Cloudflare zone cache API */
 export declare function createCloudflarePurge(zoneId: string, apiToken: string): PurgeStrategy;
 /** Look up Cloudflare zone ID from a site URL */

package/dist/publish-rendered.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publish-rendered.d.ts","sourceRoot":"","sources":["../src/publish-rendered.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAqD7E;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,eAAe,EAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,eAAe,EAC9B,WAAW,CAAC,EAAE,WAAW,EACzB,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA8G7C;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,eAAe,EAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,eAAe,EAC9B,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAsB5B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,eAAe,EAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,eAAe,EAC9B,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA0D7C;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,eAAe,EAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,eAAe,GAC7B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,eAAe,EAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,eAAe,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAiBnC;AAED,0CAA0C;AAC1C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAcrF;AAED,iDAAiD;AACjD,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQtG;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,eAAe,EAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,eAAe,EAC9B,KAAK,EAAE,aAAa,EACpB,SAAS,GAAE,KAAK,GAAG,KAAa,GAC/B,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAkBlD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,eAAe,EAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,eAAe,EAC9B,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAUlD"}
+{"version":3,"file":"publish-rendered.d.ts","sourceRoot":"","sources":["../src/publish-rendered.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAmC5C;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,eAAe,EAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,eAAe,EAC9B,WAAW,CAAC,EAAE,WAAW,EACzB,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,IAAI,GACnB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAsH7C;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,eAAe,EAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,eAAe,EAC9B,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,IAAI,GACnB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA4B5B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,eAAe,EAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,eAAe,EAC9B,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,IAAI,GACnB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAgE7C;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,eAAe,EAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,eAAe,EAC9B,aAAa,CAAC,EAAE,IAAI,GACnB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,eAAe,EAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,eAAe,EAC9B,aAAa,CAAC,EAAE,IAAI,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAiBnC;AAED,0CAA0C;AAC1C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAcrF;AAED,iDAAiD;AACjD,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQtG;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,eAAe,EAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,eAAe,EAC9B,KAAK,EAAE,aAAa,EACpB,SAAS,GAAE,KAAK,GAAG,KAAa,GAC/B,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAkBlD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,eAAe,EAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,eAAe,EAC9B,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAUlD"}