@powerhousedao/shared 6.2.3-dev.13 → 6.2.3-dev.15

package/dist/clis/build-pieces.d.mts

@@ -0,0 +1,95 @@
+import { t as InlineConfig } from "./index-CyAv0ucZ.mjs";
+import { t as Manifest } from "./types-D17YQuYG.mjs";
+import * as node_fs0 from "node:fs";
+
+//#region clis/build-pieces.d.mts
+type PiecePlan = {
+  /** The directory under pieces/, and so under <outDir>/node/pieces. */dir: string; /** Source entry, relative to the project root: pieces/<dir>/index.ts. */
+  entry: string; /** Where the piece lands, relative to the project root. */
+  outDir: string;
+};
+type PieceBuildTarget = {
+  projectRoot: string;
+  outDir: string;
+  pieces: PiecePlan[];
+};
+type PackagePiece = {
+  name: string;
+  version: string;
+  entry?: string;
+  bundle?: string;
+};
+type PieceMetadata = Record<string, unknown> & {
+  displayName?: string;
+  description?: string;
+  actions?: Record<string, unknown>;
+  triggers?: Record<string, unknown>;
+};
+type DescribedPiece = {
+  name: string;
+  version: string;
+  metadata: PieceMetadata;
+};
+type DescribeResult = {
+  list: PackagePiece[];
+  pieces: DescribedPiece[];
+  errors: {
+    name: string;
+    message: string;
+  }[];
+};
+type BuiltPiece = {
+  name: string;
+  version: string;
+  displayName?: string;
+  description?: string; /** Piece directory, relative to the project root, `/` separated. */
+  bundle: string; /** The descriptor inside it, relative to the project root, `/` separated. */
+  descriptor: string;
+};
+type PackageIdentity = {
+  name: string;
+  version: string;
+  license?: string;
+};
+type PieceBuildOptions = {
+  /** The bundler: tsdown's `build`, handed in so this module never loads it. */bundle: (config: InlineConfig) => Promise<unknown>;
+};
+declare function statSafe(p: string): node_fs0.Stats | null;
+declare function expandEntryGlobs(root: string, globs: string[]): string[];
+declare function planPieces(projectRoot: string, outDir: string): PiecePlan[];
+declare function createJsonReplacer(): (this: unknown, _key: string, value: unknown) => {} | null | undefined;
+declare const DESCRIBE_HELPERS = "\nconst isRecord = (value) => typeof value === \"object\" && value !== null;\n\nfunction findPiece(mod) {\n  const candidates = [\n    ...Object.values(mod),\n    ...(isRecord(mod.default) ? Object.values(mod.default) : []),\n    mod.default,\n  ];\n  for (const candidate of candidates) {\n    if (isRecord(candidate) && candidate.constructor?.name === \"Piece\") {\n      return candidate;\n    }\n  }\n  for (const candidate of candidates) {\n    if (\n      isRecord(candidate) &&\n      typeof candidate.displayName === \"string\" &&\n      (isRecord(candidate.actions) ||\n        typeof candidate.actions === \"function\" ||\n        typeof candidate.getAction === \"function\")\n    ) {\n      return candidate;\n    }\n  }\n  return undefined;\n}\n\nfunction describePiece(piece) {\n  if (typeof piece.metadata === \"function\") return piece.metadata();\n  const call = (value) => (typeof value === \"function\" ? value.call(piece) : value);\n  return {\n    displayName: piece.displayName,\n    logoUrl: piece.logoUrl,\n    description: piece.description,\n    authors: piece.authors,\n    categories: piece.categories,\n    auth: piece.auth,\n    minimumSupportedRelease: piece.minimumSupportedRelease,\n    maximumSupportedRelease: piece.maximumSupportedRelease,\n    deprecated: piece.deprecated,\n    actions: call(piece.actions) ?? {},\n    triggers: call(piece.triggers) ?? {},\n  };\n}\n\nfunction createJsonReplacer() {\n  const ancestors = [];\n  return function replace(_key, value) {\n    if (typeof value === \"function\" || value === undefined) return undefined;\n    if (typeof value === \"bigint\") return value.toString();\n    if (typeof value !== \"object\" || value === null) return value;\n    while (ancestors.length > 0 && ancestors.at(-1) !== this) ancestors.pop();\n    if (ancestors.includes(value)) return undefined;\n    ancestors.push(value);\n    return value;\n  };\n}\n";
+declare const DESCRIBE_SCRIPT = "\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { isAbsolute, join } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\nconst job = JSON.parse(readFileSync(process.argv[2], \"utf8\"));\n\nconst isRecord = (value) => typeof value === \"object\" && value !== null;\n\nfunction findPiece(mod) {\n  const candidates = [\n    ...Object.values(mod),\n    ...(isRecord(mod.default) ? Object.values(mod.default) : []),\n    mod.default,\n  ];\n  for (const candidate of candidates) {\n    if (isRecord(candidate) && candidate.constructor?.name === \"Piece\") {\n      return candidate;\n    }\n  }\n  for (const candidate of candidates) {\n    if (\n      isRecord(candidate) &&\n      typeof candidate.displayName === \"string\" &&\n      (isRecord(candidate.actions) ||\n        typeof candidate.actions === \"function\" ||\n        typeof candidate.getAction === \"function\")\n    ) {\n      return candidate;\n    }\n  }\n  return undefined;\n}\n\nfunction describePiece(piece) {\n  if (typeof piece.metadata === \"function\") return piece.metadata();\n  const call = (value) => (typeof value === \"function\" ? value.call(piece) : value);\n  return {\n    displayName: piece.displayName,\n    logoUrl: piece.logoUrl,\n    description: piece.description,\n    authors: piece.authors,\n    categories: piece.categories,\n    auth: piece.auth,\n    minimumSupportedRelease: piece.minimumSupportedRelease,\n    maximumSupportedRelease: piece.maximumSupportedRelease,\n    deprecated: piece.deprecated,\n    actions: call(piece.actions) ?? {},\n    triggers: call(piece.triggers) ?? {},\n  };\n}\n\nfunction createJsonReplacer() {\n  const ancestors = [];\n  return function replace(_key, value) {\n    if (typeof value === \"function\" || value === undefined) return undefined;\n    if (typeof value === \"bigint\") return value.toString();\n    if (typeof value !== \"object\" || value === null) return value;\n    while (ancestors.length > 0 && ancestors.at(-1) !== this) ancestors.pop();\n    if (ancestors.includes(value)) return undefined;\n    ancestors.push(value);\n    return value;\n  };\n}\n\n// Says why the child gave up in the one place the parent always reads, so a\n// failure reports the cause and never the text of this script.\nfunction fail(message) {\n  writeFileSync(job.outFile, JSON.stringify({ fatal: message }));\n  process.exit(1);\n}\n\n// The module to load for a list entry; a bundle names its own main.\nfunction entryFile(piece) {\n  const declared = piece.entry ?? piece.bundle;\n  if (typeof declared !== \"string\") return undefined;\n  const path = isAbsolute(declared) ? declared : join(job.projectRoot, declared);\n  if (piece.entry) return path;\n  const pkgFile = join(path, \"package.json\");\n  if (!existsSync(pkgFile)) return undefined;\n  const pkg = JSON.parse(readFileSync(pkgFile, \"utf8\"));\n  return join(path, typeof pkg.main === \"string\" ? pkg.main : \"index.mjs\");\n}\n\nlet listModule;\ntry {\n  listModule = await import(pathToFileURL(job.listPath).href);\n} catch (error) {\n  fail(job.listPath + \" threw on import: \" + (error instanceof Error ? error.message : String(error)));\n}\nconst list = listModule.pieces ?? listModule.default;\nif (!Array.isArray(list)) {\n  fail(job.listPath + ' exports no \"pieces\" array');\n}\n\nconst out = { list, pieces: [], errors: [] };\nfor (const piece of list) {\n  const file = entryFile(piece);\n  // A missing file is the parent's to report, with the message it owns.\n  if (!file || !existsSync(file)) continue;\n  try {\n    const mod = await import(pathToFileURL(file).href);\n    const found = findPiece(mod);\n    if (!found) {\n      throw new Error(\n        \"no Piece export found in \" + file + \"; exports: \" + Object.keys(mod).join(\", \"),\n      );\n    }\n    const metadata = JSON.parse(JSON.stringify(describePiece(found), createJsonReplacer()));\n    out.pieces.push({ name: piece.name, version: piece.version, metadata });\n  } catch (error) {\n    out.errors.push({\n      name: piece.name,\n      message: error instanceof Error ? error.message : String(error),\n    });\n  }\n}\nwriteFileSync(job.outFile, JSON.stringify(out, createJsonReplacer()));\n";
+declare function describePieces(projectRoot: string, listPath: string): DescribeResult;
+type PieceLocation = {
+  /** The piece directory, absolute. */dir: string; /** The module file, absolute; unset for a bundle, whose package.json names it. */
+  entryFile?: string;
+  form: "entry" | "bundle";
+};
+declare function resolvePieceLocation(piece: PackagePiece, projectRoot: string, outDir: string): PieceLocation;
+declare function pieceListPath(target: {
+  projectRoot: string;
+  outDir: string;
+}): string;
+declare function assertPiecesOutDir(target: {
+  outDir: string;
+  pieces: PiecePlan[];
+}): void;
+declare function assertPieceVersion(piece: PackagePiece, pkg: PackageIdentity): void;
+declare function piecePackageJson(options: {
+  name: string;
+  version: string;
+  description?: string;
+  main: string;
+  license?: string;
+}): Record<string, unknown>;
+declare function pieceDescriptor(piece: PackagePiece, metadata: PieceMetadata): Record<string, unknown>;
+declare function enrichManifestPieces(manifest: Manifest, built: BuiltPiece[]): {
+  manifest: Manifest;
+  unbuilt: string[];
+};
+declare function buildPieces(target: PieceBuildTarget, pkg: PackageIdentity, options: PieceBuildOptions): Promise<BuiltPiece[]>;
+declare function syncDistManifest(target: PieceBuildTarget, built: BuiltPiece[]): string | undefined;
+//#endregion
+export { BuiltPiece, DESCRIBE_HELPERS, DESCRIBE_SCRIPT, DescribeResult, DescribedPiece, PackageIdentity, PackagePiece, PieceBuildOptions, PieceBuildTarget, PieceLocation, PieceMetadata, PiecePlan, assertPieceVersion, assertPiecesOutDir, buildPieces, createJsonReplacer, describePieces, enrichManifestPieces, expandEntryGlobs, pieceDescriptor, pieceListPath, piecePackageJson, planPieces, resolvePieceLocation, statSafe, syncDistManifest };
+//# sourceMappingURL=build-pieces.d.mts.map

package/dist/clis/build-pieces.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-pieces.d.mts","names":[],"sources":["../../clis/build-pieces.mts"],"mappings":";;;;;KA4BY,SAAA;wEAEV,GAAA,UAFU;EAIV,KAAA;EAEA,MAAA;AAAA;AAAA,KAKU,gBAAA;EACV,WAAA;EACA,MAAA;EACA,MAAA,EAAQ,SAAA;AAAA;AAAA,KAKE,YAAA;EACV,IAAA;EACA,OAAA;EACA,KAAA;EACA,MAAA;AAAA;AAAA,KAKU,aAAA,GAAgB,MAAA;EAC1B,WAAA;EACA,WAAA;EACA,OAAA,GAAU,MAAA;EACV,QAAA,GAAW,MAAA;AAAA;AAAA,KAGD,cAAA;EACV,IAAA;EACA,OAAA;EACA,QAAA,EAAU,aAAA;AAAA;AAAA,KAGA,cAAA;EACV,IAAA,EAAM,YAAA;EACN,MAAA,EAAQ,cAAA;EACR,MAAA;IAAU,IAAA;IAAc,OAAA;EAAA;AAAA;AAAA,KAGd,UAAA;EACV,IAAA;EACA,OAAA;EACA,WAAA;EACA,WAAA,WApBA;EAsBA,MAAA,UArBA;EAuBA,UAAA;AAAA;AAAA,KAGU,eAAA;EACV,IAAA;EACA,OAAA;EACA,OAAA;AAAA;AAAA,KAGU,iBAAA;EA3BV,8EA6BA,MAAA,GAAS,MAAA,EAAQ,YAAA,KAAiB,OAAA;AAAA;AAAA,iBAKpB,QAAA,CAAS,CAAA,WAAD,QAAA,CAAU,KAAA;AAAA,iBAUlB,gBAAA,CAAiB,IAAA,UAAc,KAAA;AAAA,iBA4B/B,UAAA,CAAW,WAAA,UAAqB,MAAA,WAAiB,SAAA;AAAA,iBAejD,kBAAA,CAAA,IAEU,IAAA,WAAe,IAAA,UAAc,KAAA;AAAA,cAiB1C,gBAAA;AAAA,cAiEA,eAAA;AAAA,iBAsFG,cAAA,CACd,WAAA,UACA,QAAA,WACC,cAAA;AAAA,KA0BS,aAAA;EAxRV,qCA0RA,GAAA,UAzRA;EA2RA,SAAA;EACA,IAAA;AAAA;AAAA,iBAKc,oBAAA,CACd,KAAA,EAAO,YAAA,EACP,WAAA,UACA,MAAA,WACC,aAAA;AAAA,iBAmCa,aAAA,CAAc,MAAA;EAC5B,WAAA;EACA,MAAA;AAAA;AAAA,iBAac,kBAAA,CAAmB,MAAA;EACjC,MAAA;EACA,MAAA,EAAQ,SAAA;AAAA;AAAA,iBAWM,kBAAA,CACd,KAAA,EAAO,YAAA,EACP,GAAA,EAAK,eAAA;AAAA,iBAWS,gBAAA,CAAiB,OAAA;EAC/B,IAAA;EACA,OAAA;EACA,WAAA;EACA,IAAA;EACA,OAAA;AAAA,IACE,MAAA;AAAA,iBAgBY,eAAA,CACd,KAAA,EAAO,YAAA,EACP,QAAA,EAAU,aAAA,GACT,MAAA;AAAA,iBAUa,oBAAA,CACd,QAAA,EAAU,QAAA,EACV,KAAA,EAAO,UAAA;EACJ,QAAA,EAAU,QAAA;EAAU,OAAA;AAAA;AAAA,iBAkCH,WAAA,CACpB,MAAA,EAAQ,gBAAA,EACR,GAAA,EAAK,eAAA,EACL,OAAA,EAAS,iBAAA,GACR,OAAA,CAAQ,UAAA;AAAA,iBA4GK,gBAAA,CACd,MAAA,EAAQ,gBAAA,EACR,KAAA,EAAO,UAAA"}

package/dist/clis/build-pieces.mjs

@@ -0,0 +1,363 @@
+import { o as buildPieceBuildConfig, t as PIECE_ENTRY_GLOB } from "./build-config-BkfXtfV8.mjs";
+import { tmpdir } from "node:os";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { copyFileSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+//#region clis/build-pieces.mts
+const toPosix = (p) => p.split(sep).join("/");
+function statSafe(p) {
+	try {
+		return statSync(p);
+	} catch {
+		return null;
+	}
+}
+function expandEntryGlobs(root, globs) {
+	const files = /* @__PURE__ */ new Set();
+	for (const pattern of globs) {
+		const segments = pattern.split("/").filter(Boolean);
+		let dirs = [root];
+		for (const seg of segments) {
+			const next = [];
+			for (const d of dirs) {
+				if (!statSafe(d)?.isDirectory()) continue;
+				if (seg === "*") for (const e of readdirSync(d, { withFileTypes: true })) next.push(join(d, e.name));
+				else next.push(join(d, seg));
+			}
+			dirs = next;
+		}
+		for (const f of dirs) if (statSafe(f)?.isFile()) files.add(f);
+	}
+	return [...files];
+}
+function planPieces(projectRoot, outDir) {
+	return expandEntryGlobs(projectRoot, [PIECE_ENTRY_GLOB]).map((file) => {
+		const dir = basename(dirname(file));
+		return {
+			dir,
+			entry: relative(projectRoot, file),
+			outDir: join(outDir, "node", "pieces", dir)
+		};
+	}).sort((a, b) => a.dir < b.dir ? -1 : a.dir > b.dir ? 1 : 0);
+}
+function createJsonReplacer() {
+	const ancestors = [];
+	return function replace(_key, value) {
+		if (typeof value === "function" || value === void 0) return void 0;
+		if (typeof value === "bigint") return value.toString();
+		if (typeof value !== "object" || value === null) return value;
+		while (ancestors.length > 0 && ancestors.at(-1) !== this) ancestors.pop();
+		if (ancestors.includes(value)) return void 0;
+		ancestors.push(value);
+		return value;
+	};
+}
+const DESCRIBE_HELPERS = `
+const isRecord = (value) => typeof value === "object" && value !== null;
+
+function findPiece(mod) {
+  const candidates = [
+    ...Object.values(mod),
+    ...(isRecord(mod.default) ? Object.values(mod.default) : []),
+    mod.default,
+  ];
+  for (const candidate of candidates) {
+    if (isRecord(candidate) && candidate.constructor?.name === "Piece") {
+      return candidate;
+    }
+  }
+  for (const candidate of candidates) {
+    if (
+      isRecord(candidate) &&
+      typeof candidate.displayName === "string" &&
+      (isRecord(candidate.actions) ||
+        typeof candidate.actions === "function" ||
+        typeof candidate.getAction === "function")
+    ) {
+      return candidate;
+    }
+  }
+  return undefined;
+}
+
+function describePiece(piece) {
+  if (typeof piece.metadata === "function") return piece.metadata();
+  const call = (value) => (typeof value === "function" ? value.call(piece) : value);
+  return {
+    displayName: piece.displayName,
+    logoUrl: piece.logoUrl,
+    description: piece.description,
+    authors: piece.authors,
+    categories: piece.categories,
+    auth: piece.auth,
+    minimumSupportedRelease: piece.minimumSupportedRelease,
+    maximumSupportedRelease: piece.maximumSupportedRelease,
+    deprecated: piece.deprecated,
+    actions: call(piece.actions) ?? {},
+    triggers: call(piece.triggers) ?? {},
+  };
+}
+
+function createJsonReplacer() {
+  const ancestors = [];
+  return function replace(_key, value) {
+    if (typeof value === "function" || value === undefined) return undefined;
+    if (typeof value === "bigint") return value.toString();
+    if (typeof value !== "object" || value === null) return value;
+    while (ancestors.length > 0 && ancestors.at(-1) !== this) ancestors.pop();
+    if (ancestors.includes(value)) return undefined;
+    ancestors.push(value);
+    return value;
+  };
+}
+`;
+const DESCRIBE_SCRIPT = `
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { isAbsolute, join } from "node:path";
+import { pathToFileURL } from "node:url";
+
+const job = JSON.parse(readFileSync(process.argv[2], "utf8"));
+${DESCRIBE_HELPERS}
+// Says why the child gave up in the one place the parent always reads, so a
+// failure reports the cause and never the text of this script.
+function fail(message) {
+  writeFileSync(job.outFile, JSON.stringify({ fatal: message }));
+  process.exit(1);
+}
+
+// The module to load for a list entry; a bundle names its own main.
+function entryFile(piece) {
+  const declared = piece.entry ?? piece.bundle;
+  if (typeof declared !== "string") return undefined;
+  const path = isAbsolute(declared) ? declared : join(job.projectRoot, declared);
+  if (piece.entry) return path;
+  const pkgFile = join(path, "package.json");
+  if (!existsSync(pkgFile)) return undefined;
+  const pkg = JSON.parse(readFileSync(pkgFile, "utf8"));
+  return join(path, typeof pkg.main === "string" ? pkg.main : "index.mjs");
+}
+
+let listModule;
+try {
+  listModule = await import(pathToFileURL(job.listPath).href);
+} catch (error) {
+  fail(job.listPath + " threw on import: " + (error instanceof Error ? error.message : String(error)));
+}
+const list = listModule.pieces ?? listModule.default;
+if (!Array.isArray(list)) {
+  fail(job.listPath + ' exports no "pieces" array');
+}
+
+const out = { list, pieces: [], errors: [] };
+for (const piece of list) {
+  const file = entryFile(piece);
+  // A missing file is the parent's to report, with the message it owns.
+  if (!file || !existsSync(file)) continue;
+  try {
+    const mod = await import(pathToFileURL(file).href);
+    const found = findPiece(mod);
+    if (!found) {
+      throw new Error(
+        "no Piece export found in " + file + "; exports: " + Object.keys(mod).join(", "),
+      );
+    }
+    const metadata = JSON.parse(JSON.stringify(describePiece(found), createJsonReplacer()));
+    out.pieces.push({ name: piece.name, version: piece.version, metadata });
+  } catch (error) {
+    out.errors.push({
+      name: piece.name,
+      message: error instanceof Error ? error.message : String(error),
+    });
+  }
+}
+writeFileSync(job.outFile, JSON.stringify(out, createJsonReplacer()));
+`;
+function childFailure(error, outFile) {
+	try {
+		const answer = JSON.parse(readFileSync(outFile, "utf8"));
+		if (typeof answer.fatal === "string") return answer.fatal;
+	} catch {}
+	const { status, signal } = error;
+	if (signal) return `the describe child was killed by ${signal}`;
+	return `the describe child exited with code ${status ?? "unknown"}`;
+}
+function describePieces(projectRoot, listPath) {
+	const dir = mkdtempSync(join(tmpdir(), "ph-build-pieces-"));
+	const rel = toPosix(relative(projectRoot, listPath));
+	try {
+		const jobFile = join(dir, "job.json");
+		const scriptFile = join(dir, "describe.mjs");
+		const outFile = join(dir, "describe.json");
+		writeFileSync(scriptFile, DESCRIBE_SCRIPT);
+		writeFileSync(jobFile, JSON.stringify({
+			projectRoot,
+			listPath,
+			outFile
+		}));
+		try {
+			execFileSync(process.execPath, [scriptFile, jobFile], {
+				timeout: 6e4,
+				stdio: "inherit"
+			});
+		} catch (error) {
+			throw new Error(`pieces: could not load ${rel}: ${childFailure(error, outFile)}`, { cause: error });
+		}
+		return JSON.parse(readFileSync(outFile, "utf8"));
+	} finally {
+		rmSync(dir, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+function resolvePieceLocation(piece, projectRoot, outDir) {
+	const declared = piece.entry ?? piece.bundle;
+	if (typeof declared !== "string" || declared === "") throw new Error(`pieces: "${piece.name}" declares neither an entry nor a bundle`);
+	const path = isAbsolute(declared) ? declared : join(projectRoot, declared);
+	const form = piece.entry ? "entry" : "bundle";
+	if (!(form === "entry" ? statSafe(path)?.isFile() : statSafe(join(path, "package.json"))?.isFile())) throw new Error(`pieces: "${piece.name}" declares ${declared}, which is missing`);
+	const dir = form === "entry" ? dirname(path) : path;
+	const inside = relative(resolve(projectRoot, outDir, "node", "pieces"), dir);
+	if (inside === "" || inside.startsWith("..") || isAbsolute(inside)) {
+		const expected = toPosix(join(outDir, "node", "pieces"));
+		throw new Error(`pieces: "${piece.name}" declares ${declared}, which is outside ${expected}/; a piece is built to ${expected}/<dir>/index.mjs and its entry must point there`);
+	}
+	return form === "entry" ? {
+		dir,
+		entryFile: path,
+		form
+	} : {
+		dir,
+		form
+	};
+}
+function pieceListPath(target) {
+	return resolve(target.projectRoot, target.outDir, "node", "pieces", "index.mjs");
+}
+function assertPiecesOutDir(target) {
+	if (target.pieces.length === 0 || target.outDir === "dist") return;
+	throw new Error(`pieces: --out-dir ${target.outDir} cannot hold pieces; a piece is loaded from dist/node/pieces/<name> by the host, so a package that ships pieces builds to dist`);
+}
+function assertPieceVersion(piece, pkg) {
+	if (piece.name === pkg.name && piece.version !== pkg.version) throw new Error(`pieces: "${piece.name}" declares version ${piece.version}, package.json says ${pkg.version}`);
+}
+function piecePackageJson(options) {
+	return {
+		name: options.name,
+		version: options.version,
+		description: options.description ?? "",
+		type: "module",
+		main: options.main,
+		...options.license ? { license: options.license } : {},
+		dependencies: {}
+	};
+}
+function pieceDescriptor(piece, metadata) {
+	const { name: _name, version: _version, ...rest } = metadata;
+	return {
+		name: piece.name,
+		version: piece.version,
+		...rest
+	};
+}
+function enrichManifestPieces(manifest, built) {
+	const byId = new Map(built.map((piece) => [piece.name, piece]));
+	const toModule = (piece) => ({
+		id: piece.name,
+		name: piece.displayName ?? piece.name,
+		version: piece.version,
+		...piece.description ? { description: piece.description } : {},
+		bundle: piece.bundle,
+		descriptor: piece.descriptor
+	});
+	const unbuilt = [];
+	const seen = /* @__PURE__ */ new Set();
+	const pieces = (manifest.pieces ?? []).map((entry) => {
+		const hit = byId.get(entry.id);
+		if (!hit) {
+			unbuilt.push(entry.id);
+			return entry;
+		}
+		seen.add(entry.id);
+		return toModule(hit);
+	});
+	for (const piece of built) if (!seen.has(piece.name)) pieces.push(toModule(piece));
+	return {
+		manifest: {
+			...manifest,
+			pieces
+		},
+		unbuilt
+	};
+}
+const count = (record) => typeof record === "object" && record !== null ? Object.keys(record).length : 0;
+async function buildPieces(target, pkg, options) {
+	const { projectRoot, outDir } = target;
+	assertPiecesOutDir(target);
+	for (const piece of target.pieces) {
+		console.log(`\n▶ Building piece ${piece.dir}...`);
+		await options.bundle(buildPieceBuildConfig({
+			entry: resolve(projectRoot, piece.entry),
+			outDir: resolve(projectRoot, piece.outDir)
+		}));
+	}
+	const listPath = pieceListPath(target);
+	if (!existsSync(listPath)) throw new Error(`pieces: ${toPosix(relative(projectRoot, listPath))} was not built; pieces/index.ts must export the list of pieces this package ships`);
+	const described = describePieces(projectRoot, listPath);
+	const built = [];
+	const listedDirs = /* @__PURE__ */ new Set();
+	for (const piece of described.list) {
+		const location = resolvePieceLocation(piece, projectRoot, outDir);
+		assertPieceVersion(piece, pkg);
+		const failure = described.errors.find((e) => e.name === piece.name);
+		if (failure) throw new Error(`pieces: "${piece.name}" could not be described: ${failure.message}`);
+		const found = described.pieces.find((p) => p.name === piece.name);
+		if (!found) throw new Error(`pieces: "${piece.name}" was not described`);
+		const metadata = found.metadata;
+		const relDir = toPosix(relative(projectRoot, location.dir));
+		listedDirs.add(relDir);
+		writeFileSync(join(location.dir, "descriptor.json"), JSON.stringify(pieceDescriptor(piece, metadata), createJsonReplacer(), 2) + "\n");
+		if (location.form === "entry" && location.entryFile) writeFileSync(join(location.dir, "package.json"), JSON.stringify(piecePackageJson({
+			name: piece.name,
+			version: piece.version,
+			description: metadata.description,
+			main: relative(location.dir, location.entryFile),
+			license: pkg.license
+		}), null, 2) + "\n");
+		console.log(`piece: ${piece.name}@${piece.version} -> ${relDir} (${count(metadata.actions)} actions, ${count(metadata.triggers)} triggers)`);
+		built.push({
+			name: piece.name,
+			version: piece.version,
+			displayName: metadata.displayName,
+			description: metadata.description,
+			bundle: relDir,
+			descriptor: `${relDir}/descriptor.json`
+		});
+	}
+	warnUnlistedPieces(target.pieces, listedDirs);
+	return built;
+}
+function warnUnlistedPieces(planned, listedDirs) {
+	for (const piece of planned) if (!listedDirs.has(toPosix(piece.outDir))) console.warn(`⚠ pieces: pieces/${piece.dir} was built but pieces/index.ts does not list it; a host will not find it`);
+}
+function syncDistManifest(target, built) {
+	const { projectRoot, outDir } = target;
+	const source = join(projectRoot, "powerhouse.manifest.json");
+	const copy = resolve(projectRoot, outDir, "powerhouse.manifest.json");
+	const shipsPieces = existsSync(pieceListPath(target));
+	if (!existsSync(source)) {
+		if (shipsPieces) console.warn("⚠ no powerhouse.manifest.json; pieces will not be listed");
+		return;
+	}
+	mkdirSync(dirname(copy), { recursive: true });
+	copyFileSync(source, copy);
+	if (!shipsPieces) return copy;
+	const enriched = enrichManifestPieces(JSON.parse(readFileSync(copy, "utf8")), built);
+	for (const id of enriched.unbuilt) console.warn(`⚠ manifest lists piece "${id}" but nothing built it`);
+	writeFileSync(copy, JSON.stringify(enriched.manifest, null, 2) + "\n");
+	return copy;
+}
+//#endregion
+export { DESCRIBE_HELPERS, DESCRIBE_SCRIPT, assertPieceVersion, assertPiecesOutDir, buildPieces, createJsonReplacer, describePieces, enrichManifestPieces, expandEntryGlobs, pieceDescriptor, pieceListPath, piecePackageJson, planPieces, resolvePieceLocation, statSafe, syncDistManifest };
+
+//# sourceMappingURL=build-pieces.mjs.map

package/dist/clis/build-pieces.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-pieces.mjs","names":[],"sources":["../../clis/build-pieces.mts"],"sourcesContent":["// The pieces half of a package build: find and bundle each piece whole, load\n// it once in a child process to learn what it is, and write what a host reads.\nimport { execFileSync } from \"node:child_process\";\nimport {\n  copyFileSync,\n  existsSync,\n  mkdirSync,\n  mkdtempSync,\n  readdirSync,\n  readFileSync,\n  rmSync,\n  statSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport {\n  basename,\n  dirname,\n  isAbsolute,\n  join,\n  relative,\n  resolve,\n  sep,\n} from \"node:path\";\nimport type { InlineConfig } from \"tsdown\";\nimport type { Manifest, PieceModule } from \"../document-model/types.js\";\nimport { buildPieceBuildConfig, PIECE_ENTRY_GLOB } from \"./build-config.mjs\";\n\nexport type PiecePlan = {\n  /** The directory under pieces/, and so under <outDir>/node/pieces. */\n  dir: string;\n  /** Source entry, relative to the project root: pieces/<dir>/index.ts. */\n  entry: string;\n  /** Where the piece lands, relative to the project root. */\n  outDir: string;\n};\n\n// What buildPieces needs to know about the package it works in: where it is,\n// where it builds to, and which pieces the plan found.\nexport type PieceBuildTarget = {\n  projectRoot: string;\n  outDir: string;\n  pieces: PiecePlan[];\n};\n\n// One entry of pieces/index.ts, as @powerhousedao/pieces-framework declares it.\n// Declared here so the build needs no dependency on a package meant for pieces.\nexport type PackagePiece = {\n  name: string;\n  version: string;\n  entry?: string;\n  bundle?: string;\n};\n\n// What a piece says about itself, in the framework's PieceMetadata shape.\n// Read from the built piece, so nothing in the build has to know the framework.\nexport type PieceMetadata = Record<string, unknown> & {\n  displayName?: string;\n  description?: string;\n  actions?: Record<string, unknown>;\n  triggers?: Record<string, unknown>;\n};\n\nexport type DescribedPiece = {\n  name: string;\n  version: string;\n  metadata: PieceMetadata;\n};\n\nexport type DescribeResult = {\n  list: PackagePiece[];\n  pieces: DescribedPiece[];\n  errors: { name: string; message: string }[];\n};\n\nexport type BuiltPiece = {\n  name: string;\n  version: string;\n  displayName?: string;\n  description?: string;\n  /** Piece directory, relative to the project root, `/` separated. */\n  bundle: string;\n  /** The descriptor inside it, relative to the project root, `/` separated. */\n  descriptor: string;\n};\n\nexport type PackageIdentity = {\n  name: string;\n  version: string;\n  license?: string;\n};\n\nexport type PieceBuildOptions = {\n  /** The bundler: tsdown's `build`, handed in so this module never loads it. */\n  bundle: (config: InlineConfig) => Promise<unknown>;\n};\n\nconst toPosix = (p: string) => p.split(sep).join(\"/\");\n\nexport function statSafe(p: string) {\n  try {\n    return statSync(p);\n  } catch {\n    return null;\n  }\n}\n\n// Expand entry globs (single-`*` segments only — the shape `browserEntry`\n// uses) against files on disk, resolving against `root`.\nexport function expandEntryGlobs(root: string, globs: string[]): string[] {\n  const files = new Set<string>();\n  for (const pattern of globs) {\n    const segments = pattern.split(\"/\").filter(Boolean);\n    let dirs = [root];\n    for (const seg of segments) {\n      const next: string[] = [];\n      for (const d of dirs) {\n        if (!statSafe(d)?.isDirectory()) continue;\n        if (seg === \"*\") {\n          for (const e of readdirSync(d, { withFileTypes: true })) {\n            next.push(join(d, e.name));\n          }\n        } else {\n          next.push(join(d, seg));\n        }\n      }\n      dirs = next;\n    }\n    for (const f of dirs) {\n      if (statSafe(f)?.isFile()) files.add(f);\n    }\n  }\n  return [...files];\n}\n\n// The pieces a project holds, one per pieces/<dir>/index.ts, sorted by dir so\n// a build log and a manifest read the same from one run to the next.\nexport function planPieces(projectRoot: string, outDir: string): PiecePlan[] {\n  return expandEntryGlobs(projectRoot, [PIECE_ENTRY_GLOB])\n    .map((file) => {\n      const dir = basename(dirname(file));\n      return {\n        dir,\n        entry: relative(projectRoot, file),\n        outDir: join(outDir, \"node\", \"pieces\", dir),\n      };\n    })\n    .sort((a, b) => (a.dir < b.dir ? -1 : a.dir > b.dir ? 1 : 0));\n}\n\n// A JSON.stringify replacer that makes a piece's metadata serializable: props\n// carry resolvers, defaults may be class instances, and a schema may cycle.\nexport function createJsonReplacer() {\n  const ancestors: object[] = [];\n  return function replace(this: unknown, _key: string, value: unknown) {\n    if (typeof value === \"function\" || value === undefined) return undefined;\n    if (typeof value === \"bigint\") return value.toString();\n    if (typeof value !== \"object\" || value === null) return value;\n    // `this` is the holder, so popping back to it leaves the current path.\n    while (ancestors.length > 0 && ancestors.at(-1) !== this) ancestors.pop();\n    if (ancestors.includes(value)) return undefined;\n    ancestors.push(value);\n    return value;\n  };\n}\n\n// The half of the child script that needs nothing from the job: a test\n// evaluates this text on its own, so neither copy can drift from the other.\n\n// `constructor?.name`: a module may export an Object.create(null), and the\n// real piece is usually beside it in the same module.\nexport const DESCRIBE_HELPERS = `\nconst isRecord = (value) => typeof value === \"object\" && value !== null;\n\nfunction findPiece(mod) {\n  const candidates = [\n    ...Object.values(mod),\n    ...(isRecord(mod.default) ? Object.values(mod.default) : []),\n    mod.default,\n  ];\n  for (const candidate of candidates) {\n    if (isRecord(candidate) && candidate.constructor?.name === \"Piece\") {\n      return candidate;\n    }\n  }\n  for (const candidate of candidates) {\n    if (\n      isRecord(candidate) &&\n      typeof candidate.displayName === \"string\" &&\n      (isRecord(candidate.actions) ||\n        typeof candidate.actions === \"function\" ||\n        typeof candidate.getAction === \"function\")\n    ) {\n      return candidate;\n    }\n  }\n  return undefined;\n}\n\nfunction describePiece(piece) {\n  if (typeof piece.metadata === \"function\") return piece.metadata();\n  const call = (value) => (typeof value === \"function\" ? value.call(piece) : value);\n  return {\n    displayName: piece.displayName,\n    logoUrl: piece.logoUrl,\n    description: piece.description,\n    authors: piece.authors,\n    categories: piece.categories,\n    auth: piece.auth,\n    minimumSupportedRelease: piece.minimumSupportedRelease,\n    maximumSupportedRelease: piece.maximumSupportedRelease,\n    deprecated: piece.deprecated,\n    actions: call(piece.actions) ?? {},\n    triggers: call(piece.triggers) ?? {},\n  };\n}\n\nfunction createJsonReplacer() {\n  const ancestors = [];\n  return function replace(_key, value) {\n    if (typeof value === \"function\" || value === undefined) return undefined;\n    if (typeof value === \"bigint\") return value.toString();\n    if (typeof value !== \"object\" || value === null) return value;\n    while (ancestors.length > 0 && ancestors.at(-1) !== this) ancestors.pop();\n    if (ancestors.includes(value)) return undefined;\n    ancestors.push(value);\n    return value;\n  };\n}\n`;\n\n// Runs in a child node process: loading a piece runs piece-authored top-level\n// code, and the runtime describes pieces in a worker for the same reason.\n\n// A string so it works from `src` under bun or tsx as well as from `dist`. It\n// answers through a file, leaving both its streams to the piece.\nexport const DESCRIBE_SCRIPT = `\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { isAbsolute, join } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\nconst job = JSON.parse(readFileSync(process.argv[2], \"utf8\"));\n${DESCRIBE_HELPERS}\n// Says why the child gave up in the one place the parent always reads, so a\n// failure reports the cause and never the text of this script.\nfunction fail(message) {\n  writeFileSync(job.outFile, JSON.stringify({ fatal: message }));\n  process.exit(1);\n}\n\n// The module to load for a list entry; a bundle names its own main.\nfunction entryFile(piece) {\n  const declared = piece.entry ?? piece.bundle;\n  if (typeof declared !== \"string\") return undefined;\n  const path = isAbsolute(declared) ? declared : join(job.projectRoot, declared);\n  if (piece.entry) return path;\n  const pkgFile = join(path, \"package.json\");\n  if (!existsSync(pkgFile)) return undefined;\n  const pkg = JSON.parse(readFileSync(pkgFile, \"utf8\"));\n  return join(path, typeof pkg.main === \"string\" ? pkg.main : \"index.mjs\");\n}\n\nlet listModule;\ntry {\n  listModule = await import(pathToFileURL(job.listPath).href);\n} catch (error) {\n  fail(job.listPath + \" threw on import: \" + (error instanceof Error ? error.message : String(error)));\n}\nconst list = listModule.pieces ?? listModule.default;\nif (!Array.isArray(list)) {\n  fail(job.listPath + ' exports no \"pieces\" array');\n}\n\nconst out = { list, pieces: [], errors: [] };\nfor (const piece of list) {\n  const file = entryFile(piece);\n  // A missing file is the parent's to report, with the message it owns.\n  if (!file || !existsSync(file)) continue;\n  try {\n    const mod = await import(pathToFileURL(file).href);\n    const found = findPiece(mod);\n    if (!found) {\n      throw new Error(\n        \"no Piece export found in \" + file + \"; exports: \" + Object.keys(mod).join(\", \"),\n      );\n    }\n    const metadata = JSON.parse(JSON.stringify(describePiece(found), createJsonReplacer()));\n    out.pieces.push({ name: piece.name, version: piece.version, metadata });\n  } catch (error) {\n    out.errors.push({\n      name: piece.name,\n      message: error instanceof Error ? error.message : String(error),\n    });\n  }\n}\nwriteFileSync(job.outFile, JSON.stringify(out, createJsonReplacer()));\n`;\n\n// What the child said went wrong, if it got that far, and otherwise how it\n// died: an exit status, never the whole script an `Error.message` carries.\nfunction childFailure(error: unknown, outFile: string): string {\n  try {\n    const answer = JSON.parse(readFileSync(outFile, \"utf8\")) as {\n      fatal?: unknown;\n    };\n    if (typeof answer.fatal === \"string\") return answer.fatal;\n  } catch {\n    // no answer on disk: fall through to the exit status\n  }\n  const { status, signal } = error as {\n    status?: number | null;\n    signal?: string | null;\n  };\n  if (signal) return `the describe child was killed by ${signal}`;\n  return `the describe child exited with code ${status ?? \"unknown\"}`;\n}\n\n// Load the built list and every piece it names in a child process and return\n// what they say about themselves. Throws when the list itself cannot be read.\n\n// Both of the child's streams are the parent's, so a piece that prints at\n// import time is heard rather than mixed into the answer.\nexport function describePieces(\n  projectRoot: string,\n  listPath: string,\n): DescribeResult {\n  const dir = mkdtempSync(join(tmpdir(), \"ph-build-pieces-\"));\n  const rel = toPosix(relative(projectRoot, listPath));\n  try {\n    const jobFile = join(dir, \"job.json\");\n    const scriptFile = join(dir, \"describe.mjs\");\n    const outFile = join(dir, \"describe.json\");\n    writeFileSync(scriptFile, DESCRIBE_SCRIPT);\n    writeFileSync(jobFile, JSON.stringify({ projectRoot, listPath, outFile }));\n    try {\n      execFileSync(process.execPath, [scriptFile, jobFile], {\n        timeout: 60_000,\n        stdio: \"inherit\",\n      });\n    } catch (error) {\n      throw new Error(\n        `pieces: could not load ${rel}: ${childFailure(error, outFile)}`,\n        { cause: error },\n      );\n    }\n    return JSON.parse(readFileSync(outFile, \"utf8\")) as DescribeResult;\n  } finally {\n    rmSync(dir, { recursive: true, force: true });\n  }\n}\n\nexport type PieceLocation = {\n  /** The piece directory, absolute. */\n  dir: string;\n  /** The module file, absolute; unset for a bundle, whose package.json names it. */\n  entryFile?: string;\n  form: \"entry\" | \"bundle\";\n};\n\n// Where a list entry says its built piece is, checked against the disk: a\n// listed piece nobody built would otherwise fail much later, in a host.\nexport function resolvePieceLocation(\n  piece: PackagePiece,\n  projectRoot: string,\n  outDir: string,\n): PieceLocation {\n  const declared = piece.entry ?? piece.bundle;\n  if (typeof declared !== \"string\" || declared === \"\") {\n    throw new Error(\n      `pieces: \"${piece.name}\" declares neither an entry nor a bundle`,\n    );\n  }\n  const path = isAbsolute(declared) ? declared : join(projectRoot, declared);\n  const form = piece.entry ? \"entry\" : \"bundle\";\n  const present =\n    form === \"entry\"\n      ? statSafe(path)?.isFile()\n      : statSafe(join(path, \"package.json\"))?.isFile();\n  if (!present) {\n    throw new Error(\n      `pieces: \"${piece.name}\" declares ${declared}, which is missing`,\n    );\n  }\n  const dir = form === \"entry\" ? dirname(path) : path;\n  // Both forms, not just `entry`: a descriptor.json is written into this\n  // directory, and outside outDir that lands in tracked source.\n  const piecesRoot = resolve(projectRoot, outDir, \"node\", \"pieces\");\n  const inside = relative(piecesRoot, dir);\n  if (inside === \"\" || inside.startsWith(\"..\") || isAbsolute(inside)) {\n    const expected = toPosix(join(outDir, \"node\", \"pieces\"));\n    throw new Error(\n      `pieces: \"${piece.name}\" declares ${declared}, which is outside ${expected}/; ` +\n        `a piece is built to ${expected}/<dir>/index.mjs and its entry must point there`,\n    );\n  }\n  return form === \"entry\" ? { dir, entryFile: path, form } : { dir, form };\n}\n\n// Where the node build leaves the list of pieces a package ships. Its presence\n// on disk, not a pieces/<dir> in the source, is what says a package has them.\nexport function pieceListPath(target: {\n  projectRoot: string;\n  outDir: string;\n}): string {\n  return resolve(\n    target.projectRoot,\n    target.outDir,\n    \"node\",\n    \"pieces\",\n    \"index.mjs\",\n  );\n}\n\n// `dist` is not a default here but a contract: a host reads a piece from\n// dist/node/pieces/<name>, and a list entry names that path literally.\nexport function assertPiecesOutDir(target: {\n  outDir: string;\n  pieces: PiecePlan[];\n}): void {\n  if (target.pieces.length === 0 || target.outDir === \"dist\") return;\n  throw new Error(\n    `pieces: --out-dir ${target.outDir} cannot hold pieces; a piece is loaded from ` +\n      `dist/node/pieces/<name> by the host, so a package that ships pieces builds to dist`,\n  );\n}\n\n// A piece named after its package must carry the package's version: once\n// published, a drifted version resolves to the wrong tarball.\nexport function assertPieceVersion(\n  piece: PackagePiece,\n  pkg: PackageIdentity,\n): void {\n  if (piece.name === pkg.name && piece.version !== pkg.version) {\n    throw new Error(\n      `pieces: \"${piece.name}\" declares version ${piece.version}, package.json says ${pkg.version}`,\n    );\n  }\n}\n\n// The package.json written beside a piece built from an `entry`, giving the\n// directory npm-bundle shape so a registry can serve it on its own.\nexport function piecePackageJson(options: {\n  name: string;\n  version: string;\n  description?: string;\n  main: string;\n  license?: string;\n}): Record<string, unknown> {\n  return {\n    name: options.name,\n    version: options.version,\n    description: options.description ?? \"\",\n    type: \"module\",\n    main: options.main,\n    ...(options.license ? { license: options.license } : {}),\n    // Empty on purpose: the runtime treats a bundle that declares dependencies\n    // as not self-contained, and everything a piece needs is inlined already.\n    dependencies: {},\n  };\n}\n\n// The descriptor written beside a piece: the list's name and version, then\n// whatever the piece said about itself, in the framework's PieceMetadata shape.\nexport function pieceDescriptor(\n  piece: PackagePiece,\n  metadata: PieceMetadata,\n): Record<string, unknown> {\n  const { name: _name, version: _version, ...rest } = metadata;\n  return { name: piece.name, version: piece.version, ...rest };\n}\n\n// The manifest's `pieces` with what the build learned: a built piece replaces\n// the source entry with its id in place, or is appended at the end.\n\n// A source entry nothing built is kept as it is and returned as `unbuilt`,\n// for the caller to warn about.\nexport function enrichManifestPieces(\n  manifest: Manifest,\n  built: BuiltPiece[],\n): { manifest: Manifest; unbuilt: string[] } {\n  const byId = new Map(built.map((piece) => [piece.name, piece]));\n  const toModule = (piece: BuiltPiece): PieceModule => ({\n    id: piece.name,\n    name: piece.displayName ?? piece.name,\n    version: piece.version,\n    ...(piece.description ? { description: piece.description } : {}),\n    bundle: piece.bundle,\n    descriptor: piece.descriptor,\n  });\n  const unbuilt: string[] = [];\n  const seen = new Set<string>();\n  const pieces: PieceModule[] = (manifest.pieces ?? []).map((entry) => {\n    const hit = byId.get(entry.id);\n    if (!hit) {\n      unbuilt.push(entry.id);\n      return entry;\n    }\n    seen.add(entry.id);\n    return toModule(hit);\n  });\n  for (const piece of built) {\n    if (!seen.has(piece.name)) pieces.push(toModule(piece));\n  }\n  return { manifest: { ...manifest, pieces }, unbuilt };\n}\n\nconst count = (record: unknown) =>\n  typeof record === \"object\" && record !== null\n    ? Object.keys(record).length\n    : 0;\n\n// Build every planned piece, then read the built list and describe what it\n// names. Returns what was built, for the manifest.\nexport async function buildPieces(\n  target: PieceBuildTarget,\n  pkg: PackageIdentity,\n  options: PieceBuildOptions,\n): Promise<BuiltPiece[]> {\n  const { projectRoot, outDir } = target;\n  assertPiecesOutDir(target);\n  // resolve, not join: an absolute --out-dir is what the browser and node\n  // steps hand tsdown, and joining it onto the project root mangles it.\n  for (const piece of target.pieces) {\n    console.log(`\\n▶ Building piece ${piece.dir}...`);\n    await options.bundle(\n      buildPieceBuildConfig({\n        entry: resolve(projectRoot, piece.entry),\n        outDir: resolve(projectRoot, piece.outDir),\n      }),\n    );\n  }\n\n  // The list is the source of truth for names and versions; a package that\n  // built pieces without a list has nothing a host could read.\n  const listPath = pieceListPath(target);\n  if (!existsSync(listPath)) {\n    throw new Error(\n      `pieces: ${toPosix(relative(projectRoot, listPath))} was not built; ` +\n        `pieces/index.ts must export the list of pieces this package ships`,\n    );\n  }\n  const described = describePieces(projectRoot, listPath);\n\n  const built: BuiltPiece[] = [];\n  const listedDirs = new Set<string>();\n  for (const piece of described.list) {\n    const location = resolvePieceLocation(piece, projectRoot, outDir);\n    assertPieceVersion(piece, pkg);\n    const failure = described.errors.find((e) => e.name === piece.name);\n    if (failure) {\n      throw new Error(\n        `pieces: \"${piece.name}\" could not be described: ${failure.message}`,\n      );\n    }\n    const found = described.pieces.find((p) => p.name === piece.name);\n    if (!found) {\n      throw new Error(`pieces: \"${piece.name}\" was not described`);\n    }\n    const metadata = found.metadata;\n    const relDir = toPosix(relative(projectRoot, location.dir));\n    listedDirs.add(relDir);\n\n    writeFileSync(\n      join(location.dir, \"descriptor.json\"),\n      JSON.stringify(\n        pieceDescriptor(piece, metadata),\n        createJsonReplacer(),\n        2,\n      ) + \"\\n\",\n    );\n    if (location.form === \"entry\" && location.entryFile) {\n      writeFileSync(\n        join(location.dir, \"package.json\"),\n        JSON.stringify(\n          piecePackageJson({\n            name: piece.name,\n            version: piece.version,\n            description: metadata.description,\n            main: relative(location.dir, location.entryFile),\n            license: pkg.license,\n          }),\n          null,\n          2,\n        ) + \"\\n\",\n      );\n    }\n    console.log(\n      `piece: ${piece.name}@${piece.version} -> ${relDir} ` +\n        `(${count(metadata.actions)} actions, ${count(metadata.triggers)} triggers)`,\n    );\n    built.push({\n      name: piece.name,\n      version: piece.version,\n      displayName: metadata.displayName,\n      description: metadata.description,\n      bundle: relDir,\n      descriptor: `${relDir}/descriptor.json`,\n    });\n  }\n\n  warnUnlistedPieces(target.pieces, listedDirs);\n  return built;\n}\n\n// A built piece no list entry points into ships without a host ever finding it.\nfunction warnUnlistedPieces(\n  planned: PiecePlan[],\n  listedDirs: Set<string>,\n): void {\n  for (const piece of planned) {\n    if (!listedDirs.has(toPosix(piece.outDir))) {\n      console.warn(\n        `⚠ pieces: pieces/${piece.dir} was built but pieces/index.ts does not list it; a host will not find it`,\n      );\n    }\n  }\n}\n\n// Make sure the manifest ships under outDir (tsdown copies it only in the\n// browser build) and, when pieces were built, list them in that copy.\n\n// Always copied afresh: only <outDir>/node is cleaned by the builds, so a copy\n// left by the last build would otherwise outlive an edit to the source.\n\n// The source file is never written. Returns the path of the copy, if any.\nexport function syncDistManifest(\n  target: PieceBuildTarget,\n  built: BuiltPiece[],\n): string | undefined {\n  const { projectRoot, outDir } = target;\n  const source = join(projectRoot, \"powerhouse.manifest.json\");\n  // resolve, not join: an absolute --out-dir is a location, not a suffix.\n  const copy = resolve(projectRoot, outDir, \"powerhouse.manifest.json\");\n  // The built list, not the source plan: a package whose pieces are all\n  // `bundle:` entries has no pieces/<dir> and still ships pieces.\n  const shipsPieces = existsSync(pieceListPath(target));\n  if (!existsSync(source)) {\n    if (shipsPieces) {\n      console.warn(\"⚠ no powerhouse.manifest.json; pieces will not be listed\");\n    }\n    return undefined;\n  }\n  mkdirSync(dirname(copy), { recursive: true });\n  copyFileSync(source, copy);\n  if (!shipsPieces) return copy;\n\n  const manifest = JSON.parse(readFileSync(copy, \"utf8\")) as Manifest;\n  const enriched = enrichManifestPieces(manifest, built);\n  for (const id of enriched.unbuilt) {\n    console.warn(`⚠ manifest lists piece \"${id}\" but nothing built it`);\n  }\n  writeFileSync(copy, JSON.stringify(enriched.manifest, null, 2) + \"\\n\");\n  return copy;\n}\n"],"mappings":"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"}