@usecds/server 0.0.0-stage → 0.1.0

package/dist/core/storage-report.d.ts

@@ -0,0 +1,44 @@
+import { ObjectStore } from "../types.js";
+export interface StoredFile {
+    kind: "object" | "media";
+    hash: string;
+    file: string;
+    bytes: number | null;
+}
+export interface ReleaseDiff {
+    previousReleaseId: string;
+    added: string[];
+    removed: string[];
+    shared: number;
+}
+export interface ReleaseUsage {
+    releaseId: string;
+    channels: string[];
+    objects: number;
+    media: number;
+    bytes: number;
+    uniqueBytes: number;
+    missing: string[];
+    diff: ReleaseDiff | null;
+}
+export interface StorageReport {
+    releases: ReleaseUsage[];
+    channels: Record<string, {
+        releaseId: string;
+        retained: boolean;
+    }>;
+    totals: {
+        objects: number;
+        media: number;
+        bytes: number;
+    };
+    orphans: {
+        files: StoredFile[];
+        bytes: number;
+    };
+}
+/**
+ * Walks the store and reports per-release usage, release-to-release diffs,
+ * channel pointers and orphaned files. Read-only.
+ */
+export declare function analyzeStorage(store: ObjectStore): Promise<StorageReport>;

package/dist/core/storage-report.js

@@ -0,0 +1,112 @@
+/**
+ * Walks the store and reports per-release usage, release-to-release diffs,
+ * channel pointers and orphaned files. Read-only.
+ */
+export async function analyzeStorage(store) {
+    // 1. Inventory of stored files
+    const files = new Map(); // keyed by file path
+    const mediaFilesByHash = new Map();
+    for (const hash of await store.listObjects()) {
+        const file = `objects/${hash}.json`;
+        files.set(file, { kind: "object", hash, file, bytes: await store.objectSize(hash) });
+    }
+    for (const filename of await store.listMedia()) {
+        // Filename is <hash>.<ext>
+        const hash = filename.split(".")[0];
+        const file = `media/${filename}`;
+        files.set(file, { kind: "media", hash, file, bytes: await store.mediaSize(filename) });
+        mediaFilesByHash.set(hash, [...(mediaFilesByHash.get(hash) ?? []), file]);
+    }
+    // 2. Channel pointers
+    const channels = {};
+    const releaseIds = (await store.listReleases()).sort();
+    for (const channel of await store.listChannels()) {
+        const manifest = await store.readChannelManifest(channel);
+        if (manifest) {
+            channels[channel] = { releaseId: manifest.releaseId, retained: releaseIds.includes(manifest.releaseId) };
+        }
+    }
+    // 3. Files referenced by each retained release
+    const referencesByRelease = new Map();
+    for (const releaseId of releaseIds) {
+        const manifest = await store.readRelease(releaseId);
+        if (!manifest)
+            continue;
+        const referenced = new Set();
+        for (const col of Object.values(manifest.collections)) {
+            referenced.add(`objects/${col.hash}.json`);
+        }
+        for (const [virtualPath, med] of Object.entries(manifest.media)) {
+            const stored = mediaFilesByHash.get(med.hash);
+            if (stored) {
+                stored.forEach((f) => referenced.add(f));
+            }
+            else {
+                const ext = virtualPath.includes(".") ? virtualPath.substring(virtualPath.lastIndexOf(".")) : "";
+                referenced.add(`media/${med.hash}${ext}`);
+            }
+        }
+        referencesByRelease.set(releaseId, { files: referenced, manifest });
+    }
+    const referenceCount = new Map();
+    for (const { files: referenced } of referencesByRelease.values()) {
+        referenced.forEach((f) => referenceCount.set(f, (referenceCount.get(f) ?? 0) + 1));
+    }
+    // 4. Per-release usage and diff against the previous retained release
+    const releases = [];
+    let previous = null;
+    for (const [releaseId, { files: referenced }] of referencesByRelease) {
+        const usage = {
+            releaseId,
+            channels: Object.keys(channels).filter((c) => channels[c].releaseId === releaseId),
+            objects: 0,
+            media: 0,
+            bytes: 0,
+            uniqueBytes: 0,
+            missing: [],
+            diff: null
+        };
+        for (const file of referenced) {
+            const stored = files.get(file);
+            if (!stored || stored.bytes === null) {
+                usage.missing.push(file);
+                continue;
+            }
+            if (stored.kind === "object")
+                usage.objects++;
+            else
+                usage.media++;
+            usage.bytes += stored.bytes;
+            if (referenceCount.get(file) === 1)
+                usage.uniqueBytes += stored.bytes;
+        }
+        if (previous) {
+            const prevFiles = previous.files;
+            usage.diff = {
+                previousReleaseId: previous.releaseId,
+                added: [...referenced].filter((f) => !prevFiles.has(f)),
+                removed: [...prevFiles].filter((f) => !referenced.has(f)),
+                shared: [...referenced].filter((f) => prevFiles.has(f)).length
+            };
+        }
+        releases.push(usage);
+        previous = { releaseId, files: referenced };
+    }
+    // 5. Totals and orphans
+    const all = [...files.values()];
+    const orphanFiles = all.filter((f) => !referenceCount.has(f.file));
+    return {
+        releases,
+        channels,
+        totals: {
+            objects: all.filter((f) => f.kind === "object").length,
+            media: all.filter((f) => f.kind === "media").length,
+            bytes: sum(all)
+        },
+        orphans: { files: orphanFiles, bytes: sum(orphanFiles) }
+    };
+}
+function sum(files) {
+    return files.reduce((total, f) => total + (f.bytes ?? 0), 0);
+}
+//# sourceMappingURL=storage-report.js.map

