@typokit/turbo 0.1.4

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { createTurboConfig, defaultPipeline } from "./pipeline.js";
+export type { TurboPipeline, TurboTaskConfig, TurboConfig, } from "./pipeline.js";
+export { runBuild, runDev, runTest, runTypokitTask } from "./scripts.js";
+export type { TaskOptions } from "./scripts.js";
+export { getSetupInstructions, getTurboJsonTemplate } from "./setup.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACnE,YAAY,EACV,aAAa,EACb,eAAe,EACf,WAAW,GACZ,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// @typokit/turbo — Turborepo Integration Helpers
+// Pipeline configuration
+export { createTurboConfig, defaultPipeline } from "./pipeline.js";
+// Helper scripts
+export { runBuild, runDev, runTest, runTypokitTask } from "./scripts.js";
+// Setup utilities
+export { getSetupInstructions, getTurboJsonTemplate } from "./setup.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,yBAAyB;AACzB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAOnE,iBAAiB;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGzE,kBAAkB;AAClB,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/pipeline.d.ts

@@ -0,0 +1,32 @@
+/** Configuration for a single Turborepo task */
+export interface TurboTaskConfig {
+    dependsOn?: string[];
+    outputs?: string[];
+    cache?: boolean;
+    persistent?: boolean;
+    env?: string[];
+    inputs?: string[];
+}
+/** Map of task names to their configuration */
+export interface TurboPipeline {
+    [taskName: string]: TurboTaskConfig;
+}
+/** Root turbo.json structure */
+export interface TurboConfig {
+    $schema?: string;
+    tasks: TurboPipeline;
+    globalDependencies?: string[];
+    globalEnv?: string[];
+}
+/** Default pipeline tasks for a TypoKit project */
+export declare const defaultPipeline: TurboPipeline;
+/**
+ * Create a turbo.json configuration object with TypoKit defaults.
+ * Merges user overrides on top of the default pipeline.
+ */
+export declare function createTurboConfig(overrides?: {
+    tasks?: TurboPipeline;
+    globalDependencies?: string[];
+    globalEnv?: string[];
+}): TurboConfig;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAEA,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAAC;CACrC;AAED,gCAAgC;AAChC,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,mDAAmD;AACnD,eAAO,MAAM,eAAe,EAAE,aAuB7B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE;IAC5C,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,GAAG,WAAW,CAuBd"}

package/dist/pipeline.js

