@ifc-lite/query 2.0.0 → 2.2.0

package/dist/pset-lookup.js

@@ -0,0 +1,73 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Find a property by (setName, propName) across every property set
+ * carrying that name, first match across the sequence wins. Returns
+ * `undefined` when no same-named set carries a property with that name.
+ */
+export function findPropertyInSets(sets, setName, propName) {
+    for (const set of sets) {
+        if (set.name !== setName)
+            continue;
+        const match = set.properties.find((p) => p.name === propName);
+        if (match)
+            return match;
+    }
+    return undefined;
+}
+/**
+ * Find a quantity by (setName, quantityName) across every quantity set
+ * carrying that name, first match across the sequence wins. Returns
+ * `undefined` when no same-named set carries a quantity with that name.
+ */
+export function findQuantityInSets(sets, setName, quantityName) {
+    for (const set of sets) {
+        if (set.name !== setName)
+            continue;
+        const match = set.quantities.find((q) => q.name === quantityName);
+        if (match)
+            return match;
+    }
+    return undefined;
+}
+/**
+ * Find EVERY property named `propName`, across EVERY same-named
+ * (setName) property set — not just the first. For a caller evaluating a
+ * predicate ("does this entity have a set with this name and value?")
+ * first-match is wrong: an entity can carry two distinct `IfcPropertySet`s
+ * named e.g. "Pset_WallCommon" (one from the type, one from the
+ * occurrence), and the wanted value may live on the second one. Use this
+ * instead of `findPropertyInSets` when the result feeds a `.some(...)`
+ * predicate rather than a single value read; keep `findPropertyInSets` for
+ * value extraction (export/aggregation/display), where picking one member
+ * is the documented, correct behaviour.
+ */
+export function findAllPropertiesInSets(sets, setName, propName) {
+    const matches = [];
+    for (const set of sets) {
+        if (set.name !== setName)
+            continue;
+        for (const p of set.properties) {
+            if (p.name === propName)
+                matches.push(p);
+        }
+    }
+    return matches;
+}
+/**
+ * Quantity counterpart to `findAllPropertiesInSets` — see its doc comment.
+ */
+export function findAllQuantitiesInSets(sets, setName, quantityName) {
+    const matches = [];
+    for (const set of sets) {
+        if (set.name !== setName)
+            continue;
+        for (const q of set.quantities) {
+            if (q.name === quantityName)
+                matches.push(q);
+        }
+    }
+    return matches;
+}
+//# sourceMappingURL=pset-lookup.js.map

package/dist/pset-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pset-lookup.js","sourceRoot":"","sources":["../src/pset-lookup.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAsC/D;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAmC,EACnC,OAAe,EACf,QAAgB;IAEhB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,SAAS;QACnC,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAC9D,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAmC,EACnC,OAAe,EACf,YAAoB;IAEpB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,SAAS;QACnC,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;QAClE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAmC,EACnC,OAAe,EACf,QAAgB;IAEhB,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,SAAS;QACnC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YAC/B,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAmC,EACnC,OAAe,EACf,YAAoB;IAEpB,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,SAAS;QACnC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YAC/B,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/selector/ast.d.ts

