@ifc-lite/ifcx 2.2.2 → 2.3.0

package/dist/tombstones.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Tombstone (deletion overlay) semantics for IFCX composition.
+ *
+ * A tombstone is an opinion `{ "ifclite::deleted": true }` at an entity
+ * path. Composition resolves the attribute with normal layer strength
+ * (stronger layers override weaker ones), so:
+ *
+ * - a tombstone shadows all weaker opinions for that path, including the
+ *   entity's child subtree (entity tombstones delete the subtree), and
+ * - a stronger layer may resurrect the entity by asserting
+ *   `"ifclite::deleted": false` (this is how a revert layer undoes a
+ *   deletion).
+ *
+ * The filter runs after attribute merging, so the surviving value of
+ * `ifclite::deleted` is already the strongest opinion in the stack.
+ *
+ * Spec: docs/architecture/layer-prs/02-layer-format.md §2.3.
+ */
+import type { ComposedNode } from './types.js';
+/** True when a merged attribute record marks the node as deleted. */
+export declare function isTombstoned(attributes: Map<string, unknown>): boolean;
+/**
+ * Remove tombstoned nodes (and their subtrees) from a composed node map.
+ *
+ * - Nodes whose strongest `ifclite::deleted` opinion is `true` are removed.
+ * - Their descendants (reachable through `children`) are removed with them.
+ * - References to removed nodes are dropped from surviving parents.
+ * - The `ifclite::deleted` marker itself is stripped from survivors so the
+ *   composed state is clean for extractors and export.
+ *
+ * The input map is mutated in place (composition owns these structures)
+ * and returned for convenience.
+ */
+export declare function applyTombstones<T extends ComposedNode>(composed: Map<string, T>): Map<string, T>;
+//# sourceMappingURL=tombstones.d.ts.map

package/dist/tombstones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tombstones.d.ts","sourceRoot":"","sources":["../src/tombstones.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAEtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,YAAY,EACpD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GACvB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAwChB"}

package/dist/tombstones.js

@@ -0,0 +1,64 @@
+/* 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 { IFCLITE_ATTR } from './types.js';
+/** True when a merged attribute record marks the node as deleted. */
+export function isTombstoned(attributes) {
+    return attributes.get(IFCLITE_ATTR.DELETED) === true;
+}
+/**
+ * Remove tombstoned nodes (and their subtrees) from a composed node map.
+ *
+ * - Nodes whose strongest `ifclite::deleted` opinion is `true` are removed.
+ * - Their descendants (reachable through `children`) are removed with them.
+ * - References to removed nodes are dropped from surviving parents.
+ * - The `ifclite::deleted` marker itself is stripped from survivors so the
+ *   composed state is clean for extractors and export.
+ *
+ * The input map is mutated in place (composition owns these structures)
+ * and returned for convenience.
+ */
+export function applyTombstones(composed) {
+    const deleted = new Set();
+    for (const [path, node] of composed) {
+        if (isTombstoned(node.attributes))
+            deleted.add(path);
+    }
+    if (deleted.size === 0) {
+        // Still strip explicit `deleted: false` resurrect markers.
+        for (const node of composed.values()) {
+            node.attributes.delete(IFCLITE_ATTR.DELETED);
+        }
+        return composed;
+    }
+    // Entity tombstones shadow child paths: expand to full subtrees.
+    const queue = [...deleted];
+    while (queue.length > 0) {
+        const path = queue.pop();
+        if (path === undefined)
+            break;
+        const node = composed.get(path);
+        if (!node)
+            continue;
+        for (const child of node.children.values()) {
+            // A child carrying its own resurrect opinion stays only if it is
+            // also referenced by a surviving parent; subtree shadowing wins here.
+            if (!deleted.has(child.path)) {
+                deleted.add(child.path);
+                queue.push(child.path);
+            }
+        }
+    }
+    for (const path of deleted) {
+        composed.delete(path);
+    }
+    for (const node of composed.values()) {
+        node.attributes.delete(IFCLITE_ATTR.DELETED);
+        for (const [name, child] of node.children) {
+            if (deleted.has(child.path))
+                node.children.delete(name);
+        }
+    }
+    return composed;
+}
+//# sourceMappingURL=tombstones.js.map

package/dist/tombstones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tombstones.js","sourceRoot":"","sources":["../src/tombstones.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAsB/D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,qEAAqE;AACrE,MAAM,UAAU,YAAY,CAAC,UAAgC;IAC3D,OAAO,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAwB;IAExB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QACpC,IAAI,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACvB,2DAA2D;QAC3D,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,iEAAiE;IACjE,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAC3B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM;QAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,iEAAiE;YACjE,sEAAsE;YACtE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACrC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1C,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/types.d.ts

@@ -69,7 +69,69 @@ export declare const ATTR: {
     readonly MATERIAL: "bsi::ifc::material";
     readonly PROP_PREFIX: "bsi::ifc::prop::";
     readonly SPACE_BOUNDARY: "bsi::ifc::spaceBoundary";
+    readonly PART_OF_SYSTEM: "bsi::ifc::system::partofsystem";
 };
