@vltpkg/cli-sdk 0.0.0-9 → 1.0.0-rc.10

package/dist/esm/output.d.ts

@@ -1,20 +1,14 @@
+import { styleText as utilStyleText } from 'node:util';
 import type { LoadedConfig } from './config/index.ts';
 import type { Command } from './index.ts';
 import type { View, Views } from './view.ts';
 export declare const stdout: (...args: unknown[]) => void;
 export declare const stderr: (...args: unknown[]) => void;
+type StyleTextFn = (format: Parameters<typeof utilStyleText>[0], s: string) => string;
+export declare let styleTextStdout: StyleTextFn;
+export declare let styleTextStderr: StyleTextFn;
 export declare const getView: <T>(conf: LoadedConfig, views?: Views<T>) => View<T>;
-export type OnDone<T> = ((result: T) => Promise<unknown>) | ((result: T) => unknown);
-/**
- * If the view is a View class, then instantiate and start it.
- * If it's a view function, then just define the onDone method.
- */
-export declare const startView: <T>(conf: LoadedConfig, views?: Views<T>, { start }?: {
-    start: number;
-}) => {
-    onDone: OnDone<T>;
-    onError?: (err: unknown) => void;
-};
+export type OnDone<T> = (result: T) => Promise<unknown>;
 /**
  * Main export. Run the command appropriately, displaying output using
  * the user-requested view, or the default if the user requested a view
@@ -23,4 +17,5 @@ export declare const startView: <T>(conf: LoadedConfig, views?: Views<T>, { star
 export declare const outputCommand: <T>(cliCommand: Command<T>, conf: LoadedConfig, { start }?: {
     start: number;
 }) => Promise<void>;
+export {};
 //# sourceMappingURL=output.d.ts.map

package/dist/esm/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/output.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAK5C,eAAO,MAAM,MAAM,YAAa,OAAO,EAAE,SAAyB,CAAA;AAElE,eAAO,MAAM,MAAM,YAAa,OAAO,EAAE,SAA2B,CAAA;AAIpE,eAAO,MAAM,OAAO,GAAI,CAAC,QACjB,YAAY,UACV,KAAK,CAAC,CAAC,CAAC,KACf,IAAI,CAAC,CAAC,CAmBR,CAAA;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,IAChB,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GACjC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,CAAA;AAE5B;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,QACnB,YAAY,UACV,KAAK,CAAC,CAAC,CAAC,cACL;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,KAC3B;IACD,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IACjB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CA2BjC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAU,CAAC,cACvB,OAAO,CAAC,CAAC,CAAC,QAChB,YAAY,cACP;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,kBAiC7B,CAAA"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/output.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,SAAS,IAAI,aAAa,EAC3B,MAAM,WAAW,CAAA;AAGlB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,OAAO,KAAK,EAAE,IAAI,EAAe,KAAK,EAAE,MAAM,WAAW,CAAA;AAezD,eAAO,MAAM,MAAM,YAAa,OAAO,EAAE,SAAyB,CAAA;AAElE,eAAO,MAAM,MAAM,YAAa,OAAO,EAAE,SAA2B,CAAA;AAEpE,KAAK,WAAW,GAAG,CACjB,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,EAC3C,CAAC,EAAE,MAAM,KACN,MAAM,CAAA;AASX,eAAO,IAAI,eAAe,EAAE,WAAyB,CAAA;AACrD,eAAO,IAAI,eAAe,EAAE,WAAyB,CAAA;AAKrD,eAAO,MAAM,OAAO,GAAI,CAAC,QACjB,YAAY,UACV,KAAK,CAAC,CAAC,CAAC,KACf,IAAI,CAAC,CAAC,CA2BR,CAAA;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAsCvD;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAU,CAAC,cACvB,OAAO,CAAC,CAAC,CAAC,QAChB,YAAY,cACP;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,kBA6D7B,CAAA"}

package/dist/esm/output.js

@@ -1,24 +1,45 @@
-import chalk from 'chalk';
-import { formatWithOptions } from 'node:util';
+import { formatWithOptions, styleText as utilStyleText, } from 'node:util';
+import { createSupportsColor } from 'supports-color';
 import { defaultView } from "./config/definition.js";
-import { printErr } from "./print-err.js";
+import { printErr, formatOptions } from "./print-err.js";
 import { isViewClass } from "./view.js";
-// TODO: make these have log levels etc
+import { generateDefaultHelp, generateFullHelp, } from "./custom-help.js";
+const supportsColor = (stream) => {
+    const res = createSupportsColor(stream, { sniffFlags: false });
+    if (res === false)
+        return false;
+    /* c8 ignore next */
+    return res.level > 0;
+};
 // eslint-disable-next-line no-console
 export const stdout = (...args) => console.log(...args);
 // eslint-disable-next-line no-console
 export const stderr = (...args) => console.error(...args);