@@ -0,0 +1,106 @@
+/**
+ * AST for the IfcOpenShell selector (filter) syntax.
+ *
+ * The AST is the seam: {@link parseSelector} understands the whole grammar,
+ * and each surface (the viewer's rule builder today, the CLI/MCP/SDK query
+ * descriptor next) is an adapter from this tree onto its own representation.
+ * The parser therefore accepts constructs no adapter can evaluate yet — an
+ * adapter reports those back rather than dropping them, which is why every
+ * node carries {@link SelectorFilterBase.text}, the exact source substring the
+ * user typed.
+ */
+/** Comparison operators the grammar defines. `*=` is "contains". */
+export type SelectorOp = '=' | '!=' | '>' | '>=' | '<' | '<=' | '*=' | '!*=';
+/** A literal name or value: a plain string, or a `/…/` regular expression. */
+export type SelectorText = {
+    kind: 'string';
+    text: string;
+} | {
+    kind: 'regex';
+    source: string;
+};
+/** A comparison right-hand side. Bare `NULL` (any case) is the null literal. */
+export type SelectorValue = SelectorText | {
+    kind: 'null';
+};
+/** Keyword filters that compare one derived attribute of an element. */
+export type SelectorKeywordKind = 'type' | 'material' | 'classification' | 'location' | 'parent';
+interface SelectorFilterBase {
+    /** The exact source substring this filter was parsed from. */
+    text: string;
+}
+/** `IfcWall` / `! IfcWall` — the class and all its subclasses. */
+interface SelectorClassFilter extends SelectorFilterBase {
+    kind: 'class';
+    name: string;
+    negate: boolean;
+}
+/** `325Q7Fhnf67OZC$$r43uzK` / `! 325Q7Fhnf67OZC$$r43uzK` — one element. */
+interface SelectorGlobalIdFilter extends SelectorFilterBase {
+    kind: 'globalId';
+    id: string;
+    negate: boolean;
+}
+/** `Name=Foo` — an IFC attribute of the element itself. */
+interface SelectorAttributeFilter extends SelectorFilterBase {
+    kind: 'attribute';
+    name: string;
+    op: SelectorOp;
+    value: SelectorValue;
+}
+/** `Pset_WallCommon.FireRating=2HR` — a property in a property set. */
+interface SelectorPropertyFilter extends SelectorFilterBase {
+    kind: 'property';
+    pset: SelectorText;
+    prop: SelectorText;
+    op: SelectorOp;
+    value: SelectorValue;
+}
+/** `type=WT01`, `material=concrete`, `location="Level 3"`, … */
+interface SelectorKeywordFilter extends SelectorFilterBase {
+    kind: SelectorKeywordKind;
+    op: SelectorOp;
+    value: SelectorValue;
+}
+/** `query:types.count=0` — a value-query key path. */
+interface SelectorQueryFilter extends SelectorFilterBase {
+    kind: 'query';
+    keys: string;
+    op: SelectorOp;
+    value: SelectorValue;
+}
+/**
+ * Every filter the grammar can express. The member interfaces stay
+ * module-internal: a consumer narrows on `filter.kind` off this union rather
+ * than naming one, and an exported type nothing consumes is semver liability
+ * with no reader.
+ */
+export type SelectorFilter = SelectorClassFilter | SelectorGlobalIdFilter | SelectorAttributeFilter | SelectorPropertyFilter | SelectorKeywordFilter | SelectorQueryFilter;
+/**
+ * Filters chained with `,`. They narrow left to right (AND).
+ *
+ * Not re-exported from the package index: a caller reaches one through
+ * {@link SelectorQuery.groups}, and an export nothing consumes is permanent
+ * semver liability.
+ */
+export interface SelectorGroup {
+    filters: SelectorFilter[];
+}
+/** Groups joined with `+`. Their results are unioned. */
+export interface SelectorQuery {
+    groups: SelectorGroup[];
+}
+export interface SelectorParseError {
+    message: string;
+    /** 0-based character offset into the input where the problem starts. */
+    offset: number;
+}
+export type SelectorParseResult = {
+    ok: true;
+    query: SelectorQuery;
+} | {
+    ok: false;
+    error: SelectorParseError;
+};
+export {};
+//# sourceMappingURL=ast.d.ts.map

package/dist/selector/ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../src/selector/ast.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,oEAAoE;AACpE,MAAM,MAAM,UAAU,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;AAE7E,8EAA8E;AAC9E,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,gFAAgF;AAChF,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,wEAAwE;AACxE,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,UAAU,GACV,gBAAgB,GAChB,UAAU,GACV,QAAQ,CAAC;AAEb,UAAU,kBAAkB;IAC1B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,kEAAkE;AAClE,UAAU,mBAAoB,SAAQ,kBAAkB;IACtD,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,2EAA2E;AAC3E,UAAU,sBAAuB,SAAQ,kBAAkB;IACzD,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,2DAA2D;AAC3D,UAAU,uBAAwB,SAAQ,kBAAkB;IAC1D,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,uEAAuE;AACvE,UAAU,sBAAuB,SAAQ,kBAAkB;IACzD,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,gEAAgE;AAChE,UAAU,qBAAsB,SAAQ,kBAAkB;IACxD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,sDAAsD;AACtD,UAAU,mBAAoB,SAAQ,kBAAkB;IACtD,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB,mBAAmB,GACnB,sBAAsB,GACtB,uBAAuB,GACvB,sBAAsB,GACtB,qBAAqB,GACrB,mBAAmB,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAClC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC"}

package/dist/selector/ast.js

@@ -0,0 +1,5 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+export {};
+//# sourceMappingURL=ast.js.map

