@hyperfrontend/builder 0.1.0

package/bundle/declarations/dts-per-entry.d.ts

@@ -0,0 +1,27 @@
+import type { MemoryMonitor } from '../../memory/monitor';
+import type { BuildContext } from '../../models';
+/**
+ * Runs the per-entry d.ts inlining pass: re-runs `rollup-plugin-dts` over every
+ * tsc-emitted entry `.d.ts` so (a) local per-source sibling re-exports
+ * (`export … from './create-logger'`) are flattened into the entry's
+ * `index.d.ts`, and (b) bundled-dep type imports are routed through
+ * `_dependencies/<dep>/index.d.ts` rather than left as bare specifiers. This
+ * self-containment is what lets `pruneOrphanDeclarations` delete the orphaned
+ * per-source `.d.ts` afterwards without orphaning a still-referenced sibling.
+ *
+ * Runs whenever the build bundles any dep — npm (`bundledDeps`) **or** workspace
+ * (`workspaceBundledDeps`); a package whose deps are all `@hyperfrontend/*` still
+ * needs the flatten. Entries whose tsc output is missing are skipped silently —
+ * the bundle phase may have skipped them deliberately (e.g., empty bundles).
+ *
+ * @param context - Resolved build context.
+ * @param monitor - Optional memory monitor invoked between jobs.
+ * @throws {Error} When the worker artifact cannot be located, or when any per-entry job fails.
+ *
+ * @example Inlining bundled-dep types into every entry's .d.ts after tsc emission
+ * ```typescript
+ * await runDtsPerEntry(context)
+ * ```
+ */
+export declare const runDtsPerEntry: (context: BuildContext, monitor?: MemoryMonitor) => Promise<void>;
+//# sourceMappingURL=dts-per-entry.d.ts.map

package/bundle/declarations/dts-per-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dts-per-entry.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/builder/src/bundle/declarations/dts-per-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,cAAc,CAAA;AAqD5D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,cAAc,GAAU,SAAS,YAAY,EAAE,UAAU,aAAa,KAAG,OAAO,CAAC,IAAI,CAejG,CAAA"}

package/bundle/declarations/dts-pre-pass.d.ts

@@ -0,0 +1,18 @@
+import type { MemoryMonitor } from '../../memory/monitor';
+import type { BuildContext } from '../../models';
+/**
+ * Runs the d.ts pre-pass: for each bundled dep, produces `_dependencies/<dep>/index.d.ts`
+ * by running `rollup-plugin-dts` over the dep's types entry. Cross-dep type imports are
+ * marked external so the per-entry d.ts pass can route them through `_dependencies/`.
+ *
+ * @param context - Resolved build context.
+ * @param monitor - Optional memory monitor invoked between jobs.
+ * @throws {Error} When the worker artifact cannot be located, or when any d.ts job fails.
+ *
+ * @example Producing _dependencies/<dep>/index.d.ts for a self-contained build
+ * ```typescript
+ * await runDtsPrePass(context)
+ * ```
+ */
+export declare const runDtsPrePass: (context: BuildContext, monitor?: MemoryMonitor) => Promise<void>;
+//# sourceMappingURL=dts-pre-pass.d.ts.map

package/bundle/declarations/dts-pre-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dts-pre-pass.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/builder/src/bundle/declarations/dts-pre-pass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,cAAc,CAAA;AA8ErE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,GAAU,SAAS,YAAY,EAAE,UAAU,aAAa,KAAG,OAAO,CAAC,IAAI,CAiBhG,CAAA"}

package/bundle/declarations/flatten-paths.d.ts

@@ -0,0 +1,28 @@
+import type { BuildContext } from '../../models';
+/**
+ * Reshapes the nested declaration tree produced by tsc (with `baseUrl=workspaceRoot`)
+ * into the flat per-library structure consumers expect.
+ *
+ * Without this step tsc emits declarations at
+ *   `dist/libs/<lib>/libs/<lib>/src/index.d.ts`
+ * because it preserves the workspace-relative path. This primitive flattens that to
+ *   `dist/libs/<lib>/index.d.ts`
+ * while preserving any nested platform / feature subdirectories.
+ *
+ * The copy is recursive and unconditional, so internal non-entry subdirectories
+ * that any entry's `index.d.ts` re-exports from (e.g. `shared/`, `lib/`) are
+ * preserved rather than dropped. Per-source declarations left unreachable once
+ * the per-entry pass inlines each `index.d.ts` are removed afterwards by
+ * `pruneOrphanDeclarations`. Finally removes the leftover `libs/`, `plugins/`,
+ * and `apps/` folders tsc created at the output root.
+ *
+ * @param context - Resolved build context. Uses `projectRoot`, `outputPath`,
+ * and `workspaceRoot`.
+ *
+ * @example Flattening declarations after a manual tsc invocation
+ * ```typescript
+ * flattenDeclarationPaths(context)
+ * ```
+ */
+export declare const flattenDeclarationPaths: (context: BuildContext) => void;
+//# sourceMappingURL=flatten-paths.d.ts.map

package/bundle/declarations/flatten-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten-paths.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/builder/src/bundle/declarations/flatten-paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAoChD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,uBAAuB,GAAI,SAAS,YAAY,KAAG,IAM/D,CAAA"}

package/bundle/declarations/generate-declarations.d.ts

@@ -0,0 +1,33 @@
+import type { BuildContext } from '../../models';
+/**
+ * Result of running tsc to emit declaration files.
+ */
+export interface GenerateDeclarationsResult {
+    /** Whether the tsc invocation succeeded. */
+    success: boolean;
+    /** Captured stdout content from tsc. */
+    stdout: string;
+    /** Captured stderr content from tsc. */
+    stderr: string;
+}
+/**
+ * Generates `.d.ts` and `.d.ts.map` files for every entry point in the project
+ * by spawning the workspace-local TypeScript compiler.
+ *
+ * After tsc finishes, calls `flattenDeclarationPaths` to relocate the nested
+ * `dist/<lib>/libs/<lib>/src/...` structure that tsc emits with `baseUrl=workspaceRoot`
+ * back into the flat per-library shape consumers expect.
+ *
+ * @param context - Resolved build context. Provides project root, output path, tsconfig path,
+ * workspace root, and entry point discovery for the flatten step.
+ * @returns Promise resolving with tsc's exit status, captured stdout, and captured stderr.
+ * @throws {Error} When tsc exits with a non-zero status or fails to spawn.
+ *
+ * @example Generating declarations as part of a custom build
+ * ```typescript
+ * const result = await generateDeclarations(context)
+ * console.log(result.stdout)
+ * ```
+ */
+export declare const generateDeclarations: (context: BuildContext) => Promise<GenerateDeclarationsResult>;
+//# sourceMappingURL=generate-declarations.d.ts.map

package/bundle/declarations/generate-declarations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-declarations.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/builder/src/bundle/declarations/generate-declarations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAgBhD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAA;IAChB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;CACf;AA8CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,oBAAoB,GAAU,SAAS,YAAY,KAAG,OAAO,CAAC,0BAA0B,CAuBpG,CAAA"}