@faicad/faijs 0.13.0

package/dist/vendored/brepjs/topology/metadata/colorFns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorFns.js","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/topology/metadata/colorFns.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shape-attached colors — assign RGBA colors to whole shapes or individual\n * faces, persisting through boolean operations and modifiers via propagation.\n *\n * Follows the same WeakMap + HashCode pattern as faceTagFns.ts.\n */\n\nimport type { ShapeEvolution } from '../../kernel/types.js';\nimport { getKernel } from '../../kernel/index.js';\nimport type { AnyShape, Dimension, Face } from '../../core/shapeTypes.js';\nimport { HASH_CODE_MAX } from '../../core/constants.js';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** RGBA color as 0-1 floats. */\nexport type Color = [number, number, number, number];\n\n/** Accepted color inputs: hex string, RGB tuple, or RGBA tuple. */\nexport type ColorInput = string | [number, number, number] | [number, number, number, number];\n\n// ---------------------------------------------------------------------------\n// Internal storage\n// ---------------------------------------------------------------------------\n\n// Whole-shape color, keyed on shape.wrapped identity\nconst shapeColorStore = new WeakMap<object, Color>();\n\n// Per-face colors: shape.wrapped → face hash → color\nconst faceColorStore = new WeakMap<object, Map<number, Color>>();\n\n/** O(1) check whether a shape has any color metadata (shape or face level). */\nexport function hasColorMetadata(shape: AnyShape<Dimension>): boolean {\n  return shapeColorStore.has(shape.wrapped) || faceColorStore.has(shape.wrapped);\n}\n\nfunction getFaceColorMap(shape: AnyShape<Dimension>): Map<number, Color> {\n  let map = faceColorStore.get(shape.wrapped);\n  if (!map) {\n    map = new Map();\n    faceColorStore.set(shape.wrapped, map);\n  }\n  return map;\n}\n\n// ---------------------------------------------------------------------------\n// Color parsing\n// ---------------------------------------------------------------------------\n\n/** Parse any accepted color input into canonical RGBA (exported so content-\n *  addressed consumers can canonicalize before hashing). */\nexport function parseColor(input: ColorInput): Color {\n  if (typeof input === 'string') {\n    let hex = input.startsWith('#') ? input.slice(1) : input;\n    if (hex.length === 3) {\n      hex =\n        hex.charAt(0) +\n        hex.charAt(0) +\n        hex.charAt(1) +\n        hex.charAt(1) +\n        hex.charAt(2) +\n        hex.charAt(2);\n    }\n    const r = parseInt(hex.slice(0, 2), 16) / 255;\n    const g = parseInt(hex.slice(2, 4), 16) / 255;\n    const b = parseInt(hex.slice(4, 6), 16) / 255;\n    return [r, g, b, 1];\n  }\n  if (input.length === 3) {\n    return [input[0], input[1], input[2], 1];\n  }\n  return [input[0], input[1], input[2], input[3]];\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Set a whole-shape color (stored externally via WeakMap).\n * Returns the same shape reference.\n */\nexport function colorShape<T extends AnyShape<Dimension>>(shape: T, color: ColorInput): T {\n  shapeColorStore.set(shape.wrapped, parseColor(color));\n  return shape;\n}\n\n/**\n * Set per-face colors on a shape.\n * Returns the same shape reference.\n */\nexport function colorFaces<T extends AnyShape<Dimension>>(\n  shape: T,\n  faces: Face<Dimension>[],\n  color: ColorInput\n): T {\n  const parsed = parseColor(color);\n  const map = getFaceColorMap(shape);\n  for (const face of faces) {\n    map.set(getKernel().hashCode(face.wrapped, HASH_CODE_MAX), parsed);\n  }\n  return shape;\n}\n\n/**\n * Get the whole-shape color, or undefined if none set.\n */\nexport function getShapeColor(shape: AnyShape<Dimension>): Color | undefined {\n  return shapeColorStore.get(shape.wrapped);\n}\n\n/**\n * Get the color of a specific face, or undefined if none set.\n */\nexport function getFaceColor(shape: AnyShape<Dimension>, face: Face<Dimension>): Color | undefined {\n  const map = faceColorStore.get(shape.wrapped);\n  if (!map) return undefined;\n  return map.get(getKernel().hashCode(face.wrapped, HASH_CODE_MAX));\n}\n\n/**\n * Propagate colors from input shapes to a result shape using a\n * kernel-provided ShapeEvolution record (no direct kernel op access needed).\n */\nexport function propagateColorsFromEvolution(\n  evolution: ShapeEvolution,\n  inputs: readonly AnyShape<Dimension>[],\n  result: AnyShape<Dimension>\n): void {\n  // Propagate whole-shape colors: first input with a color wins\n  for (const input of inputs) {\n    const c = shapeColorStore.get(input.wrapped);\n    if (c) {\n      shapeColorStore.set(result.wrapped, c);\n      break;\n    }\n  }\n\n  // Propagate per-face colors\n  const resultFaceMap = getFaceColorMap(result);\n\n  for (const input of inputs) {\n    const inputFaceMap = faceColorStore.get(input.wrapped);\n    if (!inputFaceMap || inputFaceMap.size === 0) continue;\n\n    for (const [hash, color] of inputFaceMap) {\n      if (evolution.deleted.has(hash)) continue;\n\n      const modifiedHashes = evolution.modified.get(hash);\n      if (modifiedHashes && modifiedHashes.length > 0) {\n        for (const modHash of modifiedHashes) {\n          resultFaceMap.set(modHash, color);\n        }\n      } else {\n        // Face survived unmodified\n        resultFaceMap.set(hash, color);\n      }\n    }\n  }\n}\n"]}

