create-bunli 0.1.3 → 0.3.0

package/README.md

@@ -21,6 +21,7 @@ create-bunli my-cli
 - 🧪 **Testing included** - Comes with @bunli/test for CLI testing
 - 🎨 **Best practices** - Follows Bunli conventions and patterns
 - 🌐 **Flexible sources** - Use bundled templates or any GitHub repository
+- ⚡ **Type generation** - All templates include codegen for enhanced developer experience
 
 ## Usage
 
@@ -205,6 +206,18 @@ Templates can include a `template.json` manifest:
 }
 ```
 
+### Type Generation
+
+All templates include type generation configuration for enhanced developer experience:
+
+This provides:
+- **Autocomplete** for command names and options
+- **Type safety** at compile time
+- **IntelliSense** for command metadata
+- **CLI wrappers** for programmatic execution
+
+Learn more in the [Type Generation Guide](/docs/guides/type-generation).
+
 ### Template Variables
 
 Use these variables in your template files:

package/dist/cli.js

@@ -102,6 +102,15 @@ async function getFilesToProcess(dir, manifest) {
     }
   }
   await walk(dir);
+  if (manifest?.files?.exclude) {
+    return files.filter((file) => {
+      return !manifest.files.exclude.some((pattern) => {
+        const regexPattern = pattern.replace(/\*\*/g, ".*").replace(/\*/g, "[^/]*").replace(/\?/g, "[^/]");
+        const regex = new RegExp(`^${regexPattern}$`);
+        return regex.test(file);
+      });
+    });
+  }
   return files;
 }
 async function runPostInstallHooks(dir, hooks) {
@@ -277,7 +286,7 @@ async function run() {
   } else if (args[0] && !args[0].startsWith("-") && args[0] !== "create") {
     process.argv.splice(2, 0, "create");
   }
-  const cli = createCLI({
+  const cli = await createCLI({
     name: "create-bunli",
     version: "0.1.0",
     description: "Scaffold new Bunli CLI projects"

package/dist/index.js

@@ -96,6 +96,15 @@ async function getFilesToProcess(dir, manifest) {
     }
   }
   await walk(dir);
+  if (manifest?.files?.exclude) {
+    return files.filter((file) => {
+      return !manifest.files.exclude.some((pattern) => {
+        const regexPattern = pattern.replace(/\*\*/g, ".*").replace(/\*/g, "[^/]*").replace(/\?/g, "[^/]");
+        const regex = new RegExp(`^${regexPattern}$`);
+        return regex.test(file);
+      });
+    });
+  }
   return files;
 }
 async function runPostInstallHooks(dir, hooks) {

package/dist/templates/advanced/.bunli/commands.gen.report.json

@@ -0,0 +1,6 @@
+{
+  "commandsParsed": 0,
+  "filesScanned": 0,
+  "skipped": [],
+  "names": []
+}

package/dist/templates/advanced/.bunli/commands.gen.ts

@@ -0,0 +1,66 @@
+// This file was automatically generated by Bunli.
+// You should NOT make any changes in this file as it will be overwritten.
+
+import type { Command, CLI, GeneratedOptionMeta, RegisteredCommands, CommandOptions, GeneratedCommandMeta } from '@bunli/core'
+import { createGeneratedHelpers, registerGeneratedStore } from '@bunli/core'
+
+
+
+// Narrow list of command names to avoid typeof-cycles in types
+const names = [] as const
+type GeneratedNames = typeof names[number]
+
+const modules: Record<GeneratedNames, Command<any>> = {
+
+} as const
+
+const metadata: Record<GeneratedNames, GeneratedCommandMeta> = {
+
+} as const
+
+export const generated = registerGeneratedStore(createGeneratedHelpers(modules, metadata))
+
+export const commands = generated.commands
+export const commandMeta = generated.metadata
+
+export interface GeneratedCLI {
+  register(cli?: CLI<any>): GeneratedCLI
+  list(): Array<{
+    name: GeneratedNames
+    command: (typeof modules)[GeneratedNames]
+    metadata: (typeof metadata)[GeneratedNames]
+  }>
+  get<Name extends GeneratedNames>(name: Name): (typeof modules)[Name]
+  getMetadata<Name extends GeneratedNames>(name: Name): (typeof metadata)[Name]
+  getFlags<Name extends keyof RegisteredCommands & string>(name: Name): CommandOptions<Name>
+  getFlagsMeta<Name extends GeneratedNames>(name: Name): Record<string, GeneratedOptionMeta>
+  withCLI(cli: CLI<any>): { execute(name: string, options: unknown): Promise<void> }
+}
+
+export const cli: GeneratedCLI = {
+  register: (cliInstance?: CLI<any>) => { generated.register(cliInstance); return cli },
+  list: () => generated.list(),
+  get: <Name extends GeneratedNames>(name: Name) => generated.get(name),
+  getMetadata: <Name extends GeneratedNames>(name: Name) => generated.getMetadata(name),
+  getFlags: <Name extends keyof RegisteredCommands & string>(name: Name) => generated.getFlags(name) as CommandOptions<Name>,
+  getFlagsMeta: <Name extends GeneratedNames>(name: Name) => generated.getFlagsMeta(name),
+  withCLI: (cliInstance) => generated.withCLI(cliInstance)
+}
+
+// Enhanced helper functions
+export const listCommands = () => generated.list().map(c => c.name)
+export const getCommandApi = <Name extends GeneratedNames>(name: Name) => generated.getMetadata(name)
+export const getTypedFlags = <Name extends GeneratedNames>(name: Name) => generated.getFlags(name) as CommandOptions<Name>
+export const validateCommand = <Name extends GeneratedNames>(name: Name, flags: Record<string, unknown>) => generated.validateCommand(name, flags)
+export const findCommandByName = <Name extends GeneratedNames>(name: Name) => generated.findByName(name)
+export const findCommandsByDescription = (searchTerm: string) => generated.findByDescription(searchTerm)
+export const getCommandNames = () => generated.getCommandNames()
+
+// Auto-register on import for zero-config usage
+export default cli
+
+// Ensure module augmentation happens on import
+declare module '@bunli/core' {
+  // Precise key mapping without typeof cycles
+  interface RegisteredCommands extends Record<GeneratedNames, Command<any>> {}
+}

package/dist/templates/advanced/bunli.config.ts

@@ -0,0 +1,29 @@
+import { defineConfig } from '@bunli/core'
+
+export default defineConfig({
+  name: '{{name}}',
+  version: '{{version}}',
+  description: '{{description}}',
+  
+  plugins: [],
+  
+  build: {
+    entry: './src/index.ts',
+    outdir: './dist',
+    targets: ['darwin-arm64', 'darwin-x64', 'linux-x64', 'windows-x64'],
+    minify: true,
+    sourcemap: true,
+    compress: true
+  },
+  
+  dev: {
+    watch: true,
+    inspect: false
+  },
+  
+  test: {
+    pattern: ['**/*.test.ts', '**/*.spec.ts'],
+    coverage: true,
+    watch: false
+  }
+})

package/dist/templates/advanced/package.json

@@ -9,11 +9,12 @@
     "{{projectName}}": "./dist/index.js"
   },
   "scripts": {
+    "postinstall": "bunli generate",
     "dev": "bun run src/index.ts",
     "build": "bunli build",
     "test": "bun test",
     "test:watch": "bun test --watch",
-    "type-check": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
     "lint": "tsc --noEmit",
     "prepare": "bun run build"
   },

package/dist/templates/advanced/src/index.ts

@@ -6,7 +6,7 @@ import { serveCommand } from './commands/serve.js'
 import { configCommand } from './commands/config.js'
 import { loadConfig } from './utils/config.js'
 
-const cli = createCLI({
+const cli = await createCLI({
   name: '{{projectName}}',
   version: '0.1.0',
   description: '{{description}}'

package/dist/templates/advanced/template.json

@@ -33,5 +33,12 @@
         { "label": "Unlicense", "value": "Unlicense" }
       ]
     }
-  ]
+  ],
+  "files": {
+    "exclude": [
+      "node_modules/**",
+      ".git/**",
+      "template.json"
+    ]
+  }
 }

package/dist/templates/advanced/tsconfig.json

@@ -12,7 +12,7 @@
     "declarationMap": true,
     "outDir": "./dist",
     "rootDir": "./src",
-    "types": ["bun-types"],
+    "types": ["bun"],
     "noUnusedLocals": true,
     "noUnusedParameters": true,
     "noImplicitReturns": true,

package/dist/templates/basic/.bunli/commands.gen.report.json

@@ -0,0 +1,6 @@
+{
+  "commandsParsed": 0,
+  "filesScanned": 0,
+  "skipped": [],
+  "names": []
+}

package/dist/templates/basic/.bunli/commands.gen.ts

@@ -0,0 +1,66 @@
+// This file was automatically generated by Bunli.
+// You should NOT make any changes in this file as it will be overwritten.
+
+import type { Command, CLI, GeneratedOptionMeta, RegisteredCommands, CommandOptions, GeneratedCommandMeta } from '@bunli/core'
+import { createGeneratedHelpers, registerGeneratedStore } from '@bunli/core'
+
+
+
+// Narrow list of command names to avoid typeof-cycles in types
+const names = [] as const
+type GeneratedNames = typeof names[number]
+
+const modules: Record<GeneratedNames, Command<any>> = {
+
+} as const
+
+const metadata: Record<GeneratedNames, GeneratedCommandMeta> = {
+
+} as const
+
+export const generated = registerGeneratedStore(createGeneratedHelpers(modules, metadata))
+
+export const commands = generated.commands
+export const commandMeta = generated.metadata
+
+export interface GeneratedCLI {
+  register(cli?: CLI<any>): GeneratedCLI
+  list(): Array<{
+    name: GeneratedNames
+    command: (typeof modules)[GeneratedNames]
+    metadata: (typeof metadata)[GeneratedNames]
+  }>
+  get<Name extends GeneratedNames>(name: Name): (typeof modules)[Name]
+  getMetadata<Name extends GeneratedNames>(name: Name): (typeof metadata)[Name]
+  getFlags<Name extends keyof RegisteredCommands & string>(name: Name): CommandOptions<Name>
+  getFlagsMeta<Name extends GeneratedNames>(name: Name): Record<string, GeneratedOptionMeta>
+  withCLI(cli: CLI<any>): { execute(name: string, options: unknown): Promise<void> }
+}
+
+export const cli: GeneratedCLI = {
+  register: (cliInstance?: CLI<any>) => { generated.register(cliInstance); return cli },
+  list: () => generated.list(),
+  get: <Name extends GeneratedNames>(name: Name) => generated.get(name),
+  getMetadata: <Name extends GeneratedNames>(name: Name) => generated.getMetadata(name),
+  getFlags: <Name extends keyof RegisteredCommands & string>(name: Name) => generated.getFlags(name) as CommandOptions<Name>,
+  getFlagsMeta: <Name extends GeneratedNames>(name: Name) => generated.getFlagsMeta(name),
+  withCLI: (cliInstance) => generated.withCLI(cliInstance)
+}
+
+// Enhanced helper functions
+export const listCommands = () => generated.list().map(c => c.name)
+export const getCommandApi = <Name extends GeneratedNames>(name: Name) => generated.getMetadata(name)
+export const getTypedFlags = <Name extends GeneratedNames>(name: Name) => generated.getFlags(name) as CommandOptions<Name>
+export const validateCommand = <Name extends GeneratedNames>(name: Name, flags: Record<string, unknown>) => generated.validateCommand(name, flags)
+export const findCommandByName = <Name extends GeneratedNames>(name: Name) => generated.findByName(name)
+export const findCommandsByDescription = (searchTerm: string) => generated.findByDescription(searchTerm)
+export const getCommandNames = () => generated.getCommandNames()
+
+// Auto-register on import for zero-config usage
+export default cli
+
+// Ensure module augmentation happens on import
+declare module '@bunli/core' {
+  // Precise key mapping without typeof cycles
+  interface RegisteredCommands extends Record<GeneratedNames, Command<any>> {}
+}

package/dist/templates/basic/bunli.config.ts

@@ -0,0 +1,29 @@
+import { defineConfig } from '@bunli/core'
+
+export default defineConfig({
+  name: '{{name}}',
+  version: '{{version}}',
+  description: '{{description}}',
+  
+  build: {
+    entry: './src/index.ts',
+    outdir: './dist',
+    targets: ['native'],
+    minify: true,
+    sourcemap: true,
+    compress: false
+  },
+  
+  dev: {
+    watch: true,
+    inspect: true
+  },
+  
+  test: {
+    pattern: ['**/*.test.ts', '**/*.spec.ts'],
+    coverage: true,
+    watch: false
+  },
+
+  plugins: [],
+})

package/dist/templates/basic/package.json

@@ -8,10 +8,11 @@
     "{{projectName}}": "./dist/index.js"
   },
   "scripts": {
+    "postinstall": "bunli generate",
     "dev": "bun run src/index.ts",
     "build": "bunli build",
     "test": "bun test",
-    "type-check": "tsc --noEmit"
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@bunli/core": "latest"

package/dist/templates/basic/src/index.ts

@@ -2,7 +2,7 @@
 import { createCLI } from '@bunli/core'
 import { helloCommand } from './commands/hello.js'
 
-const cli = createCLI({
+const cli = await createCLI({
   name: '{{projectName}}',
   version: '0.1.0',
   description: '{{description}}'

package/dist/templates/basic/tsconfig.json

@@ -12,7 +12,7 @@
     "declarationMap": true,
     "outDir": "./dist",
     "rootDir": "./src",
-    "types": ["bun-types"]
+    "types": ["bun"]
   },
   "include": ["src/**/*"],
   "exclude": ["node_modules", "dist", "test/**/*"]

package/dist/templates/monorepo/.bunli/commands.gen.report.json

@@ -0,0 +1,6 @@
+{
+  "commandsParsed": 0,
+  "filesScanned": 0,
+  "skipped": [],
+  "names": []
+}

package/dist/templates/monorepo/.bunli/commands.gen.ts

@@ -0,0 +1,66 @@
+// This file was automatically generated by Bunli.
+// You should NOT make any changes in this file as it will be overwritten.
+
+import type { Command, CLI, GeneratedOptionMeta, RegisteredCommands, CommandOptions, GeneratedCommandMeta } from '@bunli/core'
+import { createGeneratedHelpers, registerGeneratedStore } from '@bunli/core'
+
+
+
+// Narrow list of command names to avoid typeof-cycles in types
+const names = [] as const
+type GeneratedNames = typeof names[number]
+
+const modules: Record<GeneratedNames, Command<any>> = {
+
+} as const
+
+const metadata: Record<GeneratedNames, GeneratedCommandMeta> = {
+
+} as const
+
+export const generated = registerGeneratedStore(createGeneratedHelpers(modules, metadata))
+
+export const commands = generated.commands
+export const commandMeta = generated.metadata
+
+export interface GeneratedCLI {
+  register(cli?: CLI<any>): GeneratedCLI
+  list(): Array<{
+    name: GeneratedNames
+    command: (typeof modules)[GeneratedNames]
+    metadata: (typeof metadata)[GeneratedNames]
+  }>
+  get<Name extends GeneratedNames>(name: Name): (typeof modules)[Name]
+  getMetadata<Name extends GeneratedNames>(name: Name): (typeof metadata)[Name]
+  getFlags<Name extends keyof RegisteredCommands & string>(name: Name): CommandOptions<Name>
+  getFlagsMeta<Name extends GeneratedNames>(name: Name): Record<string, GeneratedOptionMeta>
+  withCLI(cli: CLI<any>): { execute(name: string, options: unknown): Promise<void> }
+}
+
+export const cli: GeneratedCLI = {
+  register: (cliInstance?: CLI<any>) => { generated.register(cliInstance); return cli },
+  list: () => generated.list(),
+  get: <Name extends GeneratedNames>(name: Name) => generated.get(name),
+  getMetadata: <Name extends GeneratedNames>(name: Name) => generated.getMetadata(name),
+  getFlags: <Name extends keyof RegisteredCommands & string>(name: Name) => generated.getFlags(name) as CommandOptions<Name>,
+  getFlagsMeta: <Name extends GeneratedNames>(name: Name) => generated.getFlagsMeta(name),
+  withCLI: (cliInstance) => generated.withCLI(cliInstance)
+}
+
+// Enhanced helper functions
+export const listCommands = () => generated.list().map(c => c.name)
+export const getCommandApi = <Name extends GeneratedNames>(name: Name) => generated.getMetadata(name)
+export const getTypedFlags = <Name extends GeneratedNames>(name: Name) => generated.getFlags(name) as CommandOptions<Name>
+export const validateCommand = <Name extends GeneratedNames>(name: Name, flags: Record<string, unknown>) => generated.validateCommand(name, flags)
+export const findCommandByName = <Name extends GeneratedNames>(name: Name) => generated.findByName(name)
+export const findCommandsByDescription = (searchTerm: string) => generated.findByDescription(searchTerm)
+export const getCommandNames = () => generated.getCommandNames()
+
+// Auto-register on import for zero-config usage
+export default cli
+
+// Ensure module augmentation happens on import
+declare module '@bunli/core' {
+  // Precise key mapping without typeof cycles
+  interface RegisteredCommands extends Record<GeneratedNames, Command<any>> {}
+}

package/dist/templates/monorepo/README.md

@@ -32,7 +32,7 @@ bun run build
 bun test
 
 # Type check
-bun run type-check
+bun run typecheck
 ```
 
 ## Creating a New Package
