@posthog/wizard 2.9.1 → 2.10.1

package/dist/src/ui/tui/start-tui.d.ts

@@ -1,9 +0,0 @@
-/**
- * start-tui.ts — Sets up the Ink TUI renderer and InkUI.
- */
-import { WizardStore, Flow } from './store.js';
-export declare function startTUI(version: string, flow?: Flow): {
-    unmount: () => void;
-    store: WizardStore;
-    waitForSetup: () => Promise<void>;
-};

package/dist/src/ui/tui/start-tui.js

@@ -1,41 +0,0 @@
-/**
- * start-tui.ts — Sets up the Ink TUI renderer and InkUI.
- */
-import { render } from 'ink';
-import { createElement } from 'react';
-import { WizardStore, Flow } from './store.js';
-import { InkUI } from './ink-ui.js';
-import { setUI } from '../index.js';
-import { App } from './App.js';
-// ANSI escape sequences
-const RESET_ATTRS = '\x1b[0m';
-const CLEAR_SCREEN = '\x1b[2J';
-const CURSOR_HOME = '\x1b[H';
-const BG_BLACK = '\x1b[48;2;0;0;0m';
-/** Set background to true black, clear screen, cursor to top-left. */
-const FORCE_DARK = BG_BLACK + CLEAR_SCREEN + CURSOR_HOME;
-export function startTUI(version, flow = Flow.PostHogIntegration) {
-    // Force dark background regardless of terminal theme
-    process.stdout.write(FORCE_DARK);
-    const store = new WizardStore(flow);
-    store.version = version;
-    // Swap in the InkUI
-    const inkUI = new InkUI(store);
-    setUI(inkUI);
-    // Render the Ink app
-    const { unmount: inkUnmount } = render(createElement(App, { store }));
-    // Reset terminal on exit
-    const cleanup = () => {
-        process.stdout.write(RESET_ATTRS + CLEAR_SCREEN + CURSOR_HOME);
-    };
-    process.on('exit', cleanup);
-    return {
-        unmount: () => {
-            inkUnmount();
-            cleanup();
-        },
-        store,
-        waitForSetup: () => store.getGate('intro'),
-    };
-}
-//# sourceMappingURL=start-tui.js.map

package/dist/src/ui/tui/start-tui.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"start-tui.js","sourceRoot":"","sources":["../../../../src/ui/tui/start-tui.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,wBAAwB;AACxB,MAAM,WAAW,GAAG,SAAS,CAAC;AAC9B,MAAM,YAAY,GAAG,SAAS,CAAC;AAC/B,MAAM,WAAW,GAAG,QAAQ,CAAC;AAC7B,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AAEpC,sEAAsE;AACtE,MAAM,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,CAAC;AAEzD,MAAM,UAAU,QAAQ,CACtB,OAAe,EACf,OAAa,IAAI,CAAC,kBAAkB;IAMpC,qDAAqD;IACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAEjC,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IAExB,oBAAoB;IACpB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,KAAK,CAAC,KAAK,CAAC,CAAC;IAEb,qBAAqB;IACrB,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAEtE,yBAAyB;IACzB,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,GAAG,YAAY,GAAG,WAAW,CAAC,CAAC;IACjE,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE5B,OAAO;QACL,OAAO,EAAE,GAAG,EAAE;YACZ,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,KAAK;QACL,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;KAC3C,CAAC;AACJ,CAAC","sourcesContent":["/**\n * start-tui.ts — Sets up the Ink TUI renderer and InkUI.\n */\n\nimport { render } from 'ink';\nimport { createElement } from 'react';\nimport { WizardStore, Flow } from './store.js';\nimport { InkUI } from './ink-ui.js';\nimport { setUI } from '../index.js';\nimport { App } from './App.js';\n\n// ANSI escape sequences\nconst RESET_ATTRS = '\\x1b[0m';\nconst CLEAR_SCREEN = '\\x1b[2J';\nconst CURSOR_HOME = '\\x1b[H';\nconst BG_BLACK = '\\x1b[48;2;0;0;0m';\n\n/** Set background to true black, clear screen, cursor to top-left. */\nconst FORCE_DARK = BG_BLACK + CLEAR_SCREEN + CURSOR_HOME;\n\nexport function startTUI(\n  version: string,\n  flow: Flow = Flow.PostHogIntegration,\n): {\n  unmount: () => void;\n  store: WizardStore;\n  waitForSetup: () => Promise<void>;\n} {\n  // Force dark background regardless of terminal theme\n  process.stdout.write(FORCE_DARK);\n\n  const store = new WizardStore(flow);\n  store.version = version;\n\n  // Swap in the InkUI\n  const inkUI = new InkUI(store);\n  setUI(inkUI);\n\n  // Render the Ink app\n  const { unmount: inkUnmount } = render(createElement(App, { store }));\n\n  // Reset terminal on exit\n  const cleanup = () => {\n    process.stdout.write(RESET_ATTRS + CLEAR_SCREEN + CURSOR_HOME);\n  };\n  process.on('exit', cleanup);\n\n  return {\n    unmount: () => {\n      inkUnmount();\n      cleanup();\n    },\n    store,\n    waitForSetup: () => store.getGate('intro'),\n  };\n}\n"]}

