@faicad/faijs 0.13.0

package/dist/vendored/brepjs/topology/shapeRef/refResolveFns.js

@@ -0,0 +1,128 @@
+/**
+ * Consumer-facing resolution for lineage references — the layer that turns the
+ * capture/resolve primitives into a parametric-replay flow.
+ *
+ * A downstream op (fillet, offset, shell, ...) names the entity it acts on with
+ * a lineage ref at author time. When an upstream parameter changes and the model
+ * is rebuilt, these helpers re-resolve that ref to the live entity on the new
+ * shape, so the op re-targets the *same* feature instead of a stale hash. One
+ * unified dispatch covers all four ref kinds (face / edge / vertex / generated
+ * face), since they share the `(ref, roles, shape)` resolve signature.
+ */
+import { assignRoles, resolveRef } from './shapeRefFns.js';
+import { resolveEdgeRef } from './edgeRefFns.js';
+import { resolveVertexRef } from './vertexRefFns.js';
+import { resolveDerivedFaceRef } from './derivedFaceRefFns.js';
+function isRefObject(v) {
+    return typeof v === 'object' && v !== null && 'origin' in v;
+}
+/** A generated-face ref: carries the bridged roles + the op that made it. */
+export function isDerivedFaceRef(v) {
+    return isRefObject(v) && 'betweenRoles' in v && 'op' in v;
+}
+/** An edge ref: exactly two adjacent face-roles. */
+export function isEdgeRef(v) {
+    return isRefObject(v) && Array.isArray(v['faceRoles']) && v['faceRoles'].length === 2;
+}
+/** A vertex ref: three or more adjacent face-roles. */
+export function isVertexRef(v) {
+    return isRefObject(v) && Array.isArray(v['faceRoles']) && v['faceRoles'].length >= 3;
+}
+/** A face ref: a single role name. */
+export function isFaceRef(v) {
+    return isRefObject(v) && typeof v['role'] === 'string';
+}
+/** True for any of the four lineage reference kinds. */
+export function isLineageRef(v) {
+    return isFaceRef(v) || isEdgeRef(v) || isVertexRef(v) || isDerivedFaceRef(v);
+}
+function brokenResolution(reason, candidates) {
+    return candidates === undefined ? { ok: false, reason } : { ok: false, reason, candidates };
+}
+/**
+ * Resolve a lineage ref against `shape` using a prepared role table (the robust
+ * path — the table is maintained across edits via `updateRoles`). Returns the
+ * live entity on success, or the failure reason (and tied candidates) on failure.
+ */
+export function resolveLineageRef(ref, roles, shape) {
+    if (isDerivedFaceRef(ref)) {
+        const r = resolveDerivedFaceRef(ref, roles, shape);
+        return 'face' in r ? { ok: true, entity: r.face } : brokenResolution(r.reason, r.candidates);
+    }
+    if (isEdgeRef(ref)) {
+        const r = resolveEdgeRef(ref, roles, shape);
+        return 'edge' in r ? { ok: true, entity: r.edge } : brokenResolution(r.reason, r.candidates);
+    }
+    if (isVertexRef(ref)) {
+        const r = resolveVertexRef(ref, roles, shape);
+        return 'vertex' in r
+            ? { ok: true, entity: r.vertex }
+            : brokenResolution(r.reason, r.candidates);
+    }
+    const r = resolveRef(ref, roles, shape);
+    return 'face' in r ? { ok: true, entity: r.face } : brokenResolution(r.reason, r.candidates);
+}
+/** Role table for a from-scratch rebuild, reusing a per-origin cache. */
+function rolesFor(ref, shape, cache) {
+    const cached = cache.get(ref.origin);
+    if (cached !== undefined)
+        return cached;
+    const roles = new Map([[ref.origin, assignRoles(shape, ref.origin)]]);
+    cache.set(ref.origin, roles);
+    return roles;
+}
+/**
+ * Resolve a lineage ref against a freshly rebuilt `shape` with no maintained
+ * role table, re-deriving roles via `assignRoles(shape, ref.origin)`. The ref's
+ * `origin` must therefore be the role-assignment scheme (e.g. `'box'`), and
+ * stability is bounded by that scheme — `'box'` names faces semantically
+ * (rebuild-stable); other schemes fall back to positional `face_N`.
+ */
+export function resolveRefIn(ref, shape) {
+    return resolveLineageRef(ref, rolesFor(ref, shape, new Map()), shape);
+}
+/**
+ * A plain options object worth recursing into for nested refs — a literal `{}`
+ * (or null-prototype) that isn't a lineage ref, a shape handle, or a Date/Map/
+ * class instance (which `Object.entries` would silently flatten away).
+ */
+function isPlainOptions(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    if (proto !== Object.prototype && proto !== null)
+        return false;
+    return !('wrapped' in value);
+}
+/**
+ * Replace every lineage ref in an operation's params with the live entity it
+ * resolves to in `shape`, recursing into arrays (a fillet's edge list) and
+ * nested plain objects (a `{ selection: { edge } }` options bag). Refs that
+ * can't resolve are left as-is. Role tables are re-derived once per `origin` and
+ * reused across the whole params map. Lets a replay engine pass stable entity
+ * selections that survive upstream edits.
+ */
+export function resolveRefParams(params, shape) {
+    const roleCache = new Map();
+    const resolveValue = (value) => {
+        if (isLineageRef(value)) {
+            const res = resolveLineageRef(value, rolesFor(value, shape, roleCache), shape);
+            return res.ok ? res.entity : value;
+        }
+        if (Array.isArray(value))
+            return value.map(resolveValue);
+        if (isPlainOptions(value)) {
+            const nested = {};
+            for (const [k, v] of Object.entries(value))
+                nested[k] = resolveValue(v);
+            return nested;
+        }
+        return value;
+    };
+    const out = { ...params };
+    for (const [key, value] of Object.entries(params)) {
+        out[key] = resolveValue(value);
+    }
+    return out;
+}
+//# sourceMappingURL=refResolveFns.js.map

