@willwade/aac-processors 0.2.20 → 0.3.0

package/dist/processors/gotalkNowProcessor.d.ts

@@ -0,0 +1,51 @@
+/**
+ * GoTalk NOW Processor
+ *
+ * Reads, translates, and converts Attainment Company's GoTalk NOW
+ * communication-board files (`.gtbz`).
+ *
+ * A `.gtbz` file is a ZIP archive containing Apple property lists:
+ *   - BookInfo.plist        – format version (GoTalkBookFormatVersion)
+ *   - PageData.plist        – pages dict keyed by page id (positive = content,
+ *                             negative = system/express-bar pages)
+ *   - PageOrder.plist       – ordered array of page ids
+ *   - PageHistory.plist     – navigation history (usually empty)
+ *   - SettingsWriteOut.plist– app-level settings (TTS, scanning, …)
+ *   - IconSource-<id>.png   – page icons
+ *   - Source-<page>-<btn>-<guid>-…png – button images
+ *   - <page>-<btn>.caf      – audio recordings (Core Audio Format)
+ *   - Backup-<n>.zip        – rolling backups
+ *   - REQUIRESREGEN         – marker file
+ *
+ * Colours and fonts in PageData are NSKeyedArchiver-encoded binary plists
+ * carried inside `<data>` tags. They are treated as opaque blobs and preserved
+ * verbatim so that only text fields are touched during translation.
+ */
+import { BaseProcessor, ProcessorOptions, ExtractStringsResult, TranslatedString, SourceString } from '../core/baseProcessor';
+import { AACTree } from '../core/treeStructure';
+import { ProcessorInput } from '../utils/io';
+declare class GotalkNowProcessor extends BaseProcessor {
+    readonly capabilities: {
+        wordList: "none";
+        preservesAssetsOnSave: boolean;
+        newCellCreation: "allowed";
+    };
+    constructor(options?: ProcessorOptions);
+    private openZip;
+    private readPlistFromZip;
+    extractTexts(filePathOrBuffer: ProcessorInput): Promise<string[]>;
+    loadIntoTree(filePathOrBuffer: ProcessorInput): Promise<AACTree>;
+    processTexts(filePathOrBuffer: ProcessorInput, translations: Map<string, string>, outputPath: string): Promise<Uint8Array>;
+    saveFromTree(tree: AACTree, outputPath: string): Promise<void>;
+    /**
+     * Extract strings with metadata for aac-tools-platform compatibility.
+     * Uses the generic implementation from BaseProcessor.
+     */
+    extractStringsWithMetadata(filePath: string): Promise<ExtractStringsResult>;
+    /**
+     * Generate translated download for aac-tools-platform compatibility.
+     * Uses the generic implementation from BaseProcessor.
+     */
+    generateTranslatedDownload(filePath: string, translatedStrings: TranslatedString[], sourceStrings: SourceString[]): Promise<string>;
+}
+export { GotalkNowProcessor };

package/dist/processors/gotalkNowProcessor.js

