@faicad/faijs 0.22.2 → 0.29.5

package/dist/api/cadquery-selectors/grammar.js

@@ -0,0 +1,345 @@
+/**
+ * cadquery-selectors/grammar — CadQuery string-syntax selector grammar.
+ *
+ * Hand-rolled recursive-descent parser mirroring the upstream grammar
+ * `cadquery/selectors.py::_makeGrammar` + `_makeExpressionGrammar`. No
+ * pyparsing dependency is introduced; this small grammar is hand-parsed.
+ *
+ * Precedence (pyparsing infix_notation lists operators lowest→highest):
+ *   `and` (lowest) < `or` < `exc`/`except` < `not` (highest)
+ * so `not` binds tightest and `and` sits at the root of the tree.
+ *
+ * Atom forms (upstream `_makeGrammar`):
+ *   * bare direction        `X`|`Y`|`Z`|`XY`|`XZ`|`YZ`|`(x,y,z)`  → DirectionSelector
+ *   * named view            `front`|`back`|`left`|`right`|`top`|`bottom` → DirectionMinMax
+ *   * `%TYPE`               type_op + caseless LUT member (upcased)  → TypeSelector
+ *   * `>A` / `>A[k]`        direction_op + dir + optional index  → DirectionNth
+ *   * `>>A` / `<<A[k]`      center_nth_op + dir + optional index  → CenterNth
+ *   * `|A`|`#A`|`+A`|`-A`    other_op + direction  → Parallel / Perp / Direction
+ *
+ * Binary operators fold their operands into a single n-ary node, matching the
+ * pyparsing odd-indexed reduce in the upstream callbacks.
+ */
+/**
+ * The complete set of syntax features this grammar supports, in one place.
+ * The selector-parity plan drives its coverage gate off this list — adding a
+ * syntax feature without a coverage entry fails that gate.
+ */
+export const SYNTAX_FEATURES = [
+    // operator modifiers
+    ...['>', '<', '>>', '<<', '|', '#', '+', '-', '%'].map((token) => ({
+        group: 'modifier',
+        name: token,
+        token,
+    })),
+    // axes
+    ...['X', 'Y', 'Z', 'XY', 'XZ', 'YZ', '(x,y,z)'].map((token) => ({
+        group: 'axis',
+        name: token,
+        token,
+    })),
+    // type filter
+    ...['PLANE', 'CYLINDER', 'CONE', 'SPHERE', 'TORUS', 'BEZIER', 'BSPLINE', 'REVOLUTION', 'EXTRUSION', 'OFFSET', 'OTHER', 'LINE', 'CIRCLE', 'ELLIPSE', 'HYPERBOLA', 'PARABOLA'].map((token) => ({ group: 'type', name: token.toLowerCase(), token })),
+    // named views
+    ...['front', 'back', 'left', 'right', 'top', 'bottom'].map((token) => ({
+        group: 'view',
+        name: token,
+        token,
+    })),
+    // logical connectives
+    ...['and', 'or', 'exc', 'except', 'not'].map((token) => ({
+        group: 'logical',
+        name: token,
+        token,
+    })),
+    // index suffix
+    { group: 'index', name: '[k]', token: '[k]' },
+];
+/** Named views → (direction, max) — upstream `_SimpleStringSyntaxSelector.namedViews`. */
+export const NAMED_VIEW = {
+    front: { vec: { x: 0, y: 0, z: 1 }, max: true },
+    back: { vec: { x: 0, y: 0, z: 1 }, max: false },
+    left: { vec: { x: 1, y: 0, z: 0 }, max: false },
+    right: { vec: { x: 1, y: 0, z: 0 }, max: true },
+    top: { vec: { x: 0, y: 1, z: 0 }, max: true },
+    bottom: { vec: { x: 0, y: 1, z: 0 }, max: false },
+};
+/** Axes table — upstream `_SimpleStringSyntaxSelector.axes` (kept NON-unit). */
+export const AXES = {
+    X: { x: 1, y: 0, z: 0 },
+    Y: { x: 0, y: 1, z: 0 },
+    Z: { x: 0, y: 0, z: 1 },
+    XY: { x: 1, y: 1, z: 0 },
+    YZ: { x: 0, y: 1, z: 1 },
+    XZ: { x: 1, y: 0, z: 1 },
+};
+/** Valid `%type` names — union of upstream geom_LUT_EDGE ∪ geom_LUT_FACE values. */
+export const TYPE_NAMES = new Set([
+    'PLANE', 'CYLINDER', 'CONE', 'SPHERE', 'TORUS', 'BEZIER', 'BSPLINE',
+    'REVOLUTION', 'EXTRUSION', 'OFFSET', 'OTHER',
+    'LINE', 'CIRCLE', 'ELLIPSE', 'HYPERBOLA', 'PARABOLA',
+]);
+function lex(src) {
+    const out = [];
+    let i = 0;
+    const n = src.length;
+    while (i < n) {
+        const c = src[i];
+        if (/\s/.test(c)) {
+            i++;
+            continue;
+        }
+        // multi-char direction selectors must be checked before their single char
+        if ((c === '>' || c === '<') && src[i + 1] === c) {
+            out.push({ t: 'op', v: c + c });
+            i += 2;
+            continue;
+        }
+        if (c === '(' || c === ')' || c === '[' || c === ']' || c === ',') {
+            out.push({ t: 'op', v: c });
+            i++;
+            continue;
+        }
+        if (c === '>' || c === '<' || c === '|' || c === '#' || c === '%') {
+            out.push({ t: 'op', v: c });
+            i++;
+            continue;
+        }
+        // `+` and `-` are context-dependent: operator (`+Z`) or sign (`[-1]`, `(-1,0,0)`).
+        if (c === '+' || c === '-') {
+            out.push({ t: 'op', v: c });
+            i++;
+            continue;
+        }
+        if (/[0-9]/.test(c) || c === '.') {
+            let j = i;
+            while (j < n && /[0-9.]/.test(src[j]))
+                j++;
+            out.push({ t: 'num', v: src.slice(i, j) });
+            i = j;
+            continue;
+        }
+        if (/[A-Za-z]/.test(c)) {
+            let j = i;
+            while (j < n && /[A-Za-z0-9_]/.test(src[j]))
+                j++;
+            out.push({ t: 'word', v: src.slice(i, j) });
+            i = j;
+            continue;
+        }
+        throw new SyntaxError(`[cadquery-selectors] unexpected character "${c}" at ${i}`);
+    }
+    return out;
+}
+// ── Parser (recursive descent over tokens) ──────────────────────────────────
+class Parser {
+    toks;
+    pos = 0;
+    constructor(src) {
+        this.toks = lex(src);
+    }
+    peek() {
+        return this.toks[this.pos];
+    }
+    next() {
+        return this.toks[this.pos++];
+    }
+    eof() {
+        return this.pos >= this.toks.length;
+    }
+    /** Consume an operator token with value `v`, or throw. */
+    eatOp(v) {
+        const t = this.peek();
+        if (!t || t.t !== 'op' || t.v !== v) {
+            throw new SyntaxError(`[cadquery-selectors] expected "${v}"`);
+        }
+        this.pos++;
+    }
+    /** Look at current token: is it an operator token with value v? */
+    atOp(v) {
+        const t = this.peek();
+        return !!t && t.t === 'op' && t.v === v;
+    }
+    /** Look at current token: is it the given keyword (case-insensitive)? */
+    atWord(w) {
+        const t = this.peek();
+        return !!t && t.t === 'word' && t.v.toLowerCase() === w;
+    }
+    parse() {
+        const expr = this.parseAnd();
+        if (!this.eof()) {
+            throw new SyntaxError(`[cadquery-selectors] trailing input at position ${this.pos}`);
+        }
+        return expr;
+    }
+    // `and` — lowest precedence; left-associative n-ary fold.
+    parseAnd() {
+        const terms = [this.parseOr()];
+        while (this.atWord('and')) {
+            this.pos++;
+            terms.push(this.parseOr());
+        }
+        return terms.length === 1 ? terms[0] : { op: 'and', terms };
+    }
+    parseOr() {
+        const terms = [this.parseExc()];
+        while (this.atWord('or')) {
+            this.pos++;
+            terms.push(this.parseExc());
+        }
+        return terms.length === 1 ? terms[0] : { op: 'or', terms };
+    }
+    parseExc() {
+        const terms = [this.parseNot()];
+        while (this.atWord('exc') || this.atWord('except')) {
+            this.pos++;
+            terms.push(this.parseNot());
+        }
+        return terms.length === 1 ? terms[0] : { op: 'exc', terms };
+    }
+    // `not` — highest precedence, unary, right-associative.
+    parseNot() {
+        if (this.atWord('not')) {
+            this.pos++;
+            return { op: 'not', term: this.parseNot() };
+        }
+        if (this.atOp('(')) {
+            this.pos++;
+            const inner = this.parseAnd();
+            this.eatOp(')');
+            return inner;
+        }
+        return { op: 'atom', desc: this.parseAtom() };
+    }
+    /** Parse an axis directive: bare word (X/Y/Z/XY/YZ/XZ) or `(x,y,z)` vector. */
+    parseDirection() {
+        const t = this.peek();
+        if (t && t.t === 'word') {
+            const up = t.v.toUpperCase();
+            if (up in AXES) {
+                this.pos++;
+                return AXES[up];
+            }
+            return null;
+        }
+        if (t && t.t === 'op' && t.v === '(') {
+            this.pos++;
+            const x = this.parseNumber();
+            this.eatOp(',');
+            const y = this.parseNumber();
+            this.eatOp(',');
+            const z = this.parseNumber();
+            this.eatOp(')');
+            return { x, y, z };
+        }
+        return null;
+    }
+    /**
+     * Parse a numeric literal, allowing an optional leading `+`/`-`. Numeric
+     * grammar from upstream: integer [. [integer]] where integer = sign? digits.
+     */
+    parseNumber() {
+        let sign = 1;
+        if (this.atOp('-') || this.atOp('+')) {
+            if (this.atOp('-'))
+                sign = -1;
+            this.pos++;
+        }
+        // ensure a numeric literal follows the sign
+        if (!this.peek() || this.peek().t !== 'num') {
+            throw new SyntaxError('[cadquery-selectors] expected a number');
+        }
+        const raw = this.next().v;
+        const v = Number(raw);
+        if (!Number.isFinite(v))
+            throw this.error('invalid number');
+        return sign * v;
+    }
+    /** Consume an optional index `[k]` where k is a signed integer; null if absent. */
+    parseIndex() {
+        if (!this.atOp('['))
+            return null;
+        this.pos++;
+        const n = Math.trunc(this.parseNumber());
+        this.eatOp(']');
+        return { n };
+    }
+    error(msg) {
+        return new SyntaxError(`[cadquery-selectors] ${msg}`);
+    }
+    /** Parse a single atom (a leaf of the expression). Throws on unknown atom. */
+    parseAtom() {
+        const t = this.peek();
+        if (!t)
+            throw this.error('unexpected end of expression');
+        // 1. bare direction — a word that is an axis name maps to DirectionSelector.
+        if (t.t === 'word' && t.v.toUpperCase() in AXES) {
+            this.pos++;
+            return { kind: 'dir', vec: AXES[t.v.toUpperCase()] };
+        }
+        // 2. %TYPE
+        if (t.t === 'op' && t.v === '%') {
+            this.pos++;
+            const nameT = this.next();
+            if (!nameT || nameT.t !== 'word')
+                throw this.error('`%` must be followed by a geometry type');
+            const up = nameT.v.toUpperCase();
+            if (!TYPE_NAMES.has(up))
+                throw this.error(`invalid geometry type "%${nameT.v}"`);
+            return { kind: 'type', name: up };
+        }
+        // 3./4. direction ops and center nth ops
+        if (t.t === 'op' && (t.v === '>>' || t.v === '<<')) {
+            this.pos++;
+            const vec = this.parseDirection();
+            if (!vec)
+                throw this.error('expected an axis or vector after `' + t.v + '`');
+            const idx = this.parseIndex();
+            const max = t.v === '>>';
+            return { kind: 'centerNth', vec, max, n: idx ? idx.n : null };
+        }
+        if (t.t === 'op' && (t.v === '>' || t.v === '<')) {
+            this.pos++;
+            const vec = this.parseDirection();
+            if (!vec)
+                throw this.error('expected an axis direction after `' + t.v + '`');
+            const max = t.v === '>';
+            const idx = this.parseIndex();
+            if (idx)
+                return { kind: 'minmaxNth', vec, max, n: idx.n };
+            return { kind: 'minmax', vec, max };
+        }
+        // 5. other_op — `|` `#` `+` `-`
+        if (t.t === 'op' && (t.v === '|' || t.v === '#' || t.v === '+' || t.v === '-')) {
+            this.pos++;
+            const vec = this.parseDirection();
+            if (!vec)
+                throw this.error(`expected an axis direction after \`${t.v}\``);
+            if (t.v === '|')
+                return { kind: 'parallel', vec };
+            if (t.v === '#')
+                return { kind: 'perpendicular', vec };
+            return { kind: 'signed', vec, sign: t.v === '+' ? 1 : -1 };
+        }
+        // 6. named view
+        if (t.t === 'word' && t.v.toLowerCase() in NAMED_VIEW) {
+            this.pos++;
+            const nv = NAMED_VIEW[t.v.toLowerCase()];
+            return { kind: 'minmax', vec: nv.vec, max: nv.max };
+        }
+        throw this.error(`unsupported selector atom near "${JSON.stringify(t)}"`);
+    }
+}
+/**
+ * Parse a raw CadQuery selector expression string into an AST.
+ *
+ * @param expr - The CadQuery selector string (e.g. `">Z and |X"`).
+ * @returns The parsed selector AST.
+ */
+export function parseSelector(expr) {
+    if (expr == null || expr.trim() === '') {
+        throw new SyntaxError('[cadquery-selectors] selector expression may not be empty');
+    }
+    return new Parser(expr).parse();
+}
+//# sourceMappingURL=grammar.js.map

