@hyperfrontend/builder 0.1.0

package/models/package-json.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Repository field in package.json.
+ */
+export interface RepositoryField {
+    /** Repository type (e.g., 'git'). */
+    type: string;
+    /** Repository URL. */
+    url: string;
+    /** Optional sub-directory inside the repository. */
+    directory?: string;
+}
+/**
+ * Bugs field in package.json.
+ */
+export interface BugsField {
+    /** Bug tracker URL. */
+    url?: string;
+    /** Bug tracker email. */
+    email?: string;
+}
+/**
+ * Author / contributor entry in package.json.
+ */
+export interface AuthorField {
+    /** Author name. */
+    name: string;
+    /** Author email. */
+    email?: string;
+    /** Author URL. */
+    url?: string;
+}
+/**
+ * Funding entry in package.json.
+ */
+export interface FundingField {
+    /** Funding type (e.g., 'github', 'patreon'). */
+    type: string;
+    /** Funding URL. */
+    url: string;
+}
+/**
+ * Conditional export specification for the package.json `exports` field.
+ *
+ * Each property maps an export condition (e.g., `import`, `require`, `types`) to a
+ * resolved file path, or to a nested conditional-export object for further refinement.
+ */
+export interface ConditionalExport {
+    /** Path used by ESM `import`. */
+    import?: string;
+    /** Path used by CommonJS `require`. */
+    require?: string;
+    /** Default fallback path. */
+    default?: string;
+    /** TypeScript declaration path. */
+    types?: string;
+    /** Node.js-specific export. */
+    node?: string | ConditionalExport;
+    /** Browser-specific export. */
+    browser?: string | ConditionalExport;
+    /** Development build export. */
+    development?: string | ConditionalExport;
+    /** Production build export. */
+    production?: string | ConditionalExport;
+}
+/**
+ * Value form for an `exports` map entry — a resolved string path, a conditional
+ * exports object, or a nested record for sub-conditions.
+ */
+export type ExportValue = string | ConditionalExport | Record<string, unknown>;
+/**
+ * Subset of the npm package.json schema that the builder reads from and writes to.
+ *
+ * Only fields the builder pipeline interacts with directly are typed; arbitrary additional
+ * fields are preserved through the index signature and emitted to the output package.json.
+ */
+export interface PackageJson {
+    /** Package name. */
+    name?: string;
+    /** Package version. */
+    version?: string;
+    /** Short package description. */
+    description?: string;
+    /** SPDX license identifier or expression. */
+    license?: string;
+    /** Main entry path (CommonJS). */
+    main?: string;
+    /** Module entry path (ESM). */
+    module?: string;
+    /** TypeScript type-declarations entry path. */
+    types?: string;
+    /** Subpath exports map. */
+    exports?: Record<string, ExportValue>;
+    /** Bin name → script path mapping. */
+    bin?: Record<string, string> | string;
+    /** Runtime dependencies. */
+    dependencies?: Record<string, string>;
+    /** Development dependencies. */
+    devDependencies?: Record<string, string>;
+    /** Peer dependencies. */
+    peerDependencies?: Record<string, string>;
+    /** Optional dependencies. */
+    optionalDependencies?: Record<string, string>;
+    /** Repository field. */
+    repository?: RepositoryField | string;
+    /** Bugs field. */
+    bugs?: BugsField | string;
+    /** Homepage URL. */
+    homepage?: string;
+    /** Author field. */
+    author?: AuthorField | string;
+    /** Contributors. */
+    contributors?: (AuthorField | string)[];
+    /** Funding entry or list. */
+    funding?: FundingField | FundingField[] | string;
+    /** Whether the package has side effects. */
+    sideEffects?: boolean;
+    /** Keywords for npm search. */
+    keywords?: string[];
+    /** unpkg CDN entry path. */
+    unpkg?: string;
+    /** jsdelivr CDN entry path. */
+    jsdelivr?: string;
+    /** Engines compatibility map. */
+    engines?: Record<string, string>;
+    /** Files included when packaging. */
+    files?: string[];
+    /** Arbitrary additional fields preserved on read/write. */
+    [key: string]: unknown;
+}
+//# sourceMappingURL=package-json.d.ts.map

