@fastkit/plugboy 0.3.0 → 1.0.0-next.0

package/dist/plugboy.mjs

@@ -1,103 +1,3 @@
-import {
-  Builder,
-  PROJECT_REQUIRED_FIELDS,
-  Path,
-  PlugboyProject,
-  PlugboyWorkspace,
-  TSUP_SYNC_OPTIONS,
-  WORKSPACE_PACKAGE_SYNC_FIELDS,
-  WORKSPACE_REQUIRED_FIELDS,
-  buildHooks,
-  copyDirSync,
-  createHooksDefaults,
-  definePlugin,
-  defineProjectConfig,
-  defineWorkspaceConfig,
-  exposeEntries,
-  extractProjectPlugins,
-  findConfig,
-  findFile,
-  findProjectPlugin,
-  findWorkspacePackages,
-  generateWorkspace,
-  getDirname,
-  getFilename,
-  getProject,
-  getProjectPackageJson,
-  getWorkspace,
-  getWorkspacePackageJson,
-  isFileNotFoundException,
-  isProjectPackageJson,
-  isPromise,
-  isWorkspacePackageJson,
-  loadProjectConfig,
-  loadWorkspaceConfig,
-  mergeDTSSettingsList,
-  normalizeDTSPreserveTypeSettings,
-  normalizeDTSPreserveTypeTarget,
-  normalizeDTSSettings,
-  pathExists,
-  resolveListable,
-  resolveOptimizeCSSOptions,
-  resolveRawExposeEntriesSettings,
-  resolveRawWorkspaceEntries,
-  resolveRawWorkspaceEntry,
-  resolveUserHooks,
-  resolveUserPluginOptions,
-  resolveUserProjectConfig,
-  resolveUserWorkspaceConfig,
-  rmrf,
-  syncWorkspacePackageFields
-} from "./chunk-IDJLTVUE.mjs";
-export {
-  Builder,
-  PROJECT_REQUIRED_FIELDS,
-  Path,
-  PlugboyProject,
-  PlugboyWorkspace,
-  TSUP_SYNC_OPTIONS,
-  WORKSPACE_PACKAGE_SYNC_FIELDS,
-  WORKSPACE_REQUIRED_FIELDS,
-  buildHooks,
-  copyDirSync,
-  createHooksDefaults,
-  definePlugin,
-  defineProjectConfig,
-  defineWorkspaceConfig,
-  exposeEntries,
-  extractProjectPlugins,
-  findConfig,
-  findFile,
-  findProjectPlugin,
-  findWorkspacePackages,
-  generateWorkspace,
-  getDirname,
-  getFilename,
-  getProject,
-  getProjectPackageJson,
-  getWorkspace,
-  getWorkspacePackageJson,
-  isFileNotFoundException,
-  isProjectPackageJson,
-  isPromise,
-  isWorkspacePackageJson,
-  loadProjectConfig,
-  loadWorkspaceConfig,
-  mergeDTSSettingsList,
-  normalizeDTSPreserveTypeSettings,
-  normalizeDTSPreserveTypeTarget,
-  normalizeDTSSettings,
-  pathExists,
-  resolveListable,
-  resolveOptimizeCSSOptions,
-  resolveRawExposeEntriesSettings,
-  resolveRawWorkspaceEntries,
-  resolveRawWorkspaceEntry,
-  resolveUserHooks,
-  resolveUserPluginOptions,
-  resolveUserProjectConfig,
-  resolveUserWorkspaceConfig,
-  rmrf,
-  syncWorkspacePackageFields
-};
-//# sourceMappingURL=plugboy.mjs.map
+import { $ as normalizeDTSSettings, A as resolveRawExposeEntriesSettings, B as exitHook, C as findProjectPlugin, D as loadProjectConfig, E as isProjectPackageJson, F as getFilename, G as resolveListable, H as mergeExternals, I as isFileNotFoundException, J as WORKSPACE_REQUIRED_FIELDS, K as PROJECT_REQUIRED_FIELDS, L as pathExists, M as findConfig, N as findFile, O as resolveUserProjectConfig, P as getDirname, Q as normalizeDTSPreserveTypeTarget, R as rmrf, S as extractProjectPlugins, T as defineProjectConfig, U as mergeNoExternals, V as mergeChunkAddons, W as isPromise, X as mergeDTSSettingsList, Y as resolveOptimizeCSSOptions, Z as normalizeDTSPreserveTypeSettings, _ as loadWorkspaceConfig, a as syncWorkspacePackageFields, b as resolveUserWorkspaceConfig, c as Builder, d as getWorkspacePackageJson, et as createHooksDefaults, f as Path, g as isWorkspacePackageJson, h as defineWorkspaceConfig, i as getWorkspace, j as copyDirSync, k as exposeEntries, l as findWorkspacePackages, m as resolveUserHooks, n as PlugboyWorkspace, o as PlugboyProject, p as buildHooks, q as TSDOWN_SYNC_OPTIONS, r as WORKSPACE_PACKAGE_SYNC_FIELDS, s as getProject, t as generateWorkspace, u as getProjectPackageJson, v as resolveRawWorkspaceEntries, w as resolveUserPluginOption, x as definePlugin, y as resolveRawWorkspaceEntry, z as writeFileAtomic } from "./workspace-BqcryYAT.mjs";
+
+export { Builder, PROJECT_REQUIRED_FIELDS, Path, PlugboyProject, PlugboyWorkspace, TSDOWN_SYNC_OPTIONS, WORKSPACE_PACKAGE_SYNC_FIELDS, WORKSPACE_REQUIRED_FIELDS, buildHooks, copyDirSync, createHooksDefaults, definePlugin, defineProjectConfig, defineWorkspaceConfig, exitHook, exposeEntries, extractProjectPlugins, findConfig, findFile, findProjectPlugin, findWorkspacePackages, generateWorkspace, getDirname, getFilename, getProject, getProjectPackageJson, getWorkspace, getWorkspacePackageJson, isFileNotFoundException, isProjectPackageJson, isPromise, isWorkspacePackageJson, loadProjectConfig, loadWorkspaceConfig, mergeChunkAddons, mergeDTSSettingsList, mergeExternals, mergeNoExternals, normalizeDTSPreserveTypeSettings, normalizeDTSPreserveTypeTarget, normalizeDTSSettings, pathExists, resolveListable, resolveOptimizeCSSOptions, resolveRawExposeEntriesSettings, resolveRawWorkspaceEntries, resolveRawWorkspaceEntry, resolveUserHooks, resolveUserPluginOption, resolveUserProjectConfig, resolveUserWorkspaceConfig, rmrf, syncWorkspacePackageFields, writeFileAtomic };