package/dist/vendored/brepjs/topology/shapeRef/refResolveFns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refResolveFns.js","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/topology/shapeRef/refResolveFns.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Consumer-facing resolution for lineage references — the layer that turns the\n * capture/resolve primitives into a parametric-replay flow.\n *\n * A downstream op (fillet, offset, shell, ...) names the entity it acts on with\n * a lineage ref at author time. When an upstream parameter changes and the model\n * is rebuilt, these helpers re-resolve that ref to the live entity on the new\n * shape, so the op re-targets the *same* feature instead of a stale hash. One\n * unified dispatch covers all four ref kinds (face / edge / vertex / generated\n * face), since they share the `(ref, roles, shape)` resolve signature.\n */\n\nimport type { Edge, Face, Shape3D, Vertex } from '../../core/shapeTypes.js';\nimport { assignRoles, resolveRef } from './shapeRefFns.js';\nimport { resolveEdgeRef } from './edgeRefFns.js';\nimport { resolveVertexRef } from './vertexRefFns.js';\nimport { resolveDerivedFaceRef } from './derivedFaceRefFns.js';\nimport type { ShapeRef, EdgeRef, VertexRef, DerivedFaceRef, RoleTable } from './shapeRefTypes.js';\n\n/** Any of the four lineage reference kinds. */\nexport type LineageRef = ShapeRef | EdgeRef | VertexRef | DerivedFaceRef;\n/** The live entity a lineage ref resolves to. */\nexport type ResolvedEntity = Face | Edge | Vertex;\n\n/** Why a lineage ref failed to resolve (preserved from the underlying resolver). */\nexport type BrokenReason = 'ambiguous' | 'not-found' | 'deleted';\n\n/**\n * Outcome of resolving a lineage ref. Carries the failure `reason` (and any tied\n * `candidates`) rather than collapsing to undefined, so a replay engine can tell\n * \"deleted by the edit\" (expected — skip) from \"ambiguous\" (warn the author).\n */\nexport type LineageResolution =\n  | { readonly ok: true; readonly entity: ResolvedEntity }\n  | {\n      readonly ok: false;\n      readonly reason: BrokenReason;\n      readonly candidates?: readonly ResolvedEntity[];\n    };\n\nfunction isRefObject(v: unknown): v is Record<string, unknown> {\n  return typeof v === 'object' && v !== null && 'origin' in v;\n}\n\n/** A generated-face ref: carries the bridged roles + the op that made it. */\nexport function isDerivedFaceRef(v: unknown): v is DerivedFaceRef {\n  return isRefObject(v) && 'betweenRoles' in v && 'op' in v;\n}\n/** An edge ref: exactly two adjacent face-roles. */\nexport function isEdgeRef(v: unknown): v is EdgeRef {\n  return isRefObject(v) && Array.isArray(v['faceRoles']) && v['faceRoles'].length === 2;\n}\n/** A vertex ref: three or more adjacent face-roles. */\nexport function isVertexRef(v: unknown): v is VertexRef {\n  return isRefObject(v) && Array.isArray(v['faceRoles']) && v['faceRoles'].length >= 3;\n}\n/** A face ref: a single role name. */\nexport function isFaceRef(v: unknown): v is ShapeRef {\n  return isRefObject(v) && typeof v['role'] === 'string';\n}\n/** True for any of the four lineage reference kinds. */\nexport function isLineageRef(v: unknown): v is LineageRef {\n  return isFaceRef(v) || isEdgeRef(v) || isVertexRef(v) || isDerivedFaceRef(v);\n}\n\nfunction brokenResolution(\n  reason: BrokenReason,\n  candidates?: readonly ResolvedEntity[]\n): LineageResolution {\n  return candidates === undefined ? { ok: false, reason } : { ok: false, reason, candidates };\n}\n\n/**\n * Resolve a lineage ref against `shape` using a prepared role table (the robust\n * path — the table is maintained across edits via `updateRoles`). Returns the\n * live entity on success, or the failure reason (and tied candidates) on failure.\n */\nexport function resolveLineageRef(\n  ref: LineageRef,\n  roles: RoleTable,\n  shape: Shape3D\n): LineageResolution {\n  if (isDerivedFaceRef(ref)) {\n    const r = resolveDerivedFaceRef(ref, roles, shape);\n    return 'face' in r ? { ok: true, entity: r.face } : brokenResolution(r.reason, r.candidates);\n  }\n  if (isEdgeRef(ref)) {\n    const r = resolveEdgeRef(ref, roles, shape);\n    return 'edge' in r ? { ok: true, entity: r.edge } : brokenResolution(r.reason, r.candidates);\n  }\n  if (isVertexRef(ref)) {\n    const r = resolveVertexRef(ref, roles, shape);\n    return 'vertex' in r\n      ? { ok: true, entity: r.vertex }\n      : brokenResolution(r.reason, r.candidates);\n  }\n  const r = resolveRef(ref, roles, shape);\n  return 'face' in r ? { ok: true, entity: r.face } : brokenResolution(r.reason, r.candidates);\n}\n\n/** Role table for a from-scratch rebuild, reusing a per-origin cache. */\nfunction rolesFor(ref: LineageRef, shape: Shape3D, cache: Map<string, RoleTable>): RoleTable {\n  const cached = cache.get(ref.origin);\n  if (cached !== undefined) return cached;\n  const roles: RoleTable = new Map([[ref.origin, assignRoles(shape, ref.origin)]]);\n  cache.set(ref.origin, roles);\n  return roles;\n}\n\n/**\n * Resolve a lineage ref against a freshly rebuilt `shape` with no maintained\n * role table, re-deriving roles via `assignRoles(shape, ref.origin)`. The ref's\n * `origin` must therefore be the role-assignment scheme (e.g. `'box'`), and\n * stability is bounded by that scheme — `'box'` names faces semantically\n * (rebuild-stable); other schemes fall back to positional `face_N`.\n */\nexport function resolveRefIn(ref: LineageRef, shape: Shape3D): LineageResolution {\n  return resolveLineageRef(ref, rolesFor(ref, shape, new Map()), shape);\n}\n\n/**\n * A plain options object worth recursing into for nested refs — a literal `{}`\n * (or null-prototype) that isn't a lineage ref, a shape handle, or a Date/Map/\n * class instance (which `Object.entries` would silently flatten away).\n */\nfunction isPlainOptions(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) return false;\n  const proto = Object.getPrototypeOf(value) as object | null;\n  if (proto !== Object.prototype && proto !== null) return false;\n  return !('wrapped' in value);\n}\n\n/**\n * Replace every lineage ref in an operation's params with the live entity it\n * resolves to in `shape`, recursing into arrays (a fillet's edge list) and\n * nested plain objects (a `{ selection: { edge } }` options bag). Refs that\n * can't resolve are left as-is. Role tables are re-derived once per `origin` and\n * reused across the whole params map. Lets a replay engine pass stable entity\n * selections that survive upstream edits.\n */\nexport function resolveRefParams(\n  params: Readonly<Record<string, unknown>>,\n  shape: Shape3D\n): Record<string, unknown> {\n  const roleCache = new Map<string, RoleTable>();\n  const resolveValue = (value: unknown): unknown => {\n    if (isLineageRef(value)) {\n      const res = resolveLineageRef(value, rolesFor(value, shape, roleCache), shape);\n      return res.ok ? res.entity : value;\n    }\n    if (Array.isArray(value)) return value.map(resolveValue);\n    if (isPlainOptions(value)) {\n      const nested: Record<string, unknown> = {};\n      for (const [k, v] of Object.entries(value)) nested[k] = resolveValue(v);\n      return nested;\n    }\n    return value;\n  };\n  const out: Record<string, unknown> = { ...params };\n  for (const [key, value] of Object.entries(params)) {\n    out[key] = resolveValue(value);\n  }\n  return out;\n}\n"]}

