@windagency/valora 2.0.1

package/dist/ui/prompt-adapter.interface.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Prompt Adapter Interface
+ *
+ * Library-agnostic interactive prompting interface.
+ * Implementations can use Inquirer, Prompts, Enquirer, or any other prompting library.
+ *
+ * This separation allows:
+ * - Multiple adapter implementations without coupling
+ * - Easy testing with mock adapters
+ * - Library migration without changing consumer code
+ */
+/**
+ * Question types supported by the prompt adapter
+ */
+export type QuestionType = 'checkbox' | 'confirm' | 'editor' | 'expand' | 'input' | 'list' | 'number' | 'password' | 'rawlist';
+/**
+ * Choice for list/checkbox questions
+ */
+export interface PromptChoice<T = unknown> {
+    checked?: boolean;
+    disabled?: boolean | string;
+    name?: string;
+    short?: string;
+    type?: 'choice' | 'separator';
+    value?: T;
+}
+/**
+ * Separator for list/checkbox questions
+ */
+export interface PromptSeparator {
+    line?: string;
+    type: 'separator';
+}
+/**
+ * Question configuration
+ */
+export interface PromptQuestion<T = unknown> {
+    /**
+     * Default value
+     */
+    default?: ((answers: T) => unknown) | unknown;
+    /**
+     * Choices for list/checkbox questions
+     */
+    choices?: ((answers: T) => Array<PromptChoice | PromptSeparator | string> | Promise<Array<PromptChoice | PromptSeparator | string>>) | Array<PromptChoice | PromptSeparator | string>;
+    /**
+     * Filter function to transform the answer
+     */
+    filter?: (input: unknown, answers: T) => Promise<unknown> | unknown;
+    /**
+     * Message to display
+     */
+    message: ((answers: T) => Promise<string> | string) | string;
+    /**
+     * Property name for the answer
+     */
+    name: string;
+    /**
+     * Prefix for the prompt
+     */
+    prefix?: string;
+    /**
+     * Suffix for the prompt
+     */
+    suffix?: string;
+    /**
+     * Transformer function to display the value
+     */
+    transformer?: (input: unknown, answers: T, flags: {
+        isFinal: boolean;
+    }) => Promise<string> | string;
+    /**
+     * Question type
+     */
+    type?: ((answers: T) => Promise<QuestionType> | QuestionType) | QuestionType;
+    /**
+     * Validation function
+     */
+    validate?: (input: unknown, answers?: T) => boolean | Promise<boolean | string> | string;
+    /**
+     * When function to conditionally show question
+     */
+    when?: ((answers: T) => boolean | Promise<boolean>) | boolean;
+    /**
+     * Page size for list questions
+     */
+    pageSize?: number;
+    /**
+     * Loop for list questions
+     */
+    loop?: boolean;
+}
+/**
+ * Prompt answers type
+ */
+export type PromptAnswers = Record<string, unknown>;
+/**
+ * Prompt Adapter Interface
+ *
+ * Defines the contract for interactive prompting implementations.
+ * All prompting operations should go through this interface.
+ */
+export interface PromptAdapter {
+    /**
+     * Prompt user with questions
+     *
+     * @param questions - Question or array of questions
+     * @param initialAnswers - Initial answers to pre-fill
+     * @returns Promise with answers
+     *
+     * @example
+     * const answers = await adapter.prompt([
+     *   {
+     *     type: 'input',
+     *     name: 'name',
+     *     message: 'What is your name?'
+     *   },
+     *   {
+     *     type: 'confirm',
+     *     name: 'continue',
+     *     message: 'Continue?',
+     *     default: true
+     *   }
+     * ]);
+     */
+    prompt<T = PromptAnswers>(questions: Array<PromptQuestion<T>> | PromptQuestion<T>, initialAnswers?: Partial<T>): Promise<T>;
+    /**
+     * Create a separator for list/checkbox questions
+     *
+     * @param line - Optional separator text
+     * @returns Separator object
+     *
+     * @example
+     * const separator = adapter.createSeparator('--- Options ---');
+     */
+    createSeparator(line?: string): PromptSeparator;
+    /**
+     * Get the underlying Separator class (for compatibility)
+     * @deprecated Use createSeparator() instead
+     */
+    Separator: new (line?: string) => PromptSeparator;
+}
+/**
+ * Get the singleton PromptAdapter instance
+ *
+ * @returns PromptAdapter instance
+ *
+ * @example
+ * import { getPromptAdapter } from './prompt-adapter.interface.js';
+ *
+ * const prompt = getPromptAdapter();
+ * const answers = await prompt.prompt([
+ *   {
+ *     type: 'input',
+ *     name: 'username',
+ *     message: 'Enter your username:'
+ *   }
+ * ]);
+ */
+export declare function getPromptAdapter(): PromptAdapter;
+/**
+ * Set a custom PromptAdapter implementation
+ * Useful for testing or switching to different prompting libraries
+ *
+ * @param adapter - The adapter instance to use
+ *
+ * @example
+ * // In tests
+ * import { setPromptAdapter } from './prompt-adapter.interface.js';
+ *
+ * const mockAdapter = new MockPromptAdapter();
+ * setPromptAdapter(mockAdapter);
+ */
+export declare function setPromptAdapter(adapter: PromptAdapter): void;
+//# sourceMappingURL=prompt-adapter.interface.d.ts.map

