itty-packager 1.0.7 → 1.0.9

package/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(bun bin/itty.js lint:*)"
+    ],
+    "deny": []
+  }
+}

package/CLAUDE.md

@@ -0,0 +1,77 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+### Development Commands
+- `bun bin/itty.js lint` - Lint the codebase using the CLI tool itself
+- `bun bin/itty.js build` - Build the project (not typically needed as this is the build tool itself)
+- `echo 'No tests yet'` - Current test command (no test suite implemented)
+
+### Release Commands
+- `bun bin/itty.js publish --patch --tag --dry-run --src=. --no-license` - Dry run release
+- `bun bin/itty.js publish --patch --tag --push --src=. --no-license` - Patch release (quiet by default)
+- `bun bin/itty.js publish --minor --tag --push --src=. --no-license` - Minor release
+- `bun bin/itty.js publish --major --tag --push --src=. --no-license` - Major release
+- Add `--verbose` flag to any command for detailed output including npm and git details
+
+### CLI Usage
+The main CLI entry point is `bin/itty.js` which provides three core commands:
+- `itty build` - TypeScript compilation with Rollup
+- `itty lint` - ESLint with built-in TypeScript configuration
+- `itty publish` - Version bumping and npm publishing
+
+## Architecture
+
+### Core Components
+
+**CLI Entry Point** (`bin/itty.js`):
+- Main executable that dynamically imports command modules
+- Handles global flags (--help, --version) and subcommand routing
+- Supports build, lint, and publish subcommands
+
+**Build System** (`lib/builder.js`):
+- Core build logic using Rollup and TypeScript
+- Handles ESM/CJS hybrid builds, minification with terser, sourcemaps
+- Automatically updates package.json exports based on build outputs
+- Supports snippet generation for README injection
+- Single file exports map to root export, multiple files get individual exports
+
+**Command Modules** (`lib/commands/`):
+- **build.js**: Wraps builder.js with CLI argument parsing
+- **lint.js**: ESLint integration with smart config detection
+- **publish.js**: Version bumping, package extraction, and npm publishing
+
+**ESLint Configuration** (`lib/configs/`):
+- **createConfig.mjs**: Factory function for extending base TypeScript ESLint config
+- **eslint.config.mjs**: Base configuration with TypeScript support
+- Automatically used when no local ESLint config is found
+
+### Key Architectural Patterns
+
+**Dynamic Command Loading**: Commands are lazily loaded to improve startup time and allow future extensibility.
+
+**Smart Configuration**: The lint command detects local ESLint configs and falls back to built-in TypeScript configuration when none exists.
+
+**Clean Package Publishing**: The publish command creates a flat package structure by extracting build artifacts to a temporary directory, copying essential files (README, LICENSE, CHANGELOG), and transforming package.json paths before publishing.
+
+**Extensible ESLint**: Projects can extend the built-in config using `createConfig()` from `itty-packager/lib/configs/createConfig.mjs`.
+
+### Build Output Handling
+
+The build system automatically manages package.json exports:
+- Single TypeScript file → root export (`"."`)
+- Multiple TypeScript files → individual named exports
+- Paths are automatically updated to point to dist/ directory
+- ESM builds by default, CJS optional with `--hybrid` flag
+
+### Publishing Workflow
+
+The publish command transforms the package structure:
+1. Extracts build artifacts from dist/ to temporary directory
+2. Copies root files (README.md, LICENSE, .npmrc)
+3. Transforms package.json paths (e.g., `./dist/file.mjs` → `./file.mjs`)
+4. Publishes the clean, flat structure
+5. Updates root package.json with new version
+6. Optionally handles git tagging and pushing

package/README.md

@@ -138,7 +138,7 @@ Version bump and publish your package to npm with clean, flat package structure.
 - `--no-cleanup` - Leave temporary directory after publishing
 - `--public` - Publish as public package (`--access=public`)
 - `--no-license` - Do not copy LICENSE file to published package
-- `--no-changelog` - Do not copy CHANGELOG.md file to published package
+- `-v, --verbose` - Show detailed output including npm and git command details
 
 **Git Options:**
 - `--tag` - Create git tag for release
@@ -148,7 +148,7 @@ Version bump and publish your package to npm with clean, flat package structure.
 **Default Behavior:**
 - Defaults to patch version bump if no type specified
 - Extracts build artifacts to temporary directory
-- Copies root files: `README.md`, `LICENSE`, `CHANGELOG.md`, `.npmrc` (if they exist)
+- Copies root files: `README.md`, `LICENSE`, `.npmrc` (if they exist)
 - Transforms package.json paths (e.g., `./dist/file.mjs` → `./file.mjs`)
 - Creates clean, flat package structure in node_modules
 
