@aprovan/patchwork-ink 0.1.0-dev.03aaf5b

package/dist/chunk-FQPGY42H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runner.ts"],"sourcesContent":["/**\n * @aprovan/patchwork-ink - Runner\n *\n * Provides the runtime mounting logic for Ink terminal widgets.\n * The image owns all ink/react dependencies and mounting code.\n */\n\nimport type { WriteStream } from 'node:tty';\nimport { render } from 'ink';\nimport React from 'react';\n\n/**\n * Global injections for compiling widgets with this image\n *\n * These tell the compiler which imports to transform into global variable references.\n * The evaluateWidget function will provide these globals at runtime.\n */\nexport interface GlobalInjection {\n  module: string;\n  globalName: string;\n}\n\nexport function getGlobals(): GlobalInjection[] {\n  return [\n    { module: 'react', globalName: '__REACT__' },\n    { module: 'ink', globalName: '__INK__' },\n  ];\n}\n\nexport interface RunnerOptions {\n  /** Service proxy for UTCP calls */\n  proxy?: {\n    call(\n      namespace: string,\n      procedure: string,\n      args: unknown[],\n    ): Promise<unknown>;\n  };\n  /** Initial props/inputs to pass to widget */\n  inputs?: Record<string, unknown>;\n  /** Output stream (default: process.stdout) */\n  stdout?: WriteStream;\n  /** Input stream (default: process.stdin) */\n  stdin?: NodeJS.ReadStream;\n  /** Exit on Ctrl+C (default: true) */\n  exitOnCtrlC?: boolean;\n}\n\nexport interface RunnerInstance {\n  /** Unique mount ID */\n  id: string;\n  /** Unmount the widget */\n  unmount: () => void;\n  /** Wait until the widget exits */\n  waitUntilExit: () => Promise<void>;\n  /** Rerender with new props */\n  rerender: (props: Record<string, unknown>) => void;\n  /** Clear the terminal output */\n  clear: () => void;\n}\n\nlet mountCounter = 0;\n\nfunction generateMountId(): string {\n  return `patchwork-ink-${Date.now()}-${++mountCounter}`;\n}\n\n/**\n * Generate namespace globals that proxy calls to a service proxy\n *\n * Given services like [\"git.branch\", \"git.status\", \"github.repos.get\"],\n * generates globals with appropriate methods.\n */\nfunction generateNamespaceGlobals(\n  services: string[],\n  proxy: RunnerOptions['proxy'],\n): Record<string, unknown> {\n  if (!proxy) return {};\n\n  const namespaces: Record<string, Record<string, unknown>> = {};\n\n  for (const service of services) {\n    const parts = service.split('.');\n    if (parts.length < 2) continue;\n\n    const namespace = parts[0] as string;\n    const procedurePath = parts.slice(1);\n\n    if (!namespaces[namespace]) {\n      namespaces[namespace] = {};\n    }\n\n    let current = namespaces[namespace] as Record<string, unknown>;\n    for (let i = 0; i < procedurePath.length - 1; i++) {\n      const key = procedurePath[i] as string;\n      if (!current[key]) {\n        current[key] = {};\n      }\n      current = current[key] as Record<string, unknown>;\n    }\n\n    const finalKey = procedurePath[procedurePath.length - 1] as string;\n    const fullProcedure = procedurePath.join('.');\n    current[finalKey] = (...args: unknown[]) =>\n      proxy.call(namespace, fullProcedure, args);\n  }\n\n  return namespaces;\n}\n\n/**\n * Extract unique namespace names from services array\n */\nfunction extractNamespaces(services: string[]): string[] {\n  const namespaces = new Set<string>();\n  for (const service of services) {\n    const parts = service.split('.');\n    if (parts[0]) {\n      namespaces.add(parts[0]);\n    }\n  }\n  return Array.from(namespaces);\n}\n\n/**\n * Inject namespace globals into globalThis\n */\nfunction injectNamespaceGlobals(namespaces: Record<string, unknown>): void {\n  for (const [name, value] of Object.entries(namespaces)) {\n    (globalThis as Record<string, unknown>)[name] = value;\n  }\n}\n\n/**\n * Remove namespace globals from globalThis\n */\nfunction removeNamespaceGlobals(namespaceNames: string[]): void {\n  for (const name of namespaceNames) {\n    delete (globalThis as Record<string, unknown>)[name];\n  }\n}\n\nexport interface CompiledWidget {\n  /** Compiled ESM code */\n  code: string;\n  /** Content hash for caching */\n  hash: string;\n  /** Original manifest */\n  manifest: {\n    name: string;\n    services?: string[];\n    [key: string]: unknown;\n  };\n}\n\n/**\n * Run a compiled widget using Ink\n *\n * This is the main entry point for running terminal widgets.\n * The image owns all React/Ink dependencies.\n */\nexport async function run(\n  widget: CompiledWidget,\n  options: RunnerOptions = {},\n): Promise<RunnerInstance> {\n  const {\n    proxy,\n    inputs = {},\n    stdout = process.stdout as WriteStream,\n    stdin = process.stdin,\n    exitOnCtrlC = true,\n  } = options;\n  const mountId = generateMountId();\n\n  // Inject namespace globals for services\n  const services = widget.manifest.services || [];\n  const namespaceNames = extractNamespaces(services);\n  const namespaces = generateNamespaceGlobals(services, proxy);\n  injectNamespaceGlobals(namespaces);\n\n  // Import the widget module from code\n  const dataUri = `data:text/javascript;base64,${Buffer.from(\n    widget.code,\n  ).toString('base64')}`;\n\n  let module: { default?: unknown };\n  try {\n    module = await import(/* webpackIgnore: true */ /* @vite-ignore */ dataUri);\n  } catch {\n    // Fallback: use Function-based loading\n    const AsyncFunction = Object.getPrototypeOf(async function () {})\n      .constructor as new (argName: string, code: string) => (\n      exports: Record<string, unknown>,\n    ) => Promise<Record<string, unknown>>;\n    const exports: Record<string, unknown> = {};\n    const fn = new AsyncFunction('exports', widget.code + '\\nreturn exports;');\n    module = await fn(exports);\n  }\n\n  const Component = module.default;\n  if (!Component) {\n    removeNamespaceGlobals(namespaceNames);\n    throw new Error('Widget must export a default component');\n  }\n\n  if (typeof Component !== 'function') {\n    removeNamespaceGlobals(namespaceNames);\n    throw new Error('Widget default export must be a function/component');\n  }\n\n  // Render using Ink\n  let currentInputs = { ...inputs };\n  const element = React.createElement(\n    Component as React.ComponentType,\n    currentInputs,\n  );\n  const instance = render(element, {\n    stdout,\n    stdin,\n    exitOnCtrlC,\n  });\n\n  return {\n    id: mountId,\n    unmount() {\n      instance.unmount();\n      removeNamespaceGlobals(namespaceNames);\n    },\n    waitUntilExit() {\n      return instance.waitUntilExit();\n    },\n    rerender(newInputs: Record<string, unknown>) {\n      currentInputs = { ...currentInputs, ...newInputs };\n      const newElement = React.createElement(\n        Component as React.ComponentType,\n        currentInputs,\n      );\n      instance.rerender(newElement);\n    },\n    clear() {\n      instance.clear();\n    },\n  };\n}\n\n/**\n * Run a widget once and wait for exit\n */\nexport async function runOnce(\n  widget: CompiledWidget,\n  options: RunnerOptions = {},\n): Promise<void> {\n  const instance = await run(widget, options);\n  await instance.waitUntilExit();\n  instance.unmount();\n}\n\n/**\n * Evaluate widget code and return the component\n *\n * This is used for more advanced scenarios where you need\n * direct access to the component.\n */\nexport async function evaluateWidget(\n  code: string,\n  services: Record<string, unknown> = {},\n): Promise<React.ComponentType<{ services?: Record<string, unknown> }>> {\n  // Store services for widget access\n  (globalThis as Record<string, unknown>).__PATCHWORK_SERVICES__ = services;\n\n  // Inject globals that the compiled code expects\n  const __EXPORTS__: Record<string, unknown> = {};\n  const __REACT__ = React;\n  const __INK__ = await import('ink');\n\n  // Execute the transformed code with injected globals\n  const fn = new Function('__EXPORTS__', '__REACT__', '__INK__', code);\n  fn(__EXPORTS__, __REACT__, __INK__);\n\n  const Component =\n    __EXPORTS__.default ||\n    __EXPORTS__.Widget ||\n    Object.values(__EXPORTS__).find(\n      (v): v is React.ComponentType => typeof v === 'function',\n    );\n\n  if (!Component) {\n    throw new Error('No default export or Widget component found');\n  }\n\n  return Component as React.ComponentType<{\n    services?: Record<string, unknown>;\n  }>;\n}\n\n/**\n * Render a component directly with Ink\n *\n * For cases where you already have an evaluated component.\n */\nexport function renderComponent(\n  Component: React.ComponentType<Record<string, unknown>>,\n  props: Record<string, unknown> = {},\n  options: Omit<RunnerOptions, 'proxy' | 'inputs'> = {},\n): RunnerInstance {\n  const {\n    stdout = process.stdout as WriteStream,\n    stdin = process.stdin,\n    exitOnCtrlC = true,\n  } = options;\n  const mountId = generateMountId();\n\n  let currentProps = { ...props };\n  const element = React.createElement(Component, currentProps);\n  const instance = render(element, {\n    stdout,\n    stdin,\n    exitOnCtrlC,\n  });\n\n  return {\n    id: mountId,\n    unmount: () => instance.unmount(),\n    waitUntilExit: () => instance.waitUntilExit(),\n    rerender(newProps: Record<string, unknown>) {\n      currentProps = { ...currentProps, ...newProps };\n      instance.rerender(React.createElement(Component, currentProps));\n    },\n    clear: () => instance.clear(),\n  };\n}\n"],"mappings":";AAQA,SAAS,cAAc;AACvB,OAAO,WAAW;AAaX,SAAS,aAAgC;AAC9C,SAAO;AAAA,IACL,EAAE,QAAQ,SAAS,YAAY,YAAY;AAAA,IAC3C,EAAE,QAAQ,OAAO,YAAY,UAAU;AAAA,EACzC;AACF;AAkCA,IAAI,eAAe;AAEnB,SAAS,kBAA0B;AACjC,SAAO,iBAAiB,KAAK,IAAI,CAAC,IAAI,EAAE,YAAY;AACtD;AAQA,SAAS,yBACP,UACA,OACyB;AACzB,MAAI,CAAC,MAAO,QAAO,CAAC;AAEpB,QAAM,aAAsD,CAAC;AAE7D,aAAW,WAAW,UAAU;AAC9B,UAAM,QAAQ,QAAQ,MAAM,GAAG;AAC/B,QAAI,MAAM,SAAS,EAAG;AAEtB,UAAM,YAAY,MAAM,CAAC;AACzB,UAAM,gBAAgB,MAAM,MAAM,CAAC;AAEnC,QAAI,CAAC,WAAW,SAAS,GAAG;AAC1B,iBAAW,SAAS,IAAI,CAAC;AAAA,IAC3B;AAEA,QAAI,UAAU,WAAW,SAAS;AAClC,aAAS,IAAI,GAAG,IAAI,cAAc,SAAS,GAAG,KAAK;AACjD,YAAM,MAAM,cAAc,CAAC;AAC3B,UAAI,CAAC,QAAQ,GAAG,GAAG;AACjB,gBAAQ,GAAG,IAAI,CAAC;AAAA,MAClB;AACA,gBAAU,QAAQ,GAAG;AAAA,IACvB;AAEA,UAAM,WAAW,cAAc,cAAc,SAAS,CAAC;AACvD,UAAM,gBAAgB,cAAc,KAAK,GAAG;AAC5C,YAAQ,QAAQ,IAAI,IAAI,SACtB,MAAM,KAAK,WAAW,eAAe,IAAI;AAAA,EAC7C;AAEA,SAAO;AACT;AAKA,SAAS,kBAAkB,UAA8B;AACvD,QAAM,aAAa,oBAAI,IAAY;AACnC,aAAW,WAAW,UAAU;AAC9B,UAAM,QAAQ,QAAQ,MAAM,GAAG;AAC/B,QAAI,MAAM,CAAC,GAAG;AACZ,iBAAW,IAAI,MAAM,CAAC,CAAC;AAAA,IACzB;AAAA,EACF;AACA,SAAO,MAAM,KAAK,UAAU;AAC9B;AAKA,SAAS,uBAAuB,YAA2C;AACzE,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,UAAU,GAAG;AACtD,IAAC,WAAuC,IAAI,IAAI;AAAA,EAClD;AACF;AAKA,SAAS,uBAAuB,gBAAgC;AAC9D,aAAW,QAAQ,gBAAgB;AACjC,WAAQ,WAAuC,IAAI;AAAA,EACrD;AACF;AAqBA,eAAsB,IACpB,QACA,UAAyB,CAAC,GACD;AACzB,QAAM;AAAA,IACJ;AAAA,IACA,SAAS,CAAC;AAAA,IACV,SAAS,QAAQ;AAAA,IACjB,QAAQ,QAAQ;AAAA,IAChB,cAAc;AAAA,EAChB,IAAI;AACJ,QAAM,UAAU,gBAAgB;AAGhC,QAAM,WAAW,OAAO,SAAS,YAAY,CAAC;AAC9C,QAAM,iBAAiB,kBAAkB,QAAQ;AACjD,QAAM,aAAa,yBAAyB,UAAU,KAAK;AAC3D,yBAAuB,UAAU;AAGjC,QAAM,UAAU,+BAA+B,OAAO;AAAA,IACpD,OAAO;AAAA,EACT,EAAE,SAAS,QAAQ,CAAC;AAEpB,MAAI;AACJ,MAAI;AACF,aAAS,MAAM;AAAA;AAAA;AAAA,MAAoD;AAAA;AAAA,EACrE,QAAQ;AAEN,UAAM,gBAAgB,OAAO,eAAe,iBAAkB;AAAA,IAAC,CAAC,EAC7D;AAGH,UAAM,UAAmC,CAAC;AAC1C,UAAM,KAAK,IAAI,cAAc,WAAW,OAAO,OAAO,mBAAmB;AACzE,aAAS,MAAM,GAAG,OAAO;AAAA,EAC3B;AAEA,QAAM,YAAY,OAAO;AACzB,MAAI,CAAC,WAAW;AACd,2BAAuB,cAAc;AACrC,UAAM,IAAI,MAAM,wCAAwC;AAAA,EAC1D;AAEA,MAAI,OAAO,cAAc,YAAY;AACnC,2BAAuB,cAAc;AACrC,UAAM,IAAI,MAAM,oDAAoD;AAAA,EACtE;AAGA,MAAI,gBAAgB,EAAE,GAAG,OAAO;AAChC,QAAM,UAAU,MAAM;AAAA,IACpB;AAAA,IACA;AAAA,EACF;AACA,QAAM,WAAW,OAAO,SAAS;AAAA,IAC/B;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,UAAU;AACR,eAAS,QAAQ;AACjB,6BAAuB,cAAc;AAAA,IACvC;AAAA,IACA,gBAAgB;AACd,aAAO,SAAS,cAAc;AAAA,IAChC;AAAA,IACA,SAAS,WAAoC;AAC3C,sBAAgB,EAAE,GAAG,eAAe,GAAG,UAAU;AACjD,YAAM,aAAa,MAAM;AAAA,QACvB;AAAA,QACA;AAAA,MACF;AACA,eAAS,SAAS,UAAU;AAAA,IAC9B;AAAA,IACA,QAAQ;AACN,eAAS,MAAM;AAAA,IACjB;AAAA,EACF;AACF;AAKA,eAAsB,QACpB,QACA,UAAyB,CAAC,GACX;AACf,QAAM,WAAW,MAAM,IAAI,QAAQ,OAAO;AAC1C,QAAM,SAAS,cAAc;AAC7B,WAAS,QAAQ;AACnB;AAQA,eAAsB,eACpB,MACA,WAAoC,CAAC,GACiC;AAEtE,EAAC,WAAuC,yBAAyB;AAGjE,QAAM,cAAuC,CAAC;AAC9C,QAAM,YAAY;AAClB,QAAM,UAAU,MAAM,OAAO,KAAK;AAGlC,QAAM,KAAK,IAAI,SAAS,eAAe,aAAa,WAAW,IAAI;AACnE,KAAG,aAAa,WAAW,OAAO;AAElC,QAAM,YACJ,YAAY,WACZ,YAAY,UACZ,OAAO,OAAO,WAAW,EAAE;AAAA,IACzB,CAAC,MAAgC,OAAO,MAAM;AAAA,EAChD;AAEF,MAAI,CAAC,WAAW;AACd,UAAM,IAAI,MAAM,6CAA6C;AAAA,EAC/D;AAEA,SAAO;AAGT;AAOO,SAAS,gBACd,WACA,QAAiC,CAAC,GAClC,UAAmD,CAAC,GACpC;AAChB,QAAM;AAAA,IACJ,SAAS,QAAQ;AAAA,IACjB,QAAQ,QAAQ;AAAA,IAChB,cAAc;AAAA,EAChB,IAAI;AACJ,QAAM,UAAU,gBAAgB;AAEhC,MAAI,eAAe,EAAE,GAAG,MAAM;AAC9B,QAAM,UAAU,MAAM,cAAc,WAAW,YAAY;AAC3D,QAAM,WAAW,OAAO,SAAS;AAAA,IAC/B;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,SAAS,MAAM,SAAS,QAAQ;AAAA,IAChC,eAAe,MAAM,SAAS,cAAc;AAAA,IAC5C,SAAS,UAAmC;AAC1C,qBAAe,EAAE,GAAG,cAAc,GAAG,SAAS;AAC9C,eAAS,SAAS,MAAM,cAAc,WAAW,YAAY,CAAC;AAAA,IAChE;AAAA,IACA,OAAO,MAAM,SAAS,MAAM;AAAA,EAC9B;AACF;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { InkEnvironment, SetupOptions, cleanup, setup } from './setup.js';
+export { CompiledWidget, GlobalInjection, RunnerInstance, RunnerOptions, evaluateWidget, getGlobals, renderComponent, run, runOnce } from './runner.js';
+export { Box, Newline, Spacer, Static, Text, Transform, render, useApp, useFocus, useFocusManager, useInput, useStderr, useStdin, useStdout } from 'ink';
+export { default as React } from 'react';
+export { default as chalk } from 'chalk';
+import 'node:tty';

package/dist/index.js

@@ -0,0 +1,57 @@
+import {
+  evaluateWidget,
+  getGlobals,
+  renderComponent,
+  run,
+  runOnce
+} from "./chunk-FQPGY42H.js";
+import {
+  cleanup,
+  setup
+} from "./chunk-5NAXJKRC.js";
+
+// src/index.ts
+import {
+  render,
+  Box,
+  Text,
+  Static,
+  Transform,
+  Newline,
+  Spacer,
+  useInput,
+  useApp,
+  useFocus,
+  useFocusManager,
+  useStdin,
+  useStdout,
+  useStderr
+} from "ink";
+import { default as default2 } from "react";
+import { default as default3 } from "chalk";
+export {
+  Box,
+  Newline,
+  default2 as React,
+  Spacer,
+  Static,
+  Text,
+  Transform,
+  default3 as chalk,
+  cleanup,
+  evaluateWidget,
+  getGlobals,
+  render,
+  renderComponent,
+  run,
+  runOnce,
+  setup,
+  useApp,
+  useFocus,
+  useFocusManager,
+  useInput,
+  useStderr,
+  useStdin,
+  useStdout
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @aprovan/patchwork-image-ink\n *\n * Ink terminal UI image for CLI widgets.\n * Provides React components for building terminal interfaces.\n */\n\nexport { setup, cleanup } from './setup.js';\nexport type { SetupOptions, InkEnvironment } from './setup.js';\n\n// Runner - mounting/execution for terminal widgets\nexport {\n  run,\n  runOnce,\n  evaluateWidget,\n  renderComponent,\n  getGlobals,\n} from './runner.js';\nexport type {\n  RunnerOptions,\n  RunnerInstance,\n  CompiledWidget,\n  GlobalInjection,\n} from './runner.js';\n\n// Re-export Ink components for convenience\nexport {\n  render,\n  Box,\n  Text,\n  Static,\n  Transform,\n  Newline,\n  Spacer,\n  useInput,\n  useApp,\n  useFocus,\n  useFocusManager,\n  useStdin,\n  useStdout,\n  useStderr,\n} from 'ink';\n\n// Re-export React for widget authors\nexport { default as React } from 'react';\n\n// Re-export chalk for styling\nexport { default as chalk } from 'chalk';\n"],"mappings":";;;;;;;;;;;;;AA0BA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAoB,WAAXA,gBAAwB;AAGjC,SAAoB,WAAXA,gBAAwB;","names":["default"]}

package/dist/runner.d.ts

@@ -0,0 +1,87 @@
+import { WriteStream } from 'node:tty';
+import React from 'react';
+
+/**
+ * @aprovan/patchwork-ink - Runner
+ *
+ * Provides the runtime mounting logic for Ink terminal widgets.
+ * The image owns all ink/react dependencies and mounting code.
+ */
+
+/**
+ * Global injections for compiling widgets with this image
+ *
+ * These tell the compiler which imports to transform into global variable references.
+ * The evaluateWidget function will provide these globals at runtime.
+ */
+interface GlobalInjection {
+    module: string;
+    globalName: string;
+}
+declare function getGlobals(): GlobalInjection[];
+interface RunnerOptions {
+    /** Service proxy for UTCP calls */
+    proxy?: {
+        call(namespace: string, procedure: string, args: unknown[]): Promise<unknown>;
+    };
+    /** Initial props/inputs to pass to widget */
+    inputs?: Record<string, unknown>;
+    /** Output stream (default: process.stdout) */
+    stdout?: WriteStream;
+    /** Input stream (default: process.stdin) */
+    stdin?: NodeJS.ReadStream;
+    /** Exit on Ctrl+C (default: true) */
+    exitOnCtrlC?: boolean;
+}
+interface RunnerInstance {
+    /** Unique mount ID */
+    id: string;
+    /** Unmount the widget */
+    unmount: () => void;
+    /** Wait until the widget exits */
+    waitUntilExit: () => Promise<void>;
+    /** Rerender with new props */
+    rerender: (props: Record<string, unknown>) => void;
+    /** Clear the terminal output */
+    clear: () => void;
+}
+interface CompiledWidget {
+    /** Compiled ESM code */
+    code: string;
+    /** Content hash for caching */
+    hash: string;
+    /** Original manifest */
+    manifest: {
+        name: string;
+        services?: string[];
+        [key: string]: unknown;
+    };
+}
+/**
+ * Run a compiled widget using Ink
+ *
+ * This is the main entry point for running terminal widgets.
+ * The image owns all React/Ink dependencies.
+ */
+declare function run(widget: CompiledWidget, options?: RunnerOptions): Promise<RunnerInstance>;
+/**
+ * Run a widget once and wait for exit
+ */
+declare function runOnce(widget: CompiledWidget, options?: RunnerOptions): Promise<void>;
+/**
+ * Evaluate widget code and return the component
+ *
+ * This is used for more advanced scenarios where you need
+ * direct access to the component.
+ */
+declare function evaluateWidget(code: string, services?: Record<string, unknown>): Promise<React.ComponentType<{
+    services?: Record<string, unknown>;
+}>>;
+/**
+ * Render a component directly with Ink
+ *
+ * For cases where you already have an evaluated component.
+ */
+declare function renderComponent(Component: React.ComponentType<Record<string, unknown>>, props?: Record<string, unknown>, options?: Omit<RunnerOptions, 'proxy' | 'inputs'>): RunnerInstance;
+
+export { type CompiledWidget, type GlobalInjection, type RunnerInstance, type RunnerOptions, evaluateWidget, getGlobals, renderComponent, run, runOnce };

package/dist/runner.js

@@ -0,0 +1,15 @@
+import {
+  evaluateWidget,
+  getGlobals,
+  renderComponent,
+  run,
+  runOnce
+} from "./chunk-FQPGY42H.js";
+export {
+  evaluateWidget,
+  getGlobals,
+  renderComponent,
+  run,
+  runOnce
+};
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/setup.d.ts

@@ -0,0 +1,40 @@
+import { WriteStream } from 'node:tty';
+
+/**
+ * @aprovan/patchwork-image-ink
+ *
+ * Setup function for the Ink terminal UI image.
+ * Handles terminal environment configuration for CLI widgets.
+ */
+
+interface SetupOptions {
+    /** Output stream (default: process.stdout) */
+    stdout?: WriteStream;
+    /** Input stream (default: process.stdin) */
+    stdin?: NodeJS.ReadStream;
+    /** Enable color support detection override */
+    colorMode?: 'detect' | 'ansi' | 'ansi256' | 'truecolor' | 'none';
+    /** Enable debug mode (default: false) */
+    debug?: boolean;
+}
+interface InkEnvironment {
+    stdout: WriteStream;
+    stdin: NodeJS.ReadStream;
+    colorSupport: 'none' | 'ansi' | 'ansi256' | 'truecolor';
+    isInteractive: boolean;
+    columns: number;
+    rows: number;
+}
+/**
+ * Setup the Ink terminal UI image runtime environment
+ *
+ * @param options - Optional configuration
+ * @returns Environment configuration for Ink
+ */
+declare function setup(options?: SetupOptions): InkEnvironment;
+/**
+ * Cleanup - no-op for CLI but provided for API consistency
+ */
+declare function cleanup(): void;
+
+export { type InkEnvironment, type SetupOptions, cleanup, setup };

package/dist/setup.js

@@ -0,0 +1,9 @@
+import {
+  cleanup,
+  setup
+} from "./chunk-5NAXJKRC.js";
+export {
+  cleanup,
+  setup
+};
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@aprovan/patchwork-ink",
+  "version": "0.1.0-dev.03aaf5b",
+  "description": "Patchwork image: Ink terminal UI for CLI widgets",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./runner": {
+      "types": "./dist/runner.d.ts",
+      "import": "./dist/runner.js"
+    },
+    "./setup": {
+      "types": "./dist/setup.d.ts",
+      "import": "./dist/setup.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "patchwork": {
+    "platform": "cli",
+    "esbuild": {
+      "target": "node20",
+      "format": "esm",
+      "jsx": "automatic"
+    }
+  },
+  "dependencies": {
+    "chalk": "^5.0.0",
+    "ink": "^5.0.0",
+    "ink-box": "^2.0.0",
+    "ink-link": "^4.0.0",
+    "ink-spinner": "^5.0.0",
+    "react": "^18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "@types/react": "^18.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/index.ts

@@ -0,0 +1,48 @@
+/**
+ * @aprovan/patchwork-image-ink
+ *
+ * Ink terminal UI image for CLI widgets.
+ * Provides React components for building terminal interfaces.
+ */
+
+export { setup, cleanup } from './setup.js';
+export type { SetupOptions, InkEnvironment } from './setup.js';
+
+// Runner - mounting/execution for terminal widgets
+export {
+  run,
+  runOnce,
+  evaluateWidget,
+  renderComponent,
+  getGlobals,
+} from './runner.js';
+export type {
+  RunnerOptions,
+  RunnerInstance,
+  CompiledWidget,
+  GlobalInjection,
+} from './runner.js';
+
+// Re-export Ink components for convenience
+export {
+  render,
+  Box,
+  Text,
+  Static,
+  Transform,
+  Newline,
+  Spacer,
+  useInput,
+  useApp,
+  useFocus,
+  useFocusManager,
+  useStdin,
+  useStdout,
+  useStderr,
+} from 'ink';
+
+// Re-export React for widget authors
+export { default as React } from 'react';
+
+// Re-export chalk for styling
+export { default as chalk } from 'chalk';

package/src/runner.ts

@@ -0,0 +1,331 @@
+/**
+ * @aprovan/patchwork-ink - Runner
+ *
+ * Provides the runtime mounting logic for Ink terminal widgets.
+ * The image owns all ink/react dependencies and mounting code.
+ */
+
+import type { WriteStream } from 'node:tty';
+import { render } from 'ink';
+import React from 'react';
+
+/**
+ * Global injections for compiling widgets with this image
+ *
+ * These tell the compiler which imports to transform into global variable references.
+ * The evaluateWidget function will provide these globals at runtime.
+ */
+export interface GlobalInjection {
+  module: string;
+  globalName: string;
+}
+
+export function getGlobals(): GlobalInjection[] {
+  return [
+    { module: 'react', globalName: '__REACT__' },
+    { module: 'ink', globalName: '__INK__' },
+  ];
+}
+
+export interface RunnerOptions {
+  /** Service proxy for UTCP calls */
+  proxy?: {
+    call(
+      namespace: string,
+      procedure: string,
+      args: unknown[],
+    ): Promise<unknown>;
+  };
+  /** Initial props/inputs to pass to widget */
+  inputs?: Record<string, unknown>;
+  /** Output stream (default: process.stdout) */
+  stdout?: WriteStream;
+  /** Input stream (default: process.stdin) */
+  stdin?: NodeJS.ReadStream;
+  /** Exit on Ctrl+C (default: true) */
+  exitOnCtrlC?: boolean;
+}
+
+export interface RunnerInstance {
+  /** Unique mount ID */
+  id: string;
+  /** Unmount the widget */
+  unmount: () => void;
+  /** Wait until the widget exits */
+  waitUntilExit: () => Promise<void>;
+  /** Rerender with new props */
+  rerender: (props: Record<string, unknown>) => void;
+  /** Clear the terminal output */
+  clear: () => void;
+}
+
+let mountCounter = 0;
+
+function generateMountId(): string {
+  return `patchwork-ink-${Date.now()}-${++mountCounter}`;
+}
+
+/**
+ * Generate namespace globals that proxy calls to a service proxy
+ *
+ * Given services like ["git.branch", "git.status", "github.repos.get"],
+ * generates globals with appropriate methods.
+ */
+function generateNamespaceGlobals(
+  services: string[],
+  proxy: RunnerOptions['proxy'],
+): Record<string, unknown> {
+  if (!proxy) return {};
+
+  const namespaces: Record<string, Record<string, unknown>> = {};
+
+  for (const service of services) {
+    const parts = service.split('.');
+    if (parts.length < 2) continue;
+
+    const namespace = parts[0] as string;
+    const procedurePath = parts.slice(1);
+
+    if (!namespaces[namespace]) {
+      namespaces[namespace] = {};
+    }
+
+    let current = namespaces[namespace] as Record<string, unknown>;
+    for (let i = 0; i < procedurePath.length - 1; i++) {
+      const key = procedurePath[i] as string;
+      if (!current[key]) {
+        current[key] = {};
+      }
+      current = current[key] as Record<string, unknown>;
+    }
+
+    const finalKey = procedurePath[procedurePath.length - 1] as string;
+    const fullProcedure = procedurePath.join('.');
+    current[finalKey] = (...args: unknown[]) =>
+      proxy.call(namespace, fullProcedure, args);
+  }
+
+  return namespaces;
+}
+
+/**
+ * Extract unique namespace names from services array
+ */
+function extractNamespaces(services: string[]): string[] {
+  const namespaces = new Set<string>();
+  for (const service of services) {
+    const parts = service.split('.');
+    if (parts[0]) {
+      namespaces.add(parts[0]);
+    }
+  }
+  return Array.from(namespaces);
+}
+
+/**
+ * Inject namespace globals into globalThis
+ */
+function injectNamespaceGlobals(namespaces: Record<string, unknown>): void {
+  for (const [name, value] of Object.entries(namespaces)) {
+    (globalThis as Record<string, unknown>)[name] = value;
+  }
+}
+
+/**
+ * Remove namespace globals from globalThis
+ */
+function removeNamespaceGlobals(namespaceNames: string[]): void {
+  for (const name of namespaceNames) {
+    delete (globalThis as Record<string, unknown>)[name];
+  }
+}
+
+export interface CompiledWidget {
+  /** Compiled ESM code */
+  code: string;
+  /** Content hash for caching */
+  hash: string;
+  /** Original manifest */
+  manifest: {
+    name: string;
+    services?: string[];
+    [key: string]: unknown;
+  };
+}
+
+/**
+ * Run a compiled widget using Ink
+ *
+ * This is the main entry point for running terminal widgets.
+ * The image owns all React/Ink dependencies.
+ */
+export async function run(
+  widget: CompiledWidget,
+  options: RunnerOptions = {},
+): Promise<RunnerInstance> {
+  const {
+    proxy,
+    inputs = {},
+    stdout = process.stdout as WriteStream,
+    stdin = process.stdin,
+    exitOnCtrlC = true,
+  } = options;
+  const mountId = generateMountId();
+
+  // Inject namespace globals for services
+  const services = widget.manifest.services || [];
+  const namespaceNames = extractNamespaces(services);
+  const namespaces = generateNamespaceGlobals(services, proxy);
+  injectNamespaceGlobals(namespaces);
+
+  // Import the widget module from code
+  const dataUri = `data:text/javascript;base64,${Buffer.from(
+    widget.code,
+  ).toString('base64')}`;
+
+  let module: { default?: unknown };
+  try {
+    module = await import(/* webpackIgnore: true */ /* @vite-ignore */ dataUri);
+  } catch {
+    // Fallback: use Function-based loading
+    const AsyncFunction = Object.getPrototypeOf(async function () {})
+      .constructor as new (argName: string, code: string) => (
+      exports: Record<string, unknown>,
+    ) => Promise<Record<string, unknown>>;
+    const exports: Record<string, unknown> = {};
+    const fn = new AsyncFunction('exports', widget.code + '\nreturn exports;');
+    module = await fn(exports);
+  }
+
+  const Component = module.default;
+  if (!Component) {
+    removeNamespaceGlobals(namespaceNames);
+    throw new Error('Widget must export a default component');
+  }
+
+  if (typeof Component !== 'function') {
+    removeNamespaceGlobals(namespaceNames);
+    throw new Error('Widget default export must be a function/component');
+  }
+
+  // Render using Ink
+  let currentInputs = { ...inputs };
+  const element = React.createElement(
+    Component as React.ComponentType,
+    currentInputs,
+  );
+  const instance = render(element, {
+    stdout,
+    stdin,
+    exitOnCtrlC,
+  });
+
+  return {
+    id: mountId,
+    unmount() {
+      instance.unmount();
+      removeNamespaceGlobals(namespaceNames);
+    },
+    waitUntilExit() {
+      return instance.waitUntilExit();
+    },
+    rerender(newInputs: Record<string, unknown>) {
+      currentInputs = { ...currentInputs, ...newInputs };
+      const newElement = React.createElement(
+        Component as React.ComponentType,
+        currentInputs,
+      );
+      instance.rerender(newElement);
+    },
+    clear() {
+      instance.clear();
+    },
+  };
+}
+
+/**
+ * Run a widget once and wait for exit
+ */
+export async function runOnce(
+  widget: CompiledWidget,
+  options: RunnerOptions = {},
+): Promise<void> {
+  const instance = await run(widget, options);
+  await instance.waitUntilExit();
+  instance.unmount();
+}
+
+/**
+ * Evaluate widget code and return the component
+ *
+ * This is used for more advanced scenarios where you need
+ * direct access to the component.
+ */
+export async function evaluateWidget(
+  code: string,
+  services: Record<string, unknown> = {},
+): Promise<React.ComponentType<{ services?: Record<string, unknown> }>> {
+  // Store services for widget access
+  (globalThis as Record<string, unknown>).__PATCHWORK_SERVICES__ = services;
+
+  // Inject globals that the compiled code expects
+  const __EXPORTS__: Record<string, unknown> = {};
+  const __REACT__ = React;
+  const __INK__ = await import('ink');
+
+  // Execute the transformed code with injected globals
+  const fn = new Function('__EXPORTS__', '__REACT__', '__INK__', code);
+  fn(__EXPORTS__, __REACT__, __INK__);
+
+  const Component =
+    __EXPORTS__.default ||
+    __EXPORTS__.Widget ||
+    Object.values(__EXPORTS__).find(
+      (v): v is React.ComponentType => typeof v === 'function',
+    );
+
+  if (!Component) {
+    throw new Error('No default export or Widget component found');
+  }
+
+  return Component as React.ComponentType<{
+    services?: Record<string, unknown>;
+  }>;
+}
+
+/**
+ * Render a component directly with Ink
+ *
+ * For cases where you already have an evaluated component.
+ */
+export function renderComponent(
+  Component: React.ComponentType<Record<string, unknown>>,
+  props: Record<string, unknown> = {},
+  options: Omit<RunnerOptions, 'proxy' | 'inputs'> = {},
+): RunnerInstance {
+  const {
+    stdout = process.stdout as WriteStream,
+    stdin = process.stdin,
+    exitOnCtrlC = true,
+  } = options;
+  const mountId = generateMountId();
+
+  let currentProps = { ...props };
+  const element = React.createElement(Component, currentProps);
+  const instance = render(element, {
+    stdout,
+    stdin,
+    exitOnCtrlC,
+  });
+
+  return {
+    id: mountId,
+    unmount: () => instance.unmount(),
+    waitUntilExit: () => instance.waitUntilExit(),
+    rerender(newProps: Record<string, unknown>) {
+      currentProps = { ...currentProps, ...newProps };
+      instance.rerender(React.createElement(Component, currentProps));
+    },
+    clear: () => instance.clear(),
+  };
+}