fritzkit 0.0.0-stage → 0.1.0

package/dist/cli/context.js

@@ -0,0 +1,139 @@
+/**
+ * Shared plumbing for the CLI verbs and the MCP tools: the injectable context, error
+ * classes with exit codes, error formatting, Fritzing path overrides and the
+ * <part> argument resolver (slug, part folder or .fzpz).
+ *
+ * Command code never writes to process.stdout directly: everything goes through the
+ * returned CommandResult (or ctx.out), so the MCP server's stdout stays pure JSON-RPC.
+ */
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+import { FritzingRunningError } from "../core/export/install.js";
+import { fritzingPaths, isFritzingRunning } from "../core/fritzing.js";
+import { SLUG_RE } from "../core/schema/part.js";
+import { listParts, PART_FILE, PartJsonError, resolveWorkspace } from "../core/workspace.js";
+export const EXIT_OK = 0;
+export const EXIT_ERROR = 1;
+export const EXIT_NOT_IMPLEMENTED = 2;
+export const EXIT_FRITZING_RUNNING = 3;
+export const SCHEMA_HINT = "run `fritzkit schema` for the format";
+export class CliError extends Error {
+    exitCode;
+    constructor(message, exitCode = EXIT_ERROR) {
+        super(message);
+        this.exitCode = exitCode;
+        this.name = "CliError";
+    }
+}
+export class NotImplementedError extends CliError {
+    constructor(message) {
+        super(message, EXIT_NOT_IMPLEMENTED);
+        this.name = "NotImplementedError";
+    }
+}
+/** Duck-typed ZodError check (works across zod copies). */
+export function isZodError(e) {
+    return (e instanceof Error &&
+        e.name === "ZodError" &&
+        Array.isArray(e.issues));
+}
+/** One line per zod issue ("  path: message") plus the schema hint. */
+export function formatZodIssues(issues) {
+    const lines = issues.map((i) => {
+        const path = i.path.map(String).join(".");
+        return `  ${path || "(root)"}: ${i.message}`;
+    });
+    return ["part.json does not match the fritzkit part schema:", ...lines, SCHEMA_HINT].join("\n");
+}
+/** Map any thrown value to an exit code and a human message. */
+export function describeError(e) {
+    if (e instanceof CliError)
+        return { exitCode: e.exitCode, message: e.message };
+    if (e instanceof FritzingRunningError) {
+        return { exitCode: EXIT_FRITZING_RUNNING, message: fritzingRunningMessage() };
+    }
+    if (isZodError(e))
+        return { exitCode: EXIT_ERROR, message: formatZodIssues(e.issues) };
+    if (e instanceof PartJsonError)
+        return { exitCode: EXIT_ERROR, message: e.message };
+    if (e instanceof Error)
+        return { exitCode: EXIT_ERROR, message: e.message };
+    return { exitCode: EXIT_ERROR, message: String(e) };
+}
+export function fritzingRunningMessage(action = "install") {
+    return (`Fritzing is running, so fritzkit will not ${action}. Fritzing scans its user parts ` +
+        `folder only at startup and would not see the change until it restarts. Close ` +
+        `Fritzing (File > Quit) and run the command again.`);
+}
+export function cwdOf(ctx) {
+    return ctx.cwd ?? process.cwd();
+}
+export function workspaceOf(ctx) {
+    return resolveWorkspace(ctx.workspace === undefined ? undefined : resolve(cwdOf(ctx), ctx.workspace), ctx.env);
+}
+export function isRunningOf(ctx) {
+    return ctx.isRunning ?? isFritzingRunning;
+}
+/**
+ * fritzingPaths(env) with test/CI overrides: FRITZKIT_FRITZING_USER_PARTS replaces the
+ * user parts folder, FRITZKIT_FRITZING_BINS the bins folder (my_parts.fzb inside it).
+ */
+export function fritzingPathsFor(env) {
+    const base = fritzingPaths(env);
+    const userPartsDir = env.FRITZKIT_FRITZING_USER_PARTS
+        ? resolve(env.FRITZKIT_FRITZING_USER_PARTS)
+        : base.userPartsDir;
+    const binsDir = env.FRITZKIT_FRITZING_BINS ? resolve(env.FRITZKIT_FRITZING_BINS) : base.binsDir;
+    return { ...base, userPartsDir, binsDir, myPartsBin: join(binsDir, "my_parts.fzb") };
+}
+/** "Unknown part" error that lists what the workspace holds. */
+export async function unknownPart(part, workspace) {
+    const parts = await listParts(workspace);
+    const have = parts.length > 0
+        ? `Parts in ${workspace}: ${parts.map((p) => p.slug).join(", ")}`
+        : `The workspace ${workspace} has no parts yet; create one with: fritzkit new <slug>`;
+    return new CliError(`unknown part "${part}". ${have}`);
+}
+/**
+ * Resolve a <part> argument: a slug in the workspace, a part folder (or its part.json),
+ * or a .fzpz file. Slugs win over same-named folders in the current directory.
+ */
+export async function resolveTarget(part, ctx) {
+    const workspace = workspaceOf(ctx);
+    if (SLUG_RE.test(part) && existsSync(join(workspace, part, PART_FILE))) {
+        return { kind: "dir", dir: join(workspace, part), slug: part };
+    }
+    const abs = resolve(cwdOf(ctx), part);
+    if (existsSync(abs)) {
+        const st = statSync(abs);
+        if (st.isFile() && /\.fzpz$/i.test(abs))
+            return { kind: "fzpz", path: abs, dir: dirname(abs) };
+        if (st.isFile() && basename(abs) === PART_FILE) {
+            return { kind: "dir", dir: dirname(abs), slug: basename(dirname(abs)) };
+        }
+        if (st.isDirectory() && existsSync(join(abs, PART_FILE))) {
+            return { kind: "dir", dir: abs, slug: basename(abs) };
+        }
+        if (st.isDirectory())
+            throw new CliError(`${abs} is a folder without a ${PART_FILE}`);
+        throw new CliError(`${abs} is neither a part folder, a ${PART_FILE} nor a .fzpz`);
+    }
+    if (/\.fzpz$/i.test(part))
+        throw new CliError(`no such file: ${abs}`);
+    throw await unknownPart(part, workspace);
+}
+/** Today's date (YYYY-MM-DD) unless the context fixes one. */
+export function dateOf(ctx) {
+    return ctx.date ?? new Date().toISOString().slice(0, 10);
+}
+/** package.json version (same relative path from src/cli and dist/cli). */
+export function cliVersion(url = new URL("../../package.json", import.meta.url)) {
+    try {
+        const pkg = JSON.parse(readFileSync(url, "utf8"));
+        return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/cli/context.js.map

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

package/dist/cli/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/main.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/** fritzkit CLI entry point (package.json bin). All logic lives in program.ts. */
+import { runCli } from "./program.js";
+process.exitCode = await runCli(process.argv.slice(2), {
+    out: (s) => process.stdout.write(s),
+    err: (s) => process.stderr.write(s),
+});
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AACA,kFAAkF;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACrD,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;CACpC,CAAC,CAAC"}

package/dist/cli/program.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The commander program behind `fritzkit`. buildProgram wires each verb to its handler in
+ * commands/*.ts; runCli parses argv, prints the result (text, or JSON with --json) and
+ * returns the exit code: 0 ok, 1 validation/usage error, 2 not implemented, 3 Fritzing
+ * running. Nothing here calls process.exit, so tests can drive it in-process.
+ */
+import { Command } from "commander";
+import { type CommandContext } from "./context.js";
+export interface CliIo {
+    /** stdout sink (receives whole chunks, newline included). */
+    out: (s: string) => void;
+    /** stderr sink. */
+    err: (s: string) => void;
+}
+/** Hook the `mcp` verb uses to start the stdio server (overridable in tests). */
+export type McpStarter = (ctx: CommandContext) => Promise<void>;
+export declare function buildProgram(io: CliIo, base: CommandContext, state: {
+    exitCode: number;
+}, startMcp?: McpStarter): Command;
+/** Parse user args (argv without node and the script) and run; resolves to the exit code. */
+export declare function runCli(argv: string[], io: CliIo, base?: CommandContext, startMcp?: McpStarter): Promise<number>;

package/dist/cli/program.js

@@ -0,0 +1,158 @@
+/**
+ * The commander program behind `fritzkit`. buildProgram wires each verb to its handler in
+ * commands/*.ts; runCli parses argv, prints the result (text, or JSON with --json) and
+ * returns the exit code: 0 ok, 1 validation/usage error, 2 not implemented, 3 Fritzing
+ * running. Nothing here calls process.exit, so tests can drive it in-process.
+ */
+import { Command, CommanderError, Option } from "commander";
+import { cliVersion, describeError, EXIT_ERROR, } from "./context.js";
+import { doctorCommand } from "./commands/doctor.js";
+import { exportCommand, installCommand } from "./commands/export.js";
+import { importKicadCommand } from "./commands/kicad.js";
+import { initCommand, listCommand, newCommand } from "./commands/parts.js";
+import { pruneCommand } from "./commands/prune.js";
+import { renderCommand } from "./commands/render.js";
+import { schemaCommand } from "./commands/schema.js";
+import { uiCommand } from "./commands/ui.js";
+import { validateCommand } from "./commands/validate.js";
+const defaultMcpStarter = async (ctx) => {
+    const { startStdioServer } = await import("../mcp/server.js");
+    await startStdioServer(ctx);
+};
+function wrap(data) {
+    return data !== null && typeof data === "object" && !Array.isArray(data)
+        ? data
+        : { data };
+}
+export function buildProgram(io, base, state, startMcp = defaultMcpStarter) {
+    const program = new Command();
+    program
+        .name("fritzkit")
+        .description("Compile a JSON part spec (part.json) into a Fritzing part (.fzpz)")
+        .version(cliVersion(), "-V, --version")
+        .option("--workspace <dir>", "parts workspace (default: $FRITZKIT_WORKSPACE or ~/fritzkit/parts)")
+        .option("--json", "machine-readable JSON output")
+        .showHelpAfterError()
+        .exitOverride()
+        .configureOutput({ writeOut: io.out, writeErr: io.err });
+    // Every verb's action: build the context, run the handler, print, record the exit code.
+    const run = (fn) => async (...args) => {
+        const cmd = args[args.length - 1];
+        const g = cmd.optsWithGlobals();
+        const ctx = { ...base };
+        if (g.workspace !== undefined)
+            ctx.workspace = g.workspace;
+        try {
+            const r = await fn(ctx, ...args.slice(0, -1));
+            if (g.json) {
+                io.out(JSON.stringify({ exitCode: r.exitCode, ...wrap(r.data) }, null, 2) + "\n");
+            }
+            else if (r.text) {
+                io.out(r.text + "\n");
+            }
+            state.exitCode = r.exitCode;
+        }
+        catch (e) {
+            const { exitCode, message } = describeError(e);
+            if (g.json)
+                io.out(JSON.stringify({ exitCode, error: message }, null, 2) + "\n");
+            else
+                io.err(`${message.startsWith("fritzkit") ? "" : "fritzkit: "}${message}\n`);
+            state.exitCode = exitCode;
+        }
+    };
+    program
+        .command("init")
+        .description("create the workspace folder and print its path")
+        .action(run((ctx) => initCommand(ctx)));
+    program
+        .command("new <slug>")
+        .description("create <workspace>/<slug>/part.json from the template")
+        .option("--title <title>", "part title (default: the slug)")
+        .action(run((ctx, slug, o) => newCommand(slug, o, ctx)));
+    program
+        .command("list")
+        .description("list the parts in the workspace")
+        .action(run((ctx) => listCommand(ctx)));
+    program
+        .command("validate <part>")
+        .description("check a part (slug, part folder or .fzpz): schema, compile, structure")
+        .option("--checker", "also run Fritzing's fzp checker (needs uv)")
+        .action(run((ctx, part, o) => validateCommand(part, o, ctx)));
+    program
+        .command("render <part>")
+        .description("write the view SVGs (default <partdir>/build/)")
+        .addOption(new Option("--view <view>", "view to render")
+        .choices(["breadboard", "schematic", "pcb", "icon", "all"])
+        .default("all"))
+        .option("--out <dir>", "output folder")
+        .option("--png", "also rasterise each SVG to PNG at 300 dpi")
+        .action(run((ctx, part, o) => renderCommand(part, o, ctx)));
+    program
+        .command("export <part>")
+        .description("compile and write <partdir>/<moduleId>.fzpz")
+        .option("--out <file>", "output .fzpz path")
+        .option("--install", "also install into Fritzing's user parts folder")
+        .option("--force", "export even when the validator reports errors")
+        .action(run((ctx, part, o) => exportCommand(part, o, ctx)));
+    program
+        .command("install <part>")
+        .description("export and install into Fritzing (same as export --install)")
+        .option("--out <file>", "output .fzpz path")
+        .option("--force", "install even when the validator reports errors")
+        .action(run((ctx, part, o) => installCommand(part, o, ctx)));
+    program
+        .command("prune <family-or-slug>")
+        .description("remove older installed versions of a part (dry run unless --yes)")
+        .option("--keep <moduleId>", "version to keep (default: the newest)")
+        .option("--yes", "actually delete")
+        .action(run((ctx, arg, o) => pruneCommand(arg, o, ctx)));
+    program
+        .command("doctor")
+        .description("check Node, Fritzing, uv, the fzp checker and sharp")
+        .action(run((ctx) => doctorCommand(ctx)));
+    program
+        .command("schema")
+        .description("print the part.json JSON Schema")
+        .option("--out <file>", "write it to a file instead")
+        .action(run((ctx, o) => schemaCommand(o, ctx)));
+    program
+        .command("import-kicad <file>")
+        .description("create a part folder from a KiCad .kicad_mod footprint")
+        .requiredOption("--slug <slug>", "slug of the new part")
+        .option("--title <title>", "part title (default: the footprint name)")
+        .action(run((ctx, file, o) => importKicadCommand(file, o, ctx)));
+    program
+        .command("mcp")
+        .description("start the fritzkit MCP server on stdio")
+        .action(async (_o, cmd) => {
+        const g = cmd.optsWithGlobals();
+        await startMcp(g.workspace !== undefined ? { ...base, workspace: g.workspace } : base);
+    });
+    program
+        .command("ui [part]")
+        .description("open the part editor in the browser (local server on 127.0.0.1)")
+        .option("--port <n>", "port to listen on (default 5173, or the next free one)")
+        .option("--no-open", "print the URL instead of opening the browser")
+        .action(run((ctx, part, o) => uiCommand(part, o, ctx)));
+    return program;
+}
+/** Parse user args (argv without node and the script) and run; resolves to the exit code. */
+export async function runCli(argv, io, base = { env: process.env }, startMcp) {
+    const state = { exitCode: 0 };
+    const program = buildProgram(io, base, state, startMcp);
+    if (argv.length === 0) {
+        program.outputHelp();
+        return EXIT_ERROR;
+    }
+    try {
+        await program.parseAsync(argv, { from: "user" });
+    }
+    catch (e) {
+        if (e instanceof CommanderError)
+            return e.exitCode === 0 ? 0 : EXIT_ERROR;
+        throw e;
+    }
+    return state.exitCode;
+}
+//# sourceMappingURL=program.js.map

package/dist/cli/program.js.map

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

package/dist/cli/raster.d.ts

@@ -0,0 +1,4 @@
+/** SVG -> PNG with sharp (loaded lazily so verbs that never rasterise start fast). */
+export declare const DEFAULT_DPI = 300;
+/** Rasterise an SVG whose root width/height are in inches at `dpi` pixels per inch. */
+export declare function svgToPng(svg: string, dpi?: number): Promise<Uint8Array>;

package/dist/cli/raster.js

@@ -0,0 +1,9 @@
+/** SVG -> PNG with sharp (loaded lazily so verbs that never rasterise start fast). */
+export const DEFAULT_DPI = 300;
+/** Rasterise an SVG whose root width/height are in inches at `dpi` pixels per inch. */
+export async function svgToPng(svg, dpi = DEFAULT_DPI) {
+    const { default: sharp } = await import("sharp");
+    const buf = await sharp(Buffer.from(svg, "utf8"), { density: dpi }).png().toBuffer();
+    return new Uint8Array(buf.buffer, buf.byteOffset, buf.length);
+}
+//# sourceMappingURL=raster.js.map

package/dist/cli/raster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raster.js","sourceRoot":"","sources":["../../src/cli/raster.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAE/B,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,MAAc,WAAW;IACnE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IACrF,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;AAChE,CAAC"}

package/dist/core/compile/breadboard-util.d.ts

@@ -0,0 +1,12 @@
+export declare class PathParseError extends Error {
+    constructor(message: string);
+}
+/**
+ * Scale every length in an SVG path by `factor` (e.g. mm -> mil). Works for absolute
+ * and relative M/L/H/V/C/S/Q/T/A/Z commands, including implicit repetitions and the
+ * compact arc-flag form ("a1 1 0 01 5 5"). Arc rotation and flags are not scaled.
+ * Output is normalised: one command letter per segment, numbers formatted with fmt.
+ */
+export declare function scalePath(d: string, factor: number): string;
+/** Darken a #RRGGBB colour by multiplying each channel by (1 - amount). */
+export declare function darkenHex(hex: string, amount?: number): string;

package/dist/core/compile/breadboard-util.js

@@ -0,0 +1,107 @@
+/**
+ * Small pure helpers for the breadboard renderer: an SVG path number scaler (part
+ * outlines are written in mm, the SVG is in mil) and a hex colour darkener.
+ */
+import { fmt } from "../units.js";
+/** Number of parameters each path command takes (per repetition). */
+const PARAM_COUNT = {
+    m: 2,
+    l: 2,
+    h: 1,
+    v: 1,
+    c: 6,
+    s: 4,
+    q: 4,
+    t: 2,
+    a: 7,
+    z: 0,
+};
+const NUMBER_RE = /^[-+]?(?:\d+\.?\d*|\.\d+)(?:[eE][-+]?\d+)?/;
+export class PathParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PathParseError";
+    }
+}
+/**
+ * Scale every length in an SVG path by `factor` (e.g. mm -> mil). Works for absolute
+ * and relative M/L/H/V/C/S/Q/T/A/Z commands, including implicit repetitions and the
+ * compact arc-flag form ("a1 1 0 01 5 5"). Arc rotation and flags are not scaled.
+ * Output is normalised: one command letter per segment, numbers formatted with fmt.
+ */
+export function scalePath(d, factor) {
+    let i = 0;
+    const n = d.length;
+    const skipSep = () => {
+        while (i < n && /[\s,]/.test(d[i]))
+            i++;
+    };
+    const readNumber = () => {
+        skipSep();
+        const m = NUMBER_RE.exec(d.slice(i));
+        if (!m)
+            throw new PathParseError(`expected a number at offset ${i} in path "${d}"`);
+        i += m[0].length;
+        return Number(m[0]);
+    };
+    const readFlag = () => {
+        skipSep();
+        const ch = d[i];
+        if (ch !== "0" && ch !== "1") {
+            throw new PathParseError(`expected an arc flag (0 or 1) at offset ${i} in path "${d}"`);
+        }
+        i++;
+        return ch;
+    };
+    const startsNumber = () => {
+        skipSep();
+        return i < n && /[-+.\d]/.test(d[i]);
+    };
+    const out = [];
+    skipSep();
+    while (i < n) {
+        const cmd = d[i];
+        const lower = cmd.toLowerCase();
+        const count = PARAM_COUNT[lower];
+        if (count === undefined) {
+            throw new PathParseError(`unknown path command "${cmd}" at offset ${i} in path "${d}"`);
+        }
+        i++;
+        if (count === 0) {
+            out.push(cmd);
+            skipSep();
+            continue;
+        }
+        let first = true;
+        do {
+            const params = [];
+            for (let k = 0; k < count; k++) {
+                if (lower === "a" && (k === 3 || k === 4))
+                    params.push(readFlag());
+                else if (lower === "a" && k === 2)
+                    params.push(fmt(readNumber()));
+                else
+                    params.push(fmt(readNumber() * factor));
+            }
+            // Implicit repetitions after M/m are line-tos; keep the explicit letter each time.
+            const letter = first ? cmd : lower === "m" ? (cmd === "M" ? "L" : "l") : cmd;
+            out.push(letter + params.join(" "));
+            first = false;
+        } while (startsNumber());
+        skipSep();
+    }
+    return out.join(" ");
+}
+/** Darken a #RRGGBB colour by multiplying each channel by (1 - amount). */
+export function darkenHex(hex, amount = 0.3) {
+    const m = /^#([0-9A-Fa-f]{6})$/.exec(hex);
+    if (!m)
+        throw new Error(`darkenHex: not a #RRGGBB colour: ${hex}`);
+    const v = parseInt(m[1], 16);
+    const ch = (shift) => {
+        const c = Math.round(((v >> shift) & 0xff) * (1 - amount));
+        return Math.max(0, Math.min(255, c)).toString(16).padStart(2, "0").toUpperCase();
+    };
+    return `#${ch(16)}${ch(8)}${ch(0)}`;
+}
+//# sourceMappingURL=breadboard-util.js.map