package/dist/vendored/brepjs/topology/shapeRef/roleLookup.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared helpers for lineage references (edge/vertex): the role-table lookups
+ * — forward "role → current faces", reverse "face → role" — plus the small
+ * geometry both share. (Not hot-path, so a shared `distance` here is fine; the
+ * deliberately math-free `vec3.ts` is reserved for hot kernel loops.)
+ */
+import type { Face, Shape3D, Vertex } from '../../core/shapeTypes.js';
+import type { Vec3 } from '../../core/types.js';
+import type { RoleTable } from './shapeRefTypes.js';
+/** Euclidean distance between two points. */
+export declare function distance(a: Vec3, b: Vec3): number;
+/** Mean of a set of vertices' positions (e.g. an edge's endpoints). */
+export declare function vertexCentroid(verts: readonly Vertex[]): Vec3 | undefined;
+/** The role whose tracked hashes include this face (reverse lookup). */
+export declare function roleOfFace(face: Face, origin: string, roles: RoleTable): string | undefined;
+/** Current faces a role resolves to — its tracked successors present in `shape`. */
+export declare function facesForRole(shape: Shape3D, origin: string, role: string, roles: RoleTable): Face[];
+//# sourceMappingURL=roleLookup.d.ts.map

package/dist/vendored/brepjs/topology/shapeRef/roleLookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roleLookup.d.ts","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/topology/shapeRef/roleLookup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAGhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,6CAA6C;AAC7C,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAKjD;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,CAazE;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAQ3F;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,GACf,IAAI,EAAE,CAIR"}