@@ -62,7 +62,7 @@ bun run release
 - `dev` - Run all packages in development mode
 - `build` - Build all packages
 - `test` - Run all tests
-- `type-check` - Type check all packages
+- `typecheck` - Type check all packages
 - `lint` - Lint all packages
 - `clean` - Clean all build artifacts
 - `changeset` - Create a new changeset

package/dist/templates/monorepo/bunli.config.ts

@@ -0,0 +1,34 @@
+import { defineConfig } from '@bunli/core'
+
+export default defineConfig({
+  name: '{{name}}',
+  version: '{{version}}',
+  description: '{{description}}',
+  
+  plugins: [],
+
+  build: {
+    entry: './packages/core/src/index.ts',
+    outdir: './packages/core/dist',
+    targets: ['darwin-arm64', 'darwin-x64', 'linux-x64', 'windows-x64'],
+    minify: true,
+    compress: true,
+    sourcemap: true
+  },
+  
+  dev: {
+    watch: true,
+    inspect: false
+  },
+  
+  test: {
+    pattern: ['**/*.test.ts', '**/*.spec.ts'],
+    coverage: true,
+    watch: false
+  },
+  
+  workspace: {
+    packages: ['./packages/*'],
+    versionStrategy: 'fixed'
+  }
+})

package/dist/templates/monorepo/package.json