package/dist/core/storage-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-report.js","sourceRoot":"","sources":["../../src/core/storage-report.ts"],"names":[],"mappings":"AAmCA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAkB;IACrD,+BAA+B;IAC/B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC,CAAC,qBAAqB;IAClE,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAoB,CAAC;IAErD,KAAK,MAAM,IAAI,IAAI,MAAM,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,WAAW,IAAI,OAAO,CAAC;QACpC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,KAAK,MAAM,QAAQ,IAAI,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;QAC/C,2BAA2B;QAC3B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,SAAS,QAAQ,EAAE,CAAC;QACjC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACvF,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,sBAAsB;IACtB,MAAM,QAAQ,GAA8B,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAG,CAAC,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,KAAK,MAAM,OAAO,IAAI,MAAM,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC1D,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3G,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAA6D,CAAC;IACjG,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACtD,UAAU,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC;QAC7C,CAAC;QACD,KAAK,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjG,UAAU,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QACD,mBAAmB,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,KAAK,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,mBAAmB,CAAC,MAAM,EAAE,EAAE,CAAC;QACjE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,sEAAsE;IACtE,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,IAAI,QAAQ,GAAqD,IAAI,CAAC;IACtE,KAAK,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,IAAI,mBAAmB,EAAE,CAAC;QACrE,MAAM,KAAK,GAAiB;YAC1B,SAAS;YACT,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC;YAClF,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,CAAC;YACd,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,IAAI;SACX,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBACrC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACzB,SAAS;YACX,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;gBAAE,KAAK,CAAC,OAAO,EAAE,CAAC;;gBACzC,KAAK,CAAC,KAAK,EAAE,CAAC;YACnB,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;YAC5B,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,KAAK,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK,CAAC;QACxE,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC;YACjC,KAAK,CAAC,IAAI,GAAG;gBACX,iBAAiB,EAAE,QAAQ,CAAC,SAAS;gBACrC,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACvD,OAAO,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACzD,MAAM,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM;aAC/D,CAAC;QACJ,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,QAAQ,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAC9C,CAAC;IAED,wBAAwB;IACxB,MAAM,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAChC,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACnE,OAAO;QACL,QAAQ;QACR,QAAQ;QACR,MAAM,EAAE;YACN,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,MAAM;YACtD,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,MAAM;YACnD,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC;SAChB;QACD,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,EAAE;KACzD,CAAC;AACJ,CAAC;AAED,SAAS,GAAG,CAAC,KAAmB;IAC9B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/core/targets.d.ts