package/dist/selector/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../src/selector/ast.ts"],"names":[],"mappings":"AAAA;;+DAE+D"}

package/dist/selector/parse.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Recursive-descent parser for the IfcOpenShell selector syntax.
+ *
+ *     query  := group ("+" group)*        groups are unioned
+ *     group  := filter ("," filter)*      filters narrow left to right
+ *     filter := "!"? (class | globalId)
+ *             | word ("." name)? op value
+ *             | (string | regex) "." name op value
+ *             | word "." (string | regex) op value
+ *
+ * The parser is deliberately more capable than any single adapter: it accepts
+ * every construct the page documents, so an adapter can name what it cannot
+ * evaluate instead of silently matching nothing — the defect behind #4091.
+ *
+ * See {@link tokenizeSelector} for the lexical rules and where they are ifc-lite's
+ * reading rather than the page's words.
+ */
+import type { SelectorParseResult } from './ast.js';
+export declare function parseSelector(text: string): SelectorParseResult;
+//# sourceMappingURL=parse.d.ts.map

package/dist/selector/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/selector/parse.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAMV,mBAAmB,EAGpB,MAAM,UAAU,CAAC;AAqBlB,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAe/D"}

package/dist/selector/parse.js

@@ -0,0 +1,227 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { tokenizeSelector } from './tokenize.js';
+const KEYWORDS = new Map([
+    ['type', 'type'],
+    ['material', 'material'],
+    ['classification', 'classification'],
+    ['location', 'location'],
+    ['parent', 'parent'],
+]);
+const QUERY_PREFIX = 'query:';
+const GLOBAL_ID = /^[0-9A-Za-z_$]{22}$/;
+class ParseFailure extends Error {
+    error;
+    constructor(error) {
+        super(error.message);
+        this.error = error;
+        this.name = 'ParseFailure';
+    }
+}
+export function parseSelector(text) {
+    const lexed = tokenizeSelector(text);
+    if (!lexed.ok)
+        return { ok: false, error: lexed.error };
+    if (lexed.tokens.length === 0) {
+        return {
+            ok: false,
+            error: { message: 'empty selector: type a class name such as IfcWall', offset: 0 },
+        };
+    }
+    try {
+        return { ok: true, query: { groups: new Parser(text, lexed.tokens).parseQuery() } };
+    }
+    catch (err) {
+        if (err instanceof ParseFailure)
+            return { ok: false, error: err.error };
+        throw err;
+    }
+}
+class Parser {
+    source;
+    tokens;
+    pos = 0;
+    constructor(source, tokens) {
+        this.source = source;
+        this.tokens = tokens;
+    }
+    parseQuery() {
+        const groups = [this.parseGroup()];
+        while (this.peek()?.kind === 'plus') {
+            this.advance();
+            groups.push(this.parseGroup());
+        }
+        const trailing = this.peek();
+        if (trailing)
+            this.fail(`unexpected "${trailing.value}"`, trailing.start);
+        return groups;
+    }
+    parseGroup() {
+        const filters = [this.parseFilter()];
+        while (this.peek()?.kind === 'comma') {
+            this.advance();
+            filters.push(this.parseFilter());
+        }
+        return { filters };
+    }
+    parseFilter() {
+        const first = this.require('expected a filter');
+        let negate = false;
+        let head = first;
+        if (first.kind === 'bang') {
+            negate = true;
+            this.advance();
+            head = this.require('expected a class name or GlobalId after "!"');
+        }
+        if (head.kind !== 'word' && head.kind !== 'string' && head.kind !== 'regex') {
+            this.fail(`unexpected "${head.value}"`, head.start);
+        }
+        this.advance();
+        const after = this.peek();
+        if (after?.kind === 'dot') {
+            if (negate)
+                this.failNegate(first);
+            this.advance();
+            return this.finishProperty(first, nameOf(head));
+        }
+        // `Pset_BeamCommon."IsExternal"` — a bare-word property set keeps its '.'
+        // inside the word (that is what keeps a decimal like `1.5` one token), so
+        // the separator never reaches the branch above and the quoted property
+        // name arrives as the NEXT token. Without this, only the regex spelling
+        // `/Pset_.*Common/."IsExternal"` parsed, and the literal one failed with a
+        // message about a missing operator (#4091).
+        if (head.kind === 'word' &&
+            head.value.length > 1 &&
+            head.value.endsWith('.') &&
+            (after?.kind === 'string' || after?.kind === 'regex')) {
+            if (negate)
+                this.failNegate(first);
+            return this.finishProperty(first, { kind: 'string', text: head.value.slice(0, -1) });
+        }
+        if (after?.kind === 'op') {
+            if (negate)
+                this.failNegate(first);
+            if (head.kind !== 'word') {
+                this.fail('a quoted name or regular expression is only valid as a property-set or property name, e.g. /Pset_.*Common/.FireRating=2HR', head.start);
+            }
+            return this.finishKeyed(first, head);
+        }
+        return this.finishBare(first, head, negate);
+    }
+    /** `<pset> . <prop> <op> <value>`, the pset already consumed. */
+    finishProperty(first, pset) {
+        const propTok = this.require('expected a property name after "."');
+        if (propTok.kind !== 'word' && propTok.kind !== 'string' && propTok.kind !== 'regex') {
+            this.fail(`expected a property name after "." but found "${propTok.value}"`, propTok.start);
+        }
+        this.advance();
+        const op = this.requireOp();
+        const value = this.requireValue(op);
+        return {
+            kind: 'property',
+            pset,
+            prop: nameOf(propTok),
+            op: op.value,
+            value,
+            text: this.spanFrom(first),
+        };
+    }
+    /** `<word> <op> <value>` — property with an inline dot, keyword, query or attribute. */
+    finishKeyed(first, head) {
+        const key = head.value;
+        const op = this.requireOp();
+        const value = this.requireValue(op);
+        const text = this.spanFrom(first);
+        if (key.toLowerCase().startsWith(QUERY_PREFIX)) {
+            const keys = key.slice(QUERY_PREFIX.length);
+            if (keys.length === 0)
+                this.fail('expected a key path after "query:"', head.start);
+            return { kind: 'query', keys, op: op.value, value, text };
+        }
+        const dot = key.indexOf('.');
+        if (dot >= 0) {
+            const pset = key.slice(0, dot);
+            const prop = key.slice(dot + 1);
+            if (pset.length === 0 || prop.length === 0) {
+                this.fail(`"${key}" is not a property set and property name, e.g. Pset_WallCommon.FireRating`, head.start);
+            }
+            return {
+                kind: 'property',
+                pset: { kind: 'string', text: pset },
+                prop: { kind: 'string', text: prop },
+                op: op.value,
+                value,
+                text,
+            };
+        }
+        const keyword = KEYWORDS.get(key.toLowerCase());
+        if (keyword)
+            return { kind: keyword, op: op.value, value, text };
+        return { kind: 'attribute', name: key, op: op.value, value, text };
+    }
+    /** A filter with no operator: a class name or a GlobalId. */
+    finishBare(first, head, negate) {
+        if (head.kind !== 'word') {
+            this.fail(`"${head.value}" is not a filter: a quoted value or regular expression needs an attribute or property to compare, e.g. Name=${head.kind === 'regex' ? `/${head.value}/` : `"${head.value}"`}`, head.start);
+        }
+        const text = this.spanFrom(first);
+        if (head.value.includes('.')) {
+            this.fail(`"${head.value}" reads as a property set and property name, so it needs one of the operators = != > >= < <= *= !*= and a value`, head.start);
+        }
+        if (head.value.toLowerCase().startsWith('ifc')) {
+            return { kind: 'class', name: head.value, negate, text };
+        }
+        if (GLOBAL_ID.test(head.value)) {
+            return { kind: 'globalId', id: head.value, negate, text };
+        }
+        this.fail(`"${head.value}" is not an IFC class name (those start with "Ifc"), a 22-character GlobalId, or a comparison such as Name=${head.value}`, head.start);
+    }
+    // ── Token helpers ───────────────────────────────────────────────────────
+    peek() {
+        return this.tokens[this.pos];
+    }
+    advance() {
+        this.pos += 1;
+    }
+    require(message) {
+        const tok = this.peek();
+        if (!tok || tok.kind === 'comma' || tok.kind === 'plus') {
+            this.fail(message, tok ? tok.start : this.source.length);
+        }
+        return tok;
+    }
+    requireOp() {
+        const tok = this.peek();
+        if (!tok || tok.kind !== 'op') {
+            this.fail('expected one of the operators = != > >= < <= *= !*=', tok ? tok.start : this.source.length);
+        }
+        this.advance();
+        return tok;
+    }
+    requireValue(op) {
+        const tok = this.peek();
+        if (!tok || (tok.kind !== 'word' && tok.kind !== 'string' && tok.kind !== 'regex')) {
+            this.fail(`expected a value after "${op.value}"`, tok ? tok.start : this.source.length);
+        }
+        this.advance();
+        if (tok.kind === 'word' && tok.value.toUpperCase() === 'NULL')
+            return { kind: 'null' };
+        return nameOf(tok);
+    }
+    /** The source text from `first` through the token just consumed. */
+    spanFrom(first) {
+        const last = this.tokens[this.pos - 1];
+        return this.source.slice(first.start, last.end);
+    }
+    failNegate(first) {
+        this.fail('"!" may only negate a class name or a GlobalId', first.start);
+    }
+    fail(message, offset) {
+        throw new ParseFailure({ message, offset });
+    }
+}
+function nameOf(tok) {
+    return tok.kind === 'regex' ? { kind: 'regex', source: tok.value } : { kind: 'string', text: tok.value };
+}
+//# sourceMappingURL=parse.js.map