package/models/package-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-json.d.ts","sourceRoot":"","sources":["../../../../../../../libs/builder/src/models/package-json.ts"],"names":[],"mappings":"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"}

package/package/assets/copy-assets.d.ts

@@ -0,0 +1,31 @@
+import type { AssetSpec, PackageJson } from '../../models';
+/**
+ * Copies one or more asset specs into the build output directory.
+ *
+ * Each spec selects its inputs in one of two ways:
+ * - `spec.files`: explicit list of relative paths under `spec.from`. Missing entries
+ *   are silently skipped.
+ * - `spec.glob`: POSIX-style glob evaluated relative to `spec.from`.
+ *
+ * The destination is `<outputPath>/<spec.to>`, defaulting to the dist root when
+ * `spec.to` is omitted or equal to `'.'`. Specs whose `condition` predicate returns
+ * `false` are skipped entirely.
+ *
+ * @param specs - Asset specifications to materialize.
+ * @param outputPath - Absolute path to the build output directory.
+ * @param srcPkg - Source `package.json`, supplied to each spec's `condition` predicate.
+ *
+ * @example Copying README + LICENSE into the dist root
+ * ```typescript
+ * copyAssets(
+ *   [
+ *     { from: '/abs/libs/foo', files: ['README.md', 'CHANGELOG.md'] },
+ *     { from: '/abs/repo', files: ['LICENSE.md', 'SECURITY.md'] },
+ *   ],
+ *   '/abs/dist/libs/foo',
+ *   srcPkg
+ * )
+ * ```
+ */
+export declare const copyAssets: (specs: AssetSpec[], outputPath: string, srcPkg: PackageJson) => void;
+//# sourceMappingURL=copy-assets.d.ts.map

package/package/assets/copy-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-assets.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/builder/src/package/assets/copy-assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AA2C1D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,SAAS,EAAE,EAAE,YAAY,MAAM,EAAE,QAAQ,WAAW,KAAG,IAmBxF,CAAA"}

package/package/assets/index.cjs.js

@@ -0,0 +1,84 @@
+'use strict';
+
+const node_fs = require('node:fs');
+const index_cjs_js = require('../../_dependencies/@hyperfrontend/logging/index.cjs.js');
+const index_cjs_js$1 = require('../../_dependencies/@hyperfrontend/project-scope/core/index.cjs.js');
+
+const log = index_cjs_js.logger.channel('builder:package:assets');
+const resolveTargetDir = (outputPath, to) => (!to || to === '.' ? outputPath : index_cjs_js$1.join(outputPath, to));
+const collectFromFiles = (from, files) => {
+    const collected = [];
+    for (const file of files) {
+        const srcFile = index_cjs_js$1.join(from, file);
+        if (index_cjs_js$1.exists(srcFile) && index_cjs_js$1.isFile(srcFile))
+            collected.push(file);
+    }
+    return collected;
+};
+const collectFromGlob = (from, pattern) => {
+    const collected = [];
+    for (const entry of index_cjs_js$1.readDirectoryRecursive(from)) {
+        if (!entry.isFile)
+            continue;
+        const rel = index_cjs_js$1.relativePath(from, entry.path);
+        if (index_cjs_js$1.matchGlobPattern(rel, pattern))
+            collected.push(rel);
+    }
+    return collected;
+};
+const collectAssetFiles = (spec) => {
+    if (spec.files)
+        return collectFromFiles(spec.from, spec.files);
+    if (spec.glob)
+        return collectFromGlob(spec.from, spec.glob);
+    return [];
+};
+/**
+ * Copies one or more asset specs into the build output directory.
+ *
+ * Each spec selects its inputs in one of two ways:
+ * - `spec.files`: explicit list of relative paths under `spec.from`. Missing entries
+ *   are silently skipped.
+ * - `spec.glob`: POSIX-style glob evaluated relative to `spec.from`.
+ *
+ * The destination is `<outputPath>/<spec.to>`, defaulting to the dist root when
+ * `spec.to` is omitted or equal to `'.'`. Specs whose `condition` predicate returns
+ * `false` are skipped entirely.
+ *
+ * @param specs - Asset specifications to materialize.
+ * @param outputPath - Absolute path to the build output directory.
+ * @param srcPkg - Source `package.json`, supplied to each spec's `condition` predicate.
+ *
+ * @example Copying README + LICENSE into the dist root
+ * ```typescript
+ * copyAssets(
+ *   [
+ *     { from: '/abs/libs/foo', files: ['README.md', 'CHANGELOG.md'] },
+ *     { from: '/abs/repo', files: ['LICENSE.md', 'SECURITY.md'] },
+ *   ],
+ *   '/abs/dist/libs/foo',
+ *   srcPkg
+ * )
+ * ```
+ */
+const copyAssets = (specs, outputPath, srcPkg) => {
+    for (const spec of specs) {
+        if (spec.condition && !spec.condition(srcPkg))
+            continue;
+        if (!index_cjs_js$1.exists(spec.from)) {
+            log.debug(`asset source missing, skipping: ${spec.from}`);
+            continue;
+        }
+        const target = resolveTargetDir(outputPath, spec.to);
+        const files = collectAssetFiles(spec);
+        for (const file of files) {
+            const srcPath = index_cjs_js$1.join(spec.from, file);
+            const destPath = index_cjs_js$1.join(target, file);
+            index_cjs_js$1.ensureDir(index_cjs_js$1.getDirname(destPath));
+            node_fs.copyFileSync(srcPath, destPath);
+            log.debug(`copied ${file}`);
+        }
+    }
+};
+
+exports.copyAssets = copyAssets;

