@mathiscode/pucc 1.0.0

package/dist/devtools-shell.js

@@ -0,0 +1,242 @@
+/*! devtools-shell v1.0.0 */
+"use strict";
+(() => {
+  // src/core/CommandParser.ts
+  var CommandParser = class {
+    /**
+     * Parse a command string into structured arguments
+     */
+    static parse(input) {
+      const args = { _: [] };
+      const trimmed = input.trim();
+      if (!trimmed) {
+        return args;
+      }
+      let i = 0;
+      const length = trimmed.length;
+      while (i < length) {
+        while (i < length && /\s/.test(trimmed[i])) {
+          i++;
+        }
+        if (i >= length)
+          break;
+        const keyMatch = trimmed.slice(i).match(/^([a-zA-Z_][a-zA-Z0-9_]*)\s*=/);
+        if (keyMatch) {
+          const key = keyMatch[1];
+          i += keyMatch[0].length;
+          while (i < length && /\s/.test(trimmed[i])) {
+            i++;
+          }
+          let value = "";
+          let inQuotes = false;
+          let quoteChar = "";
+          if (i < length && (trimmed[i] === '"' || trimmed[i] === "'")) {
+            inQuotes = true;
+            quoteChar = trimmed[i];
+            i++;
+          }
+          while (i < length) {
+            const char = trimmed[i];
+            if (inQuotes) {
+              if (char === quoteChar) {
+                i++;
+                break;
+              }
+              value += char;
+            } else {
+              if (/\s/.test(char)) {
+                break;
+              }
+              value += char;
+            }
+            i++;
+          }
+          if (value === "true") {
+            args[key] = true;
+          } else if (value === "false") {
+            args[key] = false;
+          } else if (/^-?\d+$/.test(value)) {
+            args[key] = parseInt(value, 10);
+          } else if (/^-?\d*\.\d+$/.test(value)) {
+            args[key] = parseFloat(value);
+          } else {
+            args[key] = value;
+          }
+        } else {
+          let arg = "";
+          let inQuotes = false;
+          let quoteChar = "";
+          while (i < length) {
+            const char = trimmed[i];
+            if (!inQuotes && (char === '"' || char === "'")) {
+              inQuotes = true;
+              quoteChar = char;
+              i++;
+              continue;
+            }
+            if (inQuotes && char === quoteChar) {
+              inQuotes = false;
+              i++;
+              break;
+            }
+            if (!inQuotes && /\s/.test(char)) {
+              break;
+            }
+            arg += char;
+            i++;
+          }
+          if (arg) {
+            args._.push(arg);
+          }
+        }
+      }
+      return args;
+    }
+  };
+
+  // src/commands/help.ts
+  var helpCommand = (_args, shell2) => {
+    if (!shell2) {
+      console.error("DevToolsShell instance not available");
+      return;
+    }
+    const commands = shell2.getCommands();
+    if (commands.length === 0) {
+      console.log("No commands registered.");
+      return;
+    }
+    console.log("\n%cAvailable Commands:", "font-weight: bold; font-size: 14px;");
+    console.log("\u2500".repeat(50));
+    commands.forEach((cmd) => {
+      console.log(
+        `%c$${cmd.name}%c - ${cmd.description}`,
+        "color: #4CAF50; font-weight: bold;",
+        "color: inherit;"
+      );
+    });
+    console.log("\u2500".repeat(50));
+    console.log(`Total: ${commands.length} command(s)`);
+  };
+
+  // src/commands/about.ts
+  var aboutCommand = () => {
+    console.log("%cDevTools Shell", "font-size: 20px; font-weight: bold; color: #2196F3;");
+    console.log("\u2500".repeat(50));
+    console.log("Version: 1.0.0");
+    console.log("A browser console command system library");
+    console.log("Built with TypeScript and esbuild");
+    console.log("\u2500".repeat(50));
+    console.log(
+      "Use %c$help%c to see available commands",
+      "color: #4CAF50; font-weight: bold;",
+      "color: inherit;"
+    );
+  };
+
+  // src/core/DevToolsShell.ts
+  var DevToolsShell = class {
+    constructor() {
+      this.commands = /* @__PURE__ */ new Map();
+      this.initialized = false;
+      this.registerBuiltInCommands();
+    }
+    /**
+     * Register a custom command
+     */
+    addCommand(name, handler, description) {
+      if (!name || typeof name !== "string") {
+        throw new Error("Command name must be a non-empty string");
+      }
+      if (name.startsWith("$")) {
+        throw new Error("Command name should not include the $ prefix");
+      }
+      if (typeof handler !== "function") {
+        throw new Error("Command handler must be a function");
+      }
+      if (this.commands.has(name)) {
+        console.warn(`Command "${name}" already exists. Overwriting...`);
+      }
+      this.commands.set(name, {
+        name,
+        description: description || "No description provided",
+        handler
+      });
+      this.attachCommandToWindow(name);
+    }
+    /**
+     * Execute a command by name with arguments
+     */
+    execute(commandName, input = "") {
+      const command = this.commands.get(commandName);
+      if (!command) {
+        console.error(`Command "${commandName}" not found. Use $help to see available commands.`);
+        return;
+      }
+      try {
+        const args = CommandParser.parse(input);
+        const result = command.handler(args, this);
+        if (result instanceof Promise) {
+          result.catch((error) => {
+            console.error(`Error executing command "${commandName}":`, error);
+          });
+        }
+      } catch (error) {
+        console.error(`Error executing command "${commandName}":`, error);
+      }
+    }
+    /**
+     * Get all registered commands
+     */
+    getCommands() {
+      return Array.from(this.commands.values());
+    }
+    /**
+     * Get a specific command by name
+     */
+    getCommand(name) {
+      return this.commands.get(name);
+    }
+    /**
+     * Initialize the shell and attach to window
+     */
+    initialize() {
+      if (this.initialized) {
+        return;
+      }
+      this.commands.forEach((_, name) => {
+        this.attachCommandToWindow(name);
+      });
+      this.initialized = true;
+    }
+    /**
+     * Register built-in commands
+     */
+    registerBuiltInCommands() {
+      this.addCommand("help", helpCommand, "Display all available commands");
+      this.addCommand("about", aboutCommand, "Show library information");
+    }
+    /**
+     * Attach a command to window as $commandName
+     */
+    attachCommandToWindow(name) {
+      const windowName = `$${name}`;
+      window[windowName] = (...args) => {
+        const input = args.length > 0 ? args.join(" ") : "";
+        this.execute(name, input);
+      };
+    }
+  };
+
+  // src/index.ts
+  var shell = new DevToolsShell();
+  if (typeof window !== "undefined") {
+    shell.initialize();
+    window.DevToolsShell = shell;
+    Promise.resolve().then(() => {
+      if (window.DevToolsShell !== shell) {
+        window.DevToolsShell = shell;
+      }
+    });
+  }
+})();
+//# sourceMappingURL=devtools-shell.js.map