@@ -9,10 +9,11 @@
     "packages/*"
   ],
   "scripts": {
+    "postinstall": "bunli generate",
     "dev": "turbo run dev",
     "build": "turbo run build",
     "test": "turbo run test",
-    "type-check": "turbo run type-check",
+    "typecheck": "turbo run typecheck",
     "lint": "turbo run lint",
     "clean": "turbo run clean && rm -rf node_modules",
     "changeset": "changeset",

package/dist/templates/monorepo/packages/cli/package.json

@@ -9,10 +9,11 @@
     "{{projectName}}": "./dist/index.js"
   },
   "scripts": {
+    "postinstall": "bunli generate",
     "dev": "bun run src/index.ts",
     "build": "bunli build",
     "test": "bun test",
-    "type-check": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist"
   },
   "dependencies": {

package/dist/templates/monorepo/packages/cli/src/index.ts

@@ -3,7 +3,7 @@ import { createCLI } from '@bunli/core'
 import { logger } from '@{{projectName}}/utils'
 import { processCommand, analyzeCommand } from '@{{projectName}}/core'
 
-const cli = createCLI({
+const cli = await createCLI({
   name: '{{projectName}}',
   version: '0.1.0',
   description: '{{description}}'

package/dist/templates/monorepo/packages/core/package.json

@@ -16,7 +16,7 @@
   "scripts": {
     "build": "bun scripts/build.ts && bun run tsc",
     "test": "bun test",
-    "type-check": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist"
   },
   "dependencies": {

package/dist/templates/monorepo/packages/utils/package.json

@@ -16,7 +16,7 @@
   "scripts": {
     "build": "bun scripts/build.ts && bun run tsc",
     "test": "bun test",
-    "type-check": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist"
   },
   "devDependencies": {

package/dist/templates/monorepo/template.json

@@ -20,5 +20,12 @@
       "type": "string",
       "default": ""
     }
-  ]
+  ],
+  "files": {
+    "exclude": [
+      "node_modules/**",
+      ".git/**",
+      "template.json"
+    ]
+  }
 }

package/dist/templates/monorepo/tsconfig.json

@@ -8,7 +8,7 @@
     "skipLibCheck": true,
     "forceConsistentCasingInFileNames": true,
     "resolveJsonModule": true,
-    "types": ["bun-types"]
+    "types": ["bun"]
   },
   "exclude": ["node_modules", "dist", "build", ".turbo"]
 }

package/dist/templates/monorepo/turbo.json

@@ -14,7 +14,7 @@
     "lint": {
       "dependsOn": ["^build"]
     },
-    "type-check": {
+    "typecheck": {
       "dependsOn": ["^build"]
     },
     "dev": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-bunli",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "type": "module",
   "description": "Scaffold new Bunli CLI projects",
   "bin": {
@@ -43,12 +43,13 @@
     "dev": "bun run src/cli.ts",
     "build": "bun scripts/build.ts && bun run tsc",
     "test": "bun test",
-    "type-check": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@bunli/core": "0.1.0",
-    "@bunli/utils": "0.1.0",
+    "@bunli/core": "0.3.0",
+    "@bunli/utils": "0.2.0",
+    "@bunli/test": "0.2.0",
     "giget": "^2.0.0",
     "zod": "^3.25.67"
   },
@@ -56,4 +57,4 @@
     "@types/bun": "latest",
     "typescript": "^5.8.0"
   }
-}
+}

package/templates/advanced/.bunli/commands.gen.report.json

@@ -0,0 +1,6 @@
+{
+  "commandsParsed": 0,
+  "filesScanned": 0,
+  "skipped": [],
+  "names": []
+}