package/dist/runtime-utils.d.mts

@@ -0,0 +1,28 @@
+//#region src/runtime-utils/path.d.ts
+/**
+ * Returns the absolute file path of the calling file.
+ *
+ * @param {number} depth - 1 = immediate caller, 2 = caller's caller, etc.
+ * @returns {string} Absolute file path of the caller.
+ * @throws {CallerFileError} If the caller file cannot be determined.
+ */
+declare function getCallerFile(depth?: number): string;
+/**
+ * Returns the absolute file path of the calling file.
+ *
+ * @param {number} depth - 1 = immediate caller, 2 = caller's caller, etc.
+ * @returns {string} Absolute file path of the caller.
+ * @throws {CallerFileError} If the caller file cannot be determined.
+ */
+declare function getCallerFilePath(depth?: number): string;
+/**
+ * Returns the directory that contains the package.json
+ * associated with the specified import.meta.url.
+ *
+ * If no package.json is found while walking up the directory tree,
+ * an error will be thrown.
+ */
+declare function getPackageDir(callerFilePath?: string): Promise<string>;
+//#endregion
+export { getCallerFile, getCallerFilePath, getPackageDir };
+//# sourceMappingURL=runtime-utils.d.mts.map

package/dist/runtime-utils.mjs

@@ -0,0 +1,94 @@
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { stat } from "node:fs/promises";
+
+//#region src/runtime-utils/path.ts
+/**
+* Universal ESM function to get the file path of the caller.
+* Works in Node.js, Deno, and Bun (native ESM environments).
+*
+* - Uses V8 structured stack traces when available (Node/Bun).
+* - Falls back to string-based stack parsing when necessary (e.g., Deno).
+* - Throws a descriptive error when the file path cannot be determined.
+*/
+var CallerFileError = class extends Error {
+	info;
+	constructor(message, info = {}) {
+		super(message);
+		this.name = "CallerFileError";
+		this.info = info;
+	}
+};
+/**
+* Returns the absolute file path of the calling file.
+*
+* @param {number} depth - 1 = immediate caller, 2 = caller's caller, etc.
+* @returns {string} Absolute file path of the caller.
+* @throws {CallerFileError} If the caller file cannot be determined.
+*/
+function getCallerFile(depth = 1) {
+	if (typeof depth !== "number" || depth < 1) throw new CallerFileError("Invalid depth argument", { depth });
+	try {
+		const originalPrepare = Error.prepareStackTrace;
+		Error.prepareStackTrace = (_, structuredStackTrace) => structuredStackTrace;
+		const { stack } = /* @__PURE__ */ new Error();
+		Error.prepareStackTrace = originalPrepare;
+		if (Array.isArray(stack)) {
+			const frame = stack[depth];
+			if (frame && typeof frame.getFileName === "function") {
+				const file = frame.getFileName();
+				if (typeof file === "string") return file;
+				throw new CallerFileError("CallSite#getFileName() returned null", { frame });
+			} else throw new CallerFileError("Invalid or missing CallSite object", { frame });
+		} else throw new CallerFileError("Structured stack trace unavailable", { stack });
+	} catch (v8Error) {
+		try {
+			const stackStr = (/* @__PURE__ */ new Error()).stack;
+			if (typeof stackStr !== "string") throw new CallerFileError("Error.stack is not a string", { stack: stackStr });
+			const lines = stackStr.split("\n").map((l) => l.trim()).filter(Boolean);
+			const index = 1 + depth;
+			if (index >= lines.length) throw new CallerFileError("Stack trace too shallow", { lines });
+			const line = lines[index];
+			const match = line.match(/(file:\/\/[^\s)]+)/) || line.match(/(\/[^:\s)]+)(:\d+){0,2}/) || line.match(/([A-Za-z]:\\[^:\s)]+)(:\d+){0,2}/);
+			if (!match) throw new CallerFileError("No file path pattern found in stack line", { line });
+			const raw = match[1];
+			if (raw.startsWith("file://")) return new URL(raw).pathname;
+			return raw.replace(/:\d+(:\d+)?$/, "");
+		} catch (fallbackError) {
+			if (fallbackError instanceof CallerFileError) throw fallbackError;
+			throw new CallerFileError("Fallback stack parsing failed", { cause: fallbackError });
+		}
+	}
+}
+/**
+* Returns the absolute file path of the calling file.
+*
+* @param {number} depth - 1 = immediate caller, 2 = caller's caller, etc.
+* @returns {string} Absolute file path of the caller.
+* @throws {CallerFileError} If the caller file cannot be determined.
+*/
+function getCallerFilePath(depth = 1) {
+	const file = getCallerFile(depth + 1);
+	return file.startsWith("file:") ? fileURLToPath(file) : file;
+}
+/**
+* Returns the directory that contains the package.json
+* associated with the specified import.meta.url.
+*
+* If no package.json is found while walking up the directory tree,
+* an error will be thrown.
+*/
+async function getPackageDir(callerFilePath = getCallerFilePath()) {
+	let dir = dirname(callerFilePath);
+	while (true) {
+		if (await stat(join(dir, "package.json")).then(() => true).catch(() => false)) return dir;
+		const parent = dirname(dir);
+		if (parent === dir) break;
+		dir = parent;
+	}
+	throw new Error(`package.json not found for: ${callerFilePath}`);
+}
+
+//#endregion
+export { getCallerFile, getCallerFilePath, getPackageDir };
+//# sourceMappingURL=runtime-utils.mjs.map