@@ -0,0 +1,469 @@
+"use strict";
+/**
+ * GoTalk NOW Processor
+ *
+ * Reads, translates, and converts Attainment Company's GoTalk NOW
+ * communication-board files (`.gtbz`).
+ *
+ * A `.gtbz` file is a ZIP archive containing Apple property lists:
+ *   - BookInfo.plist        – format version (GoTalkBookFormatVersion)
+ *   - PageData.plist        – pages dict keyed by page id (positive = content,
+ *                             negative = system/express-bar pages)
+ *   - PageOrder.plist       – ordered array of page ids
+ *   - PageHistory.plist     – navigation history (usually empty)
+ *   - SettingsWriteOut.plist– app-level settings (TTS, scanning, …)
+ *   - IconSource-<id>.png   – page icons
+ *   - Source-<page>-<btn>-<guid>-…png – button images
+ *   - <page>-<btn>.caf      – audio recordings (Core Audio Format)
+ *   - Backup-<n>.zip        – rolling backups
+ *   - REQUIRESREGEN         – marker file
+ *
+ * Colours and fonts in PageData are NSKeyedArchiver-encoded binary plists
+ * carried inside `<data>` tags. They are treated as opaque blobs and preserved
+ * verbatim so that only text fields are touched during translation.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GotalkNowProcessor = void 0;
+const baseProcessor_1 = require("../core/baseProcessor");
+const treeStructure_1 = require("../core/treeStructure");
+const plist_1 = __importDefault(require("plist"));
+const validationTypes_1 = require("../validation/validationTypes");
+const io_1 = require("../utils/io");
+const nsKeyed_1 = require("./gotalkNow/nsKeyed");
+// ---------------------------------------------------------------------------
+// GoTalk NOW button type → semantic-action mapping
+// ---------------------------------------------------------------------------
+function buildSemanticAction(rawButton, pageId, buttonIndex) {
+    const buttonType = rawButton.ButtonType || 'TTS';
+    const actionData = rawButton.ActionData || {};
+    const label = rawButton.ButtonText ?? '';
+    const ttsText = actionData.TTSText;
+    switch (buttonType) {
+        case 'Jump': {
+            const jumpTo = actionData.JumpTo;
+            const target = jumpTo !== undefined ? String(jumpTo) : undefined;
+            return {
+                semanticAction: {
+                    category: treeStructure_1.AACSemanticCategory.NAVIGATION,
+                    intent: treeStructure_1.AACSemanticIntent.NAVIGATE_TO,
+                    targetId: target,
+                    platformData: {
+                        gotalkNow: { buttonType: 'Jump', jumpTo },
+                    },
+                    fallback: { type: 'NAVIGATE', targetPageId: target },
+                },
+                message: '',
+                targetPageId: target,
+            };
+        }
+        case 'Audio': {
+            // Audio buttons play a recorded .caf file named <pageId>-<buttonIndex>.caf
+            const audioLocation = `${pageId}-${buttonIndex}.caf`;
+            return {
+                semanticAction: {
+                    category: treeStructure_1.AACSemanticCategory.MEDIA,
+                    intent: treeStructure_1.AACSemanticIntent.PLAY_SOUND,
+                    platformData: {
+                        gotalkNow: { buttonType: 'Audio', audioLocation },
+                    },
+                    fallback: { type: 'ACTION' },
+                },
+                message: label,
+            };
+        }
+        case 'Express':
+        case 'Bookmark':
+        case 'URL':
+        case 'Video': {
+            return {
+                semanticAction: {
+                    category: treeStructure_1.AACSemanticCategory.SYSTEM_CONTROL,
+                    intent: treeStructure_1.AACSemanticIntent.PLATFORM_SPECIFIC,
+                    platformData: {
+                        gotalkNow: { buttonType },
+                    },
+                    fallback: { type: 'ACTION' },
+                },
+                message: ttsText && ttsText.length > 0 ? ttsText : label,
+            };
+        }
+        case 'TTS':
+        default: {
+            // When TTSText is empty the visible ButtonText is spoken.
+            const spoken = ttsText && ttsText.length > 0 ? ttsText : label;
+            return {
+                semanticAction: {
+                    category: treeStructure_1.AACSemanticCategory.COMMUNICATION,
+                    intent: treeStructure_1.AACSemanticIntent.SPEAK_TEXT,
+                    text: spoken,
+                    platformData: {
+                        gotalkNow: { buttonType: 'TTS' },
+                    },
+                    fallback: { type: 'SPEAK', message: spoken },
+                },
+                message: spoken,
+            };
+        }
+    }
+}
+/**
+ * Derive a square-ish grid layout from the declared button count.
+ * GoTalk NOW uses fixed layouts (1, 4, 9, 16, 25, 36 …).
+ */
+function gridDimensionsFromButtonCount(count) {
+    const side = Math.max(1, Math.ceil(Math.sqrt(Math.max(count, 1))));
+    return { rows: side, cols: side };
+}
+// ---------------------------------------------------------------------------
+// Processor
+// ---------------------------------------------------------------------------
+class GotalkNowProcessor extends baseProcessor_1.BaseProcessor {
+    constructor(options) {
+        super(options);
+        this.capabilities = {
+            wordList: 'none',
+            preservesAssetsOnSave: true,
+            newCellCreation: 'allowed',
+        };
+    }
+    // ---- Zip access ---------------------------------------------------------
+    async openZip(filePathOrBuffer) {
+        const zip = await this.options.zipAdapter(filePathOrBuffer, this.options.fileAdapter);
+        return zip;
+    }
+    async readPlistFromZip(zip, name, fallback) {
+        const files = zip.listFiles();
+        if (!files.includes(name)) {
+            if (fallback)
+                return fallback();
+            throw new Error(`GoTalk NOW archive is missing ${name}`);
+        }
+        const bytes = await zip.readFile(name);
+        const text = typeof Buffer !== 'undefined' && Buffer.isBuffer(bytes)
+            ? bytes.toString('utf8')
+            : new TextDecoder().decode(bytes);
+        return plist_1.default.parse(text);
+    }
+    // ---- extractTexts -------------------------------------------------------
+    async extractTexts(filePathOrBuffer) {
+        const tree = await this.loadIntoTree(filePathOrBuffer);
+        const texts = [];
+        for (const pageId in tree.pages) {
+            const page = tree.pages[pageId];
+            if (page.name)
+                texts.push(page.name);
+            page.buttons.forEach((btn) => {
+                if (btn.label)
+                    texts.push(btn.label);
+                if (btn.message && btn.message !== btn.label)
+                    texts.push(btn.message);
+            });
+        }
+        return texts;
+    }
+    // ---- loadIntoTree -------------------------------------------------------
+    async loadIntoTree(filePathOrBuffer) {
+        const { getFileSize, pathExists } = this.options.fileAdapter;
+        const filename = typeof filePathOrBuffer === 'string' ? (0, io_1.getBasename)(filePathOrBuffer) : 'upload.gtbz';
+        let zip;
+        let pageDataValue;
+        let pageOrderValue;
+        let bookInfoValue;
+        try {
+            zip = await this.openZip(filePathOrBuffer);
+            pageDataValue = await this.readPlistFromZip(zip, 'PageData.plist');
+            pageOrderValue = await this.readPlistFromZip(zip, 'PageOrder.plist', () => []);
+            bookInfoValue = await this.readPlistFromZip(zip, 'BookInfo.plist', () => ({}));
+        }
+        catch (err) {
+            if (err instanceof validationTypes_1.ValidationFailureError)
+                throw err;
+            const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
+                filename,
+                filesize: typeof filePathOrBuffer === 'string'
+                    ? (await pathExists(filePathOrBuffer))
+                        ? await getFileSize(filePathOrBuffer)
+                        : 0
+                    : 0,
+                format: 'gotalknow',
+                message: err?.message || 'Failed to open GoTalk NOW archive',
+                type: 'structure',
+                description: 'gtbz archive',
+            });
+            throw new validationTypes_1.ValidationFailureError('Failed to load GoTalk NOW file', validation, err);
+        }
+        const pageData = pageDataValue || {};
+        const pageOrderRaw = Array.isArray(pageOrderValue) ? pageOrderValue : [];
+        const tree = new treeStructure_1.AACTree();
+        tree.metadata.format = 'gotalknow';
+        // Format version
+        const bookInfo = bookInfoValue || {};
+        if (bookInfo.GoTalkBookFormatVersion !== undefined) {
+            const version = bookInfo.GoTalkBookFormatVersion;
+            tree.metadata.version =
+                typeof version === 'number' || typeof version === 'string' ? String(version) : '1';
+        }
+        // Preserve the ordered list of page ids for round-trip fidelity.
+        const orderedPageIds = pageOrderRaw.map((id) => String(id));
+        tree.metadata.pageOrder = orderedPageIds;
+        // The first page in PageOrder (if any) is treated as the home page.
+        if (orderedPageIds.length > 0) {
+            tree.metadata.defaultHomePageId = orderedPageIds[0];
+        }
+        // Track available image files so we can resolve ButtonImages locations.
+        const zipFiles = new Set(zip.listFiles());
+        // Build pages. Use the union of PageData keys and PageOrder ids.
+        const allPageIds = new Set([...Object.keys(pageData), ...orderedPageIds]);
+        // Deterministic ordering: ordered pages first (in order), then any extras sorted numerically.
+        const sortedPageIds = [
+            ...orderedPageIds.filter((id) => allPageIds.has(id)),
+            ...[...allPageIds]
+                .filter((id) => !orderedPageIds.includes(id))
+                .sort((a, b) => Number(a) - Number(b)),
+        ];
+        if (sortedPageIds.length === 0) {
+            const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
+                filename,
+                filesize: 0,
+                format: 'gotalknow',
+                message: 'No pages found in GoTalk NOW PageData.plist',
+                type: 'structure',
+                description: 'PageData.plist',
+            });
+            throw new validationTypes_1.ValidationFailureError('GoTalk NOW file has no pages', validation);
+        }
+        for (const pageId of sortedPageIds) {
+            const rawPage = pageData[pageId] || { Buttons: {} };
+            const pageTitle = typeof rawPage.PageTitle === 'string' && rawPage.PageTitle.trim().length > 0
+                ? rawPage.PageTitle
+                : `Page ${pageId}`;
+            const page = new treeStructure_1.AACPage({
+                id: pageId,
+                name: pageTitle,
+                grid: [],
+                buttons: [],
+                parentId: null,
+            });
+            // Page-level style: background colour and title font.
+            const pageBg = (0, nsKeyed_1.decodeNsColor)(rawPage.BackgroundColor);
+            const pageFont = (0, nsKeyed_1.decodeNsFont)(rawPage.TitleFont);
+            if (pageBg || pageFont.fontFamily) {
+                page.style = {
+                    ...(page.style || {}),
+                    ...(pageBg ? { backgroundColor: pageBg } : {}),
+                    ...(pageFont.fontFamily ? { fontFamily: pageFont.fontFamily } : {}),
+                };
+            }
+            if (rawPage.Enabled === false) {
+                // Disabled pages are retained but flagged for fidelity.
+                page.enabled = false;
+            }
+            const buttonsById = rawPage.Buttons || {};
+            // Numeric sort of button indices ("0","1",…,"10",…)
+            const buttonIndices = Object.keys(buttonsById).sort((a, b) => Number(a) - Number(b));
+            const buttonCount = rawPage.ButtonCount ?? buttonIndices.length;
+            const { rows, cols } = gridDimensionsFromButtonCount(buttonCount);
+            const gridLayout = Array.from({ length: rows }, () => Array.from({ length: cols }, () => null));
+            buttonIndices.forEach((btnIndex, i) => {
+                const rawButton = buttonsById[btnIndex];
+                if (!rawButton)
+                    return;
+                const { semanticAction, message, targetPageId } = buildSemanticAction(rawButton, pageId, btnIndex);
+                const button = new treeStructure_1.AACButton({
+                    id: `${pageId}_btn_${btnIndex}`,
+                    label: rawButton.ButtonText ?? '',
+                    message,
+                    targetPageId,
+                    semanticAction,
+                });
+                // Decode style from NSKeyedArchiver blobs.
+                const backgroundColor = (0, nsKeyed_1.decodeNsColor)(rawButton.BackgroundColor);
+                const borderColor = (0, nsKeyed_1.decodeNsColor)(rawButton.BorderColor);
+                const fontColor = (0, nsKeyed_1.decodeNsColor)(rawButton.TextColor);
+                const font = (0, nsKeyed_1.decodeNsFont)(rawButton.TextFont);
+                if (backgroundColor || borderColor || fontColor || font.fontFamily) {
+                    button.style = {
+                        ...(button.style || {}),
+                        ...(backgroundColor ? { backgroundColor } : {}),
+                        ...(borderColor ? { borderColor } : {}),
+                        ...(fontColor ? { fontColor } : {}),
+                        ...(font.fontFamily ? { fontFamily: font.fontFamily } : {}),
+                    };
+                }
+                // Resolve image metadata.
+                const images = rawButton.ButtonImages;
+                if (Array.isArray(images) && images.length > 0) {
+                    const first = images[0];
+                    if (first?.Location) {
+                        button.image = first.Location;
+                        if (zipFiles.has(first.Location)) {
+                            button.resolvedImageEntry = first.Location;
+                        }
+                    }
+                    if (first?.SourceLibrary)
+                        button.symbolLibrary = first.SourceLibrary;
+                    if (first?.SourceImageName)
+                        button.symbolPath = first.SourceImageName;
+                }
+                // Visibility: GoTalk buttons can be disabled.
+                if (rawButton.Enabled === false) {
+                    button.visibility = 'Disabled';
+                }
+                // Preserve raw style data opaquely for round-trip styling.
+                button.parameters = {
+                    ...(button.parameters || {}),
+                    __gotalkNow: {
+                        buttonType: rawButton.ButtonType,
+                        textShadow: rawButton.TextShadow,
+                        textCenter: rawButton.TextCenter,
+                    },
+                };
+                page._loadButton(button);
+                // Place into grid by index (row-major).
+                const row = Math.floor(i / cols);
+                const col = i % cols;
+                if (row < rows && col < cols) {
+                    gridLayout[row][col] = button;
+                }
+            });
+            page.grid = gridLayout;
+            tree.addPage(page);
+        }
+        return tree;
+    }
+    // ---- processTexts (asset-preserving round-trip) -------------------------
+    async processTexts(filePathOrBuffer, translations, outputPath) {
+        const { writeBinaryToPath } = this.options.fileAdapter;
+        const originalZip = await this.openZip(filePathOrBuffer);
+        // Parse PageData and apply translations in place.
+        const pageDataBytes = await originalZip.readFile('PageData.plist');
+        const pageDataText = typeof Buffer !== 'undefined' && Buffer.isBuffer(pageDataBytes)
+            ? pageDataBytes.toString('utf8')
+            : new TextDecoder().decode(pageDataBytes);
+        const pageData = plist_1.default.parse(pageDataText);
+        for (const pageId of Object.keys(pageData)) {
+            const rawPage = pageData[pageId];
+            if (!rawPage || !rawPage.Buttons)
+                continue;
+            for (const btnIndex of Object.keys(rawPage.Buttons)) {
+                const rawButton = rawPage.Buttons[btnIndex];
+                if (!rawButton)
+                    continue;
+                // Translate the visible label.
+                if (rawButton.ButtonText && translations.has(rawButton.ButtonText)) {
+                    rawButton.ButtonText = translations.get(rawButton.ButtonText);
+                }
+                // Translate the spoken text (only when explicitly set).
+                const actionData = rawButton.ActionData;
+                if (actionData && actionData.TTSText && translations.has(actionData.TTSText)) {
+                    actionData.TTSText = translations.get(actionData.TTSText);
+                }
+            }
+        }
+        const rebuiltPageData = plist_1.default.build(pageData);
+        // Repack: copy every original entry verbatim, replacing only PageData.plist.
+        const outputZip = await this.options.zipAdapter(undefined, this.options.fileAdapter);
+        const files = [];
+        for (const name of originalZip.listFiles()) {
+            if (name === 'PageData.plist')
+                continue;
+            files.push({ name, data: await originalZip.readFile(name) });
+        }
+        files.push({ name: 'PageData.plist', data: rebuiltPageData });
+        const outputBuffer = await outputZip.writeFiles(files);
+        await writeBinaryToPath(outputPath, outputBuffer);
+        return outputBuffer;
+    }
+    // ---- saveFromTree (build from tree) -------------------------------------
+    async saveFromTree(tree, outputPath) {
+        const { writeBinaryToPath } = this.options.fileAdapter;
+        const pageData = {};
+        const pageOrder = [];
+        const imageFiles = [];
+        const pageIds = Object.keys(tree.pages);
+        pageIds.forEach((pageId, pageIdx) => {
+            const page = tree.pages[pageId];
+            const numericId = Number(pageId);
+            if (!Number.isNaN(numericId))
+                pageOrder.push(numericId);
+            const buttons = {};
+            const buttonList = page.buttons;
+            buttonList.forEach((btn, i) => {
+                const btnIndex = String(i);
+                const buttonType = btn.parameters?.__gotalkNow?.buttonType ||
+                    (btn.targetPageId ? 'Jump' : 'TTS');
+                const actionData = {};
+                if (buttonType === 'Jump' && btn.targetPageId) {
+                    actionData.JumpTo = Number(btn.targetPageId);
+                    actionData.TTSText = '';
+                }
+                else if (buttonType === 'TTS') {
+                    // Only store TTSText when it differs from the label (matches GoTalk's convention).
+                    actionData.TTSText = btn.message && btn.message !== btn.label ? btn.message : '';
+                }
+                else {
+                    actionData.TTSText = btn.message || '';
+                }
+                const rawButton = {
+                    ActionData: actionData,
+                    ButtonType: buttonType,
+                    ButtonText: btn.label || '',
+                };
+                if (btn.resolvedImageEntry || btn.image) {
+                    rawButton.ButtonImages = [
+                        {
+                            Location: btn.resolvedImageEntry || btn.image,
+                            Type: 'Saved',
+                        },
+                    ];
+                }
+                buttons[btnIndex] = rawButton;
+            });
+            pageData[pageId] = {
+                ButtonCount: buttonList.length,
+                Buttons: buttons,
+            };
+            // Collect referenced images so we can include them in the archive.
+            buttonList.forEach((btn) => {
+                if (btn.resolvedImageEntry) {
+                    // Image bytes are not available from the tree alone; skip if absent.
+                }
+            });
+            void pageIdx;
+        });
+        const bookInfo = {
+            GoTalkBookFormatVersion: Number(tree.metadata.version) || 1,
+        };
+        const zip = await this.options.zipAdapter(undefined, this.options.fileAdapter);
+        const files = [
+            { name: 'BookInfo.plist', data: plist_1.default.build(bookInfo) },
+            { name: 'PageData.plist', data: plist_1.default.build(pageData) },
+            {
+                name: 'PageOrder.plist',
+                data: plist_1.default.build(pageOrder),
+            },
+            { name: 'PageHistory.plist', data: plist_1.default.build([]) },
+            ...imageFiles,
+        ];
+        const outputBuffer = await zip.writeFiles(files);
+        await writeBinaryToPath(outputPath, outputBuffer);
+    }
+    /**
+     * Extract strings with metadata for aac-tools-platform compatibility.
+     * Uses the generic implementation from BaseProcessor.
+     */
+    extractStringsWithMetadata(filePath) {
+        return this.extractStringsWithMetadataGeneric(filePath);
+    }
+    /**
+     * Generate translated download for aac-tools-platform compatibility.
+     * Uses the generic implementation from BaseProcessor.
+     */
+    generateTranslatedDownload(filePath, translatedStrings, sourceStrings) {
+        return this.generateTranslatedDownloadGeneric(filePath, translatedStrings, sourceStrings);
+    }
+}
+exports.GotalkNowProcessor = GotalkNowProcessor;

