@faicad/cq-compat 0.13.2 → 0.14.1

package/dist/sketch.js

@@ -0,0 +1,529 @@
+/**
+ * Sketch — CadQuery `Sketch.py` geometry-container parity (non-planegcs part).
+ *
+ * Phase 2 of the cq-compat max-cadquery plan: expose a public Sketch API whose
+ * geometry-declaration segment (rect/circle/ellipse/polygon + modes a/s/i/c/r +
+ * faces/wires/edges/vertices selectors) mirrors upstream `Sketch.py` without the
+ * constraint solver (planegcs licensing is pending legal review; constraints are
+ * intentionally out of scope here).
+ *
+ * The constraint segment (`constrain`/`solve`) stays blocked until the
+ * LGPL-2.0-or-later verdict; this module implements everything that does not
+ * depend on it.
+ *
+ * Faces are OCCT brep faces living in the z=0 plane (kernel `makeRectangle`,
+ * `makeCircleEdge`/`makeWire`/`makeFace`, ...). Boolean modes use the kernel's
+ * face-level fuse/cut/common (verified working on faces, see probe_2d).
+ */
+import { getKernel } from '@faicad/faijs/occt-kernel/occtKernel';
+import { fromHandle } from '@faicad/faijs/sdk';
+function kernel() {
+    return getKernel();
+}
+/** Vec3 literal helper (avoids TS tuple-inference noise). */
+function v3(x, y, z) {
+    return { x, y, z };
+}
+/**
+ * Create an empty Sketch.
+ * @returns an empty Sketch
+ */
+export function sketch() {
+    return { faces: [], tags: new Map(), selected: [], locs: [] };
+}
+/**
+ * Translate a shape so its centre lands at the origin. Used to centre
+ * kernel primitives that build in the [0,size] corner.
+ */
+function centre2D(k, h, w, d) {
+    const moved = k.translate(h, -w / 2, -d / 2, 0);
+    k.release(h);
+    return moved;
+}
+/** Rectangular face, centred at origin, w along X, h along Y. */
+function makeRectFace(k, w, h) {
+    return centre2D(k, k.makeRectangle(w, h), w, h);
+}
+/** Circular face of radius r centred at origin. */
+function makeCircleFace(k, r) {
+    const e = k.makeCircleEdge(v3(0, 0, 0), v3(0, 0, 1), r);
+    const wire = k.makeWire([e]);
+    k.release(e);
+    const f = k.makeFace(wire);
+    k.release(wire);
+    return f;
+}
+/** Elliptical face, major a along X, minor b along Y, centred at origin. */
+function makeEllipseFace(k, a, b) {
+    const e = k.makeEllipseEdge(v3(0, 0, 0), v3(0, 0, 1), a, b);
+    const wire = k.makeWire([e]);
+    k.release(e);
+    const f = k.makeFace(wire);
+    k.release(wire);
+    return f;
+}
+/** Polygon face from a closed point list (first==last optional; auto-closed). */
+function makePolygonFace(k, pts) {
+    // Drop the closing duplicate if present, then drop consecutive duplicates
+    // (OCCT makeLineEdge rejects zero-length edges, e.g. a 45-degree trapezoid
+    // degenerating into a triangle with two identical top corners).
+    const same = (a, b) => Math.abs(a[0] - b[0]) < 1e-12 && Math.abs(a[1] - b[1]) < 1e-12;
+    const fst = pts[0];
+    const lst = pts[pts.length - 1];
+    const ring = fst && lst && same(fst, lst) ? pts.slice(0, -1) : pts;
+    const clean = [];
+    for (const p of ring) {
+        const last = clean[clean.length - 1];
+        if (!last || !same(last, p))
+            clean.push(p);
+    }
+    if (clean.length < 3)
+        throw new Error('polygon needs at least 3 distinct points');
+    const edges = [];
+    for (let i = 0; i < clean.length; i++) {
+        const a = clean[i];
+        const b = clean[(i + 1) % clean.length];
+        edges.push(k.makeLineEdge(v3(a[0], a[1], 0), v3(b[0], b[1], 0)));
+    }
+    const wire = k.makeWire(edges);
+    edges.forEach((e) => k.release(e));
+    const f = k.makeFace(wire);
+    k.release(wire);
+    return f;
+}
+/** Rotate a face by angle degrees about the Z axis through its centre. */
+function rotateFace(k, f, angleDeg) {
+    if (!angleDeg)
+        return f;
+    const rad = (angleDeg * Math.PI) / 180;
+    const cos = Math.cos(rad);
+    const sin = Math.sin(rad);
+    const m = [cos, -sin, 0, 0, sin, cos, 0, 0, 0, 0, 1, 0];
+    const r = k.transform(f, m);
+    k.release(f);
+    return r;
+}
+/**
+ * Apply the CQ each() mode against the current faces.
+ * - a: fuse all new faces into the current set (CQ `_faces.fuse(*res)`)
+ * - s: cut new faces away
+ * - i: intersect with new faces
+ * - r: replace current faces with the new ones
+ * - c: keep current faces; store new ones under the tag (required)
+ */
+function applyMode(k, faces, fresh, mode, tag) {
+    const tagOut = new Map();
+    switch (mode) {
+        case 'a': {
+            const all = [...faces, ...fresh];
+            if (all.length === 0)
+                return { faces: [], tags: tagOut, tagOut };
+            let acc = all[0];
+            for (let i = 1; i < all.length; i++) {
+                const merged = k.fuse(acc, all[i]);
+                k.release(acc);
+                k.release(all[i]);
+                acc = merged;
+            }
+            return { faces: [acc], tags: tagOut, tagOut };
+        }
+        case 's': {
+            let acc = faces.length ? faces[0] : null;
+            if (!acc)
+                return { faces: [], tags: tagOut, tagOut };
+            const rest = faces.slice(1);
+            for (const f of rest) {
+                const merged = k.fuse(acc, f);
+                k.release(acc);
+                k.release(f);
+                acc = merged;
+            }
+            for (const f of fresh) {
+                const cut = k.cut(acc, f);
+                k.release(acc);
+                k.release(f);
+                acc = cut;
+            }
+            return { faces: acc ? [acc] : [], tags: tagOut, tagOut };
+        }
+        case 'i': {
+            let acc = faces.length ? faces[0] : null;
+            if (!acc)
+                return { faces: [], tags: tagOut, tagOut };
+            for (const f of faces.slice(1)) {
+                const merged = k.fuse(acc, f);
+                k.release(acc);
+                k.release(f);
+                acc = merged;
+            }
+            for (const f of fresh) {
+                const common = k.common(acc, f);
+                k.release(acc);
+                k.release(f);
+                acc = common;
+            }
+            return { faces: acc ? [acc] : [], tags: tagOut, tagOut };
+        }
+        case 'c': {
+            if (!tag)
+                throw new Error('No tag specified - the geometry will be unreachable');
+            tagOut.set(tag, fresh);
+            // current faces unchanged (fresh faces are construction-only)
+            return { faces, tags: tagOut, tagOut };
+        }
+        case 'r': {
+            return { faces: fresh, tags: tagOut, tagOut };
+        }
+        default:
+            throw new Error('Invalid mode: ' + String(mode));
+    }
+}
+/** Merge the mode result into a Sketch (fresh faces released on a/s/i/r paths). */
+function commit(sk, mode, tag, fresh) {
+    const k = kernel();
+    const { faces, tagOut } = applyMode(k, sk.faces, fresh, mode, tag);
+    const tags = new Map(sk.tags);
+    for (const [t, fs] of tagOut)
+        tags.set(t, fs);
+    return { faces, tags, selected: sk.selected, locs: sk.locs };
+}
+/**
+ * rect — CadQuery `Sketch.rect(w, h, angle, mode, tag)` parity.
+ * @param sk - Sketch
+ * @param w - width along X
+ * @param h - height along Y
+ * @param opts - mode/tag/angle
+ * @returns Sketch
+ */
+export function rect(sk, w, h, opts) {
+    const k = kernel();
+    const mode = opts?.mode ?? 'a';
+    const face = rotateFace(k, makeRectFace(k, w, h), opts?.angle ?? 0);
+    return commit(sk, mode, opts?.tag, [face]);
+}
+/**
+ * circle — CadQuery `Sketch.circle(r, mode, tag)` parity.
+ * @param sk - Sketch
+ * @param r - radius
+ * @param opts - mode/tag
+ * @returns Sketch
+ */
+export function circle(sk, r, opts) {
+    const k = kernel();
+    const mode = opts?.mode ?? 'a';
+    const face = makeCircleFace(k, r);
+    return commit(sk, mode, opts?.tag, [face]);
+}
+/**
+ * ellipse — CadQuery `Sketch.ellipse(a1, a2, angle, mode, tag)` parity.
+ * @param sk - Sketch
+ * @param a1 - radius along X
+ * @param a2 - radius along Y
+ * @param opts - mode/tag/angle
+ * @returns Sketch
+ */
+export function ellipse(sk, a1, a2, opts) {
+    const k = kernel();
+    const mode = opts?.mode ?? 'a';
+    const face = rotateFace(k, makeEllipseFace(k, a1, a2), opts?.angle ?? 0);
+    return commit(sk, mode, opts?.tag, [face]);
+}
+/**
+ * polygon — CadQuery `Sketch.polygon(pts, angle, mode, tag)` parity.
+ * @param sk - Sketch
+ * @param pts - closed point list [[x,y],...]
+ * @param opts - mode/tag/angle
+ * @returns Sketch
+ */
+export function polygon(sk, pts, opts) {
+    const k = kernel();
+    const mode = opts?.mode ?? 'a';
+    const face = rotateFace(k, makePolygonFace(k, pts), opts?.angle ?? 0);
+    return commit(sk, mode, opts?.tag, [face]);
+}
+/**
+ * regularPolygon — CadQuery `Sketch.regularPolygon(r, n, angle, mode, tag)`
+ * parity: n-gon inscribed in radius r, first vertex at the +Y direction.
+ * @param sk - Sketch
+ * @param r - circumradius
+ * @param n - number of sides
+ * @param opts - mode/tag/angle
+ * @returns Sketch
+ */
+export function regularPolygon(sk, r, n, opts) {
+    const pts = [];
+    for (let i = 0; i <= n; i++) {
+        const a = (i * 2 * Math.PI) / n;
+        pts.push([r * Math.sin(a), r * Math.cos(a)]);
+    }
+    return polygon(sk, pts, opts);
+}
+/**
+ * slot — CadQuery `Sketch.slot(w, h, angle, mode, tag)` parity: stadium / long
+ * slot face of length w and width h, centred at origin.
+ * @param sk - Sketch
+ * @param w - slot length along X
+ * @param h - slot width along Y
+ * @param opts - mode/tag/angle
+ * @returns Sketch
+ */
+export function slot(sk, w, h, opts) {
+    const k = kernel();
+    const mode = opts?.mode ?? 'a';
+    const p1 = [-w / 2, h / 2];
+    const p2 = [w / 2, h / 2];
+    const p3 = [-w / 2, -h / 2];
+    const p4 = [w / 2, -h / 2];
+    const p5 = [-w / 2 - h / 2, 0];
+    const p6 = [w / 2 + h / 2, 0];
+    const e1 = k.makeLineEdge(v3(p1[0], p1[1], 0), v3(p2[0], p2[1], 0));
+    const e2 = k.makeArcEdge(v3(p2[0], p2[1], 0), v3(p6[0], p6[1], 0), v3(p4[0], p4[1], 0));
+    const e3 = k.makeLineEdge(v3(p4[0], p4[1], 0), v3(p3[0], p3[1], 0));
+    const e4 = k.makeArcEdge(v3(p3[0], p3[1], 0), v3(p5[0], p5[1], 0), v3(p1[0], p1[1], 0));
+    const wire = k.makeWire([e1, e2, e3, e4]);
+    for (const e of [e1, e2, e3, e4])
+        k.release(e);
+    const face = k.makeFace(wire);
+    k.release(wire);
+    return commit(sk, mode, opts?.tag, [rotateFace(k, face, opts?.angle ?? 0)]);
+}
+/**
+ * trapezoid — CadQuery `Sketch.trapezoid(w, h, a1, a2, angle, mode, tag)`
+ * parity: isosceles-or-not trapezoid; a1/a2 are the base angles in degrees.
+ * @param sk - Sketch
+ * @param w - bottom width
+ * @param h - height
+ * @param a1 - bottom-left base angle (degrees)
+ * @param a2 - bottom-right base angle (degrees); defaults to a1
+ * @param opts - mode/tag/angle
+ * @returns Sketch
+ */
+export function trapezoid(sk, w, h, a1, a2, opts) {
+    const a2v = a2 ?? a1;
+    const v1 = [-w / 2, -h / 2];
+    const v2 = [w / 2, -h / 2];
+    const t1 = h / Math.tan((a1 * Math.PI) / 180);
+    const t2 = h / Math.tan((a2v * Math.PI) / 180);
+    const v3 = [-w / 2 + t1, h / 2];
+    const v4 = [w / 2 - t2, h / 2];
+    return polygon(sk, [v1, v2, v4, v3, v1], opts);
+}
+/**
+ * offset — CadQuery `Sketch.offset(d, mode, tag)` parity: offset each selected
+ * wire by d and feed the resulting faces through the given mode. Requires a
+ * selection (wires()/edges()).
+ * @param sk - Sketch
+ * @param d - signed offset distance
+ * @param opts - mode/tag
+ * @returns Sketch
+ */
+export function offset(sk, d, opts) {
+    if (!sk.selected.length)
+        throw new Error('Selection is needed to offset');
+    const k = kernel();
+    const mode = opts?.mode ?? 'a';
+    const fresh = [];
+    for (const el of sk.selected) {
+        const off = k.offsetWire2D(el, d);
+        const f = k.makeFace(off);
+        k.release(off);
+        fresh.push(f);
+    }
+    return commit(sk, mode, opts?.tag, fresh);
+}
+/**
+ * faces — CadQuery `Sketch.faces()` selector parity: select current faces.
+ * @param sk - Sketch
+ * @returns Sketch (selected faces feed the next geometric declaration)
+ */
+export function faces(sk) {
+    // Upstream _faces.Faces() returns the TOPOLOGICAL faces; a fused face
+    // handle may hold several (e.g. two overlapping rects stay 2 faces after
+    // fuse, asserted by upstream test_modes). Flatten via getSubShapes.
+    const k = kernel();
+    const out = [];
+    for (const f of sk.faces) {
+        const sub = k.getSubShapes(f, 'face');
+        out.push(...sub);
+    }
+    return { ...sk, selected: out };
+}
+/**
+ * wires — CadQuery `Sketch.wires()` selector parity: select boundary wires of
+ * the current faces.
+ * @param sk - Sketch
+ * @returns Sketch
+ */
+export function wires(sk) {
+    const k = kernel();
+    const wires = [];
+    for (const f of sk.faces) {
+        const w = k.outerWire(f);
+        wires.push(w);
+    }
+    return { ...sk, selected: wires };
+}
+/**
+ * edges — CadQuery `Sketch.edges()` selector parity: select all edges of the
+ * current faces.
+ * @param sk - Sketch
+ * @returns Sketch
+ */
+export function edges(sk) {
+    const k = kernel();
+    const out = [];
+    for (const f of sk.faces) {
+        const es = k.getSubShapes(f, 'edge');
+        out.push(...es);
+    }
+    return { ...sk, selected: out };
+}
+/**
+ * vertices — CadQuery `Sketch.vertices()` selector parity: select all vertices
+ * of the current faces.
+ * @param sk - Sketch
+ * @returns Sketch
+ */
+export function vertices(sk) {
+    const k = kernel();
+    const out = [];
+    for (const f of sk.faces) {
+        const vs = k.getSubShapes(f, 'vertex');
+        out.push(...vs);
+    }
+    return { ...sk, selected: out };
+}
+/**
+ * reset — CadQuery `Sketch.reset()` parity: clear the selection so the next
+ * geometric declaration applies to the whole sketch.
+ * @param sk - Sketch
+ * @returns Sketch
+ */
+export function reset(sk) {
+    return { ...sk, selected: [] };
+}
+/**
+ * val — CadQuery `Sketch.val()` parity: first effective face as a Shape.
+ * @param sk - Sketch
+ * @returns Shape
+ */
+export function val(sk) {
+    const v = vals(sk);
+    if (!v.length)
+        throw new Error('Sketch has no faces');
+    return v[0];
+}
+/**
+ * vals — CadQuery `Sketch.vals()` parity: the current selection, or the
+ * flattened topological faces when nothing is selected (upstream returns the
+ * `_faces` faces; a fused handle may hold several).
+ * @param sk - Sketch
+ * @returns Shape[]
+ */
+export function vals(sk) {
+    if (sk.selected.length)
+        return [...sk.selected];
+    const k = kernel();
+    const out = [];
+    for (const f of sk.faces) {
+        const sub = k.getSubShapes(f, 'face');
+        out.push(...sub);
+    }
+    return out;
+}
+/**
+ * tag — CadQuery `Sketch.tag(name)` parity: store the current selection (or all
+ * faces when nothing selected) under a name for later `.select()`.
+ * @param sk - Sketch
+ * @param name - tag name
+ * @returns Sketch
+ */
+export function tag(sk, name) {
+    const tags = new Map(sk.tags);
+    const payload = sk.selected.length ? sk.selected : sk.faces;
+    tags.set(name, [...payload]);
+    return { ...sk, tags };
+}
+/**
+ * select — CadQuery `Sketch.select(tag)` parity: select the faces stored under
+ * a tag.
+ * @param sk - Sketch
+ * @param name - tag name
+ * @returns Sketch
+ */
+export function select(sk, name) {
+    const payload = sk.tags.get(name);
+    if (!payload)
+        throw new Error('Tag not found: ' + name);
+    return { ...sk, selected: [...payload] };
+}
+/**
+ * area — total surface area of the effective faces (upstream `_faces.Area()`).
+ * @param sk - Sketch
+ * @returns number
+ */
+export function area(sk) {
+    const k = kernel();
+    let total = 0;
+    for (const f of sk.faces)
+        total += k.getSurfaceArea(f);
+    return total;
+}
+/**
+ * faceCount — number of effective faces (upstream `_faces.Faces()` length).
+ * @param sk - Sketch
+ * @returns number
+ */
+export function faceCount(sk) {
+    const k = kernel();
+    let n = 0;
+    for (const f of sk.faces)
+        n += k.getSubShapes(f, 'face').length;
+    return n;
+}
+/**
+ * extrude — CadQuery `Sketch` → solid via extrusion along +Z. Phase 2 action 3:
+ * sketch → extrude/revolve dual-chain outlet. This is the brep side
+ * (kernel.extrude on each effective face, fused into one solid).
+ * @param sk - Sketch
+ * @param height - extrusion height
+ * @returns Shape (solid)
+ */
+export function extrude(sk, height) {
+    const k = kernel();
+    const solids = [];
+    for (const f of sk.faces) {
+        solids.push(k.extrude(f, 0, 0, height));
+    }
+    let acc = null;
+    for (const s of solids) {
+        if (!acc) {
+            acc = s;
+            continue;
+        }
+        const merged = k.fuse(acc, s);
+        k.release(acc);
+        k.release(s);
+        acc = merged;
+    }
+    if (!acc)
+        throw new Error('Sketch has no faces to extrude');
+    // Wrap the kernel handle into a faijs Shape so script-facing mirrors can
+    // export it as a part (bare kernel handles are invisible to execute()).
+    return fromHandle(acc);
+}
+/**
+ * Release all handles held by a Sketch (run at end of script/unit test).
+ * @param sk - Sketch whose kernel handles are released
+ */
+export function dispose(sk) {
+    const k = kernel();
+    for (const f of sk.faces)
+        k.release(f);
+    for (const [, fs] of sk.tags)
+        for (const f of fs)
+            k.release(f);
+    for (const e of sk.selected)
+        k.release(e);
+}
+//# sourceMappingURL=sketch.js.map