package/dist/vendored/brepjs/topology/shapeRef/roleLookup.js

@@ -0,0 +1,51 @@
+/**
+ * Shared helpers for lineage references (edge/vertex): the role-table lookups
+ * — forward "role → current faces", reverse "face → role" — plus the small
+ * geometry both share. (Not hot-path, so a shared `distance` here is fine; the
+ * deliberately math-free `vec3.ts` is reserved for hot kernel loops.)
+ */
+import { getFaces, vertexPosition } from '../topologyQueryFns.js';
+import { getHashCode } from '../shapeFns.js';
+/** Euclidean distance between two points. */
+export function distance(a, b) {
+    const dx = a[0] - b[0];
+    const dy = a[1] - b[1];
+    const dz = a[2] - b[2];
+    return Math.sqrt(dx * dx + dy * dy + dz * dz);
+}
+/** Mean of a set of vertices' positions (e.g. an edge's endpoints). */
+export function vertexCentroid(verts) {
+    if (verts.length === 0)
+        return undefined;
+    let x = 0;
+    let y = 0;
+    let z = 0;
+    for (const v of verts) {
+        const p = vertexPosition(v);
+        x += p[0];
+        y += p[1];
+        z += p[2];
+    }
+    const n = verts.length;
+    return [x / n, y / n, z / n];
+}
+/** The role whose tracked hashes include this face (reverse lookup). */
+export function roleOfFace(face, origin, roles) {
+    const originRoles = roles.get(origin);
+    if (!originRoles)
+        return undefined;
+    const hash = getHashCode(face);
+    for (const [role, hashes] of originRoles) {
+        if (hashes.includes(hash))
+            return role;
+    }
+    return undefined;
+}
+/** Current faces a role resolves to — its tracked successors present in `shape`. */
+export function facesForRole(shape, origin, role, roles) {
+    const hashes = roles.get(origin)?.get(role);
+    if (hashes === undefined || hashes.length === 0)
+        return [];
+    return getFaces(shape).filter((f) => hashes.includes(getHashCode(f)));
+}
+//# sourceMappingURL=roleLookup.js.map