package/dist/core/compile/breadboard-util.js.map

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

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

@@ -0,0 +1,60 @@
+/**
+ * Breadboard view renderer (Fritzing house style).
+ *
+ * Coordinates: part frame mm -> canvas mm (toCanvas) -> mil (1 viewBox unit = 1 mil).
+ * Draw order: board, photo, silkscreen + components, header bodies, leads, pads/pins,
+ * labels, terminals. Attributes only (no CSS), font Noto Sans only, no tspans.
+ *
+ * Conventions:
+ * - Silkscreen rect xMm/yMm is the TOP-LEFT corner; circle xMm/yMm is the centre; text
+ *   xMm/yMm is the anchor point, yMm being the vertical CENTRE of the text.
+ * - Free-standing pins: the pad element is connectorNpin; a 1 mil connectorNterminal
+ *   sits at its centre.
+ * - Headers: one cell per pin in the core header style; connectorNpin is the inner pin
+ *   square (male), the hole (female) or the pad (castellated).
+ * - Leads follow the bendable-leg SVGs of the core library (LED-5mm-red-leg.svg and
+ *   friends): the connectorNpin element sits where the lead leaves the board (it
+ *   doubles as the solder blob) and the connectorNleg line runs from there to the free
+ *   end. Leads have no terminal.
+ */
+import { type ResolvedConnector, type ResolvedPart } from "../resolve.js";
+import { type Attrs } from "../svg.js";
+import type { RenderContext } from "./types.js";
+export declare const XLINK_NS = "http://www.w3.org/1999/xlink";
+/** Breadboard-only colours and sizes not (yet) in STYLE. */
+export declare const BB: {
+    readonly boardStrokeMil: 8;
+    readonly boardDarken: 0.3;
+    readonly mountHoleFill: "#000000";
+    readonly mountRingMil: 10;
+    readonly padStroke: "#8C8663";
+    readonly padStrokeMil: 6;
+    readonly padHole: "#1F1F1F";
+    readonly labelGapMm: 0.4;
+    readonly headerLabelScale: 0.8;
+    readonly minLabelPitchMm: 2;
+    /** Average glyph advance of Noto Sans caps/digits, in em (for label fitting). */
+    readonly charWidthEm: 0.6;
+    readonly minHeaderLabelMil: 20;
+};
+export interface ContentOptions {
+    /** false strips every id attribute (icon view). */
+    ids: boolean;
+}
+/**
+ * Font size for one header's labels. Horizontal rows put labels side by side one pitch
+ * apart, so the size shrinks (for the whole header, never below BB.minHeaderLabelMil)
+ * until the longest label fits in 90% of the pitch; vertical columns keep the default.
+ */
+export declare function headerLabelSize(group: ResolvedConnector[], orientation: "horizontal" | "vertical", pitchMil: number): number;
+/**
+ * The breadboard artwork as a list of elements, without the root svg or layer group.
+ * Shared by the breadboard view (ids on) and the icon view (ids off) so the icon is
+ * literally the same drawing, scaled.
+ */
+export declare function renderBreadboardContent(part: ResolvedPart, ctx: RenderContext, opts: ContentOptions): string[];
+/** Root namespace attributes: xlink only when a photo is embedded. */
+export declare function extraNamespaces(ctx: RenderContext): Attrs;
+/** Join elements one per line inside a group, indented two spaces. */
+export declare function group(id: string | undefined, children: string[], extra?: Attrs): string;
+export declare function renderBreadboard(part: ResolvedPart, ctx: RenderContext): string;