@pellux/goodvibes-tui 0.18.11 → 0.18.13

package/src/runtime/store/selectors/index.ts

@@ -53,9 +53,9 @@ export function selectOverlays(state: RuntimeState): OverlayDomainState {
   return state.overlays;
 }
 
-/** Select the full panels domain slice. */
+/** Select the full panels domain slice. Casts from Record<string,unknown> to PanelDomainState. */
 export function selectPanels(state: RuntimeState): PanelDomainState {
-  return state.panels;
+  return state.panels as unknown as PanelDomainState;
 }
 
 /** Select the full permissions domain slice. */
@@ -123,11 +123,14 @@ export function selectIntelligence(state: RuntimeState): IntelligenceDomainState
   return state.intelligence;
 }
 
-/** Select the full UI performance domain slice. */
+/** Select the full surface/UI performance domain slice. */
 export function selectUiPerf(state: RuntimeState): UiPerfDomainState {
-  return state.uiPerf;
+  return state.surfacePerf;
 }
 
+/** Select the full surface performance domain slice (SDK-compatible alias). */
+export const selectSurfacePerf = selectUiPerf;
+
 // ---------------------------------------------------------------------------
 // Derived selectors
 // ---------------------------------------------------------------------------
@@ -271,7 +274,8 @@ export function selectPermissionMode(state: RuntimeState): PermissionMode {
  */
 export function selectActivePanels(state: RuntimeState): PanelState[] {
   const result: PanelState[] = [];
-  for (const panel of state.panels.panels.values()) {
+  const panelDomain = state.panels as unknown as PanelDomainState;
+  for (const panel of panelDomain.panels.values()) {
     if (panel.open) {
       result.push(panel);
     }
@@ -283,7 +287,8 @@ export function selectActivePanels(state: RuntimeState): PanelState[] {
  * Returns the panel currently holding focus.
  */
 export function selectFocusedPanel(state: RuntimeState): PanelState | undefined {
-  return state.panels.panels.get(state.panels.focusedPanelId);
+  const panelDomain = state.panels as unknown as PanelDomainState;
+  return panelDomain.panels.get(panelDomain.focusedPanelId);
 }
 
 /**

package/src/runtime/store/state.ts

@@ -33,6 +33,9 @@ import type { GitDomainState } from '@pellux/goodvibes-sdk/platform/runtime/stor
 import type { DiscoveryDomainState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/discovery';
 import type { IntelligenceDomainState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/intelligence';
 import type { UiPerfDomainState } from './domains/ui-perf.ts';
+// UiPerfDomainState is structurally identical to SDK's SurfacePerfDomainState.
+// Export as SurfacePerfDomainState alias for SDK compatibility.
+export type { UiPerfDomainState };
 
 import { createInitialSessionState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/session';
 import { createInitialModelState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/model';
@@ -73,7 +76,11 @@ export interface RuntimeState {
   model: ModelDomainState;
   conversation: ConversationDomainState;
   overlays: OverlayDomainState;
-  panels: PanelDomainState;
+  /**
+   * TUI panel state. Typed as Record<string,unknown> for SDK RuntimeState
+   * compatibility. Use selectPanels() which casts to PanelDomainState.
+   */
+  panels: Record<string, unknown>;
   permissions: PermissionDomainState;
   tasks: TaskDomainState;
   agents: AgentDomainState;
@@ -95,7 +102,8 @@ export interface RuntimeState {
   git: GitDomainState;
   discovery: DiscoveryDomainState;
   intelligence: IntelligenceDomainState;
-  uiPerf: UiPerfDomainState;
+  /** Surface/UI performance metrics. SDK-compatible field name. */
+  surfacePerf: UiPerfDomainState;
 }
 
 /**
@@ -110,7 +118,7 @@ export function createInitialRuntimeState(): RuntimeState {
     model: createInitialModelState(),
     conversation: createInitialConversationState(),
     overlays: createInitialOverlaysState(),
-    panels: createInitialPanelsState(),
+    panels: createInitialPanelsState() as unknown as Record<string, unknown>,
     permissions: createInitialPermissionsState(),
     tasks: createInitialTasksState(),
     agents: createInitialAgentsState(),
@@ -132,6 +140,6 @@ export function createInitialRuntimeState(): RuntimeState {
     git: createInitialGitState(),
     discovery: createInitialDiscoveryState(),
     intelligence: createInitialIntelligenceState(),
-    uiPerf: createInitialUiPerfState(),
+    surfacePerf: createInitialUiPerfState(),
   };
 }

package/src/runtime/ui-read-models-observability-security.ts

@@ -26,8 +26,8 @@ export interface UiSecuritySnapshot {
     readonly lintFindingCount: number;
   };
   readonly deniedPermissions: number;
-  readonly incidents: ReturnType<import('./forensics/index.ts').ForensicsRegistry['getAll']>;
-  readonly latestIncident: ReturnType<import('./forensics/index.ts').ForensicsRegistry['latest']>;
+  readonly incidents: ReturnType<import('@pellux/goodvibes-sdk/platform/runtime/forensics/index').ForensicsRegistry['getAll']>;
+  readonly latestIncident: ReturnType<import('@pellux/goodvibes-sdk/platform/runtime/forensics/index').ForensicsRegistry['latest']>;
   readonly mcpServers: readonly McpSecuritySnapshot[];
   readonly recentMcpDecisions: readonly McpDecisionRecord[];
   readonly attackPathReview: ReturnType<typeof buildMcpAttackPathReview>;

package/src/runtime/ui-read-models-observability-system.ts

@@ -49,7 +49,7 @@ export interface UiCockpitSnapshot {
   readonly tokenScopeViolationCount: number;
   readonly tokenRotationWarningCount: number;
   readonly incidentCount: number;
-  readonly latestIncident: ReturnType<import('./forensics/index.ts').ForensicsRegistry['latest']>;
+  readonly latestIncident: ReturnType<import('@pellux/goodvibes-sdk/platform/runtime/forensics/index').ForensicsRegistry['latest']>;
   readonly elevatedMcp: number;
   readonly unhealthyMcp: number;
   readonly erroredPlugins: number;

package/src/runtime/ui-service-queries.ts

@@ -8,7 +8,7 @@ import type {
   ProviderSubscription,
 } from '@pellux/goodvibes-sdk/platform/config/subscriptions';
 import type { LocalAuthSnapshot } from '@pellux/goodvibes-sdk/platform/security/user-auth';
-import type { SessionInfo } from '../sessions/manager.ts';
+import type { SessionInfo } from '@pellux/goodvibes-sdk/platform/sessions/manager';
 import type { Tool } from '@pellux/goodvibes-sdk/platform/types/tools';
 import type { ModelDefinition } from '@pellux/goodvibes-sdk/platform/providers/registry';
 import type {

package/src/runtime/ui-services.ts

@@ -1,7 +1,7 @@
 import type { RuntimeServices } from './services.ts';
 import type { RemoteRunnerRegistry } from '@pellux/goodvibes-sdk/platform/runtime/remote/runner-registry';
 import type { RemoteSupervisor } from '@pellux/goodvibes-sdk/platform/runtime/remote/supervisor';
-import { createUiRuntimeEvents, type UiRuntimeEvents } from '@pellux/goodvibes-sdk/platform/runtime/ui-events';
+import { createUiRuntimeEvents, type UiRuntimeEvents } from './ui-events.ts';
 import { createUiReadModels, type UiReadModels, type UiReadModelOptions } from './ui-read-models.ts';
 import type { ForensicsRegistry } from '@pellux/goodvibes-sdk/platform/runtime/forensics/index';
 import type { ControlPlaneRecentEvent } from '@pellux/goodvibes-sdk/platform/control-plane/index';

package/src/shell/ui-openers.ts

@@ -4,7 +4,7 @@ import type { CommandContext } from '../input/command-registry.ts';
 import type { InputHandler } from '../input/handler.ts';
 import type { PanelManager } from '../panels/panel-manager.ts';
 import type { ProviderRegistry } from '@pellux/goodvibes-sdk/platform/providers/registry';
-import type { MutableRuntimeState } from '../runtime/context.ts';
+import type { MutableRuntimeState } from '@pellux/goodvibes-sdk/platform/runtime/mutable-runtime-state';
 import type { FeatureFlagManager } from '@pellux/goodvibes-sdk/platform/runtime/feature-flags/index';
 import type { McpRegistry } from '@pellux/goodvibes-sdk/platform/mcp/registry';
 import type { SubscriptionManager } from '@pellux/goodvibes-sdk/platform/config/subscriptions';

package/src/tools/index.ts

@@ -1,186 +1 @@
-import { join } from 'node:path';
-import { ToolRegistry } from '@pellux/goodvibes-sdk/platform/tools/registry';
-import { FileStateCache } from '@pellux/goodvibes-sdk/platform/state/file-cache';
-import { ProjectIndex } from '@pellux/goodvibes-sdk/platform/state/project-index';
-import { ModeManager } from '@pellux/goodvibes-sdk/platform/state/mode-manager';
-import { HookDispatcher } from '@pellux/goodvibes-sdk/platform/hooks/dispatcher';
-import { FileUndoManager } from '@pellux/goodvibes-sdk/platform/state/file-undo';
-import type { ConfigManager } from '@pellux/goodvibes-sdk/platform/config/manager';
-import type { ProviderRegistry } from '@pellux/goodvibes-sdk/platform/providers/registry';
-import type { ToolLLM } from '@pellux/goodvibes-sdk/platform/config/tool-llm';
-import { ReadTool } from '@pellux/goodvibes-sdk/platform/tools/read/index';
-import { createWriteTool } from '@pellux/goodvibes-sdk/platform/tools/write/index';
-import { createEditTool } from '@pellux/goodvibes-sdk/platform/tools/edit/index';
-import { createFindTool } from '@pellux/goodvibes-sdk/platform/tools/find/index';
-import { createExecTool } from '@pellux/goodvibes-sdk/platform/tools/exec/index';
-import { createAnalyzeTool } from '@pellux/goodvibes-sdk/platform/tools/analyze/index';
-import { InspectTool } from '@pellux/goodvibes-sdk/platform/tools/inspect/index';
-import { createAgentTool } from '@pellux/goodvibes-sdk/platform/tools/agent/index';
-import { createFetchTool } from '@pellux/goodvibes-sdk/platform/tools/fetch/index';
-import { createStateTool } from '@pellux/goodvibes-sdk/platform/tools/state/index';
-import { createWorkflowServices, createWorkflowTool } from '@pellux/goodvibes-sdk/platform/tools/workflow/index';
-import { createRegistryTool } from '@pellux/goodvibes-sdk/platform/tools/registry-tool/index';
-import { KVState } from '@pellux/goodvibes-sdk/platform/state/kv-state';
-import { createTaskTool } from '@pellux/goodvibes-sdk/platform/tools/task/index';
-import { createTeamTool } from '@pellux/goodvibes-sdk/platform/tools/team/index';
-import { createWorklistTool } from '@pellux/goodvibes-sdk/platform/tools/worklist/index';
-import { createMcpTool } from '@pellux/goodvibes-sdk/platform/tools/mcp/index';
-import { createPacketTool } from '@pellux/goodvibes-sdk/platform/tools/packet/index';
-import { createQueryTool } from '@pellux/goodvibes-sdk/platform/tools/query/index';
-import { createRemoteTool } from '@pellux/goodvibes-sdk/platform/tools/remote-trigger/index';
-import { createReplTool } from '@pellux/goodvibes-sdk/platform/tools/repl/index';
-import { controlTool } from '@pellux/goodvibes-sdk/platform/tools/control/index';
-import { createChannelTool } from '@pellux/goodvibes-sdk/platform/tools/channel/index';
-import { createWebSearchTool } from '@pellux/goodvibes-sdk/platform/tools/web-search/index';
-import { ProcessManager } from '@pellux/goodvibes-sdk/platform/tools/shared/process-manager';
-import type { AgentManager } from '@pellux/goodvibes-sdk/platform/tools/agent/index';
-import { AgentMessageBus } from '@pellux/goodvibes-sdk/platform/agents/message-bus';
-import type { WrfcController } from '@pellux/goodvibes-sdk/platform/agents/wrfc-controller';
-import type { WebSearchService } from '@pellux/goodvibes-sdk/platform/web-search/index';
-import type { ChannelPluginRegistry } from '@pellux/goodvibes-sdk/platform/channels/index';
-import type { RemoteRunnerRegistry } from '@pellux/goodvibes-sdk/platform/runtime/remote/index';
-import { CrossSessionTaskRegistry } from '@pellux/goodvibes-sdk/platform/sessions/orchestration/index';
-import type { SandboxSessionRegistry } from '@pellux/goodvibes-sdk/platform/runtime/sandbox/session-registry';
-import type { FeatureFlagManager } from '@pellux/goodvibes-sdk/platform/runtime/feature-flags/index';
-import type { ServiceRegistry } from '../config/service-registry.ts';
-import { OverflowHandler } from '@pellux/goodvibes-sdk/platform/tools/shared/overflow';
-import type { SessionChangeTracker } from '@pellux/goodvibes-sdk/platform/sessions/change-tracker';
-import type { ArchetypeLoader } from '@pellux/goodvibes-sdk/platform/agents/archetypes';
-
-/**
- * Register all built-in tools into the given registry.
- * Creates shared FileStateCache and ProjectIndex instances so read/write/edit
- * tools share cache state within a session.
- */
-export function registerAllTools(
-  registry: ToolRegistry,
-  deps?: {
-    fileCache?: FileStateCache;
-    projectIndex?: ProjectIndex;
-    fileUndoManager: FileUndoManager;
-    modeManager: ModeManager;
-    processManager: ProcessManager;
-    agentManager?: AgentManager;
-    agentMessageBus: AgentMessageBus;
-    wrfcController?: WrfcController;
-    webSearchService?: WebSearchService;
-    channelRegistry?: ChannelPluginRegistry | null;
-    remoteRunnerRegistry?: RemoteRunnerRegistry;
-    workflowServices: ReturnType<typeof createWorkflowServices>;
-    mcpRegistry?: import('../mcp/registry.ts').McpRegistry;
-    sessionOrchestration?: CrossSessionTaskRegistry;
-    sandboxSessionRegistry?: SandboxSessionRegistry;
-    workingDirectory: string;
-    archetypeLoader?: Pick<ArchetypeLoader, 'loadArchetype'>;
-    configManager?: ConfigManager;
-    providerRegistry?: ProviderRegistry;
-    toolLLM?: ToolLLM;
-    featureFlags?: Pick<FeatureFlagManager, 'isEnabled'> | null;
-    serviceRegistry?: Pick<ServiceRegistry, 'resolveAuth'> | null;
-    overflowHandler?: OverflowHandler;
-    changeTracker?: SessionChangeTracker;
-  },
-): { fileCache: FileStateCache; projectIndex: ProjectIndex } {
-  const fileCache = deps?.fileCache ?? new FileStateCache();
-  if (!deps?.fileUndoManager || !deps?.modeManager || !deps?.processManager || !deps?.agentMessageBus || !deps?.workflowServices) {
-    throw new Error('registerAllTools requires explicit fileUndoManager, modeManager, processManager, agentMessageBus, and workflowServices ownership.');
-  }
-  const fileUndoManager = deps.fileUndoManager;
-  const modeManager = deps.modeManager;
-  const processManager = deps.processManager;
-  const agentManager = deps?.agentManager
-    ?? (deps?.remoteRunnerRegistry
-      ? (deps.remoteRunnerRegistry as unknown as { agentManager?: AgentManager | null }).agentManager ?? null
-      : null);
-  if (!agentManager) {
-    throw new Error('registerAllTools requires agentManager');
-  }
-  const agentMessageBus = deps.agentMessageBus;
-  const wrfcController = deps?.wrfcController;
-  const archetypeLoader = deps?.archetypeLoader;
-  const webSearchService = deps?.webSearchService;
-  const channelRegistry = deps?.channelRegistry ?? null;
-  const remoteRunnerRegistry = deps?.remoteRunnerRegistry;
-  const workflowServices = deps.workflowServices;
-  const mcpRegistry = deps?.mcpRegistry;
-  if (!deps?.configManager || !deps?.providerRegistry || !deps?.toolLLM) {
-    throw new Error('registerAllTools requires configManager, providerRegistry, and toolLLM');
-  }
-  if (!deps?.sandboxSessionRegistry) {
-    throw new Error('registerAllTools requires sandboxSessionRegistry');
-  }
-  if (!deps?.sessionOrchestration) {
-    throw new Error('registerAllTools requires sessionOrchestration');
-  }
-  const sessionOrchestration = deps.sessionOrchestration;
-  const workingDirectory = deps?.workingDirectory;
-  if (!workingDirectory) {
-    throw new Error('registerAllTools requires workingDirectory');
-  }
-  const projectIndex = deps?.projectIndex ?? new ProjectIndex(workingDirectory);
-
-  registry.register(new ReadTool(projectIndex, fileCache));
-  registry.register(createWriteTool({
-    projectRoot: workingDirectory,
-    fileCache,
-    projectIndex,
-    fileUndoManager,
-    configManager: deps.configManager,
-    toolLLM: deps.toolLLM,
-    changeTracker: deps?.changeTracker,
-  }));
-  registry.register(createEditTool(fileCache, {
-    fileUndoManager,
-    configManager: deps.configManager,
-    toolLLM: deps.toolLLM,
-    changeTracker: deps?.changeTracker,
-  }));
-  registry.register(createFindTool(workingDirectory, deps.featureFlags));
-  registry.register(createExecTool(processManager, {
-    featureFlags: deps.featureFlags,
-    overflowHandler: deps.overflowHandler,
-  }));
-  registry.register(createAnalyzeTool(deps.toolLLM, deps.featureFlags, workingDirectory));
-  registry.register(new InspectTool(deps.featureFlags, workingDirectory));
-  registry.register(createAgentTool({
-    manager: agentManager,
-    messageBus: agentMessageBus,
-    configManager: deps.configManager,
-    ...(archetypeLoader ? { archetypeLoader } : {}),
-    ...(wrfcController ? { wrfcController } : {}),
-  }));
-  const kvState = new KVState(undefined, workingDirectory);
-  const hookDispatcher = new HookDispatcher();
-  registry.register(createStateTool(kvState, projectIndex, {
-    memoryDir: join(workingDirectory, '.goodvibes', 'memory'),
-    hookDispatcher,
-    modeManager,
-  }));
-  registry.register(createWorkflowTool(workflowServices));
-  registry.register(createFetchTool({
-    serviceRegistry: deps.serviceRegistry,
-    featureFlags: deps.featureFlags,
-  }));
-  if (webSearchService) {
-    registry.register(createWebSearchTool(webSearchService));
-  }
-  registry.register(createRegistryTool(registry, {
-    workingDirectory,
-    homeDirectory: deps.configManager.getHomeDirectory() ?? undefined,
-  }));
-  registry.register(createTaskTool(sessionOrchestration));
-  registry.register(createTeamTool({ surfaceRoot: 'tui' }));
-  registry.register(createWorklistTool({ surfaceRoot: 'tui' }));
-  if (mcpRegistry) {
-    registry.register(createMcpTool(mcpRegistry));
-  }
-  registry.register(createPacketTool(workingDirectory));
-  registry.register(createQueryTool(workingDirectory));
-  if (remoteRunnerRegistry) {
-    registry.register(createRemoteTool(remoteRunnerRegistry));
-  }
-  registry.register(createReplTool(deps.configManager, deps.sandboxSessionRegistry, { surfaceRoot: 'tui' }));
-  registry.register(controlTool);
-  registry.register(createChannelTool(channelRegistry));
-  return { fileCache, projectIndex };
-}
+export { registerAllTools } from '@pellux/goodvibes-sdk/platform/tools/index';

package/src/types/grid.ts

@@ -0,0 +1,48 @@
+/**
+ * Cell - The atomic unit of the terminal surface grid.
+ */
+export interface Cell {
+  char: string;
+  fg: string;
+  bg: string;
+  bold: boolean;
+  dim: boolean;
+  underline: boolean;
+  italic: boolean;
+  strikethrough: boolean;
+  link?: string;
+}
+
+/**
+ * Line - A single horizontal row of Cells.
+ */
+export type Line = Cell[];
+
+export const createEmptyCell = (): Cell => ({
+  char: ' ',
+  fg: '',
+  bg: '',
+  bold: false,
+  dim: false,
+  underline: false,
+  italic: false,
+  strikethrough: false,
+});
+
+export const createEmptyLine = (width: number): Line =>
+  Array.from({ length: width }, createEmptyCell);
+
+/**
+ * createStyledCell - Create a Cell with all defaults, applying only the provided overrides.
+ */
+export const createStyledCell = (char: string, overrides: Partial<Omit<Cell, 'char'>> = {}): Cell => ({
+  char,
+  fg: overrides.fg ?? '',
+  bg: overrides.bg ?? '',
+  bold: overrides.bold ?? false,
+  dim: overrides.dim ?? false,
+  underline: overrides.underline ?? false,
+  italic: overrides.italic ?? false,
+  strikethrough: overrides.strikethrough ?? false,
+  link: overrides.link,
+});

package/src/utils/clipboard.ts

@@ -0,0 +1,21 @@
+import { logger } from '@pellux/goodvibes-sdk/platform/utils/logger';
+import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils/error-display';
+
+/**
+ * copyToClipboard - Uses OSC 52 escape sequence to copy text to the terminal clipboard.
+ * Terminal-specific: only works in terminals that support OSC 52.
+ */
+export function copyToClipboard(text: string) {
+  if (!text) return;
+  logger.info('Clipboard: Attempting to copy via OSC 52', { length: text.length });
+  try {
+    const base64 = Buffer.from(text).toString('base64');
+    const sequence = `\x1b]52;c;${base64}\x07`;
+    process.stdout.write(sequence);
+    logger.info('Clipboard: OSC 52 sequence written');
+  } catch (err: unknown) {
+    logger.error('Clipboard: OSC 52 copy failed', { error: summarizeError(err) });
+  }
+}
+
+export { pasteFromClipboard, pasteImageFromClipboard, MIN_IMAGE_BYTES } from '@pellux/goodvibes-sdk/platform/utils/clipboard';

package/src/utils/splash-lines.ts

@@ -1,4 +1,4 @@
-import { center, getDisplayWidth } from '@pellux/goodvibes-sdk/platform/utils/terminal-width';
+import { center, getDisplayWidth } from './terminal-width.ts';
 import { VERSION } from '../version.ts';
 
 const ART_LINES = [

package/src/utils/terminal-width.ts

@@ -0,0 +1,185 @@
+/**
+ * Calculates the visual width of a string in the terminal.
+ * Handles CJK characters, emoji (including ZWJ sequences), and
+ * variation selectors correctly as double-width.
+ */
+export function getDisplayWidth(text: string): number {
+  let width = 0;
+  let i = 0;
+  while (i < text.length) {
+    const code = text.codePointAt(i)!;
+    const charLen = code > 0xFFFF ? 2 : 1;
+
+    if (code < 32 || code === 127) {
+      i += charLen;
+      continue;
+    }
+
+    if (
+      code === 0x200d ||
+      code === 0xfe0f ||
+      code === 0xfe0e ||
+      (code >= 0x0300 && code <= 0x036f) ||
+      (code >= 0x1ab0 && code <= 0x1aff) ||
+      (code >= 0x20d0 && code <= 0x20ff) ||
+      (code >= 0xfe20 && code <= 0xfe2f) ||
+      (code >= 0xe0100 && code <= 0xe01ef)
+    ) {
+      i += charLen;
+      continue;
+    }
+
+    if (
+      code === 0x2713 ||
+      code === 0x2717 ||
+      code === 0x2714 ||
+      code === 0x2718 ||
+      code === 0x2022 ||
+      code === 0x258d ||
+      (code >= 0x2500 && code <= 0x257f)
+    ) {
+      width += 1;
+      i += charLen;
+      continue;
+    }
+
+    if (
+      (code >= 0x1f300 && code <= 0x1f9ff) ||
+      (code >= 0x1fa00 && code <= 0x1faff) ||
+      (code >= 0x2600 && code <= 0x27bf) ||
+      (code >= 0x2300 && code <= 0x23ff) ||
+      (code >= 0x2b50 && code <= 0x2b55) ||
+      (code >= 0xfe00 && code <= 0xfe0f) ||
+      (code >= 0x1f000 && code <= 0x1f02f) ||
+      (code >= 0x1f680 && code <= 0x1f6ff) ||
+      code === 0x200d ||
+      (code >= 0xe000 && code <= 0xf8ff) ||
+      code === 0x2764 || code === 0x2763 ||
+      code === 0x270a || code === 0x270b || code === 0x270c ||
+      code === 0x261d || code === 0x2639 || code === 0x263a
+    ) {
+      width += 2;
+      i += charLen;
+      continue;
+    }
+
+    if (
+      (code >= 0x1100 && code <= 0x115f) ||
+      (code >= 0x2e80 && code <= 0xa4cf && code !== 0x303f) ||
+      (code >= 0xac00 && code <= 0xd7a3) ||
+      (code >= 0xf900 && code <= 0xfaff) ||
+      (code >= 0xff00 && code <= 0xff60) ||
+      (code >= 0x20000 && code <= 0x2fffd) ||
+      (code >= 0x30000 && code <= 0x3fffd)
+    ) {
+      width += 2;
+      i += charLen;
+      continue;
+    }
+
+    width += 1;
+    i += charLen;
+  }
+  return width;
+}
+
+export function center(text: string, width: number): string {
+  const displayWidth = getDisplayWidth(text);
+  if (displayWidth >= width) return text;
+  const left = Math.floor((width - displayWidth) / 2);
+  return ' '.repeat(left) + text;
+}
+
+export function truncateDisplay(text: string, width: number, ellipsis = '…'): string {
+  if (width <= 0) return '';
+  if (getDisplayWidth(text) <= width) return text;
+  const ellipsisWidth = getDisplayWidth(ellipsis);
+  if (ellipsisWidth >= width) return truncateDisplay(ellipsis, width, '');
+
+  let result = '';
+  let currentWidth = 0;
+  for (const char of text) {
+    const charWidth = getDisplayWidth(char);
+    if (currentWidth + charWidth + ellipsisWidth > width) break;
+    result += char;
+    currentWidth += charWidth;
+  }
+  return result + ellipsis;
+}
+
+export function padDisplayEnd(text: string, width: number): string {
+  const currentWidth = getDisplayWidth(text);
+  if (currentWidth >= width) return text;
+  return text + ' '.repeat(width - currentWidth);
+}
+
+export function fitDisplay(text: string, width: number, ellipsis = '…'): string {
+  return padDisplayEnd(truncateDisplay(text, width, ellipsis), width);
+}
+
+export function wrapText(text: string, width: number): string[] {
+  if (width <= 0) return [text];
+  const lines: string[] = [];
+  const paragraphs = text.split('\n');
+
+  for (const paragraph of paragraphs) {
+    if (paragraph.length === 0) {
+      lines.push('');
+      continue;
+    }
+
+    const words = paragraph.split(' ');
+    let currentLine = '';
+
+    for (const word of words) {
+      const wordWidth = getDisplayWidth(word);
+      const currentLineWidth = getDisplayWidth(currentLine);
+
+      if (wordWidth > width) {
+        if (currentLine) lines.push(currentLine);
+        let remaining = word;
+        while (getDisplayWidth(remaining) > width) {
+          let splitIdx = 0;
+          let currentWidth = 0;
+          for (let i = 0; i < remaining.length; i++) {
+            const charWidth = getDisplayWidth(remaining[i]!);
+            if (currentWidth + charWidth > width) break;
+            currentWidth += charWidth;
+            splitIdx = i + 1;
+          }
+          lines.push(remaining.slice(0, splitIdx));
+          remaining = remaining.slice(splitIdx);
+        }
+        currentLine = remaining;
+        continue;
+      }
+
+      if ((currentLineWidth + wordWidth + (currentLine ? 1 : 0)) <= width) {
+        currentLine += `${currentLine ? ' ' : ''}${word}`;
+      } else {
+        lines.push(currentLine);
+        currentLine = word;
+      }
+    }
+
+    if (currentLine) lines.push(currentLine);
+  }
+
+  return lines;
+}
+
+export function interpolateColor(startHex: string, endHex: string, factor: number): string {
+  const parse = (hex: string) => {
+    const r = parseInt(hex.slice(1, 3), 16);
+    const g = parseInt(hex.slice(3, 5), 16);
+    const b = parseInt(hex.slice(5, 7), 16);
+    return [r, g, b];
+  };
+
+  const [r1, g1, b1] = parse(startHex);
+  const [r2, g2, b2] = parse(endHex);
+  const r = Math.round(r1 + factor * (r2 - r1));
+  const g = Math.round(g1 + factor * (g2 - g1));
+  const b = Math.round(b1 + factor * (b2 - b1));
+  return `${r};${g};${b}`;
+}

package/src/version.ts

@@ -6,7 +6,7 @@ import { join } from 'node:path';
 // The prebuild script updates the fallback value before compilation.
 // Uses import.meta.dir (Bun) to locate package.json relative to this file,
 // which is correct regardless of the process working directory.
-let _version = '0.18.11';
+let _version = '0.18.13';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8'));
   _version = pkg.version ?? _version;