package/dist/vendored/brepjs/topology/shapeRef/roleLookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roleLookup.js","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/topology/shapeRef/roleLookup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,6CAA6C;AAC7C,MAAM,UAAU,QAAQ,CAAC,CAAO,EAAE,CAAO;IACvC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAAC,KAAwB;IACrD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACV,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACV,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACZ,CAAC;IACD,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,UAAU,CAAC,IAAU,EAAE,MAAc,EAAE,KAAgB;IACrE,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAC;IACnC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACzC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,YAAY,CAC1B,KAAc,EACd,MAAc,EACd,IAAY,EACZ,KAAgB;IAEhB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3D,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC","sourcesContent":["/**\n * Shared helpers for lineage references (edge/vertex): the role-table lookups\n * — forward \"role → current faces\", reverse \"face → role\" — plus the small\n * geometry both share. (Not hot-path, so a shared `distance` here is fine; the\n * deliberately math-free `vec3.ts` is reserved for hot kernel loops.)\n */\n\nimport type { Face, Shape3D, Vertex } from '../../core/shapeTypes.js';\nimport type { Vec3 } from '../../core/types.js';\nimport { getFaces, vertexPosition } from '../topologyQueryFns.js';\nimport { getHashCode } from '../shapeFns.js';\nimport type { RoleTable } from './shapeRefTypes.js';\n\n/** Euclidean distance between two points. */\nexport function distance(a: Vec3, b: Vec3): number {\n  const dx = a[0] - b[0];\n  const dy = a[1] - b[1];\n  const dz = a[2] - b[2];\n  return Math.sqrt(dx * dx + dy * dy + dz * dz);\n}\n\n/** Mean of a set of vertices' positions (e.g. an edge's endpoints). */\nexport function vertexCentroid(verts: readonly Vertex[]): Vec3 | undefined {\n  if (verts.length === 0) return undefined;\n  let x = 0;\n  let y = 0;\n  let z = 0;\n  for (const v of verts) {\n    const p = vertexPosition(v);\n    x += p[0];\n    y += p[1];\n    z += p[2];\n  }\n  const n = verts.length;\n  return [x / n, y / n, z / n];\n}\n\n/** The role whose tracked hashes include this face (reverse lookup). */\nexport function roleOfFace(face: Face, origin: string, roles: RoleTable): string | undefined {\n  const originRoles = roles.get(origin);\n  if (!originRoles) return undefined;\n  const hash = getHashCode(face);\n  for (const [role, hashes] of originRoles) {\n    if (hashes.includes(hash)) return role;\n  }\n  return undefined;\n}\n\n/** Current faces a role resolves to — its tracked successors present in `shape`. */\nexport function facesForRole(\n  shape: Shape3D,\n  origin: string,\n  role: string,\n  roles: RoleTable\n): Face[] {\n  const hashes = roles.get(origin)?.get(role);\n  if (hashes === undefined || hashes.length === 0) return [];\n  return getFaces(shape).filter((f) => hashes.includes(getHashCode(f)));\n}\n"]}

