@styx-api/cli 0.1.0

package/dist/bin.cjs

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+const require_write = require('./write-BtRGJfHV.cjs');
+let cac = require("cac");
+
+//#region src/command.ts
+/**
+* Run the `build` command without side effects (no process.exit, no I/O).
+* Returns the exit code, buffered output lines, and file map; the bin glue
+* is responsible for actually writing files and forwarding output.
+*
+* Exit code split: 2 for CLI-shape errors (bad flag, unknown backend),
+* 1 for build errors (parse failure, conflicting input/catalog), 0 for
+* success.
+*/
+function runBuildCommand(input, flags) {
+	const stdout = [];
+	const stderr = [];
+	const out = flags.out;
+	if (!out) {
+		stderr.push("error: -o/--out is required");
+		return {
+			exitCode: 2,
+			stdout,
+			stderr,
+			files: []
+		};
+	}
+	const { backends, unknown } = require_write.resolveBackends(collectList(flags.backend));
+	if (unknown.length > 0) {
+		stderr.push(`error: unknown backend(s): ${unknown.join(", ")}`);
+		stderr.push(`known: ${require_write.knownBackends.join(", ")}`);
+		return {
+			exitCode: 2,
+			stdout,
+			stderr,
+			files: []
+		};
+	}
+	if (backends.length === 0) {
+		stderr.push("error: no backends selected");
+		return {
+			exitCode: 2,
+			stdout,
+			stderr,
+			files: []
+		};
+	}
+	const mode = parseMode(flags.mode);
+	if (!mode) {
+		stderr.push(`error: --mode must be one of scripts | single | multi (got "${flags.mode}")`);
+		return {
+			exitCode: 2,
+			stdout,
+			stderr,
+			files: []
+		};
+	}
+	const result = require_write.build({
+		input,
+		catalog: flags.catalog,
+		out,
+		backends,
+		mode
+	});
+	for (const w of result.warnings) stderr.push(`warn: ${w}`);
+	for (const e of result.errors) stderr.push(`error: ${e}`);
+	if (result.stats) {
+		const { appsCompiled, appsFailed, appsSkipped } = result.stats;
+		stderr.push(`summary: ${appsCompiled} compiled, ${appsFailed} failed, ${appsSkipped} skipped`);
+	}
+	if (result.errors.length > 0) return {
+		exitCode: 1,
+		stdout,
+		stderr,
+		files: []
+	};
+	stdout.push(`wrote ${result.files.length} file${result.files.length === 1 ? "" : "s"} to ${out}`);
+	return {
+		exitCode: 0,
+		stdout,
+		stderr,
+		files: result.files
+	};
+}
+function collectList(value) {
+	if (value === void 0) return [];
+	return (Array.isArray(value) ? value : [value]).flatMap((v) => v.split(",")).map((v) => v.trim()).filter(Boolean);
+}
+function parseMode(value) {
+	if (!value) return "scripts";
+	if (value === "scripts" || value === "single" || value === "multi") return value;
+	return null;
+}
+
+//#endregion
+//#region src/bin.ts
+const cli = (0, cac.cac)("styx");
+cli.command("build [input]", "Compile a descriptor or catalog into target-language wrappers").option("-o, --out <dir>", "Output directory").option("--catalog <dir>", "Walk a niwrap-style catalog (project/package/version/app layers)").option("-b, --backend <name>", `Backend to emit (repeatable, or comma-separated). Known: ${require_write.knownBackends.join(", ")}`, { default: "python" }).option("-m, --mode <mode>", "Which emit tiers run: scripts (app only) | single (+ package) | multi (+ project)", { default: "scripts" }).action((input, flags) => {
+	const result = runBuildCommand(input, flags);
+	for (const line of result.stderr) console.error(line);
+	if (result.exitCode === 0) require_write.writeFiles(result.files);
+	for (const line of result.stdout) console.log(line);
+	if (result.exitCode !== 0) process.exit(result.exitCode);
+});
+cli.help();
+cli.version("0.0.1");
+cli.parse();
+
+//#endregion

