workon 2.1.3 → 3.1.0

package/dist/index.d.ts

@@ -0,0 +1,280 @@
+import File from 'phylo';
+
+type IdeType = 'vscode' | 'idea' | 'atom' | 'code' | 'subl' | 'vim' | 'emacs';
+interface ClaudeConfig {
+    flags?: string[];
+    split_terminal?: boolean;
+}
+interface NpmConfig {
+    command: string;
+    watch?: boolean;
+    auto_restart?: boolean;
+}
+interface DockerConfig {
+    compose_file: string;
+    services?: string[];
+}
+interface EventsConfig {
+    cwd?: boolean;
+    ide?: boolean;
+    web?: boolean;
+    claude?: boolean | ClaudeConfig;
+    npm?: boolean | string | NpmConfig;
+    docker?: boolean | string | DockerConfig;
+    [key: string]: boolean | string | ClaudeConfig | NpmConfig | DockerConfig | undefined;
+}
+interface ProjectConfig {
+    name?: string;
+    path: string;
+    ide?: IdeType;
+    homepage?: string;
+    events: EventsConfig;
+    branch?: string;
+}
+interface ProjectDefaults {
+    base: string;
+    ide?: IdeType;
+    events?: EventsConfig;
+}
+interface AppConfig {
+    project_defaults: ProjectDefaults;
+    projects: Record<string, ProjectConfig>;
+}
+interface EventMetadata {
+    name: string;
+    displayName: string;
+    description: string;
+    category: 'core' | 'development' | 'extension';
+    requiresTmux: boolean;
+    dependencies: string[];
+}
+interface EventProcessingContext {
+    project: Project$1;
+    isShellMode: boolean;
+    shellCommands: string[];
+}
+interface EventValidation {
+    validateConfig(config: unknown): true | string;
+}
+interface EventConfiguration {
+    configureInteractive(): Promise<unknown>;
+    getDefaultConfig(): unknown;
+}
+interface EventProcessing {
+    processEvent(context: EventProcessingContext): Promise<void>;
+    generateShellCommand(context: EventProcessingContext): string[];
+}
+interface EventTmux {
+    getLayoutPriority(): number;
+    contributeToLayout?(enabledCommands: string[]): string;
+}
+interface EventHelp {
+    usage: string;
+    description: string;
+    examples: Array<{
+        config: unknown;
+        description: string;
+    }>;
+}
+interface EventHandler {
+    metadata: EventMetadata;
+    validation: EventValidation;
+    configuration: EventConfiguration;
+    processing: EventProcessing;
+    tmux?: EventTmux | null;
+    help: EventHelp;
+}
+interface Project$1 {
+    name: string;
+    path: {
+        path: string;
+        absolutePath(): string;
+    };
+    ide?: IdeType;
+    homepage?: string;
+    events: EventsConfig;
+    branch?: string;
+    base?: {
+        path: string;
+    };
+}
+interface BaseEnvironment$1 {
+    $isProjectEnvironment: false;
+}
+interface ProjectEnvironment$1 {
+    $isProjectEnvironment: true;
+    project: Project$1;
+}
+type Environment$1 = BaseEnvironment$1 | ProjectEnvironment$1;
+interface Logger {
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    log(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    setLogLevel(level: string): void;
+}
+interface GlobalOptions {
+    debug?: boolean;
+    shell?: boolean;
+}
+interface OpenOptions extends GlobalOptions {
+    dryRun?: boolean;
+}
+
+declare class Config {
+    private _transient;
+    private _store;
+    constructor();
+    get<T = unknown>(key: string, defaultValue?: T): T | undefined;
+    set(key: string, value?: unknown): void;
+    has(key: string): boolean;
+    delete(key: string): void;
+    getProjects(): Record<string, ProjectConfig>;
+    getProject(name: string): ProjectConfig | undefined;
+    setProject(name: string, config: ProjectConfig): void;
+    deleteProject(name: string): void;
+    getDefaults(): ProjectDefaults | undefined;
+    setDefaults(defaults: ProjectDefaults): void;
+    get path(): string;
+    get store(): AppConfig;
+}
+
+declare class Project {
+    name: string;
+    private _base?;
+    private _path?;
+    private _ide?;
+    private _events;
+    private _branch?;
+    private _homepage?;
+    private _defaults;
+    private _initialCfg;
+    constructor(name: string, cfg?: Partial<ProjectConfig>, defaults?: ProjectDefaults);
+    set base(path: string);
+    get base(): ReturnType<typeof File.from> | undefined;
+    set ide(cmd: IdeType | undefined);
+    get ide(): IdeType | undefined;
+    set events(eventCfg: EventsConfig);
+    get events(): EventsConfig;
+    set path(path: string);
+    get path(): ReturnType<typeof File.from>;
+    set branch(branch: string | undefined);
+    get branch(): string | undefined;
+    set homepage(url: string | undefined);
+    get homepage(): string | undefined;
+    static $isProject: boolean;
+    $isProject: boolean;
+}
+
+declare class TmuxManager {
+    private sessionPrefix;
+    isTmuxAvailable(): Promise<boolean>;
+    sessionExists(sessionName: string): Promise<boolean>;
+    getSessionName(projectName: string): string;
+    killSession(sessionName: string): Promise<boolean>;
+    createSplitSession(projectName: string, projectPath: string, claudeArgs?: string[]): Promise<string>;
+    createThreePaneSession(projectName: string, projectPath: string, claudeArgs?: string[], npmCommand?: string): Promise<string>;
+    createTwoPaneNpmSession(projectName: string, projectPath: string, npmCommand?: string): Promise<string>;
+    attachToSession(sessionName: string): Promise<void>;
+    buildShellCommands(projectName: string, projectPath: string, claudeArgs?: string[]): string[];
+    buildThreePaneShellCommands(projectName: string, projectPath: string, claudeArgs?: string[], npmCommand?: string): string[];
+    buildTwoPaneNpmShellCommands(projectName: string, projectPath: string, npmCommand?: string): string[];
+    private getAttachCommand;
+    listWorkonSessions(): Promise<string[]>;
+}
+
+declare class BaseEnvironment {
+    $isProjectEnvironment: false;
+}
+declare class ProjectEnvironment {
+    $isProjectEnvironment: true;
+    project: Project;
+    constructor(projectCfg: ProjectConfig & {
+        name: string;
+        exactName?: string;
+    });
+    static load(cfg: ProjectConfig & {
+        name: string;
+    }, defaults?: ProjectDefaults): ProjectEnvironment;
+}
+type Environment = BaseEnvironment | ProjectEnvironment;
+declare class EnvironmentRecognizer {
+    private static config;
+    private static log;
+    private static projects;
+    private static configured;
+    static configure(config: Config, log: Logger): void;
+    static recognize(dir: string | ReturnType<typeof File.from>): Promise<Environment>;
+    private static getAllProjects;
+    private static getProjectEnvironment;
+    private static ensureConfigured;
+}
+
+/**
+ * Event Registry for management of events
+ * Uses explicit imports to work with bundled builds
+ */
+declare class EventRegistryClass {
+    private _events;
+    private _initialized;
+    /**
+     * Initialize the registry by registering all events
+     */
+    initialize(): Promise<void>;
+    /**
+     * Register all event classes
+     */
+    private registerEvents;
+    /**
+     * Validate if a class is a proper event
+     */
+    private isValidEvent;
+    /**
+     * Get all valid event names from registered events
+     */
+    getValidEventNames(): string[];
+    /**
+     * Get event by name
+     */
+    getEventByName(name: string): EventHandler | null;
+    /**
+     * Get all events for management UI
+     */
+    getEventsForManageUI(): Array<{
+        name: string;
+        value: string;
+        description: string;
+    }>;
+    /**
+     * Get events that support tmux integration
+     */
+    getTmuxEnabledEvents(): Array<{
+        name: string;
+        event: EventHandler;
+        priority: number;
+    }>;
+    /**
+     * Get all available events with their metadata
+     */
+    getAllEvents(): Array<{
+        name: string;
+        metadata: EventMetadata;
+        hasValidation: boolean;
+        hasConfiguration: boolean;
+        hasProcessing: boolean;
+        hasTmux: boolean;
+        hasHelp: boolean;
+    }>;
+    /**
+     * Ensure registry is initialized
+     */
+    private ensureInitialized;
+    /**
+     * Clear the registry (useful for testing)
+     */
+    clear(): void;
+}
+declare const EventRegistry: EventRegistryClass;
+
+export { type AppConfig, BaseEnvironment, type ClaudeConfig, Config, type DockerConfig, type Environment$1 as Environment, EnvironmentRecognizer, type EventConfiguration, type EventHandler, type EventHelp, type EventMetadata, type EventProcessing, type EventProcessingContext, EventRegistry, type EventTmux, type EventValidation, type EventsConfig, type GlobalOptions, type IdeType, type Logger, type NpmConfig, type OpenOptions, Project, type ProjectConfig, type ProjectDefaults, ProjectEnvironment, TmuxManager };