package/dist/selector/parse.js.map

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

package/dist/selector/tokenize.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Lexer for the IfcOpenShell selector syntax.
+ *
+ * The rules below are ifc-lite's reading of
+ * <https://docs.ifcopenshell.org/ifcopenshell-python/selector_syntax.html>,
+ * stated here because the page describes the language in prose rather than a
+ * grammar:
+ *
+ * - Whitespace is insignificant outside quotes.
+ * - `,` separates filters within a group, `+` separates groups.
+ * - `!` immediately followed by `=` is the `!=` operator, followed by `*=` is
+ *   `!*=`, and otherwise negates the class or GlobalId that follows.
+ * - `*` is only ever part of `*=`. A trailing `*` is NOT a glob in this
+ *   grammar, so `IfcWall*` is a lexical error rather than a silent no-match —
+ *   the exact shape reported in #4091.
+ * - `"…"` quotes a value; `\"` and `\\` escape inside it.
+ * - `/…/` is a regular expression; `\/` escapes a slash inside the body. No
+ *   trailing flags: the grammar has none, so `/foo/i` is a lexical error at
+ *   the `i` rather than a silently different match.
+ * - A bare word runs until whitespace or one of `,+=!<>*"/`, and may not start
+ *   with `.`; a `.` in that leading position is the property-set separator, so
+ *   both `Pset_WallCommon.FireRating` (one word, split by the parser) and
+ *   `/Pset_.*Common/.FireRating` (regex, dot, word) read correctly while a
+ *   decimal value such as `1.5` stays one word.
+ */
+import type { SelectorParseError } from './ast.js';
+/** Lexeme classes. Not exported: `Token` is the only shape callers name. */
+type TokenKind = 'word' | 'string' | 'regex' | 'op' | 'comma' | 'plus' | 'bang' | 'dot';
+export interface Token {
+    kind: TokenKind;
+    /** Word text, string/regex body, or the operator spelling. */
+    value: string;
+    /** 0-based offset of the token's first character. */
+    start: number;
+    /** 0-based offset one past the token's last character. */
+    end: number;
+}
+export type TokenizeResult = {
+    ok: true;
+    tokens: Token[];
+} | {
+    ok: false;
+    error: SelectorParseError;
+};
+export declare function tokenizeSelector(text: string): TokenizeResult;
+export {};
+//# sourceMappingURL=tokenize.d.ts.map

