@pokit/tabs-core 0.0.1 → 0.0.2

package/src/state-reducer.ts

@@ -0,0 +1,206 @@
+/**
+ * State Reducer for Event-Driven CLI
+ *
+ * Builds a state tree from CLI events using a reducer pattern.
+ * Framework-agnostic - used by both Ink and OpenTUI adapters.
+ */
+
+import type { CLIEvent, ActivityId, GroupId } from '@pokit/core';
+import type { EventDrivenState, ActivityNode, GroupNode } from './types.js';
+
+/**
+ * Create initial state
+ */
+export function createInitialState(): EventDrivenState {
+  return {
+    appName: undefined,
+    version: undefined,
+    exitCode: undefined,
+    activities: new Map(),
+    groups: new Map(),
+    rootChildren: [],
+  };
+}
+
+/**
+ * Reducer function for CLI events
+ */
+export function reducer(state: EventDrivenState, event: CLIEvent): EventDrivenState {
+  switch (event.type) {
+    case 'root:start':
+      return {
+        ...state,
+        appName: event.appName,
+        version: event.version,
+      };
+
+    case 'root:end':
+      return {
+        ...state,
+        exitCode: event.exitCode,
+      };
+
+    case 'group:start': {
+      const newGroup: GroupNode = {
+        type: 'group',
+        id: event.id,
+        parentId: event.parentId,
+        label: event.label,
+        layout: event.layout,
+        children: [],
+      };
+
+      const newGroups = new Map(state.groups);
+      newGroups.set(event.id, newGroup);
+
+      if (event.parentId) {
+        const parentGroup = state.groups.get(event.parentId);
+        if (parentGroup) {
+          const updatedParent: GroupNode = {
+            ...parentGroup,
+            children: [...parentGroup.children, event.id],
+          };
+          newGroups.set(event.parentId, updatedParent);
+        }
+        return { ...state, groups: newGroups };
+      }
+
+      return {
+        ...state,
+        groups: newGroups,
+        rootChildren: [...state.rootChildren, event.id],
+      };
+    }
+
+    case 'group:end':
+      return state;
+
+    case 'activity:start': {
+      const newActivity: ActivityNode = {
+        type: 'activity',
+        id: event.id,
+        parentId: event.parentId,
+        label: event.label,
+        status: 'running',
+        meta: event.meta,
+        logs: [],
+      };
+
+      const newActivities = new Map(state.activities);
+      newActivities.set(event.id, newActivity);
+
+      if (event.parentId) {
+        const parentGroup = state.groups.get(event.parentId as GroupId);
+        if (parentGroup) {
+          const newGroups = new Map(state.groups);
+          const updatedParent: GroupNode = {
+            ...parentGroup,
+            children: [...parentGroup.children, event.id],
+          };
+          newGroups.set(event.parentId as GroupId, updatedParent);
+          return { ...state, activities: newActivities, groups: newGroups };
+        }
+        return { ...state, activities: newActivities };
+      }
+
+      return {
+        ...state,
+        activities: newActivities,
+        rootChildren: [...state.rootChildren, event.id],
+      };
+    }
+
+    case 'activity:update': {
+      const activity = state.activities.get(event.id);
+      if (!activity) return state;
+
+      const updatedActivity: ActivityNode = {
+        ...activity,
+        progress: event.payload.progress ?? activity.progress,
+        message: event.payload.message ?? activity.message,
+      };
+
+      const newActivities = new Map(state.activities);
+      newActivities.set(event.id, updatedActivity);
+
+      return { ...state, activities: newActivities };
+    }
+
+    case 'activity:success': {
+      const activity = state.activities.get(event.id);
+      if (!activity) return state;
+
+      const updatedActivity: ActivityNode = {
+        ...activity,
+        status: 'success',
+      };
+
+      const newActivities = new Map(state.activities);
+      newActivities.set(event.id, updatedActivity);
+
+      return { ...state, activities: newActivities };
+    }
+
+    case 'activity:failure': {
+      const activity = state.activities.get(event.id);
+      if (!activity) return state;
+
+      const errorMessage = event.error instanceof Error ? event.error.message : String(event.error);
+
+      const updatedActivity: ActivityNode = {
+        ...activity,
+        status: 'failure',
+        message: errorMessage,
+      };
+
+      const newActivities = new Map(state.activities);
+      newActivities.set(event.id, updatedActivity);
+
+      return { ...state, activities: newActivities };
+    }
+
+    case 'log': {
+      if (!event.activityId) return state;
+
+      const activity = state.activities.get(event.activityId);
+      if (!activity) return state;
+
+      const updatedActivity: ActivityNode = {
+        ...activity,
+        logs: [...activity.logs, { level: event.level, message: event.message }],
+      };
+
+      const newActivities = new Map(state.activities);
+      newActivities.set(event.activityId, updatedActivity);
+
+      return { ...state, activities: newActivities };
+    }
+
+    default:
+      return state;
+  }
+}
+
+/**
+ * Get activities that belong to a tabs group
+ */
+export function getTabsGroupActivities(state: EventDrivenState, groupId: GroupId): ActivityNode[] {
+  const group = state.groups.get(groupId);
+  if (!group || group.layout !== 'tabs') return [];
+
+  return group.children
+    .map((childId) => state.activities.get(childId as ActivityId))
+    .filter((activity): activity is ActivityNode => activity !== undefined);
+}
+
+/**
+ * Find the first tabs group in the state
+ */
+export function findTabsGroup(state: EventDrivenState): GroupNode | undefined {
+  for (const group of state.groups.values()) {
+    if (group.layout === 'tabs') {
+      return group;
+    }
+  }
+  return undefined;
+}

