@storm-software/bun-tools 0.0.7

package/dist/helpers/package-json.d.cts

@@ -0,0 +1,44 @@
+import { WorkspacePackageJson } from '../types.cjs';
+
+/**
+ * Retrieve the path to the workspace root `package.json` file.
+ *
+ * @param workspaceRoot - The root directory of the workspace. Defaults to the result of `findWorkspaceRoot(process.cwd())`.
+ * @returns The absolute path to the workspace root `package.json` file.
+ * @throws Will throw an error if the `package.json` file is not found.
+ */
+declare function getRootPackageJsonPath(workspaceRoot?: string): string;
+/**
+ * Read the workspace root `package.json` file.
+ *
+ * @param workspaceRoot - The root directory of the workspace. Defaults to the result of `findWorkspaceRoot(process.cwd())`.
+ * @returns A promise that resolves to the parsed `package.json` object.
+ */
+declare function readRootPackageJson(workspaceRoot?: string): Promise<WorkspacePackageJson | undefined>;
+/**
+ * Retrieve the catalog from a workspace root `package.json` file.
+ *
+ * Bun supports catalogs at the top level or within a `workspaces` object.
+ *
+ * @param packageJson - The parsed workspace root `package.json` object.
+ * @returns The catalog object if found, or undefined if no catalog exists.
+ */
+declare function getCatalogFromPackageJson(packageJson: WorkspacePackageJson): Record<string, string> | undefined;
+/**
+ * Set the catalog on a workspace root `package.json` object.
+ *
+ * Updates the existing catalog location when present, otherwise writes to the top-level `catalog` field.
+ *
+ * @param packageJson - The parsed workspace root `package.json` object.
+ * @param catalog - The catalog object to set.
+ */
+declare function setCatalogInPackageJson(packageJson: WorkspacePackageJson, catalog: Record<string, string>): void;
+/**
+ * Write the workspace root `package.json` file.
+ *
+ * @param packageJson - The parsed workspace root `package.json` object.
+ * @param workspaceRoot - The root directory of the workspace. Defaults to the result of `findWorkspaceRoot(process.cwd())`.
+ */
+declare function writeRootPackageJson(packageJson: WorkspacePackageJson, workspaceRoot?: string): Promise<void>;
+
+export { getCatalogFromPackageJson, getRootPackageJsonPath, readRootPackageJson, setCatalogInPackageJson, writeRootPackageJson };

package/dist/helpers/package-json.d.ts

@@ -0,0 +1,44 @@
+import { WorkspacePackageJson } from '../types.js';
+
+/**
+ * Retrieve the path to the workspace root `package.json` file.
+ *
+ * @param workspaceRoot - The root directory of the workspace. Defaults to the result of `findWorkspaceRoot(process.cwd())`.
+ * @returns The absolute path to the workspace root `package.json` file.
+ * @throws Will throw an error if the `package.json` file is not found.
+ */
+declare function getRootPackageJsonPath(workspaceRoot?: string): string;
+/**
+ * Read the workspace root `package.json` file.
+ *
+ * @param workspaceRoot - The root directory of the workspace. Defaults to the result of `findWorkspaceRoot(process.cwd())`.
+ * @returns A promise that resolves to the parsed `package.json` object.
+ */
+declare function readRootPackageJson(workspaceRoot?: string): Promise<WorkspacePackageJson | undefined>;
+/**
+ * Retrieve the catalog from a workspace root `package.json` file.
+ *
+ * Bun supports catalogs at the top level or within a `workspaces` object.
+ *
+ * @param packageJson - The parsed workspace root `package.json` object.
+ * @returns The catalog object if found, or undefined if no catalog exists.
+ */
+declare function getCatalogFromPackageJson(packageJson: WorkspacePackageJson): Record<string, string> | undefined;
+/**
+ * Set the catalog on a workspace root `package.json` object.
+ *
+ * Updates the existing catalog location when present, otherwise writes to the top-level `catalog` field.
+ *
+ * @param packageJson - The parsed workspace root `package.json` object.
+ * @param catalog - The catalog object to set.
+ */
+declare function setCatalogInPackageJson(packageJson: WorkspacePackageJson, catalog: Record<string, string>): void;
+/**
+ * Write the workspace root `package.json` file.
+ *
+ * @param packageJson - The parsed workspace root `package.json` object.
+ * @param workspaceRoot - The root directory of the workspace. Defaults to the result of `findWorkspaceRoot(process.cwd())`.
+ */
+declare function writeRootPackageJson(packageJson: WorkspacePackageJson, workspaceRoot?: string): Promise<void>;
+
+export { getCatalogFromPackageJson, getRootPackageJsonPath, readRootPackageJson, setCatalogInPackageJson, writeRootPackageJson };

