craft-native 0.0.37

package/dist/api/db.d.ts

@@ -0,0 +1,427 @@
+/**
+ * @fileoverview Craft Database API
+ * @description Provides SQLite database access through the Craft bridge.
+ * Includes transaction support, table management, and a key-value store abstraction.
+ * @module @craft-native/api/db
+ *
+ * @example
+ * ```typescript
+ * import { openDatabase, KeyValueStore } from '@craft-native/api/db'
+ *
+ * // Open a database
+ * const myDb = await openDatabase('myapp.db')
+ *
+ * // Create a table
+ * await myDb.createTable('users', [
+ *   { name: 'id', type: 'INTEGER', primaryKey: true, autoIncrement: true },
+ *   { name: 'name', type: 'TEXT', notNull: true },
+ *   { name: 'email', type: 'TEXT', unique: true }
+ * ])
+ *
+ * // Insert data
+ * await myDb.execute('INSERT INTO users (name, email) VALUES (?, ?)', ['John', 'john@example.com'])
+ *
+ * // Query data
+ * const users = await myDb.query('SELECT * FROM users')
+ * ```
+ */
+import { EventEmitter } from 'events';
+import type { CraftDatabaseAPI } from '../types';
+/**
+ * Global emitter for `db:execute` audit events. Subscribe to log every SQL
+ * statement that goes through the SDK. The event payload is `{ name, sql,
+ * paramsCount, readOnly }` — params themselves are not included by default
+ * to avoid leaking secrets to logs.
+ *
+ * `setMaxListeners(0)` lifts the default 10-listener cap: analytics, the
+ * dev overlay, and tests routinely subscribe in parallel and the cap
+ * triggered spurious "MaxListenersExceeded" warnings without indicating
+ * an actual leak.
+ */
+export declare const dbAudit: EventEmitter;
+/**
+ * Validate a SQL identifier (table or column name) to prevent SQL injection
+ * and runaway identifiers. Only allows alphanumeric characters and
+ * underscores, with a length cap.
+ *
+ * @param name  The identifier to validate.
+ * @param kind  Human-readable label for error messages (`'table'` /
+ *              `'column'` / `'index'` …). Defaults to `'identifier'`.
+ */
+export declare function validateIdentifier(name: string, kind?: string): void;
+/**
+ * Back-compat alias for {@link validateIdentifier} when validating a table
+ * name. Existing call sites that say `validateTableName(...)` keep working.
+ */
+export declare function validateTableName(name: string): void;
+/**
+ * Encode a SQL literal for safe inclusion in a `DEFAULT` clause. Strings
+ * have their single quotes doubled per the SQL standard. Numbers are
+ * emitted verbatim (after `Number.isFinite` check). `null`/`undefined`
+ * become `NULL`. Booleans become `0`/`1`. Anything else throws — DEFAULT
+ * with a JSON object/array would silently misencode.
+ */
+export declare function encodeDefaultLiteral(value: unknown): string;
+/**
+ * Low-level database API implementation.
+ * Uses native SQLite through the Craft bridge.
+ * For most use cases, prefer the {@link Database} class or {@link KeyValueStore}.
+ *
+ * @example
+ * ```typescript
+ * import { db } from '@craft-native/api/db'
+ *
+ * // Execute a statement
+ * await db.execute('CREATE TABLE IF NOT EXISTS settings (key TEXT PRIMARY KEY, value TEXT)')
+ *
+ * // Query data
+ * const results = await db.query('SELECT * FROM settings WHERE key = ?', ['theme'])
+ * ```
+ */
+export declare const db: CraftDatabaseAPI;
+/**
+ * Create or open a SQLite database.
+ *
+ * @param name - Database name (will be stored as `{name}.sqlite` in app data directory)
+ * @returns Promise resolving to Database instance
+ *
+ * @example
+ * ```typescript
+ * const myDb = await openDatabase('myapp')
+ *
+ * // Database will be created at app data directory as 'myapp.sqlite'
+ * await myDb.createTable('notes', [
+ *   { name: 'id', type: 'INTEGER', primaryKey: true, autoIncrement: true },
+ *   { name: 'title', type: 'TEXT', notNull: true },
+ *   { name: 'content', type: 'TEXT' },
+ *   { name: 'created_at', type: 'INTEGER', default: Date.now() }
+ * ])
+ * ```
+ */
+export declare function openDatabase(name: string): Promise<Database>;
+/**
+ * Open a database in read-only mode. `execute()` on the returned instance
+ * rejects DDL/DML statements (`INSERT`, `UPDATE`, `DELETE`, `DROP`, etc.).
+ * Use this for analytics / reporting code paths where there is no reason
+ * for a SQL bug to be able to mutate state.
+ */
+export declare function openDatabaseReadOnly(name: string): Promise<Database>;
+/**
+ * SQLite database wrapper with extended functionality.
+ * Provides table management, transactions, and query helpers.
+ *
+ * @example
+ * ```typescript
+ * const db = new Database('myapp')
+ * await db.open()
+ *
+ * // Create table with schema
+ * await db.createTable('tasks', [
+ *   { name: 'id', type: 'INTEGER', primaryKey: true, autoIncrement: true },
+ *   { name: 'title', type: 'TEXT', notNull: true },
+ *   { name: 'completed', type: 'INTEGER', default: 0 }
+ * ])
+ *
+ * // Insert and get ID
+ * const result = await db.execute('INSERT INTO tasks (title) VALUES (?)', ['Buy groceries'])
+ * console.log('Created task with ID:', result.lastInsertId)
+ *
+ * // Query with type safety
+ * interface Task { id: number; title: string; completed: number }
+ * const tasks = await db.query<Task>('SELECT * FROM tasks')
+ *
+ * // Get single row
+ * const task = await db.get<Task>('SELECT * FROM tasks WHERE id = ?', [1])
+ *
+ * // Transaction helper
+ * await db.transaction(async () => {
+ *   await db.execute('UPDATE tasks SET completed = 1 WHERE id = ?', [1])
+ *   await db.execute('INSERT INTO activity_log (action) VALUES (?)', ['completed_task'])
+ * })
+ *
+ * await db.close()
+ * ```
+ */
+export declare class Database {
+    private name;
+    private isOpen;
+    private readOnly;
+    /** True while a `db.transaction(...)` callback is on the stack. Set
+     * before `BEGIN TRANSACTION` and cleared in the finally arm. Used to
+     * make the inevitable mistake of calling `beginTransaction()` inside
+     * `transaction()` (or vice versa) fail fast with a clear error. */
+    private _inTransactionHelper;
+    /**
+     * Create a new Database instance.
+     *
+     * @param name - Database name
+     * @param options.readOnly - When true, `execute()` rejects DDL/DML
+     *   statements (anything that would mutate the schema or data).
+     *   `query()` is unaffected. Defaults to false.
+     */
+    constructor(name: string, options?: {
+        readOnly?: boolean;
+    });
+    /** Whether this Database refuses mutating statements. */
+    isReadOnly(): boolean;
+    /**
+     * Open the database connection.
+     * Called automatically on first query if not explicitly opened.
+     *
+     * @returns Promise that resolves when connection is established
+     * @throws {Error} If not running in Craft environment
+     */
+    open(): Promise<void>;
+    /**
+     * Close the database connection.
+     * Should be called when done with the database to free resources.
+     *
+     * @returns Promise that resolves when connection is closed
+     */
+    close(): Promise<void>;
+    /**
+     * Execute a SQL statement and get result metadata.
+     *
+     * @param sql - SQL statement to execute
+     * @param params - Optional parameters for prepared statement
+     * @returns Promise resolving to ExecuteResult with rowsAffected and lastInsertId
+     *
+     * @example
+     * ```typescript
+     * const result = await db.execute(
+     *   'INSERT INTO users (name, email) VALUES (?, ?)',
+     *   ['John', 'john@example.com']
+     * )
+     * console.log(`Inserted user with ID: ${result.lastInsertId}`)
+     * console.log(`Rows affected: ${result.rowsAffected}`)
+     * ```
+     */
+    execute(sql: string, params?: unknown[]): Promise<ExecuteResult>;
+    /**
+     * Execute a query and return all matching rows.
+     *
+     * @typeParam T - Type of result rows
+     * @param sql - SQL SELECT statement
+     * @param params - Optional parameters for prepared statement
+     * @returns Promise resolving to array of typed results
+     *
+     * @example
+     * ```typescript
+     * interface User {
+     *   id: number
+     *   name: string
+     *   email: string
+     * }
+     *
+     * const users = await db.query<User>('SELECT * FROM users WHERE active = ?', [1])
+     * users.forEach(user => console.log(user.name))
+     * ```
+     */
+    query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;
+    /**
+     * Execute a query and return the first matching row.
+     *
+     * @typeParam T - Type of result row
+     * @param sql - SQL SELECT statement
+     * @param params - Optional parameters for prepared statement
+     * @returns Promise resolving to first row or null if no matches
+     *
+     * @example
+     * ```typescript
+     * const user = await db.get<User>('SELECT * FROM users WHERE id = ?', [1])
+     * if (user) {
+     *   console.log(`Found user: ${user.name}`)
+     * }
+  else {
+     *   console.log('User not found')
+     * }
+     * ```
+     */
+    get<T = unknown>(sql: string, params?: unknown[]): Promise<T | null>;
+    /**
+     * Execute a function within a transaction.
+     * Automatically commits on success, rolls back on error.
+     *
+     * NOTE: this method drives the transaction by emitting raw SQL
+     * (`BEGIN TRANSACTION` / `COMMIT` / `ROLLBACK`). The connection-level
+     * helpers `db.beginTransaction()` / `db.commit()` / `db.rollback()` use
+     * a separate native handler. Don't mix the two on the same connection —
+     * pick one style per code path. See `docs/db-transactions.md`.
+     *
+     * @typeParam T - Return type of transaction function
+     * @param fn - Async function containing database operations
+     * @returns Promise resolving to function's return value
+     * @throws Re-throws any error after rolling back
+     *
+     * @example
+     * ```typescript
+     * const orderId = await db.transaction(async () => {
+     *   const orderResult = await db.execute(
+     *     'INSERT INTO orders (user_id, total) VALUES (?, ?)',
+     *     [userId, total]
+     *   )
+     *
+     *   for (const item of items) {
+     *     await db.execute(
+     *       'INSERT INTO order_items (order_id, product_id, quantity) VALUES (?, ?, ?)',
+     *       [orderResult.lastInsertId, item.productId, item.quantity]
+     *     )
+     *   }
+     *
+     *   return orderResult.lastInsertId
+     * })
+     * ```
+     */
+    transaction<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Create a table with the specified schema.
+     * Uses CREATE TABLE IF NOT EXISTS, so safe to call multiple times.
+     *
+     * @param tableName - Name of the table to create
+     * @param columns - Array of column definitions
+     *
+     * @example
+     * ```typescript
+     * await db.createTable('products', [
+     *   { name: 'id', type: 'INTEGER', primaryKey: true, autoIncrement: true },
+     *   { name: 'name', type: 'TEXT', notNull: true },
+     *   { name: 'price', type: 'REAL', notNull: true },
+     *   { name: 'category', type: 'TEXT' },
+     *   { name: 'in_stock', type: 'INTEGER', default: 1 }
+     * ])
+     * ```
+     */
+    createTable(tableName: string, columns: TableColumn[]): Promise<void>;
+    /**
+     * Drop a table if it exists.
+     *
+     * @param tableName - Name of the table to drop
+     */
+    dropTable(tableName: string): Promise<void>;
+    /**
+     * Check if a table exists in the database.
+     *
+     * @param tableName - Name of the table to check
+     * @returns Promise resolving to true if table exists
+     */
+    tableExists(tableName: string): Promise<boolean>;
+}
+/**
+ * Result of an execute operation.
+ */
+export interface ExecuteResult {
+    /** Number of rows affected by the operation */
+    rowsAffected: number;
+    /** ID of the last inserted row (for INSERT operations) */
+    lastInsertId: number;
+}
+/**
+ * Column definition for createTable.
+ */
+export interface TableColumn {
+    /** Column name */
+    name: string;
+    /** SQLite data type */
+    type: 'TEXT' | 'INTEGER' | 'REAL' | 'BLOB' | 'NULL';
+    /** Mark as primary key */
+    primaryKey?: boolean;
+    /** Enable auto-increment (INTEGER PRIMARY KEY only) */
+    autoIncrement?: boolean;
+    /** Disallow NULL values */
+    notNull?: boolean;
+    /** Require unique values */
+    unique?: boolean;
+    /** Default value for column */
+    default?: unknown;
+}
+/**
+ * Simple key-value store backed by SQLite.
+ * Useful for settings, preferences, and cached data.
+ *
+ * @example
+ * ```typescript
+ * const db = await openDatabase('settings')
+ * const store = new KeyValueStore(db)
+ * await store.init()
+ *
+ * // Store values (automatically JSON serialized)
+ * await store.set('theme', 'dark')
+ * await store.set('user', { name: 'John', premium: true })
+ * await store.set('recentFiles', ['/doc1.txt', '/doc2.txt'])
+ *
+ * // Retrieve values
+ * const theme = await store.get<string>('theme') // 'dark'
+ * const user = await store.get<{ name: string; premium: boolean }>('user')
+ *
+ * // Check existence
+ * if (await store.has('lastSync')) {
+ *   const lastSync = await store.get<number>('lastSync')
+ * }
+ *
+ * // List all keys
+ * const allKeys = await store.keys()
+ *
+ * // Delete and clear
+ * await store.delete('tempData')
+ * await store.clear() // Remove all entries
+ * ```
+ */
+export declare class KeyValueStore {
+    private db;
+    private tableName;
+    /**
+     * Create a new KeyValueStore.
+     *
+     * @param db - Database instance to use
+     * @param tableName - Table name for storage (default: 'kv_store')
+     */
+    constructor(db: Database, tableName?: string);
+    /**
+     * Initialize the key-value store table.
+     * Must be called before using other methods.
+     */
+    init(): Promise<void>;
+    /**
+     * Get a value by key.
+     * Returns null if key doesn't exist.
+     *
+     * @typeParam T - Expected type of the value
+     * @param key - Key to retrieve
+     * @returns Promise resolving to value or null
+     */
+    get<T = unknown>(key: string): Promise<T | null>;
+    /**
+     * Set a value for a key.
+     * Creates new entry or updates existing one.
+     * Values are automatically JSON serialized.
+     *
+     * @param key - Key to set
+     * @param value - Value to store (will be JSON serialized)
+     */
+    set(key: string, value: unknown): Promise<void>;
+    /**
+     * Delete a key from the store.
+     *
+     * @param key - Key to delete
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Check if a key exists.
+     *
+     * @param key - Key to check
+     * @returns Promise resolving to true if key exists
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Get all keys in the store.
+     *
+     * @returns Promise resolving to array of keys
+     */
+    keys(): Promise<string[]>;
+    /**
+     * Clear all entries from the store.
+     */
+    clear(): Promise<void>;
+}
+export default db;
+//# sourceMappingURL=db.d.ts.map

