fritzkit 0.0.0-stage → 0.1.1

package/dist/core/schema/part.d.ts

@@ -0,0 +1,995 @@
+/**
+ * part.json schema (zod). This is the single source of truth for the spec format; the
+ * published JSON Schema at src/core/schema/part.schema.json is generated from it
+ * (npm run gen-schema) and a test asserts the two stay in sync.
+ *
+ * Units: every length in the spec is millimetres. The compiler converts to mils
+ * (1 viewBox unit = 1 mil) when it emits SVG.
+ *
+ * Frame: the part's own coordinate system has its origin at the TOP-LEFT corner of
+ * the outline, x to the right (along widthMm) and y DOWN (along heightMm), i.e. the
+ * same orientation as a top-down reference photo. Pins may lie outside the outline
+ * (leads, overhanging headers); the compiler grows the canvas to fit them.
+ */
+import { z } from "zod";
+export declare const SLUG_RE: RegExp;
+export declare const KEY_RE: RegExp;
+export declare const COLOR_RE: RegExp;
+/** fzp connector type. female = a wire or plug attaches; male = a pin that plugs in. */
+export declare const ConnectorType: z.ZodEnum<{
+    male: "male";
+    female: "female";
+    pad: "pad";
+    wire: "wire";
+}>;
+export type ConnectorType = z.infer<typeof ConnectorType>;
+/** Electrical role; drives schematic grouping (D9) and default colours. */
+export declare const PinRole: z.ZodEnum<{
+    power: "power";
+    gnd: "gnd";
+    io: "io";
+    analog: "analog";
+    pwm: "pwm";
+    i2c: "i2c";
+    spi: "spi";
+    uart: "uart";
+    usb: "usb";
+    clock: "clock";
+    reset: "reset";
+    enable: "enable";
+    nc: "nc";
+    other: "other";
+}>;
+export type PinRole = z.infer<typeof PinRole>;
+export declare const PadShape: z.ZodEnum<{
+    rect: "rect";
+    round: "round";
+    oval: "oval";
+}>;
+export type PadShape = z.infer<typeof PadShape>;
+/** Copper geometry of one pad. holeMm absent or 0 = no hole (SMD, copper1 only). */
+export declare const PadGeometry: z.ZodObject<{
+    shape: z.ZodDefault<z.ZodEnum<{
+        rect: "rect";
+        round: "round";
+        oval: "oval";
+    }>>;
+    wMm: z.ZodNumber;
+    hMm: z.ZodNumber;
+    holeMm: z.ZodOptional<z.ZodNumber>;
+    smd: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type PadGeometry = z.infer<typeof PadGeometry>;
+/** A free-standing pin or solder pad at an arbitrary position (centre in mm). */
+export declare const Pin: z.ZodObject<{
+    type: z.ZodDefault<z.ZodEnum<{
+        male: "male";
+        female: "female";
+        pad: "pad";
+        wire: "wire";
+    }>>;
+    xMm: z.ZodNumber;
+    yMm: z.ZodNumber;
+    pad: z.ZodDefault<z.ZodObject<{
+        shape: z.ZodDefault<z.ZodEnum<{
+            rect: "rect";
+            round: "round";
+            oval: "oval";
+        }>>;
+        wMm: z.ZodNumber;
+        hMm: z.ZodNumber;
+        holeMm: z.ZodOptional<z.ZodNumber>;
+        smd: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    snap: z.ZodOptional<z.ZodBoolean>;
+    key: z.ZodString;
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    role: z.ZodDefault<z.ZodEnum<{
+        power: "power";
+        gnd: "gnd";
+        io: "io";
+        analog: "analog";
+        pwm: "pwm";
+        i2c: "i2c";
+        spi: "spi";
+        uart: "uart";
+        usb: "usb";
+        clock: "clock";
+        reset: "reset";
+        enable: "enable";
+        nc: "nc";
+        other: "other";
+    }>>;
+}, z.core.$strict>;
+export type Pin = z.infer<typeof Pin>;
+/** One pin inside a header; its position comes from the header grid. */
+export declare const HeaderPin: z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    role: z.ZodDefault<z.ZodEnum<{
+        power: "power";
+        gnd: "gnd";
+        io: "io";
+        analog: "analog";
+        pwm: "pwm";
+        i2c: "i2c";
+        spi: "spi";
+        uart: "uart";
+        usb: "usb";
+        clock: "clock";
+        reset: "reset";
+        enable: "enable";
+        nc: "nc";
+        other: "other";
+    }>>;
+}, z.core.$strict>;
+export type HeaderPin = z.infer<typeof HeaderPin>;
+/**
+ * A row/grid of 0.1 in (or other pitch) pins drawn in Fritzing's house style.
+ * xMm/yMm is the centre of the FIRST pin (row 0, col 0). Pins are listed row-major:
+ * row 0 col 0, row 0 col 1, ... A null entry leaves that position empty.
+ * The compiler places header pins exactly on multiples of 100 mil relative to the
+ * canvas origin so the part seats in a breadboard.
+ */
+export declare const Header: z.ZodObject<{
+    key: z.ZodString;
+    kind: z.ZodDefault<z.ZodEnum<{
+        male: "male";
+        female: "female";
+        castellated: "castellated";
+    }>>;
+    pitchMm: z.ZodDefault<z.ZodNumber>;
+    rows: z.ZodDefault<z.ZodNumber>;
+    cols: z.ZodNumber;
+    xMm: z.ZodNumber;
+    yMm: z.ZodNumber;
+    orientation: z.ZodDefault<z.ZodEnum<{
+        horizontal: "horizontal";
+        vertical: "vertical";
+    }>>;
+    pins: z.ZodArray<z.ZodNullable<z.ZodObject<{
+        key: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        role: z.ZodDefault<z.ZodEnum<{
+            power: "power";
+            gnd: "gnd";
+            io: "io";
+            analog: "analog";
+            pwm: "pwm";
+            i2c: "i2c";
+            spi: "spi";
+            uart: "uart";
+            usb: "usb";
+            clock: "clock";
+            reset: "reset";
+            enable: "enable";
+            nc: "nc";
+            other: "other";
+        }>>;
+    }, z.core.$strict>>>;
+    pad: z.ZodOptional<z.ZodObject<{
+        shape: z.ZodDefault<z.ZodEnum<{
+            rect: "rect";
+            round: "round";
+            oval: "oval";
+        }>>;
+        wMm: z.ZodNumber;
+        hMm: z.ZodNumber;
+        holeMm: z.ZodOptional<z.ZodNumber>;
+        smd: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type Header = z.infer<typeof Header>;
+/**
+ * A flying wire lead. Drawn as a bendable leg (fzp legId line) from (fromXMm, fromYMm)
+ * on the board, lengthMm long in direction, with the connector at the free end.
+ */
+export declare const Lead: z.ZodObject<{
+    color: z.ZodDefault<z.ZodString>;
+    lengthMm: z.ZodDefault<z.ZodNumber>;
+    fromXMm: z.ZodNumber;
+    fromYMm: z.ZodNumber;
+    direction: z.ZodDefault<z.ZodEnum<{
+        left: "left";
+        right: "right";
+        up: "up";
+        down: "down";
+    }>>;
+    gaugeMm: z.ZodDefault<z.ZodNumber>;
+    key: z.ZodString;
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    role: z.ZodDefault<z.ZodEnum<{
+        power: "power";
+        gnd: "gnd";
+        io: "io";
+        analog: "analog";
+        pwm: "pwm";
+        i2c: "i2c";
+        spi: "spi";
+        uart: "uart";
+        usb: "usb";
+        clock: "clock";
+        reset: "reset";
+        enable: "enable";
+        nc: "nc";
+        other: "other";
+    }>>;
+}, z.core.$strict>;
+export type Lead = z.infer<typeof Lead>;
+export declare const Outline: z.ZodObject<{
+    widthMm: z.ZodNumber;
+    heightMm: z.ZodNumber;
+    shape: z.ZodDefault<z.ZodEnum<{
+        rect: "rect";
+        custom: "custom";
+        rounded: "rounded";
+    }>>;
+    cornerRadiusMm: z.ZodDefault<z.ZodNumber>;
+    pathMm: z.ZodOptional<z.ZodString>;
+    holes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        xMm: z.ZodNumber;
+        yMm: z.ZodNumber;
+        dMm: z.ZodNumber;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type Outline = z.infer<typeof Outline>;
+/** Decorative items drawn on the breadboard view (vector style). */
+export declare const SilkItem: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"text">;
+    text: z.ZodString;
+    xMm: z.ZodNumber;
+    yMm: z.ZodNumber;
+    sizeMm: z.ZodDefault<z.ZodNumber>;
+    color: z.ZodDefault<z.ZodString>;
+    anchor: z.ZodDefault<z.ZodEnum<{
+        start: "start";
+        middle: "middle";
+        end: "end";
+    }>>;
+    rotate: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"rect">;
+    xMm: z.ZodNumber;
+    yMm: z.ZodNumber;
+    wMm: z.ZodNumber;
+    hMm: z.ZodNumber;
+    color: z.ZodDefault<z.ZodString>;
+    rxMm: z.ZodDefault<z.ZodNumber>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"circle">;
+    xMm: z.ZodNumber;
+    yMm: z.ZodNumber;
+    dMm: z.ZodNumber;
+    color: z.ZodDefault<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"line">;
+    x1Mm: z.ZodNumber;
+    y1Mm: z.ZodNumber;
+    x2Mm: z.ZodNumber;
+    y2Mm: z.ZodNumber;
+    widthMm: z.ZodDefault<z.ZodNumber>;
+    color: z.ZodDefault<z.ZodString>;
+}, z.core.$strict>], "kind">;
+export type SilkItem = z.infer<typeof SilkItem>;
+export declare const Photo: z.ZodObject<{
+    src: z.ZodString;
+    crop: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    rotate: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    removeBackground: z.ZodDefault<z.ZodBoolean>;
+    opacity: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type Photo = z.infer<typeof Photo>;
+export declare const Artwork: z.ZodObject<{
+    style: z.ZodDefault<z.ZodEnum<{
+        vector: "vector";
+        photo: "photo";
+    }>>;
+    boardColor: z.ZodDefault<z.ZodString>;
+    silkColor: z.ZodDefault<z.ZodString>;
+    silkscreen: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"text">;
+        text: z.ZodString;
+        xMm: z.ZodNumber;
+        yMm: z.ZodNumber;
+        sizeMm: z.ZodDefault<z.ZodNumber>;
+        color: z.ZodDefault<z.ZodString>;
+        anchor: z.ZodDefault<z.ZodEnum<{
+            start: "start";
+            middle: "middle";
+            end: "end";
+        }>>;
+        rotate: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"rect">;
+        xMm: z.ZodNumber;
+        yMm: z.ZodNumber;
+        wMm: z.ZodNumber;
+        hMm: z.ZodNumber;
+        color: z.ZodDefault<z.ZodString>;
+        rxMm: z.ZodDefault<z.ZodNumber>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"circle">;
+        xMm: z.ZodNumber;
+        yMm: z.ZodNumber;
+        dMm: z.ZodNumber;
+        color: z.ZodDefault<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"line">;
+        x1Mm: z.ZodNumber;
+        y1Mm: z.ZodNumber;
+        x2Mm: z.ZodNumber;
+        y2Mm: z.ZodNumber;
+        widthMm: z.ZodDefault<z.ZodNumber>;
+        color: z.ZodDefault<z.ZodString>;
+    }, z.core.$strict>], "kind">>>;
+    components: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"text">;
+        text: z.ZodString;
+        xMm: z.ZodNumber;
+        yMm: z.ZodNumber;
+        sizeMm: z.ZodDefault<z.ZodNumber>;
+        color: z.ZodDefault<z.ZodString>;
+        anchor: z.ZodDefault<z.ZodEnum<{
+            start: "start";
+            middle: "middle";
+            end: "end";
+        }>>;
+        rotate: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"rect">;
+        xMm: z.ZodNumber;
+        yMm: z.ZodNumber;
+        wMm: z.ZodNumber;
+        hMm: z.ZodNumber;
+        color: z.ZodDefault<z.ZodString>;
+        rxMm: z.ZodDefault<z.ZodNumber>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"circle">;
+        xMm: z.ZodNumber;
+        yMm: z.ZodNumber;
+        dMm: z.ZodNumber;
+        color: z.ZodDefault<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"line">;
+        x1Mm: z.ZodNumber;
+        y1Mm: z.ZodNumber;
+        x2Mm: z.ZodNumber;
+        y2Mm: z.ZodNumber;
+        widthMm: z.ZodDefault<z.ZodNumber>;
+        color: z.ZodDefault<z.ZodString>;
+    }, z.core.$strict>], "kind">>>;
+    photo: z.ZodOptional<z.ZodObject<{
+        src: z.ZodString;
+        crop: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        rotate: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+        removeBackground: z.ZodDefault<z.ZodBoolean>;
+        opacity: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type Artwork = z.infer<typeof Artwork>;
+export declare const Bus: z.ZodObject<{
+    id: z.ZodString;
+    pins: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type Bus = z.infer<typeof Bus>;
+/** Passed through to the fzp <spice> block. Tokens: {instanceTitle}, {net connectorN}, {<property>}. */
+export declare const Spice: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    lines: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type Spice = z.infer<typeof Spice>;
+export declare const SchematicOptions: z.ZodObject<{
+    layout: z.ZodDefault<z.ZodEnum<{
+        "by-role": "by-role";
+    }>>;
+    sides: z.ZodOptional<z.ZodObject<{
+        left: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            power: "power";
+            gnd: "gnd";
+            io: "io";
+            analog: "analog";
+            pwm: "pwm";
+            i2c: "i2c";
+            spi: "spi";
+            uart: "uart";
+            usb: "usb";
+            clock: "clock";
+            reset: "reset";
+            enable: "enable";
+            nc: "nc";
+            other: "other";
+        }>>>;
+        right: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            power: "power";
+            gnd: "gnd";
+            io: "io";
+            analog: "analog";
+            pwm: "pwm";
+            i2c: "i2c";
+            spi: "spi";
+            uart: "uart";
+            usb: "usb";
+            clock: "clock";
+            reset: "reset";
+            enable: "enable";
+            nc: "nc";
+            other: "other";
+        }>>>;
+        top: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            power: "power";
+            gnd: "gnd";
+            io: "io";
+            analog: "analog";
+            pwm: "pwm";
+            i2c: "i2c";
+            spi: "spi";
+            uart: "uart";
+            usb: "usb";
+            clock: "clock";
+            reset: "reset";
+            enable: "enable";
+            nc: "nc";
+            other: "other";
+        }>>>;
+        bottom: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            power: "power";
+            gnd: "gnd";
+            io: "io";
+            analog: "analog";
+            pwm: "pwm";
+            i2c: "i2c";
+            spi: "spi";
+            uart: "uart";
+            usb: "usb";
+            clock: "clock";
+            reset: "reset";
+            enable: "enable";
+            nc: "nc";
+            other: "other";
+        }>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SchematicOptions = z.infer<typeof SchematicOptions>;
+export declare const PcbOptions: z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+        smd: "smd";
+        auto: "auto";
+        tht: "tht";
+    }>>;
+    silkscreenOutline: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export type PcbOptions = z.infer<typeof PcbOptions>;
+export declare const PartSpec: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    slug: z.ZodString;
+    title: z.ZodString;
+    version: z.ZodDefault<z.ZodNumber>;
+    family: z.ZodOptional<z.ZodString>;
+    label: z.ZodDefault<z.ZodString>;
+    author: z.ZodDefault<z.ZodString>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    description: z.ZodDefault<z.ZodString>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    properties: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    outline: z.ZodObject<{
+        widthMm: z.ZodNumber;
+        heightMm: z.ZodNumber;
+        shape: z.ZodDefault<z.ZodEnum<{
+            rect: "rect";
+            custom: "custom";
+            rounded: "rounded";
+        }>>;
+        cornerRadiusMm: z.ZodDefault<z.ZodNumber>;
+        pathMm: z.ZodOptional<z.ZodString>;
+        holes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            xMm: z.ZodNumber;
+            yMm: z.ZodNumber;
+            dMm: z.ZodNumber;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    artwork: z.ZodPrefault<z.ZodObject<{
+        style: z.ZodDefault<z.ZodEnum<{
+            vector: "vector";
+            photo: "photo";
+        }>>;
+        boardColor: z.ZodDefault<z.ZodString>;
+        silkColor: z.ZodDefault<z.ZodString>;
+        silkscreen: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"text">;
+            text: z.ZodString;
+            xMm: z.ZodNumber;
+            yMm: z.ZodNumber;
+            sizeMm: z.ZodDefault<z.ZodNumber>;
+            color: z.ZodDefault<z.ZodString>;
+            anchor: z.ZodDefault<z.ZodEnum<{
+                start: "start";
+                middle: "middle";
+                end: "end";
+            }>>;
+            rotate: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"rect">;
+            xMm: z.ZodNumber;
+            yMm: z.ZodNumber;
+            wMm: z.ZodNumber;
+            hMm: z.ZodNumber;
+            color: z.ZodDefault<z.ZodString>;
+            rxMm: z.ZodDefault<z.ZodNumber>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"circle">;
+            xMm: z.ZodNumber;
+            yMm: z.ZodNumber;
+            dMm: z.ZodNumber;
+            color: z.ZodDefault<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"line">;
+            x1Mm: z.ZodNumber;
+            y1Mm: z.ZodNumber;
+            x2Mm: z.ZodNumber;
+            y2Mm: z.ZodNumber;
+            widthMm: z.ZodDefault<z.ZodNumber>;
+            color: z.ZodDefault<z.ZodString>;
+        }, z.core.$strict>], "kind">>>;
+        components: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"text">;
+            text: z.ZodString;
+            xMm: z.ZodNumber;
+            yMm: z.ZodNumber;
+            sizeMm: z.ZodDefault<z.ZodNumber>;
+            color: z.ZodDefault<z.ZodString>;
+            anchor: z.ZodDefault<z.ZodEnum<{
+                start: "start";
+                middle: "middle";
+                end: "end";
+            }>>;
+            rotate: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"rect">;
+            xMm: z.ZodNumber;
+            yMm: z.ZodNumber;
+            wMm: z.ZodNumber;
+            hMm: z.ZodNumber;
+            color: z.ZodDefault<z.ZodString>;
+            rxMm: z.ZodDefault<z.ZodNumber>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"circle">;
+            xMm: z.ZodNumber;
+            yMm: z.ZodNumber;
+            dMm: z.ZodNumber;
+            color: z.ZodDefault<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"line">;
+            x1Mm: z.ZodNumber;
+            y1Mm: z.ZodNumber;
+            x2Mm: z.ZodNumber;
+            y2Mm: z.ZodNumber;
+            widthMm: z.ZodDefault<z.ZodNumber>;
+            color: z.ZodDefault<z.ZodString>;
+        }, z.core.$strict>], "kind">>>;
+        photo: z.ZodOptional<z.ZodObject<{
+            src: z.ZodString;
+            crop: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            rotate: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+            removeBackground: z.ZodDefault<z.ZodBoolean>;
+            opacity: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    pins: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        type: z.ZodDefault<z.ZodEnum<{
+            male: "male";
+            female: "female";
+            pad: "pad";
+            wire: "wire";
+        }>>;
+        xMm: z.ZodNumber;
+        yMm: z.ZodNumber;
+        pad: z.ZodDefault<z.ZodObject<{
+            shape: z.ZodDefault<z.ZodEnum<{
+                rect: "rect";
+                round: "round";
+                oval: "oval";
+            }>>;
+            wMm: z.ZodNumber;
+            hMm: z.ZodNumber;
+            holeMm: z.ZodOptional<z.ZodNumber>;
+            smd: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        snap: z.ZodOptional<z.ZodBoolean>;
+        key: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        role: z.ZodDefault<z.ZodEnum<{
+            power: "power";
+            gnd: "gnd";
+            io: "io";
+            analog: "analog";
+            pwm: "pwm";
+            i2c: "i2c";
+            spi: "spi";
+            uart: "uart";
+            usb: "usb";
+            clock: "clock";
+            reset: "reset";
+            enable: "enable";
+            nc: "nc";
+            other: "other";
+        }>>;
+    }, z.core.$strict>>>;
+    headers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        kind: z.ZodDefault<z.ZodEnum<{
+            male: "male";
+            female: "female";
+            castellated: "castellated";
+        }>>;
+        pitchMm: z.ZodDefault<z.ZodNumber>;
+        rows: z.ZodDefault<z.ZodNumber>;
+        cols: z.ZodNumber;
+        xMm: z.ZodNumber;
+        yMm: z.ZodNumber;
+        orientation: z.ZodDefault<z.ZodEnum<{
+            horizontal: "horizontal";
+            vertical: "vertical";
+        }>>;
+        pins: z.ZodArray<z.ZodNullable<z.ZodObject<{
+            key: z.ZodString;
+            name: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            role: z.ZodDefault<z.ZodEnum<{
+                power: "power";
+                gnd: "gnd";
+                io: "io";
+                analog: "analog";
+                pwm: "pwm";
+                i2c: "i2c";
+                spi: "spi";
+                uart: "uart";
+                usb: "usb";
+                clock: "clock";
+                reset: "reset";
+                enable: "enable";
+                nc: "nc";
+                other: "other";
+            }>>;
+        }, z.core.$strict>>>;
+        pad: z.ZodOptional<z.ZodObject<{
+            shape: z.ZodDefault<z.ZodEnum<{
+                rect: "rect";
+                round: "round";
+                oval: "oval";
+            }>>;
+            wMm: z.ZodNumber;
+            hMm: z.ZodNumber;
+            holeMm: z.ZodOptional<z.ZodNumber>;
+            smd: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+    leads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        color: z.ZodDefault<z.ZodString>;
+        lengthMm: z.ZodDefault<z.ZodNumber>;
+        fromXMm: z.ZodNumber;
+        fromYMm: z.ZodNumber;
+        direction: z.ZodDefault<z.ZodEnum<{
+            left: "left";
+            right: "right";
+            up: "up";
+            down: "down";
+        }>>;
+        gaugeMm: z.ZodDefault<z.ZodNumber>;
+        key: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        role: z.ZodDefault<z.ZodEnum<{
+            power: "power";
+            gnd: "gnd";
+            io: "io";
+            analog: "analog";
+            pwm: "pwm";
+            i2c: "i2c";
+            spi: "spi";
+            uart: "uart";
+            usb: "usb";
+            clock: "clock";
+            reset: "reset";
+            enable: "enable";
+            nc: "nc";
+            other: "other";
+        }>>;
+    }, z.core.$strict>>>;
+    pinIds: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    buses: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        pins: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>;
+    spice: z.ZodOptional<z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        lines: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    schematic: z.ZodPrefault<z.ZodObject<{
+        layout: z.ZodDefault<z.ZodEnum<{
+            "by-role": "by-role";
+        }>>;
+        sides: z.ZodOptional<z.ZodObject<{
+            left: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                power: "power";
+                gnd: "gnd";
+                io: "io";
+                analog: "analog";
+                pwm: "pwm";
+                i2c: "i2c";
+                spi: "spi";
+                uart: "uart";
+                usb: "usb";
+                clock: "clock";
+                reset: "reset";
+                enable: "enable";
+                nc: "nc";
+                other: "other";
+            }>>>;
+            right: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                power: "power";
+                gnd: "gnd";
+                io: "io";
+                analog: "analog";
+                pwm: "pwm";
+                i2c: "i2c";
+                spi: "spi";
+                uart: "uart";
+                usb: "usb";
+                clock: "clock";
+                reset: "reset";
+                enable: "enable";
+                nc: "nc";
+                other: "other";
+            }>>>;
+            top: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                power: "power";
+                gnd: "gnd";
+                io: "io";
+                analog: "analog";
+                pwm: "pwm";
+                i2c: "i2c";
+                spi: "spi";
+                uart: "uart";
+                usb: "usb";
+                clock: "clock";
+                reset: "reset";
+                enable: "enable";
+                nc: "nc";
+                other: "other";
+            }>>>;
+            bottom: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                power: "power";
+                gnd: "gnd";
+                io: "io";
+                analog: "analog";
+                pwm: "pwm";
+                i2c: "i2c";
+                spi: "spi";
+                uart: "uart";
+                usb: "usb";
+                clock: "clock";
+                reset: "reset";
+                enable: "enable";
+                nc: "nc";
+                other: "other";
+            }>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    pcb: z.ZodPrefault<z.ZodObject<{
+        mode: z.ZodDefault<z.ZodEnum<{
+            smd: "smd";
+            auto: "auto";
+            tht: "tht";
+        }>>;
+        silkscreenOutline: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type PartSpec = z.infer<typeof PartSpec>;
+/** The spec as written on disk (before defaults are applied). */
+export type PartSpecInput = z.input<typeof PartSpec>;
+/** Parse and apply defaults. Throws ZodError on invalid input. */
+export declare function parsePartSpec(input: unknown): PartSpec;
+export declare function safeParsePartSpec(input: unknown): z.ZodSafeParseResult<{
+    slug: string;
+    title: string;
+    version: number;
+    label: string;
+    author: string;
+    tags: string[];
+    description: string;
+    sources: string[];
+    properties: Record<string, string>;
+    outline: {
+        widthMm: number;
+        heightMm: number;
+        shape: "rect" | "custom" | "rounded";
+        cornerRadiusMm: number;
+        holes: {
+            xMm: number;
+            yMm: number;
+            dMm: number;
+        }[];
+        pathMm?: string | undefined;
+    };
+    artwork: {
+        style: "vector" | "photo";
+        boardColor: string;
+        silkColor: string;
+        silkscreen: ({
+            kind: "text";
+            text: string;
+            xMm: number;
+            yMm: number;
+            sizeMm: number;
+            color: string;
+            anchor: "start" | "middle" | "end";
+            rotate: number;
+        } | {
+            kind: "rect";
+            xMm: number;
+            yMm: number;
+            wMm: number;
+            hMm: number;
+            color: string;
+            rxMm: number;
+            note?: string | undefined;
+        } | {
+            kind: "circle";
+            xMm: number;
+            yMm: number;
+            dMm: number;
+            color: string;
+            note?: string | undefined;
+        } | {
+            kind: "line";
+            x1Mm: number;
+            y1Mm: number;
+            x2Mm: number;
+            y2Mm: number;
+            widthMm: number;
+            color: string;
+        })[];
+        components: ({
+            kind: "text";
+            text: string;
+            xMm: number;
+            yMm: number;
+            sizeMm: number;
+            color: string;
+            anchor: "start" | "middle" | "end";
+            rotate: number;
+        } | {
+            kind: "rect";
+            xMm: number;
+            yMm: number;
+            wMm: number;
+            hMm: number;
+            color: string;
+            rxMm: number;
+            note?: string | undefined;
+        } | {
+            kind: "circle";
+            xMm: number;
+            yMm: number;
+            dMm: number;
+            color: string;
+            note?: string | undefined;
+        } | {
+            kind: "line";
+            x1Mm: number;
+            y1Mm: number;
+            x2Mm: number;
+            y2Mm: number;
+            widthMm: number;
+            color: string;
+        })[];
+        photo?: {
+            src: string;
+            rotate: 0 | 90 | 180 | 270;
+            removeBackground: boolean;
+            opacity: number;
+            crop?: [number, number, number, number] | undefined;
+        } | undefined;
+    };
+    pins: {
+        type: "male" | "female" | "pad" | "wire";
+        xMm: number;
+        yMm: number;
+        pad: {
+            shape: "rect" | "round" | "oval";
+            wMm: number;
+            hMm: number;
+            holeMm?: number | undefined;
+            smd?: boolean | undefined;
+        };
+        key: string;
+        name: string;
+        role: "power" | "gnd" | "io" | "analog" | "pwm" | "i2c" | "spi" | "uart" | "usb" | "clock" | "reset" | "enable" | "nc" | "other";
+        snap?: boolean | undefined;
+        label?: string | undefined;
+        description?: string | undefined;
+    }[];
+    headers: {
+        key: string;
+        kind: "male" | "female" | "castellated";
+        pitchMm: number;
+        rows: number;
+        cols: number;
+        xMm: number;
+        yMm: number;
+        orientation: "horizontal" | "vertical";
+        pins: ({
+            key: string;
+            name: string;
+            role: "power" | "gnd" | "io" | "analog" | "pwm" | "i2c" | "spi" | "uart" | "usb" | "clock" | "reset" | "enable" | "nc" | "other";
+            label?: string | undefined;
+            description?: string | undefined;
+        } | null)[];
+        pad?: {
+            shape: "rect" | "round" | "oval";
+            wMm: number;
+            hMm: number;
+            holeMm?: number | undefined;
+            smd?: boolean | undefined;
+        } | undefined;
+    }[];
+    leads: {
+        color: string;
+        lengthMm: number;
+        fromXMm: number;
+        fromYMm: number;
+        direction: "left" | "right" | "up" | "down";
+        gaugeMm: number;
+        key: string;
+        name: string;
+        role: "power" | "gnd" | "io" | "analog" | "pwm" | "i2c" | "spi" | "uart" | "usb" | "clock" | "reset" | "enable" | "nc" | "other";
+        label?: string | undefined;
+        description?: string | undefined;
+    }[];
+    pinIds: Record<string, number>;
+    buses: {
+        id: string;
+        pins: string[];
+    }[];
+    schematic: {
+        layout: "by-role";
+        sides?: {
+            left?: ("power" | "gnd" | "io" | "analog" | "pwm" | "i2c" | "spi" | "uart" | "usb" | "clock" | "reset" | "enable" | "nc" | "other")[] | undefined;
+            right?: ("power" | "gnd" | "io" | "analog" | "pwm" | "i2c" | "spi" | "uart" | "usb" | "clock" | "reset" | "enable" | "nc" | "other")[] | undefined;
+            top?: ("power" | "gnd" | "io" | "analog" | "pwm" | "i2c" | "spi" | "uart" | "usb" | "clock" | "reset" | "enable" | "nc" | "other")[] | undefined;
+            bottom?: ("power" | "gnd" | "io" | "analog" | "pwm" | "i2c" | "spi" | "uart" | "usb" | "clock" | "reset" | "enable" | "nc" | "other")[] | undefined;
+        } | undefined;
+    };
+    pcb: {
+        mode: "smd" | "auto" | "tht";
+        silkscreenOutline: boolean;
+    };
+    $schema?: string | undefined;
+    family?: string | undefined;
+    spice?: {
+        lines: string[];
+        model?: string | undefined;
+    } | undefined;
+}>;