package/dist/ui/prompt-adapter.interface.d.ts.map

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

package/dist/ui/prompt-adapter.interface.js

@@ -0,0 +1,54 @@
+/**
+ * Prompt Adapter Interface
+ *
+ * Library-agnostic interactive prompting interface.
+ * Implementations can use Inquirer, Prompts, Enquirer, or any other prompting library.
+ *
+ * This separation allows:
+ * - Multiple adapter implementations without coupling
+ * - Easy testing with mock adapters
+ * - Library migration without changing consumer code
+ */
+import { createDefaultPromptAdapter } from './prompt-adapter.js';
+/**
+ * Singleton instance
+ */
+let adapterInstance = null;
+/**
+ * Get the singleton PromptAdapter instance
+ *
+ * @returns PromptAdapter instance
+ *
+ * @example
+ * import { getPromptAdapter } from './prompt-adapter.interface.js';
+ *
+ * const prompt = getPromptAdapter();
+ * const answers = await prompt.prompt([
+ *   {
+ *     type: 'input',
+ *     name: 'username',
+ *     message: 'Enter your username:'
+ *   }
+ * ]);
+ */
+export function getPromptAdapter() {
+    adapterInstance ??= createDefaultPromptAdapter();
+    return adapterInstance;
+}
+/**
+ * Set a custom PromptAdapter implementation
+ * Useful for testing or switching to different prompting libraries
+ *
+ * @param adapter - The adapter instance to use
+ *
+ * @example
+ * // In tests
+ * import { setPromptAdapter } from './prompt-adapter.interface.js';
+ *
+ * const mockAdapter = new MockPromptAdapter();
+ * setPromptAdapter(mockAdapter);
+ */
+export function setPromptAdapter(adapter) {
+    adapterInstance = adapter;
+}
+//# sourceMappingURL=prompt-adapter.interface.js.map

package/dist/ui/prompt-adapter.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-adapter.interface.js","sourceRoot":"","sources":["../../src/ui/prompt-adapter.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAuK9D;;GAEG;AACH,IAAI,eAAe,GAAyB,IAAI,CAAC;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB;IAC/B,eAAe,KAAK,0BAA0B,EAAE,CAAC;IACjD,OAAO,eAAgB,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAsB;IACtD,eAAe,GAAG,OAAO,CAAC;AAC3B,CAAC"}

package/dist/ui/prompt-adapter.js