package/dist/sketch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sketch.js","sourceRoot":"","sources":["../src/sketch.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Sketch — CadQuery `Sketch.py` geometry-container parity (non-planegcs part).\n *\n * Phase 2 of the cq-compat max-cadquery plan: expose a public Sketch API whose\n * geometry-declaration segment (rect/circle/ellipse/polygon + modes a/s/i/c/r +\n * faces/wires/edges/vertices selectors) mirrors upstream `Sketch.py` without the\n * constraint solver (planegcs licensing is pending legal review; constraints are\n * intentionally out of scope here).\n *\n * The constraint segment (`constrain`/`solve`) stays blocked until the\n * LGPL-2.0-or-later verdict; this module implements everything that does not\n * depend on it.\n *\n * Faces are OCCT brep faces living in the z=0 plane (kernel `makeRectangle`,\n * `makeCircleEdge`/`makeWire`/`makeFace`, ...). Boolean modes use the kernel's\n * face-level fuse/cut/common (verified working on faces, see probe_2d).\n */\n\nimport { getKernel } from '@faicad/faijs/occt-kernel/occtKernel'\nimport { fromHandle } from '@faicad/faijs/sdk'\nimport type { OcctKernel, ShapeHandle, Vec3 } from 'occt-wasm'\n\n/** Sketch face-container state. */\nexport interface Sketch {\n  /** Current effective faces (upstream `_faces`). */\n  faces: ShapeHandle[]\n  /** Construction faces stored under their tag (mode \"c\"). */\n  tags: Map<string, ShapeHandle[]>\n  /** Selected entities (faces/wires/edges/vertices) feeding the next each(). */\n  selected: ShapeHandle[]\n  /** Pushed iteration locations (push/selection-derived). */\n  locs: Array<[number, number]>\n}\n\n/** Sketch geometry-declaration mode (CadQuery Modes): a=additive, s=subtract, i=intersect, c=construction+tag, r=replace. */\nexport type SketchMode = 'a' | 's' | 'i' | 'c' | 'r'\n\n/** Options for a geometry declaration: mode/tag/angle (CadQuery keyword args). */\nexport interface SketchOpts {\n  mode?: SketchMode\n  tag?: string\n  angle?: number\n}\n\nfunction kernel(): OcctKernel {\n  return getKernel() as unknown as OcctKernel\n}\n\n/** Vec3 literal helper (avoids TS tuple-inference noise). */\nfunction v3(x: number, y: number, z: number): Vec3 {\n  return { x, y, z }\n}\n\n/**\n * Create an empty Sketch.\n * @returns an empty Sketch\n */\nexport function sketch(): Sketch {\n  return { faces: [], tags: new Map(), selected: [], locs: [] }\n}\n\n/**\n * Translate a shape so its centre lands at the origin. Used to centre\n * kernel primitives that build in the [0,size] corner.\n */\nfunction centre2D(k: OcctKernel, h: ShapeHandle, w: number, d: number): ShapeHandle {\n  const moved = k.translate(h, -w / 2, -d / 2, 0)\n  k.release(h)\n  return moved\n}\n\n/** Rectangular face, centred at origin, w along X, h along Y. */\nfunction makeRectFace(k: OcctKernel, w: number, h: number): ShapeHandle {\n  return centre2D(k, k.makeRectangle(w, h), w, h)\n}\n\n/** Circular face of radius r centred at origin. */\nfunction makeCircleFace(k: OcctKernel, r: number): ShapeHandle {\n  const e = k.makeCircleEdge(v3(0, 0, 0), v3(0, 0, 1), r)\n  const wire = k.makeWire([e])\n  k.release(e)\n  const f = k.makeFace(wire)\n  k.release(wire)\n  return f\n}\n\n/** Elliptical face, major a along X, minor b along Y, centred at origin. */\nfunction makeEllipseFace(k: OcctKernel, a: number, b: number): ShapeHandle {\n  const e = k.makeEllipseEdge(v3(0, 0, 0), v3(0, 0, 1), a, b)\n  const wire = k.makeWire([e])\n  k.release(e)\n  const f = k.makeFace(wire)\n  k.release(wire)\n  return f\n}\n\n/** Polygon face from a closed point list (first==last optional; auto-closed). */\nfunction makePolygonFace(k: OcctKernel, pts: Array<[number, number]>): ShapeHandle {\n  // Drop the closing duplicate if present, then drop consecutive duplicates\n  // (OCCT makeLineEdge rejects zero-length edges, e.g. a 45-degree trapezoid\n  // degenerating into a triangle with two identical top corners).\n  const same = (a: [number, number], b: [number, number]) =>\n    Math.abs(a[0] - b[0]) < 1e-12 && Math.abs(a[1] - b[1]) < 1e-12\n  const fst = pts[0]\n  const lst = pts[pts.length - 1]\n  const ring = fst && lst && same(fst, lst) ? pts.slice(0, -1) : pts\n  const clean: Array<[number, number]> = []\n  for (const p of ring) {\n    const last = clean[clean.length - 1]\n    if (!last || !same(last, p)) clean.push(p)\n  }\n  if (clean.length < 3) throw new Error('polygon needs at least 3 distinct points')\n  const edges: ShapeHandle[] = []\n  for (let i = 0; i < clean.length; i++) {\n    const a = clean[i]\n    const b = clean[(i + 1) % clean.length]\n    edges.push(k.makeLineEdge(v3(a[0], a[1], 0), v3(b[0], b[1], 0)))\n  }\n  const wire = k.makeWire(edges)\n  edges.forEach((e) => k.release(e))\n  const f = k.makeFace(wire)\n  k.release(wire)\n  return f\n}\n\n/** Rotate a face by angle degrees about the Z axis through its centre. */\nfunction rotateFace(k: OcctKernel, f: ShapeHandle, angleDeg: number): ShapeHandle {\n  if (!angleDeg) return f\n  const rad = (angleDeg * Math.PI) / 180\n  const cos = Math.cos(rad)\n  const sin = Math.sin(rad)\n  const m = [cos, -sin, 0, 0, sin, cos, 0, 0, 0, 0, 1, 0]\n  const r = k.transform(f, m)\n  k.release(f)\n  return r\n}\n\n/**\n * Apply the CQ each() mode against the current faces.\n * - a: fuse all new faces into the current set (CQ `_faces.fuse(*res)`)\n * - s: cut new faces away\n * - i: intersect with new faces\n * - r: replace current faces with the new ones\n * - c: keep current faces; store new ones under the tag (required)\n */\nfunction applyMode(\n  k: OcctKernel,\n  faces: ShapeHandle[],\n  fresh: ShapeHandle[],\n  mode: SketchMode,\n  tag?: string,\n): { faces: ShapeHandle[]; tags: Map<string, ShapeHandle[]>; tagOut: Map<string, ShapeHandle[]> } {\n  const tagOut = new Map<string, ShapeHandle[]>()\n  switch (mode) {\n    case 'a': {\n      const all = [...faces, ...fresh]\n      if (all.length === 0) return { faces: [], tags: tagOut, tagOut }\n      let acc: ShapeHandle = all[0]\n      for (let i = 1; i < all.length; i++) {\n        const merged = k.fuse(acc, all[i])\n        k.release(acc)\n        k.release(all[i])\n        acc = merged\n      }\n      return { faces: [acc], tags: tagOut, tagOut }\n    }\n    case 's': {\n      let acc: ShapeHandle | null = faces.length ? faces[0] : null\n      if (!acc) return { faces: [], tags: tagOut, tagOut }\n      const rest = faces.slice(1)\n      for (const f of rest) {\n        const merged = k.fuse(acc, f)\n        k.release(acc)\n        k.release(f)\n        acc = merged\n      }\n      for (const f of fresh) {\n        const cut = k.cut(acc, f)\n        k.release(acc)\n        k.release(f)\n        acc = cut\n      }\n      return { faces: acc ? [acc] : [], tags: tagOut, tagOut }\n    }\n    case 'i': {\n      let acc: ShapeHandle | null = faces.length ? faces[0] : null\n      if (!acc) return { faces: [], tags: tagOut, tagOut }\n      for (const f of faces.slice(1)) {\n        const merged = k.fuse(acc, f)\n        k.release(acc)\n        k.release(f)\n        acc = merged\n      }\n      for (const f of fresh) {\n        const common = k.common(acc, f)\n        k.release(acc)\n        k.release(f)\n        acc = common\n      }\n      return { faces: acc ? [acc] : [], tags: tagOut, tagOut }\n    }\n    case 'c': {\n      if (!tag) throw new Error('No tag specified - the geometry will be unreachable')\n      tagOut.set(tag, fresh)\n      // current faces unchanged (fresh faces are construction-only)\n      return { faces, tags: tagOut, tagOut }\n    }\n    case 'r': {\n      return { faces: fresh, tags: tagOut, tagOut }\n    }\n    default:\n      throw new Error('Invalid mode: ' + String(mode))\n  }\n}\n\n/** Merge the mode result into a Sketch (fresh faces released on a/s/i/r paths). */\nfunction commit(sk: Sketch, mode: SketchMode, tag: string | undefined, fresh: ShapeHandle[]): Sketch {\n  const k = kernel()\n  const { faces, tagOut } = applyMode(k, sk.faces, fresh, mode, tag)\n  const tags = new Map(sk.tags)\n  for (const [t, fs] of tagOut) tags.set(t, fs)\n  return { faces, tags, selected: sk.selected, locs: sk.locs }\n}\n\n/**\n * rect — CadQuery `Sketch.rect(w, h, angle, mode, tag)` parity.\n * @param sk - Sketch\n * @param w - width along X\n * @param h - height along Y\n * @param opts - mode/tag/angle\n * @returns Sketch\n */\nexport function rect(sk: Sketch, w: number, h: number, opts?: SketchOpts): Sketch {\n  const k = kernel()\n  const mode = opts?.mode ?? 'a'\n  const face = rotateFace(k, makeRectFace(k, w, h), opts?.angle ?? 0)\n  return commit(sk, mode, opts?.tag, [face])\n}\n\n/**\n * circle — CadQuery `Sketch.circle(r, mode, tag)` parity.\n * @param sk - Sketch\n * @param r - radius\n * @param opts - mode/tag\n * @returns Sketch\n */\nexport function circle(sk: Sketch, r: number, opts?: SketchOpts): Sketch {\n  const k = kernel()\n  const mode = opts?.mode ?? 'a'\n  const face = makeCircleFace(k, r)\n  return commit(sk, mode, opts?.tag, [face])\n}\n\n/**\n * ellipse — CadQuery `Sketch.ellipse(a1, a2, angle, mode, tag)` parity.\n * @param sk - Sketch\n * @param a1 - radius along X\n * @param a2 - radius along Y\n * @param opts - mode/tag/angle\n * @returns Sketch\n */\nexport function ellipse(sk: Sketch, a1: number, a2: number, opts?: SketchOpts): Sketch {\n  const k = kernel()\n  const mode = opts?.mode ?? 'a'\n  const face = rotateFace(k, makeEllipseFace(k, a1, a2), opts?.angle ?? 0)\n  return commit(sk, mode, opts?.tag, [face])\n}\n\n/**\n * polygon — CadQuery `Sketch.polygon(pts, angle, mode, tag)` parity.\n * @param sk - Sketch\n * @param pts - closed point list [[x,y],...]\n * @param opts - mode/tag/angle\n * @returns Sketch\n */\nexport function polygon(sk: Sketch, pts: Array<[number, number]>, opts?: SketchOpts): Sketch {\n  const k = kernel()\n  const mode = opts?.mode ?? 'a'\n  const face = rotateFace(k, makePolygonFace(k, pts), opts?.angle ?? 0)\n  return commit(sk, mode, opts?.tag, [face])\n}\n\n/**\n * regularPolygon — CadQuery `Sketch.regularPolygon(r, n, angle, mode, tag)`\n * parity: n-gon inscribed in radius r, first vertex at the +Y direction.\n * @param sk - Sketch\n * @param r - circumradius\n * @param n - number of sides\n * @param opts - mode/tag/angle\n * @returns Sketch\n */\nexport function regularPolygon(sk: Sketch, r: number, n: number, opts?: SketchOpts): Sketch {\n  const pts: Array<[number, number]> = []\n  for (let i = 0; i <= n; i++) {\n    const a = (i * 2 * Math.PI) / n\n    pts.push([r * Math.sin(a), r * Math.cos(a)])\n  }\n  return polygon(sk, pts, opts)\n}\n\n/**\n * slot — CadQuery `Sketch.slot(w, h, angle, mode, tag)` parity: stadium / long\n * slot face of length w and width h, centred at origin.\n * @param sk - Sketch\n * @param w - slot length along X\n * @param h - slot width along Y\n * @param opts - mode/tag/angle\n * @returns Sketch\n */\nexport function slot(sk: Sketch, w: number, h: number, opts?: SketchOpts): Sketch {\n  const k = kernel()\n  const mode = opts?.mode ?? 'a'\n  const p1: [number, number] = [-w / 2, h / 2]\n  const p2: [number, number] = [w / 2, h / 2]\n  const p3: [number, number] = [-w / 2, -h / 2]\n  const p4: [number, number] = [w / 2, -h / 2]\n  const p5: [number, number] = [-w / 2 - h / 2, 0]\n  const p6: [number, number] = [w / 2 + h / 2, 0]\n  const e1 = k.makeLineEdge(v3(p1[0], p1[1], 0), v3(p2[0], p2[1], 0))\n  const e2 = k.makeArcEdge(v3(p2[0], p2[1], 0), v3(p6[0], p6[1], 0), v3(p4[0], p4[1], 0))\n  const e3 = k.makeLineEdge(v3(p4[0], p4[1], 0), v3(p3[0], p3[1], 0))\n  const e4 = k.makeArcEdge(v3(p3[0], p3[1], 0), v3(p5[0], p5[1], 0), v3(p1[0], p1[1], 0))\n  const wire = k.makeWire([e1, e2, e3, e4])\n  for (const e of [e1, e2, e3, e4]) k.release(e)\n  const face = k.makeFace(wire)\n  k.release(wire)\n  return commit(sk, mode, opts?.tag, [rotateFace(k, face, opts?.angle ?? 0)])\n}\n\n/**\n * trapezoid — CadQuery `Sketch.trapezoid(w, h, a1, a2, angle, mode, tag)`\n * parity: isosceles-or-not trapezoid; a1/a2 are the base angles in degrees.\n * @param sk - Sketch\n * @param w - bottom width\n * @param h - height\n * @param a1 - bottom-left base angle (degrees)\n * @param a2 - bottom-right base angle (degrees); defaults to a1\n * @param opts - mode/tag/angle\n * @returns Sketch\n */\nexport function trapezoid(sk: Sketch, w: number, h: number, a1: number, a2?: number, opts?: SketchOpts): Sketch {\n  const a2v = a2 ?? a1\n  const v1: [number, number] = [-w / 2, -h / 2]\n  const v2: [number, number] = [w / 2, -h / 2]\n  const t1 = h / Math.tan((a1 * Math.PI) / 180)\n  const t2 = h / Math.tan((a2v * Math.PI) / 180)\n  const v3: [number, number] = [-w / 2 + t1, h / 2]\n  const v4: [number, number] = [w / 2 - t2, h / 2]\n  return polygon(sk, [v1, v2, v4, v3, v1], opts)\n}\n\n/**\n * offset — CadQuery `Sketch.offset(d, mode, tag)` parity: offset each selected\n * wire by d and feed the resulting faces through the given mode. Requires a\n * selection (wires()/edges()).\n * @param sk - Sketch\n * @param d - signed offset distance\n * @param opts - mode/tag\n * @returns Sketch\n */\nexport function offset(sk: Sketch, d: number, opts?: SketchOpts): Sketch {\n  if (!sk.selected.length) throw new Error('Selection is needed to offset')\n  const k = kernel()\n  const mode = opts?.mode ?? 'a'\n  const fresh: ShapeHandle[] = []\n  for (const el of sk.selected) {\n    const off = k.offsetWire2D(el, d)\n    const f = k.makeFace(off)\n    k.release(off)\n    fresh.push(f)\n  }\n  return commit(sk, mode, opts?.tag, fresh)\n}\n\n/**\n * faces — CadQuery `Sketch.faces()` selector parity: select current faces.\n * @param sk - Sketch\n * @returns Sketch (selected faces feed the next geometric declaration)\n */\nexport function faces(sk: Sketch): Sketch {\n  // Upstream _faces.Faces() returns the TOPOLOGICAL faces; a fused face\n  // handle may hold several (e.g. two overlapping rects stay 2 faces after\n  // fuse, asserted by upstream test_modes). Flatten via getSubShapes.\n  const k = kernel()\n  const out: ShapeHandle[] = []\n  for (const f of sk.faces) {\n    const sub = k.getSubShapes(f, 'face') as unknown as ShapeHandle[]\n    out.push(...sub)\n  }\n  return { ...sk, selected: out }\n}\n\n/**\n * wires — CadQuery `Sketch.wires()` selector parity: select boundary wires of\n * the current faces.\n * @param sk - Sketch\n * @returns Sketch\n */\nexport function wires(sk: Sketch): Sketch {\n  const k = kernel()\n  const wires: ShapeHandle[] = []\n  for (const f of sk.faces) {\n    const w = k.outerWire(f)\n    wires.push(w)\n  }\n  return { ...sk, selected: wires }\n}\n\n/**\n * edges — CadQuery `Sketch.edges()` selector parity: select all edges of the\n * current faces.\n * @param sk - Sketch\n * @returns Sketch\n */\nexport function edges(sk: Sketch): Sketch {\n  const k = kernel()\n  const out: ShapeHandle[] = []\n  for (const f of sk.faces) {\n    const es = k.getSubShapes(f, 'edge') as unknown as ShapeHandle[]\n    out.push(...es)\n  }\n  return { ...sk, selected: out }\n}\n\n/**\n * vertices — CadQuery `Sketch.vertices()` selector parity: select all vertices\n * of the current faces.\n * @param sk - Sketch\n * @returns Sketch\n */\nexport function vertices(sk: Sketch): Sketch {\n  const k = kernel()\n  const out: ShapeHandle[] = []\n  for (const f of sk.faces) {\n    const vs = k.getSubShapes(f, 'vertex') as unknown as ShapeHandle[]\n    out.push(...vs)\n  }\n  return { ...sk, selected: out }\n}\n\n/**\n * reset — CadQuery `Sketch.reset()` parity: clear the selection so the next\n * geometric declaration applies to the whole sketch.\n * @param sk - Sketch\n * @returns Sketch\n */\nexport function reset(sk: Sketch): Sketch {\n  return { ...sk, selected: [] }\n}\n\n/**\n * val — CadQuery `Sketch.val()` parity: first effective face as a Shape.\n * @param sk - Sketch\n * @returns Shape\n */\nexport function val(sk: Sketch): ShapeHandle {\n  const v = vals(sk)\n  if (!v.length) throw new Error('Sketch has no faces')\n  return v[0]\n}\n\n/**\n * vals — CadQuery `Sketch.vals()` parity: the current selection, or the\n * flattened topological faces when nothing is selected (upstream returns the\n * `_faces` faces; a fused handle may hold several).\n * @param sk - Sketch\n * @returns Shape[]\n */\nexport function vals(sk: Sketch): ShapeHandle[] {\n  if (sk.selected.length) return [...sk.selected]\n  const k = kernel()\n  const out: ShapeHandle[] = []\n  for (const f of sk.faces) {\n    const sub = k.getSubShapes(f, 'face') as unknown as ShapeHandle[]\n    out.push(...sub)\n  }\n  return out\n}\n\n/**\n * tag — CadQuery `Sketch.tag(name)` parity: store the current selection (or all\n * faces when nothing selected) under a name for later `.select()`.\n * @param sk - Sketch\n * @param name - tag name\n * @returns Sketch\n */\nexport function tag(sk: Sketch, name: string): Sketch {\n  const tags = new Map(sk.tags)\n  const payload = sk.selected.length ? sk.selected : sk.faces\n  tags.set(name, [...payload])\n  return { ...sk, tags }\n}\n\n/**\n * select — CadQuery `Sketch.select(tag)` parity: select the faces stored under\n * a tag.\n * @param sk - Sketch\n * @param name - tag name\n * @returns Sketch\n */\nexport function select(sk: Sketch, name: string): Sketch {\n  const payload = sk.tags.get(name)\n  if (!payload) throw new Error('Tag not found: ' + name)\n  return { ...sk, selected: [...payload] }\n}\n\n/**\n * area — total surface area of the effective faces (upstream `_faces.Area()`).\n * @param sk - Sketch\n * @returns number\n */\nexport function area(sk: Sketch): number {\n  const k = kernel()\n  let total = 0\n  for (const f of sk.faces) total += k.getSurfaceArea(f)\n  return total\n}\n\n/**\n * faceCount — number of effective faces (upstream `_faces.Faces()` length).\n * @param sk - Sketch\n * @returns number\n */\nexport function faceCount(sk: Sketch): number {\n  const k = kernel()\n  let n = 0\n  for (const f of sk.faces) n += (k.getSubShapes(f, 'face') as unknown as ShapeHandle[]).length\n  return n\n}\n\n/**\n * extrude — CadQuery `Sketch` → solid via extrusion along +Z. Phase 2 action 3:\n * sketch → extrude/revolve dual-chain outlet. This is the brep side\n * (kernel.extrude on each effective face, fused into one solid).\n * @param sk - Sketch\n * @param height - extrusion height\n * @returns Shape (solid)\n */\nexport function extrude(sk: Sketch, height: number): ShapeHandle {\n  const k = kernel()\n  const solids: ShapeHandle[] = []\n  for (const f of sk.faces) {\n    solids.push(k.extrude(f, 0, 0, height))\n  }\n  let acc: ShapeHandle | null = null\n  for (const s of solids) {\n    if (!acc) {\n      acc = s\n      continue\n    }\n    const merged = k.fuse(acc, s)\n    k.release(acc)\n    k.release(s)\n    acc = merged\n  }\n  if (!acc) throw new Error('Sketch has no faces to extrude')\n  // Wrap the kernel handle into a faijs Shape so script-facing mirrors can\n  // export it as a part (bare kernel handles are invisible to execute()).\n  return fromHandle(acc) as unknown as ShapeHandle\n}\n\n/**\n * Release all handles held by a Sketch (run at end of script/unit test).\n * @param sk - Sketch whose kernel handles are released\n */\nexport function dispose(sk: Sketch): void {\n  const k = kernel()\n  for (const f of sk.faces) k.release(f)\n  for (const [, fs] of sk.tags) for (const f of fs) k.release(f)\n  for (const e of sk.selected) k.release(e)\n}\n"]}