+/**
+ * IFClite extension attributes for layered change tracking
+ * (docs/architecture/layer-prs/). Tools unaware of the namespace ignore
+ * these and still get valid IFCX composition (modulo deletion overlays,
+ * which `bakeLayers` can materialize away for foreign tools).
+ */
+export declare const IFCLITE_ATTR: {
+    /**
+     * Tombstone opinion: `true` deletes the entity (and shadows all weaker
+     * opinions for the path, including child paths); `false` resurrects it.
+     */
+    readonly DELETED: "ifclite::deleted";
+    /** Marks derived (cache) content excluded from canonical hashing. */
+    readonly DERIVED: "ifclite::derived";
+    /**
+     * Collab structured-branch carriers (#1031): the collab runtime keeps
+     * classifications / materials / geometry refs as dedicated CRDT
+     * branches; on the IFCX wire they travel as ordinary attributes under
+     * these keys (psets/quantities use the `bsi::ifc::v5a::<Set>::<Name>`
+     * convention instead, so merge component keys stay `pset:`/`qset:`).
+     */
+    readonly CLASSIFICATIONS: "ifclite::classifications";
+    readonly MATERIALS: "ifclite::materials";
+    readonly GEOMETRY_REF: "ifclite::geometryRef";
+};
+/** Header key carrying the provenance manifest (see provenance.ts). */
+export declare const PROVENANCE_KEY = "ifclite::provenance";
+/**
+ * IFC5-alpha namespaced property/quantity prefix (#1031): keys are
+ * `bsi::ifc::v5a::<Set>::<Name>`. Within this namespace the routing
+ * dialect is fixed (see `routesToQuantityTable` and the collab
+ * structured-branch inflation): `Pset_*` members are properties, `Qto_*`
+ * members are quantities, custom sets route typed records to properties
+ * and raw numbers to quantities.
+ */
+export declare const V5A_ATTR_PREFIX = "bsi::ifc::v5a::";
+/** Split a v5a key into set + member name; null when not a v5a set key. */
+export declare function parseV5aKey(key: string): {
+    setName: string;
+    name: string;
+} | null;
+/**
+ * Canonical wire shape for typed property values (#1031): pset
+ * properties under `bsi::ifc::v5a::<Set>::<Prop>` carry this record so
+ * the IFC type, unit, and provenance survive round-trips. Every writer
+ * (collab snapshots, MCP draft ops) and reader (property extraction,
+ * seed inflation) shares this one definition.
+ */
+export interface TypedPropertyValue {
+    type: string;
+    value: string | number | boolean | null;
+    unit?: string;
+    source?: string;
+}
+/**
+ * Strict shape test for TypedPropertyValue. Deliberately rejects any
+ * extra keys: legacy/migrated attributes carry raw scalars or foreign
+ * objects, never this exact record, so the test is what disambiguates
+ * "typed property" from "leave it alone".
+ */
+export declare function isTypedPropertyValue(value: unknown): value is TypedPropertyValue;
 export interface UsdMesh {
     points: number[][];
     faceVertexIndices: number[];

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA;;;GAGG;AAMH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,IAAI,EAAE,QAAQ,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAMD,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,SAAS,GACT,SAAS,GACT,QAAQ,GACR,UAAU,GACV,MAAM,GACN,OAAO,GACP,QAAQ,GACR,WAAW,GACX,MAAM,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,oBAAoB,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,oBAAoB,CAAC;CAC7B;AAMD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACrC;AAMD;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;CAqBP,CAAC;AAMX,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IACnB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;CACvB;AAMD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAMD,eAAO,MAAM,aAAa,aAMxB,CAAC;AAEH,eAAO,MAAM,sBAAsB,aAgBjC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -24,8 +24,91 @@ export const ATTR = {
     PROP_PREFIX: 'bsi::ifc::prop::',
     // IFC Relationships (evolving)
     SPACE_BOUNDARY: 'bsi::ifc::spaceBoundary',
+    // IFC5 system membership (bsi::ifc::system schema): sits on the MEMBER
+    // node as `[{ ref }]` pointing at the IfcSystem-family node — the ECS
+    // successor of IfcRelAssignsToGroup (see the buildingSMART
+    // Domestic_Hot_Water sample).
+    PART_OF_SYSTEM: 'bsi::ifc::system::partofsystem',
 };
 // ============================================================================
+// IFClite Layer Extension Namespace (`ifclite::`)
+// ============================================================================
+/**
+ * IFClite extension attributes for layered change tracking
+ * (docs/architecture/layer-prs/). Tools unaware of the namespace ignore
+ * these and still get valid IFCX composition (modulo deletion overlays,
+ * which `bakeLayers` can materialize away for foreign tools).
+ */
+export const IFCLITE_ATTR = {
+    /**
+     * Tombstone opinion: `true` deletes the entity (and shadows all weaker
+     * opinions for the path, including child paths); `false` resurrects it.
+     */
+    DELETED: 'ifclite::deleted',
+    /** Marks derived (cache) content excluded from canonical hashing. */
+    DERIVED: 'ifclite::derived',
+    /**
+     * Collab structured-branch carriers (#1031): the collab runtime keeps
+     * classifications / materials / geometry refs as dedicated CRDT
+     * branches; on the IFCX wire they travel as ordinary attributes under
+     * these keys (psets/quantities use the `bsi::ifc::v5a::<Set>::<Name>`
+     * convention instead, so merge component keys stay `pset:`/`qset:`).
+     */
+    CLASSIFICATIONS: 'ifclite::classifications',
+    MATERIALS: 'ifclite::materials',
+    GEOMETRY_REF: 'ifclite::geometryRef',
+};
+/** Header key carrying the provenance manifest (see provenance.ts). */
+export const PROVENANCE_KEY = 'ifclite::provenance';
+/**
+ * IFC5-alpha namespaced property/quantity prefix (#1031): keys are
+ * `bsi::ifc::v5a::<Set>::<Name>`. Within this namespace the routing
+ * dialect is fixed (see `routesToQuantityTable` and the collab
+ * structured-branch inflation): `Pset_*` members are properties, `Qto_*`
+ * members are quantities, custom sets route typed records to properties
+ * and raw numbers to quantities.
+ */
+export const V5A_ATTR_PREFIX = 'bsi::ifc::v5a::';
+/** Split a v5a key into set + member name; null when not a v5a set key. */
+export function parseV5aKey(key) {
+    if (!key.startsWith(V5A_ATTR_PREFIX))
+        return null;
+    const rest = key.slice(V5A_ATTR_PREFIX.length);
+    const sep = rest.indexOf('::');
+    if (sep <= 0 || sep >= rest.length - 2)
+        return null;
+    return { setName: rest.slice(0, sep), name: rest.slice(sep + 2) };
+}
+const TYPED_PROPERTY_KEYS = new Set(['type', 'value', 'unit', 'source']);
+/**
+ * Strict shape test for TypedPropertyValue. Deliberately rejects any
+ * extra keys: legacy/migrated attributes carry raw scalars or foreign
+ * objects, never this exact record, so the test is what disambiguates
+ * "typed property" from "leave it alone".
+ */
+export function isTypedPropertyValue(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const record = value;
+    if (typeof record.type !== 'string')
+        return false;
+    if (!('value' in record))
+        return false;
+    const v = record.value;
+    if (v !== null && typeof v !== 'string' && typeof v !== 'number' && typeof v !== 'boolean') {
+        return false;
+    }
+    for (const key of Object.keys(record)) {
+        if (!TYPED_PROPERTY_KEYS.has(key))
+            return false;
+    }
+    if ('unit' in record && record.unit !== undefined && typeof record.unit !== 'string')
+        return false;
+    if ('source' in record && record.source !== undefined && typeof record.source !== 'string')
+        return false;
+    return true;
+}
+// ============================================================================
 // Spatial Types
 // ============================================================================
 export const SPATIAL_TYPES = new Set([

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AA6F/D,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,8BAA8B;IAC9B,KAAK,EAAE,iBAAiB;IAExB,gDAAgD;IAChD,IAAI,EAAE,oBAAoB;IAC1B,SAAS,EAAE,cAAc;IACzB,UAAU,EAAE,0BAA0B;IAEtC,4BAA4B;IAC5B,aAAa,EAAE,sCAAsC;IACrD,OAAO,EAAE,iCAAiC;IAE1C,gCAAgC;IAChC,QAAQ,EAAE,oBAAoB;IAE9B,2DAA2D;IAC3D,WAAW,EAAE,kBAAkB;IAE/B,+BAA+B;IAC/B,cAAc,EAAE,yBAAyB;CACjC,CAAC;AA0BX,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IACnC,YAAY;IACZ,SAAS;IACT,aAAa;IACb,mBAAmB;IACnB,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IAC5C,SAAS;IACT,qBAAqB;IACrB,SAAS;IACT,WAAW;IACX,SAAS;IACT,WAAW;IACX,SAAS;IACT,UAAU;IACV,SAAS;IACT,SAAS;IACT,aAAa;IACb,gBAAgB;IAChB,YAAY;IACZ,mBAAmB;IACnB,yBAAyB;CAC1B,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ifc-lite/ifcx",
-  "version": "2.2.2",
+  "version": "2.3.0",
   "description": "IFC5 (IFCX) parser for IFC-Lite",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,9 +13,10 @@
     }
   },
   "dependencies": {
-    "@ifc-lite/data": "^2.5.2",
-    "@ifc-lite/mutations": "^1.18.1",
-    "@ifc-lite/pointcloud": "^0.3.5"
+    "@noble/hashes": "^2.2.0",
+    "@ifc-lite/pointcloud": "^0.3.5",
+    "@ifc-lite/data": "^2.5.3",
+    "@ifc-lite/mutations": "^1.19.0"
   },
   "devDependencies": {
     "tsx": "^4.23.0",