package/dist/selector/tokenize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenize.d.ts","sourceRoot":"","sources":["../../src/selector/tokenize.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD,4EAA4E;AAC5E,KAAK,SAAS,GACV,MAAM,GACN,QAAQ,GACR,OAAO,GACP,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,KAAK,CAAC;AAEV,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAa7C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CA2E7D"}

package/dist/selector/tokenize.js

@@ -0,0 +1,147 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/** Characters that end a bare word. */
+const WORD_BREAK = new Set([',', '+', '=', '!', '<', '>', '*', '"', '/']);
+function isSpace(ch) {
+    return ch === ' ' || ch === '\t' || ch === '\n' || ch === '\r' || ch === '\f' || ch === '\v';
+}
+function fail(message, offset) {
+    return { ok: false, error: { message, offset } };
+}
+export function tokenizeSelector(text) {
+    const tokens = [];
+    let i = 0;
+    while (i < text.length) {
+        const ch = text[i];
+        if (isSpace(ch)) {
+            i += 1;
+            continue;
+        }
+        if (ch === ',') {
+            tokens.push({ kind: 'comma', value: ',', start: i, end: i + 1 });
+            i += 1;
+            continue;
+        }
+        if (ch === '+') {
+            tokens.push({ kind: 'plus', value: '+', start: i, end: i + 1 });
+            i += 1;
+            continue;
+        }
+        if (ch === '.') {
+            tokens.push({ kind: 'dot', value: '.', start: i, end: i + 1 });
+            i += 1;
+            continue;
+        }
+        if (ch === '!') {
+            if (text[i + 1] === '=') {
+                tokens.push({ kind: 'op', value: '!=', start: i, end: i + 2 });
+                i += 2;
+            }
+            else if (text[i + 1] === '*' && text[i + 2] === '=') {
+                tokens.push({ kind: 'op', value: '!*=', start: i, end: i + 3 });
+                i += 3;
+            }
+            else {
+                tokens.push({ kind: 'bang', value: '!', start: i, end: i + 1 });
+                i += 1;
+            }
+            continue;
+        }
+        if (ch === '*') {
+            if (text[i + 1] !== '=') {
+                return fail(`"*" is only valid as part of the "*=" (contains) operator; this grammar has no "*" wildcard. Use a regular expression such as /Ifc.*Wall/ instead.`, i);
+            }
+            tokens.push({ kind: 'op', value: '*=', start: i, end: i + 2 });
+            i += 2;
+            continue;
+        }
+        if (ch === '=') {
+            tokens.push({ kind: 'op', value: '=', start: i, end: i + 1 });
+            i += 1;
+            continue;
+        }
+        if (ch === '<' || ch === '>') {
+            const two = text[i + 1] === '=';
+            const value = two ? `${ch}=` : ch;
+            tokens.push({ kind: 'op', value, start: i, end: i + value.length });
+            i += value.length;
+            continue;
+        }
+        if (ch === '"') {
+            const quoted = readQuoted(text, i);
+            if (!quoted.ok)
+                return quoted;
+            tokens.push(quoted.token);
+            i = quoted.token.end;
+            continue;
+        }
+        if (ch === '/') {
+            const regex = readRegex(text, i);
+            if (!regex.ok)
+                return regex;
+            tokens.push(regex.token);
+            i = regex.token.end;
+            continue;
+        }
+        const start = i;
+        while (i < text.length) {
+            const c = text[i];
+            if (isSpace(c) || WORD_BREAK.has(c))
+                break;
+            i += 1;
+        }
+        tokens.push({ kind: 'word', value: text.slice(start, i), start, end: i });
+    }
+    return { ok: true, tokens };
+}
+/** `"foo \"bar\" baz"` — the token value is the unescaped body. */
+function readQuoted(text, start) {
+    let out = '';
+    let i = start + 1;
+    while (i < text.length) {
+        const c = text[i];
+        if (c === '\\') {
+            const next = text[i + 1];
+            if (next === undefined)
+                break;
+            out += next;
+            i += 2;
+            continue;
+        }
+        if (c === '"') {
+            return { ok: true, token: { kind: 'string', value: out, start, end: i + 1 } };
+        }
+        out += c;
+        i += 1;
+    }
+    return { ok: false, error: { message: 'unterminated quoted value: no closing "', offset: start } };
+}
+/** `/foo\/bar/` — the token value is the regex source with `\/` unescaped. */
+function readRegex(text, start) {
+    let out = '';
+    let i = start + 1;
+    while (i < text.length) {
+        const c = text[i];
+        if (c === '\\') {
+            const next = text[i + 1];
+            if (next === undefined)
+                break;
+            // Only `\/` is about the delimiter; every other escape belongs to the
+            // regular expression and is handed through untouched.
+            out += next === '/' ? '/' : `\\${next}`;
+            i += 2;
+            continue;
+        }
+        if (c === '/') {
+            if (out.length === 0) {
+                return { ok: false, error: { message: 'empty regular expression: // matches nothing', offset: start } };
+            }
+            return { ok: true, token: { kind: 'regex', value: out, start, end: i + 1 } };
+        }
+        out += c;
+        i += 1;
+    }
+    return { ok: false, error: { message: 'unterminated regular expression: no closing /', offset: start } };
+}
+//# sourceMappingURL=tokenize.js.map