package/package/assets/index.d.ts

@@ -0,0 +1,33 @@
+import { AssetSpec, PackageJson } from '../../models';
+
+/**
+ * Copies one or more asset specs into the build output directory.
+ *
+ * Each spec selects its inputs in one of two ways:
+ * - `spec.files`: explicit list of relative paths under `spec.from`. Missing entries
+ *   are silently skipped.
+ * - `spec.glob`: POSIX-style glob evaluated relative to `spec.from`.
+ *
+ * The destination is `<outputPath>/<spec.to>`, defaulting to the dist root when
+ * `spec.to` is omitted or equal to `'.'`. Specs whose `condition` predicate returns
+ * `false` are skipped entirely.
+ *
+ * @param specs - Asset specifications to materialize.
+ * @param outputPath - Absolute path to the build output directory.
+ * @param srcPkg - Source `package.json`, supplied to each spec's `condition` predicate.
+ *
+ * @example Copying README + LICENSE into the dist root
+ * ```typescript
+ * copyAssets(
+ *   [
+ *     { from: '/abs/libs/foo', files: ['README.md', 'CHANGELOG.md'] },
+ *     { from: '/abs/repo', files: ['LICENSE.md', 'SECURITY.md'] },
+ *   ],
+ *   '/abs/dist/libs/foo',
+ *   srcPkg
+ * )
+ * ```
+ */
+declare const copyAssets: (specs: AssetSpec[], outputPath: string, srcPkg: PackageJson) => void;
+
+export { copyAssets };

package/package/assets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/builder/src/package/assets/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA"}

package/package/assets/index.esm.js

