@torba/dev 1.0.10

package/dist/index.cjs

@@ -0,0 +1,81 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let _torba_core = require("@torba/core");
+
+//#region lib/plugin.ts
+/** Identity helper for authoring a plugin with inferred types. */
+function definePlugin(plugin) {
+	return plugin;
+}
+
+//#endregion
+//#region lib/config.ts
+/** Use as the default export of `torba.config.mjs`. */
+function defineConfig(input) {
+	return input;
+}
+/** Resolve a config input to a concrete `TorbaConfig`. */
+async function resolveConfig(input, ctx) {
+	return typeof input === "function" ? input(ctx) : input;
+}
+
+//#endregion
+//#region lib/engine.ts
+/** Flatten author-ordered launch groups into a single `Valset`. */
+function flattenArgs(items) {
+	const out = [];
+	for (const item of items) if (typeof item === "string") out.push({
+		rules: [],
+		value: [item]
+	});
+	else if (Array.isArray(item)) out.push(...item);
+	else out.push(item);
+	return out;
+}
+/**
+* Run every plugin's `build` hook in parallel, merge the contributions, and
+* assemble the final `Manifest`.
+*/
+async function buildManifest(config, ctx) {
+	ctx.log("torba", `resolving ${config.plugins.length} plugin(s)`);
+	const results = await Promise.all(config.plugins.map(async (p) => ({
+		name: p.name,
+		contribution: await p.build(ctx)
+	})));
+	const artifacts = [];
+	for (const r of results) if (r.contribution.artifacts) artifacts.push(...r.contribution.artifacts);
+	if (config.manifest.artifacts) artifacts.push(...config.manifest.artifacts);
+	const deduped = (0, _torba_core.deduplicateArtifacts)(artifacts);
+	const vars = {};
+	const owner = {};
+	for (const r of results) {
+		if (!r.contribution.vars) continue;
+		for (const [key, value] of Object.entries(r.contribution.vars)) {
+			const prev = owner[key];
+			if (prev !== void 0 && prev !== r.name) ctx.log("torba", `warning: var '${key}' set by both '${prev}' and '${r.name}' — using '${r.name}'`);
+			vars[key] = value;
+			owner[key] = r.name;
+		}
+	}
+	if (config.manifest.vars) for (const [key, value] of Object.entries(config.manifest.vars)) vars[key] = value;
+	const pluginMap = Object.fromEntries(results.map((r) => [r.name, r.contribution.launch ?? {}]));
+	const m = config.manifest;
+	const launch = {
+		command: m.command(pluginMap),
+		workdir: typeof m.workdir === "function" ? m.workdir(pluginMap) : m.workdir ?? ".",
+		args: flattenArgs(m.args(pluginMap)),
+		envs: typeof m.envs === "function" ? m.envs(pluginMap) : m.envs ?? {}
+	};
+	ctx.log("torba", `merged ${deduped.length} artifact(s) (${artifacts.length - deduped.length} deduped)`);
+	return {
+		vars,
+		launch,
+		artifacts: deduped,
+		...m.restrict && m.restrict.length > 0 ? { restrict: m.restrict } : {}
+	};
+}
+
+//#endregion
+exports.buildManifest = buildManifest;
+exports.defineConfig = defineConfig;
+exports.definePlugin = definePlugin;
+exports.resolveConfig = resolveConfig;

package/dist/index.d.cts

