@c15t/cli 1.8.3 → 2.0.0-rc.0

package/dist/machines/generate/machine.d.ts

@@ -0,0 +1,250 @@
+/**
+ * Generate command state machine
+ *
+ * Main state machine for the generate flow with all states, transitions, and actors.
+ */
+import type { StorageMode } from '../../constants';
+import type { CliContext } from '../../context/types';
+import { type GenerateMachineContext } from './types';
+/**
+ * The generate state machine definition
+ */
+export declare const generateMachine: import("xstate").StateMachine<GenerateMachineContext, {
+    type: "START";
+} | {
+    type: "CANCEL";
+    reason?: string;
+} | {
+    type: "RETRY";
+} | {
+    type: "RESET";
+} | {
+    type: "PREFLIGHT_COMPLETE";
+    result: {
+        passed: boolean;
+        checks: import("./types").PreflightCheckResult[];
+        projectRoot: string;
+        framework: GenerateMachineContext["framework"];
+        packageManager: import("../../context/package-manager-detection").PackageManagerResult;
+    };
+} | {
+    type: "PREFLIGHT_RETRY";
+} | {
+    type: "SELECT_MODE";
+    mode: StorageMode;
+} | {
+    type: "MODE_SELECTED";
+    mode: StorageMode;
+} | {
+    type: "ACCOUNT_CREATION_COMPLETE";
+    needsAccount: boolean;
+} | {
+    type: "BROWSER_OPENED";
+} | {
+    type: "BACKEND_URL_ENTERED";
+    url: string;
+} | {
+    type: "BACKEND_OPTIONS_COMPLETE";
+    useEnvFile: boolean;
+    proxyNextjs: boolean;
+} | {
+    type: "FRONTEND_OPTIONS_COMPLETE";
+    enableSSR?: boolean;
+    enableDevTools?: boolean;
+    uiStyle: import("./types").UIStyle;
+    expandedTheme?: import("./types").ExpandedTheme;
+} | {
+    type: "SCRIPTS_OPTION_COMPLETE";
+    addScripts: boolean;
+} | {
+    type: "FILES_GENERATED";
+    filesCreated: string[];
+    filesModified: import("..").FileModification[];
+} | {
+    type: "FILE_GENERATION_ERROR";
+    error: Error;
+} | {
+    type: "CONFIRM_INSTALL";
+    confirmed: boolean;
+} | {
+    type: "INSTALL_COMPLETE";
+    success: boolean;
+} | {
+    type: "SKIP_INSTALL";
+} | {
+    type: "SHOW_SUMMARY";
+} | {
+    type: "GITHUB_STAR_PROMPT";
+    opened: boolean;
+} | {
+    type: "COMPLETE";
+} | {
+    type: "ROLLBACK_COMPLETE";
+} | {
+    type: "CLEANUP_COMPLETE";
+}, {
+    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/preflight").PreflightOutput, import("./actors/preflight").PreflightInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/prompts").ModeSelectionOutput, import("./actors/prompts").ModeSelectionInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/prompts").BackendOptionsOutput, import("./actors/prompts").BackendOptionsInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/prompts").FrontendOptionsOutput, import("./actors/prompts").FrontendOptionsInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/file-generation").FileGenerationOutput, import("./actors/file-generation").FileGenerationInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/dependencies").DependencyInstallOutput, import("./actors/dependencies").DependencyInstallInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/prompts").GitHubStarOutput, import("./actors/prompts").GitHubStarInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/prompts").BackendURLOutput, import("./actors/prompts").BackendURLInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/prompts").AccountCreationOutput, import("./actors/prompts").AccountCreationInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/prompts").ScriptsOptionOutput, import("./actors/prompts").ScriptsOptionInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/dependencies").CheckDepsOutput, import("./actors/dependencies").CheckDepsInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/prompts").InstallConfirmOutput, import("./actors/prompts").InstallConfirmInput, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<import("./actors/file-generation").RollbackOutput, import("./actors/file-generation").RollbackInput, import("xstate").EventObject>> | undefined;
+}, {
+    src: "preflight";
+    logic: import("xstate").PromiseActorLogic<import("./actors/preflight").PreflightOutput, import("./actors/preflight").PreflightInput, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "modeSelection";
+    logic: import("xstate").PromiseActorLogic<import("./actors/prompts").ModeSelectionOutput, import("./actors/prompts").ModeSelectionInput, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "backendOptions";
+    logic: import("xstate").PromiseActorLogic<import("./actors/prompts").BackendOptionsOutput, import("./actors/prompts").BackendOptionsInput, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "frontendOptions";
+    logic: import("xstate").PromiseActorLogic<import("./actors/prompts").FrontendOptionsOutput, import("./actors/prompts").FrontendOptionsInput, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "fileGeneration";
+    logic: import("xstate").PromiseActorLogic<import("./actors/file-generation").FileGenerationOutput, import("./actors/file-generation").FileGenerationInput, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "dependencyInstall";
+    logic: import("xstate").PromiseActorLogic<import("./actors/dependencies").DependencyInstallOutput, import("./actors/dependencies").DependencyInstallInput, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "githubStar";
+    logic: import("xstate").PromiseActorLogic<import("./actors/prompts").GitHubStarOutput, import("./actors/prompts").GitHubStarInput, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "backendURL";
+    logic: import("xstate").PromiseActorLogic<import("./actors/prompts").BackendURLOutput, import("./actors/prompts").BackendURLInput, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "accountCreation";
+    logic: import("xstate").PromiseActorLogic<import("./actors/prompts").AccountCreationOutput, import("./actors/prompts").AccountCreationInput, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "scriptsOption";
+    logic: import("xstate").PromiseActorLogic<import("./actors/prompts").ScriptsOptionOutput, import("./actors/prompts").ScriptsOptionInput, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "checkDependencies";
+    logic: import("xstate").PromiseActorLogic<import("./actors/dependencies").CheckDepsOutput, import("./actors/dependencies").CheckDepsInput, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "installConfirm";
+    logic: import("xstate").PromiseActorLogic<import("./actors/prompts").InstallConfirmOutput, import("./actors/prompts").InstallConfirmInput, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "rollback";
+    logic: import("xstate").PromiseActorLogic<import("./actors/file-generation").RollbackOutput, import("./actors/file-generation").RollbackInput, import("xstate").EventObject>;
+    id: string | undefined;
+}, never, {
+    type: "hasReact";
+    params: unknown;
+} | {
+    type: "isC15tMode";
+    params: unknown;
+} | {
+    type: "preflightPassed";
+    params: unknown;
+} | {
+    type: "preflightFailed";
+    params: unknown;
+} | {
+    type: "hasModeArg";
+    params: unknown;
+} | {
+    type: "isOfflineMode";
+    params: unknown;
+} | {
+    type: "isSelfHostedMode";
+    params: unknown;
+} | {
+    type: "isCustomMode";
+    params: unknown;
+} | {
+    type: "modeRequiresBackend";
+    params: unknown;
+} | {
+    type: "modeNoBackend";
+    params: unknown;
+} | {
+    type: "isNextjs";
+    params: unknown;
+} | {
+    type: "isReact";
+    params: unknown;
+} | {
+    type: "isCore";
+    params: unknown;
+} | {
+    type: "hasTailwind";
+    params: unknown;
+} | {
+    type: "hasBackendURL";
+    params: unknown;
+} | {
+    type: "isExpandedUIStyle";
+    params: unknown;
+} | {
+    type: "installConfirmed";
+    params: unknown;
+} | {
+    type: "installSucceeded";
+    params: unknown;
+} | {
+    type: "hasFilesToRollback";
+    params: unknown;
+} | {
+    type: "hasDependencies";
+    params: unknown;
+} | {
+    type: "hasErrors";
+    params: unknown;
+} | {
+    type: "needsCleanup";
+    params: unknown;
+} | {
+    type: "shouldPromptSSR";
+    params: unknown;
+} | {
+    type: "shouldPromptUIStyle";
+    params: unknown;
+}, never, "error" | "exited" | "complete" | "preflightError" | "idle" | "preflight" | "modeSelection" | "offlineMode" | "selfHostedMode" | "customMode" | "backendOptions" | "frontendOptions" | "scriptsOptions" | "fileGeneration" | "dependencyInstall" | "summary" | "githubStar" | "cancelling" | "rollback" | "routeToMode" | "dependencyCheck" | "dependencyConfirm" | {
+    c15tMode: "backendURL" | "accountCreation";
+}, string, {
+    cliContext: CliContext;
+    modeArg?: StorageMode;
+}, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
+    id: "generate";
+    states: {
+        readonly idle: {};
+        readonly preflight: {};
+        readonly preflightError: {};
+        readonly modeSelection: {};
+        readonly routeToMode: {};
+        readonly c15tMode: {
+            states: {
+                readonly accountCreation: {};
+                readonly backendURL: {};
+            };
+        };
+        readonly offlineMode: {};
+        readonly selfHostedMode: {};
+        readonly customMode: {};
+        readonly backendOptions: {};
+        readonly frontendOptions: {};
+        readonly scriptsOptions: {};
+        readonly fileGeneration: {};
+        readonly dependencyCheck: {};
+        readonly dependencyConfirm: {};
+        readonly dependencyInstall: {};
+        readonly summary: {};
+        readonly githubStar: {};
+        readonly complete: {};
+        readonly error: {};
+        readonly cancelling: {};
+        readonly rollback: {};
+        readonly exited: {};
+    };
+}>;
+export type GenerateMachine = typeof generateMachine;
+//# sourceMappingURL=machine.d.ts.map

