@skillpet/circuit 0.5.0

package/dist/drawing.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Drawing canvas — aligned with Python `schemdraw.Drawing` (SVG subset).
+ */
+import { ImageFormat, type BBox, type ImageType } from "./types.js";
+import { type SchemdrawStyle } from "./config.js";
+import { Point, type XY } from "./geometry/point.js";
+import { Container } from "./container.js";
+import { Element } from "./element.js";
+import type { SegmentLike } from "./segment.js";
+/** Metadata attached to an element for interactive / introspection use. */
+export interface ElementMeta {
+    id: string;
+    type: string;
+    tooltip?: string;
+}
+/**
+ * 电路画布。构造返回的实例经 `Proxy` 支持 Python 式锚点：`drawing.foo` 在已 `setAnchor('foo')` 且不与成员名冲突时得到 {@link Point}。
+ * TypeScript 若报「无此属性」，可用 {@link Drawing.getAnchor} 或 `anchors['foo']`。
+ */
+export declare class Drawing {
+    readonly elements: Element[];
+    /** Named positions in drawing coordinates (`set_anchor` / Python `Drawing.anchors`). */
+    anchors: Record<string, [number, number]>;
+    /** Extra SVG `<defs>` fragments (Python `Drawing.svgdefs`). */
+    readonly svgdefs: string[];
+    dwgparams: Record<string, unknown>;
+    _here: Point;
+    _theta: number;
+    private readonly _state;
+    outfile?: string;
+    private readonly _elementMeta;
+    setElementMeta(el: Element, meta: ElementMeta): void;
+    getElementMeta(el: Element): ElementMeta | undefined;
+    /**
+     * Current placement position (Python `Drawing.here` / `_here`).
+     * Get/set both call `push_element(None)` like Python — flushes any pending implicit `add`.
+     */
+    get here(): Point;
+    set here(v: Point | XY);
+    /** Current drawing direction in degrees (Python `Drawing.theta`). Getter flushes implicit stack. */
+    get theta(): number;
+    set theta(v: number);
+    /** Two-terminal default length (Python `Drawing.unit`). */
+    get unit(): number;
+    set unit(v: number);
+    constructor(opts?: Partial<SchemdrawStyle> & {
+        file?: string;
+    });
+    /**
+     * Typed read of a named anchor (same coordinates as Python `drawing.name` after `set_anchor`).
+     * Dot access `drawing.name` also works on instances returned by `new Drawing()` / `withDrawing`.
+     */
+    getAnchor(name: string): Point | undefined;
+    enter(): void;
+    exit(): void;
+    containsElement(el: Element): boolean;
+    add(el: Element): Element;
+    /** Remove last element; restore `here` / `theta` from last remaining (Python `Drawing.undo`). */
+    undo(): void;
+    /** Merge drawing defaults (Python `Drawing.config`). */
+    config(partial: Partial<SchemdrawStyle>): void;
+    /** Append multiple elements (Python `Drawing.add_elements`). */
+    addElements(...els: Element[]): void;
+    /**
+     * Grouping box for implicit `add` stack (Python `Drawing.container()` / `with drawing.container():`).
+     * Call {@link Container.enter} before child elements and {@link Container.exit} after, then {@link add} the container.
+     */
+    container(opts?: {
+        cornerradius?: number;
+        padx?: number;
+        pady?: number;
+    }): Container;
+    /** Offset the current placement position (Python `Drawing.move`). */
+    move(dx?: number, dy?: number): void;
+    /** Set placement position relative to `ref` (Python `Drawing.move_from`). */
+    moveFrom(ref: Point, dx?: number, dy?: number, theta?: number): void;
+    /** Save `here` / `theta` on a stack (Python `Drawing.push`). */
+    push(): void;
+    /** Restore last pushed `here` / `theta` (Python `Drawing.pop`). */
+    pop(): void;
+    /**
+     * Save / restore `here` and `theta` around a callback — same stack as `push`/`pop`
+     * (Python `with drawing.hold():`).
+     */
+    withHold<T>(fn: () => T): T;
+    /**
+     * Manual alternative to `withHold`: call `hold()` then `close()` when done
+     * (Python `HoldState` context manager).
+     */
+    hold(): {
+        close: () => void;
+    };
+    /** Append raw XML inside `<defs>` (Python `Drawing.add_svgdef`). */
+    addSvgDef(svgdef: string): void;
+    /** Record a named anchor at the current position (Python `Drawing.set_anchor`). */
+    setAnchor(name: string): void;
+    /**
+     * Flattened transformed segments — `params` = user ∪ elm ∪ defaults (**no** drawing `_dwgparams`),
+     * aligned with Python `Drawing.get_segments`.
+     */
+    getSegments(): SegmentLike[];
+    /**
+     * Write SVG to a file (Node only). Extension should be `.svg`.
+     * In browser environments this method throws — use {@link toSvgString} instead.
+     */
+    save(path: string): Promise<void>;
+    getBBox(): BBox;
+    /** Render to SVG string (user units, SVG backend). */
+    toSvgString(): string;
+    /**
+     * Python `Drawing.get_imagedata` — 当前构建仅支持 SVG（UTF-8 字节）；PNG 等栅格格式未接入。
+     */
+    getImageData(fmt?: ImageFormat | ImageType | string): Uint8Array;
+}
+/** Run `fn` with drawing stack (implicit `add` for elements created inside). */
+export declare function withDrawing(fn: (d: Drawing) => void, opts?: Partial<SchemdrawStyle>): Drawing;
+//# sourceMappingURL=drawing.d.ts.map