package/dist/api/cadquery-selectors/grammar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.js","sourceRoot":"","sources":["../../../src/api/cadquery-selectors/grammar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAqD;IAC/E,qBAAqB;IACrB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACjE,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,KAAK;QACX,KAAK;KACN,CAAC,CAAC;IACH,OAAO;IACP,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC9D,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,KAAK;QACX,KAAK;KACN,CAAC,CAAC;IACH,cAAc;IACd,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,GAAG,CAC9K,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,CACjE;IACD,cAAc;IACd,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrE,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,KAAK;QACX,KAAK;KACN,CAAC,CAAC;IACH,sBAAsB;IACtB,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACvD,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,KAAK;QACX,KAAK;KACN,CAAC,CAAC;IACH,eAAe;IACf,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;CAC9C,CAAA;AAED,0FAA0F;AAC1F,MAAM,CAAC,MAAM,UAAU,GAAgD;IACrE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE;IAC/C,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE;IAC/C,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE;IAC/C,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE;IAC/C,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE;IAC7C,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE;CAClD,CAAA;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,IAAI,GAAyB;IACxC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACvB,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACvB,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACvB,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACxB,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACxB,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;CACzB,CAAA;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,UAAU,GAAwB,IAAI,GAAG,CAAC;IACrD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS;IACnE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO;IAC5C,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU;CACrD,CAAC,CAAA;AASF,SAAS,GAAG,CAAC,GAAW;IACtB,MAAM,GAAG,GAAU,EAAE,CAAA;IACrB,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAA;IACpB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;QAChB,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,CAAC,EAAE,CAAA;YACH,SAAQ;QACV,CAAC;QACD,0EAA0E;QAC1E,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YAC/B,CAAC,IAAI,CAAC,CAAA;YACN,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YAClE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;YAC3B,CAAC,EAAE,CAAA;YACH,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YAClE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;YAC3B,CAAC,EAAE,CAAA;YACH,SAAQ;QACV,CAAC;QACD,mFAAmF;QACnF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;YAC3B,CAAC,EAAE,CAAA;YACH,SAAQ;QACV,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YACjC,IAAI,CAAC,GAAG,CAAC,CAAA;YACT,OAAO,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAAE,CAAC,EAAE,CAAA;YAC1C,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;YAC1C,CAAC,GAAG,CAAC,CAAA;YACL,SAAQ;QACV,CAAC;QACD,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,GAAG,CAAC,CAAA;YACT,OAAO,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAAE,CAAC,EAAE,CAAA;YAChD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;YAC3C,CAAC,GAAG,CAAC,CAAA;YACL,SAAQ;QACV,CAAC;QACD,MAAM,IAAI,WAAW,CAAC,8CAA8C,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IACnF,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,+EAA+E;AAE/E,MAAM,MAAM;IACO,IAAI,CAAO;IACpB,GAAG,GAAG,CAAC,CAAA;IAEf,YAAY,GAAW;QACrB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;IACtB,CAAC;IAEO,IAAI;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;IAEO,IAAI;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IAC9B,CAAC;IAEO,GAAG;QACT,OAAO,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAA;IACrC,CAAC;IAED,0DAA0D;IAClD,KAAK,CAAC,CAAS;QACrB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QACrB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,WAAW,CAAC,kCAAkC,CAAC,GAAG,CAAC,CAAA;QAC/D,CAAC;QACD,IAAI,CAAC,GAAG,EAAE,CAAA;IACZ,CAAC;IAED,mEAAmE;IAC3D,IAAI,CAAC,CAAS;QACpB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QACrB,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACzC,CAAC;IAED,yEAAyE;IACjE,MAAM,CAAC,CAAS;QACtB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QACrB,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;IACzD,CAAC;IAED,KAAK;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;QAC5B,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAChB,MAAM,IAAI,WAAW,CAAC,mDAAmD,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;QACtF,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,0DAA0D;IAClD,QAAQ;QACd,MAAM,KAAK,GAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;QAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,EAAE,CAAA;YACV,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;QAC5B,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;IAC9D,CAAC;IAEO,OAAO;QACb,MAAM,KAAK,GAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;QAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,GAAG,EAAE,CAAA;YACV,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;QAC7B,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IAC7D,CAAC;IAEO,QAAQ;QACd,MAAM,KAAK,GAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;QAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,GAAG,EAAE,CAAA;YACV,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;QAC7B,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;IAC9D,CAAC;IAED,wDAAwD;IAChD,QAAQ;QACd,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,GAAG,EAAE,CAAA;YACV,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAA;QAC7C,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,EAAE,CAAA;YACV,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;YAC7B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YACf,OAAO,KAAK,CAAA;QACd,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAA;IAC/C,CAAC;IAED,+EAA+E;IACvE,cAAc;QACpB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QACrB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;YACxB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;YAC5B,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;gBACf,IAAI,CAAC,GAAG,EAAE,CAAA;gBACV,OAAO,IAAI,CAAC,EAAE,CAAE,CAAA;YAClB,CAAC;YACD,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACrC,IAAI,CAAC,GAAG,EAAE,CAAA;YACV,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;YAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YACf,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;YAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YACf,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;YAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YACf,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;QACpB,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;OAGG;IACK,WAAW;QACjB,IAAI,IAAI,GAAG,CAAC,CAAA;QACZ,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,IAAI,GAAG,CAAC,CAAC,CAAA;YAC7B,IAAI,CAAC,GAAG,EAAE,CAAA;QACZ,CAAC;QACD,4CAA4C;QAC5C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,EAAG,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;YAC7C,MAAM,IAAI,WAAW,CAAC,wCAAwC,CAAC,CAAA;QACjE,CAAC;QACD,MAAM,GAAG,GAAI,IAAI,CAAC,IAAI,EAAyB,CAAC,CAAC,CAAA;QACjD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QACrB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAA;QAC3D,OAAO,IAAI,GAAG,CAAC,CAAA;IACjB,CAAC;IAED,mFAAmF;IAC3E,UAAU;QAChB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;QAChC,IAAI,CAAC,GAAG,EAAE,CAAA;QACV,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;QACxC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACf,OAAO,EAAE,CAAC,EAAE,CAAA;IACd,CAAC;IAEO,KAAK,CAAC,GAAW;QACvB,OAAO,IAAI,WAAW,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAA;IACvD,CAAC;IAED,8EAA8E;IACtE,SAAS;QACf,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QACrB,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAA;QAExD,6EAA6E;QAC7E,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC;YAChD,IAAI,CAAC,GAAG,EAAE,CAAA;YACV,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAE,EAAE,CAAA;QACvD,CAAC;QAED,WAAW;QACX,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAChC,IAAI,CAAC,GAAG,EAAE,CAAA;YACV,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;YACzB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,KAAK,MAAM;gBAAE,MAAM,IAAI,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAA;YAC7F,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;YAChC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,MAAM,IAAI,CAAC,KAAK,CAAC,2BAA2B,KAAK,CAAC,CAAC,GAAG,CAAC,CAAA;YAChF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;QACnC,CAAC;QAED,yCAAyC;QACzC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,GAAG,EAAE,CAAA;YACV,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;YACjC,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,CAAC,KAAK,CAAC,oCAAoC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAA;YAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAA;YAC7B,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;YACxB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAC/D,CAAC;QACD,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,GAAG,EAAE,CAAA;YACV,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;YACjC,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,CAAC,KAAK,CAAC,oCAAoC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAA;YAC5E,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAA;YACvB,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAA;YAC7B,IAAI,GAAG;gBAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAA;YACzD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;QACrC,CAAC;QACD,gCAAgC;QAChC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YAC/E,IAAI,CAAC,GAAG,EAAE,CAAA;YACV,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;YACjC,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;YACzE,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG;gBAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,CAAA;YACjD,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG;gBAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,CAAA;YACtD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC5D,CAAC;QAED,gBAAgB;QAChB,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,UAAU,EAAE,CAAC;YACtD,IAAI,CAAC,GAAG,EAAE,CAAA;YACV,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAE,CAAA;YACzC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAA;QACrD,CAAC;QAED,MAAM,IAAI,CAAC,KAAK,CAAC,mCAAmC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAC3E,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,WAAW,CAAC,2DAA2D,CAAC,CAAA;IACpF,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAA;AACjC,CAAC","sourcesContent":["/**\n * cadquery-selectors/grammar — CadQuery string-syntax selector grammar.\n *\n * Hand-rolled recursive-descent parser mirroring the upstream grammar\n * `cadquery/selectors.py::_makeGrammar` + `_makeExpressionGrammar`. No\n * pyparsing dependency is introduced; this small grammar is hand-parsed.\n *\n * Precedence (pyparsing infix_notation lists operators lowest→highest):\n *   `and` (lowest) < `or` < `exc`/`except` < `not` (highest)\n * so `not` binds tightest and `and` sits at the root of the tree.\n *\n * Atom forms (upstream `_makeGrammar`):\n *   * bare direction        `X`|`Y`|`Z`|`XY`|`XZ`|`YZ`|`(x,y,z)`  → DirectionSelector\n *   * named view            `front`|`back`|`left`|`right`|`top`|`bottom` → DirectionMinMax\n *   * `%TYPE`               type_op + caseless LUT member (upcased)  → TypeSelector\n *   * `>A` / `>A[k]`        direction_op + dir + optional index  → DirectionNth\n *   * `>>A` / `<<A[k]`      center_nth_op + dir + optional index  → CenterNth\n *   * `|A`|`#A`|`+A`|`-A`    other_op + direction  → Parallel / Perp / Direction\n *\n * Binary operators fold their operands into a single n-ary node, matching the\n * pyparsing odd-indexed reduce in the upstream callbacks.\n */\n\nimport type { AtomDesc, SelectorExpr, Vec3 } from './types'\n\n/**\n * The complete set of syntax features this grammar supports, in one place.\n * The selector-parity plan drives its coverage gate off this list — adding a\n * syntax feature without a coverage entry fails that gate.\n */\nexport const SYNTAX_FEATURES: { group: string; name: string; token: string }[] = [\n  // operator modifiers\n  ...['>', '<', '>>', '<<', '|', '#', '+', '-', '%'].map((token) => ({\n    group: 'modifier',\n    name: token,\n    token,\n  })),\n  // axes\n  ...['X', 'Y', 'Z', 'XY', 'XZ', 'YZ', '(x,y,z)'].map((token) => ({\n    group: 'axis',\n    name: token,\n    token,\n  })),\n  // type filter\n  ...['PLANE', 'CYLINDER', 'CONE', 'SPHERE', 'TORUS', 'BEZIER', 'BSPLINE', 'REVOLUTION', 'EXTRUSION', 'OFFSET', 'OTHER', 'LINE', 'CIRCLE', 'ELLIPSE', 'HYPERBOLA', 'PARABOLA'].map(\n    (token) => ({ group: 'type', name: token.toLowerCase(), token }),\n  ),\n  // named views\n  ...['front', 'back', 'left', 'right', 'top', 'bottom'].map((token) => ({\n    group: 'view',\n    name: token,\n    token,\n  })),\n  // logical connectives\n  ...['and', 'or', 'exc', 'except', 'not'].map((token) => ({\n    group: 'logical',\n    name: token,\n    token,\n  })),\n  // index suffix\n  { group: 'index', name: '[k]', token: '[k]' },\n]\n\n/** Named views → (direction, max) — upstream `_SimpleStringSyntaxSelector.namedViews`. */\nexport const NAMED_VIEW: Record<string, { vec: Vec3; max: boolean }> = {\n  front: { vec: { x: 0, y: 0, z: 1 }, max: true },\n  back: { vec: { x: 0, y: 0, z: 1 }, max: false },\n  left: { vec: { x: 1, y: 0, z: 0 }, max: false },\n  right: { vec: { x: 1, y: 0, z: 0 }, max: true },\n  top: { vec: { x: 0, y: 1, z: 0 }, max: true },\n  bottom: { vec: { x: 0, y: 1, z: 0 }, max: false },\n}\n\n/** Axes table — upstream `_SimpleStringSyntaxSelector.axes` (kept NON-unit). */\nexport const AXES: Record<string, Vec3> = {\n  X: { x: 1, y: 0, z: 0 },\n  Y: { x: 0, y: 1, z: 0 },\n  Z: { x: 0, y: 0, z: 1 },\n  XY: { x: 1, y: 1, z: 0 },\n  YZ: { x: 0, y: 1, z: 1 },\n  XZ: { x: 1, y: 0, z: 1 },\n}\n\n/** Valid `%type` names — union of upstream geom_LUT_EDGE ∪ geom_LUT_FACE values. */\nexport const TYPE_NAMES: ReadonlySet<string> = new Set([\n  'PLANE', 'CYLINDER', 'CONE', 'SPHERE', 'TORUS', 'BEZIER', 'BSPLINE',\n  'REVOLUTION', 'EXTRUSION', 'OFFSET', 'OTHER',\n  'LINE', 'CIRCLE', 'ELLIPSE', 'HYPERBOLA', 'PARABOLA',\n])\n\n// ── Lexer ───────────────────────────────────────────────────────────────────\n\ntype Tok =\n  | { t: 'op'; v: string } // multi/single-char operator or bracket / comma\n  | { t: 'word'; v: string } // identifier / keyword (upstream Word())\n  | { t: 'num'; v: string } // numeric literal string (kept raw; no sign)\n\nfunction lex(src: string): Tok[] {\n  const out: Tok[] = []\n  let i = 0\n  const n = src.length\n  while (i < n) {\n    const c = src[i]\n    if (/\\s/.test(c)) {\n      i++\n      continue\n    }\n    // multi-char direction selectors must be checked before their single char\n    if ((c === '>' || c === '<') && src[i + 1] === c) {\n      out.push({ t: 'op', v: c + c })\n      i += 2\n      continue\n    }\n    if (c === '(' || c === ')' || c === '[' || c === ']' || c === ',') {\n      out.push({ t: 'op', v: c })\n      i++\n      continue\n    }\n    if (c === '>' || c === '<' || c === '|' || c === '#' || c === '%') {\n      out.push({ t: 'op', v: c })\n      i++\n      continue\n    }\n    // `+` and `-` are context-dependent: operator (`+Z`) or sign (`[-1]`, `(-1,0,0)`).\n    if (c === '+' || c === '-') {\n      out.push({ t: 'op', v: c })\n      i++\n      continue\n    }\n    if (/[0-9]/.test(c) || c === '.') {\n      let j = i\n      while (j < n && /[0-9.]/.test(src[j])) j++\n      out.push({ t: 'num', v: src.slice(i, j) })\n      i = j\n      continue\n    }\n    if (/[A-Za-z]/.test(c)) {\n      let j = i\n      while (j < n && /[A-Za-z0-9_]/.test(src[j])) j++\n      out.push({ t: 'word', v: src.slice(i, j) })\n      i = j\n      continue\n    }\n    throw new SyntaxError(`[cadquery-selectors] unexpected character \"${c}\" at ${i}`)\n  }\n  return out\n}\n\n// ── Parser (recursive descent over tokens) ──────────────────────────────────\n\nclass Parser {\n  private readonly toks: Tok[]\n  private pos = 0\n\n  constructor(src: string) {\n    this.toks = lex(src)\n  }\n\n  private peek(): Tok | undefined {\n    return this.toks[this.pos]\n  }\n\n  private next(): Tok | undefined {\n    return this.toks[this.pos++]\n  }\n\n  private eof(): boolean {\n    return this.pos >= this.toks.length\n  }\n\n  /** Consume an operator token with value `v`, or throw. */\n  private eatOp(v: string): void {\n    const t = this.peek()\n    if (!t || t.t !== 'op' || t.v !== v) {\n      throw new SyntaxError(`[cadquery-selectors] expected \"${v}\"`)\n    }\n    this.pos++\n  }\n\n  /** Look at current token: is it an operator token with value v? */\n  private atOp(v: string): boolean {\n    const t = this.peek()\n    return !!t && t.t === 'op' && t.v === v\n  }\n\n  /** Look at current token: is it the given keyword (case-insensitive)? */\n  private atWord(w: string): boolean {\n    const t = this.peek()\n    return !!t && t.t === 'word' && t.v.toLowerCase() === w\n  }\n\n  parse(): SelectorExpr {\n    const expr = this.parseAnd()\n    if (!this.eof()) {\n      throw new SyntaxError(`[cadquery-selectors] trailing input at position ${this.pos}`)\n    }\n    return expr\n  }\n\n  // `and` — lowest precedence; left-associative n-ary fold.\n  private parseAnd(): SelectorExpr {\n    const terms: SelectorExpr[] = [this.parseOr()]\n    while (this.atWord('and')) {\n      this.pos++\n      terms.push(this.parseOr())\n    }\n    return terms.length === 1 ? terms[0]! : { op: 'and', terms }\n  }\n\n  private parseOr(): SelectorExpr {\n    const terms: SelectorExpr[] = [this.parseExc()]\n    while (this.atWord('or')) {\n      this.pos++\n      terms.push(this.parseExc())\n    }\n    return terms.length === 1 ? terms[0]! : { op: 'or', terms }\n  }\n\n  private parseExc(): SelectorExpr {\n    const terms: SelectorExpr[] = [this.parseNot()]\n    while (this.atWord('exc') || this.atWord('except')) {\n      this.pos++\n      terms.push(this.parseNot())\n    }\n    return terms.length === 1 ? terms[0]! : { op: 'exc', terms }\n  }\n\n  // `not` — highest precedence, unary, right-associative.\n  private parseNot(): SelectorExpr {\n    if (this.atWord('not')) {\n      this.pos++\n      return { op: 'not', term: this.parseNot() }\n    }\n    if (this.atOp('(')) {\n      this.pos++\n      const inner = this.parseAnd()\n      this.eatOp(')')\n      return inner\n    }\n    return { op: 'atom', desc: this.parseAtom() }\n  }\n\n  /** Parse an axis directive: bare word (X/Y/Z/XY/YZ/XZ) or `(x,y,z)` vector. */\n  private parseDirection(): Vec3 | null {\n    const t = this.peek()\n    if (t && t.t === 'word') {\n      const up = t.v.toUpperCase()\n      if (up in AXES) {\n        this.pos++\n        return AXES[up]!\n      }\n      return null\n    }\n    if (t && t.t === 'op' && t.v === '(') {\n      this.pos++\n      const x = this.parseNumber()\n      this.eatOp(',')\n      const y = this.parseNumber()\n      this.eatOp(',')\n      const z = this.parseNumber()\n      this.eatOp(')')\n      return { x, y, z }\n    }\n    return null\n  }\n\n  /**\n   * Parse a numeric literal, allowing an optional leading `+`/`-`. Numeric\n   * grammar from upstream: integer [. [integer]] where integer = sign? digits.\n   */\n  private parseNumber(): number {\n    let sign = 1\n    if (this.atOp('-') || this.atOp('+')) {\n      if (this.atOp('-')) sign = -1\n      this.pos++\n    }\n    // ensure a numeric literal follows the sign\n    if (!this.peek() || this.peek()!.t !== 'num') {\n      throw new SyntaxError('[cadquery-selectors] expected a number')\n    }\n    const raw = (this.next() as Tok & { t: 'num' }).v\n    const v = Number(raw)\n    if (!Number.isFinite(v)) throw this.error('invalid number')\n    return sign * v\n  }\n\n  /** Consume an optional index `[k]` where k is a signed integer; null if absent. */\n  private parseIndex(): { n: number } | null {\n    if (!this.atOp('[')) return null\n    this.pos++\n    const n = Math.trunc(this.parseNumber())\n    this.eatOp(']')\n    return { n }\n  }\n\n  private error(msg: string): SyntaxError {\n    return new SyntaxError(`[cadquery-selectors] ${msg}`)\n  }\n\n  /** Parse a single atom (a leaf of the expression). Throws on unknown atom. */\n  private parseAtom(): AtomDesc {\n    const t = this.peek()\n    if (!t) throw this.error('unexpected end of expression')\n\n    // 1. bare direction — a word that is an axis name maps to DirectionSelector.\n    if (t.t === 'word' && t.v.toUpperCase() in AXES) {\n      this.pos++\n      return { kind: 'dir', vec: AXES[t.v.toUpperCase()]! }\n    }\n\n    // 2. %TYPE\n    if (t.t === 'op' && t.v === '%') {\n      this.pos++\n      const nameT = this.next()\n      if (!nameT || nameT.t !== 'word') throw this.error('`%` must be followed by a geometry type')\n      const up = nameT.v.toUpperCase()\n      if (!TYPE_NAMES.has(up)) throw this.error(`invalid geometry type \"%${nameT.v}\"`)\n      return { kind: 'type', name: up }\n    }\n\n    // 3./4. direction ops and center nth ops\n    if (t.t === 'op' && (t.v === '>>' || t.v === '<<')) {\n      this.pos++\n      const vec = this.parseDirection()\n      if (!vec) throw this.error('expected an axis or vector after `' + t.v + '`')\n      const idx = this.parseIndex()\n      const max = t.v === '>>'\n      return { kind: 'centerNth', vec, max, n: idx ? idx.n : null }\n    }\n    if (t.t === 'op' && (t.v === '>' || t.v === '<')) {\n      this.pos++\n      const vec = this.parseDirection()\n      if (!vec) throw this.error('expected an axis direction after `' + t.v + '`')\n      const max = t.v === '>'\n      const idx = this.parseIndex()\n      if (idx) return { kind: 'minmaxNth', vec, max, n: idx.n }\n      return { kind: 'minmax', vec, max }\n    }\n    // 5. other_op — `|` `#` `+` `-`\n    if (t.t === 'op' && (t.v === '|' || t.v === '#' || t.v === '+' || t.v === '-')) {\n      this.pos++\n      const vec = this.parseDirection()\n      if (!vec) throw this.error(`expected an axis direction after \\`${t.v}\\``)\n      if (t.v === '|') return { kind: 'parallel', vec }\n      if (t.v === '#') return { kind: 'perpendicular', vec }\n      return { kind: 'signed', vec, sign: t.v === '+' ? 1 : -1 }\n    }\n\n    // 6. named view\n    if (t.t === 'word' && t.v.toLowerCase() in NAMED_VIEW) {\n      this.pos++\n      const nv = NAMED_VIEW[t.v.toLowerCase()]!\n      return { kind: 'minmax', vec: nv.vec, max: nv.max }\n    }\n\n    throw this.error(`unsupported selector atom near \"${JSON.stringify(t)}\"`)\n  }\n}\n\n/**\n * Parse a raw CadQuery selector expression string into an AST.\n *\n * @param expr - The CadQuery selector string (e.g. `\">Z and |X\"`).\n * @returns The parsed selector AST.\n */\nexport function parseSelector(expr: string): SelectorExpr {\n  if (expr == null || expr.trim() === '') {\n    throw new SyntaxError('[cadquery-selectors] selector expression may not be empty')\n  }\n  return new Parser(expr).parse()\n}"]}

package/dist/api/cadquery-selectors/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * cadquery-selectors — CadQuery 拓扑选择器子系统（独立物理边界）
+ *
+ * 单一选择器真相的边界（plan §4.5/§4.6）：grammar → parseSelector、实体投影
+ * （entity.ts）、谓词（predicates.ts）、链式收窄求值（resolve.ts），以及面向
+ * faijs `Shape` 的薄适配（face/edge）。cq-compat 只经此处 re-export 消费，
+ * 与 faijs 自有的命名 / 血缘 TopoRef 系统物理隔离，不依赖之。
+ */
+export { asBrepShape } from './borrow-bridge.js';
+export { resolveFaceSelector } from './face.js';
+export { resolveEdgeSelection, resolveFaceEdgeSelection, resolveVertexSelection } from './edge.js';
+export { parseSelector, SYNTAX_FEATURES, NAMED_VIEW, AXES, TYPE_NAMES } from './grammar.js';
+export type { SelectorExpr, AtomDesc, EntityKind, SelStep, Vec3 } from './types.js';
+export { faceGeom, edgeGeom, vertexGeom, subShapeHandles, orientedFaceNormal, faceGeomType, edgeGeomType, type EntityGeom, type P3, type ShapeHandle, } from './entity.js';
+export { DIR_TOLERANCE, NTH_TOLERANCE, } from './predicates.js';
+export { isParallel, isPerpendicular, isAligned, isDirectionCandidate, typeMatches, entityDirection, } from './predicates.js';
+export { resolveSelection, resolveStepHandles, EmptyNthError, type ChainResult, type Selection, } from './resolve.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/cadquery-selectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/cadquery-selectors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAA;AAC5C,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAA;AAC/F,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACxF,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAChF,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,EAAE,EACP,KAAK,WAAW,GACjB,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,aAAa,EACb,aAAa,GACd,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,UAAU,EACV,eAAe,EACf,SAAS,EACT,oBAAoB,EACpB,WAAW,EACX,eAAe,GAChB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,MAAM,WAAW,CAAA"}

package/dist/api/cadquery-selectors/index.js

@@ -0,0 +1,17 @@
+/**
+ * cadquery-selectors — CadQuery 拓扑选择器子系统（独立物理边界）
+ *
+ * 单一选择器真相的边界（plan §4.5/§4.6）：grammar → parseSelector、实体投影
+ * （entity.ts）、谓词（predicates.ts）、链式收窄求值（resolve.ts），以及面向
+ * faijs `Shape` 的薄适配（face/edge）。cq-compat 只经此处 re-export 消费，
+ * 与 faijs 自有的命名 / 血缘 TopoRef 系统物理隔离，不依赖之。
+ */
+export { asBrepShape } from './borrow-bridge.js';
+export { resolveFaceSelector } from './face.js';
+export { resolveEdgeSelection, resolveFaceEdgeSelection, resolveVertexSelection } from './edge.js';
+export { parseSelector, SYNTAX_FEATURES, NAMED_VIEW, AXES, TYPE_NAMES } from './grammar.js';
+export { faceGeom, edgeGeom, vertexGeom, subShapeHandles, orientedFaceNormal, faceGeomType, edgeGeomType, } from './entity.js';
+export { DIR_TOLERANCE, NTH_TOLERANCE, } from './predicates.js';
+export { isParallel, isPerpendicular, isAligned, isDirectionCandidate, typeMatches, entityDirection, } from './predicates.js';
+export { resolveSelection, resolveStepHandles, EmptyNthError, } from './resolve.js';
+//# sourceMappingURL=index.js.map

package/dist/api/cadquery-selectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/cadquery-selectors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAA;AAC5C,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAA;AAC/F,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAExF,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,YAAY,GAIb,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,aAAa,EACb,aAAa,GACd,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,UAAU,EACV,eAAe,EACf,SAAS,EACT,oBAAoB,EACpB,WAAW,EACX,eAAe,GAChB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,GAGd,MAAM,WAAW,CAAA","sourcesContent":["/**\n * cadquery-selectors — CadQuery 拓扑选择器子系统（独立物理边界）\n *\n * 单一选择器真相的边界（plan §4.5/§4.6）：grammar → parseSelector、实体投影\n * （entity.ts）、谓词（predicates.ts）、链式收窄求值（resolve.ts），以及面向\n * faijs `Shape` 的薄适配（face/edge）。cq-compat 只经此处 re-export 消费，\n * 与 faijs 自有的命名 / 血缘 TopoRef 系统物理隔离，不依赖之。\n */\n\nexport { asBrepShape } from './borrow-bridge'\nexport { resolveFaceSelector } from './face'\nexport { resolveEdgeSelection, resolveFaceEdgeSelection, resolveVertexSelection } from './edge'\nexport { parseSelector, SYNTAX_FEATURES, NAMED_VIEW, AXES, TYPE_NAMES } from './grammar'\nexport type { SelectorExpr, AtomDesc, EntityKind, SelStep, Vec3 } from './types'\nexport {\n  faceGeom,\n  edgeGeom,\n  vertexGeom,\n  subShapeHandles,\n  orientedFaceNormal,\n  faceGeomType,\n  edgeGeomType,\n  type EntityGeom,\n  type P3,\n  type ShapeHandle,\n} from './entity'\nexport {\n  DIR_TOLERANCE,\n  NTH_TOLERANCE,\n} from './predicates'\nexport {\n  isParallel,\n  isPerpendicular,\n  isAligned,\n  isDirectionCandidate,\n  typeMatches,\n  entityDirection,\n} from './predicates'\nexport {\n  resolveSelection,\n  resolveStepHandles,\n  EmptyNthError,\n  type ChainResult,\n  type Selection,\n} from './resolve'"]}

package/dist/api/cadquery-selectors/predicates.d.ts

@@ -0,0 +1,76 @@
+/**
+ * cadquery-selectors/predicates — per-entity boolean tests mirroring
+ * cadquery/selectors.py (plan §4.4). These are the clean-room re-encoding of
+ * the upstream selector classes, grounded by a probe of the LOCKED cadquery
+ * 2.8.0 reference behavior.
+ *
+ * Two families:
+ *   - **cluster-free tests** — direction / parallel / perpendicular / type;
+ *     evaluated per candidate entity over the ordered set.
+ *   - **cluster-based extraction** — minmax / center-nth / direction-nth;
+ *     these sort candidates by center-projection on an axis and pick a cluster,
+ *     mirroring `_NthSelector.cluster` + `filter` (implemented in resolve.ts).
+ *
+ * The base direction-motivated selectors apply ONLY to *linear edges* and
+ * *planar faces*; every other entity is dropped (upstream `BaseDirSelector`
+ * `continue`s for those, selectors.py:174-184).
+ */
+import type { EntityGeom, P3, ShapeHandle } from './entity.js';
+/** Tolerance used by the direction selectors (upstream default 1e-4 rad). */
+export declare const DIR_TOLERANCE = 0.0001;
+/** Tolerance used by the N-th clustering (upstream `_NthSelector.tolerance`). */
+export declare const NTH_TOLERANCE = 0.0001;
+/**
+ * `ParallelDirSelector` semantics: the direction (normal/tangent) is parallel
+ * to `axis` — the unit dot is ≈ ±1.
+ *
+ * @param dir - The candidate direction vector (face normal / edge tangent).
+ * @param axis - The unit direction of the selector axis.
+ * @param tolerance - Angular tolerance in radians (default `DIR_TOLERANCE`).
+ * @returns `true` when `dir` is (anti)parallel to `axis`.
+ */
+export declare function isParallel(dir: P3, axis: P3, tolerance?: number): boolean;
+/**
+ * `PerpendicularDirSelector` semantics: angle between direction and axis ≈ π/2.
+ *
+ * @param dir - The candidate direction (face normal / edge tangent).
+ * @param axis - The unit direction of the selector axis.
+ * @param tolerance - Angular tolerance in radians (default `DIR_TOLERANCE`).
+ * @returns `true` when `dir` is perpendicular to `axis`.
+ */
+export declare function isPerpendicular(dir: P3, axis: P3, tolerance?: number): boolean;
+/**
+ * `DirectionSelector` (`+`/`-`/bare) semantics: the direction is within
+ * tolerance of the *signed* axis.
+ *
+ * @param dir - The candidate direction (face normal / edge tangent).
+ * @param axis - The unit direction of the selector axis.
+ * @param sign - `+1` to match the positive axis, `-1` for the negative axis.
+ * @param tolerance - Angular tolerance in radians (default `DIR_TOLERANCE`).
+ * @returns `true` when `dir` is aligned to `sign * axis`.
+ */
+export declare function isAligned(dir: P3, axis: P3, sign: number, tolerance?: number): boolean;
+/**
+ * Whether an entity is examined by a direction test (linear edges, planar faces).
+ *
+ * @param geom - The candidate entity geometry.
+ * @returns `true` when the entity carries a meaningful direction (PLANE / LINE).
+ */
+export declare function isDirectionCandidate(geom: EntityGeom): boolean;
+/**
+ * `TypeSelector` semantics — match the upcased `geomType()` name.
+ *
+ * @param geom - The candidate entity geometry.
+ * @param want - The upcased CadQuery geometry-type name to match (e.g. `PLANE`).
+ * @returns `true` when the entity's `geomType()` equals `want`.
+ */
+export declare function typeMatches(geom: EntityGeom, want: string): boolean;
+/**
+ * Resolve the direction-bearing vector for an entity, or null when skipped.
+ *
+ * @param geom - The candidate entity geometry.
+ * @param owner - Optional owning shape handle used to orient a face normal.
+ * @returns The direction vector for a linear edge / planar face, else `null`.
+ */
+export declare function entityDirection(geom: EntityGeom, owner?: ShapeHandle): P3 | null;
+//# sourceMappingURL=predicates.d.ts.map

package/dist/api/cadquery-selectors/predicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.d.ts","sourceRoot":"","sources":["../../../src/api/cadquery-selectors/predicates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3D,6EAA6E;AAC7E,eAAO,MAAM,aAAa,SAAO,CAAA;AAEjC,iFAAiF;AACjF,eAAO,MAAM,aAAa,SAAS,CAAA;AAQnC;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,SAAgB,GAAG,OAAO,CAEhF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,SAAgB,GAAG,OAAO,CAErF;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,SAAgB,GAAG,OAAO,CAG7F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAS9D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,EAAE,GAAG,IAAI,CAGhF"}

package/dist/api/cadquery-selectors/predicates.js

@@ -0,0 +1,85 @@
+/** Tolerance used by the direction selectors (upstream default 1e-4 rad). */
+export const DIR_TOLERANCE = 1e-4;
+/** Tolerance used by the N-th clustering (upstream `_NthSelector.tolerance`). */
+export const NTH_TOLERANCE = 0.0001;
+function unitDot(a, b) {
+    const al = Math.hypot(a.x, a.y, a.z) || 1;
+    const bl = Math.hypot(b.x, b.y, b.z) || 1;
+    return (a.x * b.x + a.y * b.y + a.z * b.z) / (al * bl);
+}
+/**
+ * `ParallelDirSelector` semantics: the direction (normal/tangent) is parallel
+ * to `axis` — the unit dot is ≈ ±1.
+ *
+ * @param dir - The candidate direction vector (face normal / edge tangent).
+ * @param axis - The unit direction of the selector axis.
+ * @param tolerance - Angular tolerance in radians (default `DIR_TOLERANCE`).
+ * @returns `true` when `dir` is (anti)parallel to `axis`.
+ */
+export function isParallel(dir, axis, tolerance = DIR_TOLERANCE) {
+    return Math.abs(unitDot(dir, axis)) >= 1 - tolerance;
+}
+/**
+ * `PerpendicularDirSelector` semantics: angle between direction and axis ≈ π/2.
+ *
+ * @param dir - The candidate direction (face normal / edge tangent).
+ * @param axis - The unit direction of the selector axis.
+ * @param tolerance - Angular tolerance in radians (default `DIR_TOLERANCE`).
+ * @returns `true` when `dir` is perpendicular to `axis`.
+ */
+export function isPerpendicular(dir, axis, tolerance = DIR_TOLERANCE) {
+    return Math.abs(unitDot(dir, axis)) <= tolerance;
+}
+/**
+ * `DirectionSelector` (`+`/`-`/bare) semantics: the direction is within
+ * tolerance of the *signed* axis.
+ *
+ * @param dir - The candidate direction (face normal / edge tangent).
+ * @param axis - The unit direction of the selector axis.
+ * @param sign - `+1` to match the positive axis, `-1` for the negative axis.
+ * @param tolerance - Angular tolerance in radians (default `DIR_TOLERANCE`).
+ * @returns `true` when `dir` is aligned to `sign * axis`.
+ */
+export function isAligned(dir, axis, sign, tolerance = DIR_TOLERANCE) {
+    const d = unitDot(dir, axis);
+    return sign >= 0 ? d >= 1 - tolerance : d <= -(1 - tolerance);
+}
+/**
+ * Whether an entity is examined by a direction test (linear edges, planar faces).
+ *
+ * @param geom - The candidate entity geometry.
+ * @returns `true` when the entity carries a meaningful direction (PLANE / LINE).
+ */
+export function isDirectionCandidate(geom) {
+    switch (geom.kind) {
+        case 'face':
+            return geom.geomType() === 'PLANE';
+        case 'edge':
+            return geom.geomType() === 'LINE';
+        case 'vertex':
+            return false;
+    }
+}
+/**
+ * `TypeSelector` semantics — match the upcased `geomType()` name.
+ *
+ * @param geom - The candidate entity geometry.
+ * @param want - The upcased CadQuery geometry-type name to match (e.g. `PLANE`).
+ * @returns `true` when the entity's `geomType()` equals `want`.
+ */
+export function typeMatches(geom, want) {
+    return geom.geomType() === want;
+}
+/**
+ * Resolve the direction-bearing vector for an entity, or null when skipped.
+ *
+ * @param geom - The candidate entity geometry.
+ * @param owner - Optional owning shape handle used to orient a face normal.
+ * @returns The direction vector for a linear edge / planar face, else `null`.
+ */
+export function entityDirection(geom, owner) {
+    if (!isDirectionCandidate(geom))
+        return null;
+    return geom.direction(owner);
+}
+//# sourceMappingURL=predicates.js.map

package/dist/api/cadquery-selectors/predicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.js","sourceRoot":"","sources":["../../../src/api/cadquery-selectors/predicates.ts"],"names":[],"mappings":"AAmBA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAA;AAEjC,iFAAiF;AACjF,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAA;AAEnC,SAAS,OAAO,CAAC,CAAK,EAAE,CAAK;IAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACzC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACzC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;AACxD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,GAAO,EAAE,IAAQ,EAAE,SAAS,GAAG,aAAa;IACrE,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,SAAS,CAAA;AACtD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,GAAO,EAAE,IAAQ,EAAE,SAAS,GAAG,aAAa;IAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,SAAS,CAAA;AAClD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,GAAO,EAAE,IAAQ,EAAE,IAAY,EAAE,SAAS,GAAG,aAAa;IAClF,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC5B,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAgB;IACnD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,QAAQ,EAAE,KAAK,OAAO,CAAA;QACpC,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,QAAQ,EAAE,KAAK,MAAM,CAAA;QACnC,KAAK,QAAQ;YACX,OAAO,KAAK,CAAA;IAChB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,IAAY;IACxD,OAAO,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAA;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,IAAgB,EAAE,KAAmB;IACnE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAoB,CAAC,CAAA;AAC7C,CAAC","sourcesContent":["/**\n * cadquery-selectors/predicates — per-entity boolean tests mirroring\n * cadquery/selectors.py (plan §4.4). These are the clean-room re-encoding of\n * the upstream selector classes, grounded by a probe of the LOCKED cadquery\n * 2.8.0 reference behavior.\n *\n * Two families:\n *   - **cluster-free tests** — direction / parallel / perpendicular / type;\n *     evaluated per candidate entity over the ordered set.\n *   - **cluster-based extraction** — minmax / center-nth / direction-nth;\n *     these sort candidates by center-projection on an axis and pick a cluster,\n *     mirroring `_NthSelector.cluster` + `filter` (implemented in resolve.ts).\n *\n * The base direction-motivated selectors apply ONLY to *linear edges* and\n * *planar faces*; every other entity is dropped (upstream `BaseDirSelector`\n * `continue`s for those, selectors.py:174-184).\n */\nimport type { EntityGeom, P3, ShapeHandle } from './entity'\n\n/** Tolerance used by the direction selectors (upstream default 1e-4 rad). */\nexport const DIR_TOLERANCE = 1e-4\n\n/** Tolerance used by the N-th clustering (upstream `_NthSelector.tolerance`). */\nexport const NTH_TOLERANCE = 0.0001\n\nfunction unitDot(a: P3, b: P3): number {\n  const al = Math.hypot(a.x, a.y, a.z) || 1\n  const bl = Math.hypot(b.x, b.y, b.z) || 1\n  return (a.x * b.x + a.y * b.y + a.z * b.z) / (al * bl)\n}\n\n/**\n * `ParallelDirSelector` semantics: the direction (normal/tangent) is parallel\n * to `axis` — the unit dot is ≈ ±1.\n *\n * @param dir - The candidate direction vector (face normal / edge tangent).\n * @param axis - The unit direction of the selector axis.\n * @param tolerance - Angular tolerance in radians (default `DIR_TOLERANCE`).\n * @returns `true` when `dir` is (anti)parallel to `axis`.\n */\nexport function isParallel(dir: P3, axis: P3, tolerance = DIR_TOLERANCE): boolean {\n  return Math.abs(unitDot(dir, axis)) >= 1 - tolerance\n}\n\n/**\n * `PerpendicularDirSelector` semantics: angle between direction and axis ≈ π/2.\n *\n * @param dir - The candidate direction (face normal / edge tangent).\n * @param axis - The unit direction of the selector axis.\n * @param tolerance - Angular tolerance in radians (default `DIR_TOLERANCE`).\n * @returns `true` when `dir` is perpendicular to `axis`.\n */\nexport function isPerpendicular(dir: P3, axis: P3, tolerance = DIR_TOLERANCE): boolean {\n  return Math.abs(unitDot(dir, axis)) <= tolerance\n}\n\n/**\n * `DirectionSelector` (`+`/`-`/bare) semantics: the direction is within\n * tolerance of the *signed* axis.\n *\n * @param dir - The candidate direction (face normal / edge tangent).\n * @param axis - The unit direction of the selector axis.\n * @param sign - `+1` to match the positive axis, `-1` for the negative axis.\n * @param tolerance - Angular tolerance in radians (default `DIR_TOLERANCE`).\n * @returns `true` when `dir` is aligned to `sign * axis`.\n */\nexport function isAligned(dir: P3, axis: P3, sign: number, tolerance = DIR_TOLERANCE): boolean {\n  const d = unitDot(dir, axis)\n  return sign >= 0 ? d >= 1 - tolerance : d <= -(1 - tolerance)\n}\n\n/**\n * Whether an entity is examined by a direction test (linear edges, planar faces).\n *\n * @param geom - The candidate entity geometry.\n * @returns `true` when the entity carries a meaningful direction (PLANE / LINE).\n */\nexport function isDirectionCandidate(geom: EntityGeom): boolean {\n  switch (geom.kind) {\n    case 'face':\n      return geom.geomType() === 'PLANE'\n    case 'edge':\n      return geom.geomType() === 'LINE'\n    case 'vertex':\n      return false\n  }\n}\n\n/**\n * `TypeSelector` semantics — match the upcased `geomType()` name.\n *\n * @param geom - The candidate entity geometry.\n * @param want - The upcased CadQuery geometry-type name to match (e.g. `PLANE`).\n * @returns `true` when the entity's `geomType()` equals `want`.\n */\nexport function typeMatches(geom: EntityGeom, want: string): boolean {\n  return geom.geomType() === want\n}\n\n/**\n * Resolve the direction-bearing vector for an entity, or null when skipped.\n *\n * @param geom - The candidate entity geometry.\n * @param owner - Optional owning shape handle used to orient a face normal.\n * @returns The direction vector for a linear edge / planar face, else `null`.\n */\nexport function entityDirection(geom: EntityGeom, owner?: ShapeHandle): P3 | null {\n  if (!isDirectionCandidate(geom)) return null\n  return geom.direction(owner as ShapeHandle)\n}"]}