fritzkit 0.0.0-stage → 0.1.0

package/dist/core/compile/schematic.js

@@ -0,0 +1,240 @@
+import { el, FONT_SANS, svgRoot, text } from "../svg.js";
+import { milToMm } from "../units.js";
+import { STYLE } from "./style.js";
+const SIDE_ORDER = ["left", "right", "top", "bottom"];
+/** Default side for each role. Nothing goes on top unless spec.schematic.sides says so. */
+export const DEFAULT_SIDES = {
+    power: "left",
+    usb: "left",
+    enable: "left",
+    reset: "left",
+    io: "right",
+    analog: "right",
+    pwm: "right",
+    i2c: "right",
+    spi: "right",
+    uart: "right",
+    clock: "right",
+    other: "right",
+    nc: "right",
+    gnd: "bottom",
+};
+const S = STYLE.schematic;
+const GRID = S.gridMil;
+const PIN_LEN = S.pinLengthMil;
+/** Gap between the body edge and the start of a pin label. */
+const LABEL_INSET = 25;
+/** Minimum horizontal gap between the longest left label and the longest right label. */
+const LABEL_GAP = 60;
+const MIN_W_CELLS = 6;
+const MIN_H_CELLS = 3;
+const TITLE_MAX_CHARS = 16;
+/** Baseline shift (x font size) that vertically centres Noto Sans caps on a coordinate. */
+const BASELINE_SHIFT = 0.35;
+/**
+ * Width estimate for a run of Noto Sans text: 0.6 x font size per character. Used to
+ * size the body so labels never overflow; generous for a proportional font.
+ */
+export function estimateTextWidthMil(s, fontSizeMil) {
+    return s.length * fontSizeMil * 0.6;
+}
+const ceilGrid = (v) => Math.ceil(v / GRID - 1e-9) * GRID;
+/**
+ * Role -> side map after applying spec.schematic.sides. A role listed on a side goes
+ * there (sides are applied in the order left, right, top, bottom, so a role listed on
+ * two sides ends up on the later one); unlisted roles keep DEFAULT_SIDES.
+ */
+export function sideMap(overrides) {
+    const map = { ...DEFAULT_SIDES };
+    if (overrides) {
+        for (const side of SIDE_ORDER)
+            for (const role of overrides[side] ?? [])
+                map[role] = side;
+    }
+    return map;
+}
+/**
+ * Pick the title: spec.title if it fits maxWidth, else properties.mpn when it is short
+ * (<= 16 chars), else the first 16 chars + "..." (only when that is actually shorter
+ * than the title; a title of up to 19 chars is kept whole). needsWidth is the width the
+ * chosen short form needs (the body grows to fit it); 0 when the full title fits.
+ */
+export function chooseTitle(title, mpn, maxWidth) {
+    const fs = S.titleFontSizeMil;
+    if (estimateTextWidthMil(title, fs) <= maxWidth)
+        return { text: title, needsWidth: 0 };
+    let short;
+    if (mpn && mpn.length <= TITLE_MAX_CHARS)
+        short = mpn;
+    else
+        short = title.length > TITLE_MAX_CHARS + 3 ? `${title.slice(0, TITLE_MAX_CHARS)}...` : title;
+    return { text: short, needsWidth: estimateTextWidthMil(short, fs) };
+}
+/** Compute the whole symbol geometry (mils). Pure; exported for tests. */
+export function layoutSchematic(part) {
+    const map = sideMap(part.spec.schematic.sides);
+    const bySide = { left: [], right: [], top: [], bottom: [] };
+    for (const c of part.connectors)
+        bySide[map[c.role]].push(c);
+    const L = bySide.left.length;
+    const R = bySide.right.length;
+    const T = bySide.top.length;
+    const B = bySide.bottom.length;
+    const fs = S.fontSizeMil;
+    const maxW = (cs) => cs.reduce((m, c) => Math.max(m, estimateTextWidthMil(c.label || c.name, fs)), 0);
+    const maxL = maxW(bySide.left);
+    const maxR = maxW(bySide.right);
+    // Width: labels of both sides + gap, top/bottom pin counts, the minimum, then the title.
+    let w = Math.max(MIN_W_CELLS * GRID, (T + 1) * GRID, (B + 1) * GRID, ceilGrid((L ? LABEL_INSET + maxL : 0) + (R ? LABEL_INSET + maxR : 0) + (L && R ? LABEL_GAP : 0)));
+    const title = chooseTitle(part.spec.title, part.spec.properties["mpn"], w - 2 * LABEL_INSET);
+    w = Math.max(w, ceilGrid(title.needsWidth + 2 * LABEL_INSET));
+    // Height: vertical bands so the rotated top/bottom labels (inside the body) and the
+    // title never collide with the left/right label rows. With no top or bottom pins this
+    // is the plain (rows + 1) cells.
+    const topExt = T ? LABEL_INSET + maxW(bySide.top) : 0;
+    const botExt = B ? LABEL_INSET + maxW(bySide.bottom) : 0;
+    const tfs = S.titleFontSizeMil;
+    const titleBaseline = topExt + 15 + Math.round(tfs * 0.75);
+    const titleBottom = titleBaseline + Math.round(tfs * 0.25);
+    const n = Math.max(L, R);
+    let h;
+    let firstRow = GRID;
+    if (n > 0) {
+        firstRow = Math.max(GRID, ceilGrid(titleBottom + 0.4 * fs + 4));
+        const lastRow = firstRow + (n - 1) * GRID;
+        const bottomGap = Math.max(GRID, ceilGrid(botExt + 0.6 * fs + 4));
+        h = Math.max(MIN_H_CELLS * GRID, lastRow + bottomGap);
+    }
+    else {
+        h = Math.max(MIN_H_CELLS * GRID, ceilGrid(titleBottom + 10 + botExt));
+    }
+    const bx = L ? PIN_LEN : 0;
+    const by = T ? PIN_LEN : 0;
+    const widthMil = bx + w + (R ? PIN_LEN : 0);
+    const heightMil = by + h + (B ? PIN_LEN : 0);
+    const pins = [];
+    bySide.left.forEach((c, i) => {
+        const y = by + firstRow + i * GRID;
+        pins.push({ connector: c, side: "left", x1: bx, y1: y, x2: bx - PIN_LEN, y2: y });
+    });
+    bySide.right.forEach((c, i) => {
+        const y = by + firstRow + i * GRID;
+        pins.push({ connector: c, side: "right", x1: bx + w, y1: y, x2: bx + w + PIN_LEN, y2: y });
+    });
+    bySide.top.forEach((c, i) => {
+        const x = bx + (i + 1) * GRID;
+        pins.push({ connector: c, side: "top", x1: x, y1: by, x2: x, y2: by - PIN_LEN });
+    });
+    bySide.bottom.forEach((c, i) => {
+        const x = bx + (i + 1) * GRID;
+        pins.push({ connector: c, side: "bottom", x1: x, y1: by + h, x2: x, y2: by + h + PIN_LEN });
+    });
+    return {
+        widthMil,
+        heightMil,
+        body: { x: bx, y: by, w, h },
+        title: { text: title.text, x: bx + w / 2, y: by + titleBaseline },
+        pins,
+    };
+}
+function pinLabel(p) {
+    const fs = S.fontSizeMil;
+    const shift = Math.round(fs * BASELINE_SHIFT * 10) / 10;
+    const common = { "font-family": FONT_SANS, "font-size": fs, fill: S.body };
+    const label = p.connector.label || p.connector.name;
+    switch (p.side) {
+        case "left":
+            return text(label, {
+                x: p.x1 + LABEL_INSET,
+                y: p.y1 + shift,
+                ...common,
+                "text-anchor": "start",
+            });
+        case "right":
+            return text(label, {
+                x: p.x1 - LABEL_INSET,
+                y: p.y1 + shift,
+                ...common,
+                "text-anchor": "end",
+            });
+        case "bottom": {
+            // rotate(-90): the text runs upward from just inside the bottom edge.
+            const x = p.x1 + shift;
+            const y = p.y1 - LABEL_INSET;
+            return text(label, {
+                x,
+                y,
+                ...common,
+                "text-anchor": "start",
+                transform: `rotate(-90 ${x} ${y})`,
+            });
+        }
+        case "top": {
+            // rotate(-90) with anchor end: the text ends just inside the top edge.
+            const x = p.x1 + shift;
+            const y = p.y1 + LABEL_INSET;
+            return text(label, {
+                x,
+                y,
+                ...common,
+                "text-anchor": "end",
+                transform: `rotate(-90 ${x} ${y})`,
+            });
+        }
+    }
+}
+export function renderSchematic(part, _ctx) {
+    const lay = layoutSchematic(part);
+    const t = STYLE.terminalSizeMil;
+    // A body edge with no pins lies on the canvas edge; inset it by half the stroke so the
+    // stroke is not clipped to half width (Fritzing core symbols do the same). Edges with
+    // pins stay on the grid so the pins meet them.
+    const hs = S.bodyStrokeMil / 2;
+    const has = (side) => lay.pins.some((p) => p.side === side);
+    const x0 = lay.body.x + (has("left") ? 0 : hs);
+    const y0 = lay.body.y + (has("top") ? 0 : hs);
+    const x1 = lay.body.x + lay.body.w - (has("right") ? 0 : hs);
+    const y1 = lay.body.y + lay.body.h - (has("bottom") ? 0 : hs);
+    const items = [
+        el("rect", {
+            x: x0,
+            y: y0,
+            width: x1 - x0,
+            height: y1 - y0,
+            fill: S.bodyFill,
+            stroke: S.body,
+            "stroke-width": S.bodyStrokeMil,
+        }),
+        text(lay.title.text, {
+            x: lay.title.x,
+            y: lay.title.y,
+            "font-family": FONT_SANS,
+            "font-size": S.titleFontSizeMil,
+            fill: S.body,
+            "text-anchor": "middle",
+        }),
+    ];
+    for (const p of lay.pins) {
+        const c = p.connector;
+        items.push(el("line", {
+            id: c.svgId,
+            x1: p.x1,
+            y1: p.y1,
+            x2: p.x2,
+            y2: p.y2,
+            stroke: S.pin,
+            "stroke-width": S.pinStrokeMil,
+        }), el("rect", {
+            id: c.terminalId,
+            x: p.x2 - t / 2,
+            y: p.y2 - t / 2,
+            width: t,
+            height: t,
+            fill: S.pin,
+            stroke: "none",
+        }), pinLabel(p));
+    }
+    const group = `  <g id="schematic">\n${items.map((l) => `    ${l}`).join("\n")}\n  </g>`;
+    return svgRoot(milToMm(lay.widthMil), milToMm(lay.heightMil), [group]);
+}
+//# sourceMappingURL=schematic.js.map