package/dist/drawing.d.ts.map

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

package/dist/drawing.js

@@ -0,0 +1,337 @@
+/**
+ * Drawing canvas — aligned with Python `schemdraw.Drawing` (SVG subset).
+ */
+import { ImageFormat, bbox } from "./types.js";
+import { getGlobalStyle } from "./config.js";
+import { mergeParams, mergeParamsFirstWins } from "./params.js";
+import { Point } from "./geometry/point.js";
+import { popDrawing, pushDrawing, pushElement } from "./drawing-stack.js";
+import { Container } from "./container.js";
+import { SvgFigure } from "./svg/figure.js";
+import { assignGradientFillIds } from "./drawing-gradient.js";
+import { buildConnectionGraph, assignLeadTransitionIds } from "./drawing-transition.js";
+import { PT_PER_IN } from "./svg/constants.js";
+/** True if `prop` is a real field/getter/method on `Drawing` (not a dynamic anchor name). */
+function drawingHasProperty(obj, prop) {
+    let o = obj;
+    while (o) {
+        if (Object.prototype.hasOwnProperty.call(o, prop)) {
+            return true;
+        }
+        if (Object.getOwnPropertyDescriptor(o, prop) !== undefined) {
+            return true;
+        }
+        o = Object.getPrototypeOf(o);
+    }
+    return false;
+}
+/**
+ * 电路画布。构造返回的实例经 `Proxy` 支持 Python 式锚点：`drawing.foo` 在已 `setAnchor('foo')` 且不与成员名冲突时得到 {@link Point}。
+ * TypeScript 若报「无此属性」，可用 {@link Drawing.getAnchor} 或 `anchors['foo']`。
+ */
+export class Drawing {
+    elements = [];
+    /** Named positions in drawing coordinates (`set_anchor` / Python `Drawing.anchors`). */
+    anchors = {};
+    /** Extra SVG `<defs>` fragments (Python `Drawing.svgdefs`). */
+    svgdefs = [];
+    dwgparams = {};
+    _here = new Point(0, 0);
+    _theta = 0;
+    _state = [];
+    outfile;
+    _elementMeta = new Map();
+    setElementMeta(el, meta) {
+        this._elementMeta.set(el, meta);
+    }
+    getElementMeta(el) {
+        return this._elementMeta.get(el);
+    }
+    /**
+     * Current placement position (Python `Drawing.here` / `_here`).
+     * Get/set both call `push_element(None)` like Python — flushes any pending implicit `add`.
+     */
+    get here() {
+        pushElement(null);
+        return this._here;
+    }
+    set here(v) {
+        pushElement(null);
+        this._here = v instanceof Point ? v : Point.fromXY(v);
+    }
+    /** Current drawing direction in degrees (Python `Drawing.theta`). Getter flushes implicit stack. */
+    get theta() {
+        pushElement(null);
+        return this._theta;
+    }
+    set theta(v) {
+        this._theta = v;
+    }
+    /** Two-terminal default length (Python `Drawing.unit`). */
+    get unit() {
+        return this.dwgparams.unit ?? 3;
+    }
+    set unit(v) {
+        this.dwgparams.unit = v;
+    }
+    constructor(opts = {}) {
+        const g = getGlobalStyle();
+        this.dwgparams = mergeParams(g, opts);
+        if (opts.file !== undefined) {
+            this.outfile = opts.file;
+        }
+        return drawingProxy(this);
+    }
+    /**
+     * Typed read of a named anchor (same coordinates as Python `drawing.name` after `set_anchor`).
+     * Dot access `drawing.name` also works on instances returned by `new Drawing()` / `withDrawing`.
+     */
+    getAnchor(name) {
+        const xy = this.anchors[name];
+        return xy === undefined ? undefined : new Point(xy[0], xy[1]);
+    }
+    enter() {
+        pushDrawing(this);
+    }
+    exit() {
+        pushElement(null);
+        popDrawing(this);
+    }
+    containsElement(el) {
+        return this.elements.includes(el);
+    }
+    add(el) {
+        const r = el._place(this._here.toTuple(), this._theta, this.dwgparams);
+        this.elements.push(el);
+        this._here = r.point;
+        this._theta = r.theta;
+        return el;
+    }
+    /** Remove last element; restore `here` / `theta` from last remaining (Python `Drawing.undo`). */
+    undo() {
+        this.elements.pop();
+        if (this.elements.length > 0) {
+            const last = this.elements[this.elements.length - 1];
+            this._here = last.absdrop.point;
+            this._theta = last.absdrop.theta;
+        }
+        else {
+            this._here = new Point(0, 0);
+            this._theta = 0;
+        }
+    }
+    /** Merge drawing defaults (Python `Drawing.config`). */
+    config(partial) {
+        this.dwgparams = mergeParams(this.dwgparams, partial);
+    }
+    /** Append multiple elements (Python `Drawing.add_elements`). */
+    addElements(...els) {
+        for (const el of els) {
+            this.add(el);
+        }
+    }
+    /**
+     * Grouping box for implicit `add` stack (Python `Drawing.container()` / `with drawing.container():`).
+     * Call {@link Container.enter} before child elements and {@link Container.exit} after, then {@link add} the container.
+     */
+    container(opts) {
+        return new Container(this, { ...(opts ?? {}) });
+    }
+    /** Offset the current placement position (Python `Drawing.move`). */
+    move(dx = 0, dy = 0) {
+        this._here = this._here.add([dx, dy]);
+    }
+    /** Set placement position relative to `ref` (Python `Drawing.move_from`). */
+    moveFrom(ref, dx = 0, dy = 0, theta) {
+        this._here = ref.add([dx, dy]);
+        if (theta !== undefined) {
+            this._theta = theta;
+        }
+    }
+    /** Save `here` / `theta` on a stack (Python `Drawing.push`). */
+    push() {
+        this._state.push([new Point(this._here.x, this._here.y), this._theta]);
+    }
+    /** Restore last pushed `here` / `theta` (Python `Drawing.pop`). */
+    pop() {
+        const s = this._state.pop();
+        if (s !== undefined) {
+            this._here = s[0];
+            this._theta = s[1];
+        }
+    }
+    /**
+     * Save / restore `here` and `theta` around a callback — same stack as `push`/`pop`
+     * (Python `with drawing.hold():`).
+     */
+    withHold(fn) {
+        this.push();
+        try {
+            return fn();
+        }
+        finally {
+            this.pop();
+        }
+    }
+    /**
+     * Manual alternative to `withHold`: call `hold()` then `close()` when done
+     * (Python `HoldState` context manager).
+     */
+    hold() {
+        this.push();
+        const d = this;
+        return {
+            close: () => {
+                d.pop();
+            },
+        };
+    }
+    /** Append raw XML inside `<defs>` (Python `Drawing.add_svgdef`). */
+    addSvgDef(svgdef) {
+        this.svgdefs.push(svgdef);
+    }
+    /** Record a named anchor at the current position (Python `Drawing.set_anchor`). */
+    setAnchor(name) {
+        this.anchors[name] = this._here.toTuple();
+    }
+    /**
+     * Flattened transformed segments — `params` = user ∪ elm ∪ defaults (**no** drawing `_dwgparams`),
+     * aligned with Python `Drawing.get_segments`.
+     */
+    getSegments() {
+        const out = [];
+        for (const el of this.elements) {
+            const params = mergeParamsFirstWins(el.userParams, el.elmParams, el.defaults);
+            for (const s of el.segments) {
+                out.push(s.xform(el.transform, params));
+            }
+        }
+        return out;
+    }
+    /**
+     * Write SVG to a file (Node only). Extension should be `.svg`.
+     * In browser environments this method throws — use {@link toSvgString} instead.
+     */
+    async save(path) {
+        try {
+            const { writeFileSync } = await import("node:fs");
+            writeFileSync(path, this.toSvgString(), "utf8");
+        }
+        catch (err) {
+            if (err instanceof Error && /Cannot find module|not supported|Failed to resolve|dynamically imported module|Module not found/.test(err.message)) {
+                throw new Error("Drawing.save() requires Node.js. In the browser, use drawing.toSvgString() instead.");
+            }
+            throw err;
+        }
+    }
+    getBBox() {
+        let xmin = Infinity;
+        let ymin = Infinity;
+        let xmax = -Infinity;
+        let ymax = -Infinity;
+        for (const el of this.elements) {
+            /** Include label segments so `toSvgString` viewBox matches Python (geometry + text). */
+            const b = el.getBBox(true, true);
+            xmin = Math.min(xmin, b.xmin);
+            ymin = Math.min(ymin, b.ymin);
+            xmax = Math.max(xmax, b.xmax);
+            ymax = Math.max(ymax, b.ymax);
+        }
+        if (!Number.isFinite(xmin)) {
+            return bbox(0, 0, 0, 0);
+        }
+        return bbox(xmin, ymin, xmax, ymax);
+    }
+    /** Render to SVG string (user units, SVG backend). */
+    toSvgString() {
+        const bb = this.getBBox();
+        const { defsXml, cleanup } = assignGradientFillIds(this.elements);
+        let transDefsXml = "";
+        let transCleanup = () => { };
+        if (this.dwgparams.colorTransition) {
+            const ipu = this.dwgparams.inches_per_unit ?? 0.5;
+            const scale = PT_PER_IN * ipu;
+            const edges = buildConnectionGraph(this.elements);
+            const trans = assignLeadTransitionIds(this.elements, edges, scale);
+            transDefsXml = trans.defsXml;
+            transCleanup = trans.cleanup;
+        }
+        try {
+            const defsParts = [this.svgdefs.join(""), defsXml, transDefsXml].filter((s) => s.length > 0);
+            const fig = new SvgFigure(bb, {
+                inchesPerUnit: this.dwgparams.inches_per_unit,
+                margin: this.dwgparams.margin,
+                extraDefs: defsParts.length > 0 ? defsParts.join("") : undefined,
+            });
+            const bg = this.dwgparams.bgcolor;
+            if (bg) {
+                fig.bgcolor(bg);
+            }
+            for (const el of this.elements) {
+                const meta = this._elementMeta.get(el);
+                if (this.dwgparams.interactive && meta) {
+                    const attrs = {
+                        'data-id': meta.id,
+                        'data-type': meta.type,
+                        'class': 'sd-el',
+                    };
+                    if (meta.tooltip) {
+                        attrs['data-tooltip'] = meta.tooltip;
+                    }
+                    const titleText = meta.tooltip || `${meta.id} — ${meta.type}`;
+                    fig.beginGroup(attrs, titleText);
+                }
+                el._draw(fig);
+                if (this.dwgparams.interactive && meta) {
+                    fig.endGroup();
+                }
+            }
+            return fig.toSvgString();
+        }
+        finally {
+            cleanup();
+            transCleanup();
+        }
+    }
+    /**
+     * Python `Drawing.get_imagedata` — 当前构建仅支持 SVG（UTF-8 字节）；PNG 等栅格格式未接入。
+     */
+    getImageData(fmt = ImageFormat.SVG) {
+        const s = typeof fmt === "string" ? fmt.toLowerCase() : String(fmt).toLowerCase();
+        if (s !== "svg") {
+            throw new Error(`@skillpet/circuit: getImageData('${fmt}') is not supported; only SVG bytes are available in this build.`);
+        }
+        return new TextEncoder().encode(this.toSvgString());
+    }
+}
+/**
+ * Python `Drawing.__getattr__`: `drawing.anchorName` resolves to `Point` when `anchorName` is in `anchors`
+ * and is not a real `Drawing` member (methods, `elements`, `anchors`, etc.).
+ */
+function drawingProxy(drawing) {
+    return new Proxy(drawing, {
+        get(target, prop, receiver) {
+            if (typeof prop === "symbol") {
+                return Reflect.get(target, prop, receiver);
+            }
+            if (!drawingHasProperty(target, prop) && prop in target.anchors) {
+                const xy = target.anchors[prop];
+                return new Point(xy[0], xy[1]);
+            }
+            return Reflect.get(target, prop, receiver);
+        },
+    });
+}
+/** Run `fn` with drawing stack (implicit `add` for elements created inside). */
+export function withDrawing(fn, opts) {
+    const d = new Drawing(opts ?? {});
+    d.enter();
+    try {
+        fn(d);
+    }
+    finally {
+        d.exit();
+    }
+    return d;
+}
+//# sourceMappingURL=drawing.js.map

