npmdata 0.11.0 → 0.12.0

package/README.md

@@ -27,19 +27,19 @@ Create a dedicated npm package whose `package.json` declares an `npmdata` config
 
 ```json
 {
-  "name": "my-org-data",
+  "name": "my-org-configs",
   "version": "1.0.0",
   "npmdata": {
     "sets": [
       {
         "package": "base-datasets@^3.0.0",
-        "outputDir": "./data/base",
-        "files": ["datasets/**"]
+        "selector": { "files": ["datasets/**"] },
+        "output": { "path": "./data/base" }
       },
       {
         "package": "org-configs@^1.2.0",
-        "outputDir": "./configs",
-        "contentRegexes": ["env: production"]
+        "selector": { "contentRegexes": ["env: production"] },
+        "output": { "path": "./configs" }
       }
     ]
   }
@@ -51,7 +51,7 @@ Run `pnpm dlx npmdata init` in that package and then `npm publish` to release it
 **Consumer** — just install and run:
 
 ```sh
-npx my-org-data extract --output ./local-data
+npx my-org-configs extract --output ./local-data
 ```
 
 No knowledge of the upstream packages or transformation rules is required.
@@ -71,8 +71,8 @@ Add an `npmdata` configuration directly to a project's own `package.json` (or a
     "sets": [
       {
         "package": "base-datasets@^3.0.0",
-        "outputDir": "./data",
-        "files": ["datasets/**"]
+        "selector": { "files": ["datasets/**"] },
+        "output": { "path": "./data" }
       }
     ]
   }
@@ -86,8 +86,8 @@ Or write a standalone `.npmdatarc` (JSON object at the top level):
   "sets": [
     {
       "package": "base-datasets@^3.0.0",
-      "outputDir": "./data",
-      "files": ["datasets/**"]
+      "selector": { "files": ["datasets/**"] },
+      "output": { "path": "./data" }
     }
   ]
 }
@@ -96,6 +96,7 @@ Or write a standalone `.npmdatarc` (JSON object at the top level):
 Then run any command without `--packages`:
 
 ```sh
+npx npmdata           # same as 'npx npmdata extract'
 npx npmdata extract   # reads config, extracts all entries
 npx npmdata check     # checks all entries
 npx npmdata purge     # purges all entries