package/dist/core/compile/schematic.js.map

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

package/dist/core/compile/style.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Fritzing house style (graphic standards + core templates). Keep every colour and
+ * dimension here so the renderers stay consistent and a style change is one edit.
+ * Dimensions in mils unless the name says Mm.
+ */
+export declare const STYLE: {
+    readonly legColor: "#8C8C8C";
+    readonly legWidthMil: 30;
+    readonly contactColor: "#9A916C";
+    readonly padHoleColor: "#000000";
+    readonly labelColor: "#E6E6E6";
+    readonly labelFontSizeMil: 50;
+    readonly silkFontSizeMil: 45;
+    readonly male: {
+        readonly body: "#404040";
+        readonly pinSquare: "#8D8C8C";
+        readonly center: "#8C8663";
+        readonly bevelTop: "#B8AF82";
+        readonly bevelRight: "#80795B";
+        readonly bevelBottom: "#5E5B43";
+        readonly bevelLeft: "#9A916C";
+    };
+    readonly female: {
+        readonly body: "#404040";
+        readonly hole: "#000000";
+        readonly bevelTop: "#2A2A29";
+        readonly bevelRight: "#474747";
+        readonly bevelBottom: "#595959";
+        readonly bevelLeft: "#373737";
+    };
+    readonly schematic: {
+        readonly body: "#000000";
+        readonly bodyFill: "#FFFFFF";
+        readonly bodyStrokeMil: 9.7;
+        readonly pin: "#555555";
+        readonly pinStrokeMil: 9.7;
+        readonly pinLengthMil: 100;
+        readonly fontSizeMil: 49;
+        readonly titleFontSizeMil: 59;
+        readonly gridMil: 100;
+    };
+    readonly pcb: {
+        readonly copper: "#F7BD13";
+        readonly silkscreen: "#000000";
+        readonly silkStrokeMil: 8;
+        readonly minRingMil: 20;
+        readonly minHoleMil: 40;
+    };
+    readonly terminalSizeMil: 1;
+};
+/** Default pin colours by role for the vector style breadboard pin labels. */
+export declare const ROLE_COLORS: Record<string, string>;

