@hyperfrontend/builder 0.1.0

package/bundle/rollup/descriptor.d.ts

@@ -0,0 +1,99 @@
+import type { BinConfig, BinScriptFormat, BuildContext, CjsConfig, EntryPoint, EsmConfig, IifeConfig, UmdConfig } from '../../models';
+import type { RollupBuildDescriptor } from './worker/types';
+/**
+ * Builds the worker descriptor for the ESM output of a single entry point.
+ *
+ * The returned descriptor is fully serializable (no functions), ready to be
+ * passed to {@link dispatchRollupWorker}.
+ *
+ * @param entry - Entry point to compile.
+ * @param config - ESM-format configuration.
+ * @param context - Resolved build context.
+ * @param reportPath - Absolute path the worker will write its JSON report to.
+ * @returns Descriptor ready to be JSON-serialized for the worker.
+ *
+ * @example Producing the descriptor for the root entry
+ * ```typescript
+ * const descriptor = toEsmBuildDescriptor(entry, esmConfig, context, '/tmp/report.json')
+ * ```
+ */
+export declare const toEsmBuildDescriptor: (entry: EntryPoint, config: EsmConfig, context: BuildContext, reportPath: string) => RollupBuildDescriptor;
+/**
+ * Builds the worker descriptor for the CommonJS output of a single entry point.
+ *
+ * @param entry - Entry point to compile.
+ * @param config - CJS-format configuration.
+ * @param context - Resolved build context.
+ * @param reportPath - Absolute path the worker will write its JSON report to.
+ * @returns Descriptor ready to be JSON-serialized for the worker.
+ *
+ * @example Producing the descriptor for the root entry
+ * ```typescript
+ * const descriptor = toCjsBuildDescriptor(entry, cjsConfig, context, '/tmp/report.json')
+ * ```
+ */
+export declare const toCjsBuildDescriptor: (entry: EntryPoint, config: CjsConfig, context: BuildContext, reportPath: string) => RollupBuildDescriptor;
+/**
+ * Builds the worker descriptor for an IIFE bundle of a single entry point.
+ *
+ * Validates the externals/globals pairing eagerly, throwing before the
+ * descriptor is returned.
+ *
+ * @param entry - Entry point to bundle.
+ * @param config - IIFE-format configuration.
+ * @param context - Resolved build context.
+ * @param reportPath - Absolute path the worker will write its JSON report to.
+ * @returns Descriptor ready to be JSON-serialized for the worker.
+ * @throws {Error} When `config.external` is non-empty but `config.globals` is missing entries.
+ *
+ * @example Producing the descriptor for an IIFE bundle
+ * ```typescript
+ * const descriptor = toIifeBuildDescriptor(entry, iifeConfig, context, '/tmp/report.json')
+ * ```
+ */
+export declare const toIifeBuildDescriptor: (entry: EntryPoint, config: IifeConfig, context: BuildContext, reportPath: string) => RollupBuildDescriptor;
+/**
+ * Builds the worker descriptor for a single bin output (one (bin, format) pair).
+ *
+ * Bins are self-contained executable scripts: workspace deps are inlined and the
+ * worker writes to `<outputPath>/bin/<name>.<ext>` with the shebang banner, the
+ * resolved bootstrap footer, and `chmod 0o755` applied.
+ *
+ * Output naming convention:
+ * - ESM: `<name>.mjs`
+ * - CJS only: `<name>.js`
+ * - CJS alongside ESM: `<name>.cjs.js`
+ *
+ * @param bin - Bin declaration including name, runner, and per-bin bootstrap override.
+ * @param context - Resolved build context.
+ * @param format - Format being built (one of `bin.format`'s entries).
+ * @param formats - Full list of formats requested for this bin (drives the CJS filename).
+ * @param reportPath - Absolute path the worker will write its JSON report to.
+ * @returns Descriptor ready to be JSON-serialized for the worker.
+ *
+ * @example Producing the descriptor for an `hf-build` CJS bin alongside an ESM twin
+ * ```typescript
+ * const descriptor = toBinBuildDescriptor(bin, context, 'cjs', ['cjs', 'esm'], '/tmp/r.json')
+ * ```
+ */
+export declare const toBinBuildDescriptor: (bin: BinConfig, context: BuildContext, format: BinScriptFormat, formats: BinScriptFormat[], reportPath: string) => RollupBuildDescriptor;
+/**
+ * Builds the worker descriptor for a UMD bundle of a single entry point.
+ *
+ * Validates the externals/globals pairing eagerly, throwing before the
+ * descriptor is returned.
+ *
+ * @param entry - Entry point to bundle.
+ * @param config - UMD-format configuration.
+ * @param context - Resolved build context.
+ * @param reportPath - Absolute path the worker will write its JSON report to.
+ * @returns Descriptor ready to be JSON-serialized for the worker.
+ * @throws {Error} When `config.external` is non-empty but `config.globals` is missing entries.
+ *
+ * @example Producing the descriptor for a UMD bundle
+ * ```typescript
+ * const descriptor = toUmdBuildDescriptor(entry, umdConfig, context, '/tmp/report.json')
+ * ```
+ */
+export declare const toUmdBuildDescriptor: (entry: EntryPoint, config: UmdConfig, context: BuildContext, reportPath: string) => RollupBuildDescriptor;
+//# sourceMappingURL=descriptor.d.ts.map