package/dist/bin.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/bin.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/bin.mjs

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+import { i as build, n as knownBackends, r as resolveBackends, t as writeFiles } from "./write-DSW1zlom.mjs";
+import { cac } from "cac";
+
+//#region src/command.ts
+/**
+* Run the `build` command without side effects (no process.exit, no I/O).
+* Returns the exit code, buffered output lines, and file map; the bin glue
+* is responsible for actually writing files and forwarding output.
+*
+* Exit code split: 2 for CLI-shape errors (bad flag, unknown backend),
+* 1 for build errors (parse failure, conflicting input/catalog), 0 for
+* success.
+*/
+function runBuildCommand(input, flags) {
+	const stdout = [];
+	const stderr = [];
+	const out = flags.out;
+	if (!out) {
+		stderr.push("error: -o/--out is required");
+		return {
+			exitCode: 2,
+			stdout,
+			stderr,
+			files: []
+		};
+	}
+	const { backends, unknown } = resolveBackends(collectList(flags.backend));
+	if (unknown.length > 0) {
+		stderr.push(`error: unknown backend(s): ${unknown.join(", ")}`);
+		stderr.push(`known: ${knownBackends.join(", ")}`);
+		return {
+			exitCode: 2,
+			stdout,
+			stderr,
+			files: []
+		};
+	}
+	if (backends.length === 0) {
+		stderr.push("error: no backends selected");
+		return {
+			exitCode: 2,
+			stdout,
+			stderr,
+			files: []
+		};
+	}
+	const mode = parseMode(flags.mode);
+	if (!mode) {
+		stderr.push(`error: --mode must be one of scripts | single | multi (got "${flags.mode}")`);
+		return {
+			exitCode: 2,
+			stdout,
+			stderr,
+			files: []
+		};
+	}
+	const result = build({
+		input,
+		catalog: flags.catalog,
+		out,
+		backends,
+		mode
+	});
+	for (const w of result.warnings) stderr.push(`warn: ${w}`);
+	for (const e of result.errors) stderr.push(`error: ${e}`);
+	if (result.stats) {
+		const { appsCompiled, appsFailed, appsSkipped } = result.stats;
+		stderr.push(`summary: ${appsCompiled} compiled, ${appsFailed} failed, ${appsSkipped} skipped`);
+	}
+	if (result.errors.length > 0) return {
+		exitCode: 1,
+		stdout,
+		stderr,
+		files: []
+	};
+	stdout.push(`wrote ${result.files.length} file${result.files.length === 1 ? "" : "s"} to ${out}`);
+	return {
+		exitCode: 0,
+		stdout,
+		stderr,
+		files: result.files
+	};
+}
+function collectList(value) {
+	if (value === void 0) return [];
+	return (Array.isArray(value) ? value : [value]).flatMap((v) => v.split(",")).map((v) => v.trim()).filter(Boolean);
+}
+function parseMode(value) {
+	if (!value) return "scripts";
+	if (value === "scripts" || value === "single" || value === "multi") return value;
+	return null;
+}
+
+//#endregion
+//#region src/bin.ts
+const cli = cac("styx");
+cli.command("build [input]", "Compile a descriptor or catalog into target-language wrappers").option("-o, --out <dir>", "Output directory").option("--catalog <dir>", "Walk a niwrap-style catalog (project/package/version/app layers)").option("-b, --backend <name>", `Backend to emit (repeatable, or comma-separated). Known: ${knownBackends.join(", ")}`, { default: "python" }).option("-m, --mode <mode>", "Which emit tiers run: scripts (app only) | single (+ package) | multi (+ project)", { default: "scripts" }).action((input, flags) => {
+	const result = runBuildCommand(input, flags);
+	for (const line of result.stderr) console.error(line);
+	if (result.exitCode === 0) writeFiles(result.files);
+	for (const line of result.stdout) console.log(line);
+	if (result.exitCode !== 0) process.exit(result.exitCode);
+});
+cli.help();
+cli.version("0.0.1");
+cli.parse();
+
+//#endregion
+export {  };
+//# sourceMappingURL=bin.mjs.map