package/dist/machines/generate/machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../../../src/machines/generate/machine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAwBlD,OAAO,EAEN,KAAK,sBAAsB,EAE3B,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAIC,UAAU;cAAY,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8lB5D,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC"}

package/dist/machines/generate/runner.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Runner for the generate state machine
+ *
+ * Creates and runs the generate machine with proper setup.
+ */
+import { createActor } from 'xstate';
+import type { StorageMode } from '../../constants';
+import type { CliContext } from '../../context/types';
+import type { MachineExecutionResult } from '../types';
+import { generateMachine } from './machine';
+import type { GenerateMachineContext } from './types';
+/**
+ * Options for running the generate machine
+ */
+export interface RunGenerateOptions {
+    /** CLI context */
+    context: CliContext;
+    /** Mode passed as CLI argument */
+    modeArg?: StorageMode;
+    /** Whether to resume from persisted state */
+    resume?: boolean;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Enable state persistence */
+    persist?: boolean;
+}
+/**
+ * Run the generate state machine
+ *
+ * @param options - Options for running the machine
+ * @returns Promise that resolves when the machine completes
+ */
+export declare function runGenerateMachine(options: RunGenerateOptions): Promise<MachineExecutionResult<GenerateMachineContext>>;
+/**
+ * Cancel signal handler for graceful shutdown
+ *
+ * @param actor - The running actor to cancel
+ */
+export declare function setupCancelHandler(actor: ReturnType<typeof createActor<typeof generateMachine>>): void;
+//# sourceMappingURL=runner.d.ts.map