@@ -0,0 +1,63 @@
+export declare const DEFAULT_TARGET_ID = "default";
+export declare const RECOMMENDED_MAX_TARGETS = 8;
+export interface CollectionRules {
+    localized?: object;
+    fields?: object;
+}
+export interface CollectionRequirements extends CollectionRules {
+    minItems?: number;
+    presets?: string[];
+}
+export interface MediaPreset {
+    aspect?: string;
+    fit?: "fill" | "fit";
+    widths: Record<string, number>;
+    formats?: ("avif" | "webp" | "jpeg" | "png")[];
+    quality?: number;
+    lossless?: boolean;
+    background?: string;
+}
+export interface TargetDefinition {
+    id: string;
+    scope?: string[];
+    locales?: {
+        required?: string[];
+        minCompleteness?: number;
+        maxStale?: number;
+    };
+    collections?: Record<string, CollectionRequirements>;
+    items?: {
+        collection: string;
+        key: string;
+    }[];
+    recommendations?: Record<string, CollectionRules>;
+    media?: {
+        breakpoints?: Record<string, number>;
+        dpr?: number[];
+        presets?: Record<string, MediaPreset>;
+    };
+}
+/**
+ * Used when no default target is provided.
+ */
+export declare const BUILTIN_DEFAULT_TARGET: TargetDefinition;
+export interface ResolvedTargets {
+    defaultTarget: TargetDefinition;
+    named: TargetDefinition[];
+    effective: Record<string, TargetDefinition>;
+    warnings: string[];
+}
+/**
+ * Loads all *.json target definitions from a folder. default.json is the default target.
+ */
+export declare function loadTargets(dir: string): Promise<TargetDefinition[]>;
+/**
+ * Validates the given definitions, picks the default target (built-in if none) and
+ * computes each named target's effective definition (default merged with its own).
+ */
+export declare function resolveTargets(definitions: TargetDefinition[]): ResolvedTargets;
+/**
+ * Additive merge: lists are combined, thresholds take the stricter value, schemas are
+ * combined with allOf (both must pass). Nothing is overwritten. Scope is the named target's own.
+ */
+export declare function mergeTargets(base: TargetDefinition, own: TargetDefinition): TargetDefinition;

package/dist/core/targets.js