package/dist/processors/index.d.ts

@@ -16,3 +16,4 @@ export { SnapProcessor } from './snapProcessor';
 export { TouchChatProcessor } from './touchchatProcessor';
 export { AstericsGridProcessor } from './astericsGridProcessor';
 export { ObfsetProcessor } from './obfsetProcessor';
+export { GotalkNowProcessor } from './gotalkNowProcessor';

package/dist/processors/index.js

@@ -8,7 +8,7 @@
  * - import { Snap } from 'aac-processors/snap';
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ObfsetProcessor = exports.AstericsGridProcessor = exports.TouchChatProcessor = exports.SnapProcessor = exports.OpmlProcessor = exports.ObfProcessor = exports.GridsetProcessor = exports.ExcelProcessor = exports.DotProcessor = exports.ApplePanelsProcessor = void 0;
+exports.GotalkNowProcessor = exports.ObfsetProcessor = exports.AstericsGridProcessor = exports.TouchChatProcessor = exports.SnapProcessor = exports.OpmlProcessor = exports.ObfProcessor = exports.GridsetProcessor = exports.ExcelProcessor = exports.DotProcessor = exports.ApplePanelsProcessor = void 0;
 var applePanelsProcessor_1 = require("./applePanelsProcessor");
 Object.defineProperty(exports, "ApplePanelsProcessor", { enumerable: true, get: function () { return applePanelsProcessor_1.ApplePanelsProcessor; } });
 var dotProcessor_1 = require("./dotProcessor");