package/dist/machines/generate/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/machines/generate/runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAclD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,kBAAkB;IAClB,OAAO,EAAE,UAAU,CAAC;IACpB,kCAAkC;IAClC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,kBAAkB,GACzB,OAAO,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,CAAC,CAoHzD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,OAAO,eAAe,CAAC,CAAC,GAC3D,IAAI,CAeN"}

package/dist/machines/generate/types.d.ts

@@ -0,0 +1,189 @@
+/**
+ * Type definitions for the generate command state machine
+ *
+ * Defines context, events, and state types for the generate flow.
+ */
+import type { StorageMode } from '../../constants';
+import type { AvailablePackages } from '../../context/framework-detection';
+import type { PackageManagerResult } from '../../context/package-manager-detection';
+import type { CliContext } from '../../context/types';
+import type { BaseMachineContext, FileModification } from '../types';
+/**
+ * UI style selection for component generation
+ */
+export type UIStyle = 'prebuilt' | 'expanded';
+/**
+ * Theme preset
+ */
+export type ExpandedTheme = 'none' | 'minimal' | 'dark' | 'tailwind';
+/**
+ * Context for the generate state machine
+ */
+export interface GenerateMachineContext extends BaseMachineContext {
+    /** Reference to the CLI context (not serializable, set on init) */
+    cliContext: CliContext | null;
+    /** Project root directory */
+    projectRoot: string;
+    /** Detected framework information */
+    framework: {
+        name: string | null;
+        version: string | null;
+        pkg: AvailablePackages;
+        hasReact: boolean;
+        reactVersion: string | null;
+        tailwindVersion: string | null;
+    } | null;
+    /** Detected package manager */
+    packageManager: PackageManagerResult | null;
+    /** Whether preflight checks passed */
+    preflightPassed: boolean;
+    /** Preflight check details */
+    preflightChecks: PreflightCheckResult[];
+    /** Selected storage mode */
+    selectedMode: StorageMode | null;
+    /** Mode passed as CLI argument */
+    modeArg: StorageMode | null;
+    /** Backend URL for c15t/self-hosted modes */
+    backendURL: string | null;
+    /** Whether to store backend URL in .env file */
+    useEnvFile: boolean;
+    /** Whether to proxy requests via Next.js rewrites */
+    proxyNextjs: boolean;
+    /** Whether to enable SSR for initial data fetch */
+    enableSSR: boolean;
+    /** Whether to install and enable c15t DevTools */
+    enableDevTools: boolean;
+    /** UI component style selection */
+    uiStyle: UIStyle;
+    /** Theme preset for expanded components */
+    expandedTheme: ExpandedTheme | null;
+    /** Whether to add c15t scripts package */
+    addScripts: boolean;
+    /** Selected scripts to pre-configure */
+    selectedScripts: string[];
+    /** Paths to files created during generation */
+    filesCreated: string[];
+    /** Files modified with backup for rollback */
+    filesModified: FileModification[];
+    /** Dependencies to install */
+    dependenciesToAdd: string[];
+    /** Whether user confirmed dependency installation */
+    installConfirmed: boolean;
+    /** Whether installation was attempted */
+    installAttempted: boolean;
+    /** Whether installation succeeded */
+    installSucceeded: boolean;
+    /** Whether to run database migrations (self-hosted mode) */
+    runMigrations: boolean;
+    /** Reason for cancellation if cancelled */
+    cancelReason: string | null;
+    /** Whether cleanup has been performed */
+    cleanupDone: boolean;
+}
+/**
+ * Result of a preflight check
+ */
+export interface PreflightCheckResult {
+    name: string;
+    status: 'pass' | 'warn' | 'fail';
+    message: string;
+    hint?: string;
+}
+/**
+ * Events for the generate state machine
+ */
+export type GenerateMachineEvent = {
+    type: 'START';
+} | {
+    type: 'CANCEL';
+    reason?: string;
+} | {
+    type: 'RETRY';
+} | {
+    type: 'RESET';
+} | {
+    type: 'PREFLIGHT_COMPLETE';
+    result: {
+        passed: boolean;
+        checks: PreflightCheckResult[];
+        projectRoot: string;
+        framework: GenerateMachineContext['framework'];
+        packageManager: PackageManagerResult;
+    };
+} | {
+    type: 'PREFLIGHT_RETRY';
+} | {
+    type: 'SELECT_MODE';
+    mode: StorageMode;
+} | {
+    type: 'MODE_SELECTED';
+    mode: StorageMode;
+} | {
+    type: 'ACCOUNT_CREATION_COMPLETE';
+    needsAccount: boolean;
+} | {
+    type: 'BROWSER_OPENED';
+} | {
+    type: 'BACKEND_URL_ENTERED';
+    url: string;
+} | {
+    type: 'BACKEND_OPTIONS_COMPLETE';
+    useEnvFile: boolean;
+    proxyNextjs: boolean;
+} | {
+    type: 'FRONTEND_OPTIONS_COMPLETE';
+    enableSSR?: boolean;
+    enableDevTools?: boolean;
+    uiStyle: UIStyle;
+    expandedTheme?: ExpandedTheme;
+} | {
+    type: 'SCRIPTS_OPTION_COMPLETE';
+    addScripts: boolean;
+} | {
+    type: 'FILES_GENERATED';
+    filesCreated: string[];
+    filesModified: FileModification[];
+} | {
+    type: 'FILE_GENERATION_ERROR';
+    error: Error;
+} | {
+    type: 'CONFIRM_INSTALL';
+    confirmed: boolean;
+} | {
+    type: 'INSTALL_COMPLETE';
+    success: boolean;
+} | {
+    type: 'SKIP_INSTALL';
+} | {
+    type: 'SHOW_SUMMARY';
+} | {
+    type: 'GITHUB_STAR_PROMPT';
+    opened: boolean;
+} | {
+    type: 'COMPLETE';
+} | {
+    type: 'ROLLBACK_COMPLETE';
+} | {
+    type: 'CLEANUP_COMPLETE';
+};
+/**
+ * State value types for the generate machine
+ */
+export type GenerateMachineStateValue = 'idle' | 'preflight' | 'preflightError' | 'modeSelection' | 'c15tMode' | 'offlineMode' | 'selfHostedMode' | 'customMode' | 'backendOptions' | 'frontendOptions' | 'scriptsOptions' | 'fileGeneration' | 'dependencyInstall' | 'summary' | 'githubStar' | 'complete' | 'error' | 'cancelling' | 'cleanup' | 'exited';
+/**
+ * Initial context for the generate machine
+ */
+export declare function createInitialContext(cliContext?: CliContext, modeArg?: StorageMode): GenerateMachineContext;
+/**
+ * Type guard for checking if a mode requires backend URL
+ */
+export declare function modeRequiresBackend(mode: StorageMode): boolean;
+/**
+ * Type guard for checking if framework is Next.js
+ */
+export declare function isNextjsFramework(framework: GenerateMachineContext['framework']): boolean;
+/**
+ * Type guard for checking if framework has React
+ */
+export declare function hasReactFramework(framework: GenerateMachineContext['framework']): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/machines/generate/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/machines/generate/types.ts"],"names":[],"mappings":"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"}

