@hyperfrontend/builder 0.1.0

package/_shared/package/licenses/license-url/index.esm.js

@@ -0,0 +1,29 @@
+import { parseRepositoryUrl } from '../../../../_dependencies/@hyperfrontend/versioning/repository/parse/index.esm.js';
+
+const extractRepositoryUrl = (repository) => {
+    if (typeof repository === 'string')
+        return repository;
+    if (repository && typeof repository === 'object')
+        return repository.url;
+    return null;
+};
+const formatLicenseUrl = (platform, baseUrl, fileName) => {
+    if (platform === 'github')
+        return `${baseUrl}/blob/HEAD/${fileName}`;
+    if (platform === 'gitlab')
+        return `${baseUrl}/-/blob/HEAD/${fileName}`;
+    if (platform === 'bitbucket')
+        return `${baseUrl}/src/HEAD/${fileName}`;
+    return null;
+};
+const constructLicenseUrl = (repository, licenseFileName) => {
+    const url = extractRepositoryUrl(repository);
+    if (!url)
+        return null;
+    const parsed = parseRepositoryUrl(url);
+    if (!parsed)
+        return null;
+    return formatLicenseUrl(parsed.platform, parsed.baseUrl, licenseFileName);
+};
+
+export { extractRepositoryUrl, formatLicenseUrl, constructLicenseUrl };

package/_shared/package/licenses/write/index.cjs.js

@@ -0,0 +1,9 @@
+'use strict';
+
+const index_cjs_js$4 = require('../../../../_dependencies/@hyperfrontend/project-scope/core/index.cjs.js');
+
+const writeThirdPartyLicensesFile = (outputPath, content) => {
+    index_cjs_js$4.writeFileContent(index_cjs_js$4.join(outputPath, 'THIRD_PARTY_LICENSES.md'), content);
+};
+
+exports.writeThirdPartyLicensesFile = writeThirdPartyLicensesFile;

package/_shared/package/licenses/write/index.esm.js

@@ -0,0 +1,8 @@
+import { join as join$1 } from '../../../bundle/fs/posix-path/index.esm.js';
+import { writeFileContent } from '../../../../_dependencies/@hyperfrontend/project-scope/core/index.esm.js';
+
+const writeThirdPartyLicensesFile = (outputPath, content) => {
+    writeFileContent(join$1(outputPath, 'THIRD_PARTY_LICENSES.md'), content);
+};
+
+export { writeThirdPartyLicensesFile };

package/_shared/presets/by-names/index.cjs.js

@@ -0,0 +1,10 @@
+'use strict';
+
+const index_cjs_js$9 = require('../../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/set/index.cjs.js');
+
+const byNames = (names) => {
+    const set = index_cjs_js$9.createSet(names);
+    return (name) => set.has(name);
+};
+
+exports.byNames = byNames;

package/_shared/presets/by-names/index.esm.js

@@ -0,0 +1,8 @@
+import { createSet } from '../../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/set/index.esm.js';
+
+const byNames = (names) => {
+    const set = createSet(names);
+    return (name) => set.has(name);
+};
+
+export { byNames };

package/_shared/presets/by-prefix/index.cjs.js

@@ -0,0 +1,7 @@
+'use strict';
+
+const byPrefix = (scope) => {
+    return (name) => name.startsWith(scope);
+};
+
+exports.byPrefix = byPrefix;

package/_shared/presets/by-prefix/index.esm.js

@@ -0,0 +1,5 @@
+const byPrefix = (scope) => {
+    return (name) => name.startsWith(scope);
+};
+
+export { byPrefix };

package/bin/format.d.ts

@@ -0,0 +1,18 @@
+import type { BinFormatSpec, BinScriptFormat } from '../models';
+/**
+ * Normalizes a bin's format declaration to an explicit list.
+ *
+ * `BinFormatSpec` permits either a single `BinScriptFormat` or an array of them;
+ * a scalar is wrapped in a singleton so callers always receive the list shape.
+ *
+ * @param format - The per-bin format declaration: a single format or a list.
+ * @returns The declared formats as a list.
+ *
+ * @example Normalizing scalar and list declarations
+ * ```typescript
+ * normalizeFormats('cjs') // => ['cjs']
+ * normalizeFormats(['cjs', 'esm']) // => ['cjs', 'esm']
+ * ```
+ */
+export declare const normalizeFormats: (format: BinFormatSpec) => BinScriptFormat[];
+//# sourceMappingURL=format.d.ts.map

package/bin/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../../../../libs/builder/src/bin/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAG/D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,aAAa,KAAG,eAAe,EACC,CAAA"}

package/bin/hf-build.d.ts

