@hyperfrontend/builder 0.1.0

package/index.d.ts

@@ -0,0 +1,64 @@
+export { MemoryMonitor, MemorySnapshot, createMemoryMonitor, recover } from './memory';
+import { BuildConfig, BuildResult, BuildContext } from './models';
+export { AssetConditionPredicate, AssetSpec, AuthorField, BinConfig, BinFormatSpec, BinOutput, BinScriptFormat, BugsField, BuildConfig, BuildContext, BuildResult, BundleAllDepsOptions, CjsConfig, ConditionalExport, EntryPoint, EntryPointCategory, EntryPointDiscovery, EntryPointPlatform, EsmConfig, ExportValue, FormatCounts, FormatEntryConfig, FormatOutputs, FundingField, IifeConfig, IifeOutput, InheritFromSpec, IsWorkspacePackagePredicate, MemoryMonitorOptions, PackageJson, RepositoryField, SeaConfig, SeaPlatform, UmdConfig, UmdOutput, WorkspaceBundledDep, WorkspaceDepHoistPolicy } from './models';
+export { runBinPhase } from './bin';
+export { runBundlePhase } from './bundle';
+export { runPackagePhase } from './package';
+export { byNames, byPrefix } from './presets';
+
+/**
+ * Resolves a {@link BuildContext} from a top-level {@link BuildConfig}.
+ *
+ * Defaults applied:
+ * - `outputPath` → `<workspaceRoot>/dist/<projectRelativePath>`
+ * - `tsConfigPath` → `<projectRoot>/tsconfig.lib.json`
+ * - `external` → `[]`
+ * - `assets` → `[]`
+ * - `isWorkspacePackage` → predicate that always returns `false`
+ *
+ * Entry-point discovery is performed against `<projectRoot>/src` exactly once
+ * during context creation.
+ *
+ * @param config - Top-level builder configuration.
+ * @returns Resolved context consumed by the bundle, package, and bin phases.
+ *
+ * @example Building a context manually for a custom orchestrator
+ * ```typescript
+ * const context = createBuildContext({ projectRoot, workspaceRoot })
+ * await runBundlePhase(context, config)
+ * ```
+ */
+declare const createBuildContext: (config: BuildConfig) => BuildContext;
+/**
+ * The single facade that orchestrates a complete build: resolves the context,
+ * optionally enables the memory monitor, then runs the bundle, package, and bin
+ * phases in order before reflecting `package.json#files` from the materialized
+ * output tree. Returns a {@link BuildResult} summarizing what was emitted and
+ * how long it took.
+ *
+ * A failure in any phase still flushes the memory-monitor summary (when
+ * enabled) before re-throwing the original error.
+ *
+ * @param config - Top-level builder configuration.
+ * @returns A `BuildResult` with per-format counts, raw format outputs, bin
+ * outputs, and total duration in milliseconds.
+ * @throws {Error} Whatever any phase throws — the facade does not swallow errors.
+ *
+ * @example Building a library with workspace-aware externals
+ * ```typescript
+ * import { build } from '@hyperfrontend/builder'
+ * import { byPrefix } from '@hyperfrontend/builder/presets'
+ *
+ * const result = await build({
+ *   projectRoot: '/abs/libs/foo',
+ *   workspaceRoot: '/abs/repo',
+ *   isWorkspacePackage: byPrefix('@hyperfrontend/'),
+ *   esm: { bundleWorkspaceDeps: false },
+ *   cjs: { bundleWorkspaceDeps: false },
+ * })
+ * result.formatCounts.esm // => number of ESM entries emitted
+ * ```
+ */
+declare const build: (config: BuildConfig) => Promise<BuildResult>;
+
+export { build, createBuildContext };

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/builder/src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC7D,YAAY,EACV,uBAAuB,EACvB,SAAS,EACT,WAAW,EACX,SAAS,EACT,aAAa,EACb,SAAS,EACT,eAAe,EACf,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,UAAU,EACV,eAAe,EACf,2BAA2B,EAC3B,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,SAAS,EACT,WAAW,EACX,SAAS,EACT,SAAS,EACT,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AACnC,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA"}