package/dist/runtime-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-utils.mjs","names":[],"sources":["../src/runtime-utils/path.ts"],"sourcesContent":["import { stat } from 'node:fs/promises';\nimport { join, dirname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\n/**\n * Universal ESM function to get the file path of the caller.\n * Works in Node.js, Deno, and Bun (native ESM environments).\n *\n * - Uses V8 structured stack traces when available (Node/Bun).\n * - Falls back to string-based stack parsing when necessary (e.g., Deno).\n * - Throws a descriptive error when the file path cannot be determined.\n */\n\nclass CallerFileError extends Error {\n  info: unknown;\n  constructor(message: string, info: unknown = {}) {\n    super(message);\n    this.name = 'CallerFileError';\n    this.info = info;\n  }\n}\n\n/**\n * Returns the absolute file path of the calling file.\n *\n * @param {number} depth - 1 = immediate caller, 2 = caller's caller, etc.\n * @returns {string} Absolute file path of the caller.\n * @throws {CallerFileError} If the caller file cannot be determined.\n */\nexport function getCallerFile(depth = 1) {\n  if (typeof depth !== 'number' || depth < 1) {\n    throw new CallerFileError('Invalid depth argument', { depth });\n  }\n\n  // --- Primary method: V8 structured stack trace (Node.js / Bun) ---\n  try {\n    const originalPrepare = Error.prepareStackTrace;\n    Error.prepareStackTrace = (_, structuredStackTrace) => structuredStackTrace;\n    const err = new Error();\n    const { stack } = err;\n    Error.prepareStackTrace = originalPrepare;\n\n    if (Array.isArray(stack)) {\n      const frame = stack[depth];\n      if (frame && typeof frame.getFileName === 'function') {\n        const file = frame.getFileName();\n        if (typeof file === 'string') return file;\n        throw new CallerFileError('CallSite#getFileName() returned null', {\n          frame,\n        });\n      } else {\n        throw new CallerFileError('Invalid or missing CallSite object', {\n          frame,\n        });\n      }\n    } else {\n      throw new CallerFileError('Structured stack trace unavailable', {\n        stack,\n      });\n    }\n  } catch (v8Error) {\n    // --- Fallback: plain text stack parsing (Deno and others) ---\n    try {\n      const stackStr = new Error().stack;\n      if (typeof stackStr !== 'string') {\n        throw new CallerFileError('Error.stack is not a string', {\n          stack: stackStr,\n        });\n      }\n\n      const lines = stackStr\n        .split('\\n')\n        .map((l) => l.trim())\n        .filter(Boolean);\n      const index = 1 + depth;\n      if (index >= lines.length) {\n        throw new CallerFileError('Stack trace too shallow', { lines });\n      }\n\n      const line = lines[index];\n\n      // Match file URLs or absolute paths\n      const match =\n        line.match(/(file:\\/\\/[^\\s)]+)/) ||\n        line.match(/(\\/[^:\\s)]+)(:\\d+){0,2}/) ||\n        line.match(/([A-Za-z]:\\\\[^:\\s)]+)(:\\d+){0,2}/);\n\n      if (!match) {\n        throw new CallerFileError('No file path pattern found in stack line', {\n          line,\n        });\n      }\n\n      const raw = match[1];\n      if (raw.startsWith('file://')) {\n        const url = new URL(raw);\n        return url.pathname;\n      }\n\n      return raw.replace(/:\\d+(:\\d+)?$/, '');\n    } catch (fallbackError) {\n      if (fallbackError instanceof CallerFileError) throw fallbackError;\n      throw new CallerFileError('Fallback stack parsing failed', {\n        cause: fallbackError,\n      });\n    }\n  }\n}\n\n/**\n * Returns the absolute file path of the calling file.\n *\n * @param {number} depth - 1 = immediate caller, 2 = caller's caller, etc.\n * @returns {string} Absolute file path of the caller.\n * @throws {CallerFileError} If the caller file cannot be determined.\n */\nexport function getCallerFilePath(depth = 1) {\n  const file = getCallerFile(depth + 1);\n  return file.startsWith('file:') ? fileURLToPath(file) : file;\n}\n\n/**\n * Returns the directory that contains the package.json\n * associated with the specified import.meta.url.\n *\n * If no package.json is found while walking up the directory tree,\n * an error will be thrown.\n */\nexport async function getPackageDir(\n  callerFilePath = getCallerFilePath(),\n): Promise<string> {\n  // const { stat } = await import('node:fs/promises');\n  // const { join, dirname } = await import('node:path');\n  // const { fileURLToPath } = await import('node:url');\n\n  let dir = dirname(callerFilePath);\n\n  while (true) {\n    const pkgJson = join(dir, 'package.json');\n\n    const exists = await stat(pkgJson)\n      .then(() => true)\n      .catch(() => false);\n    if (exists) return dir;\n\n    // Move to the parent directory\n    const parent = dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n\n  throw new Error(`package.json not found for: ${callerFilePath}`);\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,IAAM,kBAAN,cAA8B,MAAM;CAClC;CACA,YAAY,SAAiB,OAAgB,EAAE,EAAE;AAC/C,QAAM,QAAQ;AACd,OAAK,OAAO;AACZ,OAAK,OAAO;;;;;;;;;;AAWhB,SAAgB,cAAc,QAAQ,GAAG;AACvC,KAAI,OAAO,UAAU,YAAY,QAAQ,EACvC,OAAM,IAAI,gBAAgB,0BAA0B,EAAE,OAAO,CAAC;AAIhE,KAAI;EACF,MAAM,kBAAkB,MAAM;AAC9B,QAAM,qBAAqB,GAAG,yBAAyB;EAEvD,MAAM,EAAE,0BADI,IAAI,OAAO;AAEvB,QAAM,oBAAoB;AAE1B,MAAI,MAAM,QAAQ,MAAM,EAAE;GACxB,MAAM,QAAQ,MAAM;AACpB,OAAI,SAAS,OAAO,MAAM,gBAAgB,YAAY;IACpD,MAAM,OAAO,MAAM,aAAa;AAChC,QAAI,OAAO,SAAS,SAAU,QAAO;AACrC,UAAM,IAAI,gBAAgB,wCAAwC,EAChE,OACD,CAAC;SAEF,OAAM,IAAI,gBAAgB,sCAAsC,EAC9D,OACD,CAAC;QAGJ,OAAM,IAAI,gBAAgB,sCAAsC,EAC9D,OACD,CAAC;UAEG,SAAS;AAEhB,MAAI;GACF,MAAM,4BAAW,IAAI,OAAO,EAAC;AAC7B,OAAI,OAAO,aAAa,SACtB,OAAM,IAAI,gBAAgB,+BAA+B,EACvD,OAAO,UACR,CAAC;GAGJ,MAAM,QAAQ,SACX,MAAM,KAAK,CACX,KAAK,MAAM,EAAE,MAAM,CAAC,CACpB,OAAO,QAAQ;GAClB,MAAM,QAAQ,IAAI;AAClB,OAAI,SAAS,MAAM,OACjB,OAAM,IAAI,gBAAgB,2BAA2B,EAAE,OAAO,CAAC;GAGjE,MAAM,OAAO,MAAM;GAGnB,MAAM,QACJ,KAAK,MAAM,qBAAqB,IAChC,KAAK,MAAM,0BAA0B,IACrC,KAAK,MAAM,mCAAmC;AAEhD,OAAI,CAAC,MACH,OAAM,IAAI,gBAAgB,4CAA4C,EACpE,MACD,CAAC;GAGJ,MAAM,MAAM,MAAM;AAClB,OAAI,IAAI,WAAW,UAAU,CAE3B,QADY,IAAI,IAAI,IAAI,CACb;AAGb,UAAO,IAAI,QAAQ,gBAAgB,GAAG;WAC/B,eAAe;AACtB,OAAI,yBAAyB,gBAAiB,OAAM;AACpD,SAAM,IAAI,gBAAgB,iCAAiC,EACzD,OAAO,eACR,CAAC;;;;;;;;;;;AAYR,SAAgB,kBAAkB,QAAQ,GAAG;CAC3C,MAAM,OAAO,cAAc,QAAQ,EAAE;AACrC,QAAO,KAAK,WAAW,QAAQ,GAAG,cAAc,KAAK,GAAG;;;;;;;;;AAU1D,eAAsB,cACpB,iBAAiB,mBAAmB,EACnB;CAKjB,IAAI,MAAM,QAAQ,eAAe;AAEjC,QAAO,MAAM;AAMX,MAHe,MAAM,KAFL,KAAK,KAAK,eAAe,CAEP,CAC/B,WAAW,KAAK,CAChB,YAAY,MAAM,CACT,QAAO;EAGnB,MAAM,SAAS,QAAQ,IAAI;AAC3B,MAAI,WAAW,IAAK;AACpB,QAAM;;AAGR,OAAM,IAAI,MAAM,+BAA+B,iBAAiB"}