@@ -0,0 +1,213 @@
+import fs from "fs/promises";
+import path from "path";
+import { deterministicStringify } from "../utils.js";
+import { validateTargetDefinition } from "../validation.js";
+export const DEFAULT_TARGET_ID = "default";
+export const RECOMMENDED_MAX_TARGETS = 8;
+/**
+ * Used when no default target is provided.
+ */
+export const BUILTIN_DEFAULT_TARGET = {
+    id: DEFAULT_TARGET_ID,
+    recommendations: {
+        _media: {
+            localized: {
+                type: "object",
+                required: ["alt", "description"],
+                properties: {
+                    alt: { type: "string", minLength: 1, maxLength: 125 },
+                    description: { type: "string", minLength: 50, maxLength: 300 }
+                }
+            }
+        },
+        _pages: {
+            localized: {
+                type: "object",
+                required: ["title", "description"],
+                properties: {
+                    title: { type: "string", minLength: 1, maxLength: 60 },
+                    description: { type: "string", minLength: 50, maxLength: 160 }
+                }
+            }
+        }
+    }
+};
+/**
+ * Loads all *.json target definitions from a folder. default.json is the default target.
+ */
+export async function loadTargets(dir) {
+    const files = (await fs.readdir(dir)).filter((f) => f.endsWith(".json")).sort();
+    const targets = [];
+    for (const file of files) {
+        const target = JSON.parse(await fs.readFile(path.join(dir, file), "utf-8"));
+        validateTargetDefinition(target);
+        const expectedDefault = file === `${DEFAULT_TARGET_ID}.json`;
+        if (expectedDefault !== (target.id === DEFAULT_TARGET_ID)) {
+            throw new Error(`Target file ${file}: only default.json may (and must) use the id "${DEFAULT_TARGET_ID}"`);
+        }
+        targets.push(target);
+    }
+    return targets;
+}
+/**
+ * Validates the given definitions, picks the default target (built-in if none) and
+ * computes each named target's effective definition (default merged with its own).
+ */
+export function resolveTargets(definitions) {
+    const warnings = [];
+    const seen = new Set();
+    for (const def of definitions) {
+        validateTargetDefinition(def);
+        if (seen.has(def.id))
+            throw new Error(`Duplicate target id: ${def.id}`);
+        seen.add(def.id);
+        if (def.id !== DEFAULT_TARGET_ID)
+            checkOwnScope(def);
+    }
+    const defaultTarget = definitions.find((d) => d.id === DEFAULT_TARGET_ID) ?? BUILTIN_DEFAULT_TARGET;
+    if (defaultTarget.scope) {
+        throw new Error(`The default target applies to everything and can't declare a scope`);
+    }
+    const named = definitions.filter((d) => d.id !== DEFAULT_TARGET_ID);
+    if (named.length > RECOMMENDED_MAX_TARGETS) {
+        warnings.push(`${named.length} named targets; the recommended maximum is ${RECOMMENDED_MAX_TARGETS}`);
+    }
+    checkPresetConflicts([defaultTarget, ...named]);
+    checkBreakpoints([defaultTarget, ...named]);
+    const effective = { [DEFAULT_TARGET_ID]: defaultTarget };
+    for (const target of named) {
+        effective[target.id] = mergeTargets(defaultTarget, target);
+    }
+    return { defaultTarget, named, effective, warnings };
+}
+/**
+ * Additive merge: lists are combined, thresholds take the stricter value, schemas are
+ * combined with allOf (both must pass). Nothing is overwritten. Scope is the named target's own.
+ */
+export function mergeTargets(base, own) {
+    const merged = { id: own.id };
+    if (own.scope)
+        merged.scope = [...own.scope];
+    const locales = {
+        required: union(base.locales?.required, own.locales?.required),
+        minCompleteness: stricter(base.locales?.minCompleteness, own.locales?.minCompleteness, Math.max),
+        maxStale: stricter(base.locales?.maxStale, own.locales?.maxStale, Math.min)
+    };
+    if (locales.required || locales.minCompleteness !== undefined || locales.maxStale !== undefined) {
+        merged.locales = dropUndefined(locales);
+    }
+    const collections = mergeRecords(base.collections, own.collections, (a, b) => dropUndefined({
+        minItems: stricter(a.minItems, b.minItems, Math.max),
+        localized: allOf(a.localized, b.localized),
+        fields: allOf(a.fields, b.fields),
+        presets: union(a.presets, b.presets)
+    }));
+    if (collections)
+        merged.collections = collections;
+    const items = unionBy([...(base.items ?? []), ...(own.items ?? [])], (i) => `${i.collection}\u0000${i.key}`);
+    if (items.length)
+        merged.items = items;
+    const recommendations = mergeRecords(base.recommendations, own.recommendations, (a, b) => dropUndefined({ localized: allOf(a.localized, b.localized), fields: allOf(a.fields, b.fields) }));
+    if (recommendations)
+        merged.recommendations = recommendations;
+    if (base.media || own.media) {
+        merged.media = dropUndefined({
+            breakpoints: base.media?.breakpoints || own.media?.breakpoints
+                ? { ...base.media?.breakpoints, ...own.media?.breakpoints }
+                : undefined,
+            dpr: union(base.media?.dpr, own.media?.dpr)?.sort((x, y) => x - y),
+            presets: base.media?.presets || own.media?.presets ? { ...base.media?.presets, ...own.media?.presets } : undefined
+        });
+    }
+    return merged;
+}
+// A named target's own requirements and recommendations must stay within its own scope
+function checkOwnScope(target) {
+    if (!target.scope)
+        return;
+    const scope = new Set(target.scope);
+    const outside = [
+        ...Object.keys(target.collections ?? {}),
+        ...Object.keys(target.recommendations ?? {}),
+        ...(target.items ?? []).map((i) => i.collection)
+    ].filter((c) => !scope.has(c));
+    if (outside.length) {
+        throw new Error(`Target ${target.id} declares rules outside its scope: ${[...new Set(outside)].join(", ")}`);
+    }
+}
+// All variants land in one release, so a preset name must mean the same thing in every target
+function checkPresetConflicts(targets) {
+    const presets = new Map();
+    for (const target of targets) {
+        for (const [name, preset] of Object.entries(target.media?.presets ?? {})) {
+            const definition = deterministicStringify(preset);
+            const existing = presets.get(name);
+            if (existing && existing.definition !== definition) {
+                throw new Error(`Preset "${name}" is defined differently in targets ${existing.target} and ${target.id}`);
+            }
+            presets.set(name, { target: target.id, definition });
+        }
+    }
+}
+// Breakpoints are shared like presets: one name, one width. Presets may only use declared breakpoints.
+function checkBreakpoints(targets) {
+    const widths = new Map();
+    for (const target of targets) {
+        for (const [name, minWidth] of Object.entries(target.media?.breakpoints ?? {})) {
+            const existing = widths.get(name);
+            if (existing && existing.minWidth !== minWidth) {
+                throw new Error(`Breakpoint "${name}" is defined differently in targets ${existing.target} and ${target.id}`);
+            }
+            widths.set(name, { target: target.id, minWidth });
+        }
+    }
+    for (const target of targets) {
+        for (const [presetName, preset] of Object.entries(target.media?.presets ?? {})) {
+            for (const breakpoint of Object.keys(preset.widths)) {
+                if (!widths.has(breakpoint)) {
+                    throw new Error(`Preset "${presetName}" in target ${target.id} uses unknown breakpoint "${breakpoint}"`);
+                }
+            }
+        }
+    }
+}
+function union(a, b) {
+    if (!a && !b)
+        return undefined;
+    return [...new Set([...(a ?? []), ...(b ?? [])])];
+}
+function unionBy(list, key) {
+    const map = new Map();
+    for (const item of list)
+        map.set(key(item), item);
+    return [...map.values()];
+}
+function stricter(a, b, pick) {
+    if (a === undefined)
+        return b;
+    if (b === undefined)
+        return a;
+    return pick(a, b);
+}
+function allOf(a, b) {
+    if (!a)
+        return b;
+    if (!b)
+        return a;
+    if (deterministicStringify(a) === deterministicStringify(b))
+        return a;
+    return { allOf: [a, b] };
+}
+function mergeRecords(a, b, merge) {
+    if (!a && !b)
+        return undefined;
+    const result = { ...a };
+    for (const [key, value] of Object.entries(b ?? {})) {
+        result[key] = key in result ? merge(result[key], value) : value;
+    }
+    return result;
+}
+function dropUndefined(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined));
+}
+//# sourceMappingURL=targets.js.map