@@ -111,7 +112,7 @@ Config is resolved using [cosmiconfig](https://github.com/cosmiconfig/cosmiconfi
 | `.npmdatarc.yaml` / `.npmdatarc.yml` | YAML object with `"sets"` array |
 | `npmdata.config.js` | CommonJS module exporting object with `sets` array |
 
-All runner flags (`--dry-run`, `--silent`, `--verbose`, `--no-gitignore`, `--unmanaged`, `--tags`, `--output`) work as usual.
+All runner flags (`--dry-run`, `--silent`, `--verbose`, `--no-gitignore`, `--unmanaged`, `--presets`, `--output`) work as usual.
 
 **When to use:** When a consuming project wants to pin and automate a set of data extractions locally without publishing a separate data package. This is the lightest-weight approach — no extra package, no `init` step, just a config block and a single CLI call.
 
@@ -198,24 +199,24 @@ npx my-shared-assets extract --output ./data
 npx my-shared-assets check  --output ./data
 ```
 
-When the data package defines multiple `npmdata` entries in its `package.json`, you can limit which entries are processed using the `--tags` option. Only entries whose `tags` list includes at least one of the requested tags will be extracted; entries with no tags are skipped when a tag filter is active.
+When the data package defines multiple `npmdata` entries in its `package.json`, you can limit which entries are processed using the `--presets` option. Only entries whose `presets` list includes at least one of the requested presets will be extracted; entries with no presets are skipped when a preset filter is active.
 
 ```sh
 # run only entries tagged with "prod"
-npx my-shared-assets --tags prod
+npx my-shared-assets --presets prod
 
 # run entries tagged with either "prod" or "staging"
-npx my-shared-assets --tags prod,staging
+npx my-shared-assets --presets prod,staging
 ```
 
-To use tags, add a `tags` array to each `npmdata` entry in the data package's `package.json`:
+To use presets, add a `presets` array to each `npmdata` entry in the data package's `package.json`:
 
 ```json
 {
   "npmdata": {
     "sets": [
-      { "package": "my-shared-assets", "outputDir": "./data", "tags": ["prod"] },
-      { "package": "my-dev-assets",    "outputDir": "./dev-data", "tags": ["dev", "staging"] }
+      { "package": "my-shared-assets", "output": { "path": "./data" }, "presets": ["prod"] },
+      { "package": "my-dev-assets",    "output": { "path": "./dev-data" }, "presets": ["dev", "staging"] }
     ]
   }
 }
@@ -229,8 +230,8 @@ When calling the bin script bundled in a data package, the following options are
 
 | Option | Description |
 |---|---|
-| `--output, -o <dir>` | Base directory for resolving all `outputDir` paths (default: cwd). |
-| `--tags <tag1,tag2>` | Limit to entries whose `tags` overlap with the given list (comma-separated). |
+| `--output, -o <dir>` | Base directory for resolving all `output.path` values (default: cwd). |
+| `--presets <preset1,preset2>` | Limit to entries whose `presets` overlap with the given list (comma-separated). |
 | `--no-gitignore` | Disable `.gitignore` management for every entry, overriding each entry's `gitignore` field. |
 | `--unmanaged` | Run every entry in unmanaged mode, overriding each entry's `unmanaged` field. Files are written without a `.npmdata` marker, without `.gitignore` updates, and without being made read-only. |
 | `--dry-run` | Simulate changes without writing or deleting any files. |
@@ -254,27 +255,27 @@ Each entry in the `npmdata.sets` array in `package.json` supports the following
 | Option | Type | Default | Description |
 |---|---|---|---|
 | `package` | `string` | required | Package spec to install and extract. Either a bare name (`my-pkg`) or with a semver constraint (`my-pkg@^1.2.3`). |
-| `outputDir` | `string` | required | Directory where files will be extracted, relative to where the consumer runs the command. |
-| `files` | `string[]` | all files | Glob patterns to filter which files are extracted (e.g. `["data/**", "*.json"]`). |
-| `contentRegexes` | `string[]` | none | Regex patterns (as strings) to filter files by content. Only files matching at least one pattern are extracted. |
-| `force` | `boolean` | `false` | Allow overwriting existing unmanaged files or files owned by a different package. |
-| `keepExisting` | `boolean` | `false` | Skip files that already exist but create them when absent. Cannot be combined with `force`. |
-| `gitignore` | `boolean` | `true` | Create/update a `.gitignore` file alongside each `.npmdata` marker file. Set to `false` to disable. |
-| `unmanaged` | `boolean` | `false` | Write files without a `.npmdata` marker, `.gitignore` update, or read-only flag. Existing files are skipped. |
-| `dryRun` | `boolean` | `false` | Simulate extraction without writing anything to disk. |
+| `output.path` | `string` | required | Directory where files will be extracted, relative to where the consumer runs the command. |
+| `selector.files` | `string[]` | all files | Glob patterns to filter which files are extracted (e.g. `["data/**", "*.json"]`). |
+| `selector.contentRegexes` | `string[]` | none | Regex patterns (as strings) to filter files by content. Only files matching at least one pattern are extracted. |
+| `output.force` | `boolean` | `false` | Allow overwriting existing unmanaged files or files owned by a different package. |
+| `output.keepExisting` | `boolean` | `false` | Skip files that already exist but create them when absent. Cannot be combined with `force`. |
+| `output.gitignore` | `boolean` | `true` | Create/update a `.gitignore` file alongside each `.npmdata` marker file. Set to `false` to disable. |
+| `output.unmanaged` | `boolean` | `false` | Write files without a `.npmdata` marker, `.gitignore` update, or read-only flag. Existing files are skipped. |
+| `output.dryRun` | `boolean` | `false` | Simulate extraction without writing anything to disk. |
 | `upgrade` | `boolean` | `false` | Force a fresh install of the package even when a satisfying version is already installed. |
 | `silent` | `boolean` | `false` | Suppress per-file output, printing only the final result line. |
-| `tags` | `string[]` | none | Tags used to group and selectively run entries with `--tags`. |
-| `symlinks` | `SymlinkConfig[]` | none | Post-extract symlink operations (see below). |
-| `contentReplacements` | `ContentReplacementConfig[]` | none | Post-extract content-replacement operations (see below). |
+| `presets` | `string[]` | none | Presets used to group and selectively run entries with `--presets`. |
+| `output.symlinks` | `SymlinkConfig[]` | none | Post-extract symlink operations (see below). |
+| `output.contentReplacements` | `ContentReplacementConfig[]` | none | Post-extract content-replacement operations (see below). |
 
 #### SymlinkConfig
 
-After extraction, for each config the runner resolves all files/directories inside `outputDir` that match `source` and creates a corresponding symlink inside `target`. Stale symlinks pointing into `outputDir` but no longer matched are removed automatically.
+After extraction, for each config the runner resolves all files/directories inside `output.path` that match `source` and creates a corresponding symlink inside `target`. Stale symlinks pointing into `output.path` but no longer matched are removed automatically.
 
 | Field | Type | Description |
 |---|---|---|
-| `source` | `string` | Glob pattern relative to `outputDir`. Every matching file or directory gets a symlink in `target`. Example: `"**\/skills\/**"` |
+| `source` | `string` | Glob pattern relative to `output.path`. Every matching file or directory gets a symlink in `target`. Example: `"**\/skills\/**"` |
 | `target` | `string` | Directory where symlinks are created, relative to the project root. Example: `".github/skills"` |
 
 #### ContentReplacementConfig
@@ -294,17 +295,21 @@ Example with multiple options:
   "npmdata": [
     {
       "package": "my-shared-assets@^2.0.0",
-      "outputDir": "./data",
-      "files": ["docs/**", "configs/*.json"],
-      "gitignore": true,
+      "selector": {
+        "files": ["docs/**", "configs/*.json"]
+      },
+      "output": {
+        "path": "./data",
+        "gitignore": true,
+        "symlinks": [
+          { "source": "**\/skills\/**", "target": ".github/skills" }
+        ],
+        "contentReplacements": [
+          { "files": "docs/**\/*.md", "match": "<!-- version: .* -->", "replace": "<!-- version: 2.0.0 -->" }
+        ]
+      },
       "upgrade": true,
-      "tags": ["prod"],
-      "symlinks": [
-        { "source": "**\/skills\/**", "target": ".github/skills" }
-      ],
-      "contentReplacements": [
-        { "files": "docs/**\/*.md", "match": "<!-- version: .* -->", "replace": "<!-- version: 2.0.0 -->" }
-      ]
+      "presets": ["prod"]
     }
   ]
 }