@@ -0,0 +1,45 @@
+/**
+ * Inquirer Prompt Adapter - Inquirer.js implementation of the prompt adapter
+ *
+ * This is a concrete implementation of PromptAdapter using the Inquirer library.
+ * The interfaces are defined separately to allow for other implementations (prompts, enquirer, etc.)
+ *
+ * Benefits:
+ * - Implements library-agnostic PromptAdapter interface
+ * - Can be swapped with other implementations without changing consumers
+ * - Provides the familiar Inquirer API through the adapter
+ */
+import inquirer from 'inquirer';
+/**
+ * Inquirer Adapter Implementation
+ *
+ * Concrete implementation of PromptAdapter using the Inquirer library.
+ */
+export class InquirerAdapter {
+    /**
+     * Separator class reference
+     */
+    Separator = inquirer.Separator;
+    /**
+     * Prompt user with questions
+     */
+    async prompt(questions, initialAnswers) {
+        // Inquirer's prompt accepts both single question and array
+        // Type assertion needed due to incompatible generic constraints between our interface and Inquirer's
+        return inquirer.prompt(questions, initialAnswers);
+    }
+    /**
+     * Create a separator for list/checkbox questions
+     */
+    createSeparator(line) {
+        return new inquirer.Separator(line);
+    }
+}
+/**
+ * Default adapter instance factory
+ * This is used by the getPromptAdapter function in the interface
+ */
+export function createDefaultPromptAdapter() {
+    return new InquirerAdapter();
+}
+//# sourceMappingURL=prompt-adapter.js.map

package/dist/ui/prompt-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-adapter.js","sourceRoot":"","sources":["../../src/ui/prompt-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,QAAQ,MAAM,UAAU,CAAC;AAIhC;;;;GAIG;AACH,MAAM,OAAO,eAAe;IAC3B;;OAEG;IACH,SAAS,GAA2C,QAAQ,CAAC,SAEzC,CAAC;IAErB;;OAEG;IACH,KAAK,CAAC,MAAM,CACX,SAAuD,EACvD,cAA2B;QAE3B,2DAA2D;QAC3D,qGAAqG;QACrG,OAAO,QAAQ,CAAC,MAAM,CACrB,SAAkD,EAClD,cAAyC,CAC3B,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,IAAa;QAC5B,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAoB,CAAC;IACxD,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B;IACzC,OAAO,IAAI,eAAe,EAAE,CAAC;AAC9B,CAAC"}

package/dist/ui/spinner-adapter.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Ora Spinner Adapter - Ora implementation of the spinner adapter
+ *
+ * This is a concrete implementation of SpinnerAdapter using the ora library.
+ * The interfaces are defined separately to allow for other implementations (cli-spinners, nanospinner, etc.)
+ *
+ * Benefits:
+ * - Implements library-agnostic SpinnerAdapter interface
+ * - Can be swapped with other implementations without changing consumers
+ * - Provides the familiar ora API through the adapter
+ */
+import type { Spinner, SpinnerAdapter, SpinnerOptions } from './spinner-adapter.interface.js';
+/**
+ * Ora Adapter Implementation
+ *
+ * Concrete implementation of SpinnerAdapter using the ora library.
+ */
+export declare class OraAdapter implements SpinnerAdapter {
+    /**
+     * Create and return a spinner instance
+     */
+    create(options?: SpinnerOptions | string): Spinner;
+}
+/**
+ * Default adapter instance factory
+ * This is used by the getSpinnerAdapter function in the interface
+ */
+export declare function createDefaultSpinnerAdapter(): SpinnerAdapter;
+//# sourceMappingURL=spinner-adapter.d.ts.map

package/dist/ui/spinner-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner-adapter.d.ts","sourceRoot":"","sources":["../../src/ui/spinner-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE3F;;;;GAIG;AACH,qBAAa,UAAW,YAAW,cAAc;IAChD;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,OAAO;CAYlD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,cAAc,CAE5D"}