package/dist/core/compile/style.js

@@ -0,0 +1,72 @@
+/**
+ * Fritzing house style (graphic standards + core templates). Keep every colour and
+ * dimension here so the renderers stay consistent and a style change is one edit.
+ * Dimensions in mils unless the name says Mm.
+ */
+export const STYLE = {
+    // Breadboard view
+    legColor: "#8C8C8C",
+    legWidthMil: 30,
+    contactColor: "#9A916C",
+    padHoleColor: "#000000",
+    labelColor: "#E6E6E6",
+    labelFontSizeMil: 50, // ~5 pt at 1 mil units (Fritzing labels are 5 pt light grey)
+    silkFontSizeMil: 45,
+    male: {
+        body: "#404040",
+        pinSquare: "#8D8C8C",
+        center: "#8C8663",
+        bevelTop: "#B8AF82",
+        bevelRight: "#80795B",
+        bevelBottom: "#5E5B43",
+        bevelLeft: "#9A916C",
+    },
+    female: {
+        body: "#404040",
+        hole: "#000000",
+        bevelTop: "#2A2A29",
+        bevelRight: "#474747",
+        bevelBottom: "#595959",
+        bevelLeft: "#373737",
+    },
+    // Schematic view
+    schematic: {
+        body: "#000000",
+        bodyFill: "#FFFFFF",
+        bodyStrokeMil: 9.7,
+        pin: "#555555",
+        pinStrokeMil: 9.7,
+        pinLengthMil: 100,
+        fontSizeMil: 49, // pin labels
+        titleFontSizeMil: 59,
+        gridMil: 100,
+    },
+    // PCB view
+    pcb: {
+        copper: "#F7BD13",
+        silkscreen: "#000000",
+        silkStrokeMil: 8,
+        minRingMil: 20,
+        minHoleMil: 40,
+    },
+    // Terminal rect (must have non-zero size or Fritzing ignores it)
+    terminalSizeMil: 1,
+};
+/** Default pin colours by role for the vector style breadboard pin labels. */
+export const ROLE_COLORS = {
+    power: "#F2A6A1",
+    gnd: "#E6E6E6",
+    io: "#E6E6E6",
+    analog: "#E6E6E6",
+    pwm: "#E6E6E6",
+    i2c: "#E6E6E6",
+    spi: "#E6E6E6",
+    uart: "#E6E6E6",
+    usb: "#E6E6E6",
+    clock: "#E6E6E6",
+    reset: "#E6E6E6",
+    enable: "#E6E6E6",
+    nc: "#777777",
+    other: "#E6E6E6",
+};
+//# sourceMappingURL=style.js.map