package/dist/vendored/brepjs/topology/shapeRef/scoring.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Face scoring for geometric fallback matching.
+ * Modeled on the existing pattern in originTrackingFns.ts.
+ */
+import type { GeometricHint } from './shapeRefTypes.js';
+import type { Face } from '../../core/shapeTypes.js';
+/** Scoring function: higher score = better match. Returns -Infinity to reject. */
+export type FaceScorer = (hint: GeometricHint, face: Face) => number;
+/**
+ * Default face scorer combining surface type, normal alignment, centroid proximity,
+ * and area similarity.
+ *
+ * Scoring breakdown:
+ * - Surface type match: +1.0 (mismatch when both defined: -Infinity)
+ * - Normal dot product: weighted contribution (rejected if < 0.707)
+ * - Centroid distance: quadratic penalty (rejected if distSq > 100)
+ * - Area ratio: penalized if |log(hintArea / faceArea)| > 1.0
+ */
+export declare function defaultScorer(hint: GeometricHint, face: Face): number;
+//# sourceMappingURL=scoring.d.ts.map

package/dist/vendored/brepjs/topology/shapeRef/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/topology/shapeRef/scoring.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAQrD,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;AAMrE;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CA+CrE"}

package/dist/vendored/brepjs/topology/shapeRef/scoring.js

@@ -0,0 +1,65 @@
+/**
+ * Face scoring for geometric fallback matching.
+ * Modeled on the existing pattern in originTrackingFns.ts.
+ */
+import { normalAt, faceCenter, faceGeomType } from '../faceFns.js';
+import { measureArea } from '../../measurement/measureFns.js';
+// ---------------------------------------------------------------------------
+// Default scorer
+// ---------------------------------------------------------------------------
+/**
+ * Default face scorer combining surface type, normal alignment, centroid proximity,
+ * and area similarity.
+ *
+ * Scoring breakdown:
+ * - Surface type match: +1.0 (mismatch when both defined: -Infinity)
+ * - Normal dot product: weighted contribution (rejected if < 0.707)
+ * - Centroid distance: quadratic penalty (rejected if distSq > 100)
+ * - Area ratio: penalized if |log(hintArea / faceArea)| > 1.0
+ */
+export function defaultScorer(hint, face) {
+    let score = 0;
+    // Surface type
+    const faceType = faceGeomType(face);
+    if (hint.surfaceType !== undefined) {
+        if (faceType === hint.surfaceType) {
+            score += 1.0;
+        }
+        else {
+            return -Infinity;
+        }
+    }
+    // Normal dot product
+    if (hint.normal !== undefined) {
+        const faceNormal = normalAt(face);
+        const dot = hint.normal[0] * faceNormal[0] +
+            hint.normal[1] * faceNormal[1] +
+            hint.normal[2] * faceNormal[2];
+        if (dot < 0.707)
+            return -Infinity;
+        score += dot;
+    }
+    // Centroid distance penalty
+    if (hint.centroid !== undefined) {
+        const faceCentroid = faceCenter(face);
+        const dx = hint.centroid[0] - faceCentroid[0];
+        const dy = hint.centroid[1] - faceCentroid[1];
+        const dz = hint.centroid[2] - faceCentroid[2];
+        const distSq = dx * dx + dy * dy + dz * dz;
+        if (distSq > 100)
+            return -Infinity;
+        score -= distSq / 100;
+    }
+    // Area ratio penalty
+    if (hint.area !== undefined && hint.area > 0) {
+        const areaResult = measureArea(face);
+        if (areaResult.ok && areaResult.value > 0) {
+            const logRatio = Math.abs(Math.log(hint.area / areaResult.value));
+            if (logRatio > 1.0) {
+                score -= logRatio;
+            }
+        }
+    }
+    return score;
+}
+//# sourceMappingURL=scoring.js.map

