Normalize formatting and add Gridset helpers

Apply code-style and formatting changes across the codebase (quote normalization to double-quotes, consistent trailing commas/line breaks, spacing, and minor string/console formatting fixes). Update CLI and core modules for consistent formatting and improved readability. Add new Gridset helper files and utilities for the gridset processor (src/processors/gridset/cellHelpers.ts, gridCalculations.ts, xmlFormatter.ts) and adjust related gridset processor modules. Update docs (README, CHANGELOG) and numerous tests to reflect these changes.

Author: willwade

CHANGELOG.md

@@ -27,7 +27,11 @@ processor.saveFromTree(tree, output);
 // After (v3.x)
 const tree: AACTree = await processor.loadIntoTree(file);
 const texts: string[] = await processor.extractTexts(file);
-const result: Uint8Array = await processor.processTexts(file, translations, output);
+const result: Uint8Array = await processor.processTexts(
+  file,
+  translations,
+  output,
+);
 await processor.saveFromTree(tree, output);
 ```
 
@@ -39,18 +43,19 @@ const symbols: ButtonForTranslation[] = processor.extractSymbolsForLLM(file);
 processor.processLLMTranslations(file, translations, output);
 
 // After
-const symbols: ButtonForTranslation[] = await processor.extractSymbolsForLLM(file);
+const symbols: ButtonForTranslation[] =
+  await processor.extractSymbolsForLLM(file);
 await processor.processLLMTranslations(file, translations, output);
 ```
 
 #### Helper Functions (BREAKING)
 
 ```typescript
 // Before
-const result = analyze(file, format);  // Returns { tree }
+const result = analyze(file, format); // Returns { tree }
 
 // After
-const result = await analyze(file, format);  // Returns Promise<{ tree }>
+const result = await analyze(file, format); // Returns Promise<{ tree }>
 ```
 
 ### Migration Guide
@@ -103,7 +108,7 @@ async function processMultipleFiles(files: string[]) {
       const processor = getProcessor(file);
       const tree = await processor.loadIntoTree(file);
       return tree;
-    })
+    }),
   );
   return results;
 }
@@ -154,6 +159,7 @@ async function processMultipleFiles(files: string[]) {
 ### Browser Compatibility Progress
 
 This change enables the following browser-compatible processors:
+
 - ✅ DotProcessor
 - ✅ OpmlProcessor
 - ✅ ObfProcessor (JSZip migration complete!)
@@ -164,6 +170,7 @@ This change enables the following browser-compatible processors:
 **Note:** Gridset `.gridsetx` encrypted files require Node.js for crypto operations. Regular `.gridset` files work in browser.
 
 Still Node-only (deferred):
+
 - ❌ SnapProcessor (sqlite - needs wasm sqlite)
 - ❌ TouchChatProcessor (sqlite - needs wasm sqlite)
 - ❌ ExcelProcessor (fs dependencies - needs audit)

README.md

@@ -13,20 +13,22 @@ npm install @willwade/aac-processors
 ## Dual Build Targets
 
 ### Node.js (default)
+
 Full feature set, including filesystem access, SQLite-backed formats, and
 ZIP/encrypted formats.
 
 ```ts
-import { getProcessor, SnapProcessor } from '@willwade/aac-processors';
+import { getProcessor, SnapProcessor } from "@willwade/aac-processors";
 
-const processor = getProcessor('board.sps');
-const tree = await processor.loadIntoTree('board.sps');
+const processor = getProcessor("board.sps");
+const tree = await processor.loadIntoTree("board.sps");
 
 const snap = new SnapProcessor();
-const texts = await snap.extractTexts('board.sps');
+const texts = await snap.extractTexts("board.sps");
 ```
 
 ### Browser
+
 Browser-safe entry that avoids Node-only dependencies. It expects `Buffer`,
 `Uint8Array`, or `ArrayBuffer` inputs rather than file paths.
 
@@ -36,7 +38,10 @@ and either include `<script src="sql-wasm.js"></script>` in your HTML, or
 `window.initSqlJs = require('sql.js');` in your app.
 
 ```ts
-import { configureSqlJs, SnapProcessor } from '@willwade/aac-processors/browser';
+import {
+  configureSqlJs,
+  SnapProcessor,
+} from "@willwade/aac-processors/browser";
 
 configureSqlJs({
   locateFile: (file) => new URL(`./${file}`, import.meta.url).toString(),
@@ -47,7 +52,7 @@ const tree = await snap.loadIntoTree(snapUint8Array);
 ```
 
 ```ts
-import { GridsetProcessor } from '@willwade/aac-processors/browser';
+import { GridsetProcessor } from "@willwade/aac-processors/browser";
 
 const processor = new GridsetProcessor();
 const tree = await processor.loadIntoTree(gridsetUint8Array);
@@ -70,19 +75,20 @@ const tree = await processor.loadIntoTree(gridsetUint8Array);
 All processors implement `processTexts()` to get all strings eg
 
 ```ts
-import { DotProcessor } from '@willwade/aac-processors';
+import { DotProcessor } from "@willwade/aac-processors";
 
 const processor = new DotProcessor();
-const texts = await processor.extractTexts('board.dot');
+const texts = await processor.extractTexts("board.dot");
 
 const translations = new Map([
-  ['Hello', 'Hola'],
-  ['Food', 'Comida'],
+  ["Hello", "Hola"],
+  ["Food", "Comida"],
 ]);
 
-await processor.processTexts('board.dot', translations, 'board-es.dot');
+await processor.processTexts("board.dot", translations, "board-es.dot");
 ```
-NB: Please use [https://aactools.co.uk](https://aactools.co.uk) for a far more comphrensive translation logic - where we do far far more than this...  
+
+NB: Please use [https://aactools.co.uk](https://aactools.co.uk) for a far more comphrensive translation logic - where we do far far more than this...
 
 ## Documentation
 

src/analytics.ts

@@ -5,4 +5,4 @@
  * This is separate from pageset metrics.
  */
 
-export * from './utilities/analytics/history';
+export * from "./utilities/analytics/history";

src/applePanels.ts

@@ -5,7 +5,7 @@
  */
 
 // Processor class
-export { ApplePanelsProcessor } from './processors/applePanelsProcessor';
+export { ApplePanelsProcessor } from "./processors/applePanelsProcessor";
 
 // Note: Apple Panels doesn't currently have platform-specific helpers
 // Future helper functions can be added here

src/astericsGrid.ts

@@ -5,7 +5,7 @@
  */
 
 // Processor class
-export { AstericsGridProcessor } from './processors/astericsGridProcessor';
+export { AstericsGridProcessor } from "./processors/astericsGridProcessor";
 
 // Note: Asterics Grid doesn't currently have platform-specific helpers
 // Future helper functions can be added here