@mathiscode/pucc 1.0.0

package/README.md

@@ -0,0 +1,314 @@
+# Pucc
+
+Power User Console Component - A browser library that provides a console command system. 
+
+Register custom commands and execute them via the browser console with a `$` prefix or via the dropdown or embedded terminal Custom Element.
+
+This can be very useful for web apps that need to provide a console for users to interact with the app, bypassing the UI for power users.
+
+## Features
+
+- 🚀 Zero dependencies (runtime)
+- 📦 Built with esbuild for fast builds
+- 🔧 TypeScript for type safety
+- 🎯 Flexible command parsing (positional args + key=value pairs)
+- 📝 Built-in commands: `$help`, `$about`
+- 🔌 Extensible command system
+
+## Installation
+
+### Via pnpm/yarn/npm
+
+```bash
+pnpm add @mathiscode/pucc
+# or
+yarn add @mathiscode/pucc
+# or
+npm install @mathiscode/pucc
+```
+
+### Via Script Tag
+
+```html
+<script src="https://unpkg.com/@mathiscode/pucc/dist/pucc.js"></script>
+```
+
+## Usage
+
+### Basic Usage
+
+After including the library, commands are automatically available in the browser console:
+
+```javascript
+// Built-in commands
+$help()        // Lists all available commands
+$about()       // Shows library information
+```
+
+### Adding Custom Commands
+
+```javascript
+// Register a new command
+Pucc.addCommand('new', (args) => {
+  console.log('Creating:', args._[0]);
+  console.log('Arguments:', args);
+}, 'Create a new entity');
+
+// Now you can use it in the console or dropdown terminal:
+// $new('customer', 'name="John Smith"', 'balance=5400')
+// new customer name="John Smith" balance=5400
+```
+
+### Command Arguments
+
+The command parser supports flexible argument formats:
+
+**Positional arguments:**
+
+```javascript
+$new customer
+// args = { _: ['customer'] }
+```
+
+**Key-value pairs:**
+
+```javascript
+$new name="John Smith" balance=5400
+// args = { name: "John Smith", balance: 5400 }
+```
+
+**Mixed (positional + key-value):**
+
+```javascript
+$new customer name="John Smith" balance=5400
+// args = { _: ['customer'], name: "John Smith", balance: 5400 }
+```
+
+**Type conversion:**
+
+- Numbers are automatically parsed: `balance=5400` → `5400` (number)
+- Booleans: `active=true` → `true` (boolean)
+- Strings: `name="John"` → `"John"` (string)
+
+### Module Import (ESM)
+
+```javascript
+import { Pucc } from 'pucc';
+
+// When using ESM, no global instance is created automatically
+// You have full control over whether to create a global instance
+// or use terminal-only commands
+
+// Option 1: Create a global instance (like IIFE build)
+const shell = new Pucc();
+shell.initialize();
+// Now commands are available: $help(), $about()
+
+// Option 2: Create a terminal-only instance
+const shell = new Pucc({ enableGlobalRegistrations: false });
+// Commands only available in terminal elements, not globally
+```
+
+### Disabling Global Command Registrations
+
+By default, commands are registered globally on the `window` object, making them accessible from the browser console. If you want to limit command execution to only the terminal element (avoiding global namespace pollution), you can disable global registrations:
+
+```javascript
+import { Pucc } from 'pucc';
+
+// Create a Pucc instance with global registrations disabled
+const shell = new Pucc({ enableGlobalRegistrations: false });
+
+// Commands will only be available through the terminal
+// They will NOT be accessible via window.$commandName
+shell.addCommand('mycommand', (args) => {
+  console.log('This command is only available in the terminal');
+}, 'A terminal-only command');
+```
+
+### Custom Command Prefix
+
+By default, commands use the `$` prefix (e.g., `$help`, `$about`). You can customize this prefix when creating a Pucc instance:
+
+```javascript
+import { Pucc } from 'pucc';
+
+// Use a custom prefix (must be a valid JavaScript identifier)
+const shell = new Pucc({ commandPrefix: 'cmd' });
+
+// Now commands can be called with the custom prefix
+// cmdhelp() or cmdabout() in the console
+// Or without prefix: help() or about()
+
+// Commands are still accessible both ways
+shell.addCommand('greet', (args) => {
+  console.log(`Hello, ${args._[0] || 'World'}!`);
+}, 'Greet someone');
+
+// Can be called as: cmdgreet('Alice')
+```
+
+**Valid prefix examples:**
+
+- `$` (default)
+- `_`
+- `cmd`
+- `myPrefix`
+- `prefix123`
+- `_prefix`
+
+**Invalid prefix examples:**
+
+- `>` (special character not allowed)
+- `123` (cannot start with a digit)
+- `prefix-` (hyphen not allowed)
+- `prefix.` (dot not allowed)
+
+**Note:** The prefix must be a valid JavaScript identifier (starts with a letter, underscore, or dollar sign; can only contain letters, digits, underscores, and dollar signs). The prefix is used for console commands and is automatically stripped when parsing command input. Commands can always be called with or without the prefix in the terminal.
+
+### Passing Pucc Options to Terminal Element
+
+When using the `pucc-terminal` custom element, you can pass Pucc constructor options in two ways:
+
+**Via attribute (for simple options):**
+
+```html
+<pucc-terminal 
+  embedded="true"
+  pucc-options='{"enableGlobalRegistrations": false, "commandPrefix": "_"}'>
+</pucc-terminal>
+```
+
+**Via property (for full functionality, including functions):**
+
+```javascript
+import { Pucc } from 'pucc';
+
+const terminal = document.querySelector('pucc-terminal');
+
+terminal.puccOptions = {
+  enableGlobalRegistrations: false,
+  commandPrefix: 'cmd',
+  customHelpHandler: (args, shell) => {
+    console.log('Custom help!');
+  },
+  initialCommands: [
+    {
+      name: 'greet',
+      description: 'Greet someone',
+      handler: (args) => {
+        console.log(`Hello, ${args._[0] || 'World'}!`);
+      }
+    }
+  ]
+};
+```
+
+**Note:** The `pucc-options` attribute only supports JSON-serializable options (`enableGlobalRegistrations`, `commandPrefix`). For options that include functions (`customHelpHandler`, `initialCommands`), use the `puccOptions` property instead.
+
+## API Reference
+
+### `new Pucc(options?)`
+
+Create a new Pucc instance.
+
+**Parameters:**
+
+- `options` (object, optional): Configuration options
+  - `customHelpHandler` (function, optional): Custom handler for the `help` command
+  - `initialCommands` (Command[], optional): Array of commands to register on initialization
+  - `enableGlobalRegistrations` (boolean, optional): Whether to register commands globally on `window`. Defaults to `true`. Set to `false` to limit commands to the dropdown/embedded terminal only.
+  - `commandPrefix` (string, optional): Custom prefix for console commands. Defaults to `$`. Must be a valid JavaScript identifier (starts with letter, underscore, or dollar sign; can contain letters, digits, underscores, and dollar signs). Commands can be called with or without the prefix.
+
+**Example:**
+
+```javascript
+// Default behavior (global registrations enabled, $ prefix)
+const shell = new Pucc();
+
+// Disable global registrations
+const shell = new Pucc({ enableGlobalRegistrations: false });
+
+// Use custom command prefix (must be a valid JavaScript identifier)
+const shell = new Pucc({ commandPrefix: 'cmd_' });
+// Now commands can be called as cmd_help, cmd_about, etc.
+```
+
+### `Pucc.addCommand(name, handler, description)`
+
+Register a new command.
+
+**Parameters:**
+
+- `name` (string): Command name (without prefix)
+- `handler` (function): Command handler function `(args: ParsedArgs) => void | Promise<void>`
+- `description` (string): Command description (shown in `$help`)
+
+**Example:**
+
+```javascript
+Pucc.addCommand('greet', (args) => {
+  const name = args.name || args._[0] || 'World';
+  console.log(`Hello, ${name}!`);
+}, 'Greet someone by name');
+```
+
+### `ParsedArgs`
+
+The argument object passed to command handlers:
+
+```typescript
+interface ParsedArgs {
+  _: string[];  // Positional arguments
+  [key: string]: string | number | boolean | string[];
+}
+```
+
+## Development
+
+### Setup
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build for production
+pnpm build
+
+# Build in watch mode (development)
+pnpm build:dev
+
+# Run linter
+pnpm lint
+
+# Format code
+pnpm format
+
+# Run server
+pnpm server
+
+# Type check
+pnpm type-check
+```
+
+### Project Structure
+
+```
+pucc/
+├── src/
+│   ├── index.ts              # Main entry point
+│   ├── core/
+│   │   ├── Pucc.ts           # Core class
+│   │   └── CommandParser.ts  # Command parser
+│   ├── commands/
+│   │   ├── help.ts           # $help command
+│   │   └── about.ts          # $about command
+│   └── types.ts              # Type definitions
+├── config/
+│   └── build.js              # Build configuration
+└── dist/                     # Build output
+```
+
+## License
+
+MIT

package/dist/commands/about.d.ts

@@ -0,0 +1,6 @@
+import type { CommandHandler } from '../types';
+/**
+ * Built-in about command handler
+ */
+export declare const aboutCommand: CommandHandler;
+//# sourceMappingURL=about.d.ts.map

package/dist/commands/about.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"about.d.ts","sourceRoot":"","sources":["../../src/commands/about.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,cA0B1B,CAAC"}

package/dist/commands/echo.d.ts

@@ -0,0 +1,3 @@
+import type { CommandHandler } from '../types';
+export declare const echoCommand: CommandHandler;
+//# sourceMappingURL=echo.d.ts.map

package/dist/commands/echo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo.d.ts","sourceRoot":"","sources":["../../src/commands/echo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAE9C,eAAO,MAAM,WAAW,EAAE,cAUzB,CAAA"}

package/dist/commands/help.d.ts

@@ -0,0 +1,6 @@
+import type { CommandHandler } from '../types';
+/**
+ * Built-in help command handler
+ */
+export declare const helpCommand: CommandHandler;
+//# sourceMappingURL=help.d.ts.map

package/dist/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAW,MAAM,UAAU,CAAC;AAGxD;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,cA0CzB,CAAC"}

package/dist/components/ShellTerminal.d.ts

@@ -0,0 +1,73 @@
+import { Terminal } from '@xterm/xterm';
+import '@xterm/xterm/css/xterm.css';
+import type { Pucc } from '../core/Pucc';
+import { TerminalLogger } from './TerminalLogger';
+import type { Command, CommandHandler } from '../types';
+export declare class ShellTerminal extends HTMLElement {
+    private terminal;
+    private fitAddon;
+    private container;
+    private isVisible;
+    private currentLine;
+    private cursorPos;
+    private history;
+    private historyIndex;
+    private savedLine;
+    private shell;
+    private hotkeyConfig;
+    private logger;
+    private promptText;
+    private isEmbedded;
+    private initialContent;
+    private _puccOptions;
+    static get observedAttributes(): string[];
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+    private getThemeColors;
+    private render;
+    private initializeTerminal;
+    private getThemeFromCSS;
+    private handleInput;
+    private replaceLine;
+    private executeCommand;
+    private setupHotkeyListener;
+    private handleHotkey;
+    private parseHotkey;
+    private parseHeightValue;
+    private updateHeight;
+    private updateTheme;
+    private writePrompt;
+    private updatePrompt;
+    private cleanup;
+    get visible(): boolean;
+    set visible(value: boolean);
+    private parsePuccOptions;
+    private initializeShell;
+    get terminalInstance(): Terminal | null;
+    get shellInstance(): Pucc | null;
+    set shellInstance(shell: Pucc);
+    get puccOptions(): {
+        customHelpHandler?: CommandHandler;
+        initialCommands?: Command[];
+        enableGlobalRegistrations?: boolean;
+        commandPrefix?: string;
+    } | null;
+    set puccOptions(options: {
+        customHelpHandler?: CommandHandler;
+        initialCommands?: Command[];
+        enableGlobalRegistrations?: boolean;
+        commandPrefix?: string;
+    } | null);
+    getLogger(): TerminalLogger | null;
+    get prompt(): string;
+    set prompt(value: string);
+    show(): void;
+    hide(): void;
+    toggle(): void;
+    write(text: string): void;
+    writeln(text: string): void;
+    clear(): void;
+}
+//# sourceMappingURL=ShellTerminal.d.ts.map

package/dist/components/ShellTerminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellTerminal.d.ts","sourceRoot":"","sources":["../../src/components/ShellTerminal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAEvC,OAAO,4BAA4B,CAAA;AACnC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAUvD,qBAAa,aAAc,SAAQ,WAAW;IAC5C,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,YAAY,CAAgJ;IAEpK,MAAM,KAAK,kBAAkB,aAE5B;;IAOD,iBAAiB;IAajB,oBAAoB;IAIpB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAiDzE,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,MAAM;IA0Hd,OAAO,CAAC,kBAAkB;IAgF1B,OAAO,CAAC,eAAe;IAkCvB,OAAO,CAAC,WAAW;IAsInB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,cAAc;IA2CtB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,YAAY,CAenB;IAED,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,WAAW;IA6BnB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,OAAO;IAWf,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAMzB;IAED,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,eAAe;IASvB,IAAI,gBAAgB,IAAI,QAAQ,GAAG,IAAI,CAEtC;IAED,IAAI,aAAa,IAAI,IAAI,GAAG,IAAI,CAE/B;IAED,IAAI,aAAa,CAAC,KAAK,EAAE,IAAI,EAE5B;IAED,IAAI,WAAW,IAAI;QAAE,iBAAiB,CAAC,EAAE,cAAc,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;QAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAEzJ;IAED,IAAI,WAAW,CAAC,OAAO,EAAE;QAAE,iBAAiB,CAAC,EAAE,cAAc,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;QAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,EAG/J;IAED,SAAS,IAAI,cAAc,GAAG,IAAI;IAIlC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAIvB;IAED,IAAI;IAiBJ,IAAI;IASJ,MAAM;IAQN,KAAK,CAAC,IAAI,EAAE,MAAM;IAMlB,OAAO,CAAC,IAAI,EAAE,MAAM;IAMpB,KAAK;CAQN"}

package/dist/components/TerminalLogger.d.ts

@@ -0,0 +1,12 @@
+import type { Terminal } from '@xterm/xterm';
+export declare class TerminalLogger {
+    private terminal;
+    constructor(terminal: Terminal);
+    write(message: string): void;
+    writeln(message: string): void;
+    info(message: string): void;
+    error(message: string): void;
+    warn(message: string): void;
+    success(message: string): void;
+}
+//# sourceMappingURL=TerminalLogger.d.ts.map

package/dist/components/TerminalLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalLogger.d.ts","sourceRoot":"","sources":["../../src/components/TerminalLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAG5C,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAU;gBAEd,QAAQ,EAAE,QAAQ;IAI9B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG/B"}

package/dist/core/CommandParser.d.ts

@@ -0,0 +1,17 @@
+import type { ParsedArgs } from '../types';
+/**
+ * Parses command strings into structured arguments
+ * Supports both positional arguments and key=value pairs
+ *
+ * Examples:
+ * - `$new customer` → `{ _: ['customer'] }`
+ * - `name="John Smith" balance=5400` → `{ name: "John Smith", balance: 5400 }`
+ * - `$new customer name="John"` → `{ _: ['customer'], name: "John" }`
+ */
+export declare class CommandParser {
+    /**
+     * Parse a command string into structured arguments
+     */
+    static parse(input: string): ParsedArgs;
+}
+//# sourceMappingURL=CommandParser.d.ts.map

package/dist/core/CommandParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandParser.d.ts","sourceRoot":"","sources":["../../src/core/CommandParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;CA8GxC"}

package/dist/core/DevToolsShell.d.ts

@@ -0,0 +1,38 @@
+import type { Command, CommandHandler } from '../types';
+/**
+ * Core DevToolsShell class managing command registry and execution
+ */
+export declare class DevToolsShell {
+    private commands;
+    private initialized;
+    constructor();
+    /**
+     * Register a custom command
+     */
+    addCommand(name: string, handler: CommandHandler, description: string): void;
+    /**
+     * Execute a command by name with arguments
+     */
+    execute(commandName: string, input?: string): void;
+    /**
+     * Get all registered commands
+     */
+    getCommands(): Command[];
+    /**
+     * Get a specific command by name
+     */
+    getCommand(name: string): Command | undefined;
+    /**
+     * Initialize the shell and attach to window
+     */
+    initialize(): void;
+    /**
+     * Register built-in commands
+     */
+    private registerBuiltInCommands;
+    /**
+     * Attach a command to window as $commandName
+     */
+    private attachCommandToWindow;
+}
+//# sourceMappingURL=DevToolsShell.d.ts.map

package/dist/core/DevToolsShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsShell.d.ts","sourceRoot":"","sources":["../../src/core/DevToolsShell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAc,MAAM,UAAU,CAAC;AAKpE;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,WAAW,CAAS;;IAM5B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IA2B5E;;OAEG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,IAAI;IAwBtD;;OAEG;IACH,WAAW,IAAI,OAAO,EAAE;IAIxB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI7C;;OAEG;IACH,UAAU,IAAI,IAAI;IAalB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAK/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAU9B"}

package/dist/core/Pucc.d.ts

@@ -0,0 +1,74 @@
+import type { Command, CommandHandler } from '../types';
+import type { TerminalLogger } from '../components/TerminalLogger';
+/**
+ * Core Pucc class managing command registry and execution
+ */
+export declare class Pucc {
+    private commands;
+    private initialized;
+    private logger;
+    private customHelpHandler;
+    private enableGlobalRegistrations;
+    private commandPrefix;
+    constructor(options?: {
+        customHelpHandler?: CommandHandler;
+        initialCommands?: Command[];
+        enableGlobalRegistrations?: boolean;
+        commandPrefix?: string;
+    });
+    /**
+     * Validate that the command prefix contains only characters valid for JavaScript function names
+     * Valid characters: letters (a-z, A-Z), digits (0-9), underscore (_), dollar sign ($)
+     * Must start with a letter, underscore, or dollar sign
+     */
+    private validateCommandPrefix;
+    /**
+     * Register a custom command
+     */
+    addCommand(name: string, handler: CommandHandler, description: string): void;
+    /**
+     * Execute a command by name with arguments
+     */
+    execute(commandName: string, input?: string, logger?: TerminalLogger | null): void;
+    /**
+     * Execute a command from raw input string (handles command prefix automatically)
+     */
+    executeFromInput(input: string, logger?: TerminalLogger | null): void;
+    /**
+     * Get all registered commands
+     */
+    getCommands(): Command[];
+    /**
+     * Get a specific command by name
+     */
+    getCommand(name: string): Command | undefined;
+    /**
+     * Initialize the shell and attach to window
+     */
+    initialize(): void;
+    /**
+     * Register built-in commands
+     */
+    private registerBuiltInCommands;
+    /**
+     * Register initial commands provided in constructor
+     */
+    private registerInitialCommands;
+    /**
+     * Get the terminal logger if available
+     */
+    getLogger(): TerminalLogger | null;
+    /**
+     * Set the terminal logger
+     */
+    setLogger(logger: TerminalLogger | null): void;
+    /**
+     * Get the command prefix
+     */
+    getCommandPrefix(): string;
+    /**
+     * Attach a command to window as both prefix+commandName and commandName
+     */
+    private attachCommandToWindow;
+}
+//# sourceMappingURL=Pucc.d.ts.map

package/dist/core/Pucc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pucc.d.ts","sourceRoot":"","sources":["../../src/core/Pucc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAKxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE;;GAEG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,yBAAyB,CAAU;IAC3C,OAAO,CAAC,aAAa,CAAS;gBAElB,OAAO,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,cAAc,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;QAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE;IAUtJ;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAgB5E;;OAEG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI;IAyCtF;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI;IAkBrE;;OAEG;IACH,WAAW,IAAI,OAAO,EAAE;IAIxB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI7C;;OAEG;IACH,UAAU,IAAI,IAAI;IAalB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAO/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAM/B;;OAEG;IACH,SAAS,IAAI,cAAc,GAAG,IAAI;IAIlC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI;IAI9C;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAkB9B"}