package/dist/vendored/brepjs/topology/metadata/faceTagFns.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Face naming and metadata — tag faces with string names that persist
+ * through boolean operations and modifiers.
+ *
+ * Built on the existing face hash / origin propagation system in shapeFns.ts.
+ */
+import type { ShapeEvolution } from '../../kernel/types.js';
+import type { AnyShape, Dimension, Face } from '../../core/shapeTypes.js';
+/** O(1) check whether a shape has any face tags attached. */
+export declare function hasFaceTags(shape: AnyShape<Dimension>): boolean;
+/**
+ * Tag selected faces with a string name.
+ *
+ * @param shape - The shape containing the faces.
+ * @param selector - Array of faces, or a predicate function.
+ * @param tag - The tag name to assign.
+ * @returns The same shape (tags are stored externally).
+ */
+export declare function tagFaces(shape: AnyShape<Dimension>, selector: Face<Dimension>[] | ((face: Face<Dimension>) => boolean), tag: string): AnyShape<Dimension>;
+/**
+ * Find all faces on a shape that have the given tag.
+ *
+ * Checks both direct tags and propagated origins (for faces that
+ * survived boolean/modifier operations).
+ */
+export declare function findFacesByTag(shape: AnyShape<Dimension>, tag: string): Face<Dimension>[];
+/**
+ * Get all tags and their associated faces on a shape.
+ */
+export declare function getFaceTags(shape: AnyShape<Dimension>): Map<string, Face<Dimension>[]>;
+/**
+ * Store arbitrary metadata for a tag on a shape.
+ */
+export declare function setTagMetadata(shape: AnyShape<Dimension>, tag: string, metadata: Record<string, unknown>): AnyShape<Dimension>;
+/**
+ * Retrieve metadata for a tag on a shape.
+ */
+export declare function getTagMetadata(shape: AnyShape<Dimension>, tag: string): Record<string, unknown> | undefined;
+/**
+ * Propagate face tags from input shapes to a result shape using a
+ * kernel-provided ShapeEvolution record (no direct kernel op access needed).
+ */
+export declare function propagateFaceTagsFromEvolution(evolution: ShapeEvolution, inputs: readonly AnyShape<Dimension>[], result: AnyShape<Dimension>): void;
+//# sourceMappingURL=faceTagFns.d.ts.map

package/dist/vendored/brepjs/topology/metadata/faceTagFns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faceTagFns.d.ts","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/topology/metadata/faceTagFns.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAc1E,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,OAAO,CAE/D;AAwBD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC1B,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,EAClE,GAAG,EAAE,MAAM,GACV,QAAQ,CAAC,SAAS,CAAC,CAYrB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAezF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAuBtF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC1B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,QAAQ,CAAC,SAAS,CAAC,CAIrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC1B,GAAG,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAErC;AAQD;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,SAAS,QAAQ,CAAC,SAAS,CAAC,EAAE,EACtC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,GAC1B,IAAI,CAyCN"}

package/dist/vendored/brepjs/topology/metadata/faceTagFns.js

