chore: init

Author: zrosenbauer

assets/logo-icon.txt

@@ -1,17 +1,23 @@
-⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⣤⣤⣶⣶⣶⣶⣶⣶⣤⣤⣀⡀
-⠀⠀⠀⠀⠀⠀⠀⣀⣴⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⣦⣀
-⠀⠀⠀⠀⠀⢀⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⡀
-⠀⠀⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿
-⠀⠀⠀⢀⣸⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠟⠻⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣇⡀
-⠀⠀⢠⣿⣿⣿⣿⣿⣿⠏⠉⠙⠛⠛⠋⠁⠀⠀⠈⠙⠛⠛⠋⠉⠹⣿⣿⣿⣿⣿⣿⡄
-⠀⠀⢸⣿⣿⣿⣿⣿⠏⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣀⣼⣿⣿⣿⣿⣿⡇
-⠀⣠⣾⣿⣿⡏⠁⢀⡴⠶⠟⢛⣛⣛⣛⠛⠶⢦⣄⠀⠀⣀⣤⠾⠋⠀⠈⢹⣿⣿⣷⣄
-⢰⣿⣿⣿⣿⣿⠀⣿⢰⣿⣿⣿⠟⠻⣿⣿⣿⣦⢹⡿⠿⠛⠉⠀⠀⠀⠀⣿⣿⣿⣿⣿⡆
-⠈⢿⣿⣿⣿⡟⠀⢻⡘⣿⣿⣿⡄⠘⢿⣿⣿⠇⡾⠁⠀⠀⠀⠀⠀⠀⠀⢻⣿⣿⣿⡿⠁
-⠀⢀⣿⣿⣯⡀⠀⠈⢳⡙⣿⣿⣭⢠⣾⣿⠏⡼⠁⠀⠀⠀⠀⠀⠀⠀⠀⢀⣽⣿⣿⡀
-⢠⣿⣿⣿⣿⣿⡄⠀⠀⠙⣮⣙⠛⠟⣛⣥⠞⠀⠀⠀⠀⠀⠀⠀⠀⠀⢠⣿⣿⣿⣿⣿⡄
-⠘⣿⣿⣿⣿⣿⠃⠀⠀⠀⠀⠉⠛⠛⠋⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⣿⣿⣿⣿⣿⠃
-⠀⠈⣿⣿⣟⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⣻⣿⣿⠁
-⢀⣾⣿⣿⣿⣷⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣾⣿⣿⣿⣷⡀
-⠸⣿⣿⣿⣿⣿⠇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠸⣿⣿⣿⣿⣿⠇
-⠀⠙⠻⠿⠟⠋⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠙⠻⠿⠟⠋
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣀⣀⣤⣤⣤⣤⣴⣶⣶⣤⣤⣤⣤⣄⣀⡀
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣀⣤⣶⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣶⣤⣀
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣴⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣦⣄
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣴⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⡀
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡄
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣤⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠏⠀⠈⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣦⣄
+⠀⠀⠀⠀⠀⠀⠀⠀⢠⣿⣿⣿⣿⣿⣿⣿⣿⣿⠃⠀⠉⠙⠛⠛⠛⠛⠋⠀⠀⠀⠀⠀⠉⠛⠛⠛⠛⠛⠉⠁⠈⣿⣿⣿⣿⣿⣿⣿⣿⣿⣧
+⠀⠀⠀⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣿⡟⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢠⡿⠁⠀⠀⠸⣿⣿⣿⣿⣿⣿⣿⣿⣿
+⠀⠀⠀⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⠿⠿⠟⠋⣀⣤⣴⠶⠶⠶⠶⠶⠶⣤⣤⣀⠀⠀⠀⠀⠀⢀⣴⡟⠁⠀⠀⠀⠀⠈⠛⠿⠿⢿⣿⣿⣿⣿
+⠀⠀⠀⠀⠀⠀⣠⣶⣿⣿⣿⣿⣇⠀⠀⠀⣾⢫⣴⣶⣶⣿⡿⣿⣿⣶⣶⣬⠹⣷⣴⣶⠶⠿⠛⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣿⣿⣿⣿⣷⣦⡀
+⠀⠀⠀⠀⠀⣸⣿⣿⣿⣿⣿⣿⣿⡇⠀⠀⣿⠸⣿⣿⣿⡏⠀⢤⣿⣿⣿⣿⢡⡿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣿⣿⣿⣿⣿⣿⣿⣷
+⠀⠀⠀⠀⠀⢹⣿⣿⣿⣿⣿⣿⣿⡇⠀⠀⠸⣧⠻⣿⣿⡿⠆⠀⣹⣿⣿⢃⡾⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⣿⣿⣿⣿⣿⣿⣿⣿
+⠀⠀⠀⠀⠀⠀⠻⣿⣿⣿⣿⣿⠟⠀⠀⠀⠀⠘⢷⣝⠿⣿⣧⣾⣿⠟⣡⡞⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠙⢿⣿⣿⣿⣿⠟⠁
+⠀⠀⠀⠀⠀⠀⠀⣸⣿⣿⣿⣇⠀⠀⠀⠀⠀⠀⠀⠙⠳⢦⣬⣥⡶⠟⠉⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣀⣿⣿⣿⣯⡀
+⠀⠀⠀⠀⠀⢀⣾⣿⣿⣿⣿⣿⣷⡄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣼⣿⣿⣿⣿⣿⣿⣆
+⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣿
+⠀⠀⠀⠀⠀⠘⣿⣿⣿⣿⣿⣿⣿⠏⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⢿⣿⣿⣿⣿⣿⣿⠏
+⠀⠀⠀⠀⠀⠀⠈⢻⣿⣿⣿⡟⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠹⣿⣿⣿⣿⠁
+⠀⠀⠀⠀⠀⠀⣴⣿⣿⣿⣿⣷⣤⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣠⣾⣿⣿⣿⣿⣦⡀
+⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣷⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢰⣿⣿⣿⣿⣿⣿⣿⣷
+⠀⠀⠀⠀⠀⠸⣿⣿⣿⣿⣿⣿⣿⡟⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠸⣿⣿⣿⣿⣿⣿⣿⡟
+⠀⠀⠀⠀⠀⠀⠙⠿⣿⣿⣿⡿⠟⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠙⠿⣿⣿⣿⡿⠟

