@skillpet/circuit 0.5.0

package/dist/svg/figure.d.ts

@@ -0,0 +1,157 @@
+/**
+ * SVG figure — aligned with Python `backends/svg.py` · `Figure` (subset).
+ */
+import type { Arcdirection, BBox, Capstyle, Halign, Joinstyle, Linestyle, RotationMode, Valign } from "../types.js";
+import { type SvgStyleOpts } from "./svg-style.js";
+export type SvgElement = {
+    z: number;
+    xml: string;
+};
+/**
+ * Estimate text dimensions using per-character width lookup (aligned with
+ * Python `svgtext.text_approx_size`). Returns width and height in points.
+ */
+export declare function textSize(text: string, fontsize: number, font?: string): {
+    width: number;
+    height: number;
+};
+export declare class SvgFigure {
+    static totalClips: number;
+    bbox: BBox;
+    readonly scale: number;
+    pxwidth: number;
+    pxheight: number;
+    private readonly elements;
+    private backgroundColor?;
+    readonly showbbox: boolean;
+    private readonly extraDefs;
+    private readonly svgDefs;
+    private readonly clips;
+    private readonly _groupStack;
+    private _hasGroups;
+    constructor(bbox: BBox, opts?: {
+        inchesPerUnit?: number;
+        margin?: number;
+        showbbox?: boolean;
+        /** Raw inner XML for `<defs>` (e.g. gradients, symbols). */
+        extraDefs?: string;
+    });
+    setBbox(bbox: BBox): void;
+    /** User coords → SVG px (y-up → y-down). */
+    xform(x: number, y: number): [number, number];
+    bgcolor(color: string): void;
+    /** Create an SVG hatch `<pattern>` def, returning the pattern id for `fill="url(#id)"`. */
+    hatchpattern(name?: string, color?: string, linewidth?: number): string;
+    /** Create an SVG `<clipPath>` def from raw path data. */
+    addclip(clipId: string, pathData: string): void;
+    /** Attach a clip-path to an element by BBox (aligned with Python `Figure.addclip`). */
+    addclipBbox(bboxClip: BBox): string | undefined;
+    plot(xs: number[], ys: number[], style?: SvgStyleOpts & {
+        zorder?: number;
+        clip?: BBox;
+    }): void;
+    circle(cx: number, cy: number, radius: number, style?: SvgStyleOpts & {
+        zorder?: number;
+    }): void;
+    /** Arrowhead at user-space `xy`, `thetaDeg` is line direction in degrees (see Python `Figure.arrow`). */
+    arrow(xy: [number, number], thetaDeg: number, opts?: {
+        arrowwidth?: number;
+        arrowlength?: number;
+        color?: string;
+        lw?: number;
+        zorder?: number;
+    }): void;
+    text(s: string, x: number, y: number, opts?: {
+        color?: string;
+        fontsize?: number;
+        fontfamily?: string;
+        rotation?: number;
+        halign?: Halign;
+        valign?: Valign;
+        rotation_mode?: RotationMode;
+        zorder?: number;
+        /** Wraps `<text>` in `<a href="...">` (e.g. Python `IcPin.href`). */
+        href?: string;
+        /** CSS `text-decoration` for pin name styling (`underline` / `overline`). */
+        textDecoration?: "underline" | "overline";
+    }): void;
+    /** Polygon / polyline — aligned with Python `Figure.poly`. */
+    poly(verts: readonly {
+        x: number;
+        y: number;
+    }[], opts?: {
+        closed?: boolean;
+        color?: string;
+        fill?: string;
+        lw?: number;
+        ls?: Linestyle;
+        hatch?: boolean;
+        capstyle?: Capstyle;
+        joinstyle?: Joinstyle;
+        zorder?: number;
+    }): void;
+    /** Cubic (4 points) or quadratic (3 points) Bézier — aligned with Python `Figure.bezier`. */
+    bezier(pts: readonly {
+        x: number;
+        y: number;
+    }[], opts?: {
+        color?: string;
+        lw?: number;
+        ls?: Linestyle;
+        capstyle?: Capstyle;
+        zorder?: number;
+        arrow?: string;
+        arrowlength?: number;
+        arrowwidth?: number;
+    }): void;
+    /** Elliptical arc — aligned with Python `Figure.arc` (subset: no arrow on arc). */
+    arc(center: [number, number], width: number, height: number, opts?: {
+        theta1?: number;
+        theta2?: number;
+        angle?: number;
+        color?: string;
+        lw?: number;
+        ls?: Linestyle;
+        fill?: string | null;
+        zorder?: number;
+        arrow?: Arcdirection | null;
+        arrowwidth?: number;
+        arrowlength?: number;
+    }): void;
+    /** Raw SVG path `d` fragments — aligned with Python `Figure.path`. */
+    path(parts: readonly (string | {
+        x: number;
+        y: number;
+    })[], opts?: {
+        color?: string;
+        lw?: number;
+        ls?: Linestyle;
+        capstyle?: Capstyle;
+        joinstyle?: Joinstyle;
+        fill?: string;
+        zorder?: number;
+    }): void;
+    image(imageData: string, xy: [number, number], width: number, height: number, opts?: {
+        rotate?: number;
+        zorder?: number;
+        imgfmt?: string;
+    }): void;
+    mathText(html: string, x: number, y: number, opts: {
+        width: number;
+        height: number;
+        color?: string;
+        fontsize?: number;
+        halign?: Halign;
+        valign?: Valign;
+        zorder?: number;
+        rotation?: number;
+    }): void;
+    /** Begin an SVG `<g>` group; elements added after this call will be wrapped on `endGroup()`. */
+    beginGroup(attrs: Record<string, string>, title?: string): void;
+    /** End the most recent `<g>` group opened by `beginGroup()`. */
+    endGroup(): void;
+    /** Sorted SVG children inner XML. */
+    toSvgInnerXml(): string;
+    toSvgString(): string;
+}
+//# sourceMappingURL=figure.d.ts.map

package/dist/svg/figure.d.ts.map

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