@willwade/aac-processors 0.0.10 → 0.0.12

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/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;

package/dist/processors/gridset/pluginTypes.js

@@ -0,0 +1,285 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUTOCONTENT_TYPES = exports.LIVECELL_TYPES = exports.WORKSPACE_TYPES = exports.Grid3CellType = void 0;
+exports.getCellTypeDisplayName = getCellTypeDisplayName;
+exports.detectPluginCellType = detectPluginCellType;
+exports.isWorkspaceCell = isWorkspaceCell;
+exports.isLiveCell = isLiveCell;
+exports.isAutoContentCell = isAutoContentCell;
+exports.isRegularCell = isRegularCell;
+/**
+ * Cell types in Grid 3
+ */
+var Grid3CellType;
+(function (Grid3CellType) {
+    Grid3CellType["Regular"] = "regular";
+    Grid3CellType["Workspace"] = "workspace";
+    Grid3CellType["LiveCell"] = "livecell";
+    Grid3CellType["AutoContent"] = "autocontent";
+})(Grid3CellType || (exports.Grid3CellType = Grid3CellType = {}));
+/**
+ * Known workspace types in Grid 3
+ */
+exports.WORKSPACE_TYPES = {
+    CHAT: 'Chat',
+    EMAIL: 'Email',
+    WORD_PROCESSOR: 'WordProcessor',
+    PHONE: 'Phone',
+    SMS: 'Sms',
+    WEB_BROWSER: 'WebBrowser',
+    COMPUTER_CONTROL: 'ComputerControl',
+    CALCULATOR: 'Calculator',
+    TIMER: 'Timer',
+    MUSIC_VIDEO: 'MusicVideo',
+    PHOTOS: 'Photos',
+    CONTACTS: 'Contacts',
+    INTERACTIVE_LEARNING: 'InteractiveLearning',
+    MESSAGE_BANKING: 'MessageBanking',
+    ENVIRONMENT_CONTROL: 'EnvironmentControl',
+    SETTINGS: 'Settings',
+};
+/**
+ * Known live cell types in Grid 3
+ */
+exports.LIVECELL_TYPES = {
+    DIGITAL_CLOCK: 'DigitalClock',
+    ANALOG_CLOCK: 'AnalogClock',
+    DATE_DISPLAY: 'DateDisplay',
+    PUBLIC_VOLUME: 'PublicVolume',
+    PUBLIC_SPEED: 'PublicSpeed',
+    PUBLIC_VOICE: 'PublicVoice',
+    MESSAGES: 'Messages',
+    BATTERY: 'Battery',
+    WIFI_STRENGTH: 'WifiStrength',
+    BLUETOOTH_STATUS: 'BluetoothStatus',
+};
+/**
+ * Known auto content types in Grid 3
+ */
+exports.AUTOCONTENT_TYPES = {
+    CHANGE_PUBLIC_VOICE: 'ChangePublicVoice',
+    CHANGE_PUBLIC_SPEED: 'ChangePublicSpeed',
+    EMAIL_CONTACTS: 'EmailContacts',
+    EMAIL_RECIPIENTS: 'EmailRecipients',
+    PHONE_CONTACTS: 'PhoneContacts',
+    SMS_CONTACTS: 'SmsContacts',
+    WEB_FAVORITES: 'WebFavorites',
+    WEB_HISTORY: 'WebHistory',
+    PREDICTION: 'Prediction',
+    GRAMMAR: 'Grammar',
+    CONTEXTUAL: 'Contextual',
+};
+/**
+ * Human-readable names for cell types
+ */
+function getCellTypeDisplayName(cellType) {
+    switch (cellType) {
+        case Grid3CellType.Workspace:
+            return 'Workspace';
+        case Grid3CellType.LiveCell:
+            return 'Live Cell';
+        case Grid3CellType.AutoContent:
+            return 'Auto Content';
+        case Grid3CellType.Regular:
+            return 'Regular';
+        default:
+            return 'Unknown';
+    }
+}
+/**
+ * Detect plugin cell type from Grid 3 cell content
+ *
+ * @param content - Grid 3 cell content object
+ * @returns Plugin metadata with detected type
+ */
+function detectPluginCellType(content) {
+    if (!content) {
+        return { cellType: Grid3CellType.Regular };
+    }
+    const contentType = content.ContentType || content.contenttype || content.ContentType;
+    const contentSubType = content.ContentSubType || content.contentsubtype || content.ContentSubType;
+    // Workspace cells - full editing workspaces
+    if (contentType === 'Workspace') {
+        return {
+            cellType: Grid3CellType.Workspace,
+            subType: contentSubType || undefined,
+            pluginId: inferWorkspacePlugin(String(contentSubType || '')),
+            displayName: contentSubType ? `${contentSubType} Workspace` : 'Workspace',
+        };
+    }
+    // LiveCell detection - dynamic content displays
+    if (contentType === 'LiveCell') {
+        return {
+            cellType: Grid3CellType.LiveCell,
+            liveCellType: contentSubType || undefined,
+            pluginId: inferLiveCellPlugin(String(contentSubType || '')),
+            displayName: contentSubType || 'Live Cell',
+        };
+    }
+    // AutoContent detection - dynamic word/content suggestions
+    if (contentType === 'AutoContent') {
+        const autoContentType = extractAutoContentType(content);
+        return {
+            cellType: Grid3CellType.AutoContent,
+            autoContentType: autoContentType || undefined,
+            pluginId: inferAutoContentPlugin(autoContentType),
+            displayName: autoContentType || 'Auto Content',
+        };
+    }
+    // Regular cell
+    return {
+        cellType: Grid3CellType.Regular,
+    };
+}
+/**
+ * Extract auto content type from AutoContent.Activate command
+ */
+function extractAutoContentType(content) {
+    const commands = content.Commands?.Command || content.commands?.command;
+    if (!commands)
+        return undefined;
+    const commandArr = Array.isArray(commands) ? commands : [commands];
+    for (const command of commandArr) {
+        const commandId = command['@_ID'] || command.ID || command.id;
+        if (commandId === 'AutoContent.Activate') {
+            const parameters = command.Parameter || command.parameter;
+            const paramArr = Array.isArray(parameters) ? parameters : parameters ? [parameters] : [];
+            for (const param of paramArr) {
+                const key = param['@_Key'] || param.Key || param.key;
+                if (key === 'autocontenttype') {
+                    return String(param['#text'] || param.text || param.value || '');
+                }
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Infer plugin ID from workspace subtype
+ */
+function inferWorkspacePlugin(subType) {
+    if (!subType)
+        return undefined;
+    const normalized = subType.toLowerCase();
+    if (normalized.includes('chat'))
+        return 'chat';
+    if (normalized.includes('email') || normalized.includes('mail'))
+        return 'email';
+    if (normalized.includes('word') || normalized.includes('processor'))
+        return 'wordprocessor';
+    if (normalized.includes('phone'))
+        return 'phone';
+    if (normalized.includes('sms') || normalized.includes('text'))
+        return 'sms';
+    if (normalized.includes('web') || normalized.includes('browser'))
+        return 'webbrowser';
+    if (normalized.includes('computer') || normalized.includes('control'))
+        return 'computercontrol';
+    if (normalized.includes('calculator') || normalized.includes('calc'))
+        return 'calculator';
+    if (normalized.includes('timer') || normalized.includes('stopwatch'))
+        return 'timer';
+    if (normalized.includes('music') || normalized.includes('video'))
+        return 'musicvideo';
+    if (normalized.includes('photo') || normalized.includes('image'))
+        return 'photos';
+    if (normalized.includes('contact'))
+        return 'contacts';
+    if (normalized.includes('learning'))
+        return 'interactivelearning';
+    if (normalized.includes('message') && normalized.includes('bank'))
+        return 'messagebanking';
+    if (normalized.includes('env') || normalized.includes('ir'))
+        return 'environmentcontrol';
+    if (normalized.includes('setting'))
+        return 'settings';
+    return undefined;
+}
+/**
+ * Infer plugin ID from live cell type
+ */
+function inferLiveCellPlugin(liveCellType) {
+    if (!liveCellType)
+        return undefined;
+    const normalized = liveCellType.toLowerCase();
+    if (normalized.includes('clock') || normalized.includes('time') || normalized.includes('date')) {
+        return 'clock';
+    }
+    if (normalized.includes('volume'))
+        return 'speech';
+    if (normalized.includes('speed'))
+        return 'speech';
+    if (normalized.includes('voice'))
+        return 'speech';
+    if (normalized.includes('message'))
+        return 'chat';
+    if (normalized.includes('battery'))
+        return 'settings';
+    if (normalized.includes('wifi') || normalized.includes('network'))
+        return 'settings';
+    if (normalized.includes('bluetooth'))
+        return 'settings';
+    return undefined;
+}
+/**
+ * Infer plugin ID from auto content type
+ */
+function inferAutoContentPlugin(autoContentType) {
+    if (!autoContentType)
+        return undefined;
+    const normalized = autoContentType.toLowerCase();
+    if (normalized.includes('voice') || normalized.includes('speed'))
+        return 'speech';
+    if (normalized.includes('email') || normalized.includes('mail'))
+        return 'email';
+    if (normalized.includes('phone'))
+        return 'phone';
+    if (normalized.includes('sms') || normalized.includes('text'))
+        return 'sms';
+    if (normalized.includes('web') ||
+        normalized.includes('favorite') ||
+        normalized.includes('history')) {
+        return 'webbrowser';
+    }
+    if (normalized.includes('prediction'))
+        return 'prediction';
+    if (normalized.includes('grammar'))
+        return 'grammar';
+    if (normalized.includes('context'))
+        return 'autocontent';
+    return undefined;
+}
+/**
+ * Check if a cell is a workspace cell
+ */
+function isWorkspaceCell(metadata) {
+    return metadata.cellType === Grid3CellType.Workspace;
+}
+/**
+ * Check if a cell is a live cell
+ */
+function isLiveCell(metadata) {
+    return metadata.cellType === Grid3CellType.LiveCell;
+}
+/**
+ * Check if a cell is an auto content cell
+ */
+function isAutoContentCell(metadata) {
+    return metadata.cellType === Grid3CellType.AutoContent;
+}
+/**
+ * Check if a cell is a regular (non-plugin) cell
+ */
+function isRegularCell(metadata) {
+    return metadata.cellType === Grid3CellType.Regular;
+}

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

@@ -1,3 +1,4 @@
+import { parseSymbolReference } from './symbols';
 export declare function resolveGrid3CellImage(zip: any, args: {
     baseDir: string;
     imageName?: string;
@@ -6,3 +7,15 @@ export declare function resolveGrid3CellImage(zip: any, args: {
     dynamicFiles?: string[];
     builtinHandler?: (name: string) => string | null;
 }, zipEntries?: any[]): string | null;
+/**
+ * Check if an image reference is a symbol library reference
+ * @param imageName - Image reference from Grid 3
+ * @returns True if it's a symbol library reference
+ */
+export declare function isSymbolLibraryReference(imageName?: string): boolean;
+/**
+ * Parse a symbol library reference from an image name
+ * @param imageName - Image reference from Grid 3
+ * @returns Parsed reference or null if not a symbol reference
+ */
+export declare function parseImageSymbolReference(imageName: string): ReturnType<typeof parseSymbolReference> | null;