@typokit/cli 0.1.4

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+// @typokit/cli — CLI binary entry point
+import { run } from "./index.js";
+const g = globalThis;
+const proc = g["process"];
+run(proc.argv).then((code) => proc.exit(code), (err) => {
+    const stderr = proc["stderr"];
+    if (stderr?.write) {
+        stderr.write(`[error] ${err instanceof Error ? err.message : String(err)}\n`);
+    }
+    proc.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,wCAAwC;AAExC,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEjC,MAAM,CAAC,GAAG,UAAqC,CAAC;AAChD,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAAiD,CAAC;AAE1E,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CACjB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EACzB,CAAC,GAAG,EAAE,EAAE;IACN,MAAM,MAAM,GACV,IACD,CAAC,QAAQ,CAAC,CAAC;IACZ,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;QAClB,MAAM,CAAC,KAAK,CACV,WAAW,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAChE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACf,CAAC,CACF,CAAC"}

package/dist/commands/build.d.ts

@@ -0,0 +1,42 @@
+import type { CliLogger } from "../logger.js";
+import type { TypoKitConfig } from "../config.js";
+import type { BuildResult } from "@typokit/types";
+import type { TypoKitPlugin, BuildPipelineInstance } from "@typokit/core";
+export interface BuildCommandOptions {
+    /** Project root directory */
+    rootDir: string;
+    /** Resolved configuration */
+    config: Required<TypoKitConfig>;
+    /** Logger instance */
+    logger: CliLogger;
+    /** Whether verbose mode is enabled */
+    verbose: boolean;
+    /** Plugins to register with the build pipeline */
+    plugins?: TypoKitPlugin[];
+}
+/** Structured build error with source context */
+export interface BuildError {
+    source: string;
+    phase: "transform" | "compile";
+    message: string;
+    file?: string;
+    line?: number;
+    errorType?: string;
+}
+/**
+ * Execute the build command.
+ *
+ * 1. Resolve type and route files from config patterns
+ * 2. Create build pipeline and let plugins register taps via onBuild()
+ * 3. Fire beforeTransform hook
+ * 4. Run the Rust native transform pipeline (buildPipeline)
+ * 5. Fire afterTypeParse, afterValidators, afterRouteTable hooks
+ * 6. Fire emit hook (plugins can add outputs)
+ * 7. Run the TypeScript compiler
+ * 8. Fire done hook
+ * 9. Return structured BuildResult
+ */
+export declare function executeBuild(options: BuildCommandOptions): Promise<BuildResult & {
+    pipeline?: BuildPipelineInstance;
+}>;
+//# sourceMappingURL=build.d.ts.map

package/dist/commands/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EACV,WAAW,EAGZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IAChC,sBAAsB;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,iDAAiD;AACjD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA+ND;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,WAAW,GAAG;IAAE,QAAQ,CAAC,EAAE,qBAAqB,CAAA;CAAE,CAAC,CAkK7D"}

package/dist/commands/build.js

@@ -0,0 +1,302 @@
+// @typokit/cli — Build Command
+/**
+ * Resolve glob patterns to actual file paths.
+ */
+async function resolveFilePatterns(rootDir, patterns) {
+    const { join, resolve } = (await import(/* @vite-ignore */ "path"));
+    const { readdirSync, statSync, existsSync } = (await import(
+    /* @vite-ignore */ "fs"));
+    const files = [];
+    for (const pattern of patterns) {
+        if (pattern.includes("*")) {
+            // Simple glob matching: support **/*.ext and **/name.ts patterns
+            const parts = pattern.split("/");
+            const hasDoubleGlob = parts.includes("**");
+            const lastPart = parts[parts.length - 1];
+            // Determine the base directory (everything before the first glob)
+            const baseParts = [];
+            for (const part of parts) {
+                if (part.includes("*"))
+                    break;
+                baseParts.push(part);
+            }
+            const baseDir = baseParts.length > 0 ? join(rootDir, ...baseParts) : rootDir;
+            if (!existsSync(baseDir))
+                continue;
+            // List files recursively if **
+            const entries = hasDoubleGlob
+                ? listFilesRecursive(baseDir, existsSync, readdirSync, statSync, join)
+                : readdirSync(baseDir).map((f) => join(baseDir, f));
+            // Match against the filename pattern
+            const filePattern = lastPart.replace(/\*/g, ".*");
+            const regex = new RegExp(`^${filePattern}$`);
+            for (const entry of entries) {
+                const name = entry.split(/[\\/]/).pop() ?? "";
+                if (regex.test(name)) {
+                    files.push(resolve(entry));
+                }
+            }
+        }
+        else {
+            // Direct path
+            const fullPath = resolve(join(rootDir, pattern));
+            if (existsSync(fullPath)) {
+                files.push(fullPath);
+            }
+        }
+    }
+    return [...new Set(files)].sort();
+}
+function listFilesRecursive(dir, existsSync, readdirSync, statSync, join) {
+    if (!existsSync(dir))
+        return [];
+    const results = [];
+    const entries = readdirSync(dir);
+    for (const entry of entries) {
+        const fullPath = join(dir, entry);
+        try {
+            const stat = statSync(fullPath);
+            if (stat.isDirectory()) {
+                if (entry !== "node_modules" &&
+                    entry !== "dist" &&
+                    entry !== ".typokit") {
+                    results.push(...listFilesRecursive(fullPath, existsSync, readdirSync, statSync, join));
+                }
+            }
+            else if (stat.isFile()) {
+                results.push(fullPath);
+            }
+        }
+        catch {
+            // Skip files that can't be stat'd
+        }
+    }
+    return results;
+}
+/**
+ * Parse TypeScript compiler errors into structured BuildError objects.
+ */
+function parseCompilerErrors(stderr) {
+    const errors = [];
+    const lines = stderr.split("\n");
+    for (const line of lines) {
+        // Match tsc error format: file(line,col): error TSxxxx: message
+        const match = line.match(/^(.+?)\((\d+),\d+\):\s*error\s+(TS\d+):\s*(.+)/);
+        if (match) {
+            errors.push({
+                source: "tsc",
+                phase: "compile",
+                message: match[4],
+                file: match[1],
+                line: parseInt(match[2], 10),
+                errorType: match[3],
+            });
+        }
+    }
+    // If no structured errors found but there's stderr content, add a generic error
+    if (errors.length === 0 && stderr.trim()) {
+        errors.push({
+            source: "compiler",
+            phase: "compile",
+            message: stderr.trim().split("\n")[0],
+        });
+    }
+    return errors;
+}
+/**
+ * Run the TypeScript compiler step.
+ */
+async function runCompiler(options) {
+    const { spawnSync } = (await import(/* @vite-ignore */ "child_process"));
+    const { config, rootDir, logger } = options;
+    const compiler = config.compiler;
+    const args = [...config.compilerArgs];
+    let command;
+    switch (compiler) {
+        case "tsc":
+            command = "tsc";
+            if (args.length === 0) {
+                args.push("-p", "tsconfig.json");
+            }
+            break;
+        case "tsup":
+            command = "tsup";
+            break;
+        case "swc":
+            command = "swc";
+            if (args.length === 0) {
+                args.push("src", "-d", config.distDir);
+            }
+            break;
+        default:
+            command = "tsc";
+            args.push("-p", "tsconfig.json");
+    }
+    logger.step("compile", `Running ${compiler}: ${command} ${args.join(" ")}`);
+    const result = spawnSync(command, args, {
+        cwd: rootDir,
+        encoding: "utf-8",
+    });
+    if (result.error) {
+        return {
+            success: false,
+            errors: [
+                {
+                    source: compiler,
+                    phase: "compile",
+                    message: result.error.message,
+                    errorType: "SPAWN_ERROR",
+                },
+            ],
+        };
+    }
+    if (result.status !== 0) {
+        const errors = parseCompilerErrors(result.stderr || result.stdout);
+        return { success: false, errors };
+    }
+    if (options.verbose && result.stdout) {
+        logger.verbose(result.stdout.trim());
+    }
+    return { success: true, errors: [] };
+}
+/**
+ * Execute the build command.
+ *
+ * 1. Resolve type and route files from config patterns
+ * 2. Create build pipeline and let plugins register taps via onBuild()
+ * 3. Fire beforeTransform hook
+ * 4. Run the Rust native transform pipeline (buildPipeline)
+ * 5. Fire afterTypeParse, afterValidators, afterRouteTable hooks
+ * 6. Fire emit hook (plugins can add outputs)
+ * 7. Run the TypeScript compiler
+ * 8. Fire done hook
+ * 9. Return structured BuildResult
+ */
+export async function executeBuild(options) {
+    const { createBuildPipeline } = (await import(
+    /* @vite-ignore */ "@typokit/core"));
+    const startTime = Date.now();
+    const { config, rootDir, logger, verbose, plugins = [] } = options;
+    const errors = [];
+    const outputs = [];
+    // Create build pipeline and let plugins register their taps
+    const pipeline = createBuildPipeline();
+    for (const plugin of plugins) {
+        if (plugin.onBuild) {
+            plugin.onBuild(pipeline);
+            if (verbose) {
+                logger.verbose(`Plugin "${plugin.name}" registered build hooks`);
+            }
+        }
+    }
+    const buildCtx = {
+        rootDir,
+        outDir: config.outputDir,
+        dev: false,
+        outputs,
+    };
+    // Step 1: Resolve file patterns
+    logger.step("build", "Resolving source files...");
+    const typeFiles = await resolveFilePatterns(rootDir, config.typeFiles);
+    const routeFiles = await resolveFilePatterns(rootDir, config.routeFiles);
+    if (verbose) {
+        logger.verbose(`Type files: ${typeFiles.length} found`);
+        for (const f of typeFiles)
+            logger.verbose(`  ${f}`);
+        logger.verbose(`Route files: ${routeFiles.length} found`);
+        for (const f of routeFiles)
+            logger.verbose(`  ${f}`);
+    }
+    // Step 2: Fire beforeTransform hook
+    await pipeline.hooks.beforeTransform.call(buildCtx);
+    // Step 3: Run native transform pipeline
+    if (typeFiles.length > 0 || routeFiles.length > 0) {
+        logger.step("transform", "Running native transform pipeline...");
+        try {
+            const { buildPipeline: nativeBuildPipeline } = (await import(
+            /* @vite-ignore */ "@typokit/transform-native"));
+            const result = await nativeBuildPipeline({
+                typeFiles,
+                routeFiles,
+                outputDir: config.outputDir,
+            });
+            if (result.regenerated) {
+                logger.success(`Transform complete — ${result.filesWritten.length} files written`);
+                for (const f of result.filesWritten) {
+                    outputs.push({ filePath: f, content: "", overwrite: true });
+                }
+            }
+            else {
+                logger.success("Transform skipped — cache hit");
+            }
+            if (verbose) {
+                logger.verbose(`Content hash: ${result.contentHash}`);
+                for (const f of result.filesWritten)
+                    logger.verbose(`  wrote: ${f}`);
+            }
+            // Fire afterTypeParse hook (types extracted during transform)
+            await pipeline.hooks.afterTypeParse.call({}, buildCtx);
+            // Fire afterValidators hook
+            await pipeline.hooks.afterValidators.call(outputs, buildCtx);
+            // Fire afterRouteTable hook
+            await pipeline.hooks.afterRouteTable.call({
+                segment: "",
+                children: {},
+                handlers: {},
+            }, buildCtx);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            logger.error(`Transform failed: ${message}`);
+            errors.push(`Transform error: ${message}`);
+            return {
+                success: false,
+                outputs,
+                duration: Date.now() - startTime,
+                errors,
+            };
+        }
+    }
+    else {
+        logger.info("No type or route files found — skipping transform");
+    }
+    // Step 4: Fire emit hook — plugins can add their own outputs
+    await pipeline.hooks.emit.call(outputs, buildCtx);
+    // Step 5: Run TypeScript compiler
+    logger.step("compile", "Compiling TypeScript...");
+    const compileResult = await runCompiler(options);
+    if (!compileResult.success) {
+        for (const buildErr of compileResult.errors) {
+            const parts = [buildErr.message];
+            if (buildErr.file)
+                parts.unshift(`${buildErr.file}:${buildErr.line ?? 0}`);
+            if (buildErr.errorType)
+                parts.push(`(${buildErr.errorType})`);
+            const formatted = parts.join(" — ");
+            logger.error(formatted);
+            errors.push(formatted);
+        }
+        return {
+            success: false,
+            outputs,
+            duration: Date.now() - startTime,
+            errors,
+        };
+    }
+    logger.success("Compilation complete");
+    const duration = Date.now() - startTime;
+    logger.success(`Build finished in ${duration}ms`);
+    const buildResult = {
+        success: true,
+        outputs,
+        duration,
+        errors: [],
+    };
+    // Step 6: Fire done hook
+    await pipeline.hooks.done.call(buildResult);
+    return {
+        ...buildResult,
+        pipeline,
+    };
+}
+//# sourceMappingURL=build.js.map

package/dist/commands/build.js.map

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

package/dist/commands/dev.d.ts

@@ -0,0 +1,106 @@
+import type { CliLogger } from "../logger.js";
+import type { TypoKitConfig } from "../config.js";
+export interface DevCommandOptions {
+    /** Project root directory */
+    rootDir: string;
+    /** Resolved configuration */
+    config: Required<TypoKitConfig>;
+    /** Logger instance */
+    logger: CliLogger;
+    /** Whether verbose mode is enabled */
+    verbose: boolean;
+    /** Debug sidecar port (default: 9800) */
+    debugPort: number;
+}
+/** Tracked file with mtime for change detection */
+interface TrackedFile {
+    path: string;
+    mtime: number;
+}
+/** Dependency graph entry: maps a file to the outputs it affects */
+interface DepGraphEntry {
+    /** Files that depend on this source file */
+    affectedOutputs: string[];
+    /** Category: "type" or "route" */
+    category: "type" | "route";
+}
+/** In-memory AST cache entry */
+interface CacheEntry {
+    mtime: number;
+    hash: string;
+}
+/** Dev server state */
+export interface DevServerState {
+    /** Whether the server is running */
+    running: boolean;
+    /** File watcher cleanup function */
+    stopWatcher: (() => void) | null;
+    /** Tracked files with mtimes */
+    trackedFiles: Map<string, TrackedFile>;
+    /** Dependency graph: source → affected outputs */
+    depGraph: Map<string, DepGraphEntry>;
+    /** AST cache: file path → cache entry */
+    astCache: Map<string, CacheEntry>;
+    /** Rebuild count */
+    rebuildCount: number;
+    /** Last rebuild duration in ms */
+    lastRebuildMs: number;
+    /** Server child process PID */
+    serverPid: number | null;
+}
+/**
+ * Create initial dev server state.
+ */
+export declare function createDevState(): DevServerState;
+/**
+ * Detect which files have changed since last check.
+ */
+export declare function detectChangedFiles(state: DevServerState, currentFiles: TrackedFile[]): {
+    changed: TrackedFile[];
+    added: TrackedFile[];
+    removed: string[];
+};
+/**
+ * Update the tracked files in state.
+ */
+export declare function updateTrackedFiles(state: DevServerState, files: TrackedFile[]): void;
+/**
+ * Build the dependency graph from type and route files.
+ * Maps each source file to the outputs it affects.
+ */
+export declare function buildDepGraph(typeFiles: string[], routeFiles: string[]): Map<string, DepGraphEntry>;
+/**
+ * Determine which outputs need regeneration based on changed files.
+ */
+export declare function getAffectedOutputs(depGraph: Map<string, DepGraphEntry>, changedFiles: string[]): Set<string>;
+/**
+ * Check if a file's AST cache is still valid.
+ */
+export declare function isCacheValid(cache: Map<string, CacheEntry>, filePath: string, currentMtime: number): boolean;
+/**
+ * Update the AST cache for a file.
+ */
+export declare function updateCache(cache: Map<string, CacheEntry>, filePath: string, mtime: number): void;
+/**
+ * Run an incremental rebuild for changed files only.
+ * Returns the files that were actually re-processed.
+ */
+export declare function incrementalRebuild(options: DevCommandOptions, state: DevServerState, changedPaths: string[]): Promise<{
+    success: boolean;
+    duration: number;
+    filesProcessed: number;
+}>;
+/**
+ * Execute the dev command.
+ *
+ * 1. Run initial full build
+ * 2. Start file watcher for incremental rebuilds
+ * 3. Start the development server (delegates to server adapter)
+ * 4. Handle graceful shutdown
+ */
+export declare function executeDev(options: DevCommandOptions): Promise<{
+    state: DevServerState;
+    stop: () => void;
+}>;
+export {};
+//# sourceMappingURL=dev.d.ts.map

package/dist/commands/dev.d.ts.map

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