package/src/types.ts

@@ -0,0 +1,106 @@
+/**
+ * Shared Types for CLI Tabs
+ *
+ * Framework-agnostic types used by both Ink and OpenTUI adapters.
+ */
+
+import type { ActivityId, GroupId, GroupLayout } from '@pokit/core';
+
+// =============================================================================
+// Tab Process Types
+// =============================================================================
+
+export type TabStatus = 'running' | 'done' | 'error' | 'stopped';
+
+export type TabProcess = {
+  id: string;
+  label: string;
+  exec: string;
+  output: string[];
+  status: TabStatus;
+  exitCode?: number;
+};
+
+export const MAX_OUTPUT_LINES = 10_000;
+export const MAX_LINE_LENGTH = 5_000;
+export const BUFFER_WARNING_THRESHOLD = 80; // Percentage
+
+// =============================================================================
+// Status Indicator Styling
+// =============================================================================
+
+/**
+ * Status indicator configuration for tabs.
+ *
+ * Color scheme:
+ * - running: green (active process)
+ * - done: cyan (completed/inactive)
+ * - error: red (failed)
+ * - stopped: yellow (manually stopped)
+ */
+export type StatusIndicator = {
+  color: string;
+  colorBright: string;
+  icon: string;
+};
+
+export const STATUS_INDICATORS: Record<TabStatus, StatusIndicator> = {
+  running: { color: '#00AA00', colorBright: '#00FF00', icon: '●' },
+  done: { color: '#00AAAA', colorBright: '#00FFFF', icon: '○' },
+  error: { color: '#AA0000', colorBright: '#FF0000', icon: '✗' },
+  stopped: { color: '#AAAA00', colorBright: '#FFFF00', icon: '■' },
+};
+
+export function getStatusIndicator(
+  status: TabStatus,
+  bright: boolean = false
+): { color: string; icon: string } {
+  const indicator = STATUS_INDICATORS[status];
+  return {
+    color: bright ? indicator.colorBright : indicator.color,
+    icon: indicator.icon,
+  };
+}
+
+// =============================================================================
+// Event-Driven State Types
+// =============================================================================
+
+/**
+ * Activity node in the state tree
+ */
+export type ActivityNode = {
+  type: 'activity';
+  id: ActivityId;
+  parentId?: GroupId | ActivityId;
+  label: string;
+  status: 'running' | 'success' | 'failure';
+  progress?: number;
+  message?: string;
+  meta?: Record<string, unknown>;
+  logs: Array<{ level: string; message: string }>;
+};
+
+/**
+ * Group node in the state tree
+ */
+export type GroupNode = {
+  type: 'group';
+  id: GroupId;
+  parentId?: GroupId;
+  label: string;
+  layout: GroupLayout;
+  children: Array<ActivityId | GroupId>;
+};
+
+/**
+ * Root state for the event-driven CLI
+ */
+export type EventDrivenState = {
+  appName?: string;
+  version?: string;
+  exitCode?: number;
+  activities: Map<ActivityId, ActivityNode>;
+  groups: Map<GroupId, GroupNode>;
+  rootChildren: Array<ActivityId | GroupId>;
+};