package/dist/helpers/package-json.js

@@ -0,0 +1 @@
+export{j as getCatalogFromPackageJson,h as getRootPackageJsonPath,i as readRootPackageJson,k as setCatalogInPackageJson,l as writeRootPackageJson}from'../chunk-JXISZBJG.js';

package/dist/helpers/replace-deps-aliases.cjs

@@ -0,0 +1 @@
+'use strict';var chunkCEGV7WAH_cjs=require('../chunk-CEGV7WAH.cjs');require('../chunk-QOVB4LRJ.cjs'),require('../chunk-WAL5SD4G.cjs'),require('../chunk-SAEQEYN6.cjs');Object.defineProperty(exports,"replaceDepsAliases",{enumerable:true,get:function(){return chunkCEGV7WAH_cjs.a}});

package/dist/helpers/replace-deps-aliases.d.cts

@@ -0,0 +1,11 @@
+/**
+ * Update package.json dependencies currently using `catalog:` or `workspace:*` to use the workspace catalog dependencies actual versions and the local workspace versions respectively.
+ *
+ * @param packageRoot - The root directory of the package to update. Defaults to the current working directory.
+ * @param workspaceRoot - The root directory of the workspace. Defaults to the result of `findWorkspaceRoot(packageRoot)`.
+ * @returns A promise that resolves when the package.json file has been updated.
+ * @throws Will throw an error if no package.json file is found in the package root, or if a dependency is marked as `catalog:` but no catalog exists.
+ */
+declare function replaceDepsAliases(packageRoot?: string, workspaceRoot?: string): Promise<void>;
+
+export { replaceDepsAliases };

package/dist/helpers/replace-deps-aliases.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Update package.json dependencies currently using `catalog:` or `workspace:*` to use the workspace catalog dependencies actual versions and the local workspace versions respectively.
+ *
+ * @param packageRoot - The root directory of the package to update. Defaults to the current working directory.
+ * @param workspaceRoot - The root directory of the workspace. Defaults to the result of `findWorkspaceRoot(packageRoot)`.
+ * @returns A promise that resolves when the package.json file has been updated.
+ * @throws Will throw an error if no package.json file is found in the package root, or if a dependency is marked as `catalog:` but no catalog exists.
+ */
+declare function replaceDepsAliases(packageRoot?: string, workspaceRoot?: string): Promise<void>;
+
+export { replaceDepsAliases };

package/dist/helpers/replace-deps-aliases.js

@@ -0,0 +1 @@
+export{a as replaceDepsAliases}from'../chunk-U3RZMO6L.js';import'../chunk-RBC53R6W.js';import'../chunk-7QKHH2VM.js';import'../chunk-JXISZBJG.js';

package/dist/helpers/workspace.cjs

@@ -0,0 +1 @@
+'use strict';var chunkD55VRNVR_cjs=require('../chunk-D55VRNVR.cjs');require('../chunk-SAEQEYN6.cjs');Object.defineProperty(exports,"getWorkspaceFilePath",{enumerable:true,get:function(){return chunkD55VRNVR_cjs.a}});Object.defineProperty(exports,"readWorkspaceFile",{enumerable:true,get:function(){return chunkD55VRNVR_cjs.b}});Object.defineProperty(exports,"writeWorkspaceFile",{enumerable:true,get:function(){return chunkD55VRNVR_cjs.c}});