@@ -0,0 +1,50 @@
+// @typokit/turbo — Turborepo pipeline configuration helpers
+/** Default pipeline tasks for a TypoKit project */
+export const defaultPipeline = {
+    build: {
+        dependsOn: ["^build"],
+        outputs: ["dist/**", ".typokit/**"],
+        inputs: ["src/**/*.ts", "tsconfig.json"],
+    },
+    dev: {
+        dependsOn: ["^build"],
+        cache: false,
+        persistent: true,
+    },
+    test: {
+        dependsOn: ["build"],
+        outputs: [],
+        inputs: ["src/**/*.ts", "src/**/*.test.ts"],
+    },
+    typecheck: {
+        dependsOn: ["^build"],
+        outputs: [],
+    },
+    lint: {
+        outputs: [],
+    },
+};
+/**
+ * Create a turbo.json configuration object with TypoKit defaults.
+ * Merges user overrides on top of the default pipeline.
+ */
+export function createTurboConfig(overrides) {
+    const tasks = { ...defaultPipeline };
+    if (overrides?.tasks) {
+        for (const [key, value] of Object.entries(overrides.tasks)) {
+            tasks[key] = { ...tasks[key], ...value };
+        }
+    }
+    const config = {
+        $schema: "https://turbo.build/schema.json",
+        tasks,
+    };
+    if (overrides?.globalDependencies) {
+        config.globalDependencies = overrides.globalDependencies;
+    }
+    if (overrides?.globalEnv) {
+        config.globalEnv = overrides.globalEnv;
+    }
+    return config;
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAyB5D,mDAAmD;AACnD,MAAM,CAAC,MAAM,eAAe,GAAkB;IAC5C,KAAK,EAAE;QACL,SAAS,EAAE,CAAC,QAAQ,CAAC;QACrB,OAAO,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC;QACnC,MAAM,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC;KACzC;IACD,GAAG,EAAE;QACH,SAAS,EAAE,CAAC,QAAQ,CAAC;QACrB,KAAK,EAAE,KAAK;QACZ,UAAU,EAAE,IAAI;KACjB;IACD,IAAI,EAAE;QACJ,SAAS,EAAE,CAAC,OAAO,CAAC;QACpB,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,CAAC,aAAa,EAAE,kBAAkB,CAAC;KAC5C;IACD,SAAS,EAAE;QACT,SAAS,EAAE,CAAC,QAAQ,CAAC;QACrB,OAAO,EAAE,EAAE;KACZ;IACD,IAAI,EAAE;QACJ,OAAO,EAAE,EAAE;KACZ;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAIjC;IACC,MAAM,KAAK,GAAkB,EAAE,GAAG,eAAe,EAAE,CAAC;IAEpD,IAAI,SAAS,EAAE,KAAK,EAAE,CAAC;QACrB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3D,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAgB;QAC1B,OAAO,EAAE,iCAAiC;QAC1C,KAAK;KACN,CAAC;IAEF,IAAI,SAAS,EAAE,kBAAkB,EAAE,CAAC;QAClC,MAAM,CAAC,kBAAkB,GAAG,SAAS,CAAC,kBAAkB,CAAC;IAC3D,CAAC;IAED,IAAI,SAAS,EAAE,SAAS,EAAE,CAAC;QACzB,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;IACzC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/scripts.d.ts

@@ -0,0 +1,29 @@
+/** Options for running a TypoKit task */
+export interface TaskOptions {
+    /** Working directory (defaults to process.cwd()) */
+    cwd?: string;
+    /** Additional CLI arguments */
+    args?: string[];
+    /** Environment variables to set */
+    env?: Record<string, string>;
+}
+/**
+ * Run a typokit CLI command as a child process.
+ * Designed for use in Turborepo task scripts.
+ */
+export declare function runTypokitTask(command: string, options?: TaskOptions): Promise<{
+    success: boolean;
+}>;
+/** Run `typokit build` — suitable as a Turborepo build task */
+export declare function runBuild(options?: TaskOptions): Promise<{
+    success: boolean;
+}>;
+/** Run `typokit dev` — suitable as a Turborepo dev task */
+export declare function runDev(options?: TaskOptions): Promise<{
+    success: boolean;
+}>;
+/** Run `typokit test` — suitable as a Turborepo test task */
+export declare function runTest(options?: TaskOptions): Promise<{
+    success: boolean;
+}>;
+//# sourceMappingURL=scripts.d.ts.map

package/dist/scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../src/scripts.ts"],"names":[],"mappings":"AAEA,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAkBD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAuB/B;AAED,+DAA+D;AAC/D,wBAAsB,QAAQ,CAC5B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAE/B;AAED,2DAA2D;AAC3D,wBAAsB,MAAM,CAC1B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAE/B;AAED,6DAA6D;AAC7D,wBAAsB,OAAO,CAC3B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAE/B"}

package/dist/scripts.js

@@ -0,0 +1,51 @@
+// @typokit/turbo — Helper scripts wrapping typokit CLI for Turborepo
+/** Get process.env safely (no @types/node) */
+function getProcessEnv() {
+    const g = globalThis;
+    const proc = g["process"];
+    return proc?.env ?? {};
+}
+/** Get process.cwd() safely */
+function getProcessCwd() {
+    const g = globalThis;
+    const proc = g["process"];
+    return proc?.cwd() ?? ".";
+}
+/**
+ * Run a typokit CLI command as a child process.
+ * Designed for use in Turborepo task scripts.
+ */
+export async function runTypokitTask(command, options) {
+    const cp = (await import(/* @vite-ignore */ "child_process"));
+    const cwd = options?.cwd ?? getProcessCwd();
+    const extraArgs = options?.args?.join(" ") ?? "";
+    const fullCommand = `npx typokit ${command}${extraArgs ? " " + extraArgs : ""}`;
+    try {
+        cp.execSync(fullCommand, {
+            cwd,
+            stdio: "inherit",
+            env: {
+                ...getProcessEnv(),
+                FORCE_COLOR: "true",
+                ...options?.env,
+            },
+        });
+        return { success: true };
+    }
+    catch {
+        return { success: false };
+    }
+}
+/** Run `typokit build` — suitable as a Turborepo build task */
+export async function runBuild(options) {
+    return runTypokitTask("build", options);
+}
+/** Run `typokit dev` — suitable as a Turborepo dev task */
+export async function runDev(options) {
+    return runTypokitTask("dev", options);
+}
+/** Run `typokit test` — suitable as a Turborepo test task */
+export async function runTest(options) {
+    return runTypokitTask("test", options);
+}
+//# sourceMappingURL=scripts.js.map

package/dist/scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.js","sourceRoot":"","sources":["../src/scripts.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAYrE,8CAA8C;AAC9C,SAAS,aAAa;IACpB,MAAM,CAAC,GAAG,UAAqC,CAAC;IAChD,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAEX,CAAC;IACd,OAAO,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,+BAA+B;AAC/B,SAAS,aAAa;IACpB,MAAM,CAAC,GAAG,UAAqC,CAAC;IAChD,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAAsC,CAAC;IAC/D,OAAO,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAe,EACf,OAAqB;IAErB,MAAM,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAE3D,CAAC;IAEF,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,aAAa,EAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IACjD,MAAM,WAAW,GAAG,eAAe,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAEhF,IAAI,CAAC;QACH,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE;YACvB,GAAG;YACH,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE;gBACH,GAAG,aAAa,EAAE;gBAClB,WAAW,EAAE,MAAM;gBACnB,GAAG,OAAO,EAAE,GAAG;aAChB;SACF,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAqB;IAErB,OAAO,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAqB;IAErB,OAAO,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAAqB;IAErB,OAAO,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,11 @@
+import { createTurboConfig } from "./pipeline.js";
+/**
+ * Returns a turbo.json template string ready to write to disk.
+ * Generates a complete turbo.json with TypoKit-optimized pipeline tasks.
+ */
+export declare function getTurboJsonTemplate(overrides?: Parameters<typeof createTurboConfig>[0]): string;
+/**
+ * Returns setup instructions for integrating TypoKit into a Turborepo workspace.
+ */
+export declare function getSetupInstructions(): string;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,GAClD,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CA8G7C"}

package/dist/setup.js

@@ -0,0 +1,125 @@
+// @typokit/turbo — Setup instructions and template generation
+import { createTurboConfig } from "./pipeline.js";
+/**
+ * Returns a turbo.json template string ready to write to disk.
+ * Generates a complete turbo.json with TypoKit-optimized pipeline tasks.
+ */
+export function getTurboJsonTemplate(overrides) {
+    const config = createTurboConfig(overrides);
+    return JSON.stringify(config, null, 2) + "\n";
+}
+/**
+ * Returns setup instructions for integrating TypoKit into a Turborepo workspace.
+ */
+export function getSetupInstructions() {
+    return `# Setting up TypoKit in a Turborepo workspace
+
+## 1. Install dependencies
+
+In your Turborepo root:
+
+\`\`\`bash
+npm install @typokit/turbo --save-dev
+# or
+pnpm add @typokit/turbo --save-dev -w
+\`\`\`
+
+In your TypoKit server package:
+
+\`\`\`bash
+npm install @typokit/core @typokit/types
+\`\`\`
+
+## 2. Configure turbo.json
+
+Add TypoKit-aware pipeline tasks to your \`turbo.json\`:
+
+\`\`\`json
+{
+  "$schema": "https://turbo.build/schema.json",
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": ["dist/**", ".typokit/**"],
+      "inputs": ["src/**/*.ts", "tsconfig.json"]
+    },
+    "dev": {
+      "dependsOn": ["^build"],
+      "cache": false,
+      "persistent": true
+    },
+    "test": {
+      "dependsOn": ["build"],
+      "outputs": [],
+      "inputs": ["src/**/*.ts", "src/**/*.test.ts"]
+    },
+    "typecheck": {
+      "dependsOn": ["^build"],
+      "outputs": []
+    },
+    "lint": {
+      "outputs": []
+    }
+  }
+}
+\`\`\`
+
+Key points:
+- \`build\` outputs include \`.typokit/\` (generated code directory)
+- \`dev\` is non-cacheable and persistent (watch mode)
+- \`test\` depends on \`build\` (needs generated code)
+
+## 3. Add scripts to your TypoKit package
+
+In your server package's \`package.json\`:
+
+\`\`\`json
+{
+  "scripts": {
+    "build": "typokit build",
+    "dev": "typokit dev",
+    "test": "typokit test"
+  }
+}
+\`\`\`
+
+## 4. Run with Turborepo
+
+\`\`\`bash
+# Build all packages (TypoKit packages built in dependency order)
+turbo build
+
+# Start dev mode for all packages
+turbo dev
+
+# Run tests
+turbo test
+\`\`\`
+
+## Programmatic Usage
+
+You can also use the helper scripts programmatically:
+
+\`\`\`typescript
+import { runBuild, runDev, runTest } from "@typokit/turbo";
+
+// In a custom build script
+await runBuild({ cwd: "./packages/server" });
+\`\`\`
+
+Or generate a turbo.json configuration:
+
+\`\`\`typescript
+import { createTurboConfig, getTurboJsonTemplate } from "@typokit/turbo";
+
+// Get a config object
+const config = createTurboConfig({
+  tasks: { "build": { env: ["DATABASE_URL"] } }
+});
+
+// Or get a ready-to-write JSON string
+const json = getTurboJsonTemplate();
+\`\`\`
+`;
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAAmD;IAEnD,MAAM,MAAM,GAAgB,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4GR,CAAC;AACF,CAAC"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@typokit/turbo",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "version": "0.1.4",
+  "type": "module",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KyleBastien/typokit",
+    "directory": "packages/turbo"
+  },
+  "scripts": {
+    "test": "rstest run --passWithNoTests"
+  }
+}