package/dist/vendored/brepjs/topology/shapeRef/scoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.js","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/topology/shapeRef/scoring.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAS9D,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,IAAmB,EAAE,IAAU;IAC3D,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,eAAe;IACf,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACnC,IAAI,QAAQ,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YAClC,KAAK,IAAI,GAAG,CAAC;QACf,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,QAAQ,CAAC;QACnB,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,GAAG,GACP,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,GAAG,GAAG,KAAK;YAAE,OAAO,CAAC,QAAQ,CAAC;QAClC,KAAK,IAAI,GAAG,CAAC;IACf,CAAC;IAED,4BAA4B;IAC5B,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAC3C,IAAI,MAAM,GAAG,GAAG;YAAE,OAAO,CAAC,QAAQ,CAAC;QACnC,KAAK,IAAI,MAAM,GAAG,GAAG,CAAC;IACxB,CAAC;IAED,qBAAqB;IACrB,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,UAAU,CAAC,EAAE,IAAI,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;YAClE,IAAI,QAAQ,GAAG,GAAG,EAAE,CAAC;gBACnB,KAAK,IAAI,QAAQ,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["/**\n * Face scoring for geometric fallback matching.\n * Modeled on the existing pattern in originTrackingFns.ts.\n */\n\nimport type { GeometricHint } from './shapeRefTypes.js';\nimport type { Face } from '../../core/shapeTypes.js';\nimport { normalAt, faceCenter, faceGeomType } from '../faceFns.js';\nimport { measureArea } from '../../measurement/measureFns.js';\n\n// ---------------------------------------------------------------------------\n// Scorer type\n// ---------------------------------------------------------------------------\n\n/** Scoring function: higher score = better match. Returns -Infinity to reject. */\nexport type FaceScorer = (hint: GeometricHint, face: Face) => number;\n\n// ---------------------------------------------------------------------------\n// Default scorer\n// ---------------------------------------------------------------------------\n\n/**\n * Default face scorer combining surface type, normal alignment, centroid proximity,\n * and area similarity.\n *\n * Scoring breakdown:\n * - Surface type match: +1.0 (mismatch when both defined: -Infinity)\n * - Normal dot product: weighted contribution (rejected if < 0.707)\n * - Centroid distance: quadratic penalty (rejected if distSq > 100)\n * - Area ratio: penalized if |log(hintArea / faceArea)| > 1.0\n */\nexport function defaultScorer(hint: GeometricHint, face: Face): number {\n  let score = 0;\n\n  // Surface type\n  const faceType = faceGeomType(face);\n  if (hint.surfaceType !== undefined) {\n    if (faceType === hint.surfaceType) {\n      score += 1.0;\n    } else {\n      return -Infinity;\n    }\n  }\n\n  // Normal dot product\n  if (hint.normal !== undefined) {\n    const faceNormal = normalAt(face);\n    const dot =\n      hint.normal[0] * faceNormal[0] +\n      hint.normal[1] * faceNormal[1] +\n      hint.normal[2] * faceNormal[2];\n    if (dot < 0.707) return -Infinity;\n    score += dot;\n  }\n\n  // Centroid distance penalty\n  if (hint.centroid !== undefined) {\n    const faceCentroid = faceCenter(face);\n    const dx = hint.centroid[0] - faceCentroid[0];\n    const dy = hint.centroid[1] - faceCentroid[1];\n    const dz = hint.centroid[2] - faceCentroid[2];\n    const distSq = dx * dx + dy * dy + dz * dz;\n    if (distSq > 100) return -Infinity;\n    score -= distSq / 100;\n  }\n\n  // Area ratio penalty\n  if (hint.area !== undefined && hint.area > 0) {\n    const areaResult = measureArea(face);\n    if (areaResult.ok && areaResult.value > 0) {\n      const logRatio = Math.abs(Math.log(hint.area / areaResult.value));\n      if (logRatio > 1.0) {\n        score -= logRatio;\n      }\n    }\n  }\n\n  return score;\n}\n"]}

