@willwade/aac-processors 0.0.9 → 0.0.11

package/dist/processors/gridset/helpers.d.ts

@@ -15,7 +15,7 @@ export declare function getAllowedImageEntries(tree: AACTree): Set<string>;
  * @param entryPath Entry name inside the zip
  * @returns Image data buffer or null if not found
  */
-export declare function openImage(gridsetBuffer: Buffer, entryPath: string): Buffer | null;
+export declare function openImage(gridsetBuffer: Buffer, entryPath: string, password?: string | undefined): Buffer | null;
 /**
  * Generate a random GUID for Grid3 elements
  * Grid3 uses GUIDs for grid identification

package/dist/processors/gridset/helpers.js

@@ -49,6 +49,7 @@ const path = __importStar(require("path"));
 const child_process_1 = require("child_process");
 const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
 const dotnetTicks_1 = require("../../utils/dotnetTicks");
+const password_1 = require("./password");
 function normalizeZipPath(p) {
     const unified = p.replace(/\\/g, '/');
     try {
@@ -94,10 +95,11 @@ function getAllowedImageEntries(tree) {
  * @param entryPath Entry name inside the zip
  * @returns Image data buffer or null if not found
  */
-function openImage(gridsetBuffer, entryPath) {
+function openImage(gridsetBuffer, entryPath, password = (0, password_1.resolveGridsetPasswordFromEnv)()) {
     const zip = new adm_zip_1.default(gridsetBuffer);
+    const entries = (0, password_1.getZipEntriesWithPassword)(zip, password);
     const want = normalizeZipPath(entryPath);
-    const entry = zip.getEntries().find((e) => normalizeZipPath(e.entryName) === want);
+    const entry = entries.find((e) => normalizeZipPath(e.entryName) === want);
     if (!entry)
         return null;
     return entry.getData();
@@ -292,7 +294,7 @@ function findGrid3Vocabularies(userName) {
             if (!entry.isFile())
                 continue;
             const ext = path.extname(entry.name).toLowerCase();
-            if (ext === '.gridset' || ext === '.grd' || ext === '.grdl') {
+            if (ext === '.gridset' || ext === '.gridsetx' || ext === '.grd' || ext === '.grdl') {
                 results.push({
                     userName: userDir.name,
                     gridsetPath: path.win32.join(gridSetsDir, entry.name),

package/dist/processors/gridset/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Grid 3 Enhanced Support Module
+ *
+ * This module exports all enhanced Grid 3 functionality including:
+ * - Cell shape detection and support
+ * - Plugin cell type detection (Workspace, LiveCell, AutoContent)
+ * - Comprehensive command definitions and detection
+ * - Color utilities and style helpers
+ * - Image resolution helpers
+ */
+export { CellBackgroundShape, SHAPE_NAMES, type Grid3Style, DEFAULT_GRID3_STYLES, CATEGORY_STYLES, createDefaultStylesXml, createCategoryStyle, } from './styleHelpers';
+export { detectPluginCellType, type Grid3PluginMetadata, Grid3CellType, WORKSPACE_TYPES, LIVECELL_TYPES, AUTOCONTENT_TYPES, getCellTypeDisplayName, isWorkspaceCell, isLiveCell, isAutoContentCell, isRegularCell, } from './pluginTypes';
+export { detectCommand, getCommandDefinition, getCommandsByPlugin, getCommandsByCategory, getAllCommandIds, getAllPluginIds, extractCommandParameters, GRID3_COMMANDS, type Grid3CommandDefinition, type CommandParameter, type ExtractedParameters, Grid3CommandCategory, } from './commands';
+import { CellBackgroundShape } from './styleHelpers';
+import { Grid3CellType } from './pluginTypes';
+import { Grid3CommandCategory } from './commands';
+export { ensureAlphaChannel, darkenColor, lightenColor, hexToRgba, rgbaToHex } from './colorUtils';
+export { resolveGridsetPassword, getZipEntriesWithPassword, resolveGridsetPasswordFromEnv, } from './password';
+export { getPageTokenImageMap, getAllowedImageEntries, openImage, generateGrid3Guid, createSettingsXml, createFileMapXml, getCommonDocumentsPath, findGrid3UserPaths, findGrid3HistoryDatabases, findGrid3Vocabularies, findGrid3UserHistory, findGrid3Users, isGrid3Installed, readGrid3History, readGrid3HistoryForUser, readAllGrid3History, type Grid3UserPath, type Grid3VocabularyPath, type Grid3HistoryEntry, } from './helpers';
+export { parseSymbolReference, isSymbolReference, resolveSymbolReference, getAvailableSymbolLibraries, getSymbolLibraryInfo, extractSymbolReferences, analyzeSymbolUsage, createSymbolReference, getSymbolLibraryName, getSymbolPath, isKnownSymbolLibrary, getSymbolLibraryDisplayName, getDefaultGrid3Path, getSymbolLibrariesDir, getSymbolSearchIndexesDir, symbolReferenceToFilename, SYMBOL_LIBRARIES, type SymbolReference, type SymbolLibraryInfo, type SymbolResolutionOptions, type SymbolResolutionResult, type SymbolUsageStats, type SymbolLibraryName, } from './symbols';
+export { getSymbolsDir, getSymbolSearchDir } from './symbols';
+export { resolveGrid3CellImage, isSymbolLibraryReference, parseImageSymbolReference, } from './resolver';
+export { extractButtonImage, extractSymbolLibraryImage, convertToAstericsImage, analyzeSymbolExtraction, suggestExtractionStrategy, exportSymbolReferencesToCsv, createSymbolManifest, type ExtractedImage, type SymbolExtractionOptions, type SymbolReport, type SymbolManifest, } from './symbolExtractor';
+export { parsePixFile, loadSearchIndexes, searchSymbols, searchSymbolsWithReferences, getSymbolFilename, getSymbolDisplayName, getAllSearchTerms, getSearchSuggestions, countLibrarySymbols, getSymbolSearchStats, type SymbolSearchResult, type SymbolSearchOptions, type LibrarySearchIndex, type SymbolSearchStats, } from './symbolSearch';
+/**
+ * Get all Grid 3 command IDs as a readonly array
+ * Useful for validation and autocomplete
+ */
+export declare const GRID3_COMMAND_IDS: readonly string[];
+/**
+ * Get all Grid 3 plugin IDs as a readonly array
+ */
+export declare const GRID3_PLUGIN_IDS: readonly string[];
+/**
+ * Grid 3 cell shapes enum values
+ */
+export declare const GRID3_CELL_SHAPES: readonly (string | CellBackgroundShape)[];
+/**
+ * Grid 3 cell types enum values
+ */
+export declare const GRID3_CELL_TYPES: readonly Grid3CellType[];
+/**
+ * Grid 3 command categories enum values
+ */
+export declare const GRID3_COMMAND_CATEGORIES: readonly Grid3CommandCategory[];

package/dist/processors/gridset/index.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * Grid 3 Enhanced Support Module
+ *
+ * This module exports all enhanced Grid 3 functionality including:
+ * - Cell shape detection and support
+ * - Plugin cell type detection (Workspace, LiveCell, AutoContent)
+ * - Comprehensive command definitions and detection
+ * - Color utilities and style helpers
+ * - Image resolution helpers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSymbolReference = exports.readAllGrid3History = exports.readGrid3HistoryForUser = exports.readGrid3History = exports.isGrid3Installed = exports.findGrid3Users = exports.findGrid3UserHistory = exports.findGrid3Vocabularies = exports.findGrid3HistoryDatabases = exports.findGrid3UserPaths = exports.getCommonDocumentsPath = exports.createFileMapXml = exports.createSettingsXml = exports.generateGrid3Guid = exports.openImage = exports.getAllowedImageEntries = exports.getPageTokenImageMap = exports.resolveGridsetPasswordFromEnv = exports.getZipEntriesWithPassword = exports.resolveGridsetPassword = exports.rgbaToHex = exports.hexToRgba = exports.lightenColor = exports.darkenColor = exports.ensureAlphaChannel = exports.Grid3CommandCategory = exports.GRID3_COMMANDS = exports.extractCommandParameters = exports.getAllPluginIds = exports.getAllCommandIds = exports.getCommandsByCategory = exports.getCommandsByPlugin = exports.getCommandDefinition = exports.detectCommand = exports.isRegularCell = exports.isAutoContentCell = exports.isLiveCell = exports.isWorkspaceCell = exports.getCellTypeDisplayName = exports.AUTOCONTENT_TYPES = exports.LIVECELL_TYPES = exports.WORKSPACE_TYPES = exports.Grid3CellType = exports.detectPluginCellType = exports.createCategoryStyle = exports.createDefaultStylesXml = exports.CATEGORY_STYLES = exports.DEFAULT_GRID3_STYLES = exports.SHAPE_NAMES = exports.CellBackgroundShape = void 0;
+exports.GRID3_COMMAND_CATEGORIES = exports.GRID3_CELL_TYPES = exports.GRID3_CELL_SHAPES = exports.GRID3_PLUGIN_IDS = exports.GRID3_COMMAND_IDS = exports.getSymbolSearchStats = exports.countLibrarySymbols = exports.getSearchSuggestions = exports.getAllSearchTerms = exports.getSymbolDisplayName = exports.getSymbolFilename = exports.searchSymbolsWithReferences = exports.searchSymbols = exports.loadSearchIndexes = exports.parsePixFile = exports.createSymbolManifest = exports.exportSymbolReferencesToCsv = exports.suggestExtractionStrategy = exports.analyzeSymbolExtraction = exports.convertToAstericsImage = exports.extractSymbolLibraryImage = exports.extractButtonImage = exports.parseImageSymbolReference = exports.isSymbolLibraryReference = exports.resolveGrid3CellImage = exports.getSymbolSearchDir = exports.getSymbolsDir = exports.SYMBOL_LIBRARIES = exports.symbolReferenceToFilename = exports.getSymbolSearchIndexesDir = exports.getSymbolLibrariesDir = exports.getDefaultGrid3Path = exports.getSymbolLibraryDisplayName = exports.isKnownSymbolLibrary = exports.getSymbolPath = exports.getSymbolLibraryName = exports.createSymbolReference = exports.analyzeSymbolUsage = exports.extractSymbolReferences = exports.getSymbolLibraryInfo = exports.getAvailableSymbolLibraries = exports.resolveSymbolReference = exports.isSymbolReference = void 0;
+// Style helpers
+var styleHelpers_1 = require("./styleHelpers");
+Object.defineProperty(exports, "CellBackgroundShape", { enumerable: true, get: function () { return styleHelpers_1.CellBackgroundShape; } });
+Object.defineProperty(exports, "SHAPE_NAMES", { enumerable: true, get: function () { return styleHelpers_1.SHAPE_NAMES; } });
+Object.defineProperty(exports, "DEFAULT_GRID3_STYLES", { enumerable: true, get: function () { return styleHelpers_1.DEFAULT_GRID3_STYLES; } });
+Object.defineProperty(exports, "CATEGORY_STYLES", { enumerable: true, get: function () { return styleHelpers_1.CATEGORY_STYLES; } });
+Object.defineProperty(exports, "createDefaultStylesXml", { enumerable: true, get: function () { return styleHelpers_1.createDefaultStylesXml; } });
+Object.defineProperty(exports, "createCategoryStyle", { enumerable: true, get: function () { return styleHelpers_1.createCategoryStyle; } });
+// Plugin cell type detection
+var pluginTypes_1 = require("./pluginTypes");
+Object.defineProperty(exports, "detectPluginCellType", { enumerable: true, get: function () { return pluginTypes_1.detectPluginCellType; } });
+Object.defineProperty(exports, "Grid3CellType", { enumerable: true, get: function () { return pluginTypes_1.Grid3CellType; } });
+Object.defineProperty(exports, "WORKSPACE_TYPES", { enumerable: true, get: function () { return pluginTypes_1.WORKSPACE_TYPES; } });
+Object.defineProperty(exports, "LIVECELL_TYPES", { enumerable: true, get: function () { return pluginTypes_1.LIVECELL_TYPES; } });
+Object.defineProperty(exports, "AUTOCONTENT_TYPES", { enumerable: true, get: function () { return pluginTypes_1.AUTOCONTENT_TYPES; } });
+Object.defineProperty(exports, "getCellTypeDisplayName", { enumerable: true, get: function () { return pluginTypes_1.getCellTypeDisplayName; } });
+Object.defineProperty(exports, "isWorkspaceCell", { enumerable: true, get: function () { return pluginTypes_1.isWorkspaceCell; } });
+Object.defineProperty(exports, "isLiveCell", { enumerable: true, get: function () { return pluginTypes_1.isLiveCell; } });
+Object.defineProperty(exports, "isAutoContentCell", { enumerable: true, get: function () { return pluginTypes_1.isAutoContentCell; } });
+Object.defineProperty(exports, "isRegularCell", { enumerable: true, get: function () { return pluginTypes_1.isRegularCell; } });
+// Command definitions and detection
+var commands_1 = require("./commands");
+Object.defineProperty(exports, "detectCommand", { enumerable: true, get: function () { return commands_1.detectCommand; } });
+Object.defineProperty(exports, "getCommandDefinition", { enumerable: true, get: function () { return commands_1.getCommandDefinition; } });
+Object.defineProperty(exports, "getCommandsByPlugin", { enumerable: true, get: function () { return commands_1.getCommandsByPlugin; } });
+Object.defineProperty(exports, "getCommandsByCategory", { enumerable: true, get: function () { return commands_1.getCommandsByCategory; } });
+Object.defineProperty(exports, "getAllCommandIds", { enumerable: true, get: function () { return commands_1.getAllCommandIds; } });
+Object.defineProperty(exports, "getAllPluginIds", { enumerable: true, get: function () { return commands_1.getAllPluginIds; } });
+Object.defineProperty(exports, "extractCommandParameters", { enumerable: true, get: function () { return commands_1.extractCommandParameters; } });
+Object.defineProperty(exports, "GRID3_COMMANDS", { enumerable: true, get: function () { return commands_1.GRID3_COMMANDS; } });
+Object.defineProperty(exports, "Grid3CommandCategory", { enumerable: true, get: function () { return commands_1.Grid3CommandCategory; } });
+// Import for local use in constant definitions
+const commands_2 = require("./commands");
+const styleHelpers_2 = require("./styleHelpers");
+const pluginTypes_2 = require("./pluginTypes");
+const commands_3 = require("./commands");
+// Color utilities
+var colorUtils_1 = require("./colorUtils");
+Object.defineProperty(exports, "ensureAlphaChannel", { enumerable: true, get: function () { return colorUtils_1.ensureAlphaChannel; } });
+Object.defineProperty(exports, "darkenColor", { enumerable: true, get: function () { return colorUtils_1.darkenColor; } });
+Object.defineProperty(exports, "lightenColor", { enumerable: true, get: function () { return colorUtils_1.lightenColor; } });
+Object.defineProperty(exports, "hexToRgba", { enumerable: true, get: function () { return colorUtils_1.hexToRgba; } });
+Object.defineProperty(exports, "rgbaToHex", { enumerable: true, get: function () { return colorUtils_1.rgbaToHex; } });
+// Password handling
+var password_1 = require("./password");
+Object.defineProperty(exports, "resolveGridsetPassword", { enumerable: true, get: function () { return password_1.resolveGridsetPassword; } });
+Object.defineProperty(exports, "getZipEntriesWithPassword", { enumerable: true, get: function () { return password_1.getZipEntriesWithPassword; } });
+Object.defineProperty(exports, "resolveGridsetPasswordFromEnv", { enumerable: true, get: function () { return password_1.resolveGridsetPasswordFromEnv; } });
+// Helper functions
+var helpers_1 = require("./helpers");
+Object.defineProperty(exports, "getPageTokenImageMap", { enumerable: true, get: function () { return helpers_1.getPageTokenImageMap; } });
+Object.defineProperty(exports, "getAllowedImageEntries", { enumerable: true, get: function () { return helpers_1.getAllowedImageEntries; } });
+Object.defineProperty(exports, "openImage", { enumerable: true, get: function () { return helpers_1.openImage; } });
+Object.defineProperty(exports, "generateGrid3Guid", { enumerable: true, get: function () { return helpers_1.generateGrid3Guid; } });
+Object.defineProperty(exports, "createSettingsXml", { enumerable: true, get: function () { return helpers_1.createSettingsXml; } });
+Object.defineProperty(exports, "createFileMapXml", { enumerable: true, get: function () { return helpers_1.createFileMapXml; } });
+Object.defineProperty(exports, "getCommonDocumentsPath", { enumerable: true, get: function () { return helpers_1.getCommonDocumentsPath; } });
+Object.defineProperty(exports, "findGrid3UserPaths", { enumerable: true, get: function () { return helpers_1.findGrid3UserPaths; } });
+Object.defineProperty(exports, "findGrid3HistoryDatabases", { enumerable: true, get: function () { return helpers_1.findGrid3HistoryDatabases; } });
+Object.defineProperty(exports, "findGrid3Vocabularies", { enumerable: true, get: function () { return helpers_1.findGrid3Vocabularies; } });
+Object.defineProperty(exports, "findGrid3UserHistory", { enumerable: true, get: function () { return helpers_1.findGrid3UserHistory; } });
+Object.defineProperty(exports, "findGrid3Users", { enumerable: true, get: function () { return helpers_1.findGrid3Users; } });
+Object.defineProperty(exports, "isGrid3Installed", { enumerable: true, get: function () { return helpers_1.isGrid3Installed; } });
+Object.defineProperty(exports, "readGrid3History", { enumerable: true, get: function () { return helpers_1.readGrid3History; } });
+Object.defineProperty(exports, "readGrid3HistoryForUser", { enumerable: true, get: function () { return helpers_1.readGrid3HistoryForUser; } });
+Object.defineProperty(exports, "readAllGrid3History", { enumerable: true, get: function () { return helpers_1.readAllGrid3History; } });
+// Symbol library handling
+var symbols_1 = require("./symbols");
+Object.defineProperty(exports, "parseSymbolReference", { enumerable: true, get: function () { return symbols_1.parseSymbolReference; } });
+Object.defineProperty(exports, "isSymbolReference", { enumerable: true, get: function () { return symbols_1.isSymbolReference; } });
+Object.defineProperty(exports, "resolveSymbolReference", { enumerable: true, get: function () { return symbols_1.resolveSymbolReference; } });
+Object.defineProperty(exports, "getAvailableSymbolLibraries", { enumerable: true, get: function () { return symbols_1.getAvailableSymbolLibraries; } });
+Object.defineProperty(exports, "getSymbolLibraryInfo", { enumerable: true, get: function () { return symbols_1.getSymbolLibraryInfo; } });
+Object.defineProperty(exports, "extractSymbolReferences", { enumerable: true, get: function () { return symbols_1.extractSymbolReferences; } });
+Object.defineProperty(exports, "analyzeSymbolUsage", { enumerable: true, get: function () { return symbols_1.analyzeSymbolUsage; } });
+Object.defineProperty(exports, "createSymbolReference", { enumerable: true, get: function () { return symbols_1.createSymbolReference; } });
+Object.defineProperty(exports, "getSymbolLibraryName", { enumerable: true, get: function () { return symbols_1.getSymbolLibraryName; } });
+Object.defineProperty(exports, "getSymbolPath", { enumerable: true, get: function () { return symbols_1.getSymbolPath; } });
+Object.defineProperty(exports, "isKnownSymbolLibrary", { enumerable: true, get: function () { return symbols_1.isKnownSymbolLibrary; } });
+Object.defineProperty(exports, "getSymbolLibraryDisplayName", { enumerable: true, get: function () { return symbols_1.getSymbolLibraryDisplayName; } });
+Object.defineProperty(exports, "getDefaultGrid3Path", { enumerable: true, get: function () { return symbols_1.getDefaultGrid3Path; } });
+Object.defineProperty(exports, "getSymbolLibrariesDir", { enumerable: true, get: function () { return symbols_1.getSymbolLibrariesDir; } });
+Object.defineProperty(exports, "getSymbolSearchIndexesDir", { enumerable: true, get: function () { return symbols_1.getSymbolSearchIndexesDir; } });
+Object.defineProperty(exports, "symbolReferenceToFilename", { enumerable: true, get: function () { return symbols_1.symbolReferenceToFilename; } });
+Object.defineProperty(exports, "SYMBOL_LIBRARIES", { enumerable: true, get: function () { return symbols_1.SYMBOL_LIBRARIES; } });
+// Backward compatibility aliases for old function names
+var symbols_2 = require("./symbols");
+Object.defineProperty(exports, "getSymbolsDir", { enumerable: true, get: function () { return symbols_2.getSymbolsDir; } });
+Object.defineProperty(exports, "getSymbolSearchDir", { enumerable: true, get: function () { return symbols_2.getSymbolSearchDir; } });
+// Image resolution
+var resolver_1 = require("./resolver");
+Object.defineProperty(exports, "resolveGrid3CellImage", { enumerable: true, get: function () { return resolver_1.resolveGrid3CellImage; } });
+Object.defineProperty(exports, "isSymbolLibraryReference", { enumerable: true, get: function () { return resolver_1.isSymbolLibraryReference; } });
+Object.defineProperty(exports, "parseImageSymbolReference", { enumerable: true, get: function () { return resolver_1.parseImageSymbolReference; } });
+// Symbol extraction and conversion
+var symbolExtractor_1 = require("./symbolExtractor");
+Object.defineProperty(exports, "extractButtonImage", { enumerable: true, get: function () { return symbolExtractor_1.extractButtonImage; } });
+Object.defineProperty(exports, "extractSymbolLibraryImage", { enumerable: true, get: function () { return symbolExtractor_1.extractSymbolLibraryImage; } });
+Object.defineProperty(exports, "convertToAstericsImage", { enumerable: true, get: function () { return symbolExtractor_1.convertToAstericsImage; } });
+Object.defineProperty(exports, "analyzeSymbolExtraction", { enumerable: true, get: function () { return symbolExtractor_1.analyzeSymbolExtraction; } });
+Object.defineProperty(exports, "suggestExtractionStrategy", { enumerable: true, get: function () { return symbolExtractor_1.suggestExtractionStrategy; } });
+Object.defineProperty(exports, "exportSymbolReferencesToCsv", { enumerable: true, get: function () { return symbolExtractor_1.exportSymbolReferencesToCsv; } });
+Object.defineProperty(exports, "createSymbolManifest", { enumerable: true, get: function () { return symbolExtractor_1.createSymbolManifest; } });
+// Symbol search functionality
+var symbolSearch_1 = require("./symbolSearch");
+Object.defineProperty(exports, "parsePixFile", { enumerable: true, get: function () { return symbolSearch_1.parsePixFile; } });
+Object.defineProperty(exports, "loadSearchIndexes", { enumerable: true, get: function () { return symbolSearch_1.loadSearchIndexes; } });
+Object.defineProperty(exports, "searchSymbols", { enumerable: true, get: function () { return symbolSearch_1.searchSymbols; } });
+Object.defineProperty(exports, "searchSymbolsWithReferences", { enumerable: true, get: function () { return symbolSearch_1.searchSymbolsWithReferences; } });
+Object.defineProperty(exports, "getSymbolFilename", { enumerable: true, get: function () { return symbolSearch_1.getSymbolFilename; } });
+Object.defineProperty(exports, "getSymbolDisplayName", { enumerable: true, get: function () { return symbolSearch_1.getSymbolDisplayName; } });
+Object.defineProperty(exports, "getAllSearchTerms", { enumerable: true, get: function () { return symbolSearch_1.getAllSearchTerms; } });
+Object.defineProperty(exports, "getSearchSuggestions", { enumerable: true, get: function () { return symbolSearch_1.getSearchSuggestions; } });
+Object.defineProperty(exports, "countLibrarySymbols", { enumerable: true, get: function () { return symbolSearch_1.countLibrarySymbols; } });
+Object.defineProperty(exports, "getSymbolSearchStats", { enumerable: true, get: function () { return symbolSearch_1.getSymbolSearchStats; } });
+/**
+ * Get all Grid 3 command IDs as a readonly array
+ * Useful for validation and autocomplete
+ */
+exports.GRID3_COMMAND_IDS = Object.freeze((0, commands_2.getAllCommandIds)());
+/**
+ * Get all Grid 3 plugin IDs as a readonly array
+ */
+exports.GRID3_PLUGIN_IDS = Object.freeze((0, commands_2.getAllPluginIds)());
+/**
+ * Grid 3 cell shapes enum values
+ */
+// eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+exports.GRID3_CELL_SHAPES = Object.freeze(Object.values(styleHelpers_2.CellBackgroundShape));
+/**
+ * Grid 3 cell types enum values
+ */
+// eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+exports.GRID3_CELL_TYPES = Object.freeze(Object.values(pluginTypes_2.Grid3CellType));
+/**
+ * Grid 3 command categories enum values
+ */
+// eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+exports.GRID3_COMMAND_CATEGORIES = Object.freeze(Object.values(commands_3.Grid3CommandCategory));

package/dist/processors/gridset/password.d.ts

@@ -0,0 +1,11 @@
+import { ProcessorOptions } from '../../core/baseProcessor';
+import AdmZip from 'adm-zip';
+/**
+ * Resolve the password to use for Grid3 archives.
+ * Preference order:
+ * 1. Explicit processor option
+ * 2. GRIDSET_PASSWORD env var
+ */
+export declare function resolveGridsetPassword(options?: ProcessorOptions, source?: string | Buffer): string | undefined;
+export declare function resolveGridsetPasswordFromEnv(): string | undefined;
+export declare function getZipEntriesWithPassword(zip: AdmZip, password?: string): AdmZip.IZipEntry[];

package/dist/processors/gridset/password.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveGridsetPassword = resolveGridsetPassword;
+exports.resolveGridsetPasswordFromEnv = resolveGridsetPasswordFromEnv;
+exports.getZipEntriesWithPassword = getZipEntriesWithPassword;
+const path_1 = __importDefault(require("path"));
+/**
+ * Resolve the password to use for Grid3 archives.
+ * Preference order:
+ * 1. Explicit processor option
+ * 2. GRIDSET_PASSWORD env var
+ */
+function resolveGridsetPassword(options, source) {
+    if (options?.gridsetPassword)
+        return options.gridsetPassword;
+    if (process.env.GRIDSET_PASSWORD)
+        return process.env.GRIDSET_PASSWORD;
+    if (typeof source === 'string') {
+        const ext = path_1.default.extname(source).toLowerCase();
+        if (ext === '.gridsetx')
+            return process.env.GRIDSET_PASSWORD;
+    }
+    return undefined;
+}
+function resolveGridsetPasswordFromEnv() {
+    return process.env.GRIDSET_PASSWORD;
+}
+// Wrapper to set the password before reading entries (typed getEntries lacks the optional arg)
+function getZipEntriesWithPassword(zip, password) {
+    if (password) {
+        return zip.getEntries(password);
+    }
+    return zip.getEntries();
+}

package/dist/processors/gridset/pluginTypes.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Grid 3 Plugin Cell Type Detection
+ *
+ * Grid 3 uses three special cell types for different plugin functionalities:
+ * - Workspace: Full editing workspaces (Email, Chat, WordProcessor, etc.)
+ * - LiveCell: Dynamic content displays (Clock, Volume indicators, etc.)
+ * - AutoContent: Dynamic word/content suggestions
+ *
+ * This module provides detection and metadata extraction for these cell types.
+ */
+/**
+ * Cell types in Grid 3
+ */
+export declare enum Grid3CellType {
+    Regular = "regular",
+    Workspace = "workspace",
+    LiveCell = "livecell",
+    AutoContent = "autocontent"
+}
+/**
+ * Plugin metadata extracted from Grid 3 cells
+ */
+export interface Grid3PluginMetadata {
+    cellType: Grid3CellType;
+    pluginId?: string;
+    subType?: string;
+    autoContentType?: string;
+    liveCellType?: string;
+    displayName?: string;
+}
+/**
+ * Known workspace types in Grid 3
+ */
+export declare const WORKSPACE_TYPES: {
+    readonly CHAT: "Chat";
+    readonly EMAIL: "Email";
+    readonly WORD_PROCESSOR: "WordProcessor";
+    readonly PHONE: "Phone";
+    readonly SMS: "Sms";
+    readonly WEB_BROWSER: "WebBrowser";
+    readonly COMPUTER_CONTROL: "ComputerControl";
+    readonly CALCULATOR: "Calculator";
+    readonly TIMER: "Timer";
+    readonly MUSIC_VIDEO: "MusicVideo";
+    readonly PHOTOS: "Photos";
+    readonly CONTACTS: "Contacts";
+    readonly INTERACTIVE_LEARNING: "InteractiveLearning";
+    readonly MESSAGE_BANKING: "MessageBanking";
+    readonly ENVIRONMENT_CONTROL: "EnvironmentControl";
+    readonly SETTINGS: "Settings";
+};
+/**
+ * Known live cell types in Grid 3
+ */
+export declare const LIVECELL_TYPES: {
+    readonly DIGITAL_CLOCK: "DigitalClock";
+    readonly ANALOG_CLOCK: "AnalogClock";
+    readonly DATE_DISPLAY: "DateDisplay";
+    readonly PUBLIC_VOLUME: "PublicVolume";
+    readonly PUBLIC_SPEED: "PublicSpeed";
+    readonly PUBLIC_VOICE: "PublicVoice";
+    readonly MESSAGES: "Messages";
+    readonly BATTERY: "Battery";
+    readonly WIFI_STRENGTH: "WifiStrength";
+    readonly BLUETOOTH_STATUS: "BluetoothStatus";
+};
+/**
+ * Known auto content types in Grid 3
+ */
+export declare const AUTOCONTENT_TYPES: {
+    readonly CHANGE_PUBLIC_VOICE: "ChangePublicVoice";
+    readonly CHANGE_PUBLIC_SPEED: "ChangePublicSpeed";
+    readonly EMAIL_CONTACTS: "EmailContacts";
+    readonly EMAIL_RECIPIENTS: "EmailRecipients";
+    readonly PHONE_CONTACTS: "PhoneContacts";
+    readonly SMS_CONTACTS: "SmsContacts";
+    readonly WEB_FAVORITES: "WebFavorites";
+    readonly WEB_HISTORY: "WebHistory";
+    readonly PREDICTION: "Prediction";
+    readonly GRAMMAR: "Grammar";
+    readonly CONTEXTUAL: "Contextual";
+};
+/**
+ * Human-readable names for cell types
+ */
+export declare function getCellTypeDisplayName(cellType: Grid3CellType): string;
+/**
+ * Detect plugin cell type from Grid 3 cell content
+ *
+ * @param content - Grid 3 cell content object
+ * @returns Plugin metadata with detected type
+ */
+export declare function detectPluginCellType(content: any): Grid3PluginMetadata;
+/**
+ * Check if a cell is a workspace cell
+ */
+export declare function isWorkspaceCell(metadata: Grid3PluginMetadata): boolean;
+/**
+ * Check if a cell is a live cell
+ */
+export declare function isLiveCell(metadata: Grid3PluginMetadata): boolean;
+/**
+ * Check if a cell is an auto content cell
+ */
+export declare function isAutoContentCell(metadata: Grid3PluginMetadata): boolean;
+/**
+ * Check if a cell is a regular (non-plugin) cell
+ */
+export declare function isRegularCell(metadata: Grid3PluginMetadata): boolean;