package/src/env.d.ts

@@ -0,0 +1,7 @@
+// Environment type declarations for @typokit/turbo (no @types/node)
+declare module "child_process" {
+  export function execSync(
+    command: string,
+    options?: Record<string, unknown>,
+  ): unknown;
+}

package/src/index.test.ts

@@ -0,0 +1,178 @@
+// @typokit/turbo — Unit tests
+import { describe, it, expect } from "@rstest/core";
+import { createTurboConfig, defaultPipeline } from "./pipeline.js";
+import type { TurboConfig, TurboTaskConfig } from "./pipeline.js";
+import { getTurboJsonTemplate, getSetupInstructions } from "./setup.js";
+
+// ---------- defaultPipeline ----------
+
+describe("defaultPipeline", () => {
+  it("defines build task with correct outputs", () => {
+    const build = defaultPipeline["build"] as TurboTaskConfig;
+    expect(build.dependsOn).toEqual(["^build"]);
+    expect(build.outputs).toContain("dist/**");
+    expect(build.outputs).toContain(".typokit/**");
+  });
+
+  it("defines dev task as non-cacheable and persistent", () => {
+    const dev = defaultPipeline["dev"] as TurboTaskConfig;
+    expect(dev.cache).toBe(false);
+    expect(dev.persistent).toBe(true);
+  });
+
+  it("defines test task depending on build", () => {
+    const test = defaultPipeline["test"] as TurboTaskConfig;
+    expect(test.dependsOn).toEqual(["build"]);
+  });
+
+  it("includes typecheck and lint tasks", () => {
+    expect(defaultPipeline["typecheck"]).toBeDefined();
+    expect(defaultPipeline["lint"]).toBeDefined();
+  });
+});
+
+// ---------- createTurboConfig ----------
+
+describe("createTurboConfig", () => {
+  it("returns config with schema and default tasks", () => {
+    const config: TurboConfig = createTurboConfig();
+    expect(config.$schema).toBe("https://turbo.build/schema.json");
+    expect(config.tasks["build"]).toBeDefined();
+    expect(config.tasks["dev"]).toBeDefined();
+    expect(config.tasks["test"]).toBeDefined();
+  });
+
+  it("merges task overrides", () => {
+    const config = createTurboConfig({
+      tasks: { build: { env: ["DATABASE_URL"] } },
+    });
+    const build = config.tasks["build"] as TurboTaskConfig;
+    expect(build.env).toEqual(["DATABASE_URL"]);
+    // Original fields preserved
+    expect(build.dependsOn).toEqual(["^build"]);
+  });
+
+  it("adds new tasks via overrides", () => {
+    const config = createTurboConfig({
+      tasks: { deploy: { dependsOn: ["build", "test"] } },
+    });
+    expect(config.tasks["deploy"]).toBeDefined();
+    expect((config.tasks["deploy"] as TurboTaskConfig).dependsOn).toEqual([
+      "build",
+      "test",
+    ]);
+  });
+
+  it("includes globalDependencies when provided", () => {
+    const config = createTurboConfig({
+      globalDependencies: [".env"],
+    });
+    expect(config.globalDependencies).toEqual([".env"]);
+  });
+
+  it("includes globalEnv when provided", () => {
+    const config = createTurboConfig({
+      globalEnv: ["NODE_ENV"],
+    });
+    expect(config.globalEnv).toEqual(["NODE_ENV"]);
+  });
+
+  it("omits globalDependencies/globalEnv when not provided", () => {
+    const config = createTurboConfig();
+    expect(config.globalDependencies).toBeUndefined();
+    expect(config.globalEnv).toBeUndefined();
+  });
+});
+
+// ---------- getTurboJsonTemplate ----------
+
+describe("getTurboJsonTemplate", () => {
+  it("returns valid JSON string", () => {
+    const template = getTurboJsonTemplate();
+    const parsed = JSON.parse(template) as TurboConfig;
+    expect(parsed.$schema).toBe("https://turbo.build/schema.json");
+    expect(parsed.tasks).toBeDefined();
+  });
+
+  it("ends with newline", () => {
+    const template = getTurboJsonTemplate();
+    expect(template.endsWith("\n")).toBe(true);
+  });
+
+  it("accepts overrides", () => {
+    const template = getTurboJsonTemplate({
+      tasks: { custom: { cache: false } },
+    });
+    const parsed = JSON.parse(template) as TurboConfig;
+    expect(parsed.tasks["custom"]).toBeDefined();
+  });
+});
+
+// ---------- getSetupInstructions ----------
+
+describe("getSetupInstructions", () => {
+  it("returns non-empty string", () => {
+    const instructions = getSetupInstructions();
+    expect(instructions.length).toBeGreaterThan(0);
+  });
+
+  it("includes key setup steps", () => {
+    const instructions = getSetupInstructions();
+    expect(instructions).toContain("turbo.json");
+    expect(instructions).toContain("typokit build");
+    expect(instructions).toContain("@typokit/turbo");
+  });
+
+  it("mentions .typokit/ output directory", () => {
+    const instructions = getSetupInstructions();
+    expect(instructions).toContain(".typokit/");
+  });
+});
+
+// ---------- Helper script exports ----------
+
+describe("@typokit/turbo script exports", () => {
+  it("exports runBuild function", async () => {
+    const mod = await import("./scripts.js");
+    expect(typeof mod.runBuild).toBe("function");
+  });
+
+  it("exports runDev function", async () => {
+    const mod = await import("./scripts.js");
+    expect(typeof mod.runDev).toBe("function");
+  });
+
+  it("exports runTest function", async () => {
+    const mod = await import("./scripts.js");
+    expect(typeof mod.runTest).toBe("function");
+  });
+
+  it("exports runTypokitTask function", async () => {
+    const mod = await import("./scripts.js");
+    expect(typeof mod.runTypokitTask).toBe("function");
+  });
+});
+
+// ---------- Main index exports ----------
+
+describe("@typokit/turbo exports", () => {
+  it("exports pipeline configuration", async () => {
+    const mod = await import("./index.js");
+    expect(typeof mod.createTurboConfig).toBe("function");
+    expect(mod.defaultPipeline).toBeDefined();
+  });
+
+  it("exports helper scripts", async () => {
+    const mod = await import("./index.js");
+    expect(typeof mod.runBuild).toBe("function");
+    expect(typeof mod.runDev).toBe("function");
+    expect(typeof mod.runTest).toBe("function");
+    expect(typeof mod.runTypokitTask).toBe("function");
+  });
+
+  it("exports setup utilities", async () => {
+    const mod = await import("./index.js");
+    expect(typeof mod.getTurboJsonTemplate).toBe("function");
+    expect(typeof mod.getSetupInstructions).toBe("function");
+  });
+});

