@hyperfrontend/builder 0.1.0

package/models/build-context.d.ts

@@ -0,0 +1,68 @@
+import type { AssetSpec, IsWorkspacePackagePredicate, WorkspaceDepHoistPolicy } from './build-config';
+import type { EntryPointDiscovery } from './entry-point';
+/**
+ * Per-package workspace dependency to bundle into a hoisted chunk under
+ * `_dependencies/<packageName>(/<sub>)?`.
+ *
+ * The default set is `package.json#dependencies` intersected with the workspace
+ * predicate.
+ */
+export interface WorkspaceBundledDep {
+    /** Workspace package name (e.g. `@hyperfrontend/logging`). */
+    packageName: string;
+    /** Sub-path under the package; `''` for the package root. */
+    subPath: string;
+    /** Public import specifier the entry resolves: `<packageName>` or `<packageName>/<subPath>`. */
+    specifier: string;
+    /** Absolute path to the source `.ts` file resolved via tsconfig path mappings. */
+    inputPath: string;
+    /**
+     * Absolute path to the dep's own tsconfig (e.g. `tsconfig.lib.json`), so the
+     * dep is compiled with its own options rather than the consumer project's.
+     */
+    tsConfigPath: string;
+    /** Hoist policy for this dep's chunk(s); see {@link WorkspaceDepHoistPolicy}. */
+    policy: WorkspaceDepHoistPolicy;
+}
+/**
+ * Resolved, fully-computed runtime context derived from a `BuildConfig`.
+ *
+ * Unlike `BuildConfig`, every path and option here has been resolved to an absolute
+ * value and every default has been filled in. Builder primitives consume the
+ * `BuildContext`, never the raw config.
+ */
+export interface BuildContext {
+    /** Absolute path to the project being built. */
+    projectRoot: string;
+    /** Absolute path to the workspace root. */
+    workspaceRoot: string;
+    /** Project path relative to the workspace root (forward-slash separated). */
+    projectRelativePath: string;
+    /** Resolved absolute output directory. */
+    outputPath: string;
+    /** Resolved absolute path to the project's tsconfig. */
+    tsConfigPath: string;
+    /** Global external dependencies to exclude from every bundle. */
+    external: string[];
+    /** Asset specs to materialize. */
+    assets: AssetSpec[];
+    /** Workspace-package predicate, normalized to always-defined. */
+    isWorkspacePackage: IsWorkspacePackagePredicate;
+    /** Result of the entry-point discovery scan. */
+    entryPointDiscovery: EntryPointDiscovery;
+    /**
+     * Third-party deps bundled into `_dependencies/<dep>/` and stripped from the
+     * output `package.json`. Empty unless at least one format declares
+     * `bundleAllDeps`.
+     */
+    bundledDeps: string[];
+    /**
+     * Workspace deps bundled into `_dependencies/<packageName>(/<sub>)?/`. Empty
+     * unless at least one format declares `bundleAllDeps` and the project declares
+     * workspace deps.
+     */
+    workspaceBundledDeps: WorkspaceBundledDep[];
+    /** Wall-clock timestamp captured at context creation, used for `BuildResult.durationMs`. */
+    startedAt: number;
+}
+//# sourceMappingURL=build-context.d.ts.map

package/models/build-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-context.d.ts","sourceRoot":"","sources":["../../../../../../../libs/builder/src/models/build-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AACrG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAA;IACnB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAA;IACf,gGAAgG;IAChG,SAAS,EAAE,MAAM,CAAA;IACjB,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB,iFAAiF;IACjF,MAAM,EAAE,uBAAuB,CAAA;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAA;IACnB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAA;IACrB,6EAA6E;IAC7E,mBAAmB,EAAE,MAAM,CAAA;IAC3B,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAA;IACpB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,kCAAkC;IAClC,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,iEAAiE;IACjE,kBAAkB,EAAE,2BAA2B,CAAA;IAC/C,gDAAgD;IAChD,mBAAmB,EAAE,mBAAmB,CAAA;IACxC;;;;OAIG;IACH,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB;;;;OAIG;IACH,oBAAoB,EAAE,mBAAmB,EAAE,CAAA;IAC3C,4FAA4F;IAC5F,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/models/build-result.d.ts

@@ -0,0 +1,43 @@
+import type { FormatOutputs } from './format-output';
+/**
+ * Per-format counts emitted during a build, derived from `FormatOutputs`.
+ */
+export interface FormatCounts {
+    /** Number of ESM entry points emitted. */
+    esm: number;
+    /** Number of CommonJS entry points emitted. */
+    cjs: number;
+    /** Number of IIFE bundles emitted. */
+    iife: number;
+    /** Number of UMD bundles emitted. */
+    umd: number;
+}
+/**
+ * Output record describing a single emitted bin (per format and per platform).
+ */
+export interface BinOutput {
+    /** Bin name (matches the configured `BinConfig.name`). */
+    name: string;
+    /** Output kind: a JS script for one of the supported formats, or a native SEA binary. */
+    kind: 'cjs' | 'esm' | 'native';
+    /** Absolute path to the emitted artifact. */
+    outputPath: string;
+    /** Native target identifier (e.g., `linux-x64`); present only when `kind === 'native'`. */
+    platform?: string;
+}
+/**
+ * Final result returned by the `build()` facade.
+ */
+export interface BuildResult {
+    /** Whether the build completed without throwing. Always `true` when `build()` resolves. */
+    success: true;
+    /** Per-format counts of emitted artifacts. */
+    formatCounts: FormatCounts;
+    /** Aggregated per-format outputs. */
+    formatOutputs: FormatOutputs;
+    /** Bins emitted (JS scripts and / or native binaries). */
+    binOutputs: BinOutput[];
+    /** Total wall-clock duration in milliseconds. */
+    durationMs: number;
+}
+//# sourceMappingURL=build-result.d.ts.map