package/dist/devtools-shell.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/core/CommandParser.ts", "../src/commands/help.ts", "../src/commands/about.ts", "../src/core/DevToolsShell.ts", "../src/index.ts"],
+  "sourcesContent": ["import type { ParsedArgs } from '../types';\n\n/**\n * Parses command strings into structured arguments\n * Supports both positional arguments and key=value pairs\n *\n * Examples:\n * - `$new customer` \u2192 `{ _: ['customer'] }`\n * - `name=\"John Smith\" balance=5400` \u2192 `{ name: \"John Smith\", balance: 5400 }`\n * - `$new customer name=\"John\"` \u2192 `{ _: ['customer'], name: \"John\" }`\n */\nexport class CommandParser {\n  /**\n   * Parse a command string into structured arguments\n   */\n  static parse(input: string): ParsedArgs {\n    const args: ParsedArgs = { _: [] };\n    const trimmed = input.trim();\n\n    if (!trimmed) {\n      return args;\n    }\n\n    let i = 0;\n    const length = trimmed.length;\n\n    while (i < length) {\n      // Skip whitespace\n      while (i < length && /\\s/.test(trimmed[i])) {\n        i++;\n      }\n\n      if (i >= length) break;\n\n      // Check if this looks like a key=value pair (starts with identifier followed by =)\n      const keyMatch = trimmed.slice(i).match(/^([a-zA-Z_][a-zA-Z0-9_]*)\\s*=/);\n      \n      if (keyMatch) {\n        const key = keyMatch[1];\n        i += keyMatch[0].length; // Move past \"key=\"\n        \n        // Skip whitespace after =\n        while (i < length && /\\s/.test(trimmed[i])) {\n          i++;\n        }\n\n        // Parse the value (may be quoted or unquoted)\n        let value = '';\n        let inQuotes = false;\n        let quoteChar = '';\n        \n        if (i < length && (trimmed[i] === '\"' || trimmed[i] === \"'\")) {\n          inQuotes = true;\n          quoteChar = trimmed[i];\n          i++; // Skip opening quote\n        }\n\n        while (i < length) {\n          const char = trimmed[i];\n          \n          if (inQuotes) {\n            if (char === quoteChar) {\n              i++; // Skip closing quote\n              break;\n            }\n            value += char;\n          } else {\n            // Unquoted value - stop at whitespace or end\n            if (/\\s/.test(char)) {\n              break;\n            }\n            value += char;\n          }\n          i++;\n        }\n\n        // Try to parse as number or boolean\n        if (value === 'true') {\n          args[key] = true;\n        } else if (value === 'false') {\n          args[key] = false;\n        } else if (/^-?\\d+$/.test(value)) {\n          args[key] = parseInt(value, 10);\n        } else if (/^-?\\d*\\.\\d+$/.test(value)) {\n          args[key] = parseFloat(value);\n        } else {\n          args[key] = value;\n        }\n      } else {\n        // Positional argument\n        let arg = '';\n        let inQuotes = false;\n        let quoteChar = '';\n        \n        while (i < length) {\n          const char = trimmed[i];\n          \n          if (!inQuotes && (char === '\"' || char === \"'\")) {\n            inQuotes = true;\n            quoteChar = char;\n            i++;\n            continue;\n          }\n          \n          if (inQuotes && char === quoteChar) {\n            inQuotes = false;\n            i++;\n            break;\n          }\n          \n          if (!inQuotes && /\\s/.test(char)) {\n            break;\n          }\n          \n          arg += char;\n          i++;\n        }\n        \n        if (arg) {\n          args._.push(arg);\n        }\n      }\n    }\n\n    return args;\n  }\n}\n", "import type { CommandHandler, Command } from '../types';\n\n/**\n * Built-in help command handler\n */\nexport const helpCommand: CommandHandler = (_args, shell) => {\n  if (!shell) {\n    console.error('DevToolsShell instance not available');\n    return;\n  }\n\n  const commands = shell.getCommands();\n  \n  if (commands.length === 0) {\n    console.log('No commands registered.');\n    return;\n  }\n\n  console.log('\\n%cAvailable Commands:', 'font-weight: bold; font-size: 14px;');\n  console.log('\u2500'.repeat(50));\n  \n  commands.forEach((cmd: Command) => {\n    console.log(`%c$${cmd.name}%c - ${cmd.description}`, \n      'color: #4CAF50; font-weight: bold;', \n      'color: inherit;');\n  });\n  \n  console.log('\u2500'.repeat(50));\n  console.log(`Total: ${commands.length} command(s)`);\n};\n", "import type { CommandHandler } from '../types';\n\n/**\n * Built-in about command handler\n */\nexport const aboutCommand: CommandHandler = () => {\n  console.log('%cDevTools Shell', 'font-size: 20px; font-weight: bold; color: #2196F3;');\n  console.log('\u2500'.repeat(50));\n  console.log('Version: 1.0.0');\n  console.log('A browser console command system library');\n  console.log('Built with TypeScript and esbuild');\n  console.log('\u2500'.repeat(50));\n  console.log('Use %c$help%c to see available commands', \n    'color: #4CAF50; font-weight: bold;', \n    'color: inherit;');\n};\n", "import type { Command, CommandHandler, ParsedArgs } from '../types';\nimport { CommandParser } from './CommandParser';\nimport { helpCommand } from '../commands/help';\nimport { aboutCommand } from '../commands/about';\n\n/**\n * Core DevToolsShell class managing command registry and execution\n */\nexport class DevToolsShell {\n  private commands: Map<string, Command> = new Map();\n  private initialized = false;\n\n  constructor() {\n    this.registerBuiltInCommands();\n  }\n\n  /**\n   * Register a custom command\n   */\n  addCommand(name: string, handler: CommandHandler, description: string): void {\n    if (!name || typeof name !== 'string') {\n      throw new Error('Command name must be a non-empty string');\n    }\n\n    if (name.startsWith('$')) {\n      throw new Error('Command name should not include the $ prefix');\n    }\n\n    if (typeof handler !== 'function') {\n      throw new Error('Command handler must be a function');\n    }\n\n    if (this.commands.has(name)) {\n      console.warn(`Command \"${name}\" already exists. Overwriting...`);\n    }\n\n    this.commands.set(name, {\n      name,\n      description: description || 'No description provided',\n      handler,\n    });\n\n    // Attach to window for console access\n    this.attachCommandToWindow(name);\n  }\n\n  /**\n   * Execute a command by name with arguments\n   */\n  execute(commandName: string, input: string = ''): void {\n    const command = this.commands.get(commandName);\n    \n    if (!command) {\n      console.error(`Command \"${commandName}\" not found. Use $help to see available commands.`);\n      return;\n    }\n\n    try {\n      const args = CommandParser.parse(input);\n      // Pass the shell instance to the handler so it can access shell methods\n      const result = command.handler(args, this);\n      \n      // Handle async handlers\n      if (result instanceof Promise) {\n        result.catch((error) => {\n          console.error(`Error executing command \"${commandName}\":`, error);\n        });\n      }\n    } catch (error) {\n      console.error(`Error executing command \"${commandName}\":`, error);\n    }\n  }\n\n  /**\n   * Get all registered commands\n   */\n  getCommands(): Command[] {\n    return Array.from(this.commands.values());\n  }\n\n  /**\n   * Get a specific command by name\n   */\n  getCommand(name: string): Command | undefined {\n    return this.commands.get(name);\n  }\n\n  /**\n   * Initialize the shell and attach to window\n   */\n  initialize(): void {\n    if (this.initialized) {\n      return;\n    }\n\n    // Attach all existing commands to window\n    this.commands.forEach((_, name) => {\n      this.attachCommandToWindow(name);\n    });\n\n    this.initialized = true;\n  }\n\n  /**\n   * Register built-in commands\n   */\n  private registerBuiltInCommands(): void {\n    this.addCommand('help', helpCommand, 'Display all available commands');\n    this.addCommand('about', aboutCommand, 'Show library information');\n  }\n\n  /**\n   * Attach a command to window as $commandName\n   */\n  private attachCommandToWindow(name: string): void {\n    const windowName = `$${name}` as `$${string}`;\n    \n    // Create a function that can be called from console\n    window[windowName] = (...args: any[]) => {\n      // If called as a function with arguments, join them as a string\n      const input = args.length > 0 ? args.join(' ') : '';\n      this.execute(name, input);\n    };\n  }\n}\n", "import { DevToolsShell } from './core/DevToolsShell';\n\n// Export the main class\nexport { DevToolsShell };\nexport type { Command, CommandHandler, ParsedArgs } from './types';\n\n// Create and initialize the shell instance\n// For IIFE builds, this will be executed immediately when the script loads\nconst shell = new DevToolsShell();\n\n// Auto-initialize when loaded in browser (for IIFE builds)\nif (typeof window !== 'undefined') {\n  shell.initialize();\n  \n  // Set the instance on window for user access\n  // We assign it directly - if esbuild's globalName overwrites it,\n  // we'll fix it in the next microtask\n  window.DevToolsShell = shell;\n  \n  // Ensure our instance assignment takes precedence over esbuild's globalName\n  // by setting it again after the current execution context\n  Promise.resolve().then(() => {\n    if (window.DevToolsShell !== shell) {\n      window.DevToolsShell = shell;\n    }\n  });\n}\n"],
+  "mappings": "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",
+  "names": ["shell"]
+}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { Pucc } from './core/Pucc';
+import { ShellTerminal } from './components/ShellTerminal';
+import { TerminalLogger } from './components/TerminalLogger';
+export { Pucc };
+export { ShellTerminal };
+export { TerminalLogger };
+export type { Command, CommandHandler, ParsedArgs } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAM7D,OAAO,EAAE,IAAI,EAAE,CAAC;AAChB,OAAO,EAAE,aAAa,EAAE,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.html