package/src/index.ts

@@ -0,0 +1,16 @@
+// @typokit/turbo — Turborepo Integration Helpers
+
+// Pipeline configuration
+export { createTurboConfig, defaultPipeline } from "./pipeline.js";
+export type {
+  TurboPipeline,
+  TurboTaskConfig,
+  TurboConfig,
+} from "./pipeline.js";
+
+// Helper scripts
+export { runBuild, runDev, runTest, runTypokitTask } from "./scripts.js";
+export type { TaskOptions } from "./scripts.js";
+
+// Setup utilities
+export { getSetupInstructions, getTurboJsonTemplate } from "./setup.js";

package/src/pipeline.ts

@@ -0,0 +1,83 @@
+// @typokit/turbo — Turborepo pipeline configuration helpers
+
+/** Configuration for a single Turborepo task */
+export interface TurboTaskConfig {
+  dependsOn?: string[];
+  outputs?: string[];
+  cache?: boolean;
+  persistent?: boolean;
+  env?: string[];
+  inputs?: string[];
+}
+
+/** Map of task names to their configuration */
+export interface TurboPipeline {
+  [taskName: string]: TurboTaskConfig;
+}
+
+/** Root turbo.json structure */
+export interface TurboConfig {
+  $schema?: string;
+  tasks: TurboPipeline;
+  globalDependencies?: string[];
+  globalEnv?: string[];
+}
+
+/** Default pipeline tasks for a TypoKit project */
+export const defaultPipeline: TurboPipeline = {
+  build: {
+    dependsOn: ["^build"],
+    outputs: ["dist/**", ".typokit/**"],
+    inputs: ["src/**/*.ts", "tsconfig.json"],
+  },
+  dev: {
+    dependsOn: ["^build"],
+    cache: false,
+    persistent: true,
+  },
+  test: {
+    dependsOn: ["build"],
+    outputs: [],
+    inputs: ["src/**/*.ts", "src/**/*.test.ts"],
+  },
+  typecheck: {
+    dependsOn: ["^build"],
+    outputs: [],
+  },
+  lint: {
+    outputs: [],
+  },
+};
+
+/**
+ * Create a turbo.json configuration object with TypoKit defaults.
+ * Merges user overrides on top of the default pipeline.
+ */
+export function createTurboConfig(overrides?: {
+  tasks?: TurboPipeline;
+  globalDependencies?: string[];
+  globalEnv?: string[];
+}): TurboConfig {
+  const tasks: TurboPipeline = { ...defaultPipeline };
+
+  if (overrides?.tasks) {
+    for (const [key, value] of Object.entries(overrides.tasks)) {
+      tasks[key] = { ...tasks[key], ...value };
+    }
+  }
+
+  const config: TurboConfig = {
+    $schema: "https://turbo.build/schema.json",
+    tasks,
+  };
+
+  if (overrides?.globalDependencies) {
+    config.globalDependencies = overrides.globalDependencies;
+  }
+
+  if (overrides?.globalEnv) {
+    config.globalEnv = overrides.globalEnv;
+  }
+
+  return config;
+}

