@willwade/aac-processors 0.0.10 → 0.0.11

package/dist/core/baseProcessor.d.ts

@@ -7,6 +7,9 @@ export interface ProcessorOptions {
     gridsetPassword?: string;
     customButtonFilter?: (button: AACButton) => boolean;
     preserveAllButtons?: boolean;
+    grid3SymbolDir?: string;
+    grid3Path?: string;
+    grid3Locale?: string;
 }
 export interface ExtractedString {
     string: string;

package/dist/core/treeStructure.d.ts

@@ -115,7 +115,7 @@ export declare class AACButton implements IAACButton {
     parameters?: {
         [key: string]: any;
     };
-    constructor({ id, label, message, targetPageId, semanticAction, audioRecording, style, contentType, contentSubType, image, resolvedImageEntry, x, y, columnSpan, rowSpan, scanBlocks, visibility, directActivate, parameters, type, action, }: {
+    constructor({ id, label, message, targetPageId, semanticAction, audioRecording, style, contentType, contentSubType, image, resolvedImageEntry, symbolLibrary, symbolPath, x, y, columnSpan, rowSpan, scanBlocks, visibility, directActivate, parameters, type, action, }: {
         id: string;
         label?: string;
         message?: string;
@@ -132,6 +132,8 @@ export declare class AACButton implements IAACButton {
         contentSubType?: string;
         image?: string;
         resolvedImageEntry?: string;
+        symbolLibrary?: string;
+        symbolPath?: string;
         x?: number;
         y?: number;
         columnSpan?: number;

package/dist/core/treeStructure.js

@@ -43,7 +43,7 @@ var AACSemanticIntent;
     AACSemanticIntent["PLATFORM_SPECIFIC"] = "PLATFORM_SPECIFIC";
 })(AACSemanticIntent || (exports.AACSemanticIntent = AACSemanticIntent = {}));
 class AACButton {
-    constructor({ id, label = '', message = '', targetPageId, semanticAction, audioRecording, style, contentType, contentSubType, image, resolvedImageEntry, x, y, columnSpan, rowSpan, scanBlocks, visibility, directActivate, parameters, 
+    constructor({ id, label = '', message = '', targetPageId, semanticAction, audioRecording, style, contentType, contentSubType, image, resolvedImageEntry, symbolLibrary, symbolPath, x, y, columnSpan, rowSpan, scanBlocks, visibility, directActivate, parameters, 
     // Legacy input support
     type, action, }) {
         this.id = id;
@@ -57,6 +57,8 @@ class AACButton {
         this.contentSubType = contentSubType;
         this.image = image;
         this.resolvedImageEntry = resolvedImageEntry;
+        this.symbolLibrary = symbolLibrary;
+        this.symbolPath = symbolPath;
         this.x = x;
         this.y = y;
         this.columnSpan = columnSpan;

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

@@ -54,6 +54,24 @@ export declare function toHexColor(value: string): string | undefined;
  * @returns Darkened hex color
  */
 export declare function darkenColor(hex: string, amount: number): string;
+/**
+ * Lighten a hex color by a specified amount
+ * @param hex - Hex color string
+ * @param amount - Amount to lighten (0-255)
+ * @returns Lightened hex color
+ */
+export declare function lightenColor(hex: string, amount: number): string;
+/**
+ * Convert hex color to RGBA object
+ * @param hex - Hex color string (#RRGGBB or #RRGGBBAA)
+ * @returns RGBA object with r, g, b, a properties (0-1 for alpha)
+ */
+export declare function hexToRgba(hex: string): {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+};
 /**
  * Normalize any color format to Grid3's 8-digit hex format
  * @param input - Color string in any supported format

package/dist/processors/gridset/colorUtils.js

@@ -16,6 +16,8 @@ exports.clampColorChannel = clampColorChannel;
 exports.clampAlpha = clampAlpha;
 exports.toHexColor = toHexColor;
 exports.darkenColor = darkenColor;
+exports.lightenColor = lightenColor;
+exports.hexToRgba = hexToRgba;
 exports.normalizeColor = normalizeColor;
 exports.ensureAlphaChannel = ensureAlphaChannel;
 /**
@@ -288,6 +290,40 @@ function darkenColor(hex, amount) {
     const newB = clamp(b - amount);
     return `#${channelToHex(newR)}${channelToHex(newG)}${channelToHex(newB)}${alpha.toUpperCase()}`;
 }
+/**
+ * Lighten a hex color by a specified amount
+ * @param hex - Hex color string
+ * @param amount - Amount to lighten (0-255)
+ * @returns Lightened hex color
+ */
+function lightenColor(hex, amount) {
+    const normalized = ensureAlphaChannel(hex).substring(1); // strip #
+    const rgb = normalized.substring(0, 6);
+    const alpha = normalized.substring(6) || 'FF';
+    const r = parseInt(rgb.substring(0, 2), 16);
+    const g = parseInt(rgb.substring(2, 4), 16);
+    const b = parseInt(rgb.substring(4, 6), 16);
+    const clamp = (val) => Math.max(0, Math.min(255, val));
+    const newR = clamp(r + amount);
+    const newG = clamp(g + amount);
+    const newB = clamp(b + amount);
+    return `#${channelToHex(newR)}${channelToHex(newG)}${channelToHex(newB)}${alpha.toUpperCase()}`;
+}
+/**
+ * Convert hex color to RGBA object
+ * @param hex - Hex color string (#RRGGBB or #RRGGBBAA)
+ * @returns RGBA object with r, g, b, a properties (0-1 for alpha)
+ */
+function hexToRgba(hex) {
+    const normalized = ensureAlphaChannel(hex).substring(1); // strip #
+    const rgb = normalized.substring(0, 6);
+    const alphaHex = normalized.substring(6) || 'FF';
+    const r = parseInt(rgb.substring(0, 2), 16);
+    const g = parseInt(rgb.substring(2, 4), 16);
+    const b = parseInt(rgb.substring(4, 6), 16);
+    const a = parseInt(alphaHex, 16) / 255;
+    return { r, g, b, a };
+}
 /**
  * Normalize any color format to Grid3's 8-digit hex format
  * @param input - Color string in any supported format

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

@@ -0,0 +1,103 @@
+/**
+ * Grid 3 Command Definitions and Detection System
+ *
+ * This module provides comprehensive metadata for all Grid 3 commands,
+ * organized by plugin/category. It enables:
+ * - Command detection and classification
+ * - Parameter extraction
+ * - Future extensibility for command execution
+ * - Semantic action mapping
+ *
+ * Grid 3 has 33+ plugins with 200+ commands. This catalog captures
+ * the most commonly used and important commands.
+ */
+/**
+ * Command categories in Grid 3
+ */
+export declare enum Grid3CommandCategory {
+    NAVIGATION = "navigation",
+    COMMUNICATION = "communication",
+    TEXT_EDITING = "text_editing",
+    COMPUTER_CONTROL = "computer_control",
+    WEB_BROWSER = "web_browser",
+    EMAIL = "email",
+    PHONE = "phone",
+    SMS = "sms",
+    SYSTEM = "system",
+    SETTINGS = "settings",
+    SPEECH = "speech",
+    AUTO_CONTENT = "auto_content",
+    ENVIRONMENT_CONTROL = "environment_control",
+    MOUSE = "mouse",
+    WINDOW = "window",
+    MEDIA = "media",
+    CUSTOM = "custom"
+}
+/**
+ * Parameter definition for commands
+ */
+export interface CommandParameter {
+    key: string;
+    type: 'string' | 'number' | 'boolean' | 'grid' | 'color' | 'font';
+    required: boolean;
+    description?: string;
+}
+/**
+ * Command metadata definition
+ */
+export interface Grid3CommandDefinition {
+    id: string;
+    category: Grid3CommandCategory;
+    pluginId: string;
+    displayName: string;
+    description: string;
+    parameters?: CommandParameter[];
+    platforms?: ('desktop' | 'ios' | 'medicare' | 'medicareBionics')[];
+    deprecated?: boolean;
+}
+/**
+ * Registry of all Grid 3 commands
+ * Key is command ID (e.g., 'Jump.To', 'Action.InsertText')
+ */
+export declare const GRID3_COMMANDS: Record<string, Grid3CommandDefinition>;
+/**
+ * Get command definition by ID
+ */
+export declare function getCommandDefinition(commandId: string): Grid3CommandDefinition | undefined;
+/**
+ * Check if a command ID is known
+ */
+export declare function isKnownCommand(commandId: string): boolean;
+/**
+ * Get all commands for a specific plugin
+ */
+export declare function getCommandsByPlugin(pluginId: string): Grid3CommandDefinition[];
+/**
+ * Get all commands in a category
+ */
+export declare function getCommandsByCategory(category: Grid3CommandCategory): Grid3CommandDefinition[];
+/**
+ * Get all command IDs
+ */
+export declare function getAllCommandIds(): string[];
+/**
+ * Get all plugin IDs that have commands
+ */
+export declare function getAllPluginIds(): string[];
+/**
+ * Extract parameters from a Grid 3 command object
+ */
+export interface ExtractedParameters {
+    [key: string]: string | number | boolean;
+}
+export declare function extractCommandParameters(command: any): ExtractedParameters;
+/**
+ * Detect and categorize a command from Grid 3
+ */
+export declare function detectCommand(commandObj: any): {
+    id: string;
+    definition?: Grid3CommandDefinition;
+    parameters: ExtractedParameters;
+    category: Grid3CommandCategory | 'unknown';
+    pluginId: string | 'unknown';
+};