gazetta 0.7.0 → 0.8.0

package/dist/validation/validators/circular-alias.js

@@ -0,0 +1,63 @@
+export const circularAlias = {
+    source: 'gazetta',
+    name: 'circular-alias',
+    stages: ['background', 'pre-publish', 'cli'],
+    defaultSeverity() {
+        return 'error';
+    },
+    async validate(input) {
+        const { scope, site } = input;
+        if (scope.kind !== 'background')
+            return [];
+        const manifest = scope.manifest;
+        if (manifest.archived !== true)
+            return [];
+        if (typeof manifest.aliasOf !== 'string' || manifest.aliasOf.length === 0)
+            return [];
+        // Walk the chain. Q3 G1 invariant says one hop max — if we make
+        // it past 1 hop, that's already a violation. Cap at depth 16 to
+        // bound the walk on pathological data.
+        const chain = walkAliasChain(scope.item.kind, scope.item.name, site);
+        if (!chain.cycle && chain.depth <= 1)
+            return [];
+        if (chain.cycle) {
+            return [
+                {
+                    validator: 'circular-alias',
+                    severity: 'error',
+                    message: `Alias cycle: ${chain.path.join(' → ')}. Aliases must not form chains (Q3 G1 invariant).`,
+                    itemPath: scope.item.itemPath,
+                },
+            ];
+        }
+        return [
+            {
+                validator: 'circular-alias',
+                severity: 'error',
+                message: `Alias chain: ${chain.path.join(' → ')}. Aliases must point at live items (Q3 G1 invariant — no chaining).`,
+                itemPath: scope.item.itemPath,
+            },
+        ];
+    },
+};
+function walkAliasChain(kind, start, site) {
+    const map = kind === 'page' ? site.pages : site.fragments;
+    const path = [start];
+    const visited = new Set([start]);
+    let cur = map.get(start);
+    const maxDepth = 16;
+    while (cur && cur.archived === true && typeof cur.aliasOf === 'string' && cur.aliasOf.length > 0) {
+        if (path.length - 1 >= maxDepth)
+            break;
+        const next = cur.aliasOf;
+        if (visited.has(next)) {
+            path.push(next);
+            return { path, depth: path.length - 1, cycle: true };
+        }
+        path.push(next);
+        visited.add(next);
+        cur = map.get(next);
+    }
+    return { path, depth: path.length - 1, cycle: false };
+}
+//# sourceMappingURL=circular-alias.js.map

package/dist/validation/validators/circular-alias.js.map

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

package/dist/validation/validators/circular-fragment.d.ts

@@ -0,0 +1,15 @@
+import type { Validator } from '../types.js';
+/**
+ * Detect circular fragment references. A fragment that references @A which
+ * references @B which references back to the original creates an infinite
+ * resolve loop.
+ *
+ * Save-delta scope: walk fragment refs in the saved manifest, simulating the
+ * site state with the saved manifest substituted in. If a cycle is found,
+ * report the chain.
+ *
+ * Only fires for fragments (pages can't be referenced cyclically — pages
+ * aren't reachable from each other through @ refs).
+ */
+export declare const circularFragment: Validator;
+//# sourceMappingURL=circular-fragment.d.ts.map

package/dist/validation/validators/circular-fragment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circular-fragment.d.ts","sourceRoot":"","sources":["../../../src/validation/validators/circular-fragment.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAS,SAAS,EAAkB,MAAM,aAAa,CAAA;AAEnE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,EAAE,SA8B9B,CAAA"}

package/dist/validation/validators/circular-fragment.js