package/src/scripts.ts

@@ -0,0 +1,80 @@
+// @typokit/turbo — Helper scripts wrapping typokit CLI for Turborepo
+
+/** Options for running a TypoKit task */
+export interface TaskOptions {
+  /** Working directory (defaults to process.cwd()) */
+  cwd?: string;
+  /** Additional CLI arguments */
+  args?: string[];
+  /** Environment variables to set */
+  env?: Record<string, string>;
+}
+
+/** Get process.env safely (no @types/node) */
+function getProcessEnv(): Record<string, string | undefined> {
+  const g = globalThis as Record<string, unknown>;
+  const proc = g["process"] as
+    | { env: Record<string, string | undefined> }
+    | undefined;
+  return proc?.env ?? {};
+}
+
+/** Get process.cwd() safely */
+function getProcessCwd(): string {
+  const g = globalThis as Record<string, unknown>;
+  const proc = g["process"] as { cwd: () => string } | undefined;
+  return proc?.cwd() ?? ".";
+}
+
+/**
+ * Run a typokit CLI command as a child process.
+ * Designed for use in Turborepo task scripts.
+ */
+export async function runTypokitTask(
+  command: string,
+  options?: TaskOptions,
+): Promise<{ success: boolean }> {
+  const cp = (await import(/* @vite-ignore */ "child_process")) as {
+    execSync: (cmd: string, opts: Record<string, unknown>) => unknown;
+  };
+
+  const cwd = options?.cwd ?? getProcessCwd();
+  const extraArgs = options?.args?.join(" ") ?? "";
+  const fullCommand = `npx typokit ${command}${extraArgs ? " " + extraArgs : ""}`;
+
+  try {
+    cp.execSync(fullCommand, {
+      cwd,
+      stdio: "inherit",
+      env: {
+        ...getProcessEnv(),
+        FORCE_COLOR: "true",
+        ...options?.env,
+      },
+    });
+    return { success: true };
+  } catch {
+    return { success: false };
+  }
+}
+
+/** Run `typokit build` — suitable as a Turborepo build task */
+export async function runBuild(
+  options?: TaskOptions,
+): Promise<{ success: boolean }> {
+  return runTypokitTask("build", options);
+}
+
+/** Run `typokit dev` — suitable as a Turborepo dev task */
+export async function runDev(
+  options?: TaskOptions,
+): Promise<{ success: boolean }> {
+  return runTypokitTask("dev", options);
+}
+
+/** Run `typokit test` — suitable as a Turborepo test task */
+export async function runTest(
+  options?: TaskOptions,
+): Promise<{ success: boolean }> {
+  return runTypokitTask("test", options);
+}