package/dist/machines/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * State machines for CLI commands
+ *
+ * Exports all state machines and utilities.
+ */
+export { actions as generateActions } from './generate/actions';
+export { checkDependenciesActor, dependencyInstallActor, getManualInstallCommand, } from './generate/actors/dependencies';
+export { fileGenerationActor, rollbackActor, } from './generate/actors/file-generation';
+export { displayPreflightFailure, displayPreflightResults, preflightActor, } from './generate/actors/preflight';
+export { accountCreationActor, backendOptionsActor, backendURLActor, frontendOptionsActor, githubStarActor, installConfirmActor, modeSelectionActor, PromptCancelledError, scriptsOptionActor, } from './generate/actors/prompts';
+export { guards as generateGuards } from './generate/guards';
+export { type GenerateMachine, generateMachine } from './generate/machine';
+export type { RunGenerateOptions } from './generate/runner';
+export { runGenerateMachine, setupCancelHandler } from './generate/runner';
+export type { ExpandedTheme, GenerateMachineContext, GenerateMachineEvent, GenerateMachineStateValue, PreflightCheckResult, UIStyle, } from './generate/types';
+export { createInitialContext } from './generate/types';
+export * from './persistence';
+export * from './telemetry-plugin';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/machines/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/machines/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EACN,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,GACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACN,mBAAmB,EACnB,aAAa,GACb,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACN,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,GACd,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACN,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAAE,KAAK,eAAe,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC3E,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,YAAY,EACX,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,OAAO,GACP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AAEnC,cAAc,SAAS,CAAC"}