package/dist/ui/spinner-adapter.interface.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Spinner Adapter Interface
+ *
+ * Library-agnostic spinner/loading indicator interface.
+ * Implementations can use ora, cli-spinners, nanospinner, or any other spinner library.
+ *
+ * This separation allows:
+ * - Multiple adapter implementations without coupling
+ * - Easy testing with mock adapters
+ * - Library migration without changing consumer code
+ */
+/**
+ * Spinner color options
+ */
+export type SpinnerColor = 'black' | 'blue' | 'cyan' | 'gray' | 'green' | 'magenta' | 'red' | 'white' | 'yellow';
+/**
+ * Spinner configuration options
+ */
+export interface SpinnerOptions {
+    /**
+     * Color of the spinner
+     */
+    color?: SpinnerColor;
+    /**
+     * Text to display with the spinner
+     */
+    text?: string;
+    /**
+     * Prefix text before the spinner
+     */
+    prefixText?: string;
+    /**
+     * Spinner type/style
+     */
+    spinner?: string;
+    /**
+     * Hide cursor while spinning
+     */
+    hideCursor?: boolean;
+    /**
+     * Indent level
+     */
+    indent?: number;
+    /**
+     * Stream to write to (stdout/stderr)
+     */
+    stream?: NodeJS.WritableStream;
+    /**
+     * Disable spinner (show text only)
+     */
+    isEnabled?: boolean;
+    /**
+     * Enable/disable interactive features
+     */
+    isSilent?: boolean;
+    /**
+     * Discard stdin input while spinner is running
+     * Set to false to prevent terminal manipulation issues
+     */
+    discardStdin?: boolean;
+}
+/**
+ * Spinner instance interface
+ */
+export interface Spinner {
+    /**
+     * Text displayed with the spinner
+     */
+    text: string;
+    /**
+     * Prefix text before the spinner
+     */
+    prefixText: string;
+    /**
+     * Spinner color
+     */
+    color: SpinnerColor;
+    /**
+     * Whether the spinner is currently spinning
+     */
+    isSpinning: boolean;
+    /**
+     * Indent level
+     */
+    indent: number;
+    /**
+     * Start the spinner
+     *
+     * @param text - Optional text to display
+     * @returns This spinner instance
+     */
+    start(text?: string): Spinner;
+    /**
+     * Stop the spinner
+     *
+     * @returns This spinner instance
+     */
+    stop(): Spinner;
+    /**
+     * Mark spinner as successful with checkmark
+     *
+     * @param text - Optional success message
+     * @returns This spinner instance
+     */
+    succeed(text?: string): Spinner;
+    /**
+     * Mark spinner as failed with cross mark
+     *
+     * @param text - Optional failure message
+     * @returns This spinner instance
+     */
+    fail(text?: string): Spinner;
+    /**
+     * Mark spinner as warning with warning icon
+     *
+     * @param text - Optional warning message
+     * @returns This spinner instance
+     */
+    warn(text?: string): Spinner;
+    /**
+     * Mark spinner as info with info icon
+     *
+     * @param text - Optional info message
+     * @returns This spinner instance
+     */
+    info(text?: string): Spinner;
+    /**
+     * Stop and clear the spinner
+     *
+     * @returns This spinner instance
+     */
+    clear(): Spinner;
+    /**
+     * Render a frame (for manual control)
+     *
+     * @returns This spinner instance
+     */
+    render(): Spinner;
+    /**
+     * Stop and remove the spinner
+     */
+    stopAndPersist(options?: {
+        prefixText?: string;
+        symbol?: string;
+        text?: string;
+    }): Spinner;
+}
+/**
+ * Spinner Adapter Interface
+ *
+ * Defines the contract for spinner/loading indicator implementations.
+ * All spinner operations should go through this interface.
+ */
+export interface SpinnerAdapter {
+    /**
+     * Create and return a spinner instance
+     *
+     * @param options - Spinner configuration options
+     * @returns Spinner instance
+     *
+     * @example
+     * const spinner = adapter.create({ text: 'Loading...', color: 'cyan' });
+     * spinner.start();
+     * // ... do work
+     * spinner.succeed('Done!');
+     */
+    create(options?: SpinnerOptions | string): Spinner;
+}
+/**
+ * Get the singleton SpinnerAdapter instance
+ *
+ * @returns SpinnerAdapter instance
+ *
+ * @example
+ * import { getSpinnerAdapter } from './spinner-adapter.interface.js';
+ *
+ * const spinner = getSpinnerAdapter();
+ * const loading = spinner.create('Loading data...');
+ * loading.start();
+ *
+ * // ... do work
+ *
+ * loading.succeed('Data loaded!');
+ */
+export declare function getSpinnerAdapter(): SpinnerAdapter;
+/**
+ * Set a custom SpinnerAdapter implementation
+ * Useful for testing or switching to different spinner libraries
+ *
+ * @param adapter - The adapter instance to use
+ *
+ * @example
+ * // In tests
+ * import { setSpinnerAdapter } from './spinner-adapter.interface.js';
+ *
+ * const mockAdapter = new MockSpinnerAdapter();
+ * setSpinnerAdapter(mockAdapter);
+ */
+export declare function setSpinnerAdapter(adapter: SpinnerAdapter): void;
+//# sourceMappingURL=spinner-adapter.interface.d.ts.map