package/dist/bin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.mjs","names":[],"sources":["../src/command.ts","../src/bin.ts"],"sourcesContent":["import { knownBackends, resolveBackends } from \"./backends.js\";\nimport { build, type BuildMode } from \"./build.js\";\nimport type { BuiltFile } from \"./build.js\";\n\nexport interface BuildFlags {\n  out?: string;\n  catalog?: string;\n  backend?: string | string[];\n  mode?: string;\n}\n\nexport interface RunResult {\n  exitCode: number;\n  stdout: string[];\n  stderr: string[];\n  files: BuiltFile[];\n}\n\n/**\n * Run the `build` command without side effects (no process.exit, no I/O).\n * Returns the exit code, buffered output lines, and file map; the bin glue\n * is responsible for actually writing files and forwarding output.\n *\n * Exit code split: 2 for CLI-shape errors (bad flag, unknown backend),\n * 1 for build errors (parse failure, conflicting input/catalog), 0 for\n * success.\n */\nexport function runBuildCommand(input: string | undefined, flags: BuildFlags): RunResult {\n  const stdout: string[] = [];\n  const stderr: string[] = [];\n\n  const out = flags.out;\n  if (!out) {\n    stderr.push(\"error: -o/--out is required\");\n    return { exitCode: 2, stdout, stderr, files: [] };\n  }\n\n  const backendNames = collectList(flags.backend);\n  const { backends, unknown } = resolveBackends(backendNames);\n  if (unknown.length > 0) {\n    stderr.push(`error: unknown backend(s): ${unknown.join(\", \")}`);\n    stderr.push(`known: ${knownBackends.join(\", \")}`);\n    return { exitCode: 2, stdout, stderr, files: [] };\n  }\n  if (backends.length === 0) {\n    stderr.push(\"error: no backends selected\");\n    return { exitCode: 2, stdout, stderr, files: [] };\n  }\n\n  const mode = parseMode(flags.mode);\n  if (!mode) {\n    stderr.push(`error: --mode must be one of scripts | single | multi (got \"${flags.mode}\")`);\n    return { exitCode: 2, stdout, stderr, files: [] };\n  }\n\n  const result = build({ input, catalog: flags.catalog, out, backends, mode });\n\n  for (const w of result.warnings) stderr.push(`warn: ${w}`);\n  for (const e of result.errors) stderr.push(`error: ${e}`);\n\n  // Catalog builds report a tool tally so a few broken tools in a large catalog\n  // are visible at a glance rather than buried in per-tool error lines.\n  if (result.stats) {\n    const { appsCompiled, appsFailed, appsSkipped } = result.stats;\n    stderr.push(`summary: ${appsCompiled} compiled, ${appsFailed} failed, ${appsSkipped} skipped`);\n  }\n\n  if (result.errors.length > 0) {\n    return { exitCode: 1, stdout, stderr, files: [] };\n  }\n\n  stdout.push(`wrote ${result.files.length} file${result.files.length === 1 ? \"\" : \"s\"} to ${out}`);\n  return { exitCode: 0, stdout, stderr, files: result.files };\n}\n\nfunction collectList(value: string | string[] | undefined): string[] {\n  if (value === undefined) return [];\n  const arr = Array.isArray(value) ? value : [value];\n  return arr\n    .flatMap((v) => v.split(\",\"))\n    .map((v) => v.trim())\n    .filter(Boolean);\n}\n\nfunction parseMode(value: string | undefined): BuildMode | null {\n  if (!value) return \"scripts\";\n  if (value === \"scripts\" || value === \"single\" || value === \"multi\") return value;\n  return null;\n}\n","#!/usr/bin/env node\nimport { cac } from \"cac\";\n\nimport { knownBackends } from \"./backends.js\";\nimport { runBuildCommand, type BuildFlags } from \"./command.js\";\nimport { writeFiles } from \"./write.js\";\n\nconst cli = cac(\"styx\");\n\ncli\n  .command(\"build [input]\", \"Compile a descriptor or catalog into target-language wrappers\")\n  .option(\"-o, --out <dir>\", \"Output directory\")\n  .option(\"--catalog <dir>\", \"Walk a niwrap-style catalog (project/package/version/app layers)\")\n  .option(\n    \"-b, --backend <name>\",\n    `Backend to emit (repeatable, or comma-separated). Known: ${knownBackends.join(\", \")}`,\n    { default: \"python\" },\n  )\n  .option(\n    \"-m, --mode <mode>\",\n    \"Which emit tiers run: scripts (app only) | single (+ package) | multi (+ project)\",\n    { default: \"scripts\" },\n  )\n  .action((input: string | undefined, flags: BuildFlags) => {\n    const result = runBuildCommand(input, flags);\n    for (const line of result.stderr) console.error(line);\n    if (result.exitCode === 0) writeFiles(result.files);\n    for (const line of result.stdout) console.log(line);\n    if (result.exitCode !== 0) process.exit(result.exitCode);\n  });\n\ncli.help();\ncli.version(\"0.0.1\");\n\ncli.parse();\n"],"mappings":";;;;;;;;;;;;;;AA2BA,SAAgB,gBAAgB,OAA2B,OAA8B;CACvF,MAAM,SAAmB,EAAE;CAC3B,MAAM,SAAmB,EAAE;CAE3B,MAAM,MAAM,MAAM;AAClB,KAAI,CAAC,KAAK;AACR,SAAO,KAAK,8BAA8B;AAC1C,SAAO;GAAE,UAAU;GAAG;GAAQ;GAAQ,OAAO,EAAE;GAAE;;CAInD,MAAM,EAAE,UAAU,YAAY,gBADT,YAAY,MAAM,QAAQ,CACY;AAC3D,KAAI,QAAQ,SAAS,GAAG;AACtB,SAAO,KAAK,8BAA8B,QAAQ,KAAK,KAAK,GAAG;AAC/D,SAAO,KAAK,UAAU,cAAc,KAAK,KAAK,GAAG;AACjD,SAAO;GAAE,UAAU;GAAG;GAAQ;GAAQ,OAAO,EAAE;GAAE;;AAEnD,KAAI,SAAS,WAAW,GAAG;AACzB,SAAO,KAAK,8BAA8B;AAC1C,SAAO;GAAE,UAAU;GAAG;GAAQ;GAAQ,OAAO,EAAE;GAAE;;CAGnD,MAAM,OAAO,UAAU,MAAM,KAAK;AAClC,KAAI,CAAC,MAAM;AACT,SAAO,KAAK,+DAA+D,MAAM,KAAK,IAAI;AAC1F,SAAO;GAAE,UAAU;GAAG;GAAQ;GAAQ,OAAO,EAAE;GAAE;;CAGnD,MAAM,SAAS,MAAM;EAAE;EAAO,SAAS,MAAM;EAAS;EAAK;EAAU;EAAM,CAAC;AAE5E,MAAK,MAAM,KAAK,OAAO,SAAU,QAAO,KAAK,SAAS,IAAI;AAC1D,MAAK,MAAM,KAAK,OAAO,OAAQ,QAAO,KAAK,UAAU,IAAI;AAIzD,KAAI,OAAO,OAAO;EAChB,MAAM,EAAE,cAAc,YAAY,gBAAgB,OAAO;AACzD,SAAO,KAAK,YAAY,aAAa,aAAa,WAAW,WAAW,YAAY,UAAU;;AAGhG,KAAI,OAAO,OAAO,SAAS,EACzB,QAAO;EAAE,UAAU;EAAG;EAAQ;EAAQ,OAAO,EAAE;EAAE;AAGnD,QAAO,KAAK,SAAS,OAAO,MAAM,OAAO,OAAO,OAAO,MAAM,WAAW,IAAI,KAAK,IAAI,MAAM,MAAM;AACjG,QAAO;EAAE,UAAU;EAAG;EAAQ;EAAQ,OAAO,OAAO;EAAO;;AAG7D,SAAS,YAAY,OAAgD;AACnE,KAAI,UAAU,OAAW,QAAO,EAAE;AAElC,SADY,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM,EAE/C,SAAS,MAAM,EAAE,MAAM,IAAI,CAAC,CAC5B,KAAK,MAAM,EAAE,MAAM,CAAC,CACpB,OAAO,QAAQ;;AAGpB,SAAS,UAAU,OAA6C;AAC9D,KAAI,CAAC,MAAO,QAAO;AACnB,KAAI,UAAU,aAAa,UAAU,YAAY,UAAU,QAAS,QAAO;AAC3E,QAAO;;;;;AChFT,MAAM,MAAM,IAAI,OAAO;AAEvB,IACG,QAAQ,iBAAiB,gEAAgE,CACzF,OAAO,mBAAmB,mBAAmB,CAC7C,OAAO,mBAAmB,mEAAmE,CAC7F,OACC,wBACA,4DAA4D,cAAc,KAAK,KAAK,IACpF,EAAE,SAAS,UAAU,CACtB,CACA,OACC,qBACA,qFACA,EAAE,SAAS,WAAW,CACvB,CACA,QAAQ,OAA2B,UAAsB;CACxD,MAAM,SAAS,gBAAgB,OAAO,MAAM;AAC5C,MAAK,MAAM,QAAQ,OAAO,OAAQ,SAAQ,MAAM,KAAK;AACrD,KAAI,OAAO,aAAa,EAAG,YAAW,OAAO,MAAM;AACnD,MAAK,MAAM,QAAQ,OAAO,OAAQ,SAAQ,IAAI,KAAK;AACnD,KAAI,OAAO,aAAa,EAAG,SAAQ,KAAK,OAAO,SAAS;EACxD;AAEJ,IAAI,MAAM;AACV,IAAI,QAAQ,QAAQ;AAEpB,IAAI,OAAO"}