package/dist/cli/actions/check.d.ts

@@ -0,0 +1,6 @@
+import { NpmdataConfig } from '../../types';
+/**
+ * `check` CLI action handler.
+ */
+export declare function runCheck(config: NpmdataConfig | null, argv: string[], cwd: string): Promise<void>;
+//# sourceMappingURL=check.d.ts.map

package/dist/cli/actions/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/cli/actions/check.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK5C;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,aAAa,GAAG,IAAI,EAC5B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CA+Cf"}

package/dist/cli/actions/check.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCheck = runCheck;
+const argv_1 = require("../argv");
+const usage_1 = require("../usage");
+const action_check_1 = require("../../package/action-check");
+/**
+ * `check` CLI action handler.
+ */
+async function runCheck(config, argv, cwd) {
+    if (argv.includes('--help')) {
+        (0, usage_1.printUsage)('check');
+        return;
+    }
+    let parsed;
+    try {
+        parsed = (0, argv_1.parseArgv)(argv);
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exitCode = 1;
+        return;
+    }
+    if (!config || config.sets.length === 0) {
+        console.error('Error: No config found and no --packages specified.');
+        process.exitCode = 1;
+        return;
+    }
+    const overridden = (0, argv_1.applyArgvOverrides)(config.sets, parsed);
+    try {
+        const summary = await (0, action_check_1.actionCheck)({
+            entries: overridden,
+            config,
+            cwd,
+            verbose: parsed.verbose,
+            skipUnmanaged: parsed.unmanaged,
+        });
+        const hasDrift = summary.missing.length > 0 || summary.modified.length > 0 || summary.extra.length > 0;
+        if (hasDrift) {
+            for (const f of summary.missing)
+                console.log(`missing: ${f}`);
+            for (const f of summary.modified)
+                console.log(`modified: ${f}`);
+            for (const f of summary.extra)
+                console.log(`extra: ${f}`);
+            process.exitCode = 1;
+        }
+        else {
+            console.log('All managed files are in sync.');
+        }
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/cli/actions/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/cli/actions/check.ts"],"names":[],"mappings":";;AASA,4BAmDC;AA1DD,kCAAwD;AACxD,oCAAsC;AACtC,6DAAyD;AAEzD;;GAEG;AACI,KAAK,UAAU,QAAQ,CAC5B,MAA4B,EAC5B,IAAc,EACd,GAAW;IAEX,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAA,kBAAU,EAAC,OAAO,CAAC,CAAC;QACpB,OAAO;IACT,CAAC;IAED,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,gBAAS,EAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,UAAW,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACrE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,IAAA,yBAAkB,EAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE3D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAA,0BAAW,EAAC;YAChC,OAAO,EAAE,UAAU;YACnB,MAAM;YACN,GAAG;YACH,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa,EAAE,MAAM,CAAC,SAAS;SAChC,CAAC,CAAC;QAEH,MAAM,QAAQ,GACZ,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAExF,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAC9D,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ;gBAAE,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;YAChE,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,KAAK;gBAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAC1D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,UAAW,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/cli/actions/extract.d.ts

@@ -0,0 +1,7 @@
+import { NpmdataConfig } from '../../types';
+/**
+ * `extract` CLI action handler.
+ * Parses argv, merges with config, calls actionExtract, prints summary.
+ */
+export declare function runExtract(config: NpmdataConfig | null, argv: string[], cwd: string): Promise<void>;
+//# sourceMappingURL=extract.d.ts.map

package/dist/cli/actions/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../src/cli/actions/extract.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM5C;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,aAAa,GAAG,IAAI,EAC5B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAuEf"}

package/dist/cli/actions/extract.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runExtract = runExtract;
+/* eslint-disable no-console */
+const node_child_process_1 = require("node:child_process");
+const argv_1 = require("../argv");
+const usage_1 = require("../usage");
+const action_extract_1 = require("../../package/action-extract");
+const utils_1 = require("../../utils");
+/**
+ * `extract` CLI action handler.
+ * Parses argv, merges with config, calls actionExtract, prints summary.
+ */
+async function runExtract(config, argv, cwd) {
+    if (argv.includes('--help')) {
+        (0, usage_1.printUsage)('extract');
+        return;
+    }
+    let parsed;
+    try {
+        parsed = (0, argv_1.parseArgv)(argv);
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exitCode = 1;
+        return;
+    }
+    // Build entries: --packages overrides config sets
+    let entries = (0, argv_1.buildEntriesFromArgv)(parsed);
+    if (!entries) {
+        if (!config || config.sets.length === 0) {
+            console.error('Error: No packages specified. Use --packages or a config file with sets.');
+            process.exitCode = 1;
+            return;
+        }
+        // Config-sourced entries need CLI flag overrides applied
+        entries = (0, argv_1.applyArgvOverrides)(config.sets, parsed);
+    }
+    // Apply preset filter
+    const presets = parsed.presets ?? [];
+    const filtered = (0, utils_1.filterEntriesByPresets)(entries, presets);
+    if (filtered.length === 0) {
+        console.log('No entries matched the specified presets.');
+        return;
+    }
+    try {
+        const result = await (0, action_extract_1.actionExtract)({
+            entries: filtered,
+            config,
+            cwd,
+            verbose: parsed.verbose,
+            onProgress: (event) => {
+                if (filtered[0]?.silent)
+                    return;
+                if (event.type === 'file-added')
+                    console.log(`  + ${event.file}`);
+                else if (event.type === 'file-modified')
+                    console.log(`  ~ ${event.file}`);
+                else if (event.type === 'file-deleted')
+                    console.log(`  - ${event.file}`);
+            },
+        });
+        // Run postExtractScript if configured and not dry-run
+        const isDryRun = filtered.some((e) => e.output.dryRun);
+        if (!isDryRun && config?.postExtractScript) {
+            const scriptCmd = `${config.postExtractScript} ${argv.join(' ')}`.trim();
+            try {
+                (0, node_child_process_1.execSync)(scriptCmd, { cwd, stdio: 'inherit', encoding: 'utf8' });
+            }
+            catch (error) {
+                const e = error;
+                process.exitCode = e.status ?? 1;
+                return;
+            }
+        }
+        console.log(`Extract complete: ${result.added} added, ${result.modified} modified, ` +
+            `${result.deleted} deleted, ${result.skipped} skipped.`);
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=extract.js.map

package/dist/cli/actions/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../../src/cli/actions/extract.ts"],"names":[],"mappings":"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"}

package/dist/cli/actions/init.d.ts

@@ -0,0 +1,6 @@
+import { NpmdataConfig } from '../../types';
+/**
+ * `init` CLI action handler.
+ */
+export declare function runInit(config: NpmdataConfig | null, argv: string[], cwd: string): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/actions/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/actions/init.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK5C;;GAEG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,aAAa,GAAG,IAAI,EAC5B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/cli/actions/init.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInit = runInit;
+/* eslint-disable no-console */
+const node_path_1 = __importDefault(require("node:path"));
+const argv_1 = require("../argv");
+const usage_1 = require("../usage");
+const action_init_1 = require("../../package/action-init");
+/**
+ * `init` CLI action handler.
+ */
+async function runInit(config, argv, cwd) {
+    if (argv.includes('--help')) {
+        (0, usage_1.printUsage)('init');
+        return;
+    }
+    const parsed = (0, argv_1.parseArgv)(argv);
+    const outputDir = parsed.output ? node_path_1.default.resolve(cwd, parsed.output) : cwd;
+    const { verbose, files, packages } = parsed;
+    const initConfig = {
+        files,
+        packages: packages?.map((p) => (p.version ? `${p.name}@${p.version}` : p.name)),
+    };
+    try {
+        await (0, action_init_1.actionInit)(outputDir, verbose, initConfig);
+        console.log('Init complete. Scaffolded package.json and bin/npmdata.js.');
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/actions/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/actions/init.ts"],"names":[],"mappings":";;;;;AAWA,0BA0BC;AArCD,+BAA+B;AAC/B,0DAA6B;AAG7B,kCAAoC;AACpC,oCAAsC;AACtC,2DAAuD;AAEvD;;GAEG;AACI,KAAK,UAAU,OAAO,CAC3B,MAA4B,EAC5B,IAAc,EACd,GAAW;IAEX,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAA,kBAAU,EAAC,MAAM,CAAC,CAAC;QACnB,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,gBAAS,EAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACzE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAE5C,MAAM,UAAU,GAAG;QACjB,KAAK;QACL,QAAQ,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;KAChF,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,IAAA,wBAAU,EAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,UAAW,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/cli/actions/list.d.ts

@@ -0,0 +1,7 @@
+import { NpmdataConfig } from '../../types';
+/**
+ * `list` CLI action handler.
+ * Note: list always ignores --presets.
+ */
+export declare function runList(config: NpmdataConfig | null, argv: string[], cwd: string): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

package/dist/cli/actions/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/actions/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK5C;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,aAAa,GAAG,IAAI,EAC5B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/cli/actions/list.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runList = runList;
+const argv_1 = require("../argv");
+const usage_1 = require("../usage");
+const action_list_1 = require("../../package/action-list");
+/**
+ * `list` CLI action handler.
+ * Note: list always ignores --presets.
+ */
+async function runList(config, argv, cwd) {
+    if (argv.includes('--help')) {
+        (0, usage_1.printUsage)('list');
+        return;
+    }
+    const parsed = (0, argv_1.parseArgv)(argv);
+    const entries = config?.sets ?? [];
+    try {
+        const files = await (0, action_list_1.actionList)({
+            entries,
+            config,
+            cwd,
+            output: parsed.output,
+            verbose: parsed.verbose,
+        });
+        if (files.length === 0) {
+            if (parsed.verbose)
+                console.log('No managed files found.');
+        }
+        else {
+            for (const f of files) {
+                console.log(`${f.path}  ${f.packageName}@${f.packageVersion}`);
+            }
+        }
+        // list always exits 0
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/cli/actions/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/cli/actions/list.ts"],"names":[],"mappings":";;AAUA,0BAmCC;AA3CD,kCAAoC;AACpC,oCAAsC;AACtC,2DAAuD;AAEvD;;;GAGG;AACI,KAAK,UAAU,OAAO,CAC3B,MAA4B,EAC5B,IAAc,EACd,GAAW;IAEX,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAA,kBAAU,EAAC,MAAM,CAAC,CAAC;QACnB,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,gBAAS,EAAC,IAAI,CAAC,CAAC;IAE/B,MAAM,OAAO,GAAG,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;IAEnC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAA,wBAAU,EAAC;YAC7B,OAAO;YACP,MAAM;YACN,GAAG;YACH,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;QAEH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QACD,sBAAsB;IACxB,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,UAAW,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/cli/actions/purge.d.ts

@@ -0,0 +1,6 @@
+import { NpmdataConfig } from '../../types';
+/**
+ * `purge` CLI action handler.
+ */
+export declare function runPurge(config: NpmdataConfig | null, argv: string[], cwd: string): Promise<void>;
+//# sourceMappingURL=purge.d.ts.map

package/dist/cli/actions/purge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purge.d.ts","sourceRoot":"","sources":["../../../src/cli/actions/purge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK5C;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,aAAa,GAAG,IAAI,EAC5B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAoCf"}

package/dist/cli/actions/purge.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPurge = runPurge;
+const argv_1 = require("../argv");
+const usage_1 = require("../usage");
+const action_purge_1 = require("../../package/action-purge");
+/**
+ * `purge` CLI action handler.
+ */
+async function runPurge(config, argv, cwd) {
+    if (argv.includes('--help')) {
+        (0, usage_1.printUsage)('purge');
+        return;
+    }
+    let parsed;
+    try {
+        parsed = (0, argv_1.parseArgv)(argv);
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exitCode = 1;
+        return;
+    }
+    const entries = config?.sets ?? [];
+    try {
+        const summary = await (0, action_purge_1.actionPurge)({
+            entries,
+            config,
+            cwd,
+            presets: parsed.presets ?? [],
+            dryRun: parsed.dryRun,
+            verbose: parsed.verbose,
+            onProgress: (event) => {
+                if (parsed.silent)
+                    return;
+                if (event.type === 'file-deleted')
+                    console.log(`  - ${event.file}`);
+            },
+        });
+        console.log(`Purge complete: ${summary.deleted} deleted.`);
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=purge.js.map

package/dist/cli/actions/purge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"purge.js","sourceRoot":"","sources":["../../../src/cli/actions/purge.ts"],"names":[],"mappings":";;AASA,4BAwCC;AA/CD,kCAAoC;AACpC,oCAAsC;AACtC,6DAAyD;AAEzD;;GAEG;AACI,KAAK,UAAU,QAAQ,CAC5B,MAA4B,EAC5B,IAAc,EACd,GAAW;IAEX,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAA,kBAAU,EAAC,OAAO,CAAC,CAAC;QACpB,OAAO;IACT,CAAC;IAED,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,gBAAS,EAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,UAAW,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;IAEnC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAA,0BAAW,EAAC;YAChC,OAAO;YACP,MAAM;YACN,GAAG;YACH,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;YAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,CAAC,KAA0C,EAAE,EAAE;gBACzD,IAAI,MAAM,CAAC,MAAM;oBAAE,OAAO;gBAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;oBAAE,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACtE,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,mBAAmB,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,UAAW,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/cli/argv.d.ts

@@ -0,0 +1,35 @@
+import { PackageConfig, NpmdataExtractEntry } from '../types';
+/**
+ * Parsed CLI flags for all commands.
+ */
+export type ParsedArgv = {
+    packages?: PackageConfig[];
+    output?: string;
+    files?: string[];
+    contentRegexes?: string[];
+    presets?: string[];
+    force: boolean;
+    keepExisting: boolean;
+    noGitignore: boolean;
+    unmanaged: boolean;
+    dryRun: boolean;
+    upgrade: boolean;
+    silent: boolean;
+    verbose: boolean;
+};
+/**
+ * Parse all supported CLI flags from an argv array.
+ * Validates mutually exclusive combinations and throws on invalid input.
+ */
+export declare function parseArgv(argv: string[]): ParsedArgv;
+/**
+ * Build NpmdataExtractEntry objects from --packages + --output CLI flags.
+ * Returns null if --packages is not set.
+ */
+export declare function buildEntriesFromArgv(parsed: ParsedArgv): NpmdataExtractEntry[] | null;
+/**
+ * Apply CLI overrides from ParsedArgv to each NpmdataExtractEntry.
+ * CLI flags always take precedence over config file values.
+ */
+export declare function applyArgvOverrides(entries: NpmdataExtractEntry[], parsed: ParsedArgv): NpmdataExtractEntry[];
+//# sourceMappingURL=argv.d.ts.map

package/dist/cli/argv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argv.d.ts","sourceRoot":"","sources":["../../src/cli/argv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAgC,MAAM,UAAU,CAAC;AAG5F;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAiDpD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,mBAAmB,EAAE,GAAG,IAAI,CA4BrF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAAE,EAC9B,MAAM,EAAE,UAAU,GACjB,mBAAmB,EAAE,CA+BvB"}