fritzkit 0.0.0-stage → 0.1.1

package/dist/core/export/bin.js

@@ -0,0 +1,221 @@
+/**
+ * Fritzing bin files (.fzb), in particular the My Parts bin (my_parts.fzb).
+ *
+ * The edits are textual on purpose: Fritzing writes the bin with CRLF line endings, a
+ * 4-space indent and an odd `icon="Mine.png" >` root tag, and we keep every byte we do
+ * not need to touch. Instance shape (as Fritzing writes it in search.fzb):
+ *
+ *     <instance moduleIdRef="<moduleId>" modelIndex="<int>" path="<fzp path>">
+ *         <views/>
+ *     </instance>
+ */
+import { existsSync } from "node:fs";
+import { copyFile, mkdir, readdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+/**
+ * The minimal My Parts bin, byte for byte what Fritzing 1.0.7 ships on a fresh profile
+ * (CRLF, no BOM, note the space before `>` in the module tag).
+ */
+export const EMPTY_MY_PARTS_BIN = '<?xml version="1.0" encoding="UTF-8"?>\r\n' +
+    '<module fritzingVersion="0.4.3b.0.0" icon="Mine.png" >\r\n' +
+    "    <title>My Parts</title>\r\n" +
+    "    <instances></instances>\r\n" +
+    "</module>\r\n";
+/** Lowest modelIndex handed out when the bin has no instances yet. */
+export const FIRST_MODEL_INDEX = 100000;
+/** How many `<bin>.bak-*` files to keep next to the bin. */
+export const MAX_BIN_BACKUPS = 10;
+const INSTANCE_SRC = String.raw `<instance\b[^>]*?(?:\/>|>[\s\S]*?<\/instance\s*>)`;
+const ATTR_RE = /([A-Za-z_][\w.-]*)\s*=\s*(?:"([^"]*)"|'([^']*)')/g;
+function unescapeXml(s) {
+    return s
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&amp;/g, "&");
+}
+function escapeXml(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+function instanceFromXml(instanceXml) {
+    const open = /^<instance\b([^>]*?)\/?>/.exec(instanceXml)?.[1] ?? "";
+    const a = {};
+    for (const m of open.matchAll(ATTR_RE)) {
+        a[m[1]] = unescapeXml(m[2] ?? m[3] ?? "");
+    }
+    return {
+        moduleIdRef: a.moduleIdRef ?? "",
+        modelIndex: Number.parseInt(a.modelIndex ?? "", 10),
+        path: a.path ?? "",
+    };
+}
+/** Parse the `<instance>` elements of a bin document (in file order). */
+export function parseBinInstances(xml) {
+    return [...xml.matchAll(new RegExp(INSTANCE_SRC, "g"))].map((m) => instanceFromXml(m[0]));
+}
+/** Read a bin file; a missing or empty file yields the minimal My Parts document. */
+export async function readBin(path) {
+    let xml = "";
+    if (existsSync(path))
+        xml = await readFile(path, "utf8");
+    if (xml.trim() === "")
+        xml = EMPTY_MY_PARTS_BIN;
+    return { xml, instances: parseBinInstances(xml) };
+}
+function eolOf(xml) {
+    return xml.includes("\r\n") ? "\r\n" : "\n";
+}
+/** Indent unit of the file: the leading whitespace of the first indented element line. */
+function indentUnitOf(xml) {
+    return /\n([ \t]+)</.exec(xml)?.[1] ?? "    ";
+}
+/** Next modelIndex: greater than every existing one, FIRST_MODEL_INDEX at minimum. */
+export function nextModelIndex(xml) {
+    let max = FIRST_MODEL_INDEX - 1;
+    for (const i of parseBinInstances(xml)) {
+        if (Number.isFinite(i.modelIndex) && i.modelIndex > max)
+            max = i.modelIndex;
+    }
+    return max + 1;
+}
+/**
+ * The exact XML of one instance. The first line carries no indent (the caller places
+ * it); the following lines are indented with baseIndent (+ indentUnit for `<views/>`).
+ */
+export function binInstanceXml(inst, indentUnit = "    ", baseIndent = "", eol = "\r\n") {
+    return (`<instance moduleIdRef="${escapeXml(inst.moduleIdRef)}" modelIndex="${inst.modelIndex}" ` +
+        `path="${escapeXml(inst.path)}">${eol}` +
+        `${baseIndent}${indentUnit}<views/>${eol}` +
+        `${baseIndent}</instance>`);
+}
+/**
+ * Append an instance just before `</instances>`, keeping the file's line endings and
+ * indentation. Returns the xml unchanged when moduleIdRef is already present. A missing
+ * modelIndex becomes nextModelIndex(xml).
+ */
+export function addBinInstance(xml, inst) {
+    if (xml.trim() === "")
+        xml = EMPTY_MY_PARTS_BIN;
+    if (parseBinInstances(xml).some((i) => i.moduleIdRef === inst.moduleIdRef))
+        return xml;
+    const eol = eolOf(xml);
+    const unit = indentUnitOf(xml);
+    const full = {
+        moduleIdRef: inst.moduleIdRef,
+        path: inst.path,
+        modelIndex: inst.modelIndex ?? nextModelIndex(xml),
+    };
+    const selfClosing = /([ \t]*)<instances\s*\/>/.exec(xml);
+    if (selfClosing) {
+        const outer = selfClosing[1] ?? "";
+        const inner = outer + unit;
+        const block = `${outer}<instances>${eol}${inner}${binInstanceXml(full, unit, inner, eol)}${eol}` +
+            `${outer}</instances>`;
+        return (xml.slice(0, selfClosing.index) + block + xml.slice(selfClosing.index + selfClosing[0].length));
+    }
+    const close = /<\/instances\s*>/.exec(xml);
+    if (!close)
+        throw new Error("bin file has no <instances> element");
+    const lineStart = xml.lastIndexOf("\n", close.index - 1) + 1;
+    const before = xml.slice(lineStart, close.index);
+    if (/^[ \t]*$/.test(before)) {
+        // `</instances>` on its own line: insert a new line above it.
+        const inner = before + unit;
+        const line = `${inner}${binInstanceXml(full, unit, inner, eol)}${eol}`;
+        return xml.slice(0, lineStart) + line + xml.slice(lineStart);
+    }
+    // Inline `<instances></instances>` (or content on the same line): break it open.
+    const outer = /^[ \t]*/.exec(before)?.[0] ?? "";
+    const inner = outer + unit;
+    const head = xml.slice(0, close.index).replace(/[ \t]+$/, "");
+    return (`${head}${eol}${inner}${binInstanceXml(full, unit, inner, eol)}${eol}${outer}` +
+        xml.slice(close.index));
+}
+/**
+ * Remove every instance for which predicate is true, together with its indentation and
+ * the line break before it. An instances element left holding only whitespace collapses
+ * to `<instances></instances>` (the shape of a fresh bin).
+ */
+export function removeBinInstances(xml, predicate) {
+    let changed = false;
+    const re = new RegExp(String.raw `(?:\r?\n)?[ \t]*(` + INSTANCE_SRC + ")", "g");
+    const out = xml.replace(re, (whole, inst) => {
+        if (!predicate(instanceFromXml(inst)))
+            return whole;
+        changed = true;
+        return "";
+    });
+    if (!changed)
+        return xml;
+    return out.replace(/<instances>\s*<\/instances>/, "<instances></instances>");
+}
+function stamp(d) {
+    const p = (n) => String(n).padStart(2, "0");
+    return (`${d.getFullYear()}${p(d.getMonth() + 1)}${p(d.getDate())}-` +
+        `${p(d.getHours())}${p(d.getMinutes())}${p(d.getSeconds())}`);
+}
+function escapeRe(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/** Order backup names by timestamp, then by numeric clash suffix. */
+function compareBackupNames(a, b) {
+    const key = (s) => {
+        const m = /\.bak-(\d{8}-\d{6})(?:-(\d+))?$/.exec(s);
+        return [m?.[1] ?? "", Number(m?.[2] ?? 0)];
+    };
+    const [ta, na] = key(a);
+    const [tb, nb] = key(b);
+    if (ta !== tb)
+        return ta < tb ? -1 : 1;
+    return na - nb;
+}
+/**
+ * Copy the bin to `<bin>.bak-YYYYMMDD-HHMMSS` (local time; `-N` suffix on a clash) and
+ * delete all but the MAX_BIN_BACKUPS newest backups. Returns undefined when there is no
+ * bin to back up yet.
+ */
+export async function backupBin(binPath, now = () => new Date()) {
+    if (!existsSync(binPath))
+        return undefined;
+    const base = `${binPath}.bak-${stamp(now())}`;
+    let target = base;
+    for (let n = 1; existsSync(target); n++)
+        target = `${base}-${n}`;
+    await copyFile(binPath, target);
+    const dir = dirname(binPath);
+    const re = new RegExp(`^${escapeRe(basename(binPath))}\\.bak-\\d{8}-\\d{6}(-\\d+)?$`);
+    const backups = (await readdir(dir))
+        .filter((f) => re.test(f))
+        .sort((a, b) => compareBackupNames(b, a));
+    for (const old of backups.slice(MAX_BIN_BACKUPS))
+        await rm(join(dir, old), { force: true });
+    return target;
+}
+/** Write a file atomically: write `<path>.tmp-<pid>` next to it, then rename over it. */
+export async function writeFileAtomic(path, data) {
+    await mkdir(dirname(path), { recursive: true });
+    const tmp = `${path}.tmp-${process.pid}`;
+    await writeFile(tmp, data);
+    try {
+        await rename(tmp, path);
+    }
+    catch (e) {
+        await rm(tmp, { force: true });
+        throw e;
+    }
+}
+/**
+ * Write new bin xml, backing the old file up first unless `backup` is false. Returns the
+ * backup path (undefined when no backup was taken or there was no old file).
+ */
+export async function writeBin(binPath, xml, opts = {}) {
+    const bak = opts.backup === false ? undefined : await backupBin(binPath, opts.now);
+    await writeFileAtomic(binPath, xml);
+    return bak;
+}
+//# sourceMappingURL=bin.js.map

package/dist/core/export/bin.js.map

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

package/dist/core/export/fzpz.d.ts

@@ -0,0 +1,37 @@
+import type { CompiledPart, View } from "../compile/types.js";
+export interface FzpzEntry {
+    name: string;
+    data: Uint8Array;
+}
+/**
+ * Entry mtime. fflate encodes DOS time from LOCAL date components, so build the date from
+ * local components too: every machine then writes 2026-01-01 00:00:00 whatever its zone.
+ * Built per call (not a module constant) so a TZ change inside the process cannot shift it.
+ */
+export declare const fzpzMtime: () => Date;
+export declare const FZPZ_LEVEL = 6;
+/** Zip entries (in the given order) into .fzpz bytes. Throws on bad or duplicate names. */
+export declare function buildFzpzBytes(entries: readonly FzpzEntry[]): Uint8Array;
+/** Write a compiled part as a .fzpz (atomically); returns the absolute output path. */
+export declare function writeFzpz(compiled: Pick<CompiledPart, "entries">, outPath: string): Promise<string>;
+export interface FzpInfo {
+    moduleId: string;
+    family?: string;
+    variant?: string;
+    title?: string;
+    version?: string;
+    /** `<layers image="...">` per view, exactly as written in the fzp. */
+    images: Partial<Record<View, string>>;
+}
+export interface FzpzContents extends FzpInfo {
+    entries: FzpzEntry[];
+    /** Name of the fzp entry, e.g. part.<moduleId>.fzp. */
+    fzpEntry: string;
+    fzp: string;
+}
+/** Pull moduleId, family/variant properties, title, version and layer images from an fzp. */
+export declare function parseFzpInfo(fzp: string): FzpInfo;
+/** Read a .fzpz from disk: entries in archive order plus the parsed fzp. */
+export declare function readFzpz(path: string): Promise<FzpzContents>;
+/** Same as readFzpz, from bytes. */
+export declare function parseFzpzBytes(bytes: Uint8Array): FzpzContents;

package/dist/core/export/fzpz.js

@@ -0,0 +1,121 @@
+/**
+ * .fzpz = a FLAT zip (no directories) holding `part.<moduleId>.fzp` plus one
+ * `svg.<view>.<base>_<view>.svg` per view (names from identity.fzpzEntryNames).
+ * Output is byte-deterministic: fixed compression level and a fixed entry mtime.
+ */
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { unzipSync, zipSync } from "fflate";
+import { XMLParser } from "fast-xml-parser";
+import { VIEWS } from "../compile/types.js";
+import { writeFileAtomic } from "./bin.js";
+/**
+ * Entry mtime. fflate encodes DOS time from LOCAL date components, so build the date from
+ * local components too: every machine then writes 2026-01-01 00:00:00 whatever its zone.
+ * Built per call (not a module constant) so a TZ change inside the process cannot shift it.
+ */
+export const fzpzMtime = () => new Date(2026, 0, 1, 0, 0, 0);
+export const FZPZ_LEVEL = 6;
+/** Zip entries (in the given order) into .fzpz bytes. Throws on bad or duplicate names. */
+export function buildFzpzBytes(entries) {
+    const files = {};
+    for (const e of entries) {
+        if (!e.name || /[/\\]/.test(e.name) || e.name === "." || e.name === "..") {
+            throw new Error(`invalid .fzpz entry name "${e.name}" (the archive must be flat)`);
+        }
+        if (Object.prototype.hasOwnProperty.call(files, e.name)) {
+            throw new Error(`duplicate .fzpz entry "${e.name}"`);
+        }
+        files[e.name] = [e.data, { level: FZPZ_LEVEL, mtime: fzpzMtime() }];
+    }
+    return zipSync(files);
+}
+/** Write a compiled part as a .fzpz (atomically); returns the absolute output path. */
+export async function writeFzpz(compiled, outPath) {
+    const abs = resolve(outPath);
+    await writeFileAtomic(abs, buildFzpzBytes(compiled.entries));
+    return abs;
+}
+const parser = new XMLParser({
+    ignoreAttributes: false,
+    attributeNamePrefix: "@_",
+    parseTagValue: false,
+    parseAttributeValue: false,
+    isArray: (name) => name === "property" || name === "layers",
+});
+function text(v) {
+    if (v == null)
+        return undefined;
+    if (typeof v === "string" || typeof v === "number")
+        return String(v).trim();
+    if (typeof v === "object" && "#text" in v) {
+        return String(v["#text"]).trim();
+    }
+    return undefined;
+}
+/** Pull moduleId, family/variant properties, title, version and layer images from an fzp. */
+export function parseFzpInfo(fzp) {
+    const doc = parser.parse(fzp);
+    const mod = doc.module;
+    const moduleId = mod?.["@_moduleId"];
+    if (!mod || typeof moduleId !== "string" || moduleId === "") {
+        throw new Error("fzp has no <module moduleId=...>");
+    }
+    const info = { moduleId, images: {} };
+    const props = mod.properties?.property;
+    for (const p of props ?? []) {
+        const name = String(p["@_name"] ?? "").toLowerCase();
+        const value = text(p);
+        if (name === "family" && value !== undefined)
+            info.family = value;
+        if (name === "variant" && value !== undefined)
+            info.variant = value;
+    }
+    const title = text(mod.title);
+    if (title !== undefined)
+        info.title = title;
+    const version = text(mod.version);
+    if (version !== undefined)
+        info.version = version;
+    const views = mod.views;
+    for (const view of VIEWS) {
+        const v = views?.[`${view}View`];
+        const layers = v?.layers;
+        const image = layers?.[0]?.["@_image"];
+        if (typeof image === "string")
+            info.images[view] = image;
+    }
+    return info;
+}
+/** Read a .fzpz from disk: entries in archive order plus the parsed fzp. */
+export async function readFzpz(path) {
+    const bytes = new Uint8Array(await readFile(path));
+    try {
+        return parseFzpzBytes(bytes);
+    }
+    catch (e) {
+        throw new Error(`${path}: ${e instanceof Error ? e.message : String(e)}`, { cause: e });
+    }
+}
+/** Same as readFzpz, from bytes. */
+export function parseFzpzBytes(bytes) {
+    let files;
+    try {
+        files = unzipSync(bytes);
+    }
+    catch (e) {
+        const why = e instanceof Error ? e.message : String(e);
+        throw new Error(`not a .fzpz: the file is not a readable zip archive (${why})`, { cause: e });
+    }
+    const entries = Object.entries(files)
+        .filter(([name]) => !name.endsWith("/"))
+        .map(([name, data]) => ({ name, data }));
+    const fzpEntries = entries.filter((e) => /\.fzp$/i.test(e.name));
+    if (fzpEntries.length !== 1) {
+        throw new Error(`.fzpz must hold exactly one .fzp, found ${fzpEntries.length}`);
+    }
+    const fzpEntry = fzpEntries[0];
+    const fzp = new TextDecoder().decode(fzpEntry.data);
+    return { ...parseFzpInfo(fzp), entries, fzpEntry: fzpEntry.name, fzp };
+}
+//# sourceMappingURL=fzpz.js.map

package/dist/core/export/fzpz.js.map

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

package/dist/core/export/index.d.ts

@@ -0,0 +1,5 @@
+/** Export (.fzpz), install into Fritzing's user parts folder, and prune old versions. */
+export * from "./bin.js";
+export * from "./fzpz.js";
+export * from "./install.js";
+export * from "./prune.js";

package/dist/core/export/index.js

@@ -0,0 +1,6 @@
+/** Export (.fzpz), install into Fritzing's user parts folder, and prune old versions. */
+export * from "./bin.js";
+export * from "./fzpz.js";
+export * from "./install.js";
+export * from "./prune.js";
+//# sourceMappingURL=index.js.map

package/dist/core/export/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/export/index.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/core/export/install.d.ts

@@ -0,0 +1,77 @@
+import { type FritzingPaths } from "../fritzing.js";
+import type { CompiledPart } from "../compile/types.js";
+import { type FzpzEntry } from "./fzpz.js";
+export declare class FritzingRunningError extends Error {
+    constructor(action?: string);
+}
+/**
+ * Throw unless moduleId is a safe single path segment (checked before any fs call). A
+ * trailing "." is refused because Windows strips it, so "x-12345678." would alias the
+ * folder "x-12345678".
+ */
+export declare function assertSafeModuleId(moduleId: string): void;
+/** Absolute dir of a part inside userPartsDir; throws if it would escape the folder. */
+export declare function partDirFor(userPartsDir: string, moduleId: string): string;
+export interface InstallLayout {
+    moduleId: string;
+    dir: string;
+    fzpPath: string;
+    /** zip entry name -> absolute install path */
+    files: Record<string, string>;
+    /** Entries Fritzing's own importer would not install either; they are not written. */
+    ignored: string[];
+}
+export declare function isSafeEntryName(name: string): boolean;
+/**
+ * Pure: where every entry goes. The folder name is the moduleId read from the fzp
+ * content; entry names map `part.X.fzp` -> `X.fzp` and `svg.<view>.Y.svg` -> `<view>/Y.svg`.
+ * Rejects any entry name with a path separator, `..` or other unsafe characters (a sign
+ * of a hostile archive). Other entries (readme, unknown view) are listed in `ignored` and
+ * not written: Fritzing's importer (moveToPartsFolder) likewise only copies part.* and
+ * the svg.* files the fzp references, and silently skips the rest.
+ */
+export declare function plannedInstallLayout(entries: readonly FzpzEntry[], paths: Pick<FritzingPaths, "userPartsDir">): InstallLayout;
+/**
+ * The `path` attribute written into the bin instance. Default: the absolute installed
+ * fzp path with forward slashes, verified on Fritzing 1.0.7b to make the part appear in
+ * My Parts after a restart. (search.fzb/core.fzb use the bare file name for core parts.)
+ */
+export declare function binInstancePath(fzpAbs: string, _moduleId: string): string;
+export interface InstallOptions {
+    paths?: FritzingPaths;
+    /** Install even while Fritzing is running. */
+    force?: boolean;
+    /** Add an instance to my_parts.fzb so the part shows in My Parts (default true). */
+    updateBin?: boolean;
+    /** Back the bin up before writing it (default true). */
+    backupBin?: boolean;
+    /** Compute and report, write nothing. */
+    dryRun?: boolean;
+    /** Injected for tests; defaults to isFritzingRunning. */
+    isRunning?: () => Promise<boolean>;
+    /** Injected for tests (backup file timestamp). */
+    now?: () => Date;
+    /** Bin `path` attribute; defaults to binInstancePath. */
+    instancePath?: (fzpAbs: string, moduleId: string) => string;
+}
+export interface InstallResult {
+    moduleId: string;
+    installedDir: string;
+    /** Absolute paths of the files written (or that would be written on a dry run). */
+    files: string[];
+    binPath: string;
+    binBackupPath?: string;
+    /** True when the folder already held this moduleId's fzp (re-install). */
+    alreadyInstalled: boolean;
+    /** Whether the bin gained (or would gain) an instance; false with updateBin: false. */
+    binUpdated: boolean;
+    /** Set when nothing was written, with the reason (e.g. "dry run"). */
+    skipped?: string;
+    /** Archive entries that were not installed (see plannedInstallLayout). */
+    ignoredEntries: string[];
+    /** Human-readable notes, e.g. one per ignored entry. */
+    warnings: string[];
+}
+/** Input: a .fzpz path or anything carrying the flat entries (a CompiledPart). */
+export type InstallSource = string | Pick<CompiledPart, "entries">;
+export declare function installPart(source: InstallSource, opts?: InstallOptions): Promise<InstallResult>;