@hyperfrontend/builder 0.1.0 → 0.1.1

package/bundle/index.cjs.js

@@ -1,10 +1,10 @@
 'use strict';
 
 const index_cjs_js$3 = require('../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/array/index.cjs.js');
-const index_cjs_js$7 = require('../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/error/index.cjs.js');
+const index_cjs_js$4 = require('../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/error/index.cjs.js');
 const index_cjs_js$2 = require('../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/set/index.cjs.js');
-const index_cjs_js$4 = require('../_dependencies/@hyperfrontend/logging/index.cjs.js');
-const index_cjs_js$5 = require('../_dependencies/@hyperfrontend/project-scope/core/index.cjs.js');
+const index_cjs_js$5 = require('../_dependencies/@hyperfrontend/logging/index.cjs.js');
+const index_cjs_js$6 = require('../_dependencies/@hyperfrontend/project-scope/core/index.cjs.js');
 const index_cjs_js = require('../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/promise/index.cjs.js');
 const index_cjs_js$1 = require('../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/timers/index.cjs.js');
 const node_module = require('node:module');
@@ -12,7 +12,7 @@ const node_path = require('node:path');
 const node_child_process = require('node:child_process');
 const node_fs = require('node:fs');
 const node_os = require('node:os');
-const index_cjs_js$6 = require('../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/json/index.cjs.js');
+const index_cjs_js$7 = require('../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/json/index.cjs.js');
 const index_cjs_js$8 = require('../_dependencies/@hyperfrontend/project-scope/core/fs/index.cjs.js');
 const index_cjs_js$9 = require('../_dependencies/@hyperfrontend/project-scope/core/path/index.cjs.js');
 const index_cjs_js$a = require('../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/date/index.cjs.js');
@@ -37,13 +37,77 @@ function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'defau
 
 const ts__default = /*#__PURE__*/_interopDefaultCompat(ts);
 
-const log$b = index_cjs_js$4.logger.channel('builder:bundle:dependencies:pre-pass');
+const SWC_NODE_REGISTER = '@swc-node/register';
+const probeDir = (dir, offset) => {
+    const compiled = node_path.join(dir, ...offset, 'index.cjs.js');
+    if (node_fs.existsSync(compiled))
+        return { path: compiled, execArgv: [] };
+    const source = node_path.join(dir, ...offset, 'index.ts');
+    if (node_fs.existsSync(source))
+        return { path: source, execArgv: ['--require', SWC_NODE_REGISTER] };
+    return undefined;
+};
+/**
+ * Directory of the currently-executing builder module, read from `__dirname`.
+ * It is present in the shipped CommonJS build, in the `@swc-node/register` source
+ * bootstrap, and under the test runner, so callers get their own on-disk location
+ * and can find the worker beside them however the builder was packaged.
+ *
+ * @returns Absolute directory path of the running module.
+ *
+ * @example Anchoring a lookup beside the running builder
+ * ```typescript
+ * const invocation = ascendForWorker(['bundle', 'rollup', 'worker'], currentModuleDir())
+ * ```
+ */
+const currentModuleDir = () => {
+    /* istanbul ignore if -- @preserve the ESM build has no __dirname; the shipped CommonJS build and the test runner always define it, so this guard is unreachable under test */
+    if (typeof __dirname === 'undefined') {
+        throw index_cjs_js$4.createError('@hyperfrontend/builder self-location requires the CommonJS build; drive build() from the CommonJS entry point');
+    }
+    return __dirname;
+};
+/**
+ * Locate a builder worker entry by ascending from a start directory toward the
+ * filesystem root, returning the first ancestor at which the worker exists at the
+ * given in-package offset. The compiled `index.cjs.js` is preferred; an `index.ts`
+ * sibling (source-mode bootstrap) resolves with the swc loader attached.
+ *
+ * The worker ships inside the builder's own package, so resolving relative to the
+ * running module finds it wherever the package lives — built dist, an installed
+ * `node_modules` copy, or melded into a host bundle under `_dependencies/`.
+ *
+ * @param offset - In-package path segments to the worker directory (e.g. `['bundle', 'rollup', 'worker']`).
+ * @param startDir - Directory to begin the ascent from. Defaults to the running module's directory; pass an explicit value to resolve from another anchor or under test.
+ * @returns The resolved worker invocation, or `undefined` if no worker exists at the offset under any ancestor.
+ *
+ * @example Resolving the rollup worker from the running module
+ * ```typescript
+ * const invocation = ascendForWorker(['bundle', 'rollup', 'worker'])
+ * if (!invocation) throw new Error('builder rollup worker not found beside the builder module')
+ * ```
+ */
+const ascendForWorker = (offset, startDir = currentModuleDir()) => {
+    let dir = startDir;
+    let parent = node_path.dirname(dir);
+    // how: probe each level then step up; the final probe covers the filesystem root, where parent === dir
+    while (parent !== dir) {
+        const found = probeDir(dir, offset);
+        if (found)
+            return found;
+        dir = parent;
+        parent = node_path.dirname(dir);
+    }
+    return probeDir(dir, offset);
+};
+
+const log$b = index_cjs_js$5.logger.channel('builder:bundle:dependencies:pre-pass');
 const REPORT_DIR_PREFIX$1 = 'hf-builder-prepass-';