package/dist/core/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../src/core/targets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAC3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AA0CzC;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAqB;IACtD,EAAE,EAAE,iBAAiB;IACrB,eAAe,EAAE;QACf,MAAM,EAAE;YACN,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC;gBAChC,UAAU,EAAE;oBACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;oBACrD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE;iBAC/D;aACF;SACF;QACD,MAAM,EAAE;YACN,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC;gBAClC,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;oBACtD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE;iBAC/D;aACF;SACF;KACF;CACF,CAAC;AASF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChF,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5E,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,eAAe,GAAG,IAAI,KAAK,GAAG,iBAAiB,OAAO,CAAC;QAC7D,IAAI,eAAe,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,iBAAiB,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,kDAAkD,iBAAiB,GAAG,CAAC,CAAC;QAC7G,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,WAA+B;IAC5D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,wBAAwB,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjB,IAAI,GAAG,CAAC,EAAE,KAAK,iBAAiB;YAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,iBAAiB,CAAC,IAAI,sBAAsB,CAAC;IACpG,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,iBAAiB,CAAC,CAAC;IACpE,IAAI,KAAK,CAAC,MAAM,GAAG,uBAAuB,EAAE,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,8CAA8C,uBAAuB,EAAE,CAAC,CAAC;IACxG,CAAC;IAED,oBAAoB,CAAC,CAAC,aAAa,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;IAChD,gBAAgB,CAAC,CAAC,aAAa,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;IAE5C,MAAM,SAAS,GAAqC,EAAE,CAAC,iBAAiB,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3F,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QAC3B,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAsB,EAAE,GAAqB;IACxE,MAAM,MAAM,GAAqB,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IAChD,IAAI,GAAG,CAAC,KAAK;QAAE,MAAM,CAAC,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;IAE7C,MAAM,OAAO,GAAG;QACd,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC9D,eAAe,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC;QAChG,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC;KAC5E,CAAC;IACF,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChG,MAAM,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC3E,aAAa,CAAC;QACZ,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC;QACpD,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC;QAC1C,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACjC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC;KACrC,CAAC,CACH,CAAC;IACF,IAAI,WAAW;QAAE,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC;IAElD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7G,IAAI,KAAK,CAAC,MAAM;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IAEvC,MAAM,eAAe,GAAG,YAAY,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACvF,aAAa,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CACjG,CAAC;IACF,IAAI,eAAe;QAAE,MAAM,CAAC,eAAe,GAAG,eAAe,CAAC;IAE9D,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC;YAC3B,WAAW,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,IAAI,GAAG,CAAC,KAAK,EAAE,WAAW;gBAC5D,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE;gBAC3D,CAAC,CAAC,SAAS;YACb,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;YAClE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;SACnH,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uFAAuF;AACvF,SAAS,aAAa,CAAC,MAAwB;IAC7C,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO;IAC1B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG;QACd,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;QACxC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC;QAC5C,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;KACjD,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,EAAE,sCAAsC,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/G,CAAC;AACH,CAAC;AAED,8FAA8F;AAC9F,SAAS,oBAAoB,CAAC,OAA2B;IACvD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkD,CAAC;IAC1E,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;YACzE,MAAM,UAAU,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;YAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,QAAQ,IAAI,QAAQ,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBACnD,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,uCAAuC,QAAQ,CAAC,MAAM,QAAQ,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5G,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;AACH,CAAC;AAED,uGAAuG;AACvG,SAAS,gBAAgB,CAAC,OAA2B;IACnD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgD,CAAC;IACvE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,IAAI,EAAE,CAAC,EAAE,CAAC;YAC/E,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,QAAQ,IAAI,QAAQ,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,uCAAuC,QAAQ,CAAC,MAAM,QAAQ,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YAChH,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;YAC/E,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC5B,MAAM,IAAI,KAAK,CAAC,WAAW,UAAU,eAAe,MAAM,CAAC,EAAE,6BAA6B,UAAU,GAAG,CAAC,CAAC;gBAC3G,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAI,CAAO,EAAE,CAAO;IAChC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,OAAO,CAAI,IAAS,EAAE,GAAwB;IACrD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAa,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,IAAI;QAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,QAAQ,CAAC,CAAqB,EAAE,CAAqB,EAAE,IAAsC;IACpG,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,KAAK,CAAC,CAAU,EAAE,CAAU;IACnC,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,IAAI,sBAAsB,CAAC,CAAC,CAAC,KAAK,sBAAsB,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACtE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,YAAY,CACnB,CAAgC,EAChC,CAAgC,EAChC,KAAwB;IAExB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,MAAM,GAAsB,EAAE,GAAG,CAAC,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAClE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAmB,GAAM;IAC7C,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAM,CAAC;AACzF,CAAC"}