package/dist/helpers/workspace.d.cts

@@ -0,0 +1,26 @@
+import { WorkspacePackageJson } from '../types.cjs';
+
+/**
+ * Retrieve the path to the workspace root `package.json` file.
+ *
+ * @param workspaceRoot - The root directory of the workspace. Defaults to the result of `findWorkspaceRoot(process.cwd())`.
+ * @returns The absolute path to the workspace root `package.json` file.
+ * @throws Will throw an error if the `package.json` file is not found.
+ */
+declare function getWorkspaceFilePath(workspaceRoot?: string): string;
+/**
+ * Read workspace catalog and package globs from the workspace root `package.json` file.
+ *
+ * @param workspaceRoot - The root directory of the workspace. Defaults to the result of `findWorkspaceRoot(process.cwd())`.
+ * @returns A promise that resolves to the workspace catalog and package globs if found.
+ */
+declare function readWorkspaceFile(workspaceRoot?: string): Promise<WorkspacePackageJson | undefined>;
+/**
+ * Write workspace catalog and package globs to the workspace root `package.json` file.
+ *
+ * @param workspaceFile - The workspace catalog and package globs to write.
+ * @param workspaceRoot - The root directory of the workspace. Defaults to the result of `findWorkspaceRoot(process.cwd())`.
+ */
+declare function writeWorkspaceFile(workspaceFile: WorkspacePackageJson, workspaceRoot?: string): Promise<void>;
+
+export { getWorkspaceFilePath, readWorkspaceFile, writeWorkspaceFile };

package/dist/helpers/workspace.d.ts

@@ -0,0 +1,26 @@
+import { WorkspacePackageJson } from '../types.js';
+
+/**
+ * Retrieve the path to the workspace root `package.json` file.
+ *
+ * @param workspaceRoot - The root directory of the workspace. Defaults to the result of `findWorkspaceRoot(process.cwd())`.
+ * @returns The absolute path to the workspace root `package.json` file.
+ * @throws Will throw an error if the `package.json` file is not found.
+ */
+declare function getWorkspaceFilePath(workspaceRoot?: string): string;
+/**
+ * Read workspace catalog and package globs from the workspace root `package.json` file.
+ *
+ * @param workspaceRoot - The root directory of the workspace. Defaults to the result of `findWorkspaceRoot(process.cwd())`.
+ * @returns A promise that resolves to the workspace catalog and package globs if found.
+ */
+declare function readWorkspaceFile(workspaceRoot?: string): Promise<WorkspacePackageJson | undefined>;
+/**
+ * Write workspace catalog and package globs to the workspace root `package.json` file.
+ *
+ * @param workspaceFile - The workspace catalog and package globs to write.
+ * @param workspaceRoot - The root directory of the workspace. Defaults to the result of `findWorkspaceRoot(process.cwd())`.
+ */
+declare function writeWorkspaceFile(workspaceFile: WorkspacePackageJson, workspaceRoot?: string): Promise<void>;
+
+export { getWorkspaceFilePath, readWorkspaceFile, writeWorkspaceFile };

package/dist/helpers/workspace.js

@@ -0,0 +1 @@
+export{a as getWorkspaceFilePath,b as readWorkspaceFile,c as writeWorkspaceFile}from'../chunk-NNTG4CIZ.js';import'../chunk-JXISZBJG.js';

package/dist/index.cjs