@@ -0,0 +1,91 @@
+import { Artifact, Manifest, Val, ValDefs, Valset } from "@torba/core";
+
+//#region lib/plugin.d.ts
+/** Build-time context handed to every plugin's `build` hook. */
+interface BuildContext {
+  /** Sanctioned build-time logging channel; auto-prefixed by plugin name. */
+  log: (scope: string, message: string) => void;
+  /** Absolute directory of `torba.config.mjs` — anchor for relative paths. */
+  configDir: string;
+  /** Value of `torba build --mode <m>`; empty string when unset. */
+  mode: string;
+}
+/**
+ * Named launch fragments a plugin exposes for the config's `command`/`args`
+ * accessor functions — e.g. `{ jvmArgs, mainClass, gameArgs }` or `{ bin }`.
+ */
+type LaunchGroups = Record<string, Valset | Val | string>;
+/** What a plugin's `build` hook returns. */
+interface Contribution {
+  /** Artifacts to download/copy/extract. */
+  artifacts?: Artifact[];
+  /** Manifest vars this plugin owns. */
+  vars?: ValDefs;
+  /** Named launch fragments, exposed to the config's accessor functions. */
+  launch?: LaunchGroups;
+}
+/**
+ * A torba plugin — a pure-to-construct, bundler-style hook object. The
+ * constructor (`forge('1.20.1-best')`, …) does zero I/O; all network/fs work
+ * happens inside `build`, which the engine drives.
+ */
+interface TorbaPlugin {
+  name: string;
+  build(ctx: BuildContext): Promise<Contribution> | Contribution;
+}
+/** Identity helper for authoring a plugin with inferred types. */
+declare function definePlugin(plugin: TorbaPlugin): TorbaPlugin;
+//#endregion
+//#region lib/config.d.ts
+/** Map of plugin name → its launch groups, passed to launch accessors. */
+type PluginMap = Record<string, LaunchGroups>;
+/** One entry of a config's assembled `args` — flattened to a `Valset`. */
+type ArgItem = Valset | Val | string;
+interface TorbaManifestConfig {
+  /** Hand-written literal artifacts, merged with plugin output (last wins). */
+  artifacts?: Artifact[];
+  /** Override/extra vars layered on top of the merged plugin vars. */
+  vars?: ValDefs;
+  /** Launch command — typically `({ java }) => java.bin`. */
+  command: (plugins: PluginMap) => string;
+  /** Launch args — author-ordered named groups, flattened to a `Valset`. */
+  args: (plugins: PluginMap) => ArgItem[];
+  /** Working directory for the launched process. */
+  workdir?: string | ((plugins: PluginMap) => string);
+  /** Environment variables for the launched process. */
+  envs?: ValDefs | ((plugins: PluginMap) => ValDefs);
+  /** `restrict` globs swept clean after install. */
+  restrict?: string[];
+}
+interface TorbaConfig {
+  /** Default manifest output path, relative to the config file. */
+  output?: string;
+  /** The plugins whose `build` hooks produce the manifest. */
+  plugins: TorbaPlugin[];
+  /** Declarative manifest fields, separate from tooling config. */
+  manifest: TorbaManifestConfig;
+  /**
+   * Launch-time manifest patch. Re-run on every `torba launch`; the returned
+   * partial is shallow-merged (per field) over the loaded manifest.
+   */
+  runClient?: (manifest: Manifest) => Partial<Manifest>;
+}
+interface TorbaConfigContext {
+  /** Value of `torba build --mode <m>`; empty string when unset. */
+  mode: string;
+}
+type TorbaConfigInput = TorbaConfig | ((ctx: TorbaConfigContext) => TorbaConfig | Promise<TorbaConfig>);
+/** Use as the default export of `torba.config.mjs`. */
+declare function defineConfig(input: TorbaConfigInput): TorbaConfigInput;
+/** Resolve a config input to a concrete `TorbaConfig`. */
+declare function resolveConfig(input: TorbaConfigInput, ctx: TorbaConfigContext): Promise<TorbaConfig>;
+//#endregion
+//#region lib/engine.d.ts
+/**
+ * Run every plugin's `build` hook in parallel, merge the contributions, and
+ * assemble the final `Manifest`.
+ */
+declare function buildManifest(config: TorbaConfig, ctx: BuildContext): Promise<Manifest>;
+//#endregion
+export { ArgItem, BuildContext, Contribution, LaunchGroups, PluginMap, TorbaConfig, TorbaConfigContext, TorbaConfigInput, TorbaManifestConfig, TorbaPlugin, buildManifest, defineConfig, definePlugin, resolveConfig };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../lib/plugin.ts","../lib/config.ts","../lib/engine.ts"],"mappings":";;;;UAGiB,YAAA;EAAA;EAEf,GAAA,GAAM,KAAA,UAAe,OAAA;;EAErB,SAAA;EAFA;EAIA,IAAA;AAAA;;;;;KAOU,YAAA,GAAe,MAAA,SAAe,MAAA,GAAS,GAAA;;UAGlC,YAAA;EAHyB;EAKxC,SAAA,GAAY,QAAA;EALa;EAOzB,IAAA,GAAO,OAAA;EAPwB;EAS/B,MAAA,GAAS,YAAA;AAAA;;;;AANX;;UAciB,WAAA;EACf,IAAA;EACA,KAAA,CAAM,GAAA,EAAK,YAAA,GAAe,OAAA,CAAQ,YAAA,IAAgB,YAAA;AAAA;;iBAIpC,YAAA,CAAa,MAAA,EAAQ,WAAA,GAAc,WAAA;;;;KCnCvC,SAAA,GAAY,MAAA,SAAe,YAAA;;KAG3B,OAAA,GAAU,MAAA,GAAS,GAAA;AAAA,UAEd,mBAAA;EDJf;ECMA,SAAA,GAAY,QAAA;EDNS;ECQrB,IAAA,GAAO,OAAA;EDJP;ECMA,OAAA,GAAU,OAAA,EAAS,SAAA;EDNf;ECQJ,IAAA,GAAO,OAAA,EAAS,SAAA,KAAc,OAAA;EDDR;ECGtB,OAAA,cAAqB,OAAA,EAAS,SAAA;EDHU;ECKxC,IAAA,GAAO,OAAA,KAAY,OAAA,EAAS,SAAA,KAAc,OAAA;EDLjB;ECOzB,QAAA;AAAA;AAAA,UAGe,WAAA;EDVyB;ECYxC,MAAA;EDZoD;ECcpD,OAAA,EAAS,WAAA;EDXM;ECaf,QAAA,EAAU,mBAAA;;;;;EAKV,SAAA,IAAa,QAAA,EAAU,QAAA,KAAa,OAAA,CAAQ,QAAA;AAAA;AAAA,UAG7B,kBAAA;EDnBH;ECqBZ,IAAA;AAAA;AAAA,KAGU,gBAAA,GACR,WAAA,KACE,GAAA,EAAK,kBAAA,KAAuB,WAAA,GAAc,OAAA,CAAQ,WAAA;;iBAGxC,YAAA,CAAa,KAAA,EAAO,gBAAA,GAAmB,gBAAA;;iBAKjC,aAAA,CACpB,KAAA,EAAO,gBAAA,EACP,GAAA,EAAK,kBAAA,GACJ,OAAA,CAAQ,WAAA;;;ADvDX;;;;AAAA,iBEwBsB,aAAA,CACpB,MAAA,EAAQ,WAAA,EACR,GAAA,EAAK,YAAA,GACJ,OAAA,CAAQ,QAAA"}