contributing/concepts/architecture.md

@@ -96,13 +96,13 @@ The CLI binary entrypoint. Calls `cli()` from `kidd` with the CLI name, version,
 
 The framework primitives:
 
-| Module          | Purpose                                                    |
-| --------------- | ---------------------------------------------------------- |
-| `cli.ts`        | Entry function that wires yargs, config, and context       |
-| `command.ts`    | Factory for creating typed commands                        |
-| `middleware.ts` | Factory and pipeline runner for middleware composition     |
-| `autoloader.ts` | Auto-discovery and dynamic import of command files         |
-| `context/`      | Context creation, types, and error handling                |
+| Module          | Purpose                                                |
+| --------------- | ------------------------------------------------------ |
+| `cli.ts`        | Entry function that wires yargs, config, and context   |
+| `command.ts`    | Factory for creating typed commands                    |
+| `middleware.ts` | Factory and pipeline runner for middleware composition |
+| `autoloader.ts` | Auto-discovery and dynamic import of command files     |
+| `context/`      | Context creation, types, and error handling            |
 
 ### Lib Layer
 
@@ -295,10 +295,10 @@ Config is validated against a Zod schema and errors are returned as discriminate
 
 kidd uses two error strategies depending on the layer:
 
-| Layer        | Strategy                            | Type                                       |
-| ------------ | ----------------------------------- | ------------------------------------------ |
-| Lib/internal | `Result<T, E>` tuples               | `[error, null]` or `[null, value]`         |
-| Context/CLI  | `ContextError` (thrown at boundary) | `{ code, exitCode }`                       |
+| Layer        | Strategy                            | Type                               |
+| ------------ | ----------------------------------- | ---------------------------------- |
+| Lib/internal | `Result<T, E>` tuples               | `[error, null]` or `[null, value]` |
+| Context/CLI  | `ContextError` (thrown at boundary) | `{ code, exitCode }`               |
 
 **Result tuples** are used for expected failures (config parsing, validation, file I/O). Chain with early returns:
 

examples/simple/package.json

@@ -2,6 +2,7 @@
   "name": "@examples/simple",
   "version": "0.0.0",
   "private": true,
+  "type": "module",
   "scripts": {
     "dev": "kidd dev",
     "build": "kidd build",
@@ -18,6 +19,5 @@
     "tsdown": "catalog:",
     "tsx": "catalog:",
     "typescript": "catalog:"
-  },
-  "type": "module"
+  }
 }

packages/bundler/src/compile.test.ts