package/dist/ui/spinner-adapter.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner-adapter.interface.d.ts","sourceRoot":"","sources":["../../src/ui/spinner-adapter.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B;;OAEG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAE/B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACvB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC;IAEpB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAE9B;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC;IAEhB;;;;;OAKG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAEhC;;;;;OAKG;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAE7B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAE7B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAE7B;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC;IAEjB;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC;IAElB;;OAEG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;CAC3F;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC9B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC;CACnD;AAOD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAGlD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAE/D"}

package/dist/ui/spinner-adapter.interface.js

@@ -0,0 +1,53 @@
+/**
+ * Spinner Adapter Interface
+ *
+ * Library-agnostic spinner/loading indicator interface.
+ * Implementations can use ora, cli-spinners, nanospinner, or any other spinner library.
+ *
+ * This separation allows:
+ * - Multiple adapter implementations without coupling
+ * - Easy testing with mock adapters
+ * - Library migration without changing consumer code
+ */
+import { createDefaultSpinnerAdapter } from './spinner-adapter.js';
+/**
+ * Singleton instance
+ */
+let adapterInstance = null;
+/**
+ * Get the singleton SpinnerAdapter instance
+ *
+ * @returns SpinnerAdapter instance
+ *
+ * @example
+ * import { getSpinnerAdapter } from './spinner-adapter.interface.js';
+ *
+ * const spinner = getSpinnerAdapter();
+ * const loading = spinner.create('Loading data...');
+ * loading.start();
+ *
+ * // ... do work
+ *
+ * loading.succeed('Data loaded!');
+ */
+export function getSpinnerAdapter() {
+    adapterInstance ??= createDefaultSpinnerAdapter();
+    return adapterInstance;
+}
+/**
+ * Set a custom SpinnerAdapter implementation
+ * Useful for testing or switching to different spinner libraries
+ *
+ * @param adapter - The adapter instance to use
+ *
+ * @example
+ * // In tests
+ * import { setSpinnerAdapter } from './spinner-adapter.interface.js';
+ *
+ * const mockAdapter = new MockSpinnerAdapter();
+ * setSpinnerAdapter(mockAdapter);
+ */
+export function setSpinnerAdapter(adapter) {
+    adapterInstance = adapter;
+}
+//# sourceMappingURL=spinner-adapter.interface.js.map

package/dist/ui/spinner-adapter.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner-adapter.interface.js","sourceRoot":"","sources":["../../src/ui/spinner-adapter.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAqLhE;;GAEG;AACH,IAAI,eAAe,GAA0B,IAAI,CAAC;AAElD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB;IAChC,eAAe,KAAK,2BAA2B,EAAE,CAAC;IAClD,OAAO,eAAgB,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAuB;IACxD,eAAe,GAAG,OAAO,CAAC;AAC3B,CAAC"}

package/dist/ui/spinner-adapter.js