package/dist/index.d.mts

@@ -0,0 +1,91 @@
+import { Artifact, Manifest, Val, ValDefs, Valset } from "@torba/core";
+
+//#region lib/plugin.d.ts
+/** Build-time context handed to every plugin's `build` hook. */
+interface BuildContext {
+  /** Sanctioned build-time logging channel; auto-prefixed by plugin name. */
+  log: (scope: string, message: string) => void;
+  /** Absolute directory of `torba.config.mjs` — anchor for relative paths. */
+  configDir: string;
+  /** Value of `torba build --mode <m>`; empty string when unset. */
+  mode: string;
+}
+/**
+ * Named launch fragments a plugin exposes for the config's `command`/`args`
+ * accessor functions — e.g. `{ jvmArgs, mainClass, gameArgs }` or `{ bin }`.
+ */
+type LaunchGroups = Record<string, Valset | Val | string>;
+/** What a plugin's `build` hook returns. */
+interface Contribution {
+  /** Artifacts to download/copy/extract. */
+  artifacts?: Artifact[];
+  /** Manifest vars this plugin owns. */
+  vars?: ValDefs;
+  /** Named launch fragments, exposed to the config's accessor functions. */
+  launch?: LaunchGroups;
+}
+/**
+ * A torba plugin — a pure-to-construct, bundler-style hook object. The
+ * constructor (`forge('1.20.1-best')`, …) does zero I/O; all network/fs work
+ * happens inside `build`, which the engine drives.
+ */
+interface TorbaPlugin {
+  name: string;
+  build(ctx: BuildContext): Promise<Contribution> | Contribution;
+}
+/** Identity helper for authoring a plugin with inferred types. */
+declare function definePlugin(plugin: TorbaPlugin): TorbaPlugin;
+//#endregion
+//#region lib/config.d.ts
+/** Map of plugin name → its launch groups, passed to launch accessors. */
+type PluginMap = Record<string, LaunchGroups>;
+/** One entry of a config's assembled `args` — flattened to a `Valset`. */
+type ArgItem = Valset | Val | string;
+interface TorbaManifestConfig {
+  /** Hand-written literal artifacts, merged with plugin output (last wins). */
+  artifacts?: Artifact[];
+  /** Override/extra vars layered on top of the merged plugin vars. */
+  vars?: ValDefs;
+  /** Launch command — typically `({ java }) => java.bin`. */
+  command: (plugins: PluginMap) => string;
+  /** Launch args — author-ordered named groups, flattened to a `Valset`. */
+  args: (plugins: PluginMap) => ArgItem[];
+  /** Working directory for the launched process. */
+  workdir?: string | ((plugins: PluginMap) => string);
+  /** Environment variables for the launched process. */
+  envs?: ValDefs | ((plugins: PluginMap) => ValDefs);
+  /** `restrict` globs swept clean after install. */
+  restrict?: string[];
+}
+interface TorbaConfig {
+  /** Default manifest output path, relative to the config file. */
+  output?: string;
+  /** The plugins whose `build` hooks produce the manifest. */
+  plugins: TorbaPlugin[];
+  /** Declarative manifest fields, separate from tooling config. */
+  manifest: TorbaManifestConfig;
+  /**
+   * Launch-time manifest patch. Re-run on every `torba launch`; the returned
+   * partial is shallow-merged (per field) over the loaded manifest.
+   */
+  runClient?: (manifest: Manifest) => Partial<Manifest>;
+}
+interface TorbaConfigContext {
+  /** Value of `torba build --mode <m>`; empty string when unset. */
+  mode: string;
+}
+type TorbaConfigInput = TorbaConfig | ((ctx: TorbaConfigContext) => TorbaConfig | Promise<TorbaConfig>);
+/** Use as the default export of `torba.config.mjs`. */
+declare function defineConfig(input: TorbaConfigInput): TorbaConfigInput;
+/** Resolve a config input to a concrete `TorbaConfig`. */
+declare function resolveConfig(input: TorbaConfigInput, ctx: TorbaConfigContext): Promise<TorbaConfig>;
+//#endregion
+//#region lib/engine.d.ts
+/**
+ * Run every plugin's `build` hook in parallel, merge the contributions, and
+ * assemble the final `Manifest`.
+ */
+declare function buildManifest(config: TorbaConfig, ctx: BuildContext): Promise<Manifest>;
+//#endregion
+export { ArgItem, BuildContext, Contribution, LaunchGroups, PluginMap, TorbaConfig, TorbaConfigContext, TorbaConfigInput, TorbaManifestConfig, TorbaPlugin, buildManifest, defineConfig, definePlugin, resolveConfig };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../lib/plugin.ts","../lib/config.ts","../lib/engine.ts"],"mappings":";;;;UAGiB,YAAA;EAAA;EAEf,GAAA,GAAM,KAAA,UAAe,OAAA;;EAErB,SAAA;EAFA;EAIA,IAAA;AAAA;;;;;KAOU,YAAA,GAAe,MAAA,SAAe,MAAA,GAAS,GAAA;;UAGlC,YAAA;EAHyB;EAKxC,SAAA,GAAY,QAAA;EALa;EAOzB,IAAA,GAAO,OAAA;EAPwB;EAS/B,MAAA,GAAS,YAAA;AAAA;;;;AANX;;UAciB,WAAA;EACf,IAAA;EACA,KAAA,CAAM,GAAA,EAAK,YAAA,GAAe,OAAA,CAAQ,YAAA,IAAgB,YAAA;AAAA;;iBAIpC,YAAA,CAAa,MAAA,EAAQ,WAAA,GAAc,WAAA;;;;KCnCvC,SAAA,GAAY,MAAA,SAAe,YAAA;;KAG3B,OAAA,GAAU,MAAA,GAAS,GAAA;AAAA,UAEd,mBAAA;EDJf;ECMA,SAAA,GAAY,QAAA;EDNS;ECQrB,IAAA,GAAO,OAAA;EDJP;ECMA,OAAA,GAAU,OAAA,EAAS,SAAA;EDNf;ECQJ,IAAA,GAAO,OAAA,EAAS,SAAA,KAAc,OAAA;EDDR;ECGtB,OAAA,cAAqB,OAAA,EAAS,SAAA;EDHU;ECKxC,IAAA,GAAO,OAAA,KAAY,OAAA,EAAS,SAAA,KAAc,OAAA;EDLjB;ECOzB,QAAA;AAAA;AAAA,UAGe,WAAA;EDVyB;ECYxC,MAAA;EDZoD;ECcpD,OAAA,EAAS,WAAA;EDXM;ECaf,QAAA,EAAU,mBAAA;;;;;EAKV,SAAA,IAAa,QAAA,EAAU,QAAA,KAAa,OAAA,CAAQ,QAAA;AAAA;AAAA,UAG7B,kBAAA;EDnBH;ECqBZ,IAAA;AAAA;AAAA,KAGU,gBAAA,GACR,WAAA,KACE,GAAA,EAAK,kBAAA,KAAuB,WAAA,GAAc,OAAA,CAAQ,WAAA;;iBAGxC,YAAA,CAAa,KAAA,EAAO,gBAAA,GAAmB,gBAAA;;iBAKjC,aAAA,CACpB,KAAA,EAAO,gBAAA,EACP,GAAA,EAAK,kBAAA,GACJ,OAAA,CAAQ,WAAA;;;ADvDX;;;;AAAA,iBEwBsB,aAAA,CACpB,MAAA,EAAQ,WAAA,EACR,GAAA,EAAK,YAAA,GACJ,OAAA,CAAQ,QAAA"}