package/dist/index.cjs

@@ -0,0 +1,8 @@
+const require_write = require('./write-BtRGJfHV.cjs');
+
+exports.build = require_write.build;
+exports.detectLevel = require_write.detectLevel;
+exports.knownBackends = require_write.knownBackends;
+exports.loadCatalog = require_write.loadCatalog;
+exports.resolveBackends = require_write.resolveBackends;
+exports.writeFiles = require_write.writeFiles;

package/dist/index.d.cts

@@ -0,0 +1,91 @@
+import { Backend, PackageMeta, ProjectMeta } from "@styx-api/core";
+
+//#region src/build.d.ts
+type BuildMode = "scripts" | "single" | "multi";
+interface BuildOptions {
+  /** Single-descriptor input file (mutually exclusive with `catalog`). */
+  input?: string;
+  /** Catalog directory (mutually exclusive with `input`). */
+  catalog?: string;
+  /** Output directory; per-backend files end up under `<out>/<backend.target>/...`. */
+  out: string;
+  /** Backends to run (instances pre-resolved by the caller). */
+  backends: Backend[];
+  /** Which emit tiers to run. */
+  mode: BuildMode;
+}
+/** A single file from a backend run, keyed by destination path. */
+interface BuiltFile {
+  /** Absolute destination path. */
+  path: string;
+  content: string;
+}
+/** Per-tool tallies for a catalog build (undefined for single-descriptor builds). */
+interface BuildStats {
+  appsCompiled: number;
+  appsFailed: number;
+  appsSkipped: number;
+}
+interface BuildResult {
+  files: BuiltFile[];
+  errors: string[];
+  warnings: string[];
+  /** Catalog-build tallies; set only by `--catalog` builds. */
+  stats?: BuildStats;
+}
+/**
+ * Run the build. Returns the assembled file map and diagnostics; the caller
+ * is responsible for actually writing to disk (so tests can introspect the
+ * map directly).
+ */
+declare function build(options: BuildOptions): BuildResult;
+//#endregion
+//#region src/catalog.d.ts
+/**
+ * Loaded catalog: a project containing packages, each holding one or more
+ * apps. We always normalize to project > package > app even when the catalog
+ * root only describes a subset of the hierarchy (e.g. a single version dir).
+ */
+interface CatalogProject {
+  meta: ProjectMeta;
+  packages: CatalogPackage[];
+  /** Non-fatal issues found while walking the catalog (e.g. skipped stub apps). */
+  warnings: string[];
+}
+interface CatalogPackage {
+  meta: PackageMeta;
+  apps: CatalogApp[];
+}
+interface CatalogApp {
+  /** Stable identifier from `app.json#name`, used for the emitted module slug. */
+  name: string;
+  /** Absolute path to the descriptor file referenced by `app.json#source`. */
+  sourcePath: string;
+  sourceFormat?: string;
+}
+/**
+ * Detect what level of the niwrap catalog a directory describes.
+ * Project dirs contain `project.json`, package dirs contain `package.json`,
+ * version dirs contain `version.json`, app dirs contain `app.json`.
+ */
+type CatalogLevel = "project" | "package" | "version" | "app";
+declare function detectLevel(dir: string): CatalogLevel | null;
+/**
+ * Load a catalog from any niwrap layout level. The level is auto-detected from
+ * which `*.json` index file is present in `root`. Always returns a normalized
+ * `project > package > app` shape, synthesizing missing layers as needed.
+ */
+declare function loadCatalog(root: string): CatalogProject;
+//#endregion
+//#region src/backends.d.ts
+declare const knownBackends: string[];
+declare function resolveBackends(names: string[]): {
+  backends: Backend[];
+  unknown: string[];
+};
+//#endregion
+//#region src/write.d.ts
+declare function writeFiles(files: BuiltFile[]): void;
+//#endregion
+export { type BuildMode, type BuildOptions, type BuildResult, type BuiltFile, type CatalogApp, type CatalogLevel, type CatalogPackage, type CatalogProject, build, detectLevel, knownBackends, loadCatalog, resolveBackends, writeFiles };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/build.ts","../src/catalog.ts","../src/backends.ts","../src/write.ts"],"mappings":";;;KAoBY,SAAA;AAAA,UASK,YAAA;EATL;EAWV,KAAA;;EAEA,OAAA;EAbmB;EAenB,GAAA;EAN2B;EAQ3B,QAAA,EAAU,OAAA;EAEK;EAAf,IAAA,EAAM,SAAA;AAAA;;UAIS,SAAA;EANL;EAQV,IAAA;EACA,OAAA;AAAA;;UAIe,UAAA;EACf,YAAA;EACA,UAAA;EACA,WAAA;AAAA;AAAA,UAGe,WAAA;EACf,KAAA,EAAO,SAAA;EACP,MAAA;EACA,QAAA;EARA;EAUA,KAAA,GAAQ,UAAA;AAAA;;;AALV;;;iBAkBgB,KAAA,CAAM,OAAA,EAAS,YAAA,GAAe,WAAA;;;;;AAtD9C;;;UCViB,cAAA;EACf,IAAA,EAAM,WAAA;EACN,QAAA,EAAU,cAAA;EDiBiB;ECf3B,QAAA;AAAA;AAAA,UAGe,cAAA;EACf,IAAA,EAAM,WAAA;EACN,IAAA,EAAM,UAAA;AAAA;AAAA,UAGS,UAAA;EDiBf;ECfA,IAAA;EDee;ECbf,UAAA;EACA,YAAA;AAAA;;;;ADuBF;;KC4CY,YAAA;AAAA,iBAEI,WAAA,CAAY,GAAA,WAAc,YAAA;;;;;;iBAmH1B,WAAA,CAAY,IAAA,WAAe,cAAA;;;cC9L9B,aAAA;AAAA,iBAEG,eAAA,CAAgB,KAAA;EAAoB,QAAA,EAAU,OAAA;EAAW,OAAA;AAAA;;;iBClBzD,UAAA,CAAW,KAAA,EAAO,SAAA"}