@@ -0,0 +1 @@
+'use strict';require('./chunk-SFZRYJZ2.cjs'),require('./chunk-3CHW2FOO.cjs');var chunkCEGV7WAH_cjs=require('./chunk-CEGV7WAH.cjs'),chunkQOVB4LRJ_cjs=require('./chunk-QOVB4LRJ.cjs');require('./chunk-WAL5SD4G.cjs');var chunkD55VRNVR_cjs=require('./chunk-D55VRNVR.cjs'),chunkSAEQEYN6_cjs=require('./chunk-SAEQEYN6.cjs');Object.defineProperty(exports,"replaceDepsAliases",{enumerable:true,get:function(){return chunkCEGV7WAH_cjs.a}});Object.defineProperty(exports,"getCatalog",{enumerable:true,get:function(){return chunkQOVB4LRJ_cjs.b}});Object.defineProperty(exports,"getCatalogSafe",{enumerable:true,get:function(){return chunkQOVB4LRJ_cjs.a}});Object.defineProperty(exports,"saveCatalog",{enumerable:true,get:function(){return chunkQOVB4LRJ_cjs.e}});Object.defineProperty(exports,"setCatalog",{enumerable:true,get:function(){return chunkQOVB4LRJ_cjs.c}});Object.defineProperty(exports,"upgradeCatalog",{enumerable:true,get:function(){return chunkQOVB4LRJ_cjs.d}});Object.defineProperty(exports,"getWorkspaceFilePath",{enumerable:true,get:function(){return chunkD55VRNVR_cjs.a}});Object.defineProperty(exports,"readWorkspaceFile",{enumerable:true,get:function(){return chunkD55VRNVR_cjs.b}});Object.defineProperty(exports,"writeWorkspaceFile",{enumerable:true,get:function(){return chunkD55VRNVR_cjs.c}});Object.defineProperty(exports,"getCatalogFromPackageJson",{enumerable:true,get:function(){return chunkSAEQEYN6_cjs.j}});Object.defineProperty(exports,"getRootPackageJsonPath",{enumerable:true,get:function(){return chunkSAEQEYN6_cjs.h}});Object.defineProperty(exports,"readRootPackageJson",{enumerable:true,get:function(){return chunkSAEQEYN6_cjs.i}});Object.defineProperty(exports,"setCatalogInPackageJson",{enumerable:true,get:function(){return chunkSAEQEYN6_cjs.k}});Object.defineProperty(exports,"writeRootPackageJson",{enumerable:true,get:function(){return chunkSAEQEYN6_cjs.l}});

package/dist/index.d.cts

@@ -0,0 +1,5 @@
+export { UpgradeCatalogPackageOptions, UpgradeCatalogResult, getCatalog, getCatalogSafe, saveCatalog, setCatalog, upgradeCatalog } from './helpers/catalog.cjs';
+export { getCatalogFromPackageJson, getRootPackageJsonPath, readRootPackageJson, setCatalogInPackageJson, writeRootPackageJson } from './helpers/package-json.cjs';
+export { replaceDepsAliases } from './helpers/replace-deps-aliases.cjs';
+export { getWorkspaceFilePath, readWorkspaceFile, writeWorkspaceFile } from './helpers/workspace.cjs';
+export { WorkspacePackageJson } from './types.cjs';

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { UpgradeCatalogPackageOptions, UpgradeCatalogResult, getCatalog, getCatalogSafe, saveCatalog, setCatalog, upgradeCatalog } from './helpers/catalog.js';
+export { getCatalogFromPackageJson, getRootPackageJsonPath, readRootPackageJson, setCatalogInPackageJson, writeRootPackageJson } from './helpers/package-json.js';
+export { replaceDepsAliases } from './helpers/replace-deps-aliases.js';
+export { getWorkspaceFilePath, readWorkspaceFile, writeWorkspaceFile } from './helpers/workspace.js';
+export { WorkspacePackageJson } from './types.js';

package/dist/index.js

@@ -0,0 +1 @@
+import'./chunk-GGNOJ77I.js';import'./chunk-PJBAL7AE.js';export{a as replaceDepsAliases}from'./chunk-U3RZMO6L.js';export{b as getCatalog,a as getCatalogSafe,e as saveCatalog,c as setCatalog,d as upgradeCatalog}from'./chunk-RBC53R6W.js';import'./chunk-7QKHH2VM.js';export{a as getWorkspaceFilePath,b as readWorkspaceFile,c as writeWorkspaceFile}from'./chunk-NNTG4CIZ.js';export{j as getCatalogFromPackageJson,h as getRootPackageJsonPath,i as readRootPackageJson,k as setCatalogInPackageJson,l as writeRootPackageJson}from'./chunk-JXISZBJG.js';