package/dist/core/compile/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../../../src/core/compile/style.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,kBAAkB;IAClB,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,EAAE;IACf,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,SAAS;IACvB,UAAU,EAAE,SAAS;IACrB,gBAAgB,EAAE,EAAE,EAAE,6DAA6D;IACnF,eAAe,EAAE,EAAE;IACnB,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,SAAS;QACpB,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,SAAS;QACnB,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,SAAS;QACtB,SAAS,EAAE,SAAS;KACrB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,SAAS;QACnB,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,SAAS;QACtB,SAAS,EAAE,SAAS;KACrB;IACD,iBAAiB;IACjB,SAAS,EAAE;QACT,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,SAAS;QACnB,aAAa,EAAE,GAAG;QAClB,GAAG,EAAE,SAAS;QACd,YAAY,EAAE,GAAG;QACjB,YAAY,EAAE,GAAG;QACjB,WAAW,EAAE,EAAE,EAAE,aAAa;QAC9B,gBAAgB,EAAE,EAAE;QACpB,OAAO,EAAE,GAAG;KACb;IACD,WAAW;IACX,GAAG,EAAE;QACH,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,SAAS;QACrB,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,EAAE;QACd,UAAU,EAAE,EAAE;KACf;IACD,iEAAiE;IACjE,eAAe,EAAE,CAAC;CACV,CAAC;AAEX,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAA2B;IACjD,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,SAAS;IACd,EAAE,EAAE,SAAS;IACb,MAAM,EAAE,SAAS;IACjB,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,EAAE,EAAE,SAAS;IACb,KAAK,EAAE,SAAS;CACjB,CAAC"}

