frameyard 0.8.0 → 0.9.0

package/dist/fonts/install.d.ts

@@ -0,0 +1,24 @@
+import type { FontFamily, FontFile, FontManifest } from "./types.js";
+export interface FontPayload {
+    /** Project-relative path below assets/fonts/<font-id>/. */
+    path: string;
+    bytes: Buffer;
+    /** License files may be refreshed while adding another face. */
+    overwrite?: boolean;
+}
+export interface InstallFontRecordOptions {
+    projectRoot: string;
+    manifest: FontManifest;
+    incoming: FontFamily;
+    payloads: FontPayload[];
+    force: boolean;
+}
+export interface InstallFontRecordResult {
+    manifest: FontManifest;
+    family: FontFamily;
+    replacedFiles: string[];
+}
+export declare function fontFaceKey(file: FontFile): string;
+/** Merges a family record, stages every payload, and publishes the manifest atomically. */
+export declare function installFontRecord(options: InstallFontRecordOptions): Promise<InstallFontRecordResult>;
+//# sourceMappingURL=install.d.ts.map

package/dist/fonts/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/fonts/install.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAEjF,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAElD;AAgHD,2FAA2F;AAC3F,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAuD3G"}

package/dist/fonts/install.js

@@ -0,0 +1,145 @@
+import { mkdir, rm, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { publishStagedFiles, temporaryPath } from "../assets/provenance.js";
+import { FrameyardError } from "../errors.js";
+import { fontAssetDirectory, fontManifestPath, resolveFontAssetPath, stageFontManifest } from "./manifest.js";
+import { parseFontManifest } from "./schema.js";
+export function fontFaceKey(file) {
+    return `${file.subset ?? ""}\0${file.style}\0${fontWeightKey(file.weight)}`;
+}
+function fontWeightKey(weight) {
+    return typeof weight === "number" ? String(weight) : `${weight.min}-${weight.max}`;
+}
+function sortManifest(manifest) {
+    const fonts = [...manifest.fonts]
+        .sort((left, right) => left.family.localeCompare(right.family))
+        .map((font) => ({
+        ...font,
+        files: [...font.files].sort((left, right) => left.path.localeCompare(right.path)),
+    }));
+    return { version: manifest.version, fonts };
+}
+function cloneManifest(manifest) {
+    return {
+        version: manifest.version,
+        fonts: manifest.fonts.map((font) => ({
+            ...font,
+            license: { ...font.license },
+            ...(font.axes !== undefined ? { axes: { ...font.axes } } : {}),
+            files: font.files.map((file) => ({ ...file, weight: file.weight })),
+        })),
+    };
+}
+function mergeFamily(manifest, incoming, force) {
+    const fonts = cloneManifest(manifest).fonts;
+    const existingIndex = fonts.findIndex((font) => font.id === incoming.id || font.family.toLocaleLowerCase("en-US") === incoming.family.toLocaleLowerCase("en-US"));
+    const existing = existingIndex === -1 ? undefined : fonts[existingIndex];
+    const replacedFiles = [];
+    if (existing === undefined) {
+        fonts.push(incoming);
+        return { manifest: { version: manifest.version, fonts }, family: incoming, replacedFiles };
+    }
+    const sameFamily = existing.id === incoming.id &&
+        existing.family.toLocaleLowerCase("en-US") === incoming.family.toLocaleLowerCase("en-US");
+    if (!sameFamily || existing.provider !== incoming.provider) {
+        if (!force) {
+            throw new FrameyardError("OUTPUT_EXISTS", `Font id "${incoming.id}" or family "${incoming.family}" is already installed as "${existing.provider}". Pass --force to replace it.`);
+        }
+        replacedFiles.push(...existing.files.map((file) => file.path));
+        fonts[existingIndex] = incoming;
+        return { manifest: { version: manifest.version, fonts }, family: incoming, replacedFiles };
+    }
+    const variableMismatch = (existing.variable === true) !== (incoming.variable === true);
+    if (variableMismatch) {
+        if (!force) {
+            throw new FrameyardError("OUTPUT_EXISTS", `Font "${existing.family}" is already installed as ${existing.variable === true ? "variable" : "static"}. Pass --force to replace it with ${incoming.variable === true ? "variable" : "static"} files.`);
+        }
+        replacedFiles.push(...existing.files.map((file) => file.path));
+        fonts[existingIndex] = incoming;
+        return { manifest: { version: manifest.version, fonts }, family: incoming, replacedFiles };
+    }
+    for (const file of incoming.files) {
+        const index = existing.files.findIndex((candidate) => fontFaceKey(candidate) === fontFaceKey(file));
+        if (index !== -1 && !force) {
+            throw new FrameyardError("OUTPUT_EXISTS", `Font face ${file.style} ${fontWeightKey(file.weight)} in subset "${file.subset ?? "default"}" is already installed for "${existing.family}". Pass --force to replace it.`);
+        }
+        if (index !== -1) {
+            const replaced = existing.files[index];
+            if (replaced !== undefined) {
+                replacedFiles.push(replaced.path);
+            }
+            existing.files[index] = file;
+        }
+        else {
+            existing.files.push(file);
+        }
+    }
+    existing.license = {
+        ...existing.license,
+        type: incoming.license.type === "unknown" && existing.license.type !== "unknown"
+            ? existing.license.type
+            : incoming.license.type,
+        ...(incoming.license.file !== undefined ? { file: incoming.license.file } : {}),
+        ...(incoming.license.attribution !== undefined ? { attribution: incoming.license.attribution } : {}),
+    };
+    if (incoming.variable === true) {
+        existing.variable = true;
+    }
+    if (incoming.axes !== undefined) {
+        existing.axes = { ...existing.axes, ...incoming.axes };
+    }
+    return { manifest: { version: manifest.version, fonts }, family: existing, replacedFiles };
+}
+/** Merges a family record, stages every payload, and publishes the manifest atomically. */
+export async function installFontRecord(options) {
+    const projectRoot = path.resolve(options.projectRoot);
+    const merged = mergeFamily(options.manifest, options.incoming, options.force);
+    const nextManifest = sortManifest(merged.manifest);
+    parseFontManifest(nextManifest);
+    const payloadByPath = new Map(options.payloads.map((payload) => [payload.path, payload]));
+    for (const file of options.incoming.files) {
+        if (!payloadByPath.has(file.path)) {
+            throw new FrameyardError("INTERNAL", `Missing staged payload for font file ${file.path}.`);
+        }
+    }
+    if (options.incoming.license.file !== undefined && !payloadByPath.has(options.incoming.license.file)) {
+        try {
+            await stat(resolveFontAssetPath(projectRoot, options.incoming.license.file));
+        }
+        catch {
+            throw new FrameyardError("INTERNAL", `Missing staged payload for license ${options.incoming.license.file}.`);
+        }
+    }
+    await mkdir(fontAssetDirectory(projectRoot, merged.family.id), { recursive: true });
+    const staged = [];
+    for (const payload of options.payloads) {
+        const absolute = resolveFontAssetPath(projectRoot, payload.path);
+        const tempPath = temporaryPath(absolute, "font-asset");
+        await writeFile(tempPath, payload.bytes);
+        staged.push({
+            tempPath,
+            path: absolute,
+            label: `font asset ${payload.path}`,
+            ...(payload.overwrite === true ? { overwrite: true } : {}),
+        });
+    }
+    const manifestTemp = await stageFontManifest(projectRoot, nextManifest);
+    staged.push({
+        tempPath: manifestTemp,
+        path: fontManifestPath(projectRoot),
+        label: "font manifest",
+        overwrite: true,
+    });
+    await publishStagedFiles(staged, { force: options.force });
+    for (const replaced of merged.replacedFiles) {
+        if (!merged.family.files.some((file) => file.path === replaced)) {
+            await rm(resolveFontAssetPath(projectRoot, replaced), { force: true });
+        }
+    }
+    return {
+        manifest: nextManifest,
+        family: nextManifest.fonts.find((font) => font.id === merged.family.id) ?? merged.family,
+        replacedFiles: merged.replacedFiles,
+    };
+}
+//# sourceMappingURL=install.js.map

package/dist/fonts/install.js.map

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

package/dist/fonts/manifest.d.ts

@@ -0,0 +1,21 @@
+import { type FontFamily, type FontManifest } from "./types.js";
+export declare function fontManifestPath(projectRoot: string): string;
+export declare function fontAssetDirectory(projectRoot: string, id: string): string;
+export declare function resolveFontAssetPath(projectRoot: string, relativePath: string): string;
+/** Reads and schema-validates the manifest. A missing manifest is not an error. */
+export declare function readFontManifest(projectRoot: string): Promise<FontManifest | undefined>;
+export declare function readFontManifestIfPresent(projectRoot: string): Promise<FontManifest>;
+/** Writes a validated manifest to a temporary sibling file for atomic publication. */
+export declare function stageFontManifest(projectRoot: string, manifest: FontManifest): Promise<string>;
+export interface FontManifestSummary {
+    fonts: number;
+    files: number;
+    bytes: number;
+}
+export declare function summarizeFontManifest(manifest: FontManifest | undefined): FontManifestSummary;
+export declare function uniqueFontValues(font: FontFamily): {
+    subsets: string[];
+    styles: string[];
+};
+export declare function fontManifestExists(projectRoot: string): Promise<boolean>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/fonts/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/fonts/manifest.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAOtF;AAED,mFAAmF;AACnF,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAsC7F;AAED,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAE1F;AAED,sFAAsF;AACtF,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAOpG;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,GAAG,mBAAmB,CAU7F;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAU1F;AAED,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM9E"}

package/dist/fonts/manifest.js

@@ -0,0 +1,96 @@
+import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { FrameyardError } from "../errors.js";
+import { temporaryPath } from "../assets/provenance.js";
+import { parseFontManifest } from "./schema.js";
+import { FONT_ASSET_PREFIX, FONT_MANIFEST_FILENAME, emptyFontManifest, } from "./types.js";
+export function fontManifestPath(projectRoot) {
+    return path.join(path.resolve(projectRoot), FONT_MANIFEST_FILENAME);
+}
+export function fontAssetDirectory(projectRoot, id) {
+    return path.join(path.resolve(projectRoot), FONT_ASSET_PREFIX, id);
+}
+export function resolveFontAssetPath(projectRoot, relativePath) {
+    const root = path.resolve(projectRoot);
+    const absolute = path.resolve(root, relativePath);
+    if (absolute !== root && !absolute.startsWith(root + path.sep)) {
+        throw new FrameyardError("FONT_MANIFEST_INVALID", `Font asset path escapes the project root: ${relativePath}`);
+    }
+    return absolute;
+}
+/** Reads and schema-validates the manifest. A missing manifest is not an error. */
+export async function readFontManifest(projectRoot) {
+    const manifestPath = fontManifestPath(projectRoot);
+    let text;
+    try {
+        text = await readFile(manifestPath, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return undefined;
+        }
+        throw new FrameyardError("FONT_MANIFEST_INVALID", `Could not read ${manifestPath}: ${error instanceof Error ? error.message : String(error)}`, { cause: error, details: { path: manifestPath } });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        throw new FrameyardError("FONT_MANIFEST_INVALID", `${manifestPath} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`, { cause: error, details: { path: manifestPath } });
+    }
+    try {
+        return parseFontManifest(parsed);
+    }
+    catch (error) {
+        if (error instanceof FrameyardError) {
+            throw new FrameyardError(error.code, `${manifestPath}: ${error.message}`, {
+                cause: error,
+                ...(error.details !== undefined ? { details: { path: manifestPath, ...error.details } } : {}),
+            });
+        }
+        throw error;
+    }
+}
+export async function readFontManifestIfPresent(projectRoot) {
+    return (await readFontManifest(projectRoot)) ?? emptyFontManifest();
+}
+/** Writes a validated manifest to a temporary sibling file for atomic publication. */
+export async function stageFontManifest(projectRoot, manifest) {
+    parseFontManifest(manifest);
+    const manifestPath = fontManifestPath(projectRoot);
+    await mkdir(path.dirname(manifestPath), { recursive: true });
+    const tempPath = temporaryPath(manifestPath, "fonts");
+    await writeFile(tempPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+    return tempPath;
+}
+export function summarizeFontManifest(manifest) {
+    let files = 0;
+    let bytes = 0;
+    for (const font of manifest?.fonts ?? []) {
+        files += font.files.length;
+        for (const file of font.files) {
+            bytes += file.bytes;
+        }
+    }
+    return { fonts: manifest?.fonts.length ?? 0, files, bytes };
+}
+export function uniqueFontValues(font) {
+    const subsets = new Set();
+    const styles = new Set();
+    for (const file of font.files) {
+        if (file.subset !== undefined) {
+            subsets.add(file.subset);
+        }
+        styles.add(file.style);
+    }
+    return { subsets: [...subsets].sort(), styles: [...styles].sort() };
+}
+export async function fontManifestExists(projectRoot) {
+    try {
+        return (await stat(fontManifestPath(projectRoot))).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/fonts/manifest.js.map

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

package/dist/fonts/options.d.ts

@@ -0,0 +1,9 @@
+import type { FontFormat, FontStyle, FontWeight } from "./types.js";
+export declare function fontSlug(family: string): string;
+export declare function parseFontWeight(value: string): FontWeight;
+export declare function parseFontStyle(value: string): FontStyle;
+export declare function fontFormatForPath(filePath: string): FontFormat;
+export declare function formatFontWeight(weight: FontWeight): string;
+export declare function fontFileStem(filePath: string): string;
+export declare function safeFontFileName(filePath: string): string;
+//# sourceMappingURL=options.d.ts.map

package/dist/fonts/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/fonts/options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAW/C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAczD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAKvD;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAc9D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAE3D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUzD"}

package/dist/fonts/options.js

@@ -0,0 +1,66 @@
+import { FrameyardError } from "../errors.js";
+export function fontSlug(family) {
+    const slug = family
+        .normalize("NFKD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    if (slug.length === 0) {
+        throw new FrameyardError("FONT_MANIFEST_INVALID", `Could not derive a font id from "${family}".`);
+    }
+    return slug;
+}
+export function parseFontWeight(value) {
+    const match = /^(\d+)(?:-(\d+))?$/.exec(value.trim());
+    if (!match) {
+        throw new FrameyardError("USAGE", `--weight must be a number or an inclusive range like 100-900; received "${value}".`);
+    }
+    const min = Number(match[1]);
+    const max = match[2] === undefined ? min : Number(match[2]);
+    if (!Number.isInteger(min) || !Number.isInteger(max) || min < 1 || max > 1000 || min > max) {
+        throw new FrameyardError("USAGE", `--weight must be between 1 and 1000 with min <= max; received "${value}".`);
+    }
+    return match[2] === undefined ? min : { min, max };
+}
+export function parseFontStyle(value) {
+    if (value === "normal" || value === "italic") {
+        return value;
+    }
+    throw new FrameyardError("USAGE", `--style must be "normal" or "italic"; received "${value}".`);
+}
+export function fontFormatForPath(filePath) {
+    const extension = filePath.slice(filePath.lastIndexOf(".")).toLowerCase();
+    switch (extension) {
+        case ".woff2":
+            return "woff2";
+        case ".woff":
+            return "woff";
+        case ".ttf":
+            return "ttf";
+        case ".otf":
+            return "otf";
+        default:
+            throw new FrameyardError("USAGE", "Font files must use a .woff2, .woff, .ttf, or .otf extension.");
+    }
+}
+export function formatFontWeight(weight) {
+    return typeof weight === "number" ? String(weight) : `${weight.min}-${weight.max}`;
+}
+export function fontFileStem(filePath) {
+    const name = filePath.split(/[\\/]/).pop() ?? "font";
+    const dot = name.lastIndexOf(".");
+    return dot === -1 ? name : name.slice(0, dot);
+}
+export function safeFontFileName(filePath) {
+    const name = filePath.split(/[\\/]/).pop() ?? "font";
+    const extension = name.slice(name.lastIndexOf(".")).toLowerCase();
+    const stem = fontFileStem(name)
+        .replace(/[^A-Za-z0-9._-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    if (stem.length === 0) {
+        throw new FrameyardError("USAGE", `Could not derive a safe destination name from "${filePath}".`);
+    }
+    return `${stem}${extension}`;
+}
+//# sourceMappingURL=options.js.map

package/dist/fonts/options.js.map

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

package/dist/fonts/schema.d.ts

@@ -0,0 +1,4 @@
+import { type FontManifest } from "./types.js";
+/** Parses and validates a `fy.fonts.json` document. */
+export declare function parseFontManifest(value: unknown): FontManifest;
+//# sourceMappingURL=schema.d.ts.map

package/dist/fonts/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/fonts/schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAQL,KAAK,YAAY,EAIlB,MAAM,YAAY,CAAC;AAsTpB,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAqC9D"}