package/dist/core/translations.d.ts

@@ -0,0 +1,41 @@
+import { CollectionItem, TranslationCounts, TranslationSummary } from "../types.js";
+export declare const DEFAULT_SOURCE_LOCALE = "en";
+export type SourceLocaleOrigin = "argument" | "source" | "inferred" | "fallback";
+export interface TranslationIssue {
+    collection: string;
+    id: string;
+    locale: string;
+    field: string;
+    issue: "missing" | "stale";
+}
+export interface TranslationReport extends TranslationSummary {
+    sourceLocaleOrigin: SourceLocaleOrigin;
+    collections: Record<string, Record<string, TranslationCounts>>;
+    itemsWithoutSource: {
+        collection: string;
+        id: string;
+    }[];
+    issues: TranslationIssue[];
+}
+/**
+ * Hash of a source text, as stored in _provenance translation markers (sourceHash).
+ */
+export declare function translationSourceHash(text: string): string;
+/**
+ * Infers the source locale from _provenance translation markers: the locales of fields marked
+ * "original" plus all "from" locales. Returns undefined unless exactly one candidate exists.
+ */
+export declare function inferSourceLocale(collections: Record<string, CollectionItem[]>): string | undefined;
+export type ItemLocales = (collection: string, item: CollectionItem) => string[] | undefined;
+/**
+ * Measures translation completeness against the source locale.
+ *
+ * - Expected: every source-locale field whose value is a non-empty string. Other source values are ignored.
+ * - Missing: the translation is absent, null or "".
+ * - Stale: the marker's sourceHash differs from the current source text. Without a sourceHash,
+ *   falls back to the previous release: source text changed but the translation didn't.
+ * - Items restricted by itemLocales are only measured in those locales, and skipped entirely
+ *   if they aren't used in the source locale (their texts are originals, not translations).
+ */
+export declare function analyzeTranslations(collections: Record<string, CollectionItem[]>, sourceLocale: string, sourceLocaleOrigin: SourceLocaleOrigin, previous?: Record<string, CollectionItem[]>, itemLocales?: ItemLocales): TranslationReport;
+export declare function toTranslationSummary(report: TranslationReport): TranslationSummary;

