presetter 8.2.0 → 9.0.0

package/README.md

@@ -1,17 +1,16 @@
 # 🚀 Presetter
 
-![Logo](https://github.com/alvis/presetter/raw/master/assets/logo.svg)
+<p align="center">
+  <img src="https://raw.githubusercontent.com/alvis/presetter/master/assets/logo.svg" alt="Presetter logo" height="128">
+</p>
 
 <div align="center">
 
 [![npm](https://img.shields.io/npm/v/presetter?style=flat-square)](https://github.com/alvis/presetter/releases)
-[![build](https://img.shields.io/github/actions/workflow/status/alvis/presetter/test.yaml?branch=master&style=flat-square)](https://github.com/alvis/presetter/actions)
-[![maintainability](https://img.shields.io/codeclimate/maintainability/alvis/presetter?style=flat-square)](https://codeclimate.com/github/alvis/presetter/maintainability)
-[![coverage](https://img.shields.io/codeclimate/coverage/alvis/presetter?style=flat-square)](https://codeclimate.com/github/alvis/presetter/test_coverage)
-[![vulnerabilities](https://img.shields.io/sonar/vulnerabilities/presetter/master?server=https%3A%2F%2Fsonarcloud.io&style=flat-square)](https://sonarcloud.io/summary/new_code?id=presetter)
+[![build](https://img.shields.io/github/actions/workflow/status/alvis/presetter/test.yaml?branch=main&style=flat-square)](https://github.com/alvis/presetter/actions)
 [![dependencies](https://img.shields.io/librariesio/release/npm/presetter?style=flat-square)](https://libraries.io/npm/presetter)
 
-Template-driven configuration management — transform 40+ dev dependencies into 2 packages ⚡
+Template-driven configuration management for TypeScript projects and monorepos ⚡
 
 •   [Quick Start](#-quick-start)   •   [CLI Reference](#-cli-reference)   •   [Presets](#-official-presets)   •   [Architecture](#-how-it-works)   •
 
@@ -19,70 +18,67 @@ Template-driven configuration management — transform 40+ dev dependencies into
 
 ---
 
-**Presetter is the configuration management tool that processes presets to generate perfect development environments with zero manual setup.**
+**Presetter is the configuration management tool that turns an explicit preset stack into the files and scripts your TypeScript projects need.**
 
 ## ⚡ The Development Setup Revolution
 
 ### Still copying configs between projects? 😤
 
-How many times have you copied configuration files for `babel`, `eslint`, `vitest`, `typescript`, or life cycle scripts across projects? How many dev dependencies do you install before you can even start coding?
+Every repo starts clean. Then the same `eslint`, `vitest`, `typescript`, build, and lifecycle settings fork in small ways across apps, packages, services, and CLIs.
 
-**What if setup took one command and two packages?**
+Presetter moves that intent into `presetter.config.ts`: compose official presets for the shared baseline, keep local overrides visible, and regenerate the config files your toolchain still expects.
 
-### The manual setup nightmare vs. Presetter magic ✨
+<p align="center">
+  <video src="https://github.com/user-attachments/assets/03eef833-9c20-4d22-99c7-85f26c620e66" controls playsinline preload="metadata" width="100%" title="Presetter launch video: make configuration maintainable again">
+    <a href="https://github.com/user-attachments/assets/03eef833-9c20-4d22-99c7-85f26c620e66">Watch the Presetter launch video</a>
+  </video>
+</p>
+
+### The config drift loop vs. Presetter
 
 ```diff
-# Before: Manual development setup (40+ packages, 20+ config files)
-my-project/
-├── package.json                    ← 47 devDependencies to manage
-├── .babelrc.json                   ← Manual Babel configuration
-├── .eslintrc.json                  ← Custom ESLint rules and plugins
-├── .prettierrc.json                ← Prettier formatting rules
-├── vitest.config.ts                ← Test configuration
-├── tsconfig.json                   ← TypeScript compiler options
-├── tsconfig.build.json             ← Build-specific TS config
-├── .lintstagedrc.json              ← Pre-commit hook configuration
-├── .husky/                         ← Git hooks setup
-├── rollup.config.js                ← Bundle configuration
-├── tailwind.config.js              ← CSS framework config
-└── ... (dozen more config files)   ← Endless configuration maintenance
-
-# After: Presetter setup (2 packages, 1 command)
-my-project/
-+├── presetter.config.ts            ← Single preset reference
-├── package.json                    ← 2 devDependencies total!
-└── Perfect configs generated automatically from templates 🎯
+# Before: copied config across repos and packages
+workspace/
+├── apps/web/eslint.config.ts       ← React-specific edits
+├── apps/api/eslint.config.ts       ← Similar, but not quite the same
+├── packages/ui/vitest.config.ts    ← Local test tweaks
+├── packages/core/tsconfig.json     ← Shared intent copied by hand
+└── packages/runtime/package.json   ← Scripts slowly drift
+
+# After: explicit preset stack plus generated outputs
+workspace/
++├── presetter.config.ts            ← Compose the maintained baseline
+├── package.json                    ← Scripts merge with preset scripts
+└── generated config files          ← Output files can stay out of Git
 ```
 
 ---
 
-## 🎯 One Command. Perfect Setup. Every Time
+## 🎯 Compose the Toolchain You Need
 
 ```bash
-# Choose your development style and get everything instantly:
+# Choose the preset stack that matches this project:
 
 # 🟢 Modern ESM development
-npx presetter use presetter-preset-esm
+npx presetter use @presetter/preset-esm
 
 # 🔗 Legacy CommonJS compatibility
-npx presetter use presetter-preset-cjs
+npx presetter use @presetter/preset-cjs
 
 # 🌐 Dual-module library publishing
-npx presetter use presetter-preset-hybrid
+npx presetter use @presetter/preset-hybrid
 
 # 🎨 Modern web development with TailwindCSS + Storybook
-npx presetter use presetter-preset-esm presetter-preset-web
+npx presetter use @presetter/preset-esm @presetter/preset-web
 
 # ⚛️ React application with optimized toolchain
-npx presetter use presetter-preset-esm presetter-preset-react
+npx presetter use @presetter/preset-esm @presetter/preset-react
 
 # 🏢 Production-grade with security hardening + 100% coverage
-npx presetter use presetter-preset-esm presetter-preset-strict
+npx presetter use @presetter/preset-esm @presetter/preset-strict
 ```
 
-**That's it.** TypeScript, ESLint, Vitest, build scripts, git hooks, formatter, linter, bundler — everything configured perfectly and working together.
-
-![Demo](https://raw.githubusercontent.com/alvis/presetter/master/assets/demo.gif)
+TypeScript, ESLint, Vitest, build scripts, git hooks, formatter, linter, bundler — the same maintained baseline can travel across repos while each project keeps the differences that matter.
 
 ---
 
@@ -95,21 +91,21 @@ Presetter doesn't copy static files. It **generates** configurations using sophi
 - **Context-aware**: Presets know about your project structure, dependencies, and requirements
 - **Variable substitution**: Templates use dynamic values (`{source}`, `{target}`, `{output}`)
 - **Smart merging**: Deep merge algorithms handle complex configuration inheritance
-- **Two-pass resolution**: Initial setup + override pass for perfect customization
+- **Two-pass resolution**: Initial setup + override pass for controlled customization
 
 ### 🏗️ Composable Preset Architecture
 
 Mix and match presets like building blocks:
 
 ```typescript
-// presetter.config.ts - Build your perfect development environment
+// presetter.config.ts - Build the stack this project needs
 import { preset } from 'presetter';
-import essentials from 'presetter-preset-essentials';
-import web from 'presetter-preset-web';
-import react from 'presetter-preset-react';
-import strict from 'presetter-preset-strict';
+import essentials from '@presetter/preset-essentials';
+import web from '@presetter/preset-web';
+import react from '@presetter/preset-react';
+import strict from '@presetter/preset-strict';
 
-export default preset('my-perfect-app', {
+export default preset('my-app', {
   extends: [essentials, web, react, strict], // 🚀 Ultimate React stack
   override: {
     variables: {
@@ -121,11 +117,11 @@ export default preset('my-perfect-app', {
 
 ### ⚡ Real Developer Productivity
 
-| Manual Setup Time                     | With Presetter                   | Productivity Gain            |
-| ------------------------------------- | -------------------------------- | ---------------------------- |
-| **2-4 hours** initial setup           | **30 seconds**                   | **24x faster** ⚡            |
-| **30 minutes** per config update      | **Automatic** via preset updates | **∞ maintenance time saved** |
-| **Copy-paste errors** across projects | **Zero config drift**            | **100% consistency**         |
+| Common Setup Pain                   | With Presetter                         | Result                          |
+| ----------------------------------- | -------------------------------------- | ------------------------------- |
+| Rebuilding the same toolchain setup | Compose a preset stack once            | Faster project starts           |
+| Repeating config updates by hand    | Update preset versions and bootstrap   | Fewer risky edits               |
+| Copy-paste errors across projects   | Keep shared intent in one config model | Less drift, clearer differences |
 
 ---
 
@@ -147,13 +143,13 @@ export default preset('my-perfect-app', {
 
 ## 🚀 Quick Start
 
-### 🎬 Instant Project Setup
+### 🎬 Project Setup
 
 ```bash
-# 1. Choose and adopt a preset (creates presetter.config.ts automatically)
-npx presetter use presetter-preset-esm
+# 1. Choose and adopt a preset stack
+npx presetter use @presetter/preset-esm
 
-# 2. Install dependencies (presetter bootstrap runs automatically)
+# 2. Install dependencies and let bootstrap generate tool configs
 npm install
 
 # 3. Start developing immediately!
@@ -169,13 +165,13 @@ npm run watch    # ✅ Development mode
 # 1. Review current setup (decide what to keep/replace)
 ls -la *.config.* .*rc.* tsconfig*.json
 
-# 2. Remove unnecessary configs and dev dependencies
-npm uninstall babel eslint prettier typescript vitest # ...and 30+ more
+# 2. Remove local config files you want presets to own
+rm eslint.config.ts vitest.config.ts
 
 # 3. Adopt presetter
-npx presetter use presetter-preset-esm
+npx presetter use @presetter/preset-esm
 
-# 4. Cleanup and enjoy zero-config development
+# 4. Keep only the local overrides that matter
 ```
 
 ---
@@ -203,15 +199,34 @@ Options:
   --version                 Show version number
 ```
 
+#### Bootstrap flags
+
+| Flag                | Alias | Default | Purpose                                                                                           |
+| ------------------- | ----- | ------- | ------------------------------------------------------------------------------------------------- |
+| `--projects <glob>` | `-p`  | `.`     | Path globs to project directories containing a `package.json` (e.g. `packages/*`, `presets/next`) |
+| `--packages <glob>` | `-P`  | _none_  | Package-name globs matching `package.json#name` across the workspace (e.g. `@presetter/preset-*`) |
+| `--only <file>`     |       | _none_  | Only proceed when the specified file exists                                                       |
+
+Both `--projects` and `--packages` accept comma-separated values; the wildcard `*` in `--packages` does not cross the npm-scope boundary (so `@presetter/preset-*` will not match `@other/foo`).
+
 ### 🎯 Common Commands
 
 ```bash
-# Adopt presets (automatically bootstraps)
-presetter use presetter-preset-esm presetter-preset-strict
+# Adopt presets and run bootstrap
+presetter use @presetter/preset-esm @presetter/preset-strict
 
 # Manually bootstrap (if needed)
 presetter bootstrap
 
+# Bootstrap specific projects by path glob
+presetter bootstrap --projects packages/*
+
+# Bootstrap by package name (e.g. every preset package in a monorepo)
+presetter bootstrap --packages "@presetter/preset-*"
+
+# Mix path and name globs; both flags accept comma-separated values
+presetter bootstrap --projects .,e2e,packages/* --packages "@presetter/preset-*"
+
 # Run development tasks
 run build                 # Build your project
 run test                  # Run tests
@@ -234,21 +249,21 @@ Presetter comes with a comprehensive ecosystem of official presets:
 
 ### Core Development Presets
 
-| Preset                                                                                                       | Purpose                        | Best For                                  |
-| ------------------------------------------------------------------------------------------------------------ | ------------------------------ | ----------------------------------------- |
-| **[presetter-preset-essentials](https://github.com/alvis/presetter/blob/master/packages/preset-essentials)** | 🏗️ Complete TypeScript toolkit | Foundation for all TypeScript projects    |
-| **[presetter-preset-esm](https://github.com/alvis/presetter/blob/master/packages/preset-esm)**               | 🚀 ESM-first development       | Modern Node.js projects, libraries        |
-| **[presetter-preset-cjs](https://github.com/alvis/presetter/blob/master/packages/preset-cjs)**               | 🔗 CommonJS compatibility      | Legacy environments, enterprise           |
-| **[presetter-preset-hybrid](https://github.com/alvis/presetter/blob/master/packages/preset-hybrid)**         | 🌐 Dual-module packages        | npm libraries needing broad compatibility |
+| Preset                                                                                                      | Purpose                        | Best For                                  |
+| ----------------------------------------------------------------------------------------------------------- | ------------------------------ | ----------------------------------------- |
+| **[@presetter/preset-essentials](https://github.com/alvis/presetter/blob/main/packages/preset-essentials)** | 🏗️ Complete TypeScript toolkit | Foundation for all TypeScript projects    |
+| **[@presetter/preset-esm](https://github.com/alvis/presetter/blob/main/packages/preset-esm)**               | 🚀 ESM-first development       | Modern Node.js projects, libraries        |
+| **[@presetter/preset-cjs](https://github.com/alvis/presetter/blob/main/packages/preset-cjs)**               | 🔗 CommonJS compatibility      | Legacy environments, enterprise           |
+| **[@presetter/preset-hybrid](https://github.com/alvis/presetter/blob/main/packages/preset-hybrid)**         | 🌐 Dual-module packages        | npm libraries needing broad compatibility |
 
 ### Specialized Extension Presets
 
-| Preset                                                                                               | Purpose                     | Extends         |
-| ---------------------------------------------------------------------------------------------------- | --------------------------- | --------------- |
-| **[presetter-preset-strict](https://github.com/alvis/presetter/blob/master/packages/preset-strict)** | 🏢 Production-grade quality | Any base preset |
-| **[presetter-preset-web](https://github.com/alvis/presetter/blob/master/packages/preset-web)**       | 🎨 Modern web development   | Any base preset |
-| **[presetter-preset-react](https://github.com/alvis/presetter/blob/master/packages/preset-react)**   | ⚛️ React development        | Any base preset |
-| **[presetter-preset-rollup](https://github.com/alvis/presetter/blob/master/packages/preset-rollup)** | 📦 Library bundling         | Any base preset |
+| Preset                                                                                              | Purpose                     | Extends         |
+| --------------------------------------------------------------------------------------------------- | --------------------------- | --------------- |
+| **[@presetter/preset-strict](https://github.com/alvis/presetter/blob/main/packages/preset-strict)** | 🏢 Production-grade quality | Any base preset |
+| **[@presetter/preset-web](https://github.com/alvis/presetter/blob/main/packages/preset-web)**       | 🎨 Modern web development   | Any base preset |
+| **[@presetter/preset-react](https://github.com/alvis/presetter/blob/main/packages/preset-react)**   | ⚛️ React development        | Any base preset |
+| **[@presetter/preset-rollup](https://github.com/alvis/presetter/blob/main/packages/preset-rollup)** | 📦 Library bundling         | Any base preset |
 
 ### 🎯 Preset Combination Examples
 
@@ -299,6 +314,46 @@ Presetter uses a sophisticated **two-pass resolution system** that makes configu
 - **Deep Merging**: Sophisticated algorithms handle complex inheritance
 - **Script Composition**: Local scripts merge with preset scripts intelligently
 
+### 🔧 Binary Path Resolution
+
+When running tasks via `run`, `run-s`, or `run-p`, Presetter prepends binary paths from preset packages to the PATH environment variable. This makes tools in each preset's `node_modules/.bin` directory available without additional configuration.
+
+**How it works:**
+
+- Direct preset binaries are checked first
+- Extended preset binaries are checked next
+- Finally, the existing PATH is checked
+
+**Benefits:**
+
+- No need to install shared dev tools at the repository root
+- No need for pnpm's `shamefullyHoist: true` or `public-hoist-pattern` for every tool
+- Preset dependencies are available to templated scripts through the resolved PATH
+
+**Limitation - Dynamic Imports:**
+
+Libraries loaded via dynamic `import()` may fail because dynamic imports are resolved from the project root, not the preset. This affects libraries that are loaded at runtime rather than through direct imports.
+
+**Notable example:** `@vitest/coverage-v8` - required by vitest when using v8 as the coverage engine.
+
+**Workarounds:**
+
+1. **Install directly:** Add the library to your project's `package.json` (or monorepo root):
+
+   ```bash
+   npm install -D @vitest/coverage-v8
+   ```
+
+2. **Use pnpm hoisting:** Add the library to pnpm's `public-hoist-pattern` in `pnpm-workspace.yaml`:
+
+   ```yaml
+   packages:
+     - 'packages/*'
+   settings:
+     public-hoist-pattern:
+       - '@vitest/coverage-v8'
+   ```
+
 ---
 
 ## 🛠️ Advanced Usage
@@ -308,7 +363,7 @@ Presetter uses a sophisticated **two-pass resolution system** that makes configu
 ```typescript
 // presetter.config.ts
 import { preset } from 'presetter';
-import esm from 'presetter-preset-esm';
+import esm from '@presetter/preset-esm';
 
 export default preset('my-project', {
   extends: [esm],
@@ -365,22 +420,22 @@ Combine preset scripts with your local scripts:
 
 ### ✅ Developer Experience
 
-- **⚡ Zero-config setup**: One command gets you productive immediately
-- **🔄 Consistent updates**: Update all projects by updating preset versions
-- **🎯 Best practices**: Configurations follow industry standards and expert recommendations
-- **🚀 Composable architecture**: Mix and match presets to build perfect environments
+- **⚡ Repeatable setup**: Adopt a preset stack and generate the expected tool configs
+- **🔄 Consistent updates**: Update projects by updating preset versions
+- **🎯 Recommended baselines**: Configurations follow maintained TypeScript tooling patterns
+- **🚀 Composable architecture**: Mix and match presets to fit each project shape
 
 ### ✅ Project Management
 
-- **📦 Dependency reduction**: 40+ packages → 2 packages
-- **🔧 Maintenance simplification**: Single source of truth for configurations
-- **🌐 Team consistency**: Same setup across all team members and projects
-- **📈 Scalability**: Manage configurations across dozens of projects effortlessly
+- **📦 Config drift reduction**: Keep shared toolchain intent in `presetter.config.ts`
+- **🔧 Maintenance simplification**: Single source of truth for generated configurations
+- **🌐 Team consistency**: Same baseline across team members and projects
+- **📈 Scalability**: Manage configurations across many repos and monorepo packages
 
 ### ✅ Technical Excellence
 
 - **🧠 Intelligent merging**: Sophisticated algorithms handle complex configurations
-- **🔄 Two-pass resolution**: Initial setup + override for perfect customization
+- **🔄 Two-pass resolution**: Initial setup + override for controlled customization
 - **📝 Template system**: Dynamic, context-aware configuration generation
 - **🎛️ Fine-grained control**: Override anything while maintaining preset benefits
 
@@ -388,11 +443,11 @@ Combine preset scripts with your local scripts:
 
 ## 🆚 Alternatives Comparison
 
-| Solution            | Setup Time     | Maintenance | Consistency | Flexibility | Learning Curve |
-| ------------------- | -------------- | ----------- | ----------- | ----------- | -------------- |
-| **Manual Setup**    | 2-4 hours      | High        | Poor        | Full        | High           |
-| **Boilerplate/CRA** | 5 minutes      | Medium      | Medium      | Limited     | Medium         |
-| **Presetter**       | **30 seconds** | **Zero**    | **Perfect** | **Full**    | **Low**        |
+| Solution            | Setup Model                  | Maintenance       | Consistency         | Flexibility |
+| ------------------- | ---------------------------- | ----------------- | ------------------- | ----------- |
+| **Manual Setup**    | Hand-copy each config        | Repeated by hand  | Drifts easily       | Full        |
+| **Boilerplate/CRA** | Copy a starter project once  | Template ages     | Medium              | Limited     |
+| **Presetter**       | Compose presets and generate | Versioned presets | Maintained baseline | Full        |
 
 ---
 
@@ -421,7 +476,7 @@ DEBUG=presetter* run build
 
 ### How is this different from boilerplates?
 
-Boilerplates copy static files once. Presetter **generates** configurations dynamically and **maintains** them through preset updates. When you update a preset, all projects using it get the improvements automatically.
+Boilerplates copy static files once. Presetter **generates** configurations dynamically and **maintains** them through preset updates. When you update a preset and run `bootstrap`, projects using it can pick up the same improvements.
 
 ### Can I customize generated configurations?
 
@@ -437,11 +492,15 @@ Simply update the preset package version in your projects. Presetter will regene
 
 ### Can I create my own presets?
 
-Absolutely! Presets are just npm packages that export configuration templates. See [presetter-types](https://github.com/alvis/presetter/blob/master/packages/types) for TypeScript definitions.
+Absolutely! Presets are just npm packages that export configuration templates. See [@presetter/types](https://github.com/alvis/presetter/blob/main/packages/types) for TypeScript definitions.
 
 ### Does this work with monorepos?
 
-Yes! Presetter supports monorepo setups and can bootstrap multiple projects with glob patterns. Use [presetter-preset-monorepo](https://github.com/alvis/presetter/blob/master/packages/preset-monorepo) for monorepo-specific configurations.
+Yes! Presetter supports monorepo setups and can bootstrap multiple projects with glob patterns. Use [@presetter/preset-monorepo](https://github.com/alvis/presetter/blob/main/packages/preset-monorepo) for monorepo-specific configurations.
+
+### Why do some dynamically imported libraries fail to resolve?
+
+While Presetter makes preset tools available via PATH, libraries loaded through dynamic `import()` (like `@vitest/coverage-v8`) resolve from your project root, not the preset. Install such libraries directly at your project root or add them to pnpm's `public-hoist-pattern` in `pnpm-workspace.yaml`.
 
 ---
 
@@ -449,13 +508,13 @@ Yes! Presetter supports monorepo setups and can bootstrap multiple projects with
 
 We'd love your ideas and contributions!
 Submit issues or suggestions via [GitHub Issues](https://github.com/alvis/presetter/issues).
-See the [Contribution Guide](https://github.com/alvis/presetter/blob/master/CONTRIBUTING.md) for more details.
+See the [Contribution Guide](https://github.com/alvis/presetter/blob/main/CONTRIBUTING.md) for more details.
 
 ---
 
 ## 📄 License
 
-Released under the [MIT License](https://github.com/alvis/presetter/blob/master/LICENSE).
+Released under the [MIT License](https://github.com/alvis/presetter/blob/main/LICENSE).
 © 2020, [Alvis Tang](https://github.com/alvis).
 
-[![License](https://img.shields.io/github/license/alvis/presetter.svg?style=flat-square)](https://github.com/alvis/presetter/blob/master/LICENSE)
+[![License](https://img.shields.io/github/license/alvis/presetter.svg?style=flat-square)](https://github.com/alvis/presetter/blob/main/LICENSE)

package/lib/context.d.ts

@@ -1,4 +1,4 @@
-import type { ProjectContext } from 'presetter-types';
+import type { ProjectContext } from '@presetter/types';
 /**
  * get scripts from the targeted project's package.json
  * @param cwd path to the project's root folder

package/lib/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,CAAC,CAgCzB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,CAAC,CAgCzB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B"}

package/lib/debugger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debugger.d.ts","sourceRoot":"","sources":["../src/debugger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;;AAE1B,wBAAkC"}
+{"version":3,"file":"debugger.d.ts","sourceRoot":"","sources":["../src/debugger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC"}

package/lib/executable/entry.d.ts

@@ -1,7 +1,26 @@
+interface ResolveProjectRootsOptions {
+    readonly projects: readonly string[];
+    readonly packages: readonly string[];
+}
 /**
  * provide a command line interface
  * @param args command line arguments
- * @returns the command entered together with its options
  */
 export declare function entry(args: string[]): Promise<void>;
+/**
+ * resolve target project roots from path globs and package-name globs
+ * @param options resolution inputs
+ * @param options.projects path globs (e.g. `presets/next`, `packages/*`)
+ * @param options.packages package-name globs (e.g. `@presetter/preset-*`)
+ * @returns deduped absolute project root paths
+ */
+export declare function resolveProjectRoots(options: ResolveProjectRootsOptions): Promise<string[]>;
+/**
+ * expand each entry by splitting on a delimiter and trimming the parts
+ * @param values raw flag values, each possibly containing the delimiter
+ * @param delimiter delimiter character (defaults to `,`)
+ * @returns flattened, trimmed, non-empty values
+ */
+export declare function expandDelimitedValues(values: readonly string[], delimiter?: string): string[];
+export {};
 //# sourceMappingURL=entry.d.ts.map

package/lib/executable/entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/executable/entry.ts"],"names":[],"mappings":"AA+GA;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAezD"}
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/executable/entry.ts"],"names":[],"mappings":"AAmBA,UAAU,0BAA0B;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AA8GD;;;GAGG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAezD;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,MAAM,EAAE,CAAC,CA+BnB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,SAAS,GAAE,MAA+B,GACzC,MAAM,EAAE,CAOV"}