@@ -0,0 +1,168 @@
+/**
+ * Face naming and metadata — tag faces with string names that persist
+ * through boolean operations and modifiers.
+ *
+ * Built on the existing face hash / origin propagation system in shapeFns.ts.
+ */
+import { getKernel } from '../../kernel/index.js';
+import { HASH_CODE_MAX } from '../../core/constants.js';
+import { getFaces } from '../shapeFns.js';
+// ---------------------------------------------------------------------------
+// Internal storage
+// ---------------------------------------------------------------------------
+// Maps shape (by identity) → tag name → set of face hashes
+const shapeTagStore = new WeakMap();
+// Maps shape (by identity) → tag name → metadata
+const tagMetadataStore = new WeakMap();
+/** O(1) check whether a shape has any face tags attached. */
+export function hasFaceTags(shape) {
+    return shapeTagStore.has(shape.wrapped);
+}
+function getTagMap(shape) {
+    let map = shapeTagStore.get(shape.wrapped);
+    if (!map) {
+        map = new Map();
+        shapeTagStore.set(shape.wrapped, map);
+    }
+    return map;
+}
+function getMetaMap(shape) {
+    let map = tagMetadataStore.get(shape.wrapped);
+    if (!map) {
+        map = new Map();
+        tagMetadataStore.set(shape.wrapped, map);
+    }
+    return map;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Tag selected faces with a string name.
+ *
+ * @param shape - The shape containing the faces.
+ * @param selector - Array of faces, or a predicate function.
+ * @param tag - The tag name to assign.
+ * @returns The same shape (tags are stored externally).
+ */
+export function tagFaces(shape, selector, tag) {
+    const faces = Array.isArray(selector) ? selector : getFaces(shape).filter(selector);
+    const tagMap = getTagMap(shape);
+    const existing = tagMap.get(tag) ?? new Set();
+    for (const face of faces) {
+        existing.add(getKernel().hashCode(face.wrapped, HASH_CODE_MAX));
+    }
+    tagMap.set(tag, existing);
+    return shape;
+}
+/**
+ * Find all faces on a shape that have the given tag.
+ *
+ * Checks both direct tags and propagated origins (for faces that
+ * survived boolean/modifier operations).
+ */
+export function findFacesByTag(shape, tag) {
+    const tagMap = shapeTagStore.get(shape.wrapped);
+    if (!tagMap)
+        return [];
+    const hashes = tagMap.get(tag);
+    if (!hashes || hashes.size === 0)
+        return [];
+    const result = [];
+    for (const face of getFaces(shape)) {
+        const hash = getKernel().hashCode(face.wrapped, HASH_CODE_MAX);
+        if (hashes.has(hash)) {
+            result.push(face);
+        }
+    }
+    return result;
+}
+/**
+ * Get all tags and their associated faces on a shape.
+ */
+export function getFaceTags(shape) {
+    const result = new Map();
+    const tagMap = shapeTagStore.get(shape.wrapped);
+    if (!tagMap)
+        return result;
+    const faces = getFaces(shape);
+    const faceByHash = new Map();
+    for (const face of faces) {
+        faceByHash.set(getKernel().hashCode(face.wrapped, HASH_CODE_MAX), face);
+    }
+    for (const [tag, hashes] of tagMap) {
+        const taggedFaces = [];
+        for (const hash of hashes) {
+            const face = faceByHash.get(hash);
+            if (face)
+                taggedFaces.push(face);
+        }
+        if (taggedFaces.length > 0) {
+            result.set(tag, taggedFaces);
+        }
+    }
+    return result;
+}
+/**
+ * Store arbitrary metadata for a tag on a shape.
+ */
+export function setTagMetadata(shape, tag, metadata) {
+    const metaMap = getMetaMap(shape);
+    metaMap.set(tag, metadata);
+    return shape;
+}
+/**
+ * Retrieve metadata for a tag on a shape.
+ */
+export function getTagMetadata(shape, tag) {
+    return tagMetadataStore.get(shape.wrapped)?.get(tag);
+}
+function addTagToResult(resultTagMap, tag, hash) {
+    const set = resultTagMap.get(tag) ?? new Set();
+    set.add(hash);
+    resultTagMap.set(tag, set);
+}
+/**
+ * Propagate face tags from input shapes to a result shape using a
+ * kernel-provided ShapeEvolution record (no direct kernel op access needed).
+ */
+export function propagateFaceTagsFromEvolution(evolution, inputs, result) {
+    const resultTagMap = getTagMap(result);
+    for (const input of inputs) {
+        const inputTagMap = shapeTagStore.get(input.wrapped);
+        if (!inputTagMap)
+            continue;
+        // Build hash→tags lookup for this input
+        const hashToTags = new Map();
+        for (const [tag, hashes] of inputTagMap) {
+            for (const hash of hashes) {
+                const tags = hashToTags.get(hash) ?? [];
+                tags.push(tag);
+                hashToTags.set(hash, tags);
+            }
+        }
+        // For each tagged face hash, use the evolution to find result hashes
+        for (const [hash, tags] of hashToTags) {
+            if (evolution.deleted.has(hash))
+                continue;
+            const modifiedHashes = evolution.modified.get(hash);
+            const targetHashes = modifiedHashes && modifiedHashes.length > 0 ? modifiedHashes : [hash];
+            for (const targetHash of targetHashes) {
+                for (const tag of tags) {
+                    addTagToResult(resultTagMap, tag, targetHash);
+                }
+            }
+        }
+        // Copy metadata
+        const inputMetaMap = tagMetadataStore.get(input.wrapped);
+        if (inputMetaMap) {
+            const resultMetaMap = getMetaMap(result);
+            for (const [tag, meta] of inputMetaMap) {
+                if (!resultMetaMap.has(tag)) {
+                    resultMetaMap.set(tag, meta);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=faceTagFns.js.map

package/dist/vendored/brepjs/topology/metadata/faceTagFns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faceTagFns.js","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/topology/metadata/faceTagFns.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Face naming and metadata — tag faces with string names that persist\n * through boolean operations and modifiers.\n *\n * Built on the existing face hash / origin propagation system in shapeFns.ts.\n */\n\nimport type { ShapeEvolution } from '../../kernel/types.js';\nimport { getKernel } from '../../kernel/index.js';\nimport type { AnyShape, Dimension, Face } from '../../core/shapeTypes.js';\nimport { HASH_CODE_MAX } from '../../core/constants.js';\nimport { getFaces } from '../shapeFns.js';\n\n// ---------------------------------------------------------------------------\n// Internal storage\n// ---------------------------------------------------------------------------\n\n// Maps shape (by identity) → tag name → set of face hashes\nconst shapeTagStore = new WeakMap<object, Map<string, Set<number>>>();\n\n// Maps shape (by identity) → tag name → metadata\nconst tagMetadataStore = new WeakMap<object, Map<string, Record<string, unknown>>>();\n\n/** O(1) check whether a shape has any face tags attached. */\nexport function hasFaceTags(shape: AnyShape<Dimension>): boolean {\n  return shapeTagStore.has(shape.wrapped);\n}\n\nfunction getTagMap(shape: AnyShape<Dimension>): Map<string, Set<number>> {\n  let map = shapeTagStore.get(shape.wrapped);\n  if (!map) {\n    map = new Map();\n    shapeTagStore.set(shape.wrapped, map);\n  }\n  return map;\n}\n\nfunction getMetaMap(shape: AnyShape<Dimension>): Map<string, Record<string, unknown>> {\n  let map = tagMetadataStore.get(shape.wrapped);\n  if (!map) {\n    map = new Map();\n    tagMetadataStore.set(shape.wrapped, map);\n  }\n  return map;\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Tag selected faces with a string name.\n *\n * @param shape - The shape containing the faces.\n * @param selector - Array of faces, or a predicate function.\n * @param tag - The tag name to assign.\n * @returns The same shape (tags are stored externally).\n */\nexport function tagFaces(\n  shape: AnyShape<Dimension>,\n  selector: Face<Dimension>[] | ((face: Face<Dimension>) => boolean),\n  tag: string\n): AnyShape<Dimension> {\n  const faces = Array.isArray(selector) ? selector : getFaces(shape).filter(selector);\n\n  const tagMap = getTagMap(shape);\n  const existing = tagMap.get(tag) ?? new Set<number>();\n\n  for (const face of faces) {\n    existing.add(getKernel().hashCode(face.wrapped, HASH_CODE_MAX));\n  }\n\n  tagMap.set(tag, existing);\n  return shape;\n}\n\n/**\n * Find all faces on a shape that have the given tag.\n *\n * Checks both direct tags and propagated origins (for faces that\n * survived boolean/modifier operations).\n */\nexport function findFacesByTag(shape: AnyShape<Dimension>, tag: string): Face<Dimension>[] {\n  const tagMap = shapeTagStore.get(shape.wrapped);\n  if (!tagMap) return [];\n\n  const hashes = tagMap.get(tag);\n  if (!hashes || hashes.size === 0) return [];\n\n  const result: Face<Dimension>[] = [];\n  for (const face of getFaces(shape)) {\n    const hash = getKernel().hashCode(face.wrapped, HASH_CODE_MAX);\n    if (hashes.has(hash)) {\n      result.push(face);\n    }\n  }\n  return result;\n}\n\n/**\n * Get all tags and their associated faces on a shape.\n */\nexport function getFaceTags(shape: AnyShape<Dimension>): Map<string, Face<Dimension>[]> {\n  const result = new Map<string, Face<Dimension>[]>();\n  const tagMap = shapeTagStore.get(shape.wrapped);\n  if (!tagMap) return result;\n\n  const faces = getFaces(shape);\n  const faceByHash = new Map<number, Face<Dimension>>();\n  for (const face of faces) {\n    faceByHash.set(getKernel().hashCode(face.wrapped, HASH_CODE_MAX), face);\n  }\n\n  for (const [tag, hashes] of tagMap) {\n    const taggedFaces: Face<Dimension>[] = [];\n    for (const hash of hashes) {\n      const face = faceByHash.get(hash);\n      if (face) taggedFaces.push(face);\n    }\n    if (taggedFaces.length > 0) {\n      result.set(tag, taggedFaces);\n    }\n  }\n\n  return result;\n}\n\n/**\n * Store arbitrary metadata for a tag on a shape.\n */\nexport function setTagMetadata(\n  shape: AnyShape<Dimension>,\n  tag: string,\n  metadata: Record<string, unknown>\n): AnyShape<Dimension> {\n  const metaMap = getMetaMap(shape);\n  metaMap.set(tag, metadata);\n  return shape;\n}\n\n/**\n * Retrieve metadata for a tag on a shape.\n */\nexport function getTagMetadata(\n  shape: AnyShape<Dimension>,\n  tag: string\n): Record<string, unknown> | undefined {\n  return tagMetadataStore.get(shape.wrapped)?.get(tag);\n}\n\nfunction addTagToResult(resultTagMap: Map<string, Set<number>>, tag: string, hash: number): void {\n  const set = resultTagMap.get(tag) ?? new Set<number>();\n  set.add(hash);\n  resultTagMap.set(tag, set);\n}\n\n/**\n * Propagate face tags from input shapes to a result shape using a\n * kernel-provided ShapeEvolution record (no direct kernel op access needed).\n */\nexport function propagateFaceTagsFromEvolution(\n  evolution: ShapeEvolution,\n  inputs: readonly AnyShape<Dimension>[],\n  result: AnyShape<Dimension>\n): void {\n  const resultTagMap = getTagMap(result);\n\n  for (const input of inputs) {\n    const inputTagMap = shapeTagStore.get(input.wrapped);\n    if (!inputTagMap) continue;\n\n    // Build hash→tags lookup for this input\n    const hashToTags = new Map<number, string[]>();\n    for (const [tag, hashes] of inputTagMap) {\n      for (const hash of hashes) {\n        const tags = hashToTags.get(hash) ?? [];\n        tags.push(tag);\n        hashToTags.set(hash, tags);\n      }\n    }\n\n    // For each tagged face hash, use the evolution to find result hashes\n    for (const [hash, tags] of hashToTags) {\n      if (evolution.deleted.has(hash)) continue;\n\n      const modifiedHashes = evolution.modified.get(hash);\n      const targetHashes = modifiedHashes && modifiedHashes.length > 0 ? modifiedHashes : [hash];\n      for (const targetHash of targetHashes) {\n        for (const tag of tags) {\n          addTagToResult(resultTagMap, tag, targetHash);\n        }\n      }\n    }\n\n    // Copy metadata\n    const inputMetaMap = tagMetadataStore.get(input.wrapped);\n    if (inputMetaMap) {\n      const resultMetaMap = getMetaMap(result);\n      for (const [tag, meta] of inputMetaMap) {\n        if (!resultMetaMap.has(tag)) {\n          resultMetaMap.set(tag, meta);\n        }\n      }\n    }\n  }\n}\n"]}

package/dist/vendored/brepjs/topology/metadata/metadataPropagation.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Centralized metadata propagation pipeline for kernel operations.
+ *
+ * All kernel operations that produce new shapes from inputs need to propagate
+ * three kinds of metadata: face origins, face tags, and face colors. This
+ * module provides the shared plumbing so that booleanFns, modifierFns, and
+ * transform functions don't duplicate the same ~20-line block.
+ */
+import type { ShapeEvolution } from '../../kernel/types.js';
+import type { AnyShape, Dimension } from '../../core/shapeTypes.js';
+/**
+ * Collect ALL face hashes from input shapes for WithHistory kernel methods.
+ *
+ * Fast-path: returns empty array when no inputs have any metadata (origins,
+ * tags, or colors), avoiding expensive WASM topology exploration.
+ */
+/**
+ * O(1) check: does a shape carry any propagatable metadata (face origins,
+ * tags, or colors)? Lets callers skip both expensive face iteration and
+ * metadata-preserving slow paths when there's nothing to preserve.
+ */
+export declare function hasAnyMetadata(shape: AnyShape<Dimension>): boolean;
+export declare function collectInputFaceHashes(inputs: readonly AnyShape<Dimension>[]): number[];
+/**
+ * Propagate all metadata (origins, tags, colors) from inputs to result
+ * using a kernel-provided ShapeEvolution record.
+ *
+ * This is the standard pipeline for any operation that returns
+ * `{ shape, evolution }` from a WithHistory kernel method.
+ */
+export declare function propagateAllMetadata(evolution: ShapeEvolution, inputs: readonly AnyShape<Dimension>[], result: AnyShape<Dimension>): void;
+/**
+ * Fallback metadata propagation when no ShapeEvolution is available.
+ *
+ * Matches result faces to input faces by hash code (and geometric fallback).
+ * Used by operations that don't support WithHistory (e.g., native fuseAll).
+ *
+ * **Limitation:** Only propagates face origins. Face tags and face colors
+ * require a ShapeEvolution record to map input→output face hashes, so they
+ * are lost through this path. Batch booleans (`fuseAll`, `cutAll`) therefore
+ * have weaker metadata guarantees than pairwise booleans (`fuse`, `cut`).
+ */
+export declare function propagateMetadataByHash(inputs: readonly AnyShape<Dimension>[], result: AnyShape<Dimension>): void;
+/**
+ * Propagate all metadata through a *rigid relocation* (a `locate` re-tag).
+ *
+ * A relocated shape shares the source's TShape, so its faces correspond 1:1 to
+ * the source faces in iteration order — but carry new, location-dependent
+ * hashes, so the hash-keyed metadata must be re-keyed rather than left as-is.
+ * This synthesizes a 1:1 `modified` evolution (source face hash → moved face
+ * hash) and runs the standard propagation pipeline, so origins, tags, and
+ * colors all survive a move at `locate` cost (O(faces)), not a full copy.
+ *
+ * Callers should gate on {@link hasAnyMetadata} first: with no metadata this
+ * does pointless face iteration. The face counts always match for a rigid
+ * relocation; the length guard is purely defensive.
+ */
+export declare function propagateMetadataThroughRelocation(source: AnyShape<Dimension>, moved: AnyShape<Dimension>): void;
+//# sourceMappingURL=metadataPropagation.d.ts.map

package/dist/vendored/brepjs/topology/metadata/metadataPropagation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadataPropagation.d.ts","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/topology/metadata/metadataPropagation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAepE;;;;;GAKG;AACH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,OAAO,CAElE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAAQ,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,CAWvF;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,SAAS,QAAQ,CAAC,SAAS,CAAC,EAAE,EACtC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,GAC1B,IAAI,CAIN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,QAAQ,CAAC,SAAS,CAAC,EAAE,EACtC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,GAC1B,IAAI,CAEN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC3B,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,GACzB,IAAI,CAiBN"}

package/dist/vendored/brepjs/topology/metadata/metadataPropagation.js

@@ -0,0 +1,109 @@
+/**
+ * Centralized metadata propagation pipeline for kernel operations.
+ *
+ * All kernel operations that produce new shapes from inputs need to propagate
+ * three kinds of metadata: face origins, face tags, and face colors. This
+ * module provides the shared plumbing so that booleanFns, modifierFns, and
+ * transform functions don't duplicate the same ~20-line block.
+ */
+import { getKernel } from '../../kernel/index.js';
+import { HASH_CODE_MAX } from '../../core/constants.js';
+import { getFaceOrigins, propagateOriginsFromEvolution, propagateOriginsByHash, } from './originTrackingFns.js';
+import { propagateFaceTagsFromEvolution, hasFaceTags } from './faceTagFns.js';
+import { propagateColorsFromEvolution, hasColorMetadata } from './colorFns.js';
+import { subShapeHashes } from '../topologyQueryFns.js';
+// ---------------------------------------------------------------------------
+// Face hash collection
+// ---------------------------------------------------------------------------
+/**
+ * Collect ALL face hashes from input shapes for WithHistory kernel methods.
+ *
+ * Fast-path: returns empty array when no inputs have any metadata (origins,
+ * tags, or colors), avoiding expensive WASM topology exploration.
+ */
+/**
+ * O(1) check: does a shape carry any propagatable metadata (face origins,
+ * tags, or colors)? Lets callers skip both expensive face iteration and
+ * metadata-preserving slow paths when there's nothing to preserve.
+ */
+export function hasAnyMetadata(shape) {
+    return getFaceOrigins(shape) !== undefined || hasFaceTags(shape) || hasColorMetadata(shape);
+}
+export function collectInputFaceHashes(inputs) {
+    // O(1) check: skip expensive face iteration when no metadata exists
+    if (!inputs.some(hasAnyMetadata))
+        return [];
+    // Only the face hashes are needed (a membership set for metadata matching), so
+    // use subShapeHashes — the native occt-wasm 3.7.0 path reads them without
+    // allocating a handle per face, avoiding per-face arena churn on every
+    // WithHistory boolean/transform/modifier.
+    const hashes = [];
+    for (const input of inputs)
+        hashes.push(...subShapeHashes(input, 'face'));
+    return hashes;
+}
+// ---------------------------------------------------------------------------
+// Full propagation pipeline
+// ---------------------------------------------------------------------------
+/**
+ * Propagate all metadata (origins, tags, colors) from inputs to result
+ * using a kernel-provided ShapeEvolution record.
+ *
+ * This is the standard pipeline for any operation that returns
+ * `{ shape, evolution }` from a WithHistory kernel method.
+ */
+export function propagateAllMetadata(evolution, inputs, result) {
+    propagateOriginsFromEvolution(evolution, inputs, result);
+    propagateFaceTagsFromEvolution(evolution, inputs, result);
+    propagateColorsFromEvolution(evolution, inputs, result);
+}
+/**
+ * Fallback metadata propagation when no ShapeEvolution is available.
+ *
+ * Matches result faces to input faces by hash code (and geometric fallback).
+ * Used by operations that don't support WithHistory (e.g., native fuseAll).
+ *
+ * **Limitation:** Only propagates face origins. Face tags and face colors
+ * require a ShapeEvolution record to map input→output face hashes, so they
+ * are lost through this path. Batch booleans (`fuseAll`, `cutAll`) therefore
+ * have weaker metadata guarantees than pairwise booleans (`fuse`, `cut`).
+ */
+export function propagateMetadataByHash(inputs, result) {
+    propagateOriginsByHash(inputs, result);
+}
+/**
+ * Propagate all metadata through a *rigid relocation* (a `locate` re-tag).
+ *
+ * A relocated shape shares the source's TShape, so its faces correspond 1:1 to
+ * the source faces in iteration order — but carry new, location-dependent
+ * hashes, so the hash-keyed metadata must be re-keyed rather than left as-is.
+ * This synthesizes a 1:1 `modified` evolution (source face hash → moved face
+ * hash) and runs the standard propagation pipeline, so origins, tags, and
+ * colors all survive a move at `locate` cost (O(faces)), not a full copy.
+ *
+ * Callers should gate on {@link hasAnyMetadata} first: with no metadata this
+ * does pointless face iteration. The face counts always match for a rigid
+ * relocation; the length guard is purely defensive.
+ */
+export function propagateMetadataThroughRelocation(source, moved) {
+    const kernel = getKernel();
+    const srcFaces = [...kernel.iterShapes(source.wrapped, 'face')];
+    const movedFaces = [...kernel.iterShapes(moved.wrapped, 'face')];
+    if (srcFaces.length !== movedFaces.length)
+        return;
+    const modified = new Map();
+    for (let i = 0; i < srcFaces.length; i++) {
+        const sf = srcFaces[i];
+        const mf = movedFaces[i];
+        if (sf === undefined || mf === undefined)
+            continue;
+        modified.set(kernel.hashCode(sf, HASH_CODE_MAX), [kernel.hashCode(mf, HASH_CODE_MAX)]);
+    }
+    // Only the hashes are needed; release the transient face handles.
+    for (const f of srcFaces)
+        kernel.dispose(f);
+    for (const f of movedFaces)
+        kernel.dispose(f);
+    propagateAllMetadata({ modified, generated: new Map(), deleted: new Set() }, [source], moved);
+}
+//# sourceMappingURL=metadataPropagation.js.map

package/dist/vendored/brepjs/topology/metadata/metadataPropagation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadataPropagation.js","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/topology/metadata/metadataPropagation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EACL,cAAc,EACd,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,8BAA8B,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;;GAKG;AACH;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,OAAO,cAAc,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAsC;IAC3E,oEAAoE;IACpE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC;QAAE,OAAO,EAAE,CAAC;IAE5C,+EAA+E;IAC/E,0EAA0E;IAC1E,uEAAuE;IACvE,0CAA0C;IAC1C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAAyB,EACzB,MAAsC,EACtC,MAA2B;IAE3B,6BAA6B,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,8BAA8B,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1D,4BAA4B,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAsC,EACtC,MAA2B;IAE3B,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kCAAkC,CAChD,MAA2B,EAC3B,KAA0B;IAE1B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACjE,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM;QAAE,OAAO;IAElD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS;YAAE,SAAS;QACnD,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACzF,CAAC;IACD,kEAAkE;IAClE,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,UAAU;QAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9C,oBAAoB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;AAChG,CAAC","sourcesContent":["/**\n * Centralized metadata propagation pipeline for kernel operations.\n *\n * All kernel operations that produce new shapes from inputs need to propagate\n * three kinds of metadata: face origins, face tags, and face colors. This\n * module provides the shared plumbing so that booleanFns, modifierFns, and\n * transform functions don't duplicate the same ~20-line block.\n */\n\nimport type { ShapeEvolution } from '../../kernel/types.js';\nimport { getKernel } from '../../kernel/index.js';\nimport type { AnyShape, Dimension } from '../../core/shapeTypes.js';\nimport { HASH_CODE_MAX } from '../../core/constants.js';\nimport {\n  getFaceOrigins,\n  propagateOriginsFromEvolution,\n  propagateOriginsByHash,\n} from './originTrackingFns.js';\nimport { propagateFaceTagsFromEvolution, hasFaceTags } from './faceTagFns.js';\nimport { propagateColorsFromEvolution, hasColorMetadata } from './colorFns.js';\nimport { subShapeHashes } from '../topologyQueryFns.js';\n\n// ---------------------------------------------------------------------------\n// Face hash collection\n// ---------------------------------------------------------------------------\n\n/**\n * Collect ALL face hashes from input shapes for WithHistory kernel methods.\n *\n * Fast-path: returns empty array when no inputs have any metadata (origins,\n * tags, or colors), avoiding expensive WASM topology exploration.\n */\n/**\n * O(1) check: does a shape carry any propagatable metadata (face origins,\n * tags, or colors)? Lets callers skip both expensive face iteration and\n * metadata-preserving slow paths when there's nothing to preserve.\n */\nexport function hasAnyMetadata(shape: AnyShape<Dimension>): boolean {\n  return getFaceOrigins(shape) !== undefined || hasFaceTags(shape) || hasColorMetadata(shape);\n}\n\nexport function collectInputFaceHashes(inputs: readonly AnyShape<Dimension>[]): number[] {\n  // O(1) check: skip expensive face iteration when no metadata exists\n  if (!inputs.some(hasAnyMetadata)) return [];\n\n  // Only the face hashes are needed (a membership set for metadata matching), so\n  // use subShapeHashes — the native occt-wasm 3.7.0 path reads them without\n  // allocating a handle per face, avoiding per-face arena churn on every\n  // WithHistory boolean/transform/modifier.\n  const hashes: number[] = [];\n  for (const input of inputs) hashes.push(...subShapeHashes(input, 'face'));\n  return hashes;\n}\n\n// ---------------------------------------------------------------------------\n// Full propagation pipeline\n// ---------------------------------------------------------------------------\n\n/**\n * Propagate all metadata (origins, tags, colors) from inputs to result\n * using a kernel-provided ShapeEvolution record.\n *\n * This is the standard pipeline for any operation that returns\n * `{ shape, evolution }` from a WithHistory kernel method.\n */\nexport function propagateAllMetadata(\n  evolution: ShapeEvolution,\n  inputs: readonly AnyShape<Dimension>[],\n  result: AnyShape<Dimension>\n): void {\n  propagateOriginsFromEvolution(evolution, inputs, result);\n  propagateFaceTagsFromEvolution(evolution, inputs, result);\n  propagateColorsFromEvolution(evolution, inputs, result);\n}\n\n/**\n * Fallback metadata propagation when no ShapeEvolution is available.\n *\n * Matches result faces to input faces by hash code (and geometric fallback).\n * Used by operations that don't support WithHistory (e.g., native fuseAll).\n *\n * **Limitation:** Only propagates face origins. Face tags and face colors\n * require a ShapeEvolution record to map input→output face hashes, so they\n * are lost through this path. Batch booleans (`fuseAll`, `cutAll`) therefore\n * have weaker metadata guarantees than pairwise booleans (`fuse`, `cut`).\n */\nexport function propagateMetadataByHash(\n  inputs: readonly AnyShape<Dimension>[],\n  result: AnyShape<Dimension>\n): void {\n  propagateOriginsByHash(inputs, result);\n}\n\n/**\n * Propagate all metadata through a *rigid relocation* (a `locate` re-tag).\n *\n * A relocated shape shares the source's TShape, so its faces correspond 1:1 to\n * the source faces in iteration order — but carry new, location-dependent\n * hashes, so the hash-keyed metadata must be re-keyed rather than left as-is.\n * This synthesizes a 1:1 `modified` evolution (source face hash → moved face\n * hash) and runs the standard propagation pipeline, so origins, tags, and\n * colors all survive a move at `locate` cost (O(faces)), not a full copy.\n *\n * Callers should gate on {@link hasAnyMetadata} first: with no metadata this\n * does pointless face iteration. The face counts always match for a rigid\n * relocation; the length guard is purely defensive.\n */\nexport function propagateMetadataThroughRelocation(\n  source: AnyShape<Dimension>,\n  moved: AnyShape<Dimension>\n): void {\n  const kernel = getKernel();\n  const srcFaces = [...kernel.iterShapes(source.wrapped, 'face')];\n  const movedFaces = [...kernel.iterShapes(moved.wrapped, 'face')];\n  if (srcFaces.length !== movedFaces.length) return;\n\n  const modified = new Map<number, number[]>();\n  for (let i = 0; i < srcFaces.length; i++) {\n    const sf = srcFaces[i];\n    const mf = movedFaces[i];\n    if (sf === undefined || mf === undefined) continue;\n    modified.set(kernel.hashCode(sf, HASH_CODE_MAX), [kernel.hashCode(mf, HASH_CODE_MAX)]);\n  }\n  // Only the hashes are needed; release the transient face handles.\n  for (const f of srcFaces) kernel.dispose(f);\n  for (const f of movedFaces) kernel.dispose(f);\n  propagateAllMetadata({ modified, generated: new Map(), deleted: new Set() }, [source], moved);\n}\n"]}

package/dist/vendored/brepjs/topology/metadata/originTrackingFns.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Face origin tracking — tag faces with integer origins and propagate
+ * them through kernel operations via ShapeEvolution records.
+ */
+import type { ShapeEvolution } from '../../kernel/types.js';
+import type { AnyShape, Dimension } from '../../core/shapeTypes.js';
+/**
+ * Tag all faces of a shape with an opaque integer origin.
+ * Consumers assign meaning (e.g., source line number).
+ */
+export declare function setShapeOrigin(shape: AnyShape<Dimension>, origin: number): void;
+/**
+ * Get the face origin map for a shape (faceHash → originTag).
+ * Returns undefined if no origins have been set or propagated.
+ */
+export declare function getFaceOrigins(shape: AnyShape<Dimension>): Map<number, number> | undefined;
+/**
+ * Propagate face origins using a kernel-provided ShapeEvolution record.
+ */
+export declare function propagateOriginsFromEvolution(evolution: ShapeEvolution, inputs: readonly AnyShape<Dimension>[], result: AnyShape<Dimension>): void;
+/**
+ * Fallback origin propagation when no kernel op object is available
+ * (native `fuseAll` / `cutAll`, which expose no ShapeEvolution record).
+ *
+ * Matches result faces to input faces by hash code first. Faces that pass
+ * through the boolean unchanged keep their hash and recover their origin
+ * directly. Faces the boolean *regenerates* (split, merged, or re-created at
+ * the intersection) get a fresh hash that matches no input — these fall back
+ * to geometric matching (normal + centroid) against the input face
+ * signatures.
+ *
+ * The geometric pass runs for every unmatched face, not only when the hash
+ * pass found nothing. A partial hash match is the common case for additive
+ * features (pass-through side walls match by hash; the surfaces where the
+ * tool meets the body — feature tops, flush walls — are regenerated and need
+ * the geometric pass). Gating the fallback on "zero hash matches" left those
+ * regenerated faces with no origin, so they fell back to 0 (body) at mesh
+ * time — the multi-color export bug where a scoop/label/lip top printed in
+ * the body color. Matching against the full signature set (body origin 0
+ * included) keeps body faces body and feature faces feature.
+ */
+export declare function propagateOriginsByHash(inputs: readonly AnyShape<Dimension>[], result: AnyShape<Dimension>): void;
+//# sourceMappingURL=originTrackingFns.d.ts.map

package/dist/vendored/brepjs/topology/metadata/originTrackingFns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"originTrackingFns.d.ts","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/topology/metadata/originTrackingFns.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAapE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAO/E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAE1F;AAMD;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,SAAS,QAAQ,CAAC,SAAS,CAAC,EAAE,EACtC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,GAC1B,IAAI,CAgDN;AAyGD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,QAAQ,CAAC,SAAS,CAAC,EAAE,EACtC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,GAC1B,IAAI,CAkFN"}