-const createReportDir$1 = () => node_fs.mkdtempSync(index_cjs_js$5.join(node_os.tmpdir(), REPORT_DIR_PREFIX$1));
-const reportPathFor$1 = (reportDir, job, index) => index_cjs_js$5.join(reportDir, `${index}-${job.dep.replace(/\//g, '__')}-${job.kind}-${job.format}.json`);
+const createReportDir$1 = () => node_fs.mkdtempSync(index_cjs_js$6.join(node_os.tmpdir(), REPORT_DIR_PREFIX$1));
+const reportPathFor$1 = (reportDir, job, index) => index_cjs_js$6.join(reportDir, `${index}-${job.dep.replace(/\//g, '__')}-${job.kind}-${job.format}.json`);
 const runOne$1 = (job, reportPath, options) => index_cjs_js.createPromise((resolve, reject) => {
     const execPath = options.execPath ?? process.execPath;
-    const argv = [...(options.execArgv ?? []), options.workerPath, index_cjs_js$6.stringify({ ...job, reportPath })];
+    const argv = [...(options.execArgv ?? []), options.workerPath, index_cjs_js$7.stringify({ ...job, reportPath })];
     const child = node_child_process.spawn(execPath, argv, { stdio: ['ignore', 'pipe', 'pipe'] });
     let capturedStderr = '';
     child.stdout?.on('data', (chunk) => {
@@ -55,12 +119,12 @@ const runOne$1 = (job, reportPath, options) => index_cjs_js.createPromise((resol
         process.stderr.write(text);
     });
     child.on('error', (error) => {
-        reject(index_cjs_js$7.createError(`pre-pass worker for ${job.dep} (${job.kind}/${job.format}) failed to spawn: ${error.message}`));
+        reject(index_cjs_js$4.createError(`pre-pass worker for ${job.dep} (${job.kind}/${job.format}) failed to spawn: ${error.message}`));
     });
     child.on('exit', (code) => {
         if (code !== 0) {
             const tail = capturedStderr.trim().split('\n').slice(-10).join('\n');
-            reject(index_cjs_js$7.createError(`pre-pass worker for ${job.dep} (${job.kind}/${job.format}) exited with code ${code}\n${tail}`));
+            reject(index_cjs_js$4.createError(`pre-pass worker for ${job.dep} (${job.kind}/${job.format}) exited with code ${code}\n${tail}`));
             return;
         }
         resolve();
@@ -68,48 +132,30 @@ const runOne$1 = (job, reportPath, options) => index_cjs_js.createPromise((resol
 });
 const readReport$1 = (reportPath, job) => {
     if (!node_fs.existsSync(reportPath)) {
-        throw index_cjs_js$7.createError(`pre-pass worker for ${job.dep} (${job.kind}/${job.format}) did not write a report at ${reportPath}`);
+        throw index_cjs_js$4.createError(`pre-pass worker for ${job.dep} (${job.kind}/${job.format}) did not write a report at ${reportPath}`);
     }
-    const data = index_cjs_js$6.parse(node_fs.readFileSync(reportPath, 'utf8'));
+    const data = index_cjs_js$7.parse(node_fs.readFileSync(reportPath, 'utf8'));
     return { job, outputSize: data.outputSize, endHeapMB: data.endHeapMB, endRssMB: data.endRssMB, durationMs: data.durationMs };
 };
-const SWC_NODE_REGISTER$1 = '@swc-node/register';
-const swcNodeAvailable$1 = (workspaceRoot) => node_fs.existsSync(index_cjs_js$5.join(workspaceRoot, 'node_modules', '@swc-node', 'register', 'index.js'));
 /**
- * Default worker-path resolution: prefers the built-and-published artifact, falls
- * back to the workspace dist path, and finally to the in-source TypeScript file
- * via `@swc-node/register` (bootstrap case where builder is building itself for
- * the first time and the dist worker doesn't exist yet).
- *
- * Looks at, in order:
- * 1. `<workspaceRoot>/dist/libs/builder/bundle/dependencies/worker/index.cjs.js`
- * 2. `<workspaceRoot>/node_modules/@hyperfrontend/builder/bundle/dependencies/worker/index.cjs.js`
- * 3. `<workspaceRoot>/libs/builder/src/bundle/dependencies/worker/index.ts` (with `--require \@swc-node/register`)
- *
- * @param workspaceRoot - Absolute workspace root.
- * @returns Worker invocation descriptor, or `undefined` if no candidate exists.
- *
- * @example Locating the worker for an in-workspace consumer
+ * Resolves the dependency pre-pass worker by self-locating it beside the running
+ * builder module: ascends from the module's own directory to the builder package
+ * root and returns the worker at `bundle/dependencies/worker`. This works whether
+ * the builder runs from its built dist, an installed `node_modules` copy, or
+ * melded into a host bundle under `_dependencies/`. The compiled `index.cjs.js`
+ * is preferred; an `index.ts` sibling resolves with the `@swc-node/register`
+ * loader for source-mode bootstrap.
+ *
+ * @param startDir - Directory to begin the ascent from. Defaults to the running module's directory; pass an explicit value to resolve from another anchor or under test.
+ * @returns Worker invocation descriptor, or `undefined` if no worker is found under any ancestor.
+ *
+ * @example Locating the worker beside the builder
  * ```typescript
- * const invocation = resolveDefaultWorkerPath('/abs/repo')
+ * const invocation = resolveDefaultWorkerPath()
  * if (!invocation) throw new Error('builder worker artifact not found')
  * ```
  */
-const resolveDefaultWorkerPath = (workspaceRoot) => {
-    const distCandidates = [
-        index_cjs_js$5.join(workspaceRoot, 'dist', 'libs', 'builder', 'bundle', 'dependencies', 'worker', 'index.cjs.js'),
-        index_cjs_js$5.join(workspaceRoot, 'node_modules', '@hyperfrontend', 'builder', 'bundle', 'dependencies', 'worker', 'index.cjs.js'),
-    ];
-    for (const path of distCandidates) {
-        if (node_fs.existsSync(path))
-            return { path, execArgv: [] };
-    }
-    const sourcePath = index_cjs_js$5.join(workspaceRoot, 'libs', 'builder', 'src', 'bundle', 'dependencies', 'worker', 'index.ts');
-    if (node_fs.existsSync(sourcePath) && swcNodeAvailable$1(workspaceRoot)) {
-        return { path: sourcePath, execArgv: ['--require', SWC_NODE_REGISTER$1] };
-    }
-    return undefined;
-};
+const resolveDefaultWorkerPath = (startDir) => ascendForWorker(['bundle', 'dependencies', 'worker'], startDir);
 /**
  * Sequentially runs the supplied pre-pass jobs by forking a fresh Node child
  * per invocation. Strict sequential execution is mandatory — concurrent
@@ -170,14 +216,14 @@ const runPrePass = async (jobs, options) => {
  */
 const dtsPathFor = (outputPath, srcPath) => srcPath ? join(outputPath, srcPath, 'index.d.ts') : join(outputPath, 'index.d.ts');
 
-const log$a = index_cjs_js$4.logger.channel('builder:bundle:declarations:dts-per-entry');
+const log$a = index_cjs_js$5.logger.channel('builder:bundle:declarations:dts-per-entry');
 const buildSiblingDescriptors = (entries, context, currentSrcPath) => {
     const descriptors = [];
     for (const entry of entries) {
         if (entry.srcPath === currentSrcPath)
             continue;
         const indexDtsPath = dtsPathFor(context.outputPath, entry.srcPath);
-        if (!index_cjs_js$5.exists(indexDtsPath))
+        if (!index_cjs_js$6.exists(indexDtsPath))
             continue;
         descriptors.push({ srcPath: entry.srcPath, indexDtsPath });
     }
@@ -191,7 +237,7 @@ const buildJobs$1 = (entries, context) => {
     const depsRoot = depsRootOf(context);
     for (const entry of entries) {
         const inputPath = dtsPathFor(context.outputPath, entry.srcPath);
-        if (!index_cjs_js$5.exists(inputPath))
+        if (!index_cjs_js$6.exists(inputPath))
             continue;
         const siblingEntries = buildSiblingDescriptors(entries, context, entry.srcPath);
         jobs.push({
@@ -238,9 +284,9 @@ const buildJobs$1 = (entries, context) => {
 const runDtsPerEntry = async (context, monitor) => {
     if (context.bundledDeps.length === 0 && context.workspaceBundledDeps.length === 0)
         return;
-    const invocation = resolveDefaultWorkerPath(context.workspaceRoot);
+    const invocation = resolveDefaultWorkerPath();
     if (!invocation) {
-        throw index_cjs_js$7.createError('bundleAllDeps is enabled but the pre-pass worker artifact was not found for the per-entry d.ts pass.');
+        throw index_cjs_js$4.createError('bundleAllDeps is enabled but the pre-pass worker could not be located beside the builder module for the per-entry d.ts pass.');
     }
     const jobs = buildJobs$1(context.entryPointDiscovery.entryPoints, context);
     if (jobs.length === 0) {
@@ -334,17 +380,17 @@ const resolveDepEntry = (options) => {
     const { dep, projectRoot, workspaceRoot, kind } = options;
     const pkgPath = findPackageJsonViaRequire(dep, ROOTS(projectRoot, workspaceRoot));
     if (!pkgPath)
-        throw index_cjs_js$7.createError(`pre-pass: cannot locate package.json for dep "${dep}"`);
+        throw index_cjs_js$4.createError(`pre-pass: cannot locate package.json for dep "${dep}"`);
     const pkg = index_cjs_js$8.readJsonFileIfExists(pkgPath);
     if (!pkg)
-        throw index_cjs_js$7.createError(`pre-pass: package.json for dep "${dep}" could not be read at ${pkgPath}`);
+        throw index_cjs_js$4.createError(`pre-pass: package.json for dep "${dep}" could not be read at ${pkgPath}`);
     const relative = kind === 'js' ? ensureJsEntry(pkg) : ensureDtsEntry(pkg);
     if (!relative)
-        throw index_cjs_js$7.createError(`pre-pass: dep "${dep}" has no ${kind === 'js' ? 'main/module' : 'types/typings'} entry`);
+        throw index_cjs_js$4.createError(`pre-pass: dep "${dep}" has no ${kind === 'js' ? 'main/module' : 'types/typings'} entry`);
     return absolutize(node_path.dirname(pkgPath), relative);
 };
 
-const log$9 = index_cjs_js$4.logger.channel('builder:bundle:declarations:dts-pre-pass');
+const log$9 = index_cjs_js$5.logger.channel('builder:bundle:declarations:dts-pre-pass');
 const workspaceDtsOutputFile = (entry) => entry.subPath ? `${entry.specifier}/index.d.ts` : `${entry.packageName}/index.d.ts`;
 const filterRouteEntries$1 = (entry, all) => all.filter((other) => (entry.policy === 'sub-path' ? other.specifier !== entry.specifier : other.packageName !== entry.packageName));
 const buildJobs = (deps, context) => {
@@ -368,7 +414,7 @@ const buildJobs = (deps, context) => {
             dep,
             inputPath,
             format: 'esm',
-            outputPath: index_cjs_js$5.join(depsRoot, dep, 'index.d.ts'),
+            outputPath: index_cjs_js$6.join(depsRoot, dep, 'index.d.ts'),
             otherDeps: [...otherNpmDeps, ...workspacePrefixDeps],
             otherWorkspaceSpecifiers: workspaceExactSpecifiers,
             npmDeps: otherNpmDeps,
@@ -394,7 +440,7 @@ const buildWorkspaceJobs = (context, npmDeps) => {
             dep: entry.specifier,
             inputPath: entry.inputPath,
             format: 'esm',
-            outputPath: index_cjs_js$5.join(depsRoot, workspaceDtsOutputFile(entry)),
+            outputPath: index_cjs_js$6.join(depsRoot, workspaceDtsOutputFile(entry)),
             otherDeps: [...npmDeps, ...otherWorkspacePackages],
             otherWorkspaceSpecifiers: otherSubPathSpecifiers,
             tsConfigPath: entry.tsConfigPath,
@@ -423,9 +469,9 @@ const buildWorkspaceJobs = (context, npmDeps) => {
 const runDtsPrePass = async (context, monitor) => {
     if (context.bundledDeps.length === 0 && context.workspaceBundledDeps.length === 0)
         return;
-    const invocation = resolveDefaultWorkerPath(context.workspaceRoot);
+    const invocation = resolveDefaultWorkerPath();
     if (!invocation) {
-        throw index_cjs_js$7.createError('bundleAllDeps is enabled but the pre-pass worker artifact was not found for the d.ts pre-pass.');
+        throw index_cjs_js$4.createError('bundleAllDeps is enabled but the pre-pass worker could not be located beside the builder module for the d.ts pre-pass.');
     }
     const npmJobs = buildJobs(context.bundledDeps, context);
     const workspaceJobs = buildWorkspaceJobs(context, context.bundledDeps);
@@ -440,7 +486,7 @@ const runDtsPrePass = async (context, monitor) => {
     monitor?.check('bundle:declarations:dts-prepass:end');
 };
 
-const log$8 = index_cjs_js$4.logger.channel('builder:bundle:declarations');
+const log$8 = index_cjs_js$5.logger.channel('builder:bundle:declarations');
 const HEARTBEAT_INTERVAL_MS = 5000;
 const BYTES_PER_MB = 1024 * 1024;
 const formatMB = (bytes) => (bytes / BYTES_PER_MB).toFixed(1);
@@ -477,7 +523,7 @@ const runTsc = (tscPath, args, cwd) => index_cjs_js.createPromise((resolve, reje
         const durationMs = index_cjs_js$a.dateNow() - startedAt;
         if (code !== 0) {
             log$8.error(`tsc failed with exit code ${code} after ${durationMs}ms`);
-            reject(index_cjs_js$7.createError(`tsc failed with exit code ${code}`));
+            reject(index_cjs_js$4.createError(`tsc failed with exit code ${code}`));
             return;
         }
         log$8.info(`tsc exited 0 in ${durationMs}ms`);
@@ -527,7 +573,7 @@ const generateDeclarations = async (context) => {
     return result;
 };
 
-const log$7 = index_cjs_js$4.logger.channel('builder:bundle:declarations:prune-orphans');
+const log$7 = index_cjs_js$5.logger.channel('builder:bundle:declarations:prune-orphans');
 const ORPHAN_DTS_RE = /\.d\.ts$|\.d\.ts\.map$/;
 const INDEX_DTS_NAME = 'index.d.ts';
 /**
@@ -548,13 +594,13 @@ const INDEX_DTS_NAME = 'index.d.ts';
  * @returns Absolute `.d.ts` path of the referenced sibling, or `null`.
  */
 const toDtsTarget$1 = (dir, spec, depsRoot) => {
-    const abs = index_cjs_js$5.join(dir, spec);
+    const abs = index_cjs_js$6.join(dir, spec);
     // why: a `.js` specifier is the bundled-dep routing shape; map it onto its declaration sibling.
-    const candidates = spec.endsWith('.js') ? [`${abs.slice(0, -3)}.d.ts`] : [`${abs}.d.ts`, index_cjs_js$5.join(abs, INDEX_DTS_NAME)];
+    const candidates = spec.endsWith('.js') ? [`${abs.slice(0, -3)}.d.ts`] : [`${abs}.d.ts`, index_cjs_js$6.join(abs, INDEX_DTS_NAME)];
     for (const candidate of candidates) {
         if (isUnderDir(candidate, depsRoot))
             return null;
-        if (index_cjs_js$5.exists(candidate))
+        if (index_cjs_js$6.exists(candidate))
             return candidate;
     }
     return null;
@@ -582,7 +628,7 @@ const computeReachableDeclarations = (roots, depsRoot) => {
     const reachable = index_cjs_js$2.createSet([]);
     const queue = [];
     for (const root of roots) {
-        if (index_cjs_js$5.exists(root) && !reachable.has(root)) {
+        if (index_cjs_js$6.exists(root) && !reachable.has(root)) {
             reachable.add(root);
             queue.push(root);
         }
@@ -592,12 +638,12 @@ const computeReachableDeclarations = (roots, depsRoot) => {
         const file = queue[head];
         head += 1;
         // why: every queued path was `exists`-checked before enqueue (roots and `toDtsTarget` targets), so a direct read is safe.
-        const source = index_cjs_js$5.readFileContent(file);
+        const source = index_cjs_js$6.readFileContent(file);
         if (hasDynamicSpecifier(source)) {
             log$7.warn(`dynamic import/require in ${file}; keeping all orphan declarations for safety`);
             return null;
         }
-        const dir = index_cjs_js$5.getDirname(file);
+        const dir = index_cjs_js$6.getDirname(file);
         for (const spec of collectChunkSpecifiers(source)) {
             const target = toDtsTarget$1(dir, spec, depsRoot);
             if (target !== null && !reachable.has(target)) {
@@ -619,10 +665,10 @@ const computeReachableDeclarations = (roots, depsRoot) => {
  */
 const collectDeclarationFiles = (root, depsRoot) => {
     const files = [];
-    if (!index_cjs_js$5.exists(root))
+    if (!index_cjs_js$6.exists(root))
         return files;
     const visit = (dir) => {
-        for (const entry of index_cjs_js$5.readDirectory(dir)) {
+        for (const entry of index_cjs_js$6.readDirectory(dir)) {
             if (entry.isDirectory) {
                 if (isUnderDir(entry.path, depsRoot))
                     continue;
@@ -673,7 +719,7 @@ const pruneOrphanDeclarations = (context) => {
         const dir = entryDirOf(entry, context);
         if (isUnderDir(dir, depsRoot))
             continue;
-        roots.push(index_cjs_js$5.join(dir, INDEX_DTS_NAME));
+        roots.push(index_cjs_js$6.join(dir, INDEX_DTS_NAME));
     }
     const reachable = computeReachableDeclarations(roots, depsRoot);
     if (reachable === null)
@@ -726,7 +772,7 @@ const parseChunk = (source) => ts__default.default.createSourceFile('chunk.js',
  * // => '/dist/libs/foo/_dependencies/b/index.esm.js'
  * ```
  */
-const resolveRelativeTarget = (importerDir, specifier) => specifier.startsWith('.') ? index_cjs_js$5.join(importerDir, specifier) : null;
+const resolveRelativeTarget = (importerDir, specifier) => specifier.startsWith('.') ? index_cjs_js$6.join(importerDir, specifier) : null;
 /**
  * Returns the literal specifier of a `require('…')` call expression, or `null`
  * when the node is not a single-string-literal `require` call.
@@ -1025,7 +1071,7 @@ const ownersFromSource = (source) => {
     return names;
 };
 const walkTsFiles = (dir, acc) => {
-    for (const entry of index_cjs_js$5.readDirectory(dir)) {
+    for (const entry of index_cjs_js$6.readDirectory(dir)) {
         if (entry.isDirectory)
             walkTsFiles(entry.path, acc);
         else if (entry.name.endsWith('.ts') && !entry.name.endsWith('.d.ts') && !entry.name.endsWith('.spec.ts'))
@@ -1058,7 +1104,7 @@ const indexOwners = (srcRoot) => {
     const ownerOf = index_cjs_js$b.createMap();
     for (const file of files) {
         const moduleKey = toModuleKey(srcRoot, file);
-        for (const name of ownersFromSource(index_cjs_js$5.readFileContent(file))) {
+        for (const name of ownersFromSource(index_cjs_js$6.readFileContent(file))) {
             if (ambiguous.has(name))
                 continue;
             const prior = firstOwner.get(name);
@@ -1746,28 +1792,28 @@ const rewriteEntry = (parsed, hoists, format) => {
     return applyEdits$1(parsed.sourceFile.text, [...deletions, { start: parsed.headerEnd, end: parsed.headerEnd, text: insertion }]);
 };
 
-const log$6 = index_cjs_js$4.logger.channel('builder:bundle:dedupe');
+const log$6 = index_cjs_js$5.logger.channel('builder:bundle:dedupe');
 const FORMATS = ['esm', 'cjs'];
 const toSpecifier = (relative) => (relative.startsWith('.') ? relative : `./${relative}`);
 const recomputeSpecifier = (specifier, fromDir, baseDir) => 
 // why: relative `_dependencies`/`_shared` edges move with the chunk; bare and node-builtin specifiers resolve identically from anywhere, so they pass through verbatim.
-specifier.startsWith('.') ? toSpecifier(index_cjs_js$5.relativePath(fromDir, index_cjs_js$5.join(baseDir, specifier))) : specifier;
+specifier.startsWith('.') ? toSpecifier(index_cjs_js$6.relativePath(fromDir, index_cjs_js$6.join(baseDir, specifier))) : specifier;
 const locateEntries = (context, format) => {
     const locations = [];
     for (const entry of context.entryPointDiscovery.entryPoints) {
         const dir = entryDirOf(entry, context);
-        const file = index_cjs_js$5.join(dir, chunkFileName(format));
-        if (index_cjs_js$5.exists(file))
+        const file = index_cjs_js$6.join(dir, chunkFileName(format));
+        if (index_cjs_js$6.exists(file))
             locations.push({ dir, file });
     }
     return locations;
 };
-const chunkFileFor = (context, moduleKey, format) => index_cjs_js$5.join(context.outputPath, sharedDirFor(moduleKey), chunkFileName(format));
+const chunkFileFor = (context, moduleKey, format) => index_cjs_js$6.join(context.outputPath, sharedDirFor(moduleKey), chunkFileName(format));
 const buildChunkPlan = (planned, context, chunkDir, canonicalDir, format) => {
     const crossImports = planned.resolution.crossModule.map((ref) => ({
         ref: ref.ref,
         exported: ref.base,
-        specifier: toSpecifier(index_cjs_js$5.relativePath(chunkDir, chunkFileFor(context, ref.moduleKey, format))),
+        specifier: toSpecifier(index_cjs_js$6.relativePath(chunkDir, chunkFileFor(context, ref.moduleKey, format))),
     }));
     const depImports = planned.resolution.depImports.map((dep) => ({
         ref: dep.ref,
@@ -1779,11 +1825,11 @@ const buildChunkPlan = (planned, context, chunkDir, canonicalDir, format) => {
 };
 const writeChunks = (context, plan, locations, format, report) => {
     for (const [moduleKey, planned] of plan) {
-        const chunkDir = index_cjs_js$5.join(context.outputPath, sharedDirFor(moduleKey));
+        const chunkDir = index_cjs_js$6.join(context.outputPath, sharedDirFor(moduleKey));
         const chunkPlan = buildChunkPlan(planned, context, chunkDir, locations[planned.canonicalEntryIndex].dir, format);
         const source = renderChunk(chunkPlan, format);
-        index_cjs_js$5.ensureDir(chunkDir);
-        index_cjs_js$5.writeFileContent(chunkFileFor(context, moduleKey, format), source);
+        index_cjs_js$6.ensureDir(chunkDir);
+        index_cjs_js$6.writeFileContent(chunkFileFor(context, moduleKey, format), source);
         report.chunksWritten += 1;
         report.bytesReclaimed -= Buffer.byteLength(source);
     }
@@ -1797,13 +1843,13 @@ const rewriteEntries = (context, plan, entries, locations, format, report) => {
                 continue;
             hoists.push({
                 decls,
-                specifier: toSpecifier(index_cjs_js$5.relativePath(locations[index].dir, chunkFileFor(context, moduleKey, format))),
+                specifier: toSpecifier(index_cjs_js$6.relativePath(locations[index].dir, chunkFileFor(context, moduleKey, format))),
             });
             for (const decl of decls)
                 report.bytesReclaimed += Buffer.byteLength(decl.text);
         }
         if (hoists.length > 0)
-            index_cjs_js$5.writeFileContent(locations[index].file, rewriteEntry(entry.parsed, hoists, format));
+            index_cjs_js$6.writeFileContent(locations[index].file, rewriteEntry(entry.parsed, hoists, format));
     }
 };
 const processFormat$2 = (context, owners, format, report) => {
@@ -1811,7 +1857,7 @@ const processFormat$2 = (context, owners, format, report) => {
     if (locations.length < 2)
         return;
     const entries = locations.map((location) => {
-        const parsed = parseEntry(index_cjs_js$5.readFileContent(location.file), format);
+        const parsed = parseEntry(index_cjs_js$6.readFileContent(location.file), format);
         return { parsed, byModule: attribute(parsed, owners) };
     });
     const plan = planHoists(entries, owners);
@@ -1846,8 +1892,8 @@ const processFormat$2 = (context, owners, format, report) => {
  */
 const hoistSharedFirstParty = (context, monitor) => {
     const report = { chunksWritten: 0, bytesReclaimed: 0 };
-    const srcRoot = index_cjs_js$5.join(context.projectRoot, 'src');
-    if (!index_cjs_js$5.exists(srcRoot))
+    const srcRoot = index_cjs_js$6.join(context.projectRoot, 'src');
+    if (!index_cjs_js$6.exists(srcRoot))
         return report;
     const owners = indexOwners(srcRoot);
     for (const format of FORMATS) {
@@ -1996,7 +2042,7 @@ const stripDeadExports = (source, format, keep) => {
     return { code: applyEdits(source, edits, true), removedNames: index_cjs_js$3.from(removedNames) };
 };
 
-const log$5 = index_cjs_js$4.logger.channel('builder:bundle:dependencies:prune');
+const log$5 = index_cjs_js$5.logger.channel('builder:bundle:dependencies:prune');
 /**
  * Computes the set of files reachable from a set of root files by following
  * literal relative specifiers, restricted to targets under `depsRoot`.
@@ -2035,7 +2081,7 @@ const computeReachable = (roots, depsRoot, resolveTarget = (target) => target) =
     const reachable = index_cjs_js$2.createSet([]);
     const queue = [];
     for (const root of roots) {
-        if (index_cjs_js$5.exists(root) && !reachable.has(root)) {
+        if (index_cjs_js$6.exists(root) && !reachable.has(root)) {
             reachable.add(root);
             queue.push(root);
         }
@@ -2044,16 +2090,16 @@ const computeReachable = (roots, depsRoot, resolveTarget = (target) => target) =
     while (head < queue.length) {
         const file = queue[head];
         head += 1;
-        const source = index_cjs_js$5.readFileContent(file);
+        const source = index_cjs_js$6.readFileContent(file);
         // why: a dynamic specifier only threatens the sweep when it sits in a `_dependencies/` chunk, where it can hide an intra-deps edge to a sibling chunk we'd otherwise delete. First-party entry roots legitimately carry dynamic `import(<expr>)` (e.g. runtime config loading) whose targets are always external user paths — never bundled dep chunks — so bailing on those needlessly disables the entire sweep and strands emptied dep chunks. Roots are never under `depsRoot` (collectEntryFiles excludes them), so this scopes the bail to dep chunks only.
         if (isUnderDir(file, depsRoot) && hasDynamicSpecifier(source)) {
             log$5.warn(`dynamic import/require in ${file}; skipping dependency orphan prune for safety`);
             return null;
         }
-        const dir = index_cjs_js$5.getDirname(file);
+        const dir = index_cjs_js$6.getDirname(file);
         for (const spec of collectChunkSpecifiers(source)) {
-            const target = resolveTarget(index_cjs_js$5.join(dir, spec));
-            if (isUnderDir(target, depsRoot) && index_cjs_js$5.exists(target) && !reachable.has(target)) {
+            const target = resolveTarget(index_cjs_js$6.join(dir, spec));
+            if (isUnderDir(target, depsRoot) && index_cjs_js$6.exists(target) && !reachable.has(target)) {
                 reachable.add(target);
                 queue.push(target);
             }
@@ -2087,8 +2133,8 @@ const collectEntryFiles = (context, depsRoot, fileNames) => {
         if (isUnderDir(dir, depsRoot))
             continue;
         for (const name of fileNames) {
-            const candidate = index_cjs_js$5.join(dir, name);
-            if (index_cjs_js$5.exists(candidate))
+            const candidate = index_cjs_js$6.join(dir, name);
+            if (index_cjs_js$6.exists(candidate))
                 files.push(candidate);
         }
     }
@@ -2111,7 +2157,7 @@ const collectEntryFiles = (context, depsRoot, fileNames) => {
  */
 const walkFiles = (dir, matches, acc) => {
     // why: only ever called on the validated `_dependencies/` root or a directory from `readDirectory`, so the target always exists — no existence guard needed.
-    for (const entry of index_cjs_js$5.readDirectory(dir)) {
+    for (const entry of index_cjs_js$6.readDirectory(dir)) {
         if (entry.isDirectory)
             walkFiles(entry.path, matches, acc);
         else if (matches(entry.name))
@@ -2124,7 +2170,7 @@ const unlinkWithMap = (path) => {
     let orphanFilesRemoved = 1;
     node_fs.unlinkSync(path);
     const mapPath = `${path}.map`;
-    if (index_cjs_js$5.exists(mapPath)) {
+    if (index_cjs_js$6.exists(mapPath)) {
         bytesRemoved += node_fs.statSync(mapPath).size;
         node_fs.unlinkSync(mapPath);
         orphanFilesRemoved += 1;
@@ -2195,7 +2241,7 @@ const pruneDtsOrphans = (context, depsRoot) => {
  * ```
  */
 const pruneOrphanChunks = (context, depsRoot) => {
-    if (!index_cjs_js$5.exists(depsRoot) || !index_cjs_js$5.isDirectory(depsRoot))
+    if (!index_cjs_js$6.exists(depsRoot) || !index_cjs_js$6.isDirectory(depsRoot))
         return { orphanFilesRemoved: 0, bytesRemoved: 0 };
     const js = pruneJsOrphans(context, depsRoot);
     const dts = pruneDtsOrphans(context, depsRoot);
@@ -2373,7 +2419,7 @@ const collectImportEdges = (source, importerDir, format) => {
     return edges;
 };
 
-const log$4 = index_cjs_js$4.logger.channel('builder:bundle:dependencies:prune');
+const log$4 = index_cjs_js$5.logger.channel('builder:bundle:dependencies:prune');
 // why: the strip → re-derive → strip cycle converges in passes bounded by the chunk-import depth; this cap is a runaway guard, logged if ever reached.
 const MAX_ITERATIONS = 50;
 const FORMAT_FILES$1 = [
@@ -2398,7 +2444,7 @@ const buildUsageMap = (importers, chunks, format) => {
         usageMap.set(chunk, index_cjs_js$2.createSet([]));
     // why: every importer is either a validated entry file or a chunk just walked off disk, so all are present — no existence guard needed.
     for (const importer of importers) {
-        for (const [target, usage] of collectImportEdges(index_cjs_js$5.readFileContent(importer), index_cjs_js$5.getDirname(importer), format))
+        for (const [target, usage] of collectImportEdges(index_cjs_js$6.readFileContent(importer), index_cjs_js$6.getDirname(importer), format))
             mergeUsage(usageMap, target, usage);
     }
     return usageMap;
@@ -2406,11 +2452,11 @@ const buildUsageMap = (importers, chunks, format) => {
 const stripChunks = (usageMap, format, result) => {
     let changed = false;
     for (const [chunk, keep] of usageMap) {
-        const source = index_cjs_js$5.readFileContent(chunk);
+        const source = index_cjs_js$6.readFileContent(chunk);
         const stripped = stripDeadExports(source, format, keep);
         if (!stripped)
             continue;
-        index_cjs_js$5.writeFileContent(chunk, stripped.code);
+        index_cjs_js$6.writeFileContent(chunk, stripped.code);
         result.deadExportsRemoved += stripped.removedNames.length;
         result.bytesRemoved += Buffer.byteLength(source) - Buffer.byteLength(stripped.code);
         changed = true;
@@ -2454,7 +2500,7 @@ const processFormat$1 = (context, depsRoot, format, fileName, result) => {
  */
 const stripDeadExportsPass = (context, depsRoot) => {
     const result = { deadExportsRemoved: 0, bytesRemoved: 0 };
-    if (!index_cjs_js$5.exists(depsRoot))
+    if (!index_cjs_js$6.exists(depsRoot))
         return result;
     for (const { format, fileName } of FORMAT_FILES$1)
         processFormat$1(context, depsRoot, format, fileName, result);
@@ -2868,7 +2914,7 @@ const destructureRequires = (source, chunkDir, isSafeTarget) => {
     return { code: applyEdits(source, edits), rewrittenBindings: qualified.length };
 };
 
-const log$3 = index_cjs_js$4.logger.channel('builder:bundle:dependencies:prune');
+const log$3 = index_cjs_js$5.logger.channel('builder:bundle:dependencies:prune');
 const CJS_CHUNK = 'index.cjs.js';
 const collectRequireTargets = (source, chunkDir, chunkSet) => {
     const sourceFile = parseChunk(source);
@@ -2888,7 +2934,7 @@ const collectRequireTargets = (source, chunkDir, chunkSet) => {
 const buildRequireGraph = (chunks, chunkSet) => {
     const graph = index_cjs_js$b.createMap();
     for (const chunk of chunks)
-        graph.set(chunk, collectRequireTargets(index_cjs_js$5.readFileContent(chunk), index_cjs_js$5.getDirname(chunk), chunkSet));
+        graph.set(chunk, collectRequireTargets(index_cjs_js$6.readFileContent(chunk), index_cjs_js$6.getDirname(chunk), chunkSet));
     return graph;
 };
 /**
@@ -2982,7 +3028,7 @@ const computeSccIds = (nodes, graph) => {
  */
 const destructureRequiresPass = (depsRoot) => {
     const result = { requireBindingsDestructured: 0 };
-    if (!index_cjs_js$5.exists(depsRoot))
+    if (!index_cjs_js$6.exists(depsRoot))
         return result;
     const chunks = [];
     walkFiles(depsRoot, (name) => name === CJS_CHUNK, chunks);
@@ -2990,7 +3036,7 @@ const destructureRequiresPass = (depsRoot) => {
         return result;
     const sources = index_cjs_js$b.createMap();
     for (const chunk of chunks) {
-        const source = index_cjs_js$5.readFileContent(chunk);
+        const source = index_cjs_js$6.readFileContent(chunk);
         // why: a dynamic specifier could hide a require cycle the static graph misses; bail the whole pass, mirroring the orphan sweep's safety posture.
         if (hasDynamicSpecifier(source)) {
             log$3.warn(`dynamic import/require in ${chunk}; skipping require-destructure pass for safety`);
@@ -3006,10 +3052,10 @@ const destructureRequiresPass = (depsRoot) => {
         const source = sources.get(chunk);
         const myComponent = componentOf.get(chunk);
         const isSafeTarget = (target) => chunkSet.has(target) && componentOf.get(target) !== myComponent;
-        const rewritten = destructureRequires(source, index_cjs_js$5.getDirname(chunk), isSafeTarget);
+        const rewritten = destructureRequires(source, index_cjs_js$6.getDirname(chunk), isSafeTarget);
         if (!rewritten)
             continue;
-        index_cjs_js$5.writeFileContent(chunk, rewritten.code);
+        index_cjs_js$6.writeFileContent(chunk, rewritten.code);
         result.requireBindingsDestructured += rewritten.rewrittenBindings;
     }
     return result;
@@ -3173,11 +3219,11 @@ const FORMAT_FILES = [
     { format: 'cjs', fileName: 'index.cjs.js' },
 ];
 // why: a dynamic, non-literal `import(`/`require(` anywhere in the consumer graph means a consumer we cannot resolve might read a namespace wholesale — disable property-strip for the format (guaranteed-safe fallback, mirroring the orphan sweep).
-const graphHasDynamicSpecifier = (importers) => importers.some((importer) => hasDynamicSpecifier(index_cjs_js$5.readFileContent(importer)));
+const graphHasDynamicSpecifier = (importers) => importers.some((importer) => hasDynamicSpecifier(index_cjs_js$6.readFileContent(importer)));
 const collectChunkNamespaces = (chunks, format) => {
     const byChunk = index_cjs_js$b.createMap();
     for (const chunk of chunks) {
-        const { namespaces } = analyzeChunkNamespaces(index_cjs_js$5.readFileContent(chunk), format);
+        const { namespaces } = analyzeChunkNamespaces(index_cjs_js$6.readFileContent(chunk), format);
         if (namespaces.length > 0)
             byChunk.set(chunk, namespaces);
     }
@@ -3189,14 +3235,14 @@ const seedSelfDemand = (chunks, namespacesByChunk, format) => {
     for (const chunk of chunks) {
         if (!namespacesByChunk.has(chunk))
             continue;
-        const { selfDemand } = analyzeChunkNamespaces(index_cjs_js$5.readFileContent(chunk), format);
+        const { selfDemand } = analyzeChunkNamespaces(index_cjs_js$6.readFileContent(chunk), format);
         demand.set(chunk, selfDemand);
     }
     return demand;
 };
 const accumulateImporterDemand = (importers, namespacesByChunk, demand, format) => {
     for (const importer of importers) {
-        const edges = collectNamespaceUsage(index_cjs_js$5.readFileContent(importer), index_cjs_js$5.getDirname(importer), format);
+        const edges = collectNamespaceUsage(index_cjs_js$6.readFileContent(importer), index_cjs_js$6.getDirname(importer), format);
         for (const [target, usage] of edges) {
             const chunkDemand = demand.get(target);
             const namespaces = namespacesByChunk.get(target);
@@ -3234,11 +3280,11 @@ const rewriteChunks = (namespacesByChunk, demand, format, result) => {
         const keepByExport = keepSetsForChunk(namespaces, chunkDemand);
         if (keepByExport.size === 0)
             continue;
-        const source = index_cjs_js$5.readFileContent(chunk);
+        const source = index_cjs_js$6.readFileContent(chunk);
         const stripped = stripDeadProperties(source, format, keepByExport);
         if (!stripped)
             continue;
-        index_cjs_js$5.writeFileContent(chunk, stripped.code);
+        index_cjs_js$6.writeFileContent(chunk, stripped.code);
         result.deadPropertiesRemoved += stripped.removedProperties;
         result.bytesRemoved += Buffer.byteLength(source) - Buffer.byteLength(stripped.code);
     }
@@ -3286,7 +3332,7 @@ const processFormat = (context, depsRoot, format, fileName, result) => {
  */
 const stripDeadPropertiesPass = (context, depsRoot) => {
     const result = { deadPropertiesRemoved: 0, bytesRemoved: 0 };
-    if (!index_cjs_js$5.exists(depsRoot))
+    if (!index_cjs_js$6.exists(depsRoot))
         return result;
     for (const { format, fileName } of FORMAT_FILES)
         processFormat(context, depsRoot, format, fileName, result);
@@ -3413,22 +3459,22 @@ const stripComments = (source) => {
 
 const stripCommentsPass = (depsRoot) => {
     const result = { commentBytesRemoved: 0 };
-    if (!index_cjs_js$5.exists(depsRoot))
+    if (!index_cjs_js$6.exists(depsRoot))
         return result;
     const chunks = [];
     walkFiles(depsRoot, (name) => name === 'index.esm.js' || name === 'index.cjs.js', chunks);
     for (const chunk of chunks) {
-        const source = index_cjs_js$5.readFileContent(chunk);
+        const source = index_cjs_js$6.readFileContent(chunk);
         const stripped = stripComments(source);
         if (stripped === null)
             continue;
-        index_cjs_js$5.writeFileContent(chunk, stripped);
+        index_cjs_js$6.writeFileContent(chunk, stripped);
         result.commentBytesRemoved += Buffer.byteLength(source) - Buffer.byteLength(stripped);
     }
     return result;
 };
 
-const log$2 = index_cjs_js$4.logger.channel('builder:bundle:dependencies:prune');
+const log$2 = index_cjs_js$5.logger.channel('builder:bundle:dependencies:prune');
 
 const pruneDependencies = (context, monitor) => {
     const depsRoot = depsRootOf(context);
@@ -3694,53 +3740,35 @@ const toUmdBuildDescriptor = (entry, config, context, reportPath) => {
     };
 };
 
-const log$1 = index_cjs_js$4.logger.channel('builder:bundle:rollup:dispatch');
+const log$1 = index_cjs_js$5.logger.channel('builder:bundle:rollup:dispatch');
 const REPORT_DIR_PREFIX = 'hf-builder-rollup-';
-const SWC_NODE_REGISTER = '@swc-node/register';
-const swcNodeAvailable = (workspaceRoot) => node_fs.existsSync(index_cjs_js$5.join(workspaceRoot, 'node_modules', '@swc-node', 'register', 'index.js'));
 /**
- * Default worker-path resolution: prefers the built-and-published artifact, falls
- * back to the workspace dist path, and finally to the in-source TypeScript file
- * via `@swc-node/register` (bootstrap case where builder is building itself for
- * the first time and the dist worker doesn't exist yet).
- *
- * Looks at, in order:
- * 1. `<workspaceRoot>/dist/libs/builder/bundle/rollup/worker/index.cjs.js`
- * 2. `<workspaceRoot>/node_modules/@hyperfrontend/builder/bundle/rollup/worker/index.cjs.js`
- * 3. `<workspaceRoot>/libs/builder/src/bundle/rollup/worker/index.ts` (with `--require \@swc-node/register`)
- *
- * @param workspaceRoot - Absolute workspace root.
- * @returns Worker invocation descriptor, or `undefined` if no candidate exists.
- *
- * @example Locating the worker for an in-workspace consumer
+ * Resolves the rollup worker by self-locating it beside the running builder
+ * module: ascends from the module's own directory to the builder package root
+ * and returns the worker at `bundle/rollup/worker`. This works whether the
+ * builder runs from its built dist, an installed `node_modules` copy, or melded
+ * into a host bundle under `_dependencies/`. The compiled `index.cjs.js` is
+ * preferred; an `index.ts` sibling resolves with the `@swc-node/register` loader
+ * for source-mode bootstrap.
+ *
+ * @param startDir - Directory to begin the ascent from. Defaults to the running module's directory; pass an explicit value to resolve from another anchor or under test.
+ * @returns Worker invocation descriptor, or `undefined` if no worker is found under any ancestor.
+ *
+ * @example Locating the worker beside the builder
  * ```typescript
- * const invocation = resolveDefaultRollupWorkerPath('/abs/repo')
+ * const invocation = resolveDefaultRollupWorkerPath()
  * if (!invocation) throw new Error('builder rollup worker artifact not found')
  * ```
  */
-const resolveDefaultRollupWorkerPath = (workspaceRoot) => {
-    const distCandidates = [
-        index_cjs_js$5.join(workspaceRoot, 'dist', 'libs', 'builder', 'bundle', 'rollup', 'worker', 'index.cjs.js'),
-        index_cjs_js$5.join(workspaceRoot, 'node_modules', '@hyperfrontend', 'builder', 'bundle', 'rollup', 'worker', 'index.cjs.js'),
-    ];
-    for (const path of distCandidates) {
-        if (node_fs.existsSync(path))
-            return { path, execArgv: [] };
-    }
-    const sourcePath = index_cjs_js$5.join(workspaceRoot, 'libs', 'builder', 'src', 'bundle', 'rollup', 'worker', 'index.ts');
-    if (node_fs.existsSync(sourcePath) && swcNodeAvailable(workspaceRoot)) {
-        return { path: sourcePath, execArgv: ['--require', SWC_NODE_REGISTER] };
-    }
-    return undefined;
-};
-const createReportDir = () => node_fs.mkdtempSync(index_cjs_js$5.join(node_os.tmpdir(), REPORT_DIR_PREFIX));
+const resolveDefaultRollupWorkerPath = (startDir) => ascendForWorker(['bundle', 'rollup', 'worker'], startDir);
+const createReportDir = () => node_fs.mkdtempSync(index_cjs_js$6.join(node_os.tmpdir(), REPORT_DIR_PREFIX));
 const reportPathFor = (reportDir, descriptor) => {
     const safeLabel = descriptor.inputFile.replace(/[^a-zA-Z0-9_-]+/g, '_');
-    return index_cjs_js$5.join(reportDir, `${descriptor.format}-${safeLabel}.json`);
+    return index_cjs_js$6.join(reportDir, `${descriptor.format}-${safeLabel}.json`);
 };
 const runOne = (descriptor, options, label) => index_cjs_js.createPromise((resolve, reject) => {
     const execPath = options.execPath ?? process.execPath;
-    const argv = [...(options.execArgv ?? []), options.workerPath, index_cjs_js$6.stringify(descriptor)];
+    const argv = [...(options.execArgv ?? []), options.workerPath, index_cjs_js$7.stringify(descriptor)];
     const child = node_child_process.spawn(execPath, argv, { stdio: ['ignore', 'pipe', 'pipe'] });
     let capturedStderr = '';
     child.stdout?.on('data', (chunk) => {
@@ -3752,12 +3780,12 @@ const runOne = (descriptor, options, label) => index_cjs_js.createPromise((resol
         process.stderr.write(text);
     });
     child.on('error', (error) => {
-        reject(index_cjs_js$7.createError(`rollup worker for ${label} failed to spawn: ${error.message}`));
+        reject(index_cjs_js$4.createError(`rollup worker for ${label} failed to spawn: ${error.message}`));
     });
     child.on('exit', (code) => {
         if (code !== 0) {
             const tail = capturedStderr.trim().split('\n').slice(-10).join('\n');
-            reject(index_cjs_js$7.createError(`rollup worker for ${label} exited with code ${code}\n${tail}`));
+            reject(index_cjs_js$4.createError(`rollup worker for ${label} exited with code ${code}\n${tail}`));
             return;
         }
         resolve();
@@ -3765,9 +3793,9 @@ const runOne = (descriptor, options, label) => index_cjs_js.createPromise((resol
 });
 const readReport = (reportPath, label) => {
     if (!node_fs.existsSync(reportPath)) {
-        throw index_cjs_js$7.createError(`rollup worker for ${label} did not write a report at ${reportPath}`);
+        throw index_cjs_js$4.createError(`rollup worker for ${label} did not write a report at ${reportPath}`);
     }
-    const data = index_cjs_js$6.parse(node_fs.readFileSync(reportPath, 'utf8'));
+    const data = index_cjs_js$7.parse(node_fs.readFileSync(reportPath, 'utf8'));
     return data;
 };
 /**
@@ -3811,7 +3839,7 @@ const dispatchRollupWorker = async (descriptor, options) => {
     }
 };
 
-const log = index_cjs_js$4.logger.channel('builder:bundle');
+const log = index_cjs_js$5.logger.channel('builder:bundle');
 const toArray = (value) => (value === undefined ? [] : index_cjs_js$3.isArray(value) ? value : [value]);
 const collectFormatsRequestingPrePass = (config) => {
     const formats = index_cjs_js$2.createSet([]);
@@ -3838,7 +3866,7 @@ const buildJsPrePassJobs = (deps, formats, context) => {
                 dep,
                 inputPath: entry,
                 format,
-                outputPath: index_cjs_js$5.join(depsRoot, dep, chunkFileName(format)),
+                outputPath: index_cjs_js$6.join(depsRoot, dep, chunkFileName(format)),
                 otherDeps: [...otherNpmDeps, ...workspacePrefixDeps],
                 otherWorkspaceSpecifiers: workspaceExactSpecifiers,
                 npmDeps: otherNpmDeps,
@@ -3871,7 +3899,7 @@ const buildWorkspaceJsPrePassJobs = (npmDeps, formats, context) => {
                 dep: entry.specifier,
                 inputPath: entry.inputPath,
                 format,
-                outputPath: index_cjs_js$5.join(depsRoot, workspaceOutputFile(entry, format)),
+                outputPath: index_cjs_js$6.join(depsRoot, workspaceOutputFile(entry, format)),
                 otherDeps: [...npmDeps, ...otherWorkspacePackages],
                 otherWorkspaceSpecifiers: otherSubPathSpecifiers,
                 tsConfigPath: entry.tsConfigPath,
@@ -3884,25 +3912,25 @@ const buildWorkspaceJsPrePassJobs = (npmDeps, formats, context) => {
     }
     return jobs;
 };
-const resolvePrePassWorkerOrThrow = (workspaceRoot) => {
-    const invocation = resolveDefaultWorkerPath(workspaceRoot);
+const resolvePrePassWorkerOrThrow = () => {
+    const invocation = resolveDefaultWorkerPath();
     if (!invocation) {
-        throw index_cjs_js$7.createError('bundleAllDeps is enabled but the pre-pass worker could not be resolved. Build @hyperfrontend/builder once with bundleAllDeps disabled, or ensure @swc-node/register is installed for source-mode bootstrap.');
+        throw index_cjs_js$4.createError('bundleAllDeps is enabled but the pre-pass worker could not be located beside the builder module. The @hyperfrontend/builder package appears incomplete, or @swc-node/register is missing for source-mode bootstrap.');
     }
     return invocation;
 };
-const resolveRollupWorkerOrThrow = (workspaceRoot) => {
-    const invocation = resolveDefaultRollupWorkerPath(workspaceRoot);
+const resolveRollupWorkerOrThrow = () => {
+    const invocation = resolveDefaultRollupWorkerPath();
     if (!invocation) {
-        throw index_cjs_js$7.createError('rollup worker could not be resolved. Build @hyperfrontend/builder at least once before invoking the bundle phase, or ensure @swc-node/register is installed for source-mode bootstrap.');
+        throw index_cjs_js$4.createError('rollup worker could not be located beside the builder module. The @hyperfrontend/builder package appears incomplete, or @swc-node/register is missing for source-mode bootstrap.');
     }
     return invocation;
 };
-const createLazyDispatchResolver = (workspaceRoot) => {
+const createLazyDispatchResolver = () => {
     let cached = null;
     return () => {
         if (!cached) {
-            const invocation = resolveRollupWorkerOrThrow(workspaceRoot);
+            const invocation = resolveRollupWorkerOrThrow();
             cached = { workerPath: invocation.path, execArgv: invocation.execArgv };
         }
         return cached;
@@ -3946,7 +3974,7 @@ const runIifeFormats = async (config, context, outputs, resolveDispatch, monitor
         const entries = resolveEntries(iifeConfig, context.entryPointDiscovery.entryPoints);
         if (entries.length === 0)
             continue;
-        index_cjs_js$5.ensureDir(index_cjs_js$5.join(context.outputPath, iifeConfig.output ?? 'bundle'));
+        index_cjs_js$6.ensureDir(index_cjs_js$6.join(context.outputPath, iifeConfig.output ?? 'bundle'));
         for (const [i, entry] of entries.entries()) {
             const label = `iife:${i}/${entries.length}:${entry.exportPath}`;
             monitor?.check(`bundle:${label}:start`);
@@ -3962,7 +3990,7 @@ const runUmdFormats = async (config, context, outputs, resolveDispatch, monitor)
         const entries = resolveEntries(umdConfig, context.entryPointDiscovery.entryPoints);
         if (entries.length === 0)
             continue;
-        index_cjs_js$5.ensureDir(index_cjs_js$5.join(context.outputPath, umdConfig.output ?? 'bundle'));
+        index_cjs_js$6.ensureDir(index_cjs_js$6.join(context.outputPath, umdConfig.output ?? 'bundle'));
         for (const [i, entry] of entries.entries()) {
             const label = `umd:${i}/${entries.length}:${entry.exportPath}`;
             monitor?.check(`bundle:${label}:start`);
@@ -3996,7 +4024,7 @@ const runBundlePhase = async (context, config, monitor) => {
     const outputs = { esm: [], cjs: [], iife: [], umd: [] };
     const requestedPrePassFormats = collectFormatsRequestingPrePass(config);
     if (requestedPrePassFormats.length > 0 && (context.bundledDeps.length > 0 || context.workspaceBundledDeps.length > 0)) {
-        const invocation = resolvePrePassWorkerOrThrow(context.workspaceRoot);
+        const invocation = resolvePrePassWorkerOrThrow();
         const npmJobs = buildJsPrePassJobs(context.bundledDeps, requestedPrePassFormats, context);
         const workspaceJobs = buildWorkspaceJsPrePassJobs(context.bundledDeps, requestedPrePassFormats, context);
         const jobs = [...npmJobs, ...workspaceJobs];
@@ -4005,7 +4033,7 @@ const runBundlePhase = async (context, config, monitor) => {
         await runPrePass(jobs, { workerPath: invocation.path, execArgv: invocation.execArgv, monitor });
         monitor?.check('bundle:dependencies:prepass:end');
     }
-    const resolveDispatch = createLazyDispatchResolver(context.workspaceRoot);
+    const resolveDispatch = createLazyDispatchResolver();
     await runEsmFormats(config, context, outputs, resolveDispatch, monitor);
     await recover();
     monitor?.check('bundle:esm:end:post-recover');
@@ -4034,7 +4062,7 @@ const runBundlePhase = async (context, config, monitor) => {
         monitor?.check('bundle:dedupe:shared-first-party:end');
     }
     // why: runs last (after the final file-producing pass) so no later pass re-creates a file under a removed directory; sweeps the per-source dirs left empty by the orphan-d.ts prune across the whole package, not just `_dependencies/`. Guarded for the degenerate case where no format produced an output tree.
-    if (index_cjs_js$5.exists(context.outputPath)) {
+    if (index_cjs_js$6.exists(context.outputPath)) {
         const emptyDirsRemoved = removeEmptyDirs(context.outputPath);
         if (emptyDirsRemoved > 0)
             log.info(`removed ${emptyDirsRemoved} empty director${emptyDirsRemoved === 1 ? 'y' : 'ies'}`);