@willwade/aac-processors 0.2.13 → 0.2.14

package/dist/browser/core/treeStructure.js

@@ -201,6 +201,21 @@ export class AACPage {
         // Record the mutation
         this._pendingMutations.push({ type: 'addButton', button });
     }
+    /**
+     * Internal load-path button push: adds a button to the page WITHOUT recording a mutation.
+     * Used by processors during loadIntoTree so the loaded baseline isn't treated as user changes.
+     * Not part of the public API — consumers should always use addButton.
+     */
+    _loadButton(button) {
+        this.buttons.push(button);
+    }
+    /**
+     * Discard all recorded mutations on this page.
+     * Useful as an escape hatch after loadIntoTree if the consumer wants a clean baseline.
+     */
+    clearMutations() {
+        this._pendingMutations = [];
+    }
     /**
      * Get the list of pending mutations for this page (read-only)
      */

package/dist/browser/processors/applePanelsProcessor.js

@@ -219,7 +219,8 @@ class ApplePanelsProcessor extends BaseProcessor {
                             fontWeight: btn.DisplayImageWeight === 'bold' ? 'bold' : 'normal',
                         },
                     });
-                    page.addButton(button);
+                    // Load path: do not record as a user mutation
+                    page._loadButton(button);
                     if (btn.Rect) {
                         const rect = this.parseRect(btn.Rect);
                         if (rect) {

package/dist/browser/processors/astericsGridProcessor.js

@@ -714,7 +714,8 @@ class AstericsGridProcessor extends BaseProcessor {
                 }
                 grid.gridElements.forEach((element) => {
                     const button = this.createButtonFromElement(element, colorConfig, activeColorSchemeDefinition);
-                    page.addButton(button);
+                    // Load path: do not record as a user mutation
+                    page._loadButton(button);
                     const buttonX = element.x || 0;
                     const buttonY = element.y || 0;
                     const buttonWidth = element.width || 1;

package/dist/browser/processors/dotProcessor.js

@@ -117,7 +117,8 @@ class DotProcessor extends BaseProcessor {
                 });
                 tree.addPage(page);
                 // Add a self button so single-node graphs yield one button
-                page.addButton(new AACButton({
+                // Load path: do not record as a user mutation
+                page._loadButton(new AACButton({
                     id: `${node.id}_self`,
                     label: node.label,
                     message: node.label,
@@ -138,7 +139,8 @@ class DotProcessor extends BaseProcessor {
                         message: '',
                         targetPageId: edge.to,
                     });
-                    fromPage.addButton(button);
+                    // Load path: do not record as a user mutation
+                    fromPage._loadButton(button);
                 }
             }
             return tree;

package/dist/browser/processors/gridsetProcessor.js

@@ -1571,8 +1571,8 @@ class GridsetProcessor extends BaseProcessor {
                                 ...(imageData ? { imageData, image_id: resolvedImageEntry } : {}),
                             },
                         });
-                        // Add button to page
-                        page.addButton(button);
+                        // Add button to page (load path: do not record as a user mutation)
+                        page._loadButton(button);
                         // Place button in grid layout (handle colspan/rowspan)
                         for (let r = cellY; r < cellY + rowSpan && r < maxRows; r++) {
                             for (let c = cellX; c < cellX + colSpan && c < maxCols; c++) {

package/dist/browser/processors/opmlProcessor.js

@@ -42,7 +42,8 @@ class OpmlProcessor extends BaseProcessor {
                         message: '',
                         targetPageId: childText.replace(/[^a-zA-Z0-9]/g, '_'),
                     });
-                    page.addButton(button);
+                    // Load path: do not record as a user mutation
+                    page._loadButton(button);
                     const { page: childPage, childPages: grandChildren } = this.processOutline(child, page.id);
                     if (childPage && childPage.id)
                         childPages.push(childPage, ...grandChildren);

package/dist/browser/processors/snapProcessor.js

@@ -579,7 +579,8 @@ class SnapProcessor extends BaseProcessor {
                     // Add to the intended parent page
                     const parentPage = tree.getPage(parentUniqueId);
                     if (parentPage) {
-                        parentPage.addButton(button);
+                        // Load path: do not record as a user mutation
+                        parentPage._loadButton(button);
                         // Add button to grid layout if position data is available
                         const gridPositionStr = String(btnRow.GridPosition || '');
                         if (gridPositionStr && gridPositionStr.includes(',')) {

package/dist/browser/processors/touchchatProcessor.js

@@ -266,8 +266,8 @@ class TouchChatProcessor extends BaseProcessor {
                             // Set button's x and y coordinates
                             button.x = absoluteX;
                             button.y = absoluteY;
-                            // Add button to page
-                            page.addButton(button);
+                            // Add button to page (load path: do not record as a user mutation)
+                            page._loadButton(button);
                             // Place button in grid (handle span)
                             for (let r = absoluteY; r < absoluteY + safeSpanY && r < 10; r++) {
                                 for (let c = absoluteX; c < absoluteX + safeSpanX && c < 10; c++) {
@@ -368,7 +368,7 @@ class TouchChatProcessor extends BaseProcessor {
                     // Find the page that references this resource
                     const page = Object.values(tree.pages).find((p) => p.id === (numericToRid.get(btnRow.id) || String(btnRow.id)));
                     if (page)
-                        page.addButton(button);
+                        page._loadButton(button); // load path: do not record as a user mutation
                 });
             }
             catch (_e) {

package/dist/core/treeStructure.d.ts

@@ -249,6 +249,17 @@ export declare class AACPage {
         scanType?: AACScanType;
     });
     addButton(button: AACButton): void;
+    /**
+     * Internal load-path button push: adds a button to the page WITHOUT recording a mutation.
+     * Used by processors during loadIntoTree so the loaded baseline isn't treated as user changes.
+     * Not part of the public API — consumers should always use addButton.
+     */
+    _loadButton(button: AACButton): void;
+    /**
+     * Discard all recorded mutations on this page.
+     * Useful as an escape hatch after loadIntoTree if the consumer wants a clean baseline.
+     */
+    clearMutations(): void;
     /**
      * Get the list of pending mutations for this page (read-only)
      */

package/dist/core/treeStructure.js

@@ -205,6 +205,21 @@ class AACPage {
         // Record the mutation
         this._pendingMutations.push({ type: 'addButton', button });
     }
+    /**
+     * Internal load-path button push: adds a button to the page WITHOUT recording a mutation.
+     * Used by processors during loadIntoTree so the loaded baseline isn't treated as user changes.
+     * Not part of the public API — consumers should always use addButton.
+     */
+    _loadButton(button) {
+        this.buttons.push(button);
+    }
+    /**
+     * Discard all recorded mutations on this page.
+     * Useful as an escape hatch after loadIntoTree if the consumer wants a clean baseline.
+     */
+    clearMutations() {
+        this._pendingMutations = [];
+    }
     /**
      * Get the list of pending mutations for this page (read-only)
      */

package/dist/processors/applePanelsProcessor.js

@@ -225,7 +225,8 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
                             fontWeight: btn.DisplayImageWeight === 'bold' ? 'bold' : 'normal',
                         },
                     });
-                    page.addButton(button);
+                    // Load path: do not record as a user mutation
+                    page._loadButton(button);
                     if (btn.Rect) {
                         const rect = this.parseRect(btn.Rect);
                         if (rect) {

package/dist/processors/astericsGridProcessor.js

@@ -722,7 +722,8 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                 }
                 grid.gridElements.forEach((element) => {
                     const button = this.createButtonFromElement(element, colorConfig, activeColorSchemeDefinition);
-                    page.addButton(button);
+                    // Load path: do not record as a user mutation
+                    page._loadButton(button);
                     const buttonX = element.x || 0;
                     const buttonY = element.y || 0;
                     const buttonWidth = element.width || 1;

package/dist/processors/dotProcessor.js

@@ -120,7 +120,8 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
                 });
                 tree.addPage(page);
                 // Add a self button so single-node graphs yield one button
-                page.addButton(new treeStructure_1.AACButton({
+                // Load path: do not record as a user mutation
+                page._loadButton(new treeStructure_1.AACButton({
                     id: `${node.id}_self`,
                     label: node.label,
                     message: node.label,
@@ -141,7 +142,8 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
                         message: '',
                         targetPageId: edge.to,
                     });
-                    fromPage.addButton(button);
+                    // Load path: do not record as a user mutation
+                    fromPage._loadButton(button);
                 }
             }
             return tree;

package/dist/processors/gridsetProcessor.js

@@ -1597,8 +1597,8 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                                 ...(imageData ? { imageData, image_id: resolvedImageEntry } : {}),
                             },
                         });
-                        // Add button to page
-                        page.addButton(button);
+                        // Add button to page (load path: do not record as a user mutation)
+                        page._loadButton(button);
                         // Place button in grid layout (handle colspan/rowspan)
                         for (let r = cellY; r < cellY + rowSpan && r < maxRows; r++) {
                             for (let c = cellX; c < cellX + colSpan && c < maxCols; c++) {

package/dist/processors/opmlProcessor.js

@@ -45,7 +45,8 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
                         message: '',
                         targetPageId: childText.replace(/[^a-zA-Z0-9]/g, '_'),
                     });
-                    page.addButton(button);
+                    // Load path: do not record as a user mutation
+                    page._loadButton(button);
                     const { page: childPage, childPages: grandChildren } = this.processOutline(child, page.id);
                     if (childPage && childPage.id)
                         childPages.push(childPage, ...grandChildren);

package/dist/processors/snapProcessor.js

@@ -582,7 +582,8 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
                     // Add to the intended parent page
                     const parentPage = tree.getPage(parentUniqueId);
                     if (parentPage) {
-                        parentPage.addButton(button);
+                        // Load path: do not record as a user mutation
+                        parentPage._loadButton(button);
                         // Add button to grid layout if position data is available
                         const gridPositionStr = String(btnRow.GridPosition || '');
                         if (gridPositionStr && gridPositionStr.includes(',')) {

package/dist/processors/touchchatProcessor.js

@@ -269,8 +269,8 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
                             // Set button's x and y coordinates
                             button.x = absoluteX;
                             button.y = absoluteY;
-                            // Add button to page
-                            page.addButton(button);
+                            // Add button to page (load path: do not record as a user mutation)
+                            page._loadButton(button);
                             // Place button in grid (handle span)
                             for (let r = absoluteY; r < absoluteY + safeSpanY && r < 10; r++) {
                                 for (let c = absoluteX; c < absoluteX + safeSpanX && c < 10; c++) {
@@ -371,7 +371,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
                     // Find the page that references this resource
                     const page = Object.values(tree.pages).find((p) => p.id === (numericToRid.get(btnRow.id) || String(btnRow.id)));
                     if (page)
-                        page.addButton(button);
+                        page._loadButton(button); // load path: do not record as a user mutation
                 });
             }
             catch (_e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@willwade/aac-processors",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "description": "A comprehensive TypeScript library for processing AAC (Augmentative and Alternative Communication) file formats with translation support",
   "main": "dist/index.js",
   "browser": "dist/browser/index.browser.js",