gazetta 0.6.0 → 0.8.0

package/dist/render-for-analysis.js

@@ -0,0 +1,146 @@
+/**
+ * Render-for-analysis (Validation Cut 3).
+ *
+ * Renders a page or fragment to its complete HTML output for consumption by
+ * quality validators (a11y, html-validity). Same renderer as preview/publish;
+ * no storage write. Caches per (item, locale, theme, content+template+
+ * dependency hash).
+ *
+ * # Multi-instance discipline
+ *
+ * Per-instance scope. Each admin instance maintains its own cache; cache hits
+ * are bounded to one process. Acceptable because:
+ *   - Render output is deterministic given the same content + template +
+ *     fragment dependencies + locale + theme — different instances arrive at
+ *     identical bytes from identical inputs.
+ *   - The cache key folds in the hashes that drive determinism, so a stale
+ *     instance can't return divergent output: if the content changed, the key
+ *     changed, and the new render runs.
+ *   - Render-for-analysis is fire-and-forget per scanner pass; no consumer
+ *     depends on cross-instance cache sharing.
+ *
+ * # SOLID lenses
+ *
+ *   - SRP: this module renders + caches. It doesn't run validators or write
+ *     storage; consumers feed the output into their own logic.
+ *   - DIP: depends on `AdminCache` interface, not `MemoryCache`; depends on
+ *     `Site` and the resolver/renderer functions.
+ *   - OCP: adding new validators that consume the rendered output is one new
+ *     file in `validators/`; this module unchanged.
+ */
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+import { access, readFile } from 'node:fs/promises';
+import { hashManifest } from './hash.js';
+import { renderPage } from './renderer.js';
+import { resolvePage } from './resolver.js';
+/**
+ * Render the named page for analysis. Returns null when the item doesn't
+ * exist or rendering fails (failures log via `console.warn` but don't throw —
+ * validators that depend on output simply skip when output is null).
+ */
+export async function renderPageForAnalysis(pageName, opts) {
+    const { site, cache, templatesDir, locale, theme } = opts;
+    const page = pageManifestFor(site, pageName, locale);
+    if (!page)
+        return null;
+    const templateHashes = await computeTemplateHashes(site, templatesDir);
+    const fragmentHashes = computeFragmentHashes(site);
+    const contentHash = hashManifest(page, { templateHashes, fragmentHashes });
+    const key = cacheKey('page', pageName, locale, theme, contentHash);
+    const cached = await cache.get(key);
+    if (cached !== null)
+        return cached;
+    try {
+        const resolved = await resolvePage(pageName, site, locale, theme);
+        const html = await renderPage(resolved, {
+            metadata: page.metadata,
+            route: page.route,
+            seo: { siteName: site.manifest.name, locale: locale ?? 'en', defaultOgImage: site.manifest.defaultOgImage },
+        });
+        const output = { html };
+        await cache.set(key, output);
+        return output;
+    }
+    catch (err) {
+        console.warn(`[validation/render-for-analysis] page "${pageName}" failed: ${err.message}`);
+        return null;
+    }
+}
+// ---- helpers --------------------------------------------------------------
+function pageManifestFor(site, name, locale) {
+    if (locale) {
+        const variant = site.pageLocales.get(name)?.locales.get(locale);
+        if (variant)
+            return variant;
+        // fall through to default-locale page if no variant exists
+    }
+    return site.pages.get(name) ?? null;
+}
+function cacheKey(kind, name, locale, theme, hash) {
+    const loc = locale ?? '_';
+    const thm = theme ?? '_';
+    return `render-for-analysis:${kind}:${encodeName(name)}:${loc}:${thm}:${hash}`;
+}
+function encodeName(name) {
+    return name.replace(/[/]/g, '.').replace(/[^a-zA-Z0-9._-]/g, '_');
+}
+const TEMPLATE_FILES = ['index.ts', 'index.tsx', 'index.js', 'index.jsx'];
+/**
+ * Compute MD5 hashes of every template's source file. Reused by the
+ * publish-side `hashManifest()` machinery; same shape so cache keys
+ * align across surfaces.
+ */
+async function computeTemplateHashes(site, templatesDir) {
+    const out = new Map();
+    const seen = new Set();
+    const collect = (manifest) => {
+        if (manifest.template)
+            seen.add(manifest.template);
+        walkTemplates(manifest.components, seen);
+    };
+    for (const page of site.pages.values())
+        collect(page);
+    for (const frag of site.fragments.values())
+        collect(frag);
+    for (const tplName of seen) {
+        const hash = await tryHashTemplate(templatesDir, tplName);
+        if (hash)
+            out.set(tplName, hash);
+    }
+    return out;
+}
+function walkTemplates(components, out) {
+    if (!components)
+        return;
+    for (const entry of components) {
+        if (typeof entry === 'object' && entry !== null) {
+            if (entry.template)
+                out.add(entry.template);
+            walkTemplates(entry.components, out);
+        }
+    }
+}
+async function tryHashTemplate(templatesDir, name) {
+    for (const file of TEMPLATE_FILES) {
+        const path = join(templatesDir, name, file);
+        try {
+            await access(path);
+            const bytes = await readFile(path);
+            return createHash('md5').update(bytes).digest('hex').slice(0, 8);
+        }
+        catch {
+            // continue
+        }
+    }
+    return null;
+}
+function computeFragmentHashes(site) {
+    const out = new Map();
+    for (const [name, frag] of site.fragments) {
+        const json = JSON.stringify({ template: frag.template, content: frag.content ?? null, components: frag.components ?? null }, Object.keys(frag).sort());
+        out.set(name, createHash('md5').update(json).digest('hex').slice(0, 8));
+    }
+    return out;
+}
+//# sourceMappingURL=render-for-analysis.js.map

