@nicmeriano/spool 0.0.1

package/dist/cli.js

@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+
+// src/commands/init.ts
+import * as fs from "fs";
+import * as path from "path";
+import * as readline from "readline";
+function detectFramework(cwd) {
+  const pkgPath = path.join(cwd, "package.json");
+  if (!fs.existsSync(pkgPath)) return null;
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+  const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+  if (deps["next"]) {
+    return { name: "Next.js", devCommand: "npm run dev" };
+  }
+  if (deps["vite"]) {
+    return { name: "Vite", devCommand: "npm run dev" };
+  }
+  if (deps["react-scripts"]) {
+    return { name: "Create React App", devCommand: "npm start" };
+  }
+  return null;
+}
+function prompt(question, defaultValue) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  const displayDefault = defaultValue ? ` (${defaultValue})` : "";
+  return new Promise((resolve2) => {
+    rl.question(`${question}${displayDefault}: `, (answer) => {
+      rl.close();
+      resolve2(answer.trim() || defaultValue || "");
+    });
+  });
+}
+async function runInit(cwd) {
+  console.log("Initializing Spool...\n");
+  const configPath = path.join(cwd, "spool.config.ts");
+  if (fs.existsSync(configPath)) {
+    console.log("spool.config.ts already exists. Skipping.\n");
+    return;
+  }
+  const framework = detectFramework(cwd);
+  if (framework) {
+    console.log(`Detected framework: ${framework.name}
+`);
+  }
+  const defaultDevCmd = framework?.devCommand || "npm run dev";
+  const devCommand = await prompt("Dev command", defaultDevCmd);
+  const configContent = `import { defineConfig } from '@nicmeriano/spool';
+
+export default defineConfig({
+  devCommand: '${devCommand}',
+});
+`;
+  fs.writeFileSync(configPath, configContent, "utf-8");
+  console.log(`
+Created spool.config.ts`);
+  const spoolDir = path.join(cwd, ".spool");
+  if (!fs.existsSync(spoolDir)) {
+    fs.mkdirSync(spoolDir, { recursive: true });
+    console.log("Created .spool/ directory");
+  }
+  const gitignorePath = path.join(cwd, ".gitignore");
+  if (fs.existsSync(gitignorePath)) {
+    const content = fs.readFileSync(gitignorePath, "utf-8");
+    if (!content.includes(".spool")) {
+      fs.appendFileSync(gitignorePath, "\n.spool/\n");
+      console.log("Added .spool/ to .gitignore");
+    }
+  }
+  console.log('\nDone! Run "spool open" to start.');
+  console.log("\nNote: If you're not using Vite, add this script tag to your HTML manually:");
+  console.log('  <script src="http://localhost:3142/inject.js"></script>\n');
+}
+
+// src/commands/open.ts
+import { spawn } from "child_process";
+
+// src/utils/load-config.ts
+import * as fs2 from "fs";
+import * as path2 from "path";
+async function loadConfig(cwd) {
+  const configPath = path2.resolve(cwd, "spool.config.ts");
+  if (!fs2.existsSync(configPath)) {
+    throw new Error(
+      `No spool.config.ts found in ${cwd}.
+Run "spool init" to create one.`
+    );
+  }
+  const { createJiti } = await import("jiti");
+  const jiti = createJiti(import.meta.url, { interopDefault: true });
+  const config = await jiti.import(configPath);
+  return config.default ?? config;
+}
+
+// src/utils/port.ts
+import * as net from "net";
+async function findAvailablePort(preferred) {
+  return new Promise((resolve2, reject) => {
+    const server = net.createServer();
+    server.listen(preferred, () => {
+      server.close(() => resolve2(preferred));
+    });
+    server.on("error", (err) => {
+      if (err.code === "EADDRINUSE") {
+        findAvailablePort(preferred + 1).then(resolve2).catch(reject);
+      } else {
+        reject(err);
+      }
+    });
+  });
+}
+
+// src/utils/browser.ts
+import { exec } from "child_process";
+function openBrowser(url) {
+  const platform = process.platform;
+  let command2;
+  if (platform === "darwin") {
+    command2 = `open "${url}"`;
+  } else if (platform === "win32") {
+    command2 = `start "${url}"`;
+  } else {
+    command2 = `xdg-open "${url}"`;
+  }
+  exec(command2, (error) => {
+    if (error) {
+      console.error(`Could not open browser: ${error.message}`);
+    }
+  });
+}
+
+// src/constants.ts
+var DEFAULT_SERVER_PORT = 3142;
+
+// src/commands/open.ts
+async function runOpen(cwd, options = {}) {
+  const config = await loadConfig(cwd);
+  if (!process.env.ANTHROPIC_API_KEY) {
+    console.warn("Warning: ANTHROPIC_API_KEY is not set. Claude features will not work.\n");
+  }
+  const preferredPort = options.port ?? config.port ?? DEFAULT_SERVER_PORT;
+  const port = await findAvailablePort(preferredPort);
+  if (port !== preferredPort) {
+    console.log(`Port ${preferredPort} is in use, using ${port} instead.`);
+  }
+  console.log(`Starting Spool server on port ${port}...`);
+  const { startServer } = await import("@nicmeriano/spool-server");
+  startServer({ port, cwd });
+  if (config.devCommand) {
+    console.log(`Starting dev server: ${config.devCommand}`);
+    const [cmd, ...args2] = config.devCommand.split(" ");
+    const child = spawn(cmd, args2, {
+      cwd,
+      stdio: "inherit",
+      shell: true
+    });
+    child.on("error", (error) => {
+      console.error(`Dev server error: ${error.message}`);
+    });
+    process.on("SIGINT", () => {
+      child.kill();
+      process.exit(0);
+    });
+    process.on("SIGTERM", () => {
+      child.kill();
+      process.exit(0);
+    });
+  }
+  if (!options.noOpen) {
+    const shellUrl = `http://localhost:${port}`;
+    console.log(`
+Opening Spool at ${shellUrl}
+`);
+    setTimeout(() => {
+      openBrowser(shellUrl);
+    }, 1e3);
+  } else {
+    console.log(`
+Spool server running at http://localhost:${port}
+`);
+  }
+}
+
+// src/cli.ts
+var args = process.argv.slice(2);
+var command = args[0];
+function printUsage() {
+  console.log(`
+Usage: spool <command> [options]
+
+Commands:
+  init          Initialize spool in your project
+  open          Start spool server and open the UI
+
+Options (open):
+  --port <n>    Server port (default: 3142)
+  --no-open     Don't open browser automatically
+
+Examples:
+  spool init
+  spool open
+  spool open --port 4000
+  spool open --no-open
+`);
+}
+async function main() {
+  const cwd = process.cwd();
+  switch (command) {
+    case "init":
+      await runInit(cwd);
+      break;
+    case "open": {
+      const portIndex = args.indexOf("--port");
+      const port = portIndex !== -1 ? parseInt(args[portIndex + 1], 10) : void 0;
+      const noOpen = args.includes("--no-open");
+      await runOpen(cwd, { port, noOpen });
+      break;
+    }
+    case "--help":
+    case "-h":
+    case void 0:
+      printUsage();
+      break;
+    default:
+      console.error(`Unknown command: ${command}`);
+      printUsage();
+      process.exit(1);
+  }
+}
+main().catch((error) => {
+  console.error(error.message || error);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/init.ts","../src/commands/open.ts","../src/utils/load-config.ts","../src/utils/port.ts","../src/utils/browser.ts","../src/constants.ts","../src/cli.ts"],"sourcesContent":["import * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport * as readline from 'node:readline';\n\n/**\n * Detect the project framework\n */\nfunction detectFramework(cwd: string): { name: string; devCommand: string } | null {\n  const pkgPath = path.join(cwd, 'package.json');\n  if (!fs.existsSync(pkgPath)) return null;\n\n  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));\n  const deps = { ...pkg.dependencies, ...pkg.devDependencies };\n\n  if (deps['next']) {\n    return { name: 'Next.js', devCommand: 'npm run dev' };\n  }\n  if (deps['vite']) {\n    return { name: 'Vite', devCommand: 'npm run dev' };\n  }\n  if (deps['react-scripts']) {\n    return { name: 'Create React App', devCommand: 'npm start' };\n  }\n\n  return null;\n}\n\n/**\n * Prompt the user for input\n */\nfunction prompt(question: string, defaultValue?: string): Promise<string> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  const displayDefault = defaultValue ? ` (${defaultValue})` : '';\n\n  return new Promise((resolve) => {\n    rl.question(`${question}${displayDefault}: `, (answer) => {\n      rl.close();\n      resolve(answer.trim() || defaultValue || '');\n    });\n  });\n}\n\n/**\n * Run the spool init command\n */\nexport async function runInit(cwd: string): Promise<void> {\n  console.log('Initializing Spool...\\n');\n\n  // Check if config already exists\n  const configPath = path.join(cwd, 'spool.config.ts');\n  if (fs.existsSync(configPath)) {\n    console.log('spool.config.ts already exists. Skipping.\\n');\n    return;\n  }\n\n  // Detect framework\n  const framework = detectFramework(cwd);\n  if (framework) {\n    console.log(`Detected framework: ${framework.name}\\n`);\n  }\n\n  // Prompt for dev command\n  const defaultDevCmd = framework?.devCommand || 'npm run dev';\n  const devCommand = await prompt('Dev command', defaultDevCmd);\n\n  // Write spool.config.ts\n  const configContent = `import { defineConfig } from '@nicmeriano/spool';\n\nexport default defineConfig({\n  devCommand: '${devCommand}',\n});\n`;\n\n  fs.writeFileSync(configPath, configContent, 'utf-8');\n  console.log(`\\nCreated spool.config.ts`);\n\n  // Create .spool directory\n  const spoolDir = path.join(cwd, '.spool');\n  if (!fs.existsSync(spoolDir)) {\n    fs.mkdirSync(spoolDir, { recursive: true });\n    console.log('Created .spool/ directory');\n  }\n\n  // Add .spool/ to .gitignore\n  const gitignorePath = path.join(cwd, '.gitignore');\n  if (fs.existsSync(gitignorePath)) {\n    const content = fs.readFileSync(gitignorePath, 'utf-8');\n    if (!content.includes('.spool')) {\n      fs.appendFileSync(gitignorePath, '\\n.spool/\\n');\n      console.log('Added .spool/ to .gitignore');\n    }\n  }\n\n  console.log('\\nDone! Run \"spool open\" to start.');\n  console.log('\\nNote: If you\\'re not using Vite, add this script tag to your HTML manually:');\n  console.log('  <script src=\"http://localhost:3142/inject.js\"></script>\\n');\n}\n","import { spawn } from 'node:child_process';\nimport { loadConfig } from '../utils/load-config.js';\nimport { findAvailablePort } from '../utils/port.js';\nimport { openBrowser } from '../utils/browser.js';\nimport { DEFAULT_SERVER_PORT } from '../constants.js';\n\nexport interface OpenOptions {\n  port?: number;\n  noOpen?: boolean;\n}\n\n/**\n * Run the spool open command\n */\nexport async function runOpen(cwd: string, options: OpenOptions = {}): Promise<void> {\n  // Load config\n  const config = await loadConfig(cwd);\n\n  // Check for ANTHROPIC_API_KEY\n  if (!process.env.ANTHROPIC_API_KEY) {\n    console.warn('Warning: ANTHROPIC_API_KEY is not set. Claude features will not work.\\n');\n  }\n\n  // Find available port\n  const preferredPort = options.port ?? config.port ?? DEFAULT_SERVER_PORT;\n  const port = await findAvailablePort(preferredPort);\n  if (port !== preferredPort) {\n    console.log(`Port ${preferredPort} is in use, using ${port} instead.`);\n  }\n\n  // Start the server\n  console.log(`Starting Spool server on port ${port}...`);\n  const { startServer } = await import('@nicmeriano/spool-server');\n\n  // Start server (runs in background)\n  startServer({ port, cwd });\n\n  // Spawn dev command if configured\n  if (config.devCommand) {\n    console.log(`Starting dev server: ${config.devCommand}`);\n    const [cmd, ...args] = config.devCommand.split(' ');\n    const child = spawn(cmd, args, {\n      cwd,\n      stdio: 'inherit',\n      shell: true,\n    });\n\n    child.on('error', (error) => {\n      console.error(`Dev server error: ${error.message}`);\n    });\n\n    // Clean up on exit\n    process.on('SIGINT', () => {\n      child.kill();\n      process.exit(0);\n    });\n    process.on('SIGTERM', () => {\n      child.kill();\n      process.exit(0);\n    });\n  }\n\n  // Open browser\n  if (!options.noOpen) {\n    const shellUrl = `http://localhost:${port}`;\n    console.log(`\\nOpening Spool at ${shellUrl}\\n`);\n\n    // Wait a moment for server to start\n    setTimeout(() => {\n      openBrowser(shellUrl);\n    }, 1000);\n  } else {\n    console.log(`\\nSpool server running at http://localhost:${port}\\n`);\n  }\n}\n","import * as fs from 'node:fs';\nimport * as path from 'node:path';\n\n/**\n * Load spool.config.ts from the project root\n */\nexport async function loadConfig(cwd: string): Promise<import('../config.js').SpoolConfig> {\n  const configPath = path.resolve(cwd, 'spool.config.ts');\n\n  if (!fs.existsSync(configPath)) {\n    throw new Error(\n      `No spool.config.ts found in ${cwd}.\\nRun \"spool init\" to create one.`\n    );\n  }\n\n  // Use jiti for TypeScript config loading\n  const { createJiti } = await import('jiti');\n  const jiti = createJiti(import.meta.url, { interopDefault: true });\n  const config = await jiti.import(configPath) as { default?: import('../config.js').SpoolConfig } & import('../config.js').SpoolConfig;\n\n  return config.default ?? config;\n}\n","import * as net from 'node:net';\n\n/**\n * Find an available port, starting from the preferred port\n */\nexport async function findAvailablePort(preferred: number): Promise<number> {\n  return new Promise((resolve, reject) => {\n    const server = net.createServer();\n    server.listen(preferred, () => {\n      server.close(() => resolve(preferred));\n    });\n    server.on('error', (err: NodeJS.ErrnoException) => {\n      if (err.code === 'EADDRINUSE') {\n        // Try next port\n        findAvailablePort(preferred + 1).then(resolve).catch(reject);\n      } else {\n        reject(err);\n      }\n    });\n  });\n}\n","import { exec } from 'node:child_process';\n\n/**\n * Open a URL in the default browser\n */\nexport function openBrowser(url: string): void {\n  const platform = process.platform;\n  let command: string;\n\n  if (platform === 'darwin') {\n    command = `open \"${url}\"`;\n  } else if (platform === 'win32') {\n    command = `start \"${url}\"`;\n  } else {\n    command = `xdg-open \"${url}\"`;\n  }\n\n  exec(command, (error) => {\n    if (error) {\n      console.error(`Could not open browser: ${error.message}`);\n    }\n  });\n}\n","export const DEFAULT_SERVER_PORT = 3142;\nexport const DEFAULT_APP_PORT = 5173;\n","import { runInit } from './commands/init.js';\nimport { runOpen } from './commands/open.js';\n\nconst args = process.argv.slice(2);\nconst command = args[0];\n\nfunction printUsage(): void {\n  console.log(`\nUsage: spool <command> [options]\n\nCommands:\n  init          Initialize spool in your project\n  open          Start spool server and open the UI\n\nOptions (open):\n  --port <n>    Server port (default: 3142)\n  --no-open     Don't open browser automatically\n\nExamples:\n  spool init\n  spool open\n  spool open --port 4000\n  spool open --no-open\n`);\n}\n\nasync function main(): Promise<void> {\n  const cwd = process.cwd();\n\n  switch (command) {\n    case 'init':\n      await runInit(cwd);\n      break;\n\n    case 'open': {\n      const portIndex = args.indexOf('--port');\n      const port = portIndex !== -1 ? parseInt(args[portIndex + 1], 10) : undefined;\n      const noOpen = args.includes('--no-open');\n      await runOpen(cwd, { port, noOpen });\n      break;\n    }\n\n    case '--help':\n    case '-h':\n    case undefined:\n      printUsage();\n      break;\n\n    default:\n      console.error(`Unknown command: ${command}`);\n      printUsage();\n      process.exit(1);\n  }\n}\n\nmain().catch((error) => {\n  console.error(error.message || error);\n  process.exit(1);\n});\n"],"mappings":"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","names":["resolve","fs","path","resolve","command","args"]}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+interface SpoolConfig {
+    /** Dev command to start the app (e.g., "npm run dev") */
+    devCommand?: string;
+    /** Server port (default: 3142) */
+    port?: number;
+}
+/**
+ * Helper to define a typed spool config
+ */
+declare function defineConfig(config: SpoolConfig): SpoolConfig;
+
+export { type SpoolConfig, defineConfig };