package/src/setup.ts

@@ -0,0 +1,130 @@
+// @typokit/turbo — Setup instructions and template generation
+
+import { createTurboConfig } from "./pipeline.js";
+import type { TurboConfig } from "./pipeline.js";
+
+/**
+ * Returns a turbo.json template string ready to write to disk.
+ * Generates a complete turbo.json with TypoKit-optimized pipeline tasks.
+ */
+export function getTurboJsonTemplate(
+  overrides?: Parameters<typeof createTurboConfig>[0],
+): string {
+  const config: TurboConfig = createTurboConfig(overrides);
+  return JSON.stringify(config, null, 2) + "\n";
+}
+
+/**
+ * Returns setup instructions for integrating TypoKit into a Turborepo workspace.
+ */
+export function getSetupInstructions(): string {
+  return `# Setting up TypoKit in a Turborepo workspace
+
+## 1. Install dependencies
+
+In your Turborepo root:
+
+\`\`\`bash
+npm install @typokit/turbo --save-dev
+# or
+pnpm add @typokit/turbo --save-dev -w
+\`\`\`
+
+In your TypoKit server package:
+
+\`\`\`bash
+npm install @typokit/core @typokit/types
+\`\`\`
+
+## 2. Configure turbo.json
+
+Add TypoKit-aware pipeline tasks to your \`turbo.json\`:
+
+\`\`\`json
+{
+  "$schema": "https://turbo.build/schema.json",
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": ["dist/**", ".typokit/**"],
+      "inputs": ["src/**/*.ts", "tsconfig.json"]
+    },
+    "dev": {
+      "dependsOn": ["^build"],
+      "cache": false,
+      "persistent": true
+    },
+    "test": {
+      "dependsOn": ["build"],
+      "outputs": [],
+      "inputs": ["src/**/*.ts", "src/**/*.test.ts"]
+    },
+    "typecheck": {
+      "dependsOn": ["^build"],
+      "outputs": []
+    },
+    "lint": {
+      "outputs": []
+    }
+  }
+}
+\`\`\`
+
+Key points:
+- \`build\` outputs include \`.typokit/\` (generated code directory)
+- \`dev\` is non-cacheable and persistent (watch mode)
+- \`test\` depends on \`build\` (needs generated code)
+
+## 3. Add scripts to your TypoKit package
+
+In your server package's \`package.json\`:
+
+\`\`\`json
+{
+  "scripts": {
+    "build": "typokit build",
+    "dev": "typokit dev",
+    "test": "typokit test"
+  }
+}
+\`\`\`
+
+## 4. Run with Turborepo
+
+\`\`\`bash
+# Build all packages (TypoKit packages built in dependency order)
+turbo build
+
+# Start dev mode for all packages
+turbo dev
+
+# Run tests
+turbo test
+\`\`\`
+
+## Programmatic Usage
+
+You can also use the helper scripts programmatically:
+
+\`\`\`typescript
+import { runBuild, runDev, runTest } from "@typokit/turbo";
+
+// In a custom build script
+await runBuild({ cwd: "./packages/server" });
+\`\`\`
+
+Or generate a turbo.json configuration:
+
+\`\`\`typescript
+import { createTurboConfig, getTurboJsonTemplate } from "@typokit/turbo";
+
+// Get a config object
+const config = createTurboConfig({
+  tasks: { "build": { env: ["DATABASE_URL"] } }
+});
+
+// Or get a ready-to-write JSON string
+const json = getTurboJsonTemplate();
+\`\`\`
+`;
+}