package/dist/drawing.js.map

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

package/dist/element-label.d.ts

@@ -0,0 +1,54 @@
+/**
+ * User label placement — subset aligned with Python `Element._place_label` / `Label`.
+ */
+import { Point, type XY } from "./geometry/point.js";
+import type { Element } from "./element.js";
+export interface ElementLabelSpec {
+    /** Single line or list (list → distributed along `loc` like Python). */
+    text: string | readonly string[];
+    loc?: string | null;
+    ofst?: number | XY;
+    halign?: "left" | "center" | "right";
+    valign?: "top" | "center" | "bottom" | "base";
+    /** `true` = rotate with element (`theta`); number = extra local degrees. */
+    rotate?: boolean | number;
+    fontsize?: number;
+    font?: string;
+    mathfont?: string;
+    color?: string;
+    href?: string | null;
+    decoration?: string | null;
+}
+type Halign = "left" | "center" | "right";
+type Valign = "top" | "center" | "bottom" | "base";
+/**
+ * Python `Element._position_label`: when drawing angle is in (90°, 270°], swap edge `loc`
+ * so a logical "top" label stays visually above the body (see `elements.py`).
+ */
+export declare function swapLabelLocForTheta(loc: string, thetaDeg: number): string;
+/** Python `_position_label` rotation part (degrees) for `_align_label` (`th = theta - label.rotate`). */
+export declare function resolveLabelRotateDeg(spec: ElementLabelSpec, thetaDeg: number): number;
+export type BBoxLike = {
+    xmin: number;
+    xmax: number;
+    ymin: number;
+    ymax: number;
+};
+/**
+ * Python `Element._align_label` (subset): suggested `halign`/`valign`/`ofst` Point in local coords.
+ * Caller supplies `loc` after `_position_label` (e.g. `swapLabelLocForTheta`), bbox without text, and
+ * `ofstIn` after flip/reverse on tuple and default fill (scalar lblofst when undefined).
+ */
+export declare function alignLabelForPlace(el: Element, loc: string, thetaDeg: number, labelRotateDeg: number, ofstIn: number | XY, bb: BBoxLike): {
+    halign: Halign;
+    valign: Valign;
+    ofst: Point;
+};
+/**
+ * Append `SegmentText` for user labels (local coords). Caller must truncate segments first.
+ */
+export declare function placeElementLabels(el: Element, thetaDeg: number, specs: readonly ElementLabelSpec[]): void;
+/** Build `ElementLabelSpec[]` from constructor params (Python `toplabel` / `label` / …). */
+export declare function buildLabelSpecsFromParams(params: Record<string, unknown>, _thetaDeg: number): ElementLabelSpec[];
+export {};
+//# sourceMappingURL=element-label.d.ts.map

package/dist/element-label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-label.d.ts","sourceRoot":"","sources":["../src/element-label.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrC,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,KAAK,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAC1C,KAAK,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAenD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkB1E;AAED,yGAAyG;AACzG,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAetF;AAcD,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAElF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,OAAO,EACX,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,GAAG,EAAE,EACnB,EAAE,EAAE,QAAQ,GACX;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,CAAA;CAAE,CAuFjD;AAgBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI,CAwJ1G;AAED,4FAA4F;AAC5F,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAuDhH"}