package/dist/src/ui/tui/store.d.ts

@@ -1,190 +0,0 @@
-/**
- * WizardStore — Nanostore-backed reactive store for the TUI.
- * React components subscribe via useSyncExternalStore.
- *
- * The active screen is derived from session state — WizardRouter walks
- * the flow and shows the first step whose `isComplete` is still false.
- *
- * Define a step `gate` if your screen needs to await user interactions.
- * bin.ts calls `await store.getGate(stepId)` to pause until the gate
- * predicate becomes true.
- *
- * All session mutations that affect screen resolution go through
- * explicit setters so emitChange() is always called.
- */
-import { TaskStatus } from '../wizard-ui.js';
-import { type WizardSession, type OutroData, type DiscoveredFeature, AdditionalFeature, McpOutcome, RunPhase } from '../../lib/wizard-session.js';
-import type { SettingsConflict } from '../../lib/agent/agent-interface.js';
-import type { WizardReadinessResult } from '../../lib/health-checks/readiness.js';
-import { WizardRouter, type ScreenName, Screen, Overlay, Flow } from './router.js';
-export { TaskStatus, Screen, Overlay, Flow, RunPhase, McpOutcome };
-export type { ScreenName, OutroData, WizardSession };
-export interface TaskItem {
-    label: string;
-    activeForm?: string;
-    status: TaskStatus;
-    /** Legacy compat */
-    done: boolean;
-}
-export interface PlannedEvent {
-    name: string;
-    description: string;
-}
-export declare class WizardStore {
-    private $session;
-    private $statusMessages;
-    private $statusExpanded;
-    private $tasks;
-    private $eventPlan;
-    private $learnCardBlockIdx;
-    private $learnCardComplete;
-    private $version;
-    /** Last screen seen — used to detect screen transitions for analytics. */
-    private _lastScreen;
-    /** Hooks run when transitioning onto a screen. */
-    private _enterScreenHooks;
-    /** Gate promises derived from workflow step definitions. */
-    private _gates;
-    version: string;
-    /** Navigation router — resolves active screen from session state. */
-    readonly router: WizardRouter;
-    /** Blocks agent execution until the settings-override overlay is dismissed. */
-    private _resolveSettingsOverride;
-    private _backupAndFixSettings;
-    /** Blocks OAuth flow until the port-conflict overlay is dismissed. */
-    private _resolvePortConflict;
-    constructor(flow?: Flow);
-    /**
-     * Scan workflow steps for gate predicates and onInit callbacks.
-     * Creates gate promises and fires init work.
-     */
-    private _initFromWorkflow;
-    /**
-     * Run all `onReady` hooks declared by the current flow's steps, in
-     * order. Must be called after `store.session = session` so hooks see
-     * the real installDir. bin.ts calls this generically — it doesn't
-     * need to know which workflow has which pre-flow work.
-     */
-    runReadyHooks(): Promise<void>;
-    /**
-     * Get a gate promise by step ID — the primary blocking checkpoint API
-     * for bin.ts. `await store.getGate('...')` parks the caller until the
-     * corresponding workflow step's gate predicate flips to true (if the
-     * predicate stays false, the caller stays parked indefinitely — the
-     * TUI keeps rendering so the user can resolve whatever is blocking).
-     *
-     * If the workflow doesn't define a step with this ID, or the step
-     * has no `gate` predicate, this returns an already-resolved promise
-     * so bin.ts flows straight through. This lets workflows opt in to
-     * gates on a per-step basis without bin.ts needing to know which
-     * gates exist in which flow.
-     */
-    getGate(stepId: string): Promise<void>;
-    /**
-     * Re-evaluate every gate predicate against the current session and
-     * resolve any whose predicate now returns true. Called after every
-     * emitChange(), so gates unblock as soon as the session mutation
-     * that satisfies them lands. Gates only resolve once — a predicate
-     * that goes true → false → true will NOT re-block a caller that
-     * already awaited through.
-     */
-    private _checkGates;
-    get session(): WizardSession;
-    set session(value: WizardSession);
-    get statusMessages(): string[];
-    get tasks(): TaskItem[];
-    get eventPlan(): PlannedEvent[];
-    get statusExpanded(): boolean;
-    toggleStatusExpanded(): void;
-    setStatusExpanded(expanded: boolean): void;
-    /** Sets setupConfirmed. Gate resolves via _checkGates(). */
-    completeSetup(): void;
-    setRunPhase(phase: RunPhase): void;
-    setCredentials(credentials: WizardSession['credentials']): void;
-    setFrameworkConfig(integration: WizardSession['integration'], config: WizardSession['frameworkConfig']): void;
-    setDetectionComplete(): void;
-    setDetectedFramework(label: string): void;
-    setUnsupportedVersion(info: {
-        current: string;
-        minimum: string;
-        docsUrl: string;
-    }): void;
-    setLoginUrl(url: string | null): void;
-    setReadinessResult(result: WizardReadinessResult | null): void;
-    /** User dismissed the blocking outage screen. Gate resolves via _checkGates(). */
-    dismissOutage(): void;
-    /**
-     * Push the settings-override overlay and return a promise that blocks
-     * until the user dismisses it via backupAndFixSettingsOverride().
-     */
-    showSettingsOverride(conflicts: SettingsConflict[], backupAndFix: () => boolean): Promise<void>;
-    /**
-     * Push the port-conflict overlay and return a promise that blocks
-     * until the user kills the blocking process or exits.
-     */
-    showPortConflict(processInfo: {
-        command: string;
-        pid: string;
-        user: string;
-    }): Promise<void>;
-    /** Dismiss the port-conflict overlay after the user kills the process. */
-    resolvePortConflict(): void;
-    /**
-     * Back up .claude/settings.json. Dismisses the overlay on success.
-     */
-    backupAndFixSettingsOverride(): boolean;
-    /** Push the auth-error overlay (no dismiss — user must exit). */
-    showAuthError(): void;
-    addDiscoveredFeature(feature: DiscoveredFeature): void;
-    /**
-     * Enable an additional feature: enqueue it for the stop hook
-     * and set any feature-specific session flags.
-     */
-    enableFeature(feature: AdditionalFeature): void;
-    setMcpComplete(outcome?: McpOutcome, installedClients?: string[]): void;
-    setSkillsComplete(kept: boolean): void;
-    setOutroDismissed(): void;
-    setOutroData(data: OutroData): void;
-    setFrameworkContext(key: string, value: unknown): void;
-    /**
-     * The screen that should be rendered right now.
-     * Derived from session state via the router.
-     */
-    get currentScreen(): ScreenName;
-    /** Direction hint for screen transitions. */
-    get lastNavDirection(): 'push' | 'pop' | null;
-    getVersion(): number;
-    /**
-     * Notify React that state has changed.
-     * The router re-resolves the active screen on next render.
-     * Gate predicates are checked and resolved if ready.
-     */
-    emitChange(): void;
-    pushOverlay(overlay: Overlay): void;
-    popOverlay(): void;
-    /**
-     * Register a callback to run when transitioning onto the given screen.
-     * Fires after every transition that lands on this screen.
-     */
-    onEnterScreen(screen: ScreenName, fn: () => void): void;
-    /**
-     * Detect screen transitions, run enter-screen hooks, and fire analytics.
-     * Called at the end of emitChange/pushOverlay/popOverlay.
-     */
-    private _detectTransition;
-    pushStatus(message: string): void;
-    setTasks(tasks: TaskItem[]): void;
-    updateTask(index: number, done: boolean): void;
-    setEventPlan(events: PlannedEvent[]): void;
-    get learnCardBlockIdx(): number;
-    setLearnCardBlockIdx(idx: number): void;
-    get learnCardComplete(): boolean;
-    setLearnCardComplete(): void;
-    syncTodos(todos: Array<{
-        content: string;
-        status: string;
-        activeForm?: string;
-    }>): void;
-    subscribe(callback: () => void): () => void;
-    getSnapshot(): number;
-}