@@ -0,0 +1,40 @@
+/**
+ * Ora Spinner Adapter - Ora implementation of the spinner adapter
+ *
+ * This is a concrete implementation of SpinnerAdapter using the ora library.
+ * The interfaces are defined separately to allow for other implementations (cli-spinners, nanospinner, etc.)
+ *
+ * Benefits:
+ * - Implements library-agnostic SpinnerAdapter interface
+ * - Can be swapped with other implementations without changing consumers
+ * - Provides the familiar ora API through the adapter
+ */
+import ora from 'ora';
+/**
+ * Ora Adapter Implementation
+ *
+ * Concrete implementation of SpinnerAdapter using the ora library.
+ */
+export class OraAdapter {
+    /**
+     * Create and return a spinner instance
+     */
+    create(options) {
+        // Handle string shorthand for text
+        const oraOptions = typeof options === 'string' ? { text: options } : (options ?? {});
+        // Create ora spinner - type assertion needed due to adapter pattern
+        // Our SpinnerOptions uses string for spinner, ora uses SpinnerName | Spinner
+        const oraSpinner = ora(oraOptions);
+        // Return as our Spinner interface
+        // Ora already implements most of our interface, just cast it
+        return oraSpinner;
+    }
+}
+/**
+ * Default adapter instance factory
+ * This is used by the getSpinnerAdapter function in the interface
+ */
+export function createDefaultSpinnerAdapter() {
+    return new OraAdapter();
+}
+//# sourceMappingURL=spinner-adapter.js.map

package/dist/ui/spinner-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner-adapter.js","sourceRoot":"","sources":["../../src/ui/spinner-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,GAAiB,MAAM,KAAK,CAAC;AAIpC;;;;GAIG;AACH,MAAM,OAAO,UAAU;IACtB;;OAEG;IACH,MAAM,CAAC,OAAiC;QACvC,mCAAmC;QACnC,MAAM,UAAU,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAErF,oEAAoE;QACpE,6EAA6E;QAC7E,MAAM,UAAU,GAAG,GAAG,CAAC,UAAuC,CAAQ,CAAC;QAEvE,kCAAkC;QAClC,6DAA6D;QAC7D,OAAO,UAAgC,CAAC;IACzC,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B;IAC1C,OAAO,IAAI,UAAU,EAAE,CAAC;AACzB,CAAC"}

package/dist/ui/tui-adapter.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Ink TUI Adapter - Ink implementation of the TUI adapter
+ *
+ * This is a concrete implementation of TUIAdapter using the Ink library.
+ * The interfaces are defined separately to allow for other implementations (blessed, react-blessed, etc.)
+ *
+ * Benefits:
+ * - Implements library-agnostic TUIAdapter interface
+ * - Can be swapped with other implementations without changing consumers
+ * - Provides the familiar Ink API through the adapter
+ */
+import type React from 'react';
+import type { AppControl, BoxProps, InputHandler, NewlineProps, RenderResult, TextProps, TUIAdapter } from './tui-adapter.interface.js';
+/**
+ * Ink Adapter Implementation
+ *
+ * Concrete implementation of TUIAdapter using the Ink library.
+ */
+export declare class InkAdapter implements TUIAdapter {
+    /**
+     * Box component for layout
+     */
+    Box: React.FC<BoxProps>;
+    /**
+     * Text component for styled text
+     */
+    Text: React.FC<TextProps>;
+    /**
+     * Newline component
+     */
+    Newline: React.FC<NewlineProps>;
+    /**
+     * Hook for handling keyboard input
+     */
+    useInput(handler: InputHandler, options?: {
+        isActive?: boolean;
+    }): void;
+    /**
+     * Hook for controlling the app
+     */
+    useApp(): AppControl;
+    /**
+     * Render a React element to the terminal
+     */
+    render(element: React.ReactElement): RenderResult;
+}
+/**
+ * Default adapter instance factory
+ * This is used by the getTUIAdapter function in the interface
+ */
+export declare function createDefaultTUIAdapter(): TUIAdapter;
+//# sourceMappingURL=tui-adapter.d.ts.map

package/dist/ui/tui-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-adapter.d.ts","sourceRoot":"","sources":["../../src/ui/tui-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EACX,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,UAAU,EACV,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,qBAAa,UAAW,YAAW,UAAU;IAC5C;;OAEG;IACH,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAgC;IAEvD;;OAEG;IACH,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,CAAkC;IAE3D;;OAEG;IACH,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,CAAwC;IAEvE;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAIvE;;OAEG;IACH,MAAM,IAAI,UAAU;IAIpB;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,GAAG,YAAY;CAGjD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,UAAU,CAEpD"}