@@ -167,15 +167,17 @@ describe('compile operation', () => {
     )
 
     const [, output] = await compile({
-      config: { compile: { name: 'my-app', targets: ['darwin-arm64', 'linux-x64', 'windows-x64'] } },
+      config: {
+        compile: { name: 'my-app', targets: ['darwin-arm64', 'linux-x64', 'windows-x64'] },
+      },
       cwd: '/project',
     })
 
     expect(output).toMatchObject({
       binaries: expect.arrayContaining([
-        expect.objectContaining({ target: 'darwin-arm64', label: 'macOS Apple Silicon' }),
-        expect.objectContaining({ target: 'linux-x64', label: 'Linux x64' }),
-        expect.objectContaining({ target: 'windows-x64', label: 'Windows x64' }),
+        expect.objectContaining({ label: 'macOS Apple Silicon', target: 'darwin-arm64' }),
+        expect.objectContaining({ label: 'Linux x64', target: 'linux-x64' }),
+        expect.objectContaining({ label: 'Windows x64', target: 'windows-x64' }),
       ]),
     })
   })
@@ -195,8 +197,12 @@ describe('compile operation', () => {
     await compile({
       config: { compile: { name: 'my-app', targets: ['darwin-arm64', 'linux-x64'] } },
       cwd: '/project',
-      onTargetStart: (target) => { started.push(target) },
-      onTargetComplete: (target) => { completed.push(target) },
+      onTargetComplete: (target) => {
+        completed.push(target)
+      },
+      onTargetStart: (target) => {
+        started.push(target)
+      },
     })
 
     expect(started).toContain('darwin-arm64')

packages/bundler/src/compile.ts

@@ -2,9 +2,9 @@ import { execFile as execFileCb } from 'node:child_process'
 import { readdirSync, unlinkSync } from 'node:fs'
 import { join } from 'node:path'
 
+import type { CompileTarget } from '@kidd/config'
 import { err, ok } from '@kidd/utils/fp'
 import type { AsyncResult } from '@kidd/utils/fp'
-import type { CompileTarget } from '@kidd/config'
 
 import { DEFAULT_COMPILE_TARGETS } from './constants.js'
 import { detectBuildEntry, resolveConfig } from './resolve-config.js'
@@ -124,7 +124,9 @@ async function compileSingleTarget(params: {
 
   const [execError] = await execBunBuild(args)
   if (execError) {
-    return err(new Error(`bun build --compile failed for target ${params.target}`, { cause: execError }))
+    return err(
+      new Error(`bun build --compile failed for target ${params.target}`, { cause: execError })
+    )
   }
 
   return ok({ label: resolveTargetLabel(params.target), path: outfile, target: params.target })
@@ -223,5 +225,5 @@ function cleanBunBuildArtifacts(cwd: string): void {
   readdirSync(cwd)
     .filter((name) => name.endsWith('.bun-build'))
     .map((name) => join(cwd, name))
-    .forEach(unlinkSync)
+    .map(unlinkSync)
 }

packages/bundler/src/generate-autoloader.test.ts

@@ -45,8 +45,10 @@ describe('static autoloader generation', () => {
 
     expect(code).toContain("import _deploy from '/project/commands/deploy/index.ts'")
     expect(code).toContain("import _deploy_preview from '/project/commands/deploy/preview.ts'")
-    expect(code).toContain("import _deploy_production from '/project/commands/deploy/production.ts'")
-    expect(code).toContain("withTag({ ..._deploy, commands:")
+    expect(code).toContain(
+      "import _deploy_production from '/project/commands/deploy/production.ts'"
+    )
+    expect(code).toContain('withTag({ ..._deploy, commands:')
     expect(code).toContain("'preview': _deploy_preview")
     expect(code).toContain("'production': _deploy_production")
     expect(code).toContain("}, 'Command')")
@@ -57,9 +59,7 @@ describe('static autoloader generation', () => {
       dirs: [
         {
           dirs: [],
-          files: [
-            { filePath: '/project/commands/auth/login.ts', name: 'login' },
-          ],
+          files: [{ filePath: '/project/commands/auth/login.ts', name: 'login' }],
           name: 'auth',
         },
       ],
@@ -77,9 +77,7 @@ describe('static autoloader generation', () => {
   it('should import withTag from the provided tag module path', () => {
     const scan: ScanResult = {
       dirs: [],
-      files: [
-        { filePath: '/project/commands/status.ts', name: 'status' },
-      ],
+      files: [{ filePath: '/project/commands/status.ts', name: 'status' }],
     }
 
     const code = generateStaticAutoloader({ scan, tagModulePath: TAG_PATH })
@@ -94,9 +92,7 @@ describe('static autoloader generation', () => {
           dirs: [
             {
               dirs: [],
-              files: [
-                { filePath: '/project/commands/deploy/cloud/aws.ts', name: 'aws' },
-              ],
+              files: [{ filePath: '/project/commands/deploy/cloud/aws.ts', name: 'aws' }],
               name: 'cloud',
             },
           ],
@@ -133,16 +129,12 @@ describe('static autoloader generation', () => {
       dirs: [
         {
           dirs: [],
-          files: [
-            { filePath: '/project/commands/deploy/preview.ts', name: 'preview' },
-          ],
+          files: [{ filePath: '/project/commands/deploy/preview.ts', name: 'preview' }],
           index: '/project/commands/deploy/index.ts',
           name: 'deploy',
         },
       ],
-      files: [
-        { filePath: '/project/commands/status.ts', name: 'status' },
-      ],
+      files: [{ filePath: '/project/commands/status.ts', name: 'status' }],
     }
 
     const code = generateStaticAutoloader({ scan, tagModulePath: TAG_PATH })
@@ -157,9 +149,7 @@ describe('autoloader parts generation', () => {
   it('should use dynamic imports inside autoload function', () => {
     const scan: ScanResult = {
       dirs: [],
-      files: [
-        { filePath: '/project/commands/status.ts', name: 'status' },
-      ],
+      files: [{ filePath: '/project/commands/status.ts', name: 'status' }],
     }
 
     const parts = generateAutoloaderParts({ scan, tagModulePath: TAG_PATH })
@@ -175,9 +165,7 @@ describe('autoloader parts generation', () => {
   it('should include region markers', () => {
     const scan: ScanResult = {
       dirs: [],
-      files: [
-        { filePath: '/project/commands/status.ts', name: 'status' },
-      ],
+      files: [{ filePath: '/project/commands/status.ts', name: 'status' }],
     }
 
     const parts = generateAutoloaderParts({ scan, tagModulePath: TAG_PATH })
@@ -203,9 +191,7 @@ describe('autoloader parts generation', () => {
       dirs: [
         {
           dirs: [],
-          files: [
-            { filePath: '/project/commands/auth/login.ts', name: 'login' },
-          ],
+          files: [{ filePath: '/project/commands/auth/login.ts', name: 'login' }],
           name: 'auth',
         },
       ],

packages/bundler/src/generate-autoloader.ts

@@ -61,7 +61,9 @@ export function generateStaticAutoloader(params: GenerateStaticAutoloaderParams)
  * @param params - The scan result and path to the tag utility module.
  * @returns Import statements (empty) and the replacement autoloader region.
  */
-export function generateAutoloaderParts(params: GenerateStaticAutoloaderParams): StaticAutoloaderParts {
+export function generateAutoloaderParts(
+  params: GenerateStaticAutoloaderParams
+): StaticAutoloaderParts {
   const imports = collectImports(params.scan)
 
   if (imports.length === 0) {
@@ -165,9 +167,7 @@ function buildImportStatements(
 ): readonly string[] {
   const tagLine = buildTagImportLine(imports, tagModulePath)
 
-  const importLines = imports.map(
-    (entry) => `import ${entry.identifier} from '${entry.filePath}'`
-  )
+  const importLines = imports.map((entry) => `import ${entry.identifier} from '${entry.filePath}'`)
 
   return [...tagLine, '', ...importLines]
 }
@@ -294,13 +294,9 @@ function buildDynamicAutoloaderRegion(
   imports: readonly ImportEntry[],
   commandsObject: string
 ): string {
-  const destructuring = imports
-    .map((entry) => `    { default: ${entry.identifier} },`)
-    .join('\n')
+  const destructuring = imports.map((entry) => `    { default: ${entry.identifier} },`).join('\n')
 
-  const importCalls = imports
-    .map((entry) => `    import('${entry.filePath}'),`)
-    .join('\n')
+  const importCalls = imports.map((entry) => `    import('${entry.filePath}'),`).join('\n')
 
   return [
     '//#region src/autoloader.ts (static)',

packages/bundler/src/map-config.test.ts

@@ -114,4 +114,3 @@ describe('watch config mapping', () => {
     expect(result.onSuccess).toBeUndefined()
   })
 })
-

packages/bundler/src/map-config.ts

@@ -33,16 +33,16 @@ export function mapToBuildConfig(config: ResolvedBundlerConfig): InlineConfig {
     logLevel: 'info',
     minify: config.build.minify,
     outDir: config.buildOutDir,
+    outputOptions: {
+      codeSplitting: false,
+    },
     platform: 'node',
     plugins: [
       createAutoloadPlugin({
         commandsDir: config.commands,
         tagModulePath: resolveTagModulePath(),
       }),
     ],
-    outputOptions: {
-      codeSplitting: false,
-    },
     sourcemap: config.build.sourcemap,
     target: config.build.target,
     treeshake: true,

packages/bundler/src/resolve-config.test.ts

@@ -167,4 +167,3 @@ describe(normalizeCompileOptions, () => {
     expect(normalizeCompileOptions(opts)).toStrictEqual(opts)
   })
 })
-