+/* c8 ignore start */
+const styleText = (f, s) => utilStyleText(f, s, { validateStream: false });
+/* c8 ignore stop */
+// TODO: stop exporting mutable variables once exec output is refactored
+/* c8 ignore start */
+export let styleTextStdout = (_, s) => s;
+export let styleTextStderr = (_, s) => s;
+/* c8 ignore stop */
 const identity = (x) => x;
 export const getView = (conf, views) => {
     const viewName = conf.values.view;
     const viewFn = viewName === 'inspect' ? identity
-        : typeof views === 'function' ? views
-            : views && typeof views === 'object' ? views[viewName]
-                : identity;
-    // if the user specified a view that doesn't exist,
-    // then set it back to the default, and try again.
-    // This will fall back to identity if it's also missing.
-    if (!viewFn && conf.values.view !== defaultView) {
+        : viewName === 'silent' ? () => undefined
+            : typeof views === 'function' ? views
+                : views && typeof views === 'object' ? views[viewName]
+                    : identity;
+    // if the user specified a view that doesn't exist, then set it back to the
+    // default, and try again. This will fall back to identity if it's also
+    // missing. We also always treat 'json' as a valid view that falls back to
+    // identity. This allows the explicit use of `--view=json` to work even
+    // when the default view is `human`.
+    if (!viewFn &&
+        conf.values.view !== defaultView &&
+        conf.values.view !== 'json' &&
+        conf.values.view !== 'silent') {
         conf.values.view = defaultView;
         process.env.VLT_VIEW = defaultView;
         return getView(conf, views);
@@ -29,16 +50,13 @@ export const getView = (conf, views) => {
  * If the view is a View class, then instantiate and start it.
  * If it's a view function, then just define the onDone method.
  */
-export const startView = (conf, views, { start } = { start: Date.now() }) => {
+const startView = (conf, opts, views, { start } = { start: Date.now() }) => {
     const View = getView(conf, views);
-    const opts = {
-        colors: conf.values.color ? chalk : undefined,
-    };
     if (isViewClass(View)) {
         const view = new View(opts, conf);
         view.start();
         return {
-            onDone(r) {
+            async onDone(r) {
                 return view.done(r, { time: Date.now() - start });
             },
             onError(err) {
@@ -61,28 +79,47 @@ export const startView = (conf, views, { start } = { start: Date.now() }) => {
  */
 export const outputCommand = async (cliCommand, conf, { start } = { start: Date.now() }) => {
     const { usage, views, command } = cliCommand;
-    if (conf.get('help')) {
+    const stdoutColor = conf.values.color ?? supportsColor(process.stdout);
+    const stderrColor = conf.values.color ?? supportsColor(process.stderr);
+    if (conf.values.help) {
+        // Show custom help for main vlt command
+        /* c8 ignore start */
+        if (conf.command === 'help' && conf.positionals.length === 0) {
+            if (conf.get('all')) {
+                return stdout(generateFullHelp(stdoutColor));
+            }
+            return stdout(generateDefaultHelp(stdoutColor));
+        }
+        /* c8 ignore stop */
         return stdout(usage().usage());
     }
-    const formatOptions = {
-        colors: conf.values.color,
-        depth: Infinity,
-        maxArrayLength: Infinity,
-        maxStringLength: Infinity,
-    };
-    const { onDone, onError } = startView(conf, views, { start });
+    /* c8 ignore start */
+    if (stdoutColor)
+        styleTextStdout = styleText;
+    if (stderrColor)
+        styleTextStderr = styleText;
+    /* c8 ignore stop */
+    const { onDone, onError } = startView(conf, 
+    // assume views will always output to stdout so use color support from there
+    { colors: stdoutColor }, views, { start });
     try {
         const output = await onDone(await command(conf));
-        if (output !== undefined) {
+        if (output !== undefined && conf.values.view !== 'silent') {
             stdout(conf.values.view === 'json' ?
                 JSON.stringify(output, null, 2)
-                : formatWithOptions(formatOptions, output));
+                : formatWithOptions({
+                    ...formatOptions,
+                    colors: stdoutColor,
+                }, output));
         }
     }
     catch (err) {
         onError?.(err);
         process.exitCode ||= 1;
-        printErr(err, usage, stderr, formatOptions);
+        printErr(err, usage, stderr, {
+            ...formatOptions,
+            colors: stderrColor,
+        });
         process.exit(process.exitCode);
     }
 };

package/dist/esm/output.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/output.ts"],"names":[],"mappings":"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","sourcesContent":["import chalk from 'chalk'\nimport { formatWithOptions } from 'node:util'\nimport type { InspectOptions } from 'node:util'\nimport { defaultView } from './config/definition.ts'\nimport type { LoadedConfig } from './config/index.ts'\nimport type { Command } from './index.ts'\nimport { printErr } from './print-err.ts'\nimport type { View, Views } from './view.ts'\nimport { isViewClass } from './view.ts'\n\n// TODO: make these have log levels etc\n// eslint-disable-next-line no-console\nexport const stdout = (...args: unknown[]) => console.log(...args)\n// eslint-disable-next-line no-console\nexport const stderr = (...args: unknown[]) => console.error(...args)\n\nconst identity = <T>(x: T): T => x\n\nexport const getView = <T>(\n  conf: LoadedConfig,\n  views?: Views<T>,\n): View<T> => {\n  const viewName = conf.values.view\n\n  const viewFn =\n    viewName === 'inspect' ? identity\n    : typeof views === 'function' ? views\n    : views && typeof views === 'object' ? views[viewName]\n    : identity\n\n  // if the user specified a view that doesn't exist,\n  // then set it back to the default, and try again.\n  // This will fall back to identity if it's also missing.\n  if (!viewFn && conf.values.view !== defaultView) {\n    conf.values.view = defaultView\n    process.env.VLT_VIEW = defaultView\n    return getView(conf, views)\n  }\n\n  return viewFn ?? identity\n}\n\nexport type OnDone<T> =\n  | ((result: T) => Promise<unknown>)\n  | ((result: T) => unknown)\n\n/**\n * If the view is a View class, then instantiate and start it.\n * If it's a view function, then just define the onDone method.\n */\nexport const startView = <T>(\n  conf: LoadedConfig,\n  views?: Views<T>,\n  { start }: { start: number } = { start: Date.now() },\n): {\n  onDone: OnDone<T>\n  onError?: (err: unknown) => void\n} => {\n  const View = getView<T>(conf, views)\n\n  const opts = {\n    colors: conf.values.color ? chalk : undefined,\n  }\n\n  if (isViewClass(View)) {\n    const view = new View(opts, conf)\n    view.start()\n    return {\n      onDone(r) {\n        return view.done(r, { time: Date.now() - start })\n      },\n      onError(err) {\n        view.error(err)\n      },\n    }\n  }\n\n  return {\n    async onDone(r) {\n      if (r === undefined) return\n      return View(r, opts, conf)\n    },\n  }\n}\n\n/**\n * Main export. Run the command appropriately, displaying output using\n * the user-requested view, or the default if the user requested a view\n * that is not defined for this command.\n */\nexport const outputCommand = async <T>(\n  cliCommand: Command<T>,\n  conf: LoadedConfig,\n  { start }: { start: number } = { start: Date.now() },\n) => {\n  const { usage, views, command } = cliCommand\n  if (conf.get('help')) {\n    return stdout(usage().usage())\n  }\n\n  const formatOptions = {\n    colors: conf.values.color,\n    depth: Infinity,\n    maxArrayLength: Infinity,\n    maxStringLength: Infinity,\n  } as const satisfies InspectOptions\n\n  const { onDone, onError } = startView(conf, views, { start })\n\n  try {\n    const output = await onDone(await command(conf))\n    if (output !== undefined) {\n      stdout(\n        conf.values.view === 'json' ?\n          JSON.stringify(output, null, 2)\n        : formatWithOptions(formatOptions, output),\n      )\n    }\n  } catch (err) {\n    onError?.(err)\n    process.exitCode ||= 1\n\n    printErr(err, usage, stderr, formatOptions)\n\n    process.exit(process.exitCode)\n  }\n}\n"]}
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/output.ts"],"names":[],"mappings":"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","sourcesContent":["import type { WriteStream } from 'node:tty'\nimport {\n  formatWithOptions,\n  styleText as utilStyleText,\n} from 'node:util'\nimport { createSupportsColor } from 'supports-color'\nimport { defaultView } from './config/definition.ts'\nimport type { LoadedConfig } from './config/index.ts'\nimport type { Command } from './index.ts'\nimport { printErr, formatOptions } from './print-err.ts'\nimport type { View, ViewOptions, Views } from './view.ts'\nimport { isViewClass } from './view.ts'\nimport {\n  generateDefaultHelp,\n  generateFullHelp,\n} from './custom-help.ts'\n\nconst supportsColor = (stream: WriteStream) => {\n  const res = createSupportsColor(stream, { sniffFlags: false })\n  if (res === false) return false\n  /* c8 ignore next */\n  return res.level > 0\n}\n\n// eslint-disable-next-line no-console\nexport const stdout = (...args: unknown[]) => console.log(...args)\n// eslint-disable-next-line no-console\nexport const stderr = (...args: unknown[]) => console.error(...args)\n\ntype StyleTextFn = (\n  format: Parameters<typeof utilStyleText>[0],\n  s: string,\n) => string\n\n/* c8 ignore start */\nconst styleText: StyleTextFn = (f, s) =>\n  utilStyleText(f, s, { validateStream: false })\n/* c8 ignore stop */\n\n// TODO: stop exporting mutable variables once exec output is refactored\n/* c8 ignore start */\nexport let styleTextStdout: StyleTextFn = (_, s) => s\nexport let styleTextStderr: StyleTextFn = (_, s) => s\n/* c8 ignore stop */\n\nconst identity = <T>(x: T): T => x\n\nexport const getView = <T>(\n  conf: LoadedConfig,\n  views?: Views<T>,\n): View<T> => {\n  const viewName = conf.values.view\n\n  const viewFn =\n    viewName === 'inspect' ? identity\n    : viewName === 'silent' ? () => undefined\n    : typeof views === 'function' ? views\n    : views && typeof views === 'object' ? views[viewName]\n    : identity\n\n  // if the user specified a view that doesn't exist, then set it back to the\n  // default, and try again. This will fall back to identity if it's also\n  // missing. We also always treat 'json' as a valid view that falls back to\n  // identity. This allows the explicit use of `--view=json` to work even\n  // when the default view is `human`.\n  if (\n    !viewFn &&\n    conf.values.view !== defaultView &&\n    conf.values.view !== 'json' &&\n    conf.values.view !== 'silent'\n  ) {\n    conf.values.view = defaultView\n    process.env.VLT_VIEW = defaultView\n    return getView(conf, views)\n  }\n\n  return viewFn ?? identity\n}\n\nexport type OnDone<T> = (result: T) => Promise<unknown>\n\n/**\n * If the view is a View class, then instantiate and start it.\n * If it's a view function, then just define the onDone method.\n */\nconst startView = <T>(\n  conf: LoadedConfig,\n  opts: ViewOptions,\n  views?: Views<T>,\n  { start }: { start: number } = { start: Date.now() },\n): {\n  onDone: OnDone<T>\n  onError?: (err: unknown) => void\n} => {\n  const View = getView<T>(conf, views)\n\n  if (isViewClass(View)) {\n    const view = new View(opts, conf)\n    view.start()\n    return {\n      async onDone(r) {\n        return view.done(r, { time: Date.now() - start })\n      },\n      onError(err) {\n        view.error(err)\n      },\n    }\n  }\n\n  return {\n    async onDone(r) {\n      if (r === undefined) return\n      return View(r, opts, conf)\n    },\n  }\n}\n\n/**\n * Main export. Run the command appropriately, displaying output using\n * the user-requested view, or the default if the user requested a view\n * that is not defined for this command.\n */\nexport const outputCommand = async <T>(\n  cliCommand: Command<T>,\n  conf: LoadedConfig,\n  { start }: { start: number } = { start: Date.now() },\n) => {\n  const { usage, views, command } = cliCommand\n\n  const stdoutColor =\n    conf.values.color ?? supportsColor(process.stdout)\n  const stderrColor =\n    conf.values.color ?? supportsColor(process.stderr)\n\n  if (conf.values.help) {\n    // Show custom help for main vlt command\n    /* c8 ignore start */\n    if (conf.command === 'help' && conf.positionals.length === 0) {\n      if (conf.get('all')) {\n        return stdout(generateFullHelp(stdoutColor))\n      }\n      return stdout(generateDefaultHelp(stdoutColor))\n    }\n    /* c8 ignore stop */\n    return stdout(usage().usage())\n  }\n\n  /* c8 ignore start */\n  if (stdoutColor) styleTextStdout = styleText\n  if (stderrColor) styleTextStderr = styleText\n  /* c8 ignore stop */\n\n  const { onDone, onError } = startView(\n    conf,\n    // assume views will always output to stdout so use color support from there\n    { colors: stdoutColor },\n    views,\n    { start },\n  )\n\n  try {\n    const output = await onDone(await command(conf))\n    if (output !== undefined && conf.values.view !== 'silent') {\n      stdout(\n        conf.values.view === 'json' ?\n          JSON.stringify(output, null, 2)\n        : formatWithOptions(\n            {\n              ...formatOptions,\n              colors: stdoutColor,\n            },\n            output,\n          ),\n      )\n    }\n  } catch (err) {\n    onError?.(err)\n    process.exitCode ||= 1\n\n    printErr(err, usage, stderr, {\n      ...formatOptions,\n      colors: stderrColor,\n    })\n\n    process.exit(process.exitCode)\n  }\n}\n"]}

package/dist/esm/pack-tarball.d.ts

@@ -0,0 +1,22 @@
+import type { NormalizedManifest } from '@vltpkg/types';
+import type { LoadedConfig } from './config/index.ts';
+export type PackTarballResult = {
+    name: string;
+    version: string;
+    filename: string;
+    tarballName: string;
+    tarballData: Buffer;
+    unpackedSize: number;
+    files: string[];
+    integrity?: string;
+    shasum?: string;
+};
+/**
+ * Create a tarball from a package directory
+ * @param {NormalizedManifest} manifest - The manifest of the package to pack
+ * @param {string} dir - The directory containing the package to pack
+ * @param {LoadedConfig} [config] - The loaded configuration (for workspace/catalog resolution)
+ * @returns {Promise<PackTarballResult>} The manifest, filename, and tarball data (unless dry run)
+ */
+export declare const packTarball: (manifest: NormalizedManifest, dir: string, config: LoadedConfig) => Promise<PackTarballResult>;
+//# sourceMappingURL=pack-tarball.d.ts.map

package/dist/esm/pack-tarball.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-tarball.d.ts","sourceRoot":"","sources":["../../src/pack-tarball.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAQvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIrD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAwHD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,aACZ,kBAAkB,OACvB,MAAM,UACH,YAAY,KACnB,OAAO,CAAC,iBAAiB,CAsN3B,CAAA"}

package/dist/esm/pack-tarball.js

@@ -0,0 +1,249 @@
+import { create as tarCreate, list as tarList } from 'tar';
+import { minimatch } from 'minimatch';
+import { error } from '@vltpkg/error-cause';
+import * as ssri from 'ssri';
+import assert from 'node:assert';
+import { existsSync, statSync } from 'node:fs';
+import { Spec } from '@vltpkg/spec';
+import { join } from 'node:path';
+import { parse, stringify } from 'polite-json';
+/**
+ * Replace workspace: and catalog: specs with actual versions
+ * @param {NormalizedManifest} manifest_ - The manifest to process
+ * @param {LoadedConfig} config - The loaded configuration containing project root, monorepo, and catalog data
+ * @returns {NormalizedManifest} The manifest with replaced specs
+ */
+const replaceWorkspaceAndCatalogSpecs = (manifest_, config) => {
+    // Create a json copy of the manifest to avoid modifying the original
+    // preserves original formatting symbols from polite-json
+    const manifest = parse(stringify(manifest_));
+    // Get workspace and catalog configuration from config
+    const { monorepo, catalog = {}, catalogs = {} } = config.options;
+    // Process dependency types
+    const depTypes = [
+        'dependencies',
+        'devDependencies',
+        'optionalDependencies',
+        'peerDependencies',
+    ];
+    for (const depType of depTypes) {
+        const deps = manifest[depType];
+        /* c8 ignore next */
+        if (!deps || typeof deps !== 'object')
+            continue;
+        const depsObj = deps;
+        for (const [depName, depSpec] of Object.entries(depsObj)) {
+            /* c8 ignore next */
+            if (typeof depSpec !== 'string')
+                continue;
+            const spec = Spec.parse(`${depName}@${depSpec}`, {
+                catalog,
+                catalogs,
+            });
+            switch (spec.type) {
+                case 'workspace': {
+                    assert(monorepo, error(`No workspace configuration found for ${depName}`, {
+                        found: depName,
+                    }));
+                    const workspaceName = spec.workspace;
+                    assert(workspaceName, error(`No workspace name found for ${depName}`, {
+                        found: depName,
+                    }));
+                    const workspace = monorepo.get(workspaceName);
+                    assert(workspace, error(`Workspace '${workspaceName}' not found`, {
+                        found: workspaceName,
+                        validOptions: Array.from(monorepo.keys()),
+                    }));
+                    const actualVersion = workspace.manifest.version;
+                    assert(actualVersion, error(`No version found for workspace '${workspaceName}'`, {
+                        found: workspaceName,
+                        wanted: 'package version',
+                    }));
+                    depsObj[depName] = actualVersion;
+                    break;
+                }
+                case 'catalog': {
+                    const catalogName = spec.catalog || '';
+                    const targetCatalog = catalogName ? catalogs[catalogName] : catalog;
+                    assert(targetCatalog, error(`Catalog '${catalogName}' not found`, {
+                        found: catalogName,
+                        validOptions: Object.keys(catalogs),
+                    }));
+                    const actualVersion = targetCatalog[depName];
+                    assert(actualVersion, error(`Package '${depName}' not found in catalog '${catalogName || 'default'}'`, {
+                        found: depName,
+                        validOptions: Object.keys(targetCatalog),
+                    }));
+                    depsObj[depName] = actualVersion;
+                    break;
+                }
+            }
+        }
+    }
+    return manifest;
+};
+/**
+ * Create a tarball from a package directory
+ * @param {NormalizedManifest} manifest - The manifest of the package to pack
+ * @param {string} dir - The directory containing the package to pack
+ * @param {LoadedConfig} [config] - The loaded configuration (for workspace/catalog resolution)
+ * @returns {Promise<PackTarballResult>} The manifest, filename, and tarball data (unless dry run)
+ */
+export const packTarball = async (manifest, dir, config) => {
+    let packDir = dir;
+    // Check if publishDirectory is configured
+    const publishDirectory = config.get('publish-directory');
+    if (publishDirectory) {
+        // Validate that the publish directory exists and is a directory
+        assert(existsSync(publishDirectory), error(`Publish directory does not exist: ${publishDirectory}`, {
+            found: publishDirectory,
+        }));
+        assert(statSync(publishDirectory).isDirectory(), error(`Publish directory is not a directory: ${publishDirectory}`, {
+            found: publishDirectory,
+            wanted: 'directory',
+        }));
+        if (existsSync(join(publishDirectory, 'package.json'))) {
+            manifest = config.options.packageJson.read(publishDirectory);
+        }
+        packDir = publishDirectory;
+    }
+    assert(manifest.name && manifest.version, error('Package must have a name and version'));
+    const processedManifest = replaceWorkspaceAndCatalogSpecs(manifest, config);
+    const filename = `${manifest.name.replace('@', '').replace('/', '-')}-${manifest.version}.tgz`;
+    const tarballName = `${manifest.name}-${manifest.version}.tgz`;
+    try {
+        config.options.packageJson.write(packDir, processedManifest);
+        const tarballData = await tarCreate({
+            cwd: packDir,
+            gzip: true,
+            portable: true,
+            prefix: 'package/',
+            filter: (path) => {
+                // Normalize path - remove leading './'
+                const normalizedPath = path.replace(/^\.\//, '');
+                // Always include root directory
+                if (path === '.' || normalizedPath === '') {
+                    return true;
+                }
+                // Always exclude certain files/directories
+                const alwaysExcludePatterns = [
+                    /^\.?\/?\.git(\/|$)/,
+                    /^\.?\/?node_modules(\/|$)/,
+                    /^\.?\/?\.nyc_output(\/|$)/,
+                    /^\.?\/?coverage(\/|$)/,
+                    /^\.?\/?\.DS_Store$/,
+                    /^\.?\/?\.npmrc$/,
+                    /^\.?\/?package-lock\.json$/,
+                    /^\.?\/?yarn\.lock$/,
+                    /^\.?\/?pnpm-lock\.yaml$/,
+                    /^\.?\/?bun\.lockb$/,
+                    /^\.?\/?bun\.lock$/,
+                    /^\.?\/?vlt-lock\.json$/,
+                    /~$/,
+                    /\.swp$/,
+                ];
+                if (alwaysExcludePatterns.some(pattern => pattern.test(normalizedPath))) {
+                    return false;
+                }
+                // Always include certain files
+                const alwaysIncludePatterns = [
+                    /^README(\..*)?$/i,
+                    /^CHANGELOG(\..*)?$/i,
+                    /^HISTORY(\..*)?$/i,
+                    /^LICENSE(\..*)?$/i,
+                    /^LICENCE(\..*)?$/i,
+                ];
+                if (alwaysIncludePatterns.some(pattern => pattern.test(normalizedPath))) {
+                    return true;
+                }
+                // Always include package.json
+                if (normalizedPath === 'package.json') {
+                    return true;
+                }
+                // If files field is specified in package.json, use it for inclusion
+                const manifestWithFiles = manifest;
+                if (manifestWithFiles.files &&
+                    Array.isArray(manifestWithFiles.files)) {
+                    // Empty files array means exclude everything except always-included files
+                    if (manifestWithFiles.files.length === 0) {
+                        return false;
+                    }
+                    return manifestWithFiles.files.some((pattern) => {
+                        if (pattern.endsWith('/')) {
+                            const dirName = pattern.slice(0, -1);
+                            const globPattern = pattern.replace(/\/$/, '/**');
+                            const matchesDir = normalizedPath === dirName;
+                            const matchesContents = minimatch(normalizedPath, globPattern, {
+                                dot: true,
+                            });
+                            return matchesDir || matchesContents;
+                        }
+                        // File pattern: check direct match and if this path is a directory that could contain the pattern
+                        const directMatch = minimatch(normalizedPath, pattern, {
+                            dot: true,
+                        });
+                        // Check if this path is a directory that could contain the pattern
+                        const isParentDir = pattern.includes('/') &&
+                            pattern.startsWith(normalizedPath + '/');
+                        return directMatch || isParentDir;
+                    });
+                }
+                // Default behavior when no files field - exclude common development files
+                const defaultExcludePatterns = [
+                    /^\.?\/?\.vscode(\/|$)/,
+                    /^\.?\/?\.idea(\/|$)/,
+                    /^\.?\/?\.gitignore$/,
+                    /^\.?\/?\.npmignore$/,
+                    /^\.?\/?\.editorconfig$/,
+                ];
+                return !defaultExcludePatterns.some(pattern => pattern.test(normalizedPath));
+            },
+        }, ['.']).concat();
+        let unpackedSize = 0;
+        const files = [];
+        await new Promise((resolve, reject) => {
+            const stream = tarList({
+                onentry: entry => {
+                    if (entry.type === 'File') {
+                        unpackedSize += entry.size;
+                        // Remove the package/ prefix for cleaner file listing
+                        const cleanPath = entry.path.replace(/^[^/]+\//, '');
+                        if (cleanPath) {
+                            // Skip empty paths
+                            files.push(cleanPath);
+                        }
+                    }
+                },
+            });
+            stream
+                .on('end', () => resolve())
+                .on('error', reject)
+                .write(tarballData);
+            stream.end();
+        });
+        const integrityMap = ssri.fromData(tarballData, {
+            algorithms: [...new Set(['sha1', 'sha512'])],
+        });
+        // eslint-disable-next-line @typescript-eslint/no-base-to-string
+        const integrity = integrityMap.sha512?.[0]?.toString();
+        // @ts-expect-error -- types from DT are missing hexDigest
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+        const shasum = integrityMap.sha1?.[0]?.hexDigest();
+        return {
+            name: manifest.name,
+            version: manifest.version,
+            filename,
+            tarballName,
+            tarballData,
+            unpackedSize,
+            files,
+            integrity,
+            shasum,
+        };
+    }
+    finally {
+        // Restore the original package.json to the pack directory
+        config.options.packageJson.write(packDir, manifest);
+    }
+};
+//# sourceMappingURL=pack-tarball.js.map

package/dist/esm/pack-tarball.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-tarball.js","sourceRoot":"","sources":["../../src/pack-tarball.ts"],"names":[],"mappings":"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","sourcesContent":["import type { NormalizedManifest } from '@vltpkg/types'\nimport { create as tarCreate, list as tarList } from 'tar'\nimport { minimatch } from 'minimatch'\nimport { error } from '@vltpkg/error-cause'\nimport * as ssri from 'ssri'\nimport assert from 'node:assert'\nimport { existsSync, statSync } from 'node:fs'\nimport { Spec } from '@vltpkg/spec'\nimport type { LoadedConfig } from './config/index.ts'\nimport { join } from 'node:path'\nimport { parse, stringify } from 'polite-json'\n\nexport type PackTarballResult = {\n  name: string\n  version: string\n  filename: string\n  tarballName: string\n  tarballData: Buffer\n  unpackedSize: number\n  files: string[]\n  integrity?: string\n  shasum?: string\n}\n\n/**\n * Replace workspace: and catalog: specs with actual versions\n * @param {NormalizedManifest} manifest_ - The manifest to process\n * @param {LoadedConfig} config - The loaded configuration containing project root, monorepo, and catalog data\n * @returns {NormalizedManifest} The manifest with replaced specs\n */\nconst replaceWorkspaceAndCatalogSpecs = (\n  manifest_: NormalizedManifest,\n  config: LoadedConfig,\n): NormalizedManifest => {\n  // Create a json copy of the manifest to avoid modifying the original\n  // preserves original formatting symbols from polite-json\n  const manifest = parse(stringify(manifest_)) as NormalizedManifest\n\n  // Get workspace and catalog configuration from config\n  const { monorepo, catalog = {}, catalogs = {} } = config.options\n\n  // Process dependency types\n  const depTypes = [\n    'dependencies',\n    'devDependencies',\n    'optionalDependencies',\n    'peerDependencies',\n  ] as const\n\n  for (const depType of depTypes) {\n    const deps = manifest[depType]\n    /* c8 ignore next */\n    if (!deps || typeof deps !== 'object') continue\n\n    const depsObj = deps as Record<string, unknown>\n    for (const [depName, depSpec] of Object.entries(depsObj)) {\n      /* c8 ignore next */\n      if (typeof depSpec !== 'string') continue\n\n      const spec = Spec.parse(`${depName}@${depSpec}`, {\n        catalog,\n        catalogs,\n      })\n\n      switch (spec.type) {\n        case 'workspace': {\n          assert(\n            monorepo,\n            error(`No workspace configuration found for ${depName}`, {\n              found: depName,\n            }),\n          )\n\n          const workspaceName = spec.workspace\n          assert(\n            workspaceName,\n            error(`No workspace name found for ${depName}`, {\n              found: depName,\n            }),\n          )\n\n          const workspace = monorepo.get(workspaceName)\n          assert(\n            workspace,\n            error(`Workspace '${workspaceName}' not found`, {\n              found: workspaceName,\n              validOptions: Array.from(monorepo.keys()),\n            }),\n          )\n\n          const actualVersion = workspace.manifest.version\n          assert(\n            actualVersion,\n            error(\n              `No version found for workspace '${workspaceName}'`,\n              {\n                found: workspaceName,\n                wanted: 'package version',\n              },\n            ),\n          )\n\n          depsObj[depName] = actualVersion\n\n          break\n        }\n\n        case 'catalog': {\n          const catalogName = spec.catalog || ''\n          const targetCatalog =\n            catalogName ? catalogs[catalogName] : catalog\n          assert(\n            targetCatalog,\n            error(`Catalog '${catalogName}' not found`, {\n              found: catalogName,\n              validOptions: Object.keys(catalogs),\n            }),\n          )\n\n          const actualVersion = targetCatalog[depName]\n          assert(\n            actualVersion,\n            error(\n              `Package '${depName}' not found in catalog '${catalogName || 'default'}'`,\n              {\n                found: depName,\n                validOptions: Object.keys(targetCatalog),\n              },\n            ),\n          )\n\n          depsObj[depName] = actualVersion\n\n          break\n        }\n      }\n    }\n  }\n\n  return manifest\n}\n\n/**\n * Create a tarball from a package directory\n * @param {NormalizedManifest} manifest - The manifest of the package to pack\n * @param {string} dir - The directory containing the package to pack\n * @param {LoadedConfig} [config] - The loaded configuration (for workspace/catalog resolution)\n * @returns {Promise<PackTarballResult>} The manifest, filename, and tarball data (unless dry run)\n */\nexport const packTarball = async (\n  manifest: NormalizedManifest,\n  dir: string,\n  config: LoadedConfig,\n): Promise<PackTarballResult> => {\n  let packDir = dir\n\n  // Check if publishDirectory is configured\n  const publishDirectory = config.get('publish-directory')\n  if (publishDirectory) {\n    // Validate that the publish directory exists and is a directory\n    assert(\n      existsSync(publishDirectory),\n      error(`Publish directory does not exist: ${publishDirectory}`, {\n        found: publishDirectory,\n      }),\n    )\n    assert(\n      statSync(publishDirectory).isDirectory(),\n      error(\n        `Publish directory is not a directory: ${publishDirectory}`,\n        {\n          found: publishDirectory,\n          wanted: 'directory',\n        },\n      ),\n    )\n    if (existsSync(join(publishDirectory, 'package.json'))) {\n      manifest = config.options.packageJson.read(publishDirectory)\n    }\n    packDir = publishDirectory\n  }\n\n  assert(\n    manifest.name && manifest.version,\n    error('Package must have a name and version'),\n  )\n\n  const processedManifest = replaceWorkspaceAndCatalogSpecs(\n    manifest,\n    config,\n  )\n\n  const filename = `${manifest.name.replace('@', '').replace('/', '-')}-${manifest.version}.tgz`\n  const tarballName = `${manifest.name}-${manifest.version}.tgz`\n\n  try {\n    config.options.packageJson.write(packDir, processedManifest)\n\n    const tarballData = await tarCreate(\n      {\n        cwd: packDir,\n        gzip: true,\n        portable: true,\n        prefix: 'package/',\n        filter: (path: string) => {\n          // Normalize path - remove leading './'\n          const normalizedPath = path.replace(/^\\.\\//, '')\n\n          // Always include root directory\n          if (path === '.' || normalizedPath === '') {\n            return true\n          }\n\n          // Always exclude certain files/directories\n          const alwaysExcludePatterns = [\n            /^\\.?\\/?\\.git(\\/|$)/,\n            /^\\.?\\/?node_modules(\\/|$)/,\n            /^\\.?\\/?\\.nyc_output(\\/|$)/,\n            /^\\.?\\/?coverage(\\/|$)/,\n            /^\\.?\\/?\\.DS_Store$/,\n            /^\\.?\\/?\\.npmrc$/,\n            /^\\.?\\/?package-lock\\.json$/,\n            /^\\.?\\/?yarn\\.lock$/,\n            /^\\.?\\/?pnpm-lock\\.yaml$/,\n            /^\\.?\\/?bun\\.lockb$/,\n            /^\\.?\\/?bun\\.lock$/,\n            /^\\.?\\/?vlt-lock\\.json$/,\n            /~$/,\n            /\\.swp$/,\n          ]\n\n          if (\n            alwaysExcludePatterns.some(pattern =>\n              pattern.test(normalizedPath),\n            )\n          ) {\n            return false\n          }\n\n          // Always include certain files\n          const alwaysIncludePatterns = [\n            /^README(\\..*)?$/i,\n            /^CHANGELOG(\\..*)?$/i,\n            /^HISTORY(\\..*)?$/i,\n            /^LICENSE(\\..*)?$/i,\n            /^LICENCE(\\..*)?$/i,\n          ]\n\n          if (\n            alwaysIncludePatterns.some(pattern =>\n              pattern.test(normalizedPath),\n            )\n          ) {\n            return true\n          }\n\n          // Always include package.json\n          if (normalizedPath === 'package.json') {\n            return true\n          }\n\n          // If files field is specified in package.json, use it for inclusion\n          const manifestWithFiles = manifest as NormalizedManifest & {\n            files?: string[]\n          }\n          if (\n            manifestWithFiles.files &&\n            Array.isArray(manifestWithFiles.files)\n          ) {\n            // Empty files array means exclude everything except always-included files\n            if (manifestWithFiles.files.length === 0) {\n              return false\n            }\n            return manifestWithFiles.files.some((pattern: string) => {\n              if (pattern.endsWith('/')) {\n                const dirName = pattern.slice(0, -1)\n                const globPattern = pattern.replace(/\\/$/, '/**')\n                const matchesDir = normalizedPath === dirName\n                const matchesContents = minimatch(\n                  normalizedPath,\n                  globPattern,\n                  {\n                    dot: true,\n                  },\n                )\n                return matchesDir || matchesContents\n              }\n\n              // File pattern: check direct match and if this path is a directory that could contain the pattern\n              const directMatch = minimatch(normalizedPath, pattern, {\n                dot: true,\n              })\n              // Check if this path is a directory that could contain the pattern\n              const isParentDir =\n                pattern.includes('/') &&\n                pattern.startsWith(normalizedPath + '/')\n              return directMatch || isParentDir\n            })\n          }\n\n          // Default behavior when no files field - exclude common development files\n          const defaultExcludePatterns = [\n            /^\\.?\\/?\\.vscode(\\/|$)/,\n            /^\\.?\\/?\\.idea(\\/|$)/,\n            /^\\.?\\/?\\.gitignore$/,\n            /^\\.?\\/?\\.npmignore$/,\n            /^\\.?\\/?\\.editorconfig$/,\n          ]\n\n          return !defaultExcludePatterns.some(pattern =>\n            pattern.test(normalizedPath),\n          )\n        },\n      },\n      ['.'],\n    ).concat()\n\n    let unpackedSize = 0\n    const files: string[] = []\n    await new Promise<void>((resolve, reject) => {\n      const stream = tarList({\n        onentry: entry => {\n          if (entry.type === 'File') {\n            unpackedSize += entry.size\n            // Remove the package/ prefix for cleaner file listing\n            const cleanPath = entry.path.replace(/^[^/]+\\//, '')\n            if (cleanPath) {\n              // Skip empty paths\n              files.push(cleanPath)\n            }\n          }\n        },\n      })\n      stream\n        .on('end', () => resolve())\n        .on('error', reject)\n        .write(tarballData)\n      stream.end()\n    })\n\n    const integrityMap = ssri.fromData(tarballData, {\n      algorithms: [...new Set(['sha1', 'sha512'])],\n    })\n\n    // eslint-disable-next-line @typescript-eslint/no-base-to-string\n    const integrity = integrityMap.sha512?.[0]?.toString()\n    // @ts-expect-error -- types from DT are missing hexDigest\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-call\n    const shasum = integrityMap.sha1?.[0]?.hexDigest() as\n      | string\n      | undefined\n\n    return {\n      name: manifest.name,\n      version: manifest.version,\n      filename,\n      tarballName,\n      tarballData,\n      unpackedSize,\n      files,\n      integrity,\n      shasum,\n    }\n  } finally {\n    // Restore the original package.json to the pack directory\n    config.options.packageJson.write(packDir, manifest)\n  }\n}\n"]}

package/dist/esm/parse-add-remove-args.d.ts

@@ -1,3 +1,4 @@
+import type { PathScurry } from 'path-scurry';
 import type { AddImportersDependenciesMap, RemoveImportersDependenciesMap } from '@vltpkg/graph';
 import type { Monorepo } from '@vltpkg/workspaces';
 import type { LoadedConfig } from './config/index.ts';
@@ -17,6 +18,12 @@ export type WorkspaceTypes = {
     workspace?: string[];
     'workspace-group'?: string[];
 };
-export declare const parseAddArgs: (config: LoadedConfig, monorepo?: Monorepo) => ParsedAddArgs;
-export declare const parseRemoveArgs: (config: LoadedConfig, monorepo?: Monorepo) => ParsedRemoveArgs;
+/**
+ * Parses the positional arguments into {@link AddImportersDependenciesMap}.
+ */
+export declare const parseAddArgs: (config: LoadedConfig, scurry: PathScurry, monorepo?: Monorepo) => ParsedAddArgs;
+/**
+ * Parses the positional arguments into {@link RemoveImportersDependenciesMap}.
+ */
+export declare const parseRemoveArgs: (config: LoadedConfig, scurry: PathScurry, monorepo?: Monorepo) => ParsedRemoveArgs;
 //# sourceMappingURL=parse-add-remove-args.d.ts.map

package/dist/esm/parse-add-remove-args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-add-remove-args.d.ts","sourceRoot":"","sources":["../../src/parse-add-remove-args.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,2BAA2B,EAE3B,8BAA8B,EAC/B,MAAM,eAAe,CAAA;AAKtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,2BAA2B,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,8BAA8B,CAAA;CACvC,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC7B,CAAA;AAqDD,eAAO,MAAM,YAAY,WACf,YAAY,aACT,QAAQ,KAClB,aA4BF,CAAA;AAED,eAAO,MAAM,eAAe,WAClB,YAAY,aACT,QAAQ,KAClB,gBAaF,CAAA"}
+{"version":3,"file":"parse-add-remove-args.d.ts","sourceRoot":"","sources":["../../src/parse-add-remove-args.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,OAAO,KAAK,EACV,2BAA2B,EAE3B,8BAA8B,EAC/B,MAAM,eAAe,CAAA;AAGtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,2BAA2B,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,8BAA8B,CAAA;CACvC,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC7B,CAAA;AAgED;;GAEG;AACH,eAAO,MAAM,YAAY,WACf,YAAY,UACZ,UAAU,aACP,QAAQ,KAClB,aAuCF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,WAClB,YAAY,UACZ,UAAU,aACP,QAAQ,KAClB,gBAoBF,CAAA"}