@@ -29,3 +29,5 @@ var astericsGridProcessor_1 = require("./astericsGridProcessor");
 Object.defineProperty(exports, "AstericsGridProcessor", { enumerable: true, get: function () { return astericsGridProcessor_1.AstericsGridProcessor; } });
 var obfsetProcessor_1 = require("./obfsetProcessor");
 Object.defineProperty(exports, "ObfsetProcessor", { enumerable: true, get: function () { return obfsetProcessor_1.ObfsetProcessor; } });
+var gotalkNowProcessor_1 = require("./gotalkNowProcessor");
+Object.defineProperty(exports, "GotalkNowProcessor", { enumerable: true, get: function () { return gotalkNowProcessor_1.GotalkNowProcessor; } });

package/dist/processors/obfProcessor.js

@@ -691,7 +691,9 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
             });
             const manifest = {
                 format: OBF_FORMAT_VERSION,
-                root: tree.metadata.defaultHomePageId,
+                root: tree.metadata.defaultHomePageId
+                    ? this.getPageFilename(tree.metadata.defaultHomePageId, tree.metadata)
+                    : undefined,
                 paths: {
                     boards: Object.fromEntries(Object.entries(tree.pages).map(([id, page]) => [
                         id,
@@ -758,7 +760,9 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         if (Object.keys(tree.pages).length > 0) {
             const manifest = {
                 format: OBF_FORMAT_VERSION,
-                root: tree.metadata.defaultHomePageId,
+                root: tree.metadata.defaultHomePageId
+                    ? this.getPageFilename(tree.metadata.defaultHomePageId, tree.metadata)
+                    : undefined,
                 paths: {
                     boards: Object.fromEntries(Object.entries(tree.pages).map(([id, page]) => [
                         id,

package/dist/validation/gridsetValidator.d.ts

@@ -23,27 +23,20 @@ export declare class GridsetValidator extends BaseValidator {
      */
     private isZip;
     /**
-     * Validate a single XML file (legacy or exploded format)
+     * Validate a single grid.xml file (exploded/non-zip format)
      */
     private validateSingleXml;
     /**
      * Validate a ZIP archive (.gridset)
+     *
+     * Real Grid 3 archives do NOT contain a top-level gridset.xml. The required
+     * structure is: Settings0/settings.xml + FileMap.xml + Grids/<name>/grid.xml
+     * (+ optional Styles, images, thumbnails).
      */
     private validateZipArchive;
     /**
-     * Validate Gridset structure
+     * Validate a real Grid 3 <Grid> element (from grid.xml).
+     * Checks for GridGuid, Cells, and basic cell structure.
      */
-    private validateGridsetStructure;
-    /**
-     * Validate a single page
-     */
-    private validatePage;
-    /**
-     * Validate a single cell
-     */
-    private validateCell;
-    /**
-     * Validate color format (Grid3 uses ARGB format)
-     */
-    private isValidGrid3Color;
+    private validateGridStructure;
 }