package/bundle/rollup/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/builder/src/bundle/rollup/descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACrI,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAc3D;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,UAAU,EACjB,QAAQ,SAAS,EACjB,SAAS,YAAY,EACrB,YAAY,MAAM,KACjB,qBAgCF,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,UAAU,EACjB,QAAQ,SAAS,EACjB,SAAS,YAAY,EACrB,YAAY,MAAM,KACjB,qBAgCF,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,UAAU,EACjB,QAAQ,UAAU,EAClB,SAAS,YAAY,EACrB,YAAY,MAAM,KACjB,qBAqBF,CAAA;AAaD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,KAAK,SAAS,EACd,SAAS,YAAY,EACrB,QAAQ,eAAe,EACvB,SAAS,eAAe,EAAE,EAC1B,YAAY,MAAM,KACjB,qBA8BF,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,UAAU,EACjB,QAAQ,SAAS,EACjB,SAAS,YAAY,EACrB,YAAY,MAAM,KACjB,qBAqBF,CAAA"}

package/bundle/rollup/dispatch.d.ts

@@ -0,0 +1,72 @@
+import type { MemoryMonitor } from '../../memory/monitor';
+import type { RollupBuildDescriptor, RollupWorkerReport } from './worker/types';
+/**
+ * Caller-supplied options threaded through {@link dispatchRollupWorker}.
+ */
+export interface DispatchRollupWorkerOptions {
+    /** Absolute path to the worker entry script. Required — see `resolveDefaultRollupWorkerPath`. */
+    workerPath: string;
+    /** Optional memory monitor invoked before and after the spawned worker. */
+    monitor?: MemoryMonitor;
+    /** Override `process.execPath` for the spawned worker (used by tests). */
+    execPath?: string;
+    /** Extra arguments prepended to the worker invocation (e.g. `['--require', '@swc-node/register']`). */
+    execArgv?: string[];
+    /** Human-readable label for log lines and monitor checkpoints (e.g. `esm:./browser`). */
+    label?: string;
+}
+/**
+ * Resolved worker invocation: absolute path + any extra Node args (e.g. `--require \@swc-node/register`
+ * when the worker is loaded from TypeScript source during a bootstrap build).
+ */
+export interface RollupWorkerInvocation {
+    /** Absolute path to the worker entry script. */
+    path: string;
+    /** Extra args prepended to the spawned child's argv. */
+    execArgv: string[];
+}
+/**
+ * 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
+ * ```typescript
+ * const invocation = resolveDefaultRollupWorkerPath('/abs/repo')
+ * if (!invocation) throw new Error('builder rollup worker artifact not found')
+ * ```
+ */
+export declare const resolveDefaultRollupWorkerPath: (workspaceRoot: string) => RollupWorkerInvocation | undefined;
+/**
+ * Forks a single rollup worker for the supplied descriptor and waits for it
+ * to exit. The caller-provided descriptor's `reportPath` is overwritten with
+ * a temp-dir path created by this function.
+ *
+ * Each worker writes a JSON report at the temp path; this function reads it
+ * after the child exits and returns the per-job statistics. If the worker
+ * exits non-zero or fails to produce a report, the function throws with a
+ * label-rich message.
+ *
+ * The temp report directory is cleaned up before returning, regardless of
+ * success or failure.
+ *
+ * @param descriptor - Build descriptor to dispatch.
+ * @param options - Worker path + optional memory monitor.
+ * @returns Worker report (output size + memory + duration) for the dispatched job.
+ *
+ * @example Dispatching a single ESM build
+ * ```typescript
+ * const report = await dispatchRollupWorker(descriptor, { workerPath: '/abs/dist/.../worker.cjs.js' })
+ * ```
+ */
+export declare const dispatchRollupWorker: (descriptor: RollupBuildDescriptor, options: DispatchRollupWorkerOptions) => Promise<RollupWorkerReport>;
+//# sourceMappingURL=dispatch.d.ts.map

package/bundle/rollup/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/builder/src/bundle/rollup/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAY/E;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,iGAAiG;IACjG,UAAU,EAAE,MAAM,CAAA;IAClB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uGAAuG;IACvG,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAQD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,8BAA8B,GAAI,eAAe,MAAM,KAAG,sBAAsB,GAAG,SAa/F,CAAA;AA4CD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,qBAAqB,EACjC,SAAS,2BAA2B,KACnC,OAAO,CAAC,kBAAkB,CAkB5B,CAAA"}