package/dist/core/compile/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Contracts between the compile orchestrator and the four view renderers plus the fzp
+ * builder. Renderers are pure: (ResolvedPart, RenderContext) -> SVG string.
+ */
+import type { PartIdentity } from "../identity.js";
+import type { ResolvedPart } from "../resolve.js";
+export type View = "breadboard" | "schematic" | "pcb" | "icon";
+export declare const VIEWS: readonly View[];
+/** A raster prepared by the image module for the photo artwork style. */
+export interface PreparedPhoto {
+    /** PNG bytes, already cropped/rotated/keyed, sized to cover the outline. */
+    png: Uint8Array;
+    widthPx: number;
+    heightPx: number;
+    /** Opacity to draw it with (from spec.artwork.photo.opacity). */
+    opacity: number;
+}
+export interface RenderContext {
+    identity: PartIdentity;
+    /** Present only when artwork.style is "photo" and the asset could be prepared. */
+    photo?: PreparedPhoto;
+    /** ISO date YYYY-MM-DD written into the fzp (fixed in tests for determinism). */
+    date: string;
+    /** fritzkit version string for the fzp <author>/<description> footer. */
+    generator: string;
+}
+export type ViewRenderer = (part: ResolvedPart, ctx: RenderContext) => string;
+export interface CompiledPart {
+    identity: PartIdentity;
+    resolved: ResolvedPart;
+    fzp: string;
+    svgs: Record<View, string>;
+    /** Flat zip entries in the order they are written. */
+    entries: {
+        name: string;
+        data: Uint8Array;
+    }[];
+    /** Notes for the user: e.g. "photo asset missing, fell back to vector". */
+    warnings: string[];
+}
+export interface CompileOptions {
+    date?: string;
+    generator?: string;
+    /** Assets referenced by the spec (photo). Keyed by the spec-relative path. */
+    assets?: Map<string, Uint8Array>;
+    /** Hook that turns the photo asset into a PreparedPhoto (async, uses sharp). */
+    preparePhoto?: (data: Uint8Array, spec: ResolvedPart["spec"]) => Promise<PreparedPhoto | undefined>;
+}
+/** Layer ids each view lists in the fzp. */
+export declare function layerIdsFor(view: View, hasTht: boolean): string[];

package/dist/core/compile/types.js

@@ -0,0 +1,15 @@
+export const VIEWS = ["breadboard", "schematic", "pcb", "icon"];
+/** Layer ids each view lists in the fzp. */
+export function layerIdsFor(view, hasTht) {
+    switch (view) {
+        case "breadboard":
+            return ["breadboard"];
+        case "schematic":
+            return ["schematic"];
+        case "pcb":
+            return hasTht ? ["copper0", "copper1", "silkscreen"] : ["copper1", "silkscreen"];
+        case "icon":
+            return ["icon"];
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/core/compile/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/compile/types.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,KAAK,GAAoB,CAAC,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,CAAU,CAAC;AA+C1F,4CAA4C;AAC5C,MAAM,UAAU,WAAW,CAAC,IAAU,EAAE,MAAe;IACrD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY;YACf,OAAO,CAAC,YAAY,CAAC,CAAC;QACxB,KAAK,WAAW;YACd,OAAO,CAAC,WAAW,CAAC,CAAC;QACvB,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACnF,KAAK,MAAM;YACT,OAAO,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,61 @@
+export interface BinInstance {
+    moduleIdRef: string;
+    modelIndex: number;
+    path: string;
+}
+export interface BinDocument {
+    xml: string;
+    instances: BinInstance[];
+}
+/**
+ * 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 declare const EMPTY_MY_PARTS_BIN: string;
+/** Lowest modelIndex handed out when the bin has no instances yet. */
+export declare const FIRST_MODEL_INDEX = 100000;
+/** How many `<bin>.bak-*` files to keep next to the bin. */
+export declare const MAX_BIN_BACKUPS = 10;
+/** Parse the `<instance>` elements of a bin document (in file order). */
+export declare function parseBinInstances(xml: string): BinInstance[];
+/** Read a bin file; a missing or empty file yields the minimal My Parts document. */
+export declare function readBin(path: string): Promise<BinDocument>;
+/** Next modelIndex: greater than every existing one, FIRST_MODEL_INDEX at minimum. */
+export declare function nextModelIndex(xml: string): number;
+/**
+ * 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 declare function binInstanceXml(inst: BinInstance, indentUnit?: string, baseIndent?: string, eol?: string): string;
+/**
+ * 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 declare function addBinInstance(xml: string, inst: {
+    moduleIdRef: string;
+    path: string;
+    modelIndex?: number;
+}): string;
+/**
+ * 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 declare function removeBinInstances(xml: string, predicate: (i: BinInstance) => boolean): string;
+/**
+ * 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 declare function backupBin(binPath: string, now?: () => Date): Promise<string | undefined>;
+/** Write a file atomically: write `<path>.tmp-<pid>` next to it, then rename over it. */
+export declare function writeFileAtomic(path: string, data: string | Uint8Array): Promise<void>;
+/**
+ * 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 declare function writeBin(binPath: string, xml: string, opts?: {
+    backup?: boolean;
+    now?: () => Date;
+}): Promise<string | undefined>;