package/dist/vendored/brepjs/topology/shapeRef/shapeRefFns.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Core ShapeRef functions — capture hints, assign roles, create refs,
+ * update roles through evolution, and resolve refs back to faces.
+ */
+import type { Face, Shape3D } from '../../core/shapeTypes.js';
+import type { ShapeEvolution } from '../../kernel/types.js';
+import type { GeometricHint, ShapeRef, RoleTable, ResolvedRef, BrokenRef } from './shapeRefTypes.js';
+import { type FaceScorer } from './scoring.js';
+/** Snapshot the geometric properties of a face for later matching. */
+export declare function captureHint(face: Face): GeometricHint;
+/**
+ * Auto-assign role names to a shape's faces from its operation type.
+ *
+ * Known primitives get **semantic** names from face geometry — rebuild-stable
+ * across parameter edits that preserve orientation:
+ * - `box`: cardinal names by normal ('box:top'/'bottom'/'front'/'back'/'left'/'right').
+ * - `cylinder`/`cone` (Z-axis): 'top'/'bottom' caps + 'lateral' wall.
+ * - `sphere`: 'sphere:surface'.
+ *
+ * Faces a primitive namer doesn't recognize (a rotated box's non-cardinal faces),
+ * and every face of any other operation type, fall back to positional names
+ * ('opType:face_0', 'opType:face_1', ...) — so each face always gets a role.
+ *
+ * @returns Map from role name to its face hash codes (one at assignment time;
+ *   a role accrues more hashes only later, when `updateRoles` tracks a split).
+ */
+export declare function assignRoles(shape: Shape3D, operationType: string): Map<string, number[]>;
+/** Create a ShapeRef from an origin ID, role name, and face. */
+export declare function createRef(origin: string, role: string, face: Face): ShapeRef;
+/**
+ * Propagate a role table through a ShapeEvolution record.
+ * Returns a new RoleTable with hashes updated according to the evolution.
+ *
+ * - Deleted faces: hash dropped (role removed once all its hashes are gone).
+ * - Modified faces: hash replaced by **all** successor hashes — so a 1→many
+ *   split keeps every fragment, and `resolveRef` disambiguates among them.
+ * - Unchanged faces: hash preserved.
+ *
+ * Note: `evolution.generated` is intentionally not consumed here — on the OCCT
+ * kernels its hashes refer to an intermediate shape, not the final result, so
+ * naming generated faces produces roles that never resolve (verified: 0 live
+ * generated hashes across cut/fuse on occt-wasm). Stable names for generated
+ * geometry (fillet rounds, boolean seams) need history-fidelity work tracked
+ * separately.
+ */
+export declare function updateRoles(roles: RoleTable, origin: string, evolution: ShapeEvolution): RoleTable;
+/**
+ * Resolve a ShapeRef to a face in the current shape.
+ *
+ * Resolution strategy:
+ * 1. Exact: the role's tracked successor hashes. One survivor → exact match;
+ *    several survivors (a face that split) → disambiguate among *only those*
+ *    fragments; none survive → deleted.
+ * 2. Geometric fallback over the whole shape when the role isn't tracked (or a
+ *    scoped score turned up nothing): best-scoring face, else ambiguous /
+ *    not-found.
+ */
+export declare function resolveRef(ref: ShapeRef, roles: RoleTable, currentShape: Shape3D, scorer?: FaceScorer): ResolvedRef | BrokenRef;
+//# sourceMappingURL=shapeRefFns.d.ts.map

package/dist/vendored/brepjs/topology/shapeRef/shapeRefFns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapeRefFns.d.ts","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/topology/shapeRef/shapeRefFns.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAO5D,OAAO,KAAK,EACV,aAAa,EACb,QAAQ,EACR,SAAS,EACT,WAAW,EACX,SAAS,EACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,UAAU,EAAiB,MAAM,cAAc,CAAC;AAM9D,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,CASrD;AAoDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAuBxF;AAMD,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,QAAQ,CAE5E;AAuBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,cAAc,GACxB,SAAS,CAkBX;AAwDD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,OAAO,EACrB,MAAM,CAAC,EAAE,UAAU,GAClB,WAAW,GAAG,SAAS,CA8BzB"}