@@ -0,0 +1,82 @@
+import { copyFileSync } from 'node:fs';
+import { logger } from '../../_dependencies/@hyperfrontend/logging/index.esm.js';
+import { exists, join, ensureDir, getDirname, isFile, readDirectoryRecursive, relativePath, matchGlobPattern } from '../../_dependencies/@hyperfrontend/project-scope/core/index.esm.js';
+
+const log = logger.channel('builder:package:assets');
+const resolveTargetDir = (outputPath, to) => (!to || to === '.' ? outputPath : join(outputPath, to));
+const collectFromFiles = (from, files) => {
+    const collected = [];
+    for (const file of files) {
+        const srcFile = join(from, file);
+        if (exists(srcFile) && isFile(srcFile))
+            collected.push(file);
+    }
+    return collected;
+};
+const collectFromGlob = (from, pattern) => {
+    const collected = [];
+    for (const entry of readDirectoryRecursive(from)) {
+        if (!entry.isFile)
+            continue;
+        const rel = relativePath(from, entry.path);
+        if (matchGlobPattern(rel, pattern))
+            collected.push(rel);
+    }
+    return collected;
+};
+const collectAssetFiles = (spec) => {
+    if (spec.files)
+        return collectFromFiles(spec.from, spec.files);
+    if (spec.glob)
+        return collectFromGlob(spec.from, spec.glob);
+    return [];
+};
+/**
+ * Copies one or more asset specs into the build output directory.
+ *
+ * Each spec selects its inputs in one of two ways:
+ * - `spec.files`: explicit list of relative paths under `spec.from`. Missing entries
+ *   are silently skipped.
+ * - `spec.glob`: POSIX-style glob evaluated relative to `spec.from`.
+ *
+ * The destination is `<outputPath>/<spec.to>`, defaulting to the dist root when
+ * `spec.to` is omitted or equal to `'.'`. Specs whose `condition` predicate returns
+ * `false` are skipped entirely.
+ *
+ * @param specs - Asset specifications to materialize.
+ * @param outputPath - Absolute path to the build output directory.
+ * @param srcPkg - Source `package.json`, supplied to each spec's `condition` predicate.
+ *
+ * @example Copying README + LICENSE into the dist root
+ * ```typescript
+ * copyAssets(
+ *   [
+ *     { from: '/abs/libs/foo', files: ['README.md', 'CHANGELOG.md'] },
+ *     { from: '/abs/repo', files: ['LICENSE.md', 'SECURITY.md'] },
+ *   ],
+ *   '/abs/dist/libs/foo',
+ *   srcPkg
+ * )
+ * ```
+ */
+const copyAssets = (specs, outputPath, srcPkg) => {
+    for (const spec of specs) {
+        if (spec.condition && !spec.condition(srcPkg))
+            continue;
+        if (!exists(spec.from)) {
+            log.debug(`asset source missing, skipping: ${spec.from}`);
+            continue;
+        }
+        const target = resolveTargetDir(outputPath, spec.to);
+        const files = collectAssetFiles(spec);
+        for (const file of files) {
+            const srcPath = join(spec.from, file);
+            const destPath = join(target, file);
+            ensureDir(getDirname(destPath));
+            copyFileSync(srcPath, destPath);
+            log.debug(`copied ${file}`);
+        }
+    }
+};
+
+export { copyAssets };

package/package/finalize-files.d.ts

@@ -0,0 +1,25 @@
+import type { BuildConfig, BuildContext } from '../models';
+/**
+ * Finalizes `package.json#files` as the last build step, after every emit phase
+ * (bundle → package → bin → license/asset) and the orphan prune have run.
+ *
+ * The allowlist is reflected from the materialized output tree rather than
+ * predicted from config, so the field names exactly what ships. Call this last:
+ * earlier phases (notably the bin phase) emit files after the package phase
+ * writes the manifest, and reflecting before then would miss those survivors.
+ * An explicit `config.files` short-circuits reflection and is honored verbatim.
+ *
+ * An empty allowlist (only possible via an explicit `config.files: []`) leaves
+ * the manifest untouched.
+ *
+ * @param ctx - Resolved build context (provides `outputPath`).
+ * @param config - Top-level builder configuration; reads the `files` override.
+ *
+ * @example Finalizing the allowlist after the bin phase
+ * ```typescript
+ * const binOutputs = await runBinPhase(ctx, config.bin ?? [])
+ * finalizeFilesAllowlist(ctx, config)
+ * ```
+ */
+export declare const finalizeFilesAllowlist: (ctx: BuildContext, config: BuildConfig) => void;
+//# sourceMappingURL=finalize-files.d.ts.map

package/package/finalize-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize-files.d.ts","sourceRoot":"","sources":["../../../../../../../libs/builder/src/package/finalize-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAe,MAAM,WAAW,CAAA;AAKvE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,YAAY,EAAE,QAAQ,WAAW,KAAG,IAM/E,CAAA"}