package/dist/render-for-analysis.js.map

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

package/dist/resolver.d.ts

@@ -1,6 +1,7 @@
 import type { ResolvedComponent, ComponentEntry } from './types.js';
 import type { Site } from './site-loader.js';
 import { type ResolvedLocales } from './locale.js';
+import { type ResolvedThemes } from './themes.js';
 interface ResolveContext {
     site: Site;
     templatesDir: string;
@@ -8,11 +9,20 @@ interface ResolveContext {
     path: string[];
     /** When set, fragment references resolve the locale-specific variant first. */
     locale?: string;
+    /**
+     * Active theme for asset resolution. v1 doesn't yet route a theme value
+     * from runtime callers (page/fragment templates emit theme-aware CSS via
+     * tokens, not via SSR theme branching); the field is wired so step 18+
+     * runtime work can pass it without resolver changes.
+     */
+    theme?: string;
     /** Resolved site locales — cached for fallback resolution. */
     resolvedLocales?: ResolvedLocales;
+    /** Resolved site themes — needed for font variant enumeration. */
+    resolvedThemes?: ResolvedThemes | null;
 }
 export declare function resolveComponent(entry: ComponentEntry, ctx: ResolveContext): Promise<ResolvedComponent>;
-export declare function resolveFragment(fragmentName: string, site: Site, locale?: string): Promise<ResolvedComponent>;
-export declare function resolvePage(pageName: string, site: Site, locale?: string): Promise<ResolvedComponent>;
+export declare function resolveFragment(fragmentName: string, site: Site, locale?: string, theme?: string): Promise<ResolvedComponent>;
+export declare function resolvePage(pageName: string, site: Site, locale?: string, theme?: string): Promise<ResolvedComponent>;
 export {};
 //# sourceMappingURL=resolver.d.ts.map

package/dist/resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAmB,MAAM,YAAY,CAAA;AAGpF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAA6C,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7F,UAAU,cAAc;IACtB,IAAI,EAAE,IAAI,CAAA;IACV,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACpB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8DAA8D;IAC9D,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAa7G;AA4ED,wBAAsB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA8CnH;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiC3G"}
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EAIf,MAAM,YAAY,CAAA;AAInB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAA6C,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7F,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAyCpE,UAAU,cAAc;IACtB,IAAI,EAAE,IAAI,CAAA;IACV,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACpB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8DAA8D;IAC9D,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,kEAAkE;IAClE,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;CACvC;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAa7G;AAoHD,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,CAAC,CA+C5B;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,CAAC,CA2C5B"}

package/dist/resolver.js

@@ -1,6 +1,31 @@
 import { loadTemplate } from './template-loader.js';
 import { processContent } from './content.js';
+import { resolveAssetRefs } from './assets/resolve.js';
 import { resolveLocaleFallback, resolveSiteLocales } from './locale.js';
+import { resolveSiteThemes } from './themes.js';
+import { resolveFragmentArchiveAlias } from './archive-helpers.js';
+/**
+ * Build the asset-resolve context from the site being rendered. Shared
+ * across all `processContent` + `resolveAssetRefs` pairs in a single
+ * resolution pass. Locale + theme flow in from the render-time
+ * `ResolveContext`; locales/themes config is derived from `site.manifest`
+ * once and reused.
+ */
+function assetContext(site, locale, theme, resolvedLocales, resolvedThemes) {
+    return {
+        storage: site.storage,
+        assetsRoot: 'assets',
+        locale,
+        theme,
+        locales: resolvedLocales,
+        themes: resolvedThemes,
+    };
+}
+/** Process content: sync transforms (markdown) + async asset resolution. */
+async function processAndResolve(content, schema, site, ctx) {
+    const processed = processContent(content, schema);
+    return resolveAssetRefs(processed, assetContext(site, ctx.locale, ctx.theme, ctx.resolvedLocales ?? null, ctx.resolvedThemes ?? null));
+}
 export async function resolveComponent(entry, ctx) {
     if (typeof entry === 'string') {
         if (!entry.startsWith('@')) {
@@ -12,14 +37,20 @@ export async function resolveComponent(entry, ctx) {
     }
     return resolveInlineComponent(entry, ctx);
 }
-async function resolveFragmentRef(fragmentName, ctx) {
-    const key = `@${fragmentName}`;
-    if (ctx.visited.has(key)) {
-        throw new Error(`Circular reference detected: ${key}\n` + `  Resolution path: ${ctx.path.join(' → ')} → ${key}`);
-    }
-    ctx.visited.add(key);
-    ctx.path.push(key);
-    // Resolve locale-specific fragment variant, falling back through the chain
+/**
+ * Look up a fragment by name with locale fallback. Returns null when the
+ * fragment doesn't exist (in any locale). Doesn't follow aliasOf —
+ * that's the caller's job (via `resolveFragmentArchiveAlias`).
+ *
+ * Locale resolution: a locale-specific variant (`fragment.fr.json`)
+ * wins when available + reachable per the resolved-locales fallback
+ * chain; otherwise the default-locale manifest is used.
+ *
+ * Used by both `resolveFragmentRef` (per-component path) and
+ * `resolveFragment` (entry-point path). Sharing the lookup keeps
+ * locale + alias resolution coherent across both paths.
+ */
+function lookupFragmentForLocale(fragmentName, ctx) {
     let fragment = ctx.site.fragments.get(fragmentName) ?? null;
     if (ctx.locale && ctx.resolvedLocales) {
         const localeEntry = ctx.site.fragmentLocales.get(fragmentName);
@@ -31,7 +62,30 @@ async function resolveFragmentRef(fragmentName, ctx) {
                 fragment = localeVariant;
         }
     }
-    if (!fragment) {
+    return fragment;
+}
+async function resolveFragmentRef(fragmentName, ctx) {
+    const key = `@${fragmentName}`;
+    if (ctx.visited.has(key)) {
+        throw new Error(`Circular reference detected: ${key}\n` + `  Resolution path: ${ctx.path.join(' → ')} → ${key}`);
+    }
+    ctx.visited.add(key);
+    ctx.path.push(key);
+    // Look up the fragment, following aliasOf when archived (Q2 F1 lock).
+    // Throws ArchivedNoAliasError if archived without alias; throws on
+    // alias chains > MAX_ALIAS_HOPS or cycles (defensive — Q3 flatten
+    // guarantees one hop in practice).
+    const lookup = (name) => lookupFragmentForLocale(name, ctx);
+    let resolution;
+    try {
+        resolution = resolveFragmentArchiveAlias(fragmentName, lookup, ctx.path.join(' → '));
+    }
+    catch (err) {
+        ctx.path.pop();
+        ctx.visited.delete(key);
+        throw err;
+    }
+    if (!resolution) {
         const available = [...ctx.site.fragments.keys()];
         ctx.path.pop();
         ctx.visited.delete(key);
@@ -39,6 +93,8 @@ async function resolveFragmentRef(fragmentName, ctx) {
             `  Referenced in: ${ctx.path.join(' → ') || 'page root'}\n` +
             `  Available fragments: ${available.length > 0 ? available.join(', ') : '(none)'}`);
     }
+    // Cast: lookup callback only returns Site fragment entries which carry `dir`.
+    const fragment = resolution.manifest;
     const loaded = await loadTemplate(ctx.site.storage, ctx.templatesDir, fragment.template);
     const children = [];
     if (fragment.components) {
@@ -51,7 +107,7 @@ async function resolveFragmentRef(fragmentName, ctx) {
     ctx.visited.delete(key);
     return {
         template: loaded.render,
-        content: processContent(fragment.content, loaded.schema),
+        content: await processAndResolve(fragment.content, loaded.schema, ctx.site, ctx),
         children,
         path: fragment.dir,
         treePath,
@@ -74,35 +130,38 @@ async function resolveInlineComponent(comp, ctx) {
     const treePath = ctx.path.slice(1).join('/');
     ctx.path.pop();
     ctx.visited.delete(key);
-    return { template: loaded.render, content: processContent(comp.content, loaded.schema), children, treePath };
+    return {
+        template: loaded.render,
+        content: await processAndResolve(comp.content, loaded.schema, ctx.site, ctx),
+        children,
+        treePath,
+    };
 }
-export async function resolveFragment(fragmentName, site, locale) {
-    // Resolve locale-specific fragment variant
-    let fragment = site.fragments.get(fragmentName) ?? null;
-    const resolvedLocales = locale ? (resolveSiteLocales(site.manifest) ?? undefined) : undefined;
-    if (locale && resolvedLocales) {
-        const localeEntry = site.fragmentLocales.get(fragmentName);
-        if (localeEntry) {
-            const available = new Set(localeEntry.locales.keys());
-            const bestLocale = resolveLocaleFallback(locale, available, resolvedLocales);
-            const localeVariant = localeEntry.locales.get(bestLocale);
-            if (localeVariant)
-                fragment = localeVariant;
-        }
-    }
-    if (!fragment) {
+export async function resolveFragment(fragmentName, site, locale, theme) {
+    // Always resolve site-level config — even when no active locale/theme
+    // is set, the asset resolver may need it (font enumeration walks the
+    // configured theme universe).
+    const resolvedLocales = resolveSiteLocales(site.manifest) ?? undefined;
+    const resolvedThemes = resolveSiteThemes(site.manifest);
+    // Look up the fragment, following aliasOf when archived (Q2 F1 lock).
+    const lookup = (name) => lookupFragmentForLocale(name, { site, locale, resolvedLocales });
+    const resolution = resolveFragmentArchiveAlias(fragmentName, lookup, `@${fragmentName}`);
+    if (!resolution) {
         const available = [...site.fragments.keys()];
         throw new Error(`Fragment "${fragmentName}" not found.\n` +
             `  Available fragments: ${available.length > 0 ? available.join(', ') : '(none)'}`);
     }
+    const fragment = resolution.manifest;
     const templatesDir = site.templatesDir;
     const ctx = {
         site,
         templatesDir,
         visited: new Set(),
-        path: ['', `@${fragmentName}`],
+        path: ['', `@${resolution.resolvedName}`],
         locale,
+        theme,
         resolvedLocales,
+        resolvedThemes,
     };
     const loaded = await loadTemplate(site.storage, templatesDir, fragment.template);
     const children = [];
@@ -113,13 +172,13 @@ export async function resolveFragment(fragmentName, site, locale) {
     }
     return {
         template: loaded.render,
-        content: processContent(fragment.content, loaded.schema),
+        content: await processAndResolve(fragment.content, loaded.schema, site, ctx),
         children,
         path: fragment.dir,
         treePath: '',
     };
 }
-export async function resolvePage(pageName, site, locale) {
+export async function resolvePage(pageName, site, locale, theme) {
     const defaultPage = site.pages.get(pageName);
     if (!defaultPage) {
         const available = [...site.pages.keys()];
@@ -130,8 +189,18 @@ export async function resolvePage(pageName, site, locale) {
     const localeEntry = locale ? site.pageLocales.get(pageName) : undefined;
     const page = localeEntry?.locales.get(locale) ?? defaultPage;
     const templatesDir = site.templatesDir;
-    const resolvedLocales = locale ? (resolveSiteLocales(site.manifest) ?? undefined) : undefined;
-    const ctx = { site, templatesDir, visited: new Set(), path: [pageName], locale, resolvedLocales };
+    const resolvedLocales = resolveSiteLocales(site.manifest) ?? undefined;
+    const resolvedThemes = resolveSiteThemes(site.manifest);
+    const ctx = {
+        site,
+        templatesDir,
+        visited: new Set(),
+        path: [pageName],
+        locale,
+        theme,
+        resolvedLocales,
+        resolvedThemes,
+    };
     const loaded = await loadTemplate(site.storage, templatesDir, page.template);
     const children = [];
     if (page.components) {
@@ -141,7 +210,7 @@ export async function resolvePage(pageName, site, locale) {
     }
     return {
         template: loaded.render,
-        content: processContent(page.content, loaded.schema),
+        content: await processAndResolve(page.content, loaded.schema, site, ctx),
         children,
         path: page.dir,
         treePath: '',

package/dist/resolver.js.map

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

package/dist/runtime/archive-marker.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Archive marker grammar + parser for static + dynamic targets per
+ * design-soft-delete.md Q10 lock.
+ *
+ * Static (and dynamic) targets emit HTML with the marker as the first
+ * line of the file:
+ *
+ *   <!-- gazetta:archived alias=welcome -->
+ *   <!-- gazetta:archived gone -->
+ *
+ * Worker reads the first ~200 bytes of `pages/{name}/index.html`,
+ * parses the marker, and decides:
+ *
+ *   - alias=X    → 301 redirect to deriveRoute(X)
+ *   - gone       → 410 Gone
+ *   - no marker  → serve the HTML as-is (live page)
+ *
+ * Constraints (locked):
+ *   - Marker MUST be the first line (worker reads only the prefix)
+ *   - Single-line; no nested HTML; no whitespace games
+ *   - `<bare-name>` is a name (page or fragment), not a route — the
+ *     worker calls `deriveRoute()` to resolve to a URL when needed
+ *
+ * SRP: this module is the marker grammar. Emit + parse round-trip.
+ * Publish-rendered.ts emits via `archiveMarker()`; workers parse via
+ * `parseArchiveMarker()`. Workers never emit; publish never parses.
+ */
+/** Result of parsing the marker — null when no marker is present. */
+export type ArchiveMarker = {
+    kind: 'alias';
+    target: string;
+} | {
+    kind: 'gone';
+};
+/**
+ * Emit a marker line for a page/fragment that's archived. Returns the
+ * full marker line including trailing newline so callers concatenate
+ * it directly with the rendered HTML.
+ *
+ * For aliased archives: `archiveMarker({ kind: 'alias', target: 'welcome' })`
+ * For pure soft-delete: `archiveMarker({ kind: 'gone' })`
+ *
+ * Validates the alias target is non-empty and contains no whitespace
+ * (the regex grammar requires `\S+`); throws on bad input rather than
+ * silently emitting an unparseable marker.
+ */
+export declare function archiveMarker(marker: ArchiveMarker): string;
+/**
+ * Parse an archive marker from the leading bytes of an HTML file.
+ *
+ * Accepts either a `Uint8Array` (worker reading bytes from storage)
+ * or a `string` (testing convenience).
+ *
+ * Returns the parsed marker, or null when no marker is present (the
+ * normal case — live pages don't carry markers).
+ *
+ * Reads only the first MARKER_PREFIX_BYTES bytes; longer input is
+ * truncated. The marker MUST be at byte 0; markers in the middle of
+ * a file are not detected (per the locked grammar — first-line only).
+ */
+export declare function parseArchiveMarker(input: Uint8Array | string): ArchiveMarker | null;
+//# sourceMappingURL=archive-marker.d.ts.map

package/dist/runtime/archive-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-marker.d.ts","sourceRoot":"","sources":["../../src/runtime/archive-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAQhF;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAU3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,aAAa,GAAG,IAAI,CASnF"}

package/dist/runtime/archive-marker.js

@@ -0,0 +1,88 @@
+/**
+ * Archive marker grammar + parser for static + dynamic targets per
+ * design-soft-delete.md Q10 lock.
+ *
+ * Static (and dynamic) targets emit HTML with the marker as the first
+ * line of the file:
+ *
+ *   <!-- gazetta:archived alias=welcome -->
+ *   <!-- gazetta:archived gone -->
+ *
+ * Worker reads the first ~200 bytes of `pages/{name}/index.html`,
+ * parses the marker, and decides:
+ *
+ *   - alias=X    → 301 redirect to deriveRoute(X)
+ *   - gone       → 410 Gone
+ *   - no marker  → serve the HTML as-is (live page)
+ *
+ * Constraints (locked):
+ *   - Marker MUST be the first line (worker reads only the prefix)
+ *   - Single-line; no nested HTML; no whitespace games
+ *   - `<bare-name>` is a name (page or fragment), not a route — the
+ *     worker calls `deriveRoute()` to resolve to a URL when needed
+ *
+ * SRP: this module is the marker grammar. Emit + parse round-trip.
+ * Publish-rendered.ts emits via `archiveMarker()`; workers parse via
+ * `parseArchiveMarker()`. Workers never emit; publish never parses.
+ */
+/** Number of leading bytes to inspect for a marker. */
+const MARKER_PREFIX_BYTES = 200;
+/** Regex anchors at start of input; closed-form grammar. */
+const MARKER_RE = /^<!-- gazetta:archived (alias=([\S]+)|gone) -->/;
+/**
+ * Emit a marker line for a page/fragment that's archived. Returns the
+ * full marker line including trailing newline so callers concatenate
+ * it directly with the rendered HTML.
+ *
+ * For aliased archives: `archiveMarker({ kind: 'alias', target: 'welcome' })`
+ * For pure soft-delete: `archiveMarker({ kind: 'gone' })`
+ *
+ * Validates the alias target is non-empty and contains no whitespace
+ * (the regex grammar requires `\S+`); throws on bad input rather than
+ * silently emitting an unparseable marker.
+ */
+export function archiveMarker(marker) {
+    if (marker.kind === 'alias') {
+        if (!marker.target || /\s/.test(marker.target)) {
+            throw new Error(`Invalid archive alias target ${JSON.stringify(marker.target)} — must be a non-empty string with no whitespace.`);
+        }
+        return `<!-- gazetta:archived alias=${marker.target} -->\n`;
+    }
+    return '<!-- gazetta:archived gone -->\n';
+}
+/**
+ * Parse an archive marker from the leading bytes of an HTML file.
+ *
+ * Accepts either a `Uint8Array` (worker reading bytes from storage)
+ * or a `string` (testing convenience).
+ *
+ * Returns the parsed marker, or null when no marker is present (the
+ * normal case — live pages don't carry markers).
+ *
+ * Reads only the first MARKER_PREFIX_BYTES bytes; longer input is
+ * truncated. The marker MUST be at byte 0; markers in the middle of
+ * a file are not detected (per the locked grammar — first-line only).
+ */
+export function parseArchiveMarker(input) {
+    const prefix = typeof input === 'string' ? input.slice(0, MARKER_PREFIX_BYTES) : decodePrefix(input);
+    const match = MARKER_RE.exec(prefix);
+    if (!match)
+        return null;
+    if (match[1] === 'gone')
+        return { kind: 'gone' };
+    // match[1] starts with 'alias=', match[2] is the bare target name
+    const target = match[2];
+    if (!target)
+        return null;
+    return { kind: 'alias', target };
+}
+/**
+ * Decode the first MARKER_PREFIX_BYTES bytes as UTF-8. Bounded read;
+ * the worker may pass a longer Uint8Array, we slice. Returns the
+ * decoded string (or as much of it as fits in the prefix budget).
+ */
+function decodePrefix(bytes) {
+    const slice = bytes.byteLength > MARKER_PREFIX_BYTES ? bytes.subarray(0, MARKER_PREFIX_BYTES) : bytes;
+    return new TextDecoder('utf-8', { fatal: false }).decode(slice);
+}
+//# sourceMappingURL=archive-marker.js.map

package/dist/runtime/archive-marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-marker.js","sourceRoot":"","sources":["../../src/runtime/archive-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,uDAAuD;AACvD,MAAM,mBAAmB,GAAG,GAAG,CAAA;AAE/B,4DAA4D;AAC5D,MAAM,SAAS,GAAG,iDAAiD,CAAA;AAEnE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CACb,gCAAgC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,mDAAmD,CACjH,CAAA;QACH,CAAC;QACD,OAAO,+BAA+B,MAAM,CAAC,MAAM,QAAQ,CAAA;IAC7D,CAAC;IACD,OAAO,kCAAkC,CAAA;AAC3C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAA0B;IAC3D,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;IACpG,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACpC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IACvB,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAChD,kEAAkE;IAClE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACvB,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;AAClC,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,KAAiB;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,GAAG,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IACrG,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACjE,CAAC"}

package/dist/runtime/capability-gap-warnings.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Boot-time capability-gap inspection — surface #1 of the four-point
+ * capability-gap UX pattern.
+ *
+ * Per `design-soft-delete.md` Q10 lock + `feature-design-process.md`
+ * non-foundational discipline: at admin boot, walk every configured
+ * target and warn about runtime capability gaps. Non-blocking — admin
+ * starts. The warning gives operators an early signal during deploy
+ * so misconfiguration surfaces before content authors hit the gap at
+ * publish time.
+ *
+ * Pairs with:
+ *   - Surface #2 (author modal): consumes `/api/targets` extended
+ *     payload with capability info (Cut 10 wires the UI)
+ *   - Surface #3 (validator scanner): `archive-not-supported-on-target`
+ *     P4 validator from Cut 8 reports per-archived-item gaps
+ *   - Surface #4 (pre-publish gate): `/api/publish/audit` includes
+ *     per-target capability info when archived items are in scope
+ *
+ * # SOLID
+ *
+ *   - SRP: this module owns ONE concern — emit warnings at boot.
+ *     Doesn't inspect targets itself (delegates to runtime-capabilities);
+ *     doesn't render the warnings (consumes the existing console.warn
+ *     pattern).
+ *   - DIP: depends on the `inspectTarget` predicate, not on target-config
+ *     parsing details.
+ */
+import type { SiteManifest } from '../types.js';
+/**
+ * Walk the site's targets at boot; emit a warning per target that
+ * has any capability gap. Logs are operator-facing — once
+ * `design-logging.md`'s structured logger ships, replace `console.warn`
+ * with `log.warn({ module: 'admin-api.capability-gap', ... })`.
+ *
+ * Idempotent: calling twice produces the same warnings. The caller
+ * (admin-api boot path) calls once.
+ *
+ * @returns the count of targets with gaps — useful for tests.
+ */
+export declare function warnOnCapabilityGaps(manifest: SiteManifest): number;
+//# sourceMappingURL=capability-gap-warnings.d.ts.map