package/dist/index.mjs

@@ -0,0 +1,78 @@
+import { deduplicateArtifacts } from "@torba/core";
+
+//#region lib/plugin.ts
+/** Identity helper for authoring a plugin with inferred types. */
+function definePlugin(plugin) {
+	return plugin;
+}
+
+//#endregion
+//#region lib/config.ts
+/** Use as the default export of `torba.config.mjs`. */
+function defineConfig(input) {
+	return input;
+}
+/** Resolve a config input to a concrete `TorbaConfig`. */
+async function resolveConfig(input, ctx) {
+	return typeof input === "function" ? input(ctx) : input;
+}
+
+//#endregion
+//#region lib/engine.ts
+/** Flatten author-ordered launch groups into a single `Valset`. */
+function flattenArgs(items) {
+	const out = [];
+	for (const item of items) if (typeof item === "string") out.push({
+		rules: [],
+		value: [item]
+	});
+	else if (Array.isArray(item)) out.push(...item);
+	else out.push(item);
+	return out;
+}
+/**
+* Run every plugin's `build` hook in parallel, merge the contributions, and
+* assemble the final `Manifest`.
+*/
+async function buildManifest(config, ctx) {
+	ctx.log("torba", `resolving ${config.plugins.length} plugin(s)`);
+	const results = await Promise.all(config.plugins.map(async (p) => ({
+		name: p.name,
+		contribution: await p.build(ctx)
+	})));
+	const artifacts = [];
+	for (const r of results) if (r.contribution.artifacts) artifacts.push(...r.contribution.artifacts);
+	if (config.manifest.artifacts) artifacts.push(...config.manifest.artifacts);
+	const deduped = deduplicateArtifacts(artifacts);
+	const vars = {};
+	const owner = {};
+	for (const r of results) {
+		if (!r.contribution.vars) continue;
+		for (const [key, value] of Object.entries(r.contribution.vars)) {
+			const prev = owner[key];
+			if (prev !== void 0 && prev !== r.name) ctx.log("torba", `warning: var '${key}' set by both '${prev}' and '${r.name}' — using '${r.name}'`);
+			vars[key] = value;
+			owner[key] = r.name;
+		}
+	}
+	if (config.manifest.vars) for (const [key, value] of Object.entries(config.manifest.vars)) vars[key] = value;
+	const pluginMap = Object.fromEntries(results.map((r) => [r.name, r.contribution.launch ?? {}]));
+	const m = config.manifest;
+	const launch = {
+		command: m.command(pluginMap),
+		workdir: typeof m.workdir === "function" ? m.workdir(pluginMap) : m.workdir ?? ".",
+		args: flattenArgs(m.args(pluginMap)),
+		envs: typeof m.envs === "function" ? m.envs(pluginMap) : m.envs ?? {}
+	};
+	ctx.log("torba", `merged ${deduped.length} artifact(s) (${artifacts.length - deduped.length} deduped)`);
+	return {
+		vars,
+		launch,
+		artifacts: deduped,
+		...m.restrict && m.restrict.length > 0 ? { restrict: m.restrict } : {}
+	};
+}
+
+//#endregion
+export { buildManifest, defineConfig, definePlugin, resolveConfig };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../lib/plugin.ts","../lib/config.ts","../lib/engine.ts"],"sourcesContent":["import type { Artifact, ValDefs, Val, Valset } from '@torba/core';\n\n/** Build-time context handed to every plugin's `build` hook. */\nexport interface BuildContext {\n  /** Sanctioned build-time logging channel; auto-prefixed by plugin name. */\n  log: (scope: string, message: string) => void;\n  /** Absolute directory of `torba.config.mjs` — anchor for relative paths. */\n  configDir: string;\n  /** Value of `torba build --mode <m>`; empty string when unset. */\n  mode: string;\n}\n\n/**\n * Named launch fragments a plugin exposes for the config's `command`/`args`\n * accessor functions — e.g. `{ jvmArgs, mainClass, gameArgs }` or `{ bin }`.\n */\nexport type LaunchGroups = Record<string, Valset | Val | string>;\n\n/** What a plugin's `build` hook returns. */\nexport interface Contribution {\n  /** Artifacts to download/copy/extract. */\n  artifacts?: Artifact[];\n  /** Manifest vars this plugin owns. */\n  vars?: ValDefs;\n  /** Named launch fragments, exposed to the config's accessor functions. */\n  launch?: LaunchGroups;\n}\n\n/**\n * A torba plugin — a pure-to-construct, bundler-style hook object. The\n * constructor (`forge('1.20.1-best')`, …) does zero I/O; all network/fs work\n * happens inside `build`, which the engine drives.\n */\nexport interface TorbaPlugin {\n  name: string;\n  build(ctx: BuildContext): Promise<Contribution> | Contribution;\n}\n\n/** Identity helper for authoring a plugin with inferred types. */\nexport function definePlugin(plugin: TorbaPlugin): TorbaPlugin {\n  return plugin;\n}\n","import type { Artifact, ValDefs, Manifest, Val, Valset } from '@torba/core';\nimport type { TorbaPlugin, LaunchGroups } from './plugin';\n\n/** Map of plugin name → its launch groups, passed to launch accessors. */\nexport type PluginMap = Record<string, LaunchGroups>;\n\n/** One entry of a config's assembled `args` — flattened to a `Valset`. */\nexport type ArgItem = Valset | Val | string;\n\nexport interface TorbaManifestConfig {\n  /** Hand-written literal artifacts, merged with plugin output (last wins). */\n  artifacts?: Artifact[];\n  /** Override/extra vars layered on top of the merged plugin vars. */\n  vars?: ValDefs;\n  /** Launch command — typically `({ java }) => java.bin`. */\n  command: (plugins: PluginMap) => string;\n  /** Launch args — author-ordered named groups, flattened to a `Valset`. */\n  args: (plugins: PluginMap) => ArgItem[];\n  /** Working directory for the launched process. */\n  workdir?: string | ((plugins: PluginMap) => string);\n  /** Environment variables for the launched process. */\n  envs?: ValDefs | ((plugins: PluginMap) => ValDefs);\n  /** `restrict` globs swept clean after install. */\n  restrict?: string[];\n}\n\nexport interface TorbaConfig {\n  /** Default manifest output path, relative to the config file. */\n  output?: string;\n  /** The plugins whose `build` hooks produce the manifest. */\n  plugins: TorbaPlugin[];\n  /** Declarative manifest fields, separate from tooling config. */\n  manifest: TorbaManifestConfig;\n  /**\n   * Launch-time manifest patch. Re-run on every `torba launch`; the returned\n   * partial is shallow-merged (per field) over the loaded manifest.\n   */\n  runClient?: (manifest: Manifest) => Partial<Manifest>;\n}\n\nexport interface TorbaConfigContext {\n  /** Value of `torba build --mode <m>`; empty string when unset. */\n  mode: string;\n}\n\nexport type TorbaConfigInput =\n  | TorbaConfig\n  | ((ctx: TorbaConfigContext) => TorbaConfig | Promise<TorbaConfig>);\n\n/** Use as the default export of `torba.config.mjs`. */\nexport function defineConfig(input: TorbaConfigInput): TorbaConfigInput {\n  return input;\n}\n\n/** Resolve a config input to a concrete `TorbaConfig`. */\nexport async function resolveConfig(\n  input: TorbaConfigInput,\n  ctx: TorbaConfigContext,\n): Promise<TorbaConfig> {\n  return typeof input === 'function' ? input(ctx) : input;\n}\n","import {\n  type Manifest,\n  type Artifact,\n  type Launch,\n  type ValDefs,\n  type Val,\n  type Valset,\n  deduplicateArtifacts,\n} from '@torba/core';\nimport type { TorbaConfig, ArgItem, PluginMap } from './config';\nimport type { BuildContext } from './plugin';\n\n/** Flatten author-ordered launch groups into a single `Valset`. */\nfunction flattenArgs(items: ReadonlyArray<ArgItem>): Valset {\n  const out: Val[] = [];\n  for (const item of items) {\n    if (typeof item === 'string') out.push({ rules: [], value: [item] });\n    else if (Array.isArray(item)) out.push(...item);\n    else out.push(item);\n  }\n  return out;\n}\n\n/**\n * Run every plugin's `build` hook in parallel, merge the contributions, and\n * assemble the final `Manifest`.\n */\nexport async function buildManifest(\n  config: TorbaConfig,\n  ctx: BuildContext,\n): Promise<Manifest> {\n  ctx.log('torba', `resolving ${config.plugins.length} plugin(s)`);\n  const results = await Promise.all(\n    config.plugins.map(async (p) => ({\n      name: p.name,\n      contribution: await p.build(ctx),\n    })),\n  );\n\n  // Artifacts: plugin output in list order, then literal manifest.artifacts.\n  const artifacts: Artifact[] = [];\n  for (const r of results) {\n    if (r.contribution.artifacts) artifacts.push(...r.contribution.artifacts);\n  }\n  if (config.manifest.artifacts) artifacts.push(...config.manifest.artifacts);\n  const deduped = deduplicateArtifacts(artifacts);\n\n  // Vars: merge plugin vars (list order, last wins); warn on collisions.\n  const vars: Record<string, ValDefs[string]> = {};\n  const owner: Record<string, string> = {};\n  for (const r of results) {\n    if (!r.contribution.vars) continue;\n    for (const [key, value] of Object.entries(r.contribution.vars)) {\n      const prev = owner[key];\n      if (prev !== undefined && prev !== r.name) {\n        ctx.log(\n          'torba',\n          `warning: var '${key}' set by both '${prev}' and '${r.name}' — using '${r.name}'`,\n        );\n      }\n      vars[key] = value;\n      owner[key] = r.name;\n    }\n  }\n  // Config `vars` is the sanctioned override layer (silent).\n  if (config.manifest.vars) {\n    for (const [key, value] of Object.entries(config.manifest.vars)) {\n      vars[key] = value;\n    }\n  }\n\n  // Launch: author functions over the plugin → launch-groups map.\n  const pluginMap: PluginMap = Object.fromEntries(\n    results.map((r) => [r.name, r.contribution.launch ?? {}]),\n  );\n  const m = config.manifest;\n  const launch: Launch = {\n    command: m.command(pluginMap),\n    workdir:\n      typeof m.workdir === 'function'\n        ? m.workdir(pluginMap)\n        : (m.workdir ?? '.'),\n    args: flattenArgs(m.args(pluginMap)),\n    envs: typeof m.envs === 'function' ? m.envs(pluginMap) : (m.envs ?? {}),\n  };\n\n  ctx.log(\n    'torba',\n    `merged ${deduped.length} artifact(s) (${artifacts.length - deduped.length} deduped)`,\n  );\n\n  return {\n    vars,\n    launch,\n    artifacts: deduped,\n    ...(m.restrict && m.restrict.length > 0 ? { restrict: m.restrict } : {}),\n  };\n}\n"],"mappings":";;;;AAuCA,SAAgB,aAAa,QAAkC;AAC7D,QAAO;;;;;;ACUT,SAAgB,aAAa,OAA2C;AACtE,QAAO;;;AAIT,eAAsB,cACpB,OACA,KACsB;AACtB,QAAO,OAAO,UAAU,aAAa,MAAM,IAAI,GAAG;;;;;;AC9CpD,SAAS,YAAY,OAAuC;CAC1D,MAAM,MAAa,EAAE;AACrB,MAAK,MAAM,QAAQ,MACjB,KAAI,OAAO,SAAS,SAAU,KAAI,KAAK;EAAE,OAAO,EAAE;EAAE,OAAO,CAAC,KAAK;EAAE,CAAC;UAC3D,MAAM,QAAQ,KAAK,CAAE,KAAI,KAAK,GAAG,KAAK;KAC1C,KAAI,KAAK,KAAK;AAErB,QAAO;;;;;;AAOT,eAAsB,cACpB,QACA,KACmB;AACnB,KAAI,IAAI,SAAS,aAAa,OAAO,QAAQ,OAAO,YAAY;CAChE,MAAM,UAAU,MAAM,QAAQ,IAC5B,OAAO,QAAQ,IAAI,OAAO,OAAO;EAC/B,MAAM,EAAE;EACR,cAAc,MAAM,EAAE,MAAM,IAAI;EACjC,EAAE,CACJ;CAGD,MAAM,YAAwB,EAAE;AAChC,MAAK,MAAM,KAAK,QACd,KAAI,EAAE,aAAa,UAAW,WAAU,KAAK,GAAG,EAAE,aAAa,UAAU;AAE3E,KAAI,OAAO,SAAS,UAAW,WAAU,KAAK,GAAG,OAAO,SAAS,UAAU;CAC3E,MAAM,UAAU,qBAAqB,UAAU;CAG/C,MAAM,OAAwC,EAAE;CAChD,MAAM,QAAgC,EAAE;AACxC,MAAK,MAAM,KAAK,SAAS;AACvB,MAAI,CAAC,EAAE,aAAa,KAAM;AAC1B,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,EAAE,aAAa,KAAK,EAAE;GAC9D,MAAM,OAAO,MAAM;AACnB,OAAI,SAAS,UAAa,SAAS,EAAE,KACnC,KAAI,IACF,SACA,iBAAiB,IAAI,iBAAiB,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,GAChF;AAEH,QAAK,OAAO;AACZ,SAAM,OAAO,EAAE;;;AAInB,KAAI,OAAO,SAAS,KAClB,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,SAAS,KAAK,CAC7D,MAAK,OAAO;CAKhB,MAAM,YAAuB,OAAO,YAClC,QAAQ,KAAK,MAAM,CAAC,EAAE,MAAM,EAAE,aAAa,UAAU,EAAE,CAAC,CAAC,CAC1D;CACD,MAAM,IAAI,OAAO;CACjB,MAAM,SAAiB;EACrB,SAAS,EAAE,QAAQ,UAAU;EAC7B,SACE,OAAO,EAAE,YAAY,aACjB,EAAE,QAAQ,UAAU,GACnB,EAAE,WAAW;EACpB,MAAM,YAAY,EAAE,KAAK,UAAU,CAAC;EACpC,MAAM,OAAO,EAAE,SAAS,aAAa,EAAE,KAAK,UAAU,GAAI,EAAE,QAAQ,EAAE;EACvE;AAED,KAAI,IACF,SACA,UAAU,QAAQ,OAAO,gBAAgB,UAAU,SAAS,QAAQ,OAAO,WAC5E;AAED,QAAO;EACL;EACA;EACA,WAAW;EACX,GAAI,EAAE,YAAY,EAAE,SAAS,SAAS,IAAI,EAAE,UAAU,EAAE,UAAU,GAAG,EAAE;EACxE"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@torba/dev",
+  "version": "1.0.10",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown lib/index.ts --format esm,cjs --dts --clean",
+    "test": "vitest run tests/unit --passWithNoTests"
+  },
+  "type": "module",
+  "dependencies": {
+    "@torba/core": "^1.0.10"
+  },
+  "peerDependencies": {
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "vitest": "*"
+  }
+}