package/dist/workplane.d.ts

@@ -186,6 +186,19 @@ export interface Workplane {
     firstPoint?: [number, number];
     /** Optional color (sRGB 0..1) for this part. */
     color?: RGB;
+    /**
+     * Tagged workplane snapshots (CadQuery .tag()), keyed by tag name.
+     * Each snapshot records the plane frame and carried shape so
+     * workplaneFromTagged can jump back to the marked plane.
+     */
+    tags?: Record<string, TaggedWorkplane>;
+}
+/** Snapshot captured by 	ag(): plane frame + carried shape. */
+export interface TaggedWorkplane {
+    origin: [number, number, number];
+    xDir: [number, number, number];
+    normal: [number, number, number];
+    shape: Shape | null;
 }
 /**
  * Resolve a CadQuery-style face selector string to the selected face's center
@@ -703,6 +716,15 @@ export declare function cskHole(wp: Workplane, diameter: number, cskDiameter: nu
  * @returns Promise<Workplane>
  */
 export declare function threadedHole(wp: Workplane, diameterOrFastener: number | unknown, depth?: number): Promise<Workplane>;
+/**
+ * siblings — CadQuery Shape.siblings：拓扑邻接选择（Phase 3）。
+ * @param start - 起点（Workplane 带 faceSel/edgeSel，或 Shape）。
+ * @param ctxShape - 邻接搜索的容器 shape（CadQuery 的 ctx）。
+ * @param kind - 链接实体类型：'Edge'（返回面网络）| 'Vertex'（返回边网络）| 'Face'。
+ * @param level - 拓扑距离：int 或 int 数组（各层并集，每层独立排除）。
+ * @returns Promise<Workplane> 选中的实体集合（shape = 实体 compound；空集返回空 compound）。
+ */
+export declare function siblings(start: Shape | Workplane, ctxShape: Shape | Workplane, kind: 'Edge' | 'Vertex' | 'Face', level: number | number[]): Promise<Workplane>;
 /**
  * faces
  * @param wp - Workplane
@@ -710,6 +732,31 @@ export declare function threadedHole(wp: Workplane, diameterOrFastener: number |
  * @returns Workplane
  */
 export declare function faces(wp: Workplane, sel: string): Workplane;
+/**
+ * tag — CadQuery Workplane.tag(name) parity (dataflow carrier).
+ *
+ * Upstream records the current workplane state (origin/xDir/normal + current
+ * objects) under a name so a later workplaneFromTagged can jump back to it.
+ * The faijs carrier keeps a snapshot of the plane frame and the carried
+ * shape; the tagged objects stay the current shape's sub-shapes.
+ *
+ * @param wp - Workplane to mark
+ * @param name - Tag name
+ * @returns Workplane carrying the tag snapshot
+ */
+export declare function tag(wp: Workplane, name: string): Workplane;
+/**
+ * workplaneFromTagged — CadQuery Workplane.workplaneFromTagged(name) parity.
+ *
+ * Restores the workplane frame (origin/xDir/normal) and carried shape captured
+ * by an earlier 	ag(name). Points/selectors are reset (upstream jumps back
+ * to the tagged plane with an empty stack).
+ *
+ * @param wp - Workplane carrying the tags
+ * @param name - Tag name to restore
+ * @returns Workplane restored to the tagged plane
+ */
+export declare function workplaneFromTagged(wp: Workplane, name: string): Workplane;
 /**
  * edges
  * @param wp - Workplane