package/dist/api/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/api/db.ts"],"names":[],"mappings":"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"}

package/dist/api/dialog.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Craft Dialog API
+ * Native file pickers and alert dialogs
+ * @module @craft-native/api/dialog
+ */
+/**
+ * File filter for open/save dialogs
+ */
+export interface FileFilter {
+    /** Filter display name (e.g., "Images") */
+    name: string;
+    /** File extensions without dots (e.g., ["png", "jpg", "gif"]) */
+    extensions: string[];
+}
+/**
+ * Options for open file dialog
+ */
+export interface OpenDialogOptions {
+    /** Dialog title */
+    title?: string;
+    /** Default path to open */
+    defaultPath?: string;
+    /** File filters */
+    filters?: FileFilter[];
+    /** Allow selecting multiple files */
+    multiple?: boolean;
+    /** Allow selecting directories */
+    directory?: boolean;
+    /** Show hidden files */
+    showHiddenFiles?: boolean;
+}
+/**
+ * Options for save file dialog
+ */
+export interface SaveDialogOptions {
+    /** Dialog title */
+    title?: string;
+    /** Default path to save */
+    defaultPath?: string;
+    /** Default file name */
+    defaultName?: string;
+    /** File filters */
+    filters?: FileFilter[];
+    /** Show hidden files */
+    showHiddenFiles?: boolean;
+}
+/**
+ * Alert dialog style
+ */
+export type AlertStyle = 'info' | 'warning' | 'critical';
+/**
+ * Options for alert dialog
+ */
+export interface AlertOptions {
+    /** Dialog title (main message) */
+    title: string;
+    /** Dialog message (secondary text) */
+    message?: string;
+    /** Alert style */
+    style?: AlertStyle;
+    /** Custom button labels */
+    buttons?: string[];
+}
+/**
+ * Options for confirm dialog
+ */
+export interface ConfirmOptions {
+    /** Dialog title (main message) */
+    title: string;
+    /** Dialog message (secondary text) */
+    message?: string;
+    /** OK button label */
+    okLabel?: string;
+    /** Cancel button label */
+    cancelLabel?: string;
+}
+/**
+ * Result from open dialog
+ */
+export interface OpenDialogResult {
+    /** Whether a file was selected (not cancelled) */
+    canceled: boolean;
+    /** Selected file paths */
+    filePaths: string[];
+}
+/**
+ * Result from save dialog
+ */
+export interface SaveDialogResult {
+    /** Whether save was cancelled */
+    canceled: boolean;
+    /** Selected file path */
+    filePath?: string;
+}
+/**
+ * Show open file dialog
+ * @param options Dialog options
+ * @returns Selected file path(s)
+ */
+export declare function openFile(options?: OpenDialogOptions): Promise<OpenDialogResult>;
+/**
+ * Show open folder dialog
+ * @param options Dialog options
+ * @returns Selected folder path
+ */
+export declare function openFolder(options?: Omit<OpenDialogOptions, 'multiple' | 'directory'>): Promise<OpenDialogResult>;
+/**
+ * Show save file dialog
+ * @param options Dialog options
+ * @returns Selected save path
+ */
+export declare function saveFile(options?: SaveDialogOptions): Promise<SaveDialogResult>;
+/**
+ * Show alert dialog
+ * @param options Alert options or just a message string
+ * @returns Button index that was clicked
+ */
+export declare function showAlert(options: AlertOptions | string): Promise<number>;
+/**
+ * Show confirm dialog with OK/Cancel buttons
+ * @param options Confirm options or just a message string
+ * @returns true if OK was clicked, false if cancelled
+ */
+export declare function showConfirm(options: ConfirmOptions | string): Promise<boolean>;
+/**
+ * Show prompt dialog with text input
+ * @param title Dialog title
+ * @param defaultValue Default input value
+ * @returns User input or null if cancelled
+ */
+export declare function showPrompt(title: string, defaultValue?: string): Promise<string | null>;
+export declare const dialog: {
+    openFile: typeof openFile;
+    openFolder: typeof openFolder;
+    saveFile: typeof saveFile;
+    showAlert: typeof showAlert;
+    showConfirm: typeof showConfirm;
+    showPrompt: typeof showPrompt;
+};
+export default dialog;
+//# sourceMappingURL=dialog.d.ts.map

package/dist/api/dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../src/api/dialog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwBH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,iEAAiE;IACjE,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mBAAmB;IACnB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAA;IACtB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,kCAAkC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,wBAAwB;IACxB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mBAAmB;IACnB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAA;IACtB,wBAAwB;IACxB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAA;AAExD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kBAAkB;IAClB,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAA;IACjB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,QAAQ,EAAE,OAAO,CAAA;IACjB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAMD;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgBzF;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,WAAW,CAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAc3H;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAczF;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB/E;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAcpF;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAa7F;AAMD,eAAO,MAAM,MAAM,EAAE;IACnB,QAAQ,EAAE,OAAO,QAAQ,CAAA;IACzB,UAAU,EAAE,OAAO,UAAU,CAAA;IAC7B,QAAQ,EAAE,OAAO,QAAQ,CAAA;IACzB,SAAS,EAAE,OAAO,SAAS,CAAA;IAC3B,WAAW,EAAE,OAAO,WAAW,CAAA;IAC/B,UAAU,EAAE,OAAO,UAAU,CAAA;CAQ9B,CAAA;AAED,eAAe,MAAM,CAAA"}