update to assembly parsing.

Author: matas-bitbybit-dev

packages/dev/core/lib/api/context.ts

@@ -16,6 +16,11 @@ export interface PreviewCSVInterface {
     hidden?: boolean;
 }
 
+export interface PreviewAssemblyHierarchyInterface {
+    data: any;
+    hidden?: boolean;
+}
+
 export class ContextBase {
     blocklyWorkspace: any;
     verb: any;
@@ -27,6 +32,7 @@ export class ContextBase {
     promptPrint: (prompt: PrintSaveInterface) => void;
     promptPreviewData: (data: PreviewDataInterface) => void;
     promptPreviewCSV: (data: PreviewCSVInterface) => void;
+    promptPreviewAssemblyHierarchy: (data: PreviewAssemblyHierarchyInterface) => void;
 
     rerenderScene: () => void;
     tolerance = 0.00001;

packages/dev/occt-worker/lib/api/occt/assembly/manager.ts

@@ -92,6 +92,42 @@ export class OCCTAssemblyManager {
         return this.occWorkerManager.genericCallToWorkerPromise("assembly.manager.createInstanceNode", inputs);
     }
 
+    /**
+     * Create a part update definition for modifying an existing part in a document.
+     * Part updates can change the shape, name, and/or color of an existing part.
+     * 
+     * @param inputs - Update details including label and optional new shape/name/color
+     * @returns Part update definition that can be added to an assembly structure's partUpdates array
+     * @group assembly
+     * @shortname create part update
+     * @drawable false
+     * 
+     * @example
+     * ```typescript
+     * // Get existing parts from document
+     * const parts = await occt.assembly.query.getDocumentParts({ document });
+     * 
+     * // Create a new shape to replace the old one
+     * const newBox = await occt.shapes.solid.createBox({ width: 20, length: 20, height: 20 });
+     * 
+     * // Create an update definition
+     * const update = await occt.assembly.manager.createPartUpdate({ 
+     *     label: parts[0].label, 
+     *     shape: newBox,
+     *     name: "Bigger Box",
+     *     colorRgba: { r: 0, g: 1, b: 0, a: 1 }
+     * });
+     * 
+     * // Combine with structure and rebuild
+     * const structure = await occt.assembly.manager.combineStructure({ parts: [], nodes: [], partUpdates: [update] });
+     * await occt.assembly.manager.buildAssemblyDocument({ structure, existingDocument: document });
+     * ```
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async createPartUpdate(inputs: Inputs.OCCT.CreatePartUpdateDto<any>): Promise<Models.OCCT.AssemblyPartUpdateDef<any>> {
+        return this.occWorkerManager.genericCallToWorkerPromise("assembly.manager.createPartUpdate", inputs);
+    }
+
     /**
      * Combine parts and nodes into a complete assembly structure definition.
      * This is the final step before calling buildAssemblyDocument.

…itbybit-dev-occt-64-bit-mt.95baabc7.wasm …itbybit-dev-occt-64-bit-mt.c14311b1.wasmpackages/dev/occt/bitbybit-dev-occt-64-bit-mt/bitbybit-dev-occt-64-bit-mt.95baabc7.wasm renamed to packages/dev/occt/bitbybit-dev-occt-64-bit-mt/bitbybit-dev-occt-64-bit-mt.c14311b1.wasm packages/dev/occt/bitbybit-dev-occt-64-bit-mt/bitbybit-dev-occt-64-bit-mt.95baabc7.wasm renamed to packages/dev/occt/bitbybit-dev-occt-64-bit-mt/bitbybit-dev-occt-64-bit-mt.c14311b1.wasm

@@ -13,7 +13,7 @@ import { GlobalCDNProvider } from "@bitbybit-dev/base";
  * @returns Promise that resolves to the initialized OCCT module
  */
 const createBitbybitDevOcct = (moduleOverrides = {}) => {
-    const cdnWasmUrl = GlobalCDNProvider.BITBYBIT_CDN_URL + "/wasm/bitbybit-dev-occt-64-bit-mt.95baabc7.wasm";
+    const cdnWasmUrl = GlobalCDNProvider.BITBYBIT_CDN_URL + "/wasm/bitbybit-dev-occt-64-bit-mt.c14311b1.wasm";
 
     // If user provided their own locateFile, wrap it to preserve their customizations
     const userLocateFile = moduleOverrides.locateFile;

packages/dev/occt/bitbybit-dev-occt-64-bit-mt/bitbybit-dev-occt-64-bit-mt.js

@@ -14,10 +14,11 @@ import { GlobalCDNProvider } from "@bitbybit-dev/base";
  * @returns Promise that resolves to the initialized OCCT module
  */
 const createBitbybitDevOcct = (moduleOverrides = {}) => {
-    const cdnWasmUrl = GlobalCDNProvider.BITBYBIT_CDN_URL + "/wasm/bitbybit-dev-occt-64-bit.b96ec633.wasm";
+    const cdnWasmUrl = GlobalCDNProvider.BITBYBIT_CDN_URL + "/wasm/bitbybit-dev-occt-64-bit.531f1660.wasm";
+
     // If user provided their own locateFile, wrap it to preserve their customizations
     const userLocateFile = moduleOverrides.locateFile;
-    
+
     return createBitbybitDevOcctOriginal({
         ...moduleOverrides,
         locateFile(path, scriptDirectory) {

packages/dev/occt/bitbybit-dev-occt-64-bit-mt/cdn.js

@@ -430,7 +430,7 @@ export interface BitbybitOcctModule {
    * Build an assembly document from a structure definition and return the document handle directly.
    * The caller is responsible for managing the document lifetime.
    * 
-   * Structure JSON format:
+   * Structure JSON format (for creating new assembly):
    * {
    *   "parts": [
    *     { "id": "part-1", "shapeIndex": 0, "name": "Box", "color": { "r": 1, "g": 0, "b": 0, "a": 1 } }
@@ -442,9 +442,18 @@ export interface BitbybitOcctModule {
    *   ]
    * }
    * 
-   * @param structureJson - JSON string with assembly structure
-   * @param shapesArray - Array of TopoDS_Shape objects, referenced by shapeIndex in parts
-   * @param existingDoc - Optional existing document handle to reuse (clears and updates instead of creating new)
+   * When updating an existing document, you can also include:
+   * - "removals": ["0:1:1:2", "0:1:1:3:1"] - Labels to remove (parts, instances, or assemblies)
+   * - "partUpdates": [{ "label": "0:1:1:1", "shapeIndex": 0, "name": "New Name", "color": {...} }] - Updates to apply
+   * 
+   * Processing order for updates:
+   * 1. Removals are applied first
+   * 2. Part updates are applied second  
+   * 3. New parts and nodes are added last
+   * 
+   * @param structureJson - JSON string with assembly structure (parts, nodes, optional removals/partUpdates)
+   * @param shapesArray - Array of TopoDS_Shape objects, referenced by shapeIndex in parts and partUpdates
+   * @param existingDoc - Optional existing document handle to update (for removals/partUpdates/additions)
    * @returns Handle to the created/updated document. Call IsNull() to check for errors.
    */
   BuildAssemblyDocument(structureJson: string, shapesArray: TopoDS_Shape[], existingDoc?: Handle_TDocStd_Document): Handle_TDocStd_Document;