@@ -0,0 +1,81 @@
+import type { BuildConfig, BuildResult } from '../models';
+/** Exit code emitted when the build completes successfully. */
+export declare const HF_BUILD_EXIT_OK = 0;
+/** Exit code emitted when argv parsing, config loading, or the build itself fails. */
+export declare const HF_BUILD_EXIT_ERROR = 1;
+/** Default config file basename resolved against `cwd` when `--config` is omitted. */
+export declare const HF_BUILD_DEFAULT_CONFIG_NAME = "builder.config.json";
+/** Parsed argv subset consumed by the `hf-build` bin. */
+export interface HfBuildArgs {
+    /** Explicit override for the config file path (`--config`). */
+    readonly configPath?: string;
+    /** Working directory override (`--cwd`). */
+    readonly cwdOverride?: string;
+    /** Force `config.verbose = true` (`--verbose`). */
+    readonly verbose: boolean;
+    /** User asked for help (`--help` / `-h`). */
+    readonly help: boolean;
+}
+/** Injectable dependencies for `runHfBuild` — defaulted for production, overridden in tests. */
+export interface RunHfBuildDeps {
+    /** Reads and parses the JSON config file. */
+    readonly readConfig?: (path: string) => BuildConfig;
+    /** Runs the build pipeline. */
+    readonly runBuild?: (config: BuildConfig) => Promise<BuildResult>;
+}
+/** Inputs for a single `hf-build` invocation. */
+export interface RunHfBuildOptions extends RunHfBuildDeps {
+    /** Raw argv tail (excluding node + script) — usually `process.argv.slice(2)`. */
+    readonly argv: readonly string[];
+    /** Default cwd used when argv does not provide `--cwd`. */
+    readonly cwd: string;
+    /** Sink for diagnostic output (errors, parse failures). */
+    readonly stderr: NodeJS.WritableStream;
+    /** Sink for the `--help` text. Falls back to `stderr` when omitted. */
+    readonly stdout?: NodeJS.WritableStream;
+}
+/**
+ * Parses the argv understood by `hf-build`. Unknown flags throw so typos surface
+ * at the boundary instead of being silently ignored. No positional arguments are
+ * accepted — supplying one throws.
+ *
+ * @param argv - Argument list following the bin name (e.g. `process.argv.slice(2)`).
+ * @returns Parsed arguments, with `verbose` and `help` defaulted to `false`.
+ *
+ * @example Parsing a `--config` override
+ * ```typescript
+ * parseHfBuildArgs(['--config', './builder.json'])
+ * // => { configPath: './builder.json', verbose: false, help: false }
+ * ```
+ */
+export declare function parseHfBuildArgs(argv: readonly string[]): HfBuildArgs;
+/**
+ * End-to-end `hf-build` entry: parse argv → resolve config path → load JSON config
+ * → call {@link build} → translate the outcome into an exit code. All dependencies
+ * are injectable so tests can substitute deterministic stand-ins without touching
+ * the filesystem or running an actual build.
+ *
+ * Resolution order for the config file:
+ * 1. `--config <path>` if provided
+ * 2. `<cwd>/builder.config.json`
+ *
+ * `--cwd` overrides `options.cwd` for both config resolution and any relative
+ * paths the consumer subsequently interprets against the resolved cwd.
+ *
+ * @param options - argv, cwd, stderr, optional stdout, and optional dependency overrides.
+ * @returns Exit code: `0` on success, `1` on any failure (parse error, missing config, build throw).
+ *
+ * @example Running with the production defaults
+ * ```typescript
+ * const code = await runHfBuild({
+ *   argv: process.argv.slice(2),
+ *   cwd: process.cwd(),
+ *   stderr: process.stderr,
+ *   stdout: process.stdout,
+ * })
+ * process.exit(code)
+ * ```
+ */
+export declare function runHfBuild(options: RunHfBuildOptions): Promise<number>;
+export default runHfBuild;
+//# sourceMappingURL=hf-build.d.ts.map

package/bin/hf-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hf-build.d.ts","sourceRoot":"","sources":["../../../../../../../libs/builder/src/bin/hf-build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAKzD,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,IAAI,CAAA;AAEjC,sFAAsF;AACtF,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAEpC,sFAAsF;AACtF,eAAO,MAAM,4BAA4B,wBAAwB,CAAA;AAajE,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CACvB;AAED,gGAAgG;AAChG,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,WAAW,CAAA;IACnD,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,CAAA;CAClE;AAED,iDAAiD;AACjD,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAA;IACtC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;CACxC;AAOD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAmCrE;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuC5E;AAED,eAAe,UAAU,CAAA"}