package/dist/machines/persistence.d.ts

@@ -0,0 +1,65 @@
+/**
+ * State persistence utilities for CLI state machines
+ *
+ * Enables saving and loading machine snapshots for resume functionality.
+ */
+import type { AnyStateMachine, SnapshotFrom } from 'xstate';
+/**
+ * Persisted state structure
+ */
+export interface PersistedState<T = unknown> {
+    /** Machine ID this state belongs to */
+    machineId: string;
+    /** Version for migration support */
+    version: number;
+    /** Timestamp when state was saved */
+    savedAt: number;
+    /** The actual snapshot data */
+    snapshot: T;
+}
+/**
+ * Get the persistence file path for a project
+ */
+export declare function getPersistPath(projectRoot: string): string;
+/**
+ * Save a machine snapshot to disk
+ */
+export declare function saveSnapshot<TMachine extends AnyStateMachine>(snapshot: SnapshotFrom<TMachine>, machineId: string, persistPath: string): Promise<void>;
+/**
+ * Load a machine snapshot from disk
+ *
+ * @returns The snapshot if found and valid, null otherwise
+ */
+export declare function loadSnapshot<TSnapshot>(persistPath: string, machineId: string): Promise<TSnapshot | null>;
+/**
+ * Clear a persisted snapshot
+ */
+export declare function clearSnapshot(persistPath: string): Promise<void>;
+/**
+ * Check if a persisted state exists
+ */
+export declare function hasPersistedState(persistPath: string): Promise<boolean>;
+/**
+ * Get metadata about persisted state without loading full snapshot
+ */
+export declare function getPersistedStateInfo(persistPath: string): Promise<{
+    machineId: string;
+    savedAt: Date;
+} | null>;
+/**
+ * Snapshot type for persistence subscriber
+ */
+interface PersistableSnapshot {
+    value: unknown;
+}
+/**
+ * Create a persistence middleware that auto-saves on state transitions
+ */
+export declare function createPersistenceSubscriber(machineId: string, persistPath: string, options?: {
+    /** States to persist (if not provided, persist all states) */
+    persistStates?: string[];
+    /** States to skip persisting */
+    skipStates?: string[];
+}): (snapshot: PersistableSnapshot) => void;
+export {};
+//# sourceMappingURL=persistence.d.ts.map