@@ -0,0 +1,97 @@
+/**
+ * Detect circular fragment references. A fragment that references @A which
+ * references @B which references back to the original creates an infinite
+ * resolve loop.
+ *
+ * Save-delta scope: walk fragment refs in the saved manifest, simulating the
+ * site state with the saved manifest substituted in. If a cycle is found,
+ * report the chain.
+ *
+ * Only fires for fragments (pages can't be referenced cyclically — pages
+ * aren't reachable from each other through @ refs).
+ */
+export const circularFragment = {
+    source: 'gazetta',
+    name: 'circular-fragment',
+    stages: ['save-delta', 'background', 'pre-publish', 'cli'],
+    defaultSeverity() {
+        return 'error';
+    },
+    async validate(input) {
+        const { scope, site } = input;
+        if (scope.kind !== 'save-delta' && scope.kind !== 'background')
+            return [];
+        if (scope.item.kind !== 'fragment')
+            return []; // only fragments form cycles
+        const manifest = scope.kind === 'save-delta' ? scope.after : scope.manifest;
+        const fragmentName = scope.item.name;
+        const fragmentsView = scope.kind === 'save-delta' ? withSubstituted(site, fragmentName, manifest) : site.fragments;
+        const cycle = findCycle(fragmentName, fragmentsView);
+        if (!cycle)
+            return [];
+        return [
+            {
+                validator: 'circular-fragment',
+                severity: 'error',
+                message: `Circular fragment reference: ${cycle.join(' → ')}.`,
+                itemPath: scope.item.itemPath,
+            },
+        ];
+    },
+};
+/**
+ * Build a fragments map with `name` substituted by the saved manifest.
+ * Other entries pass through. Used for save-delta to evaluate the cycle
+ * against the would-be-saved state, not the on-disk state.
+ */
+function withSubstituted(site, name, manifest) {
+    const map = new Map(site.fragments);
+    const existing = map.get(name);
+    // Cast: save-delta scope.after for a fragment IS a fragment manifest by construction.
+    const dir = existing?.dir ?? `fragments/${name}`;
+    map.set(name, { ...manifest, dir });
+    return map;
+}
+/**
+ * Depth-first search for a cycle starting at `start`. Returns the cycle path
+ * (with a closing element to make the loop visible: `a → b → a`) or null.
+ */
+function findCycle(start, fragments) {
+    const visiting = new Set();
+    const path = [];
+    return walk(start);
+    function walk(name) {
+        if (visiting.has(name)) {
+            const idx = path.indexOf(name);
+            if (idx >= 0)
+                return [...path.slice(idx), name];
+            return [name, name];
+        }
+        const frag = fragments.get(name);
+        if (!frag)
+            return null;
+        visiting.add(name);
+        path.push(name);
+        for (const ref of fragmentRefs(frag.components ?? [])) {
+            const cycle = walk(ref);
+            if (cycle)
+                return cycle;
+        }
+        visiting.delete(name);
+        path.pop();
+        return null;
+    }
+}
+function fragmentRefs(components) {
+    const out = [];
+    for (const entry of components) {
+        if (typeof entry === 'string' && entry.startsWith('@')) {
+            out.push(entry.slice(1));
+        }
+        else if (typeof entry === 'object' && entry !== null && entry.components) {
+            out.push(...fragmentRefs(entry.components));
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=circular-fragment.js.map

package/dist/validation/validators/circular-fragment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circular-fragment.js","sourceRoot":"","sources":["../../../src/validation/validators/circular-fragment.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAc;IACzC,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,mBAAmB;IACzB,MAAM,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,CAAU;IAEnE,eAAe;QACb,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAqB;QAClC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;QAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO,EAAE,CAAA;QACzE,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO,EAAE,CAAA,CAAC,6BAA6B;QAC3E,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAA;QAE3E,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAA;QACpC,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAA;QAElH,MAAM,KAAK,GAAG,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC,CAAA;QACpD,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAA;QAErB,OAAO;YACL;gBACE,SAAS,EAAE,mBAAmB;gBAC9B,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,gCAAgC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG;gBAC7D,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;aAC9B;SACF,CAAA;IACH,CAAC;CACF,CAAA;AAED;;;;GAIG;AACH,SAAS,eAAe,CACtB,IAAU,EACV,IAAY,EACZ,QAAyC;IAEzC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACnC,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC9B,sFAAsF;IACtF,MAAM,GAAG,GAAG,QAAQ,EAAE,GAAG,IAAI,aAAa,IAAI,EAAE,CAAA;IAChD,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAI,QAA6B,EAAE,GAAG,EAAE,CAAC,CAAA;IACzD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS,CAChB,KAAa,EACb,SAA0D;IAE1D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;IAClC,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAA;IAElB,SAAS,IAAI,CAAC,IAAY;QACxB,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YAC9B,IAAI,GAAG,IAAI,CAAC;gBAAE,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAA;YAC/C,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACrB,CAAC;QACD,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAChC,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAA;QACtB,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAClB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACf,KAAK,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;YACtD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAA;YACvB,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAA;QACzB,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACrB,IAAI,CAAC,GAAG,EAAE,CAAA;QACV,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,UAAqC;IACzD,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1B,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YAC3E,GAAG,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAA;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/validation/validators/dangling-alias.d.ts

@@ -0,0 +1,38 @@
+/**
+ * P2: dangling-alias.
+ *
+ * Per `design-soft-delete.md` Q11 stage matrix: error at save-delta,
+ * background, pre-publish, and cli. Severity is always `error` —
+ * dangling aliases break the alias-aware renderer (the redirect
+ * target doesn't exist).
+ *
+ * The check: when an item is archived with `aliasOf: X`, validate
+ * that an item named `X` exists in `site.pages` (for archived pages)
+ * or `site.fragments` (for archived fragments).
+ *
+ * Symmetric to `referenced-fragment-exists` — both check that a
+ * reference has a target. The difference: this validator checks the
+ * archive's own aliasOf field, not the components list.
+ *
+ * # Why error
+ *
+ * An archived page with `aliasOf: 'missing'` would render `301 →
+ * /missing`, which then 404s. An archived fragment aliasing
+ * `@missing` would fail to compose at render time. Both are broken
+ * states; the publish gate must block.
+ *
+ * # Save-delta path
+ *
+ * When the saved manifest is itself archived with aliasOf, validate.
+ * When the saved manifest is live (not archived), no-op — only
+ * archives can be dangling.
+ *
+ * # SOLID
+ *
+ *   - SRP: one check; doesn't overlap with circular-alias (P3) or
+ *     aliasOf-points-to-archived (P5).
+ *   - DIP: consumes Site; no extra I/O.
+ */
+import type { Validator } from '../types.js';
+export declare const danglingAlias: Validator;
+//# sourceMappingURL=dangling-alias.d.ts.map

package/dist/validation/validators/dangling-alias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dangling-alias.d.ts","sourceRoot":"","sources":["../../../src/validation/validators/dangling-alias.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,KAAK,EAAS,SAAS,EAAkB,MAAM,aAAa,CAAA;AAEnE,eAAO,MAAM,aAAa,EAAE,SA8B3B,CAAA"}

package/dist/validation/validators/dangling-alias.js

@@ -0,0 +1,31 @@
+export const danglingAlias = {
+    source: 'gazetta',
+    name: 'dangling-alias',
+    stages: ['save-delta', 'background', 'pre-publish', 'cli'],
+    defaultSeverity() {
+        return 'error';
+    },
+    async validate(input) {
+        const { scope, site } = input;
+        if (scope.kind !== 'save-delta' && scope.kind !== 'background')
+            return [];
+        const manifest = scope.kind === 'save-delta' ? scope.after : scope.manifest;
+        if (manifest.archived !== true)
+            return [];
+        if (typeof manifest.aliasOf !== 'string' || manifest.aliasOf.length === 0)
+            return [];
+        const targetName = manifest.aliasOf;
+        const targetMap = scope.item.kind === 'page' ? site.pages : site.fragments;
+        if (targetMap.has(targetName))
+            return [];
+        return [
+            {
+                validator: 'dangling-alias',
+                severity: 'error',
+                message: `Aliased ${scope.item.kind} "${scope.item.name}" points to "${targetName}" which does not exist. The 301 redirect target is missing.`,
+                itemPath: scope.item.itemPath,
+            },
+        ];
+    },
+};
+//# sourceMappingURL=dangling-alias.js.map

package/dist/validation/validators/dangling-alias.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dangling-alias.js","sourceRoot":"","sources":["../../../src/validation/validators/dangling-alias.ts"],"names":[],"mappings":"AAqCA,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,gBAAgB;IACtB,MAAM,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,CAAU;IAEnE,eAAe;QACb,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAqB;QAClC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;QAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO,EAAE,CAAA;QACzE,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAA;QAE3E,IAAI,QAAQ,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO,EAAE,CAAA;QACzC,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAA;QAEpF,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAA;QACnC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAA;QAC1E,IAAI,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,OAAO,EAAE,CAAA;QAExC,OAAO;YACL;gBACE,SAAS,EAAE,gBAAgB;gBAC3B,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,gBAAgB,UAAU,6DAA6D;gBAC9I,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;aAC9B;SACF,CAAA;IACH,CAAC;CACF,CAAA"}

package/dist/validation/validators/deploy-target-type-supported.d.ts

@@ -0,0 +1,3 @@
+import type { Validator } from '../types.js';
+export declare const deployTargetTypeSupported: Validator;
+//# sourceMappingURL=deploy-target-type-supported.d.ts.map

package/dist/validation/validators/deploy-target-type-supported.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-target-type-supported.d.ts","sourceRoot":"","sources":["../../../src/validation/validators/deploy-target-type-supported.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAS,SAAS,EAAkB,MAAM,aAAa,CAAA;AAEnE,eAAO,MAAM,yBAAyB,EAAE,SAkCvC,CAAA"}

package/dist/validation/validators/deploy-target-type-supported.js

@@ -0,0 +1,32 @@
+export const deployTargetTypeSupported = {
+    source: 'gazetta',
+    name: 'deploy-target-type-supported',
+    stages: ['cli'],
+    defaultSeverity() {
+        return 'error';
+    },
+    async validate(input) {
+        const { scope, site } = input;
+        if (scope.kind !== 'cli')
+            return [];
+        const targets = (site.manifest.targets ?? {});
+        const issues = [];
+        for (const [name, target] of Object.entries(targets)) {
+            const deploy = target.deploy;
+            if (!deploy)
+                continue; // no adapter → no compatibility to check
+            const targetType = target.type ?? 'static'; // default per TargetConfig
+            if (deploy.supports.includes(targetType))
+                continue;
+            issues.push({
+                validator: 'deploy-target-type-supported',
+                severity: 'error',
+                message: `Target "${name}" has type: "${targetType}" but deploy adapter "${deploy.name}" supports only [${deploy.supports.map(s => `"${s}"`).join(', ')}]. ` +
+                    `Either switch to a compatible adapter or change target type.`,
+                itemPath: `site.config.ts:targets.${name}.deploy`,
+            });
+        }
+        return issues;
+    },
+};
+//# sourceMappingURL=deploy-target-type-supported.js.map

package/dist/validation/validators/deploy-target-type-supported.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-target-type-supported.js","sourceRoot":"","sources":["../../../src/validation/validators/deploy-target-type-supported.ts"],"names":[],"mappings":"AAgCA,MAAM,CAAC,MAAM,yBAAyB,GAAc;IAClD,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,8BAA8B;IACpC,MAAM,EAAE,CAAC,KAAK,CAAU;IAExB,eAAe;QACb,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAqB;QAClC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;QAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;YAAE,OAAO,EAAE,CAAA;QAEnC,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAiC,CAAA;QAC7E,MAAM,MAAM,GAAY,EAAE,CAAA;QAE1B,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACrD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;YAC5B,IAAI,CAAC,MAAM;gBAAE,SAAQ,CAAC,yCAAyC;YAC/D,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,IAAI,QAAQ,CAAA,CAAC,2BAA2B;YACtE,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAAE,SAAQ;YAElD,MAAM,CAAC,IAAI,CAAC;gBACV,SAAS,EAAE,8BAA8B;gBACzC,QAAQ,EAAE,OAAO;gBACjB,OAAO,EACL,WAAW,IAAI,gBAAgB,UAAU,yBAAyB,MAAM,CAAC,IAAI,oBAAoB,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;oBACnJ,8DAA8D;gBAChE,QAAQ,EAAE,0BAA0B,IAAI,SAAS;aAClD,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAA"}

package/dist/validation/validators/dynamic-route-conflict.d.ts

@@ -0,0 +1,18 @@
+import type { Validator } from '../types.js';
+/**
+ * Detect dynamic route ambiguity between pages.
+ *
+ * Two routes conflict when one's static path would match the other's dynamic
+ * pattern. Examples:
+ *   - `/blog/hello` (static) and `/blog/:slug` (dynamic) — both match `/blog/hello`
+ *   - `/:catch-all` and any static page — overshadows everything
+ *
+ * Save-delta scope: only flags conflicts INTRODUCED by the save (the saved
+ * manifest's route conflicts with an existing page's route). Pre-existing
+ * conflicts between two unaffected pages are caught by the background scanner
+ * (Cut 2), not save-delta.
+ *
+ * Only fires for pages.
+ */
+export declare const dynamicRouteConflict: Validator;
+//# sourceMappingURL=dynamic-route-conflict.d.ts.map

package/dist/validation/validators/dynamic-route-conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-route-conflict.d.ts","sourceRoot":"","sources":["../../../src/validation/validators/dynamic-route-conflict.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAS,SAAS,EAAkB,MAAM,aAAa,CAAA;AAEnE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAgClC,CAAA"}

package/dist/validation/validators/dynamic-route-conflict.js

@@ -0,0 +1,80 @@
+/**
+ * Detect dynamic route ambiguity between pages.
+ *
+ * Two routes conflict when one's static path would match the other's dynamic
+ * pattern. Examples:
+ *   - `/blog/hello` (static) and `/blog/:slug` (dynamic) — both match `/blog/hello`
+ *   - `/:catch-all` and any static page — overshadows everything
+ *
+ * Save-delta scope: only flags conflicts INTRODUCED by the save (the saved
+ * manifest's route conflicts with an existing page's route). Pre-existing
+ * conflicts between two unaffected pages are caught by the background scanner
+ * (Cut 2), not save-delta.
+ *
+ * Only fires for pages.
+ */
+export const dynamicRouteConflict = {
+    source: 'gazetta',
+    name: 'dynamic-route-conflict',
+    stages: ['save-delta', 'background', 'pre-publish', 'cli'],
+    defaultSeverity() {
+        return 'error';
+    },
+    async validate(input) {
+        const { scope, site } = input;
+        if (scope.kind !== 'save-delta' && scope.kind !== 'background')
+            return [];
+        if (scope.item.kind !== 'page')
+            return [];
+        const manifest = scope.kind === 'save-delta' ? scope.after : scope.manifest;
+        const newRoute = manifest.route;
+        if (!newRoute)
+            return [];
+        const issues = [];
+        for (const [otherName, other] of site.pages) {
+            if (otherName === scope.item.name)
+                continue; // skip self
+            if (routesConflict(newRoute, other.route)) {
+                issues.push({
+                    validator: 'dynamic-route-conflict',
+                    severity: 'error',
+                    message: `Route "${newRoute}" conflicts with existing page "${otherName}" (route "${other.route}").`,
+                    itemPath: scope.item.itemPath,
+                });
+            }
+        }
+        return issues;
+    },
+};
+/**
+ * Two routes conflict if they could both match the same incoming request path.
+ *
+ * Compares segment-by-segment:
+ *   - Same length required (no wildcard catch-all in current routing)
+ *   - Two static segments must match exactly
+ *   - One static + one dynamic (`:param`) is a conflict (the static would shadow the dynamic, ambiguity in author intent)
+ *   - Two dynamic segments (regardless of name) match the same set of paths — also a conflict
+ */
+function routesConflict(a, b) {
+    if (a === b)
+        return true;
+    const ap = a.split('/').filter(Boolean);
+    const bp = b.split('/').filter(Boolean);
+    if (ap.length !== bp.length)
+        return false;
+    for (let i = 0; i < ap.length; i++) {
+        const aSeg = ap[i];
+        const bSeg = bp[i];
+        const aDyn = aSeg.startsWith(':');
+        const bDyn = bSeg.startsWith(':');
+        if (!aDyn && !bDyn) {
+            // Two static segments must match exactly to compete.
+            if (aSeg !== bSeg)
+                return false;
+        }
+        // static-vs-dynamic and dynamic-vs-dynamic both potentially match same paths,
+        // continue checking remaining segments
+    }
+    return true;
+}
+//# sourceMappingURL=dynamic-route-conflict.js.map

package/dist/validation/validators/dynamic-route-conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-route-conflict.js","sourceRoot":"","sources":["../../../src/validation/validators/dynamic-route-conflict.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAc;IAC7C,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,wBAAwB;IAC9B,MAAM,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,CAAU;IAEnE,eAAe;QACb,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAqB;QAClC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;QAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO,EAAE,CAAA;QACzE,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,EAAE,CAAA;QACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAA;QAE3E,MAAM,QAAQ,GAAI,QAAyB,CAAC,KAAK,CAAA;QACjD,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAA;QAExB,MAAM,MAAM,GAAY,EAAE,CAAA;QAC1B,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5C,IAAI,SAAS,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI;gBAAE,SAAQ,CAAC,YAAY;YACxD,IAAI,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1C,MAAM,CAAC,IAAI,CAAC;oBACV,SAAS,EAAE,wBAAwB;oBACnC,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,UAAU,QAAQ,mCAAmC,SAAS,aAAa,KAAK,CAAC,KAAK,KAAK;oBACpG,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;iBAC9B,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAA;AAED;;;;;;;;GAQG;AACH,SAAS,cAAc,CAAC,CAAS,EAAE,CAAS;IAC1C,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACxB,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACvC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACvC,IAAI,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;QAClB,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACnB,qDAAqD;YACrD,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAA;QACjC,CAAC;QACD,8EAA8E;QAC9E,uCAAuC;IACzC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/validation/validators/html-validity.d.ts

@@ -0,0 +1,3 @@
+import type { Validator } from '../types.js';
+export declare const htmlValidity: Validator;
+//# sourceMappingURL=html-validity.d.ts.map

package/dist/validation/validators/html-validity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-validity.d.ts","sourceRoot":"","sources":["../../../src/validation/validators/html-validity.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAS,SAAS,EAAkB,MAAM,aAAa,CAAA;AAmBnE,eAAO,MAAM,YAAY,EAAE,SA4C1B,CAAA"}

package/dist/validation/validators/html-validity.js

@@ -0,0 +1,89 @@
+/**
+ * html-validity validator (Validation Cut 3).
+ *
+ * Runs html-validate (https://html-validate.org/) against the rendered output
+ * of each page, surfacing structural HTML problems: missing required
+ * attributes, mis-nesting, unclosed tags, deprecated elements.
+ *
+ * Stages: background + pre-publish + cli (NOT save-delta — depends on
+ * rendered output, which save-delta doesn't have access to). Pre-publish
+ * promotes warns to errors via the standard severity-promotion mechanism;
+ * background surfaces them as warns to keep accumulated debt non-blocking.
+ *
+ * Rendered output is supplied via `input.renderedOutput` (Cut 3 contract).
+ * When `renderedOutput` is absent (e.g., a save-delta scope or a setup that
+ * doesn't render), the validator returns no issues — it can't analyze HTML
+ * it doesn't have.
+ *
+ * # SOLID lenses
+ *
+ * - SRP: this validator owns the HTML-validity check. Render-for-analysis
+ *   produces the bytes; the validator consumes them.
+ * - DIP: depends on `RenderedOutputAccess` interface, not the renderer.
+ * - OCP: html-validate's rule set is configurable; future operator-tunable
+ *   rule subsets ship via per-site config without changing this file.
+ */
+import { HtmlValidate } from 'html-validate';
+let cachedValidator = null;
+function getValidator() {
+    if (!cachedValidator) {
+        cachedValidator = new HtmlValidate({
+            extends: ['html-validate:recommended'],
+            // Rules that fire too often on Gazetta-rendered output without adding
+            // value. Kept narrow; expand only when concrete operator demand surfaces.
+            rules: {
+                // Allow dynamically inserted IDs (scoped CSS via hashPath).
+                'no-dup-id': 'error',
+            },
+        });
+    }
+    return cachedValidator;
+}
+export const htmlValidity = {
+    source: 'gazetta',
+    name: 'html-validity',
+    stages: ['background', 'pre-publish', 'cli'],
+    defaultSeverity(stage) {
+        return stage === 'pre-publish' ? 'error' : 'warn';
+    },
+    async validate(input) {
+        const { scope, renderedOutput } = input;
+        if (scope.kind !== 'background' && scope.kind !== 'pre-publish' && scope.kind !== 'cli')
+            return [];
+        if (!renderedOutput)
+            return [];
+        const items = scope.kind === 'background' ? [scope.item] : scope.kind === 'pre-publish' ? [...scope.items] : [];
+        if (scope.kind === 'cli')
+            return []; // CLI scope walks the site itself; rendered output is per-item
+        const issues = [];
+        const validator = getValidator();
+        for (const item of items) {
+            if (item.kind !== 'page')
+                continue; // fragments are partials, not full HTML
+            const html = await renderedOutput.htmlFor(item);
+            if (!html)
+                continue;
+            const report = await validator.validateString(html);
+            if (report.valid)
+                continue;
+            for (const result of report.results) {
+                for (const msg of result.messages) {
+                    issues.push({
+                        // Per design-validation.md "Stage × validator matrix":
+                        // html-validity is warn at every stage (including pre-publish).
+                        // Operators who want it to block publish opt into
+                        // publishAudit.strict on the destination target — strict
+                        // promotion in the publish-audit orchestrator turns warns
+                        // into errors. The validator itself stays uniformly warn.
+                        validator: 'html-validity',
+                        severity: msg.severity === 2 ? 'warn' : 'info',
+                        message: `${msg.ruleId}: ${msg.message} (line ${msg.line}, col ${msg.column})`,
+                        itemPath: item.itemPath,
+                    });
+                }
+            }
+        }
+        return issues;
+    },
+};
+//# sourceMappingURL=html-validity.js.map

package/dist/validation/validators/html-validity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-validity.js","sourceRoot":"","sources":["../../../src/validation/validators/html-validity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAG5C,IAAI,eAAe,GAAwB,IAAI,CAAA;AAE/C,SAAS,YAAY;IACnB,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,eAAe,GAAG,IAAI,YAAY,CAAC;YACjC,OAAO,EAAE,CAAC,2BAA2B,CAAC;YACtC,sEAAsE;YACtE,0EAA0E;YAC1E,KAAK,EAAE;gBACL,4DAA4D;gBAC5D,WAAW,EAAE,OAAO;aACrB;SACF,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,eAAe,CAAA;AACxB,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAc;IACrC,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,eAAe;IACrB,MAAM,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,KAAK,CAAU;IAErD,eAAe,CAAC,KAAK;QACnB,OAAO,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAA;IACnD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAqB;QAClC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,KAAK,CAAA;QACvC,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;YAAE,OAAO,EAAE,CAAA;QAClG,IAAI,CAAC,cAAc;YAAE,OAAO,EAAE,CAAA;QAE9B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC/G,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;YAAE,OAAO,EAAE,CAAA,CAAC,+DAA+D;QAEnG,MAAM,MAAM,GAAY,EAAE,CAAA;QAC1B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAA;QAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;gBAAE,SAAQ,CAAC,wCAAwC;YAC3E,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YAC/C,IAAI,CAAC,IAAI;gBAAE,SAAQ;YACnB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;YACnD,IAAI,MAAM,CAAC,KAAK;gBAAE,SAAQ;YAC1B,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBAClC,MAAM,CAAC,IAAI,CAAC;wBACV,uDAAuD;wBACvD,gEAAgE;wBAChE,kDAAkD;wBAClD,yDAAyD;wBACzD,0DAA0D;wBAC1D,0DAA0D;wBAC1D,SAAS,EAAE,eAAe;wBAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;wBAC9C,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,OAAO,UAAU,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,MAAM,GAAG;wBAC9E,QAAQ,EAAE,IAAI,CAAC,QAAQ;qBACxB,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAA"}

package/dist/validation/validators/orphaned-locale-file.d.ts

@@ -0,0 +1,21 @@
+import type { Validator } from '../types.js';
+/**
+ * Detect locale-variant manifests whose locale isn't supported by the site.
+ *
+ * Concrete cases this catches:
+ *   - `page.fr.json` exists but site config omits `fr` from `locales.supported`
+ *     (typo, removed locale, or copy-paste leftover)
+ *   - Same for `fragment.{loc}.json`
+ *
+ * Doesn't flag missing-default — `page.json` (default locale) absence with
+ * `page.fr.json` present means "French-only page," which is valid (per
+ * `design-i18n.md` "Edge cases" — French-only pages are allowed).
+ *
+ * Background scope only — orphan-locale is a site-wide property of the file
+ * tree; save-delta on `page.fr.json` already runs the standard ref validators
+ * against the saved variant.
+ *
+ * Issues surface on the orphaned variant file itself.
+ */
+export declare const orphanedLocaleFile: Validator;
+//# sourceMappingURL=orphaned-locale-file.d.ts.map

package/dist/validation/validators/orphaned-locale-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphaned-locale-file.d.ts","sourceRoot":"","sources":["../../../src/validation/validators/orphaned-locale-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,SAAS,EAAkB,MAAM,aAAa,CAAA;AAGnE;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB,EAAE,SA8DhC,CAAA"}

package/dist/validation/validators/orphaned-locale-file.js

@@ -0,0 +1,84 @@
+import { resolveSiteLocales } from '../../locale.js';
+/**
+ * Detect locale-variant manifests whose locale isn't supported by the site.
+ *
+ * Concrete cases this catches:
+ *   - `page.fr.json` exists but site config omits `fr` from `locales.supported`
+ *     (typo, removed locale, or copy-paste leftover)
+ *   - Same for `fragment.{loc}.json`
+ *
+ * Doesn't flag missing-default — `page.json` (default locale) absence with
+ * `page.fr.json` present means "French-only page," which is valid (per
+ * `design-i18n.md` "Edge cases" — French-only pages are allowed).
+ *
+ * Background scope only — orphan-locale is a site-wide property of the file
+ * tree; save-delta on `page.fr.json` already runs the standard ref validators
+ * against the saved variant.
+ *
+ * Issues surface on the orphaned variant file itself.
+ */
+export const orphanedLocaleFile = {
+    source: 'gazetta',
+    name: 'orphaned-locale-file',
+    stages: ['background', 'cli'],
+    defaultSeverity() {
+        return 'warn';
+    },
+    async validate(input) {
+        const { scope, site } = input;
+        if (scope.kind !== 'background' && scope.kind !== 'cli')
+            return [];
+        const resolved = resolveSiteLocales(site.manifest);
+        if (!resolved)
+            return []; // single-locale site — no locale variants to check
+        const supported = new Set(resolved.supported);
+        if (scope.kind === 'background') {
+            // Per-item: only emit if THIS item's locale is unsupported.
+            const item = scope.item;
+            const variants = item.kind === 'page' ? site.pageLocales.get(item.name) : site.fragmentLocales.get(item.name);
+            if (!variants)
+                return [];
+            const issues = [];
+            for (const [locale, manifest] of variants.locales) {
+                if (supported.has(locale))
+                    continue;
+                const ext = item.kind === 'page' ? 'page' : 'fragment';
+                issues.push({
+                    validator: 'orphaned-locale-file',
+                    severity: 'warn',
+                    message: `Locale variant "${locale}" exists but is not in site.locales.supported. Add the locale to site.config.ts or remove the file.`,
+                    itemPath: `${manifest.dir}/${ext}.${locale}.json`,
+                });
+            }
+            return issues;
+        }
+        // CLI: enumerate every orphan across the site
+        const issues = [];
+        for (const [, entry] of site.pageLocales) {
+            for (const [locale, manifest] of entry.locales) {
+                if (supported.has(locale))
+                    continue;
+                issues.push({
+                    validator: 'orphaned-locale-file',
+                    severity: 'warn',
+                    message: `Locale variant "${locale}" exists but is not in site.locales.supported.`,
+                    itemPath: `${manifest.dir}/page.${locale}.json`,
+                });
+            }
+        }
+        for (const [, entry] of site.fragmentLocales) {
+            for (const [locale, manifest] of entry.locales) {
+                if (supported.has(locale))
+                    continue;
+                issues.push({
+                    validator: 'orphaned-locale-file',
+                    severity: 'warn',
+                    message: `Locale variant "${locale}" exists but is not in site.locales.supported.`,
+                    itemPath: `${manifest.dir}/fragment.${locale}.json`,
+                });
+            }
+        }
+        return issues;
+    },
+};
+//# sourceMappingURL=orphaned-locale-file.js.map