package/dist/types.cjs

@@ -0,0 +1 @@
+'use strict';require('./chunk-SFZRYJZ2.cjs');

package/dist/types.d.cts

@@ -0,0 +1,14 @@
+/**
+ * Type definition for the workspace root `package.json` file.
+ */
+interface WorkspacePackageJson {
+    catalog?: Record<string, string>;
+    workspaces?: string[] | {
+        packages?: string[];
+        catalog?: Record<string, string>;
+        catalogs?: Record<string, Record<string, string>>;
+    };
+    [key: string]: unknown;
+}
+
+export type { WorkspacePackageJson };

package/dist/types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Type definition for the workspace root `package.json` file.
+ */
+interface WorkspacePackageJson {
+    catalog?: Record<string, string>;
+    workspaces?: string[] | {
+        packages?: string[];
+        catalog?: Record<string, string>;
+        catalogs?: Record<string, Record<string, string>>;
+    };
+    [key: string]: unknown;
+}
+
+export type { WorkspacePackageJson };

package/dist/types.js

@@ -0,0 +1 @@
+import'./chunk-GGNOJ77I.js';

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@storm-software/bun-tools",
+  "version": "0.0.7",
+  "private": false,
+  "description": "A set of [Bun](https://bun.sh/) plugins and utilities for managing workspace packages/dependencies.",
+  "repository": {
+    "type": "github",
+    "url": "https://github.com/storm-software/storm-ops.git",
+    "directory": "packages/bun-tools"
+  },
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    "./index": {
+      "import": { "types": "./dist/index.d.ts", "default": "./dist/index.js" },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "default": { "types": "./dist/index.d.ts", "default": "./dist/index.js" }
+    },
+    ".": {
+      "import": { "types": "./dist/index.d.ts", "default": "./dist/index.js" },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "default": { "types": "./dist/index.d.ts", "default": "./dist/index.js" }
+    },
+    "./types": {
+      "import": { "types": "./dist/types.d.ts", "default": "./dist/types.js" },
+      "require": {
+        "types": "./dist/types.d.cts",
+        "default": "./dist/types.cjs"
+      },
+      "default": { "types": "./dist/types.d.ts", "default": "./dist/types.js" }
+    },
+    "./helpers": {
+      "import": {
+        "types": "./dist/helpers/index.d.ts",
+        "default": "./dist/helpers/index.js"
+      },
+      "require": {
+        "types": "./dist/helpers/index.d.cts",
+        "default": "./dist/helpers/index.cjs"
+      },
+      "default": {
+        "types": "./dist/helpers/index.d.ts",
+        "default": "./dist/helpers/index.js"
+      }
+    },
+    "./helpers/*": {
+      "import": {
+        "types": "./dist/helpers/*.d.ts",
+        "default": "./dist/helpers/*.js"
+      },
+      "require": {
+        "types": "./dist/helpers/*.d.cts",
+        "default": "./dist/helpers/*.cjs"
+      },
+      "default": {
+        "types": "./dist/helpers/*.d.ts",
+        "default": "./dist/helpers/*.js"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "storm-bun": "./bin/bun.js",
+    "storm-bun-cjs": "./bin/bun.cjs",
+    "storm-bun-esm": "./bin/bun.js"
+  },
+  "dependencies": {
+    "@storm-software/config": "^1.138.35",
+    "@storm-software/config-tools": "^1.190.98",
+    "@storm-software/npm-tools": "^0.6.216",
+    "@storm-software/package-constants": "^0.1.111",
+    "chalk": "^4.1.2",
+    "commander": "^12.1.0",
+    "defu": "^6.1.7",
+    "prettier": "^3.9.5",
+    "prettier-plugin-packagejson": "^3.0.2",
+    "semver": "^7.8.5",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@pnpm/types": "^1001.3.1",
+    "@types/node": "^25.9.5",
+    "tsup": "8.4.0"
+  },
+  "publishConfig": { "access": "public" },
+  "gitHead": "752dcf7147a8e553e9f0375e33cacd3711b2a34b"
+}