itty-packager 1.0.7 → 1.0.8

package/CLAUDE.md

@@ -0,0 +1,76 @@
+# 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
+- `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
+
+### 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,6 @@ 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
 
 **Git Options:**
 - `--tag` - Create git tag for release
@@ -148,7 +147,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
 
@@ -166,7 +165,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

@@ -153,10 +153,6 @@ export async function publishCommand(args) {
         type: 'boolean',
         description: 'Do not copy LICENSE file to published package'
       },
-      'no-changelog': {
-        type: 'boolean',
-        description: 'Do not copy CHANGELOG.md file to published package'
-      },
       help: {
         type: 'boolean',
         short: 'h',
@@ -185,7 +181,6 @@ 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
 
 Git Options:
       --tag               Create git tag for release
@@ -229,7 +224,6 @@ 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']
 
   try {
     // Read package.json
@@ -280,7 +274,6 @@ 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)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "itty-packager",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "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",