package/dist/index.d.mts

@@ -0,0 +1,91 @@
+import { Backend, PackageMeta, ProjectMeta } from "@styx-api/core";
+
+//#region src/build.d.ts
+type BuildMode = "scripts" | "single" | "multi";
+interface BuildOptions {
+  /** Single-descriptor input file (mutually exclusive with `catalog`). */
+  input?: string;
+  /** Catalog directory (mutually exclusive with `input`). */
+  catalog?: string;
+  /** Output directory; per-backend files end up under `<out>/<backend.target>/...`. */
+  out: string;
+  /** Backends to run (instances pre-resolved by the caller). */
+  backends: Backend[];
+  /** Which emit tiers to run. */
+  mode: BuildMode;
+}
+/** A single file from a backend run, keyed by destination path. */
+interface BuiltFile {
+  /** Absolute destination path. */
+  path: string;
+  content: string;
+}
+/** Per-tool tallies for a catalog build (undefined for single-descriptor builds). */
+interface BuildStats {
+  appsCompiled: number;
+  appsFailed: number;
+  appsSkipped: number;
+}
+interface BuildResult {
+  files: BuiltFile[];
+  errors: string[];
+  warnings: string[];
+  /** Catalog-build tallies; set only by `--catalog` builds. */
+  stats?: BuildStats;
+}
+/**
+ * Run the build. Returns the assembled file map and diagnostics; the caller
+ * is responsible for actually writing to disk (so tests can introspect the
+ * map directly).
+ */
+declare function build(options: BuildOptions): BuildResult;
+//#endregion
+//#region src/catalog.d.ts
+/**
+ * Loaded catalog: a project containing packages, each holding one or more
+ * apps. We always normalize to project > package > app even when the catalog
+ * root only describes a subset of the hierarchy (e.g. a single version dir).
+ */
+interface CatalogProject {
+  meta: ProjectMeta;
+  packages: CatalogPackage[];
+  /** Non-fatal issues found while walking the catalog (e.g. skipped stub apps). */
+  warnings: string[];
+}
+interface CatalogPackage {
+  meta: PackageMeta;
+  apps: CatalogApp[];
+}
+interface CatalogApp {
+  /** Stable identifier from `app.json#name`, used for the emitted module slug. */
+  name: string;
+  /** Absolute path to the descriptor file referenced by `app.json#source`. */
+  sourcePath: string;
+  sourceFormat?: string;
+}
+/**
+ * Detect what level of the niwrap catalog a directory describes.
+ * Project dirs contain `project.json`, package dirs contain `package.json`,
+ * version dirs contain `version.json`, app dirs contain `app.json`.
+ */
+type CatalogLevel = "project" | "package" | "version" | "app";
+declare function detectLevel(dir: string): CatalogLevel | null;
+/**
+ * Load a catalog from any niwrap layout level. The level is auto-detected from
+ * which `*.json` index file is present in `root`. Always returns a normalized
+ * `project > package > app` shape, synthesizing missing layers as needed.
+ */
+declare function loadCatalog(root: string): CatalogProject;
+//#endregion
+//#region src/backends.d.ts
+declare const knownBackends: string[];
+declare function resolveBackends(names: string[]): {
+  backends: Backend[];
+  unknown: string[];
+};
+//#endregion
+//#region src/write.d.ts
+declare function writeFiles(files: BuiltFile[]): void;
+//#endregion
+export { type BuildMode, type BuildOptions, type BuildResult, type BuiltFile, type CatalogApp, type CatalogLevel, type CatalogPackage, type CatalogProject, build, detectLevel, knownBackends, loadCatalog, resolveBackends, writeFiles };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/build.ts","../src/catalog.ts","../src/backends.ts","../src/write.ts"],"mappings":";;;KAoBY,SAAA;AAAA,UASK,YAAA;EATL;EAWV,KAAA;;EAEA,OAAA;EAbmB;EAenB,GAAA;EAN2B;EAQ3B,QAAA,EAAU,OAAA;EAEK;EAAf,IAAA,EAAM,SAAA;AAAA;;UAIS,SAAA;EANL;EAQV,IAAA;EACA,OAAA;AAAA;;UAIe,UAAA;EACf,YAAA;EACA,UAAA;EACA,WAAA;AAAA;AAAA,UAGe,WAAA;EACf,KAAA,EAAO,SAAA;EACP,MAAA;EACA,QAAA;EARA;EAUA,KAAA,GAAQ,UAAA;AAAA;;;AALV;;;iBAkBgB,KAAA,CAAM,OAAA,EAAS,YAAA,GAAe,WAAA;;;;;AAtD9C;;;UCViB,cAAA;EACf,IAAA,EAAM,WAAA;EACN,QAAA,EAAU,cAAA;EDiBiB;ECf3B,QAAA;AAAA;AAAA,UAGe,cAAA;EACf,IAAA,EAAM,WAAA;EACN,IAAA,EAAM,UAAA;AAAA;AAAA,UAGS,UAAA;EDiBf;ECfA,IAAA;EDee;ECbf,UAAA;EACA,YAAA;AAAA;;;;ADuBF;;KC4CY,YAAA;AAAA,iBAEI,WAAA,CAAY,GAAA,WAAc,YAAA;;;;;;iBAmH1B,WAAA,CAAY,IAAA,WAAe,cAAA;;;cC9L9B,aAAA;AAAA,iBAEG,eAAA,CAAgB,KAAA;EAAoB,QAAA,EAAU,OAAA;EAAW,OAAA;AAAA;;;iBClBzD,UAAA,CAAW,KAAA,EAAO,SAAA"}

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import { a as detectLevel, i as build, n as knownBackends, o as loadCatalog, r as resolveBackends, t as writeFiles } from "./write-DSW1zlom.mjs";
+
+export { build, detectLevel, knownBackends, loadCatalog, resolveBackends, writeFiles };