package/dist/machines/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/machines/persistence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAY,YAAY,EAAE,MAAM,QAAQ,CAAC;AAKtE;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IAC1C,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,QAAQ,EAAE,CAAC,CAAC;CACZ;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AA8ED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,SAAS,eAAe,EAClE,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,EAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAC3C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAyB3B;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQtE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAS7E;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAC1C,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG,IAAI,CAAC,CActD;AAED;;GAEG;AACH,UAAU,mBAAmB;IAC5B,KAAK,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAC1C,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACR,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,IAKE,UAAU,mBAAmB,UAwBrC"}

package/dist/machines/telemetry-plugin.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Telemetry plugin for XState machines
+ *
+ * Automatically tracks state transitions and events for analytics.
+ */
+import type { Telemetry } from '../utils/telemetry';
+import type { StateHistoryEntry } from './types';
+/**
+ * Configuration for telemetry tracking
+ */
+export interface TelemetryPluginConfig {
+    /** Telemetry instance to use */
+    telemetry: Telemetry;
+    /** Machine ID for event naming */
+    machineId: string;
+    /** States to skip tracking (e.g., transient states) */
+    skipStates?: string[];
+    /** Whether to track all events or just state changes */
+    trackAllEvents?: boolean;
+}
+/**
+ * Snapshot type for subscriber (loosely typed for XState compatibility)
+ */
+interface MachineSnapshot {
+    value: unknown;
+    context?: unknown;
+}
+/**
+ * Creates a telemetry subscriber for a state machine
+ *
+ * Tracks:
+ * - State entry/exit
+ * - State transition timing
+ * - Error states
+ * - Cancellation
+ */
+export declare function createTelemetrySubscriber(config: TelemetryPluginConfig): (snapshot: MachineSnapshot) => void;
+/**
+ * Gets the state history from a subscriber
+ * Useful for debugging and error reporting
+ */
+export declare function getStateHistory(subscriber: ReturnType<typeof createTelemetrySubscriber>): StateHistoryEntry[];
+/**
+ * Creates a combined subscriber that handles both telemetry and custom callbacks
+ */
+export declare function combineSubscribers(...subscribers: Array<(snapshot: MachineSnapshot) => void>): (snapshot: MachineSnapshot) => void;
+/**
+ * Utility to create a simple state logger for debugging
+ */
+export declare function createDebugSubscriber(machineId: string, logger?: {
+    debug: (msg: string, ...args: unknown[]) => void;
+}): (snapshot: MachineSnapshot) => void;
+export {};
+//# sourceMappingURL=telemetry-plugin.d.ts.map

package/dist/machines/telemetry-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-plugin.d.ts","sourceRoot":"","sources":["../../src/machines/telemetry-plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,gCAAgC;IAChC,SAAS,EAAE,SAAS,CAAC;IACrB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,wDAAwD;IACxD,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,UAAU,eAAe;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,qBAAqB,IAO9D,UAAU,eAAe,UAsEjC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,UAAU,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,GACtD,iBAAiB,EAAE,CAIrB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CACjC,GAAG,WAAW,EAAE,KAAK,CAAC,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC,IAElD,UAAU,eAAe,UAUjC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE;IAAE,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CAAE,IAIrD,UAAU,eAAe,UASjC"}