package/dist/core/translations.js

@@ -0,0 +1,125 @@
+import { sha256 } from "../utils.js";
+export const DEFAULT_SOURCE_LOCALE = "en";
+/**
+ * Hash of a source text, as stored in _provenance translation markers (sourceHash).
+ */
+export function translationSourceHash(text) {
+    return sha256(text);
+}
+/**
+ * Infers the source locale from _provenance translation markers: the locales of fields marked
+ * "original" plus all "from" locales. Returns undefined unless exactly one candidate exists.
+ */
+export function inferSourceLocale(collections) {
+    const candidates = new Set();
+    for (const items of Object.values(collections)) {
+        for (const item of items) {
+            for (const [locale, fields] of Object.entries(item._provenance?.translations ?? {})) {
+                for (const marker of Object.values(fields)) {
+                    if (marker.status === "original")
+                        candidates.add(locale);
+                    if (marker.from)
+                        candidates.add(marker.from);
+                }
+            }
+        }
+    }
+    return candidates.size === 1 ? [...candidates][0] : undefined;
+}
+const emptyCounts = () => ({ expected: 0, translated: 0, missing: 0, stale: 0, machine: 0 });
+function addCounts(target, add) {
+    target.expected += add.expected;
+    target.translated += add.translated;
+    target.missing += add.missing;
+    target.stale += add.stale;
+    target.machine += add.machine;
+}
+const isEmpty = (value) => value === undefined || value === null || value === "";
+/**
+ * Measures translation completeness against the source locale.
+ *
+ * - Expected: every source-locale field whose value is a non-empty string. Other source values are ignored.
+ * - Missing: the translation is absent, null or "".
+ * - Stale: the marker's sourceHash differs from the current source text. Without a sourceHash,
+ *   falls back to the previous release: source text changed but the translation didn't.
+ * - Items restricted by itemLocales are only measured in those locales, and skipped entirely
+ *   if they aren't used in the source locale (their texts are originals, not translations).
+ */
+export function analyzeTranslations(collections, sourceLocale, sourceLocaleOrigin, previous, itemLocales) {
+    const locales = new Set();
+    for (const items of Object.values(collections)) {
+        for (const item of items) {
+            Object.keys(item.translations).forEach((l) => locales.add(l));
+        }
+    }
+    locales.delete(sourceLocale);
+    const targetLocales = [...locales].sort();
+    const report = {
+        sourceLocale,
+        sourceLocaleOrigin,
+        locales: Object.fromEntries(targetLocales.map((l) => [l, emptyCounts()])),
+        overall: emptyCounts(),
+        collections: {},
+        itemsWithoutSource: [],
+        issues: []
+    };
+    for (const [collection, items] of Object.entries(collections)) {
+        const perLocale = Object.fromEntries(targetLocales.map((l) => [l, emptyCounts()]));
+        report.collections[collection] = perLocale;
+        const previousById = new Map((previous?.[collection] ?? []).map((i) => [i.id, i]));
+        for (const item of items) {
+            const usedIn = itemLocales?.(collection, item);
+            if (usedIn && !usedIn.includes(sourceLocale))
+                continue;
+            const sourceFields = item.translations[sourceLocale];
+            if (!sourceFields) {
+                report.itemsWithoutSource.push({ collection, id: item.id });
+                continue;
+            }
+            const prevItem = previousById.get(item.id);
+            for (const [field, sourceValue] of Object.entries(sourceFields)) {
+                if (typeof sourceValue !== "string" || sourceValue.length === 0)
+                    continue;
+                for (const locale of targetLocales) {
+                    if (usedIn && !usedIn.includes(locale))
+                        continue;
+                    const counts = perLocale[locale];
+                    counts.expected++;
+                    const value = item.translations[locale]?.[field];
+                    if (isEmpty(value)) {
+                        counts.missing++;
+                        report.issues.push({ collection, id: item.id, locale, field, issue: "missing" });
+                        continue;
+                    }
+                    counts.translated++;
+                    const marker = item._provenance?.translations?.[locale]?.[field];
+                    if (marker?.status === "machine")
+                        counts.machine++;
+                    let stale = false;
+                    if (marker?.sourceHash) {
+                        const reference = item.translations[marker.from ?? sourceLocale]?.[field];
+                        stale = typeof reference === "string" && translationSourceHash(reference) !== marker.sourceHash;
+                    }
+                    else if (prevItem) {
+                        const prevSource = prevItem.translations[sourceLocale]?.[field];
+                        const prevValue = prevItem.translations[locale]?.[field];
+                        stale = typeof prevSource === "string" && prevSource !== sourceValue && prevValue === value;
+                    }
+                    if (stale) {
+                        counts.stale++;
+                        report.issues.push({ collection, id: item.id, locale, field, issue: "stale" });
+                    }
+                }
+            }
+        }
+        for (const locale of targetLocales) {
+            addCounts(report.locales[locale], perLocale[locale]);
+            addCounts(report.overall, perLocale[locale]);
+        }
+    }
+    return report;
+}
+export function toTranslationSummary(report) {
+    return { sourceLocale: report.sourceLocale, locales: report.locales, overall: report.overall };
+}
+//# sourceMappingURL=translations.js.map

package/dist/core/translations.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export * from "./types.js";
+export * from "./utils.js";
+export * from "./validation.js";
+export { Publisher, PublisherConfig, PublishOptions, PublishArtifacts, PublishResult, PublishRequirementsError, GarbageCollectOptions, GarbageCollectResult } from "./core/publisher.js";
+export * from "./core/storage-report.js";
+export * from "./core/translations.js";
+export * from "./core/targets.js";
+export * from "./core/content-report.js";
+export * from "./core/media-metadata.js";
+export * from "./core/media-names.js";
+export * from "./core/jsonld.js";
+export * from "./core/site.js";
+export * from "./core/menu.js";
+export * from "./core/report.js";
+export * from "./core/content-types.js";
+export { FixtureSource } from "./sources/fixture.js";
+export { FilesystemStore } from "./storage/filesystem.js";