@@ -158,6 +158,7 @@ itty publish                   # Patch bump and publish from dist/ (default)
 itty publish --minor --tag     # Minor bump, publish, and create git tag
 itty publish --type=alpha      # Pre-release alpha version
 itty publish --dry-run         # Test the publish process
+itty publish --verbose         # Show detailed output during publish
 itty publish --no-license      # Publish without copying LICENSE file
 ```
 
@@ -166,7 +167,7 @@ itty publish --no-license      # Publish without copying LICENSE file
 The publish command creates a clean package structure by:
 
 1. **Extracting build artifacts** from your `dist/` directory to package root
-2. **Copying essential files** like README, LICENSE, CHANGELOG
+2. **Copying essential files** like README, LICENSE
 3. **Transforming paths** in package.json to point to root-level files
 4. **Publishing the clean structure** so users get flat imports
 

package/lib/commands/publish.js

@@ -72,19 +72,35 @@ function versionBump(currentVersion, type) {
   }
 }
 
-async function runCommand(command, cwd = process.cwd()) {
+async function runCommand(command, cwd = process.cwd(), verbose = false) {
   return new Promise((resolve, reject) => {
     const [cmd, ...args] = command.split(' ')
     const proc = spawn(cmd, args, {
-      stdio: 'inherit',
+      stdio: verbose ? 'inherit' : 'pipe',
       cwd,
       shell: true
     })
 
+    let stdout = ''
+    let stderr = ''
+
+    if (!verbose) {
+      proc.stdout?.on('data', (data) => {
+        stdout += data.toString()
+      })
+      proc.stderr?.on('data', (data) => {
+        stderr += data.toString()
+      })
+    }
+
     proc.on('close', (code) => {
       if (code === 0) {
-        resolve()
+        resolve({ stdout, stderr })
       } else {
+        // Always show error output regardless of verbose setting
+        if (!verbose && stderr) {
+          console.error(stderr)
+        }
         reject(new Error(`Command failed with exit code ${code}: ${command}`))
       }
     })
@@ -153,9 +169,10 @@ export async function publishCommand(args) {
         type: 'boolean',
         description: 'Do not copy LICENSE file to published package'
       },
-      'no-changelog': {
+      verbose: {
         type: 'boolean',
-        description: 'Do not copy CHANGELOG.md file to published package'
+        short: 'v',
+        description: 'Show detailed output including npm and git command details'
       },
       help: {
         type: 'boolean',
@@ -185,7 +202,7 @@ Publish Options:
       --no-cleanup        Leave temporary directory after publishing
       --public            Publish as public package (--access=public)
       --no-license        Do not copy LICENSE file to published package
-      --no-changelog      Do not copy CHANGELOG.md file to published package
+  -v, --verbose           Show detailed output including npm and git command details
 
 Git Options:
       --tag               Create git tag for release
@@ -229,7 +246,7 @@ This creates a clean, flat package structure in node_modules.
   const shouldPush = publishArgs.push
   const noGit = publishArgs['no-git']
   const noLicense = publishArgs['no-license']
-  const noChangelog = publishArgs['no-changelog']
+  const verbose = publishArgs.verbose
 
   try {
     // Read package.json
@@ -238,7 +255,7 @@ This creates a clean, flat package structure in node_modules.
     const newVersion = versionBump(pkg.version, releaseType)
 
     console.log(`📦 Publishing ${pkg.name} v${pkg.version} → v${newVersion}`)
-    console.log(`📁 Source: ${publishArgs.src}/`)
+    if (verbose) console.log(`📁 Source: ${publishArgs.src}/`)
 
     // Check if source directory exists
     if (!await fs.pathExists(srcDir)) {
@@ -246,12 +263,12 @@ This creates a clean, flat package structure in node_modules.
     }
 
     // Clean and create temp directory
-    console.log(`🧹 Preparing ${publishArgs.dest}/`)
+    if (verbose) console.log(`🧹 Preparing ${publishArgs.dest}/`)
     await fs.emptyDir(tempDir)
     await fs.ensureDir(tempDir)
 
     // Copy source files to temp directory
-    console.log(`📋 Copying ${publishArgs.src}/ to ${path.relative(rootPath, tempDir)}/`)
+    if (verbose) console.log(`📋 Copying ${publishArgs.src}/ to ${path.relative(rootPath, tempDir)}/`)
     
     const filter = (src) => {
       // Always exclude node_modules
@@ -280,14 +297,13 @@ This creates a clean, flat package structure in node_modules.
       
       // Add optional files based on flags
       if (!noLicense) rootFiles.push('LICENSE')
-      if (!noChangelog) rootFiles.push('CHANGELOG.md')
       
       for (const file of rootFiles) {
         const srcFile = path.join(rootPath, file)
         const destFile = path.join(tempDir, file)
         
         if (await fs.pathExists(srcFile)) {
-          console.log(`📄 Copying ${file}`)
+          if (verbose) console.log(`📄 Copying ${file}`)
           await fs.copy(srcFile, destFile)
         }
       }
@@ -300,7 +316,7 @@ This creates a clean, flat package structure in node_modules.
     const tempPkgPath = path.join(tempDir, 'package.json')
     
     const transformMessage = isRootPublish ? '' : ' (transforming paths)'
-    console.log(`📝 Updating package.json to v${newVersion}${transformMessage}`)
+    if (verbose) console.log(`📝 Updating package.json to v${newVersion}${transformMessage}`)
     await fs.writeJSON(tempPkgPath, updatedPkg, { spaces: 2 })
 
     if (dryRun) {
@@ -315,41 +331,41 @@ This creates a clean, flat package structure in node_modules.
         SEMVER_TYPES.includes(releaseType) ? '' : `--tag=${releaseType}`
       ].filter(Boolean).join(' ')
 
-      console.log(`Running: ${publishCmd}`)
-      await runCommand(publishCmd, tempDir)
+      if (verbose) console.log(`Running: ${publishCmd}`)
+      await runCommand(publishCmd, tempDir, verbose)
       
       // Update root package.json
-      console.log(`📝 Updating root package.json`)
+      if (verbose) console.log(`📝 Updating root package.json`)
       await fs.writeJSON(pkgPath, updatedPkg, { spaces: 2 })
     }
 
     // Git operations
     if (!noGit && !dryRun) {
       if (shouldPush || shouldTag) {
-        console.log(`📋 Committing changes...`)
-        await runCommand('git add .', rootPath)
-        await runCommand(`git commit -m "released v${newVersion}"`, rootPath)
+        if (verbose) console.log(`📋 Committing changes...`)
+        await runCommand('git add .', rootPath, verbose)
+        await runCommand(`git commit -m "released v${newVersion}"`, rootPath, verbose)
       }
 
       if (shouldTag) {
-        console.log(`🏷️  Creating git tag v${newVersion}`)
-        await runCommand(`git tag -a v${newVersion} -m "Release v${newVersion}"`, rootPath)
+        if (verbose) console.log(`🏷️  Creating git tag v${newVersion}`)
+        await runCommand(`git tag -a v${newVersion} -m "Release v${newVersion}"`, rootPath, verbose)
       }
 
       if (shouldPush) {
-        console.log(`📤 Pushing to remote...`)
-        await runCommand('git push', rootPath)
+        if (verbose) console.log(`📤 Pushing to remote...`)
+        await runCommand('git push', rootPath, verbose)
         
         if (shouldTag) {
-          console.log(`📤 Pushing tags...`)
-          await runCommand('git push --tags', rootPath)
+          if (verbose) console.log(`📤 Pushing tags...`)
+          await runCommand('git push --tags', rootPath, verbose)
         }
       }
     }
 
     // Cleanup
     if (!noCleanup) {
-      console.log(`🧹 Cleaning up ${publishArgs.dest}/`)
+      if (verbose) console.log(`🧹 Cleaning up ${publishArgs.dest}/`)
       await fs.remove(tempDir)
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "itty-packager",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Universal build tool for itty libraries",
   "type": "module",
   "bin": {
@@ -9,10 +9,10 @@
   "scripts": {
     "lint": "bun bin/itty.js lint",
     "test": "echo 'No tests yet'",
-    "release:dry": "bun bin/itty.js publish --patch --tag --dry-run --src=. --no-license --no-changelog",
-    "release": "bun bin/itty.js publish --patch --tag --push --src=. --no-license --no-changelog",
-    "release:minor": "bun bin/itty.js publish --minor --tag --push --src=. --no-license --no-changelog",
-    "release:major": "bun bin/itty.js publish --major --tag --push --src=. --no-license --no-changelog"
+    "release:dry": "bun bin/itty.js publish --patch --tag --dry-run --src=. --no-license",
+    "release": "bun bin/itty.js publish --patch --tag --push --src=. --no-license",
+    "release:minor": "bun bin/itty.js publish --minor --tag --push --src=. --no-license",
+    "release:major": "bun bin/itty.js publish --major --tag --push --src=. --no-license"
   },
   "keywords": [
     "build",