package/dist/index.js

@@ -0,0 +1,8 @@
+// src/config.ts
+function defineConfig(config) {
+  return config;
+}
+export {
+  defineConfig
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"sourcesContent":["export interface SpoolConfig {\n  /** Dev command to start the app (e.g., \"npm run dev\") */\n  devCommand?: string;\n  /** Server port (default: 3142) */\n  port?: number;\n}\n\n/**\n * Helper to define a typed spool config\n */\nexport function defineConfig(config: SpoolConfig): SpoolConfig {\n  return config;\n}\n"],"mappings":";AAUO,SAAS,aAAa,QAAkC;AAC7D,SAAO;AACT;","names":[]}

package/dist/vite.d.ts

@@ -0,0 +1,14 @@
+import { Plugin } from 'vite';
+
+interface SpoolVitePluginOptions {
+    /** Spool server port (default: 3142) */
+    port?: number;
+}
+/**
+ * Vite plugin for Spool
+ * - Removes X-Frame-Options header to allow iframe embedding
+ * - Injects the inject.js script tag
+ */
+declare function spool(options?: SpoolVitePluginOptions): Plugin;
+
+export { type SpoolVitePluginOptions, spool as default, spool };

package/dist/vite.js

@@ -0,0 +1,70 @@
+// src/vite.ts
+import { readFileSync } from "fs";
+import { resolve } from "path";
+function resolveServerPort(configuredPort) {
+  try {
+    const portFile = resolve(process.cwd(), ".spool/port");
+    const content = readFileSync(portFile, "utf-8").trim();
+    const discovered = parseInt(content, 10);
+    if (!isNaN(discovered) && discovered > 0) return discovered;
+  } catch {
+  }
+  return configuredPort;
+}
+function reportAppUrl(appUrl, configuredPort, retriesLeft = 10) {
+  const serverPort = resolveServerPort(configuredPort);
+  fetch(`http://localhost:${serverPort}/api/app-url`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ url: appUrl })
+  }).then((res) => {
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    console.log(`[spool] Reported app URL ${appUrl} to server on port ${serverPort}`);
+  }).catch(() => {
+    if (retriesLeft > 0) {
+      setTimeout(() => reportAppUrl(appUrl, configuredPort, retriesLeft - 1), 1e3);
+    } else {
+      console.warn(`[spool] Failed to report app URL to server after retries`);
+    }
+  });
+}
+function spool(options = {}) {
+  const configuredPort = options.port ?? 3142;
+  return {
+    name: "spool",
+    configureServer(server) {
+      server.middlewares.use((_req, res, next) => {
+        const originalWriteHead = res.writeHead.bind(res);
+        res.writeHead = function(...args) {
+          res.removeHeader("X-Frame-Options");
+          return originalWriteHead(...args);
+        };
+        next();
+      });
+      server.httpServer?.on("listening", () => {
+        const addr = server.httpServer?.address();
+        if (addr && typeof addr === "object") {
+          reportAppUrl(`http://localhost:${addr.port}`, configuredPort);
+        }
+      });
+    },
+    transformIndexHtml() {
+      const serverPort = resolveServerPort(configuredPort);
+      return [
+        {
+          tag: "script",
+          attrs: {
+            src: `http://localhost:${serverPort}/inject.js`
+          },
+          injectTo: "head"
+        }
+      ];
+    }
+  };
+}
+var vite_default = spool;
+export {
+  vite_default as default,
+  spool
+};
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport type { Plugin } from 'vite';\n\nexport interface SpoolVitePluginOptions {\n  /** Spool server port (default: 3142) */\n  port?: number;\n}\n\n/**\n * Read the actual Spool server port from .spool/port (written by the server on startup).\n * Falls back to the configured port if the file doesn't exist yet.\n */\nfunction resolveServerPort(configuredPort: number): number {\n  try {\n    const portFile = resolve(process.cwd(), '.spool/port');\n    const content = readFileSync(portFile, 'utf-8').trim();\n    const discovered = parseInt(content, 10);\n    if (!isNaN(discovered) && discovered > 0) return discovered;\n  } catch {\n    // File doesn't exist yet — server may not have started\n  }\n  return configuredPort;\n}\n\n/**\n * Try to POST the app URL to the Spool server, retrying if the server isn't ready yet.\n * Re-reads .spool/port on each attempt so it picks up late-starting servers.\n * Validates the response to ensure we're talking to the actual Spool server.\n */\nfunction reportAppUrl(\n  appUrl: string,\n  configuredPort: number,\n  retriesLeft: number = 10\n): void {\n  const serverPort = resolveServerPort(configuredPort);\n  fetch(`http://localhost:${serverPort}/api/app-url`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ url: appUrl }),\n  })\n    .then((res) => {\n      if (!res.ok) throw new Error(`HTTP ${res.status}`);\n      console.log(`[spool] Reported app URL ${appUrl} to server on port ${serverPort}`);\n    })\n    .catch(() => {\n      if (retriesLeft > 0) {\n        setTimeout(() => reportAppUrl(appUrl, configuredPort, retriesLeft - 1), 1000);\n      } else {\n        console.warn(`[spool] Failed to report app URL to server after retries`);\n      }\n    });\n}\n\n/**\n * Vite plugin for Spool\n * - Removes X-Frame-Options header to allow iframe embedding\n * - Injects the inject.js script tag\n */\nexport function spool(options: SpoolVitePluginOptions = {}): Plugin {\n  const configuredPort = options.port ?? 3142;\n\n  return {\n    name: 'spool',\n\n    configureServer(server) {\n      // Remove X-Frame-Options to allow iframe embedding\n      server.middlewares.use((_req, res, next) => {\n        const originalWriteHead = res.writeHead.bind(res) as typeof res.writeHead;\n        res.writeHead = function (...args: Parameters<typeof originalWriteHead>) {\n          res.removeHeader('X-Frame-Options');\n          return originalWriteHead(...args);\n        } as typeof res.writeHead;\n        next();\n      });\n\n      // Report actual bound port to Spool server (retries if server isn't ready)\n      server.httpServer?.on('listening', () => {\n        const addr = server.httpServer?.address();\n        if (addr && typeof addr === 'object') {\n          reportAppUrl(`http://localhost:${addr.port}`, configuredPort);\n        }\n      });\n    },\n\n    transformIndexHtml() {\n      const serverPort = resolveServerPort(configuredPort);\n      return [\n        {\n          tag: 'script',\n          attrs: {\n            src: `http://localhost:${serverPort}/inject.js`,\n          },\n          injectTo: 'head',\n        },\n      ];\n    },\n  };\n}\n\nexport default spool;\n"],"mappings":";AAAA,SAAS,oBAAoB;AAC7B,SAAS,eAAe;AAYxB,SAAS,kBAAkB,gBAAgC;AACzD,MAAI;AACF,UAAM,WAAW,QAAQ,QAAQ,IAAI,GAAG,aAAa;AACrD,UAAM,UAAU,aAAa,UAAU,OAAO,EAAE,KAAK;AACrD,UAAM,aAAa,SAAS,SAAS,EAAE;AACvC,QAAI,CAAC,MAAM,UAAU,KAAK,aAAa,EAAG,QAAO;AAAA,EACnD,QAAQ;AAAA,EAER;AACA,SAAO;AACT;AAOA,SAAS,aACP,QACA,gBACA,cAAsB,IAChB;AACN,QAAM,aAAa,kBAAkB,cAAc;AACnD,QAAM,oBAAoB,UAAU,gBAAgB;AAAA,IAClD,QAAQ;AAAA,IACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,IAC9C,MAAM,KAAK,UAAU,EAAE,KAAK,OAAO,CAAC;AAAA,EACtC,CAAC,EACE,KAAK,CAAC,QAAQ;AACb,QAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,QAAQ,IAAI,MAAM,EAAE;AACjD,YAAQ,IAAI,4BAA4B,MAAM,sBAAsB,UAAU,EAAE;AAAA,EAClF,CAAC,EACA,MAAM,MAAM;AACX,QAAI,cAAc,GAAG;AACnB,iBAAW,MAAM,aAAa,QAAQ,gBAAgB,cAAc,CAAC,GAAG,GAAI;AAAA,IAC9E,OAAO;AACL,cAAQ,KAAK,0DAA0D;AAAA,IACzE;AAAA,EACF,CAAC;AACL;AAOO,SAAS,MAAM,UAAkC,CAAC,GAAW;AAClE,QAAM,iBAAiB,QAAQ,QAAQ;AAEvC,SAAO;AAAA,IACL,MAAM;AAAA,IAEN,gBAAgB,QAAQ;AAEtB,aAAO,YAAY,IAAI,CAAC,MAAM,KAAK,SAAS;AAC1C,cAAM,oBAAoB,IAAI,UAAU,KAAK,GAAG;AAChD,YAAI,YAAY,YAAa,MAA4C;AACvE,cAAI,aAAa,iBAAiB;AAClC,iBAAO,kBAAkB,GAAG,IAAI;AAAA,QAClC;AACA,aAAK;AAAA,MACP,CAAC;AAGD,aAAO,YAAY,GAAG,aAAa,MAAM;AACvC,cAAM,OAAO,OAAO,YAAY,QAAQ;AACxC,YAAI,QAAQ,OAAO,SAAS,UAAU;AACpC,uBAAa,oBAAoB,KAAK,IAAI,IAAI,cAAc;AAAA,QAC9D;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IAEA,qBAAqB;AACnB,YAAM,aAAa,kBAAkB,cAAc;AACnD,aAAO;AAAA,QACL;AAAA,UACE,KAAK;AAAA,UACL,OAAO;AAAA,YACL,KAAK,oBAAoB,UAAU;AAAA,UACrC;AAAA,UACA,UAAU;AAAA,QACZ;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,eAAQ;","names":[]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@nicmeriano/spool",
+  "version": "0.0.1",
+  "description": "Spool CLI - UI feedback tool for Claude Code",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "spool": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./vite": {
+      "import": "./dist/vite.js",
+      "types": "./dist/vite.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "spool",
+    "claude",
+    "ui-feedback",
+    "cli"
+  ],
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nicmeriano/react-inspect.git",
+    "directory": "packages/spool"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "jiti": "^2.4.0",
+    "@nicmeriano/spool-server": "0.0.1"
+  },
+  "peerDependencies": {
+    "vite": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  }
+}