package/models/build-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-result.d.ts","sourceRoot":"","sources":["../../../../../../../libs/builder/src/models/build-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAA;IACX,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAA;IACX,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;IACZ,yFAAyF;IACzF,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAA;IAC9B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,2FAA2F;IAC3F,OAAO,EAAE,IAAI,CAAA;IACb,8CAA8C;IAC9C,YAAY,EAAE,YAAY,CAAA;IAC1B,qCAAqC;IACrC,aAAa,EAAE,aAAa,CAAA;IAC5B,0DAA0D;IAC1D,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAA;CACnB"}

package/models/entry-point.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Structural pattern of a library's entry-point layout.
+ *
+ * - `root`: single entry at `src/index.ts`
+ * - `platform`: browser / node split under `src/browser/` and `src/node/`
+ * - `feature`: multiple feature modules under `src/<feature>/`
+ * - `hybrid`: a mix of root, platform, and / or feature entries
+ * - `complex`: nested platform-plus-feature structures
+ */
+export type EntryPointCategory = 'root' | 'platform' | 'feature' | 'hybrid' | 'complex';
+/**
+ * Platform hint used for browser / node-specific entry points.
+ */
+export type EntryPointPlatform = 'browser' | 'node';
+/**
+ * A single resolved entry point within a library.
+ */
+export interface EntryPoint {
+    /** Subpath export key relative to the package root (e.g., `.`, `./browser`, `./browser/v1`). */
+    exportPath: string;
+    /** Path inside `src/` to the entry directory (e.g., ``, `browser`, `browser/v1`). */
+    srcPath: string;
+    /** Absolute path to the entry source file (e.g., `<projectRoot>/src/<srcPath>/index.ts`). */
+    inputFile: string;
+    /** True when the entry corresponds to `src/index.ts`. */
+    isRoot: boolean;
+    /** Platform hint when the entry lives under `src/browser/` or `src/node/`. */
+    platform?: EntryPointPlatform;
+}
+/**
+ * Result of scanning a library for its entry points.
+ */
+export interface EntryPointDiscovery {
+    /** Detected layout category. */
+    category: EntryPointCategory;
+    /** Every discovered entry point in stable order. */
+    entryPoints: EntryPoint[];
+    /** Whether `src/index.ts` exists. */
+    hasRootEntry: boolean;
+    /** Subset of entries flagged with a platform hint. */
+    platformEntries: EntryPoint[];
+    /** Subset of feature / module entries (non-root, non-platform). */
+    featureEntries: EntryPoint[];
+}
+//# sourceMappingURL=entry-point.d.ts.map

package/models/entry-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-point.d.ts","sourceRoot":"","sources":["../../../../../../../libs/builder/src/models/entry-point.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEvF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,MAAM,CAAA;AAEnD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,gGAAgG;IAChG,UAAU,EAAE,MAAM,CAAA;IAClB,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAA;IACf,6FAA6F;IAC7F,SAAS,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,MAAM,EAAE,OAAO,CAAA;IACf,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,kBAAkB,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,oDAAoD;IACpD,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,qCAAqC;IACrC,YAAY,EAAE,OAAO,CAAA;IACrB,sDAAsD;IACtD,eAAe,EAAE,UAAU,EAAE,CAAA;IAC7B,mEAAmE;IACnE,cAAc,EAAE,UAAU,EAAE,CAAA;CAC7B"}

package/models/format-output.d.ts

@@ -0,0 +1,34 @@
+import type { IifeConfig, UmdConfig } from './build-config';
+import type { EntryPoint } from './entry-point';
+/**
+ * Build output for a single IIFE bundle.
+ */
+export interface IifeOutput {
+    /** Resolved IIFE configuration that produced the bundle. */
+    config: IifeConfig;
+    /** Entry points combined into the bundle. */
+    entries: EntryPoint[];
+}
+/**
+ * Build output for a single UMD bundle.
+ */
+export interface UmdOutput {
+    /** Resolved UMD configuration that produced the bundle. */
+    config: UmdConfig;
+    /** Entry points combined into the bundle. */
+    entries: EntryPoint[];
+}
+/**
+ * Aggregate per-format output collected during the bundle phase.
+ */
+export interface FormatOutputs {
+    /** ESM entry points emitted. */
+    esm: EntryPoint[];
+    /** CommonJS entry points emitted. */
+    cjs: EntryPoint[];
+    /** IIFE bundles emitted. */
+    iife: IifeOutput[];
+    /** UMD bundles emitted. */
+    umd: UmdOutput[];
+}
+//# sourceMappingURL=format-output.d.ts.map

package/models/format-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-output.d.ts","sourceRoot":"","sources":["../../../../../../../libs/builder/src/models/format-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,MAAM,EAAE,UAAU,CAAA;IAClB,6CAA6C;IAC7C,OAAO,EAAE,UAAU,EAAE,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,MAAM,EAAE,SAAS,CAAA;IACjB,6CAA6C;IAC7C,OAAO,EAAE,UAAU,EAAE,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,GAAG,EAAE,UAAU,EAAE,CAAA;IACjB,qCAAqC;IACrC,GAAG,EAAE,UAAU,EAAE,CAAA;IACjB,4BAA4B;IAC5B,IAAI,EAAE,UAAU,EAAE,CAAA;IAClB,2BAA2B;IAC3B,GAAG,EAAE,SAAS,EAAE,CAAA;CACjB"}

package/models/index.cjs.js

@@ -0,0 +1,2 @@
+'use strict';
+