@@ -0,0 +1,285 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Pucc : Power User Console Component</title>
+  <link rel="stylesheet" href="demo.css">
+</head>
+<body>
+  <div class="container">
+    <div class="hero">
+      <h1>Pucc</h1>
+      <h2>Power User Console Component</h2>
+      <h3>Made with ❤️ by <a href="https://github.com/mathiscode">Jay Mathis</a></h3>
+      <div class="github-link">
+        <a href="https://github.com/mathiscode/pucc" target="_blank" rel="noopener noreferrer" class="github-button">
+          <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
+            <path d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z"/>
+          </svg>
+          <span>View on GitHub</span>
+        </a>
+      </div>
+      <p>A browser library that provides a console command system. Register custom commands and execute them via the browser console with a <code>$</code> (configurable) prefix or via the dropdown or embedded terminal Custom Element.</p>
+      <br />
+      <p>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.</p>
+    </div>
+
+    <div class="terminal-container">
+      <h2>Dropdown Terminal <span class="badge">Alt+S</span></h2>
+      <p style="color: var(--text-muted); margin-bottom: 1rem;">
+        Press <kbd>Alt</kbd> + <kbd>S</kbd> (hotkey configurable) to open a dropdown terminal that slides down from the top of the page. Press <kbd>Escape</kbd> to close it.
+      </p>
+      <div id="dropdown-terminal">
+        <p style="color: var(--text-muted); margin: 0; text-align: center;">
+          The dropdown terminal will appear at the top of the page when you press <kbd>Alt</kbd> + <kbd>S</kbd>
+        </p>
+      </div>
+    </div>
+
+    <div class="terminal-container" style="margin-bottom: 3rem;">
+      <h2>Embedded Terminal <span class="badge">Live Demo</span></h2>
+      <p style="color: var(--text-muted); margin-bottom: 1rem;">A terminal embedded directly in the page. Try commands like <code>help</code> or <code>about</code>:</p>
+      <div id="embedded-terminal"></div>
+    </div>
+
+    <div class="content-grid">
+      <div class="card">
+        <h2>Installation</h2>
+        <p>Get started with Pucc in seconds. Choose your preferred package manager:</p>
+        <p><strong>Via pnpm/yarn/npm</strong></p>
+        <pre><code>pnpm add @mathiscode/pucc # or yarn add / npm install</code></pre>
+        <p><strong>Via Script Tag</strong></p>
+        <pre><code>&lt;script src="https://unpkg.com/@mathiscode/pucc/dist/pucc.js"&gt;&lt;/script&gt;</code></pre>
+      </div>
+
+      <div class="card">
+        <h2>Usage</h2>
+        <p>After including the library, commands are automatically available in the browser console:</p>
+        <pre><code>$help()        // Lists all available commands
+$about()       // Shows library information</code></pre>
+      </div>
+
+      <div class="card">
+        <h2>Adding Custom Commands</h2>
+        <p>Register a new command with ease:</p>
+        <pre><code>Pucc.addCommand('new', (args) => {
+  console.log('Creating:', args._[0]);
+  console.log('Arguments:', args);
+}, 'Create a new entity');</code></pre>
+        <p>Now you can use it in the console or dropdown terminal:</p>
+        <pre><code>$new('customer', 'name="John Smith"', 'balance=5400')
+new customer name="John Smith" balance=5400</code></pre>
+      </div>
+
+      <div class="card">
+        <h2>Terminal Types</h2>
+        <p><strong>Embedded Terminal</strong></p>
+        <p>Embedded terminals are always visible on the page. Use the <code>embedded</code> attribute:</p>
+        <pre><code>&lt;pucc-terminal embedded="true"&gt;&lt;/pucc-terminal&gt;</code></pre>
+        <p><strong>Dropdown Terminal</strong></p>
+        <p>Dropdown terminals slide down from the top when activated via hotkey (default: <kbd>Alt</kbd> + <kbd>S</kbd>). Press <kbd>Escape</kbd> to close.</p>
+        <pre><code>&lt;pucc-terminal&gt;&lt;/pucc-terminal&gt;</code></pre>
+      </div>
+
+      <div class="card">
+        <h2>Configuration</h2>
+        <p>Customize the terminal with attributes:</p>
+        <pre><code>&lt;pucc-terminal
+  embedded="true"
+  height="300px"
+  theme="dark"
+  prompt="# "
+  hotkey="alt+s"
+  pucc-options='{"enableGlobalRegistrations": false}'&gt;
+&lt;/pucc-terminal&gt;</code></pre>
+        <p><strong>Attributes:</strong></p>
+        <ul style="color: var(--text-muted); margin: 0.5rem 0; padding-left: 1.5rem;">
+          <li><code>embedded</code> - Set to "true" for embedded mode</li>
+          <li><code>height</code> - Terminal height (e.g., "300px", "50vh")</li>
+          <li><code>theme</code> - Color theme ("dark" or "light")</li>
+          <li><code>prompt</code> - Custom prompt text (default: "$ ")</li>
+          <li><code>hotkey</code> - Keyboard shortcut for dropdown (e.g., "alt+s")</li>
+          <li><code>pucc-options</code> - JSON string with Pucc constructor options (see "Passing Pucc Options to Terminal" card)</li>
+        </ul>
+      </div>
+
+      <div class="card">
+        <h2>Command Execution</h2>
+        <p><strong>Browser Console</strong></p>
+        <p>In the browser console, use the <code>$</code> prefix and call it as a function:</p>
+        <pre><code>$help()
+$about()</code></pre>
+        <p><strong>Terminal Component</strong></p>
+        <p>In embedded or dropdown terminals, type commands directly without the prefix:</p>
+        <pre><code>help
+about</code></pre>
+      </div>
+
+      <div class="card">
+        <h2>Command Arguments</h2>
+        <p>The command parser supports flexible argument formats:</p>
+        <p><strong>Positional arguments:</strong></p>
+        <pre><code>$new customer
+// args = { _: ['customer'] }</code></pre>
+        <p><strong>Key-value pairs:</strong></p>
+        <pre><code>$new name="John Smith" balance=5400
+// args = { name: "John Smith", balance: 5400 }</code></pre>
+        <p><strong>Mixed (positional + key-value):</strong></p>
+        <pre><code>$new customer name="John Smith" balance=5400
+// args = { _: ['customer'], name: "John Smith", balance: 5400 }</code></pre>
+        <p><strong>Type conversion:</strong></p>
+        <ul style="color: var(--text-muted); margin: 0.5rem 0; padding-left: 1.5rem;">
+          <li>Numbers: <code>balance=5400</code> → <code>5400</code> (number)</li>
+          <li>Booleans: <code>active=true</code> → <code>true</code> (boolean)</li>
+          <li>Strings: <code>name="John"</code> → <code>"John"</code> (string)</li>
+        </ul>
+      </div>
+
+      <div class="card">
+        <h2>Module Import (ESM)</h2>
+        <p>When using ESM, no global instance is created automatically. You have full control:</p>
+        <pre><code>import { Pucc } from 'pucc';
+
+// 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</code></pre>
+      </div>
+
+      <div class="card">
+        <h2>Disabling Global Registrations</h2>
+        <p>Limit commands to the terminal only (avoiding global namespace pollution):</p>
+        <pre><code>import { Pucc } from 'pucc';
+
+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');</code></pre>
+      </div>
+
+      <div class="card">
+        <h2>Custom Command Prefix</h2>
+        <p>Customize the command prefix (must be a valid JavaScript identifier):</p>
+        <pre><code>import { Pucc } from 'pucc';
+
+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()
+
+shell.addCommand('greet', (args) => {
+  console.log(`Hello, ${args._[0] || 'World'}!`);
+}, 'Greet someone');
+
+// Can be called as: cmdgreet('Alice') or greet('Alice')</code></pre>
+        <p><strong>Valid prefixes:</strong> <code>$</code>, <code>_</code>, <code>cmd</code>, <code>myPrefix</code>, <code>prefix123</code>, <code>_prefix</code></p>
+        <p style="color: var(--text-muted); font-size: 0.9em; margin-top: 0.5rem;">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).</p>
+      </div>
+
+      <div class="card">
+        <h2>Passing Pucc Options to Terminal</h2>
+        <p>Configure Pucc options when using the <code>pucc-terminal</code> custom element:</p>
+        <p><strong>Via attribute (simple options):</strong></p>
+        <pre><code>&lt;pucc-terminal 
+  embedded="true"
+  pucc-options='{"enableGlobalRegistrations": false, "commandPrefix": "_"}'&gt;
+&lt;/pucc-terminal&gt;</code></pre>
+        <p><strong>Via property (full functionality):</strong></p>
+        <pre><code>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'}!`);
+      }
+    }
+  ]
+};</code></pre>
+        <p style="color: var(--text-muted); font-size: 0.9em; margin-top: 0.5rem;"><strong>Note:</strong> The <code>pucc-options</code> attribute only supports JSON-serializable options. For options that include functions, use the <code>puccOptions</code> property instead.</p>
+      </div>
+
+      <div class="card">
+        <h2>About the Author</h2>
+        <p>Pucc is created and maintained by <strong><a href="https://jaymath.is">Jay Mathis</a></strong>, a developer passionate about building useful tools for the web.</p>
+        <p><strong>Connect & Explore:</strong></p>
+        <ul style="color: var(--text-muted); margin: 0.5rem 0; padding-left: 1.5rem;">
+          <li><a href="https://github.com/mathiscode" target="_blank" rel="noopener noreferrer">GitHub Profile</a> - Check out other projects and contributions</li>
+          <li><a href="https://github.com/mathiscode/pucc" target="_blank" rel="noopener noreferrer">Pucc Repository</a> - Star, fork, or contribute to this project</li>
+          <li><a href="https://jaymath.is" target="_blank" rel="noopener noreferrer">Website</a> - Learn more about Jay and his work</li>
+        </ul>
+        <p style="color: var(--text-muted); font-size: 0.9em; margin-top: 0.5rem;">Found Pucc useful? Consider giving it <a href="https://github.com/mathiscode/pucc/stargazers" target="_blank" rel="noopener noreferrer">a star on GitHub</a>! ⭐</p>
+      </div>
+    </div>
+  </div>
+
+  <script src="pucc.js"></script>
+
+  <script>
+    function createTerminals() {
+      const embeddedContainer = document.getElementById('embedded-terminal');
+      const dropdownContainer = document.getElementById('dropdown-terminal');
+      
+      if (embeddedContainer) {
+        const embeddedTerminal = document.createElement('pucc-terminal');
+        embeddedTerminal.setAttribute('embedded', 'true');
+        embeddedTerminal.setAttribute('height', '250px');
+        embeddedTerminal.setAttribute('theme', 'dark');
+        embeddedTerminal.setAttribute('prompt', '# ');
+        embeddedContainer.appendChild(embeddedTerminal);
+      }
+      
+      if (dropdownContainer) {
+        const dropdownTerminal = document.createElement('pucc-terminal');
+        dropdownTerminal.setAttribute('height', '400px');
+        dropdownTerminal.setAttribute('theme', 'dark');
+        dropdownTerminal.setAttribute('prompt', '# ');
+        dropdownContainer.appendChild(dropdownTerminal);
+      }
+    }
+
+    if (customElements.get('pucc-terminal')) {
+      createTerminals();
+    } else {
+      customElements.whenDefined('pucc-terminal').then(() => {
+        createTerminals();
+      });
+    }
+  </script>
+  
+  <script>
+    let lastModified = 0;
+    setInterval(async () => {
+      try {
+        const response = await fetch('pucc.js?t=' + Date.now(), { method: 'HEAD' });
+        const modified = response.headers.get('last-modified');
+        if (modified) {
+          const modifiedTime = new Date(modified).getTime();
+          if (lastModified > 0 && modifiedTime > lastModified) {
+            window.location.reload();
+          }
+          lastModified = modifiedTime;
+        }
+      } catch (e) {
+        // Ignore errors
+      }
+    }, 1000);
+  </script>
+</body>
+</html>