@powerhousedao/shared 6.2.3-dev.23 → 6.2.3-dev.25

package/dist/clis/args/vetra.d.mts

@@ -1,2 +1,3 @@
-import { n as resolveSwitchboardPortDefault, r as vetraArgs, t as resolveConnectPortDefault } from "./vetra-CoMvTJK7.mjs";
-export { resolveConnectPortDefault, resolveSwitchboardPortDefault, vetraArgs };
+import { n as resolveSwitchboardPortDefault, r as vetraArgs, t as resolveConnectPortDefault } from "./vetra-DkDaWFPi.mjs";
+export { resolveConnectPortDefault, resolveSwitchboardPortDefault, vetraArgs };
+export {};

package/dist/clis/args/vetra.mjs

@@ -1,2 +1,2 @@
-import { n as resolveSwitchboardPortDefault, r as vetraArgs, t as resolveConnectPortDefault } from "./vetra-DV0zQzba.mjs";
+import { n as resolveSwitchboardPortDefault, r as vetraArgs, t as resolveConnectPortDefault } from "./vetra-BUNlAAPp.mjs";
 export { resolveConnectPortDefault, resolveSwitchboardPortDefault, vetraArgs };

package/dist/clis/{build-config-BkfXtfV8.mjs → build-config-CmdMi_wu.mjs}

@@ -58,7 +58,7 @@ const SHARED_SUBPATHS = [
 * that nothing in the import map resolves, so the package would fail to load
 * at runtime instead of simply bundling its own copy.
 */
-const EXTERNALIZABLE_SHARED_SPECIFIERS = [...new Set([...SHARED_DEP_SPECIFIERS.filter((s) => s !== "@powerhousedao/shared"), ...SHARED_SUBPATHS.map((s) => `@powerhousedao/shared/${s}`)])];
+const EXTERNALIZABLE_SHARED_SPECIFIERS = [.../* @__PURE__ */ new Set([...SHARED_DEP_SPECIFIERS.filter((s) => s !== "@powerhousedao/shared"), ...SHARED_SUBPATHS.map((s) => `@powerhousedao/shared/${s}`)])];
 function isSharedSpecifier(spec, specs) {
 	return specs.some((s) => spec === s || spec.startsWith(s + "/"));
 }
@@ -215,7 +215,7 @@ function buildPieceBuildConfig(options) {
 		deps: {
 			alwaysBundle,
 			neverBundle: [],
-			onlyAllowBundle: false
+			onlyBundle: false
 		},
 		outputOptions: { codeSplitting: false },
 		config,
@@ -227,4 +227,4 @@ function buildPieceBuildConfig(options) {
 //#endregion
 export { buildNodeBuildConfig as a, nodeBuildConfig as c, buildBrowserBuildConfig as i, browserBuildConfig as n, buildPieceBuildConfig as o, browserEntry as r, findBundledSharedDeps as s, PIECE_ENTRY_GLOB as t };
 
-//# sourceMappingURL=build-config-BkfXtfV8.mjs.map
+//# sourceMappingURL=build-config-CmdMi_wu.mjs.map

package/dist/clis/{build-config-BkfXtfV8.mjs.map → build-config-CmdMi_wu.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"build-config-BkfXtfV8.mjs","names":[],"sources":["../../connect/shared-deps.ts","../../clis/build-config.mts"],"sourcesContent":["import { satisfies, validRange } from \"semver\";\n\nexport type SharedDep = { specifier: string; package: string };\n\n/**\n * The dependency set Connect and loaded packages share via the import map.\n * `@powerhousedao/connect` is deliberately absent: it is the Connect app\n * itself (no importable exports), so there is nothing to share.\n */\nexport const SHARED_DEPS: readonly SharedDep[] = [\n  { specifier: \"document-model\", package: \"document-model\" },\n  {\n    specifier: \"@powerhousedao/document-engineering\",\n    package: \"@powerhousedao/document-engineering\",\n  },\n  { specifier: \"@powerhousedao/shared\", package: \"@powerhousedao/shared\" },\n  {\n    specifier: \"@powerhousedao/shared/registry/urls\",\n    package: \"@powerhousedao/shared\",\n  },\n  {\n    specifier: \"@powerhousedao/design-system/connect\",\n    package: \"@powerhousedao/design-system\",\n  },\n  {\n    specifier: \"@powerhousedao/reactor-browser\",\n    package: \"@powerhousedao/reactor-browser\",\n  },\n  // Connect already vendors zod (it is in DEFAULT_VENDOR_INCLUDE, so the\n  // import map publishes an entry for it) and every generated project already\n  // declares it as a peerDependency -- yet it was missing from this set, so\n  // each package inlined a private copy anyway. It is the single biggest\n  // dependency left in a minimal package.\n  { specifier: \"zod\", package: \"zod\" },\n];\n\nexport const SHARED_DEP_SPECIFIERS: readonly string[] = SHARED_DEPS.map(\n  (d) => d.specifier,\n);\n\n/**\n * The `@powerhousedao/shared` subpaths the production vendor bundles. The\n * bare root is deliberately absent: its type barrel references node-only\n * modules (`clis/`), which the current vite/rolldown cannot bundle for the\n * browser — vendoring the root fails the build (a pre-existing latent\n * issue). A package that imports the bare root is simply not shared; it\n * bundles its own copy.\n */\nexport const SHARED_SUBPATHS: readonly string[] = [\n  \"connect\",\n  \"document-model\",\n  \"processors\",\n  \"document-drive\",\n  \"registry\",\n  \"registry/urls\",\n  \"registry/manifest-slim\",\n];\n\n/**\n * The specifiers a package build may safely externalize onto the host's\n * import map — i.e. the ones the vendor actually publishes an entry for.\n *\n * `@powerhousedao/shared` is narrowed to SHARED_SUBPATHS rather than taken as\n * a prefix: the bare root is never vendored (see SHARED_SUBPATHS), and\n * neither are its other subpaths (`analytics`, `constants`, `clis`, ...).\n * Externalizing those would leave a bare specifier in the package's output\n * that nothing in the import map resolves, so the package would fail to load\n * at runtime instead of simply bundling its own copy.\n */\nexport const EXTERNALIZABLE_SHARED_SPECIFIERS: readonly string[] = [\n  ...new Set([\n    ...SHARED_DEP_SPECIFIERS.filter((s) => s !== \"@powerhousedao/shared\"),\n    ...SHARED_SUBPATHS.map((s) => `@powerhousedao/shared/${s}`),\n  ]),\n];\n\n/** Split a specifier into its package name and subpath (\"\" for a root). */\nexport function parseDepSpec(spec: string): { pkg: string; sub: string } {\n  if (spec.startsWith(\"@\")) {\n    const parts = spec.split(\"/\");\n    return { pkg: parts.slice(0, 2).join(\"/\"), sub: parts.slice(2).join(\"/\") };\n  }\n  const i = spec.indexOf(\"/\");\n  return i === -1\n    ? { pkg: spec, sub: \"\" }\n    : { pkg: spec.slice(0, i), sub: spec.slice(i + 1) };\n}\n\nfunction isSharedSpecifier(spec: string, specs: readonly string[]): boolean {\n  return specs.some((s) => spec === s || spec.startsWith(s + \"/\"));\n}\n\n/**\n * Return the import/export specifiers in `source` that are a shared\n * specifier (or a subpath of one), sorted. Heuristic: only statement\n * positions are scanned (`from \"x\"`, `import \"x\"`, `import(\"x\")`;\n * `export … from \"x\"` is covered by the `from` pattern), so import-like\n * text inside comments or strings can be reported too. That errs toward\n * over-reporting, which is the safe direction for the advisory build\n * warning.\n */\nexport function findSharedImports(\n  source: string,\n  specs: readonly string[] = SHARED_DEP_SPECIFIERS,\n): string[] {\n  const found = new Set<string>();\n  const patterns = [\n    /\\bfrom\\s+[\"']([^\"'\\\\]+)[\"']/g,\n    /\\bimport\\s+[\"']([^\"'\\\\]+)[\"']/g,\n    /\\bimport\\s*\\(\\s*[\"']([^\"'\\\\]+)[\"']\\s*\\)/g,\n  ];\n  for (const re of patterns) {\n    for (const m of source.matchAll(re)) {\n      const spec = m[1];\n      if (isSharedSpecifier(spec, specs)) found.add(spec);\n    }\n  }\n  return [...found].sort();\n}\n\n/**\n * Rewrite a package source for blob import in a worker context (import maps\n * don't apply there): shared specifiers become their mapped URLs, and\n * relative (`./`, `../`) specifiers become absolute against `sourceUrl`\n * (a blob URL has no directory to resolve against). `#` subpath imports are\n * deliberately left alone: they resolve via the package's own\n * `package.json` \"imports\" field, which the rewrite cannot reproduce.\n * Returns the input unchanged when nothing matched.\n */\nexport function rewritePackageSource(\n  source: string,\n  sourceUrl: string,\n  imports: Record<string, string>,\n): string {\n  if (!Object.keys(imports).length) return source;\n  const base = new URL(sourceUrl);\n  const map = (spec: string): string | null => {\n    const mapped = imports[spec];\n    if (mapped) return mapped;\n    if (spec.startsWith(\"./\") || spec.startsWith(\"../\")) {\n      return new URL(spec, base).href;\n    }\n    return null;\n  };\n  let out = source;\n  // The quote character is captured and reused: a source that quotes its\n  // specifiers with ' would otherwise never match the replacement and be\n  // left un-rewritten — silently, since the specifier still maps.\n  for (const re of [\n    /\\bfrom\\s+([\"'])([^\"'\\\\]+)\\1/g,\n    /\\bimport\\s+([\"'])([^\"'\\\\]+)\\1/g,\n    /\\bimport\\s*\\(\\s*([\"'])([^\"'\\\\]+)\\1\\s*\\)/g,\n  ]) {\n    out = out.replace(re, (match, quote: string, spec: string) => {\n      // The match contains the quoted specifier exactly once and the\n      // captured group has no quotes/backslashes ([^\"'\\\\]), so a literal\n      // replace is safe.\n      const mapped = map(spec);\n      return mapped\n        ? match.replace(`${quote}${spec}${quote}`, `${quote}${mapped}${quote}`)\n        : match;\n    });\n  }\n  return out;\n}\n\nexport type SharedDepMismatch = {\n  package: string;\n  required: string;\n  provided: string;\n};\n\nexport type PackageDeps = {\n  dependencies?: Record<string, unknown>;\n  peerDependencies?: Record<string, unknown>;\n};\n\n/**\n * Compare a package's declared ranges against the host's version table.\n * `hostVersions` defines the checked set (only deps present in it are\n * checked). `*`, non-semver protocols (workspace:, file:, git:, npm:, URLs)\n * and unparseable ranges never mismatch.\n */\nexport function checkSharedDeps(\n  pkgJson: PackageDeps,\n  hostVersions: Record<string, string>,\n): SharedDepMismatch[] {\n  const out: SharedDepMismatch[] = [];\n  const entries = [\n    ...Object.entries(pkgJson.dependencies ?? {}),\n    ...Object.entries(pkgJson.peerDependencies ?? {}),\n  ];\n  for (const [dep, range] of entries) {\n    const provided = hostVersions[dep];\n    if (provided === undefined || typeof range !== \"string\") continue;\n    if (range === \"*\" || /^[a-z]+:/i.test(range)) continue;\n    if (!validRange(range)) continue;\n    if (!satisfies(provided, range, { includePrerelease: true })) {\n      out.push({ package: dep, required: range, provided });\n    }\n  }\n  return out;\n}\n\nexport function formatSharedDepWarnings(\n  mismatches: SharedDepMismatch[],\n): string[] {\n  return mismatches.map(\n    (m) =>\n      `${m.package}: requires ${m.required}, Connect provides ${m.provided}`,\n  );\n}\n","import { esmExternalRequirePlugin } from \"rolldown/plugins\";\nimport type { InlineConfig } from \"tsdown\";\nimport {\n  EXTERNALIZABLE_SHARED_SPECIFIERS,\n  findSharedImports,\n} from \"../connect/shared-deps.js\";\n\nconst entry = [\n  \"index.ts\",\n  \"document-models/index.ts\",\n  \"document-models/*/index.ts\",\n  \"document-models/*/module.ts\",\n  \"editors/index.ts\",\n  \"editors/*/index.ts\",\n  \"editors/*/module.ts\",\n  \"subgraphs/index.ts\",\n  \"subgraphs/*/index.ts\",\n  \"processors/index.ts\",\n  \"processors/*/index.ts\",\n];\n\n// ./pieces is node-only for the same reason ./reactor is browser-only: a piece\n// is loaded and run by a host process, never by the browser. Only the list of\n// pieces builds here; each piece is its own build (buildPieceBuildConfig), so\n// two pieces never share a chunk and each ships as one self-contained module.\nconst nodeEntry = [...entry, \"pieces/index.ts\"];\n\n// Where a package's pieces live, one directory per piece, as the node entry\n// glob spells it; `ph build` expands it against the project to find them.\nexport const PIECE_ENTRY_GLOB = \"pieces/*/index.ts\";\n\n// ./reactor is browser-only: the SharedWorker needs it, the node build does not.\nexport const browserEntry = [...entry, \"reactor/index.ts\"];\n\nconst alwaysBundle = [\"**\"];\n\n// React must be external so `import ... from \"react\"` stays a bare import and\n// resolves to the host's React at runtime; bundled, a chunk would carry a second\n// React. In the browser build the externals below belong to esmExternalRequirePlugin\n// alone: rolldown converts a CommonJS `require(\"react\")` into an import only for\n// externals the plugin owns, and listed in neverBundle too the top-level external\n// wins, leaving a browser bundle with a require it cannot serve. use-sync-external-store\n// under zustand, and so under @xyflow/react, is the case that found this.\nconst reactExternals = [\n  \"react\",\n  \"react-dom\",\n  \"react/jsx-runtime\",\n  \"react-dom/client\",\n];\n\nconst nodeNeverBundle = [\n  // we know that we don't want connect inside connect\n  \"@powerhousedao/connect\",\n  // published code would never need the cli\n  \"@powerhousedao/ph-cli\",\n  // the reactor-api host must provide a single class identity for\n  // BaseSubgraph/BaseProcessor — inlining a copy here breaks the\n  // prototype-chain check the package loader uses to detect subgraphs.\n  \"@powerhousedao/reactor-api\",\n  // react is resolved from esm.sh\n  \"react\",\n  \"react-dom\",\n  \"react/jsx-runtime\",\n  \"react-dom/client\",\n  // build tools\n  \"tailwindcss\",\n  \"vitest\",\n  \"tsdown\",\n  \"@tailwindcss/cli\",\n  \"@vitejs/plugin-react\",\n  // testing tools\n  \"@testing-library/jest-dom\",\n  \"@testing-library/react\",\n  \"@testing-library/user-event\",\n  // types\n  \"@types/node\",\n  \"@types/react\",\n  \"@types/react-dom\",\n  // exclude pglite wasm/data chunks\n  \"@electric-sql/pglite\",\n  \"@electric-sql/pglite-tools\",\n];\n\n// The node build keeps React in neverBundle: node has createRequire, so a\n// CommonJS require of an external resolves there without the plugin.\nconst browserNeverBundle = nodeNeverBundle.filter(\n  (spec) => typeof spec !== \"string\" || !reactExternals.includes(spec),\n);\n\nconst copy = [{ from: \"powerhouse.manifest.json\", to: \"dist\" }];\n\nconst config = false;\nconst clean = true;\n// types are emitted via a separate tsc command\nconst dts = false;\nconst sourcemap = true;\n\n// Shared deps are externalized from every package build: the host (Connect)\n// resolves them to one bundled copy via the import map, so a package must\n// not inline its own copy (two instances of the same dep break identity\n// checks and double the download). One regexp per specifier covers the root\n// and every subpath (rolldown `external` accepts strings and regexps, not\n// function matchers, in this toolchain).\n//\n// Only the specifiers the vendor publishes are externalized — see\n// EXTERNALIZABLE_SHARED_SPECIFIERS. Externalizing one the import map has no\n// entry for would leave an unresolvable bare specifier in the output.\nconst sharedNeverBundle = EXTERNALIZABLE_SHARED_SPECIFIERS.map(\n  (s) => new RegExp(`^${s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\")}(/.*)?$`),\n);\n\nconst baseBrowserConfig = {\n  entry: browserEntry,\n  platform: \"browser\" as const,\n  copy,\n  config,\n  clean,\n  dts,\n  sourcemap,\n  plugins: [\n    esmExternalRequirePlugin({\n      external: reactExternals,\n      skipDuplicateCheck: true,\n    }),\n  ],\n  inputOptions: {\n    experimental: { resolveNewUrlToAsset: true },\n  },\n};\n\nexport type BrowserBuildConfigOptions = {\n  /** Externalize the shared dependency set (default: true). */\n  sharedDeps?: boolean;\n};\n\nexport function buildBrowserBuildConfig(\n  options: BrowserBuildConfigOptions = {},\n): InlineConfig {\n  const sharedDeps = options.sharedDeps ?? true;\n  return {\n    ...baseBrowserConfig,\n    deps: {\n      alwaysBundle,\n      neverBundle: [\n        ...browserNeverBundle,\n        ...(sharedDeps ? sharedNeverBundle : []),\n      ],\n    },\n  };\n}\n\n// Kept for existing callers: the default (shared deps externalized).\nexport const browserBuildConfig = buildBrowserBuildConfig();\n\n/**\n * Shared specs a source imports but the built output no longer references as\n * bare imports — the bundler inlined them, which is exactly what the\n * external set is meant to prevent.\n */\nexport function findBundledSharedDeps(\n  importedSpecs: string[],\n  outputs: readonly { path: string; content: string }[],\n): string[] {\n  return importedSpecs.filter(\n    (spec) =>\n      !outputs.some((f) => findSharedImports(f.content, [spec]).includes(spec)),\n  );\n}\n\nexport type NodeBuildConfigOptions = {\n  /** Externalize the shared dependency set (default: true). */\n  sharedDeps?: boolean;\n};\n\n/**\n * The node build externalizes the same shared set as the browser build, for\n * the same reason the `@powerhousedao/reactor-api` entry in `nodeNeverBundle`\n * already gives: the host provides these, and a package carrying its own copy\n * is a second class identity as well as dead weight. What differs is only how\n * the import is resolved at runtime -- Connect's import map in the browser,\n * ordinary node resolution here, which works because these are declared for\n * the consumer to provide (`document-model`, `@powerhousedao/reactor-browser`\n * and `zod` are peerDependencies of every generated project).\n */\nexport function buildNodeBuildConfig(\n  options: NodeBuildConfigOptions = {},\n): InlineConfig {\n  const sharedDeps = options.sharedDeps ?? true;\n  return {\n    entry: nodeEntry,\n    deps: {\n      alwaysBundle,\n      neverBundle: [\n        ...nodeNeverBundle,\n        ...(sharedDeps ? sharedNeverBundle : []),\n      ],\n    },\n    platform: \"node\",\n    config,\n    clean,\n    dts,\n    sourcemap,\n  };\n}\n\n// Kept for existing callers: the default (shared deps externalized).\nexport const nodeBuildConfig: InlineConfig = buildNodeBuildConfig();\n\nexport type PieceBuildConfigOptions = {\n  /** The piece's source entry, relative to the project: `pieces/<dir>/index.ts`. */\n  entry: string;\n  /** Where the piece lands: `<outDir>/node/pieces/<dir>`. */\n  outDir: string;\n};\n\n/**\n * One piece, bundled whole. A piece runs in a forked worker with no\n * node_modules beside it, so nothing the piece imports can be left to the\n * host: the framework, its dependencies and the shared set that every other\n * module kind externalizes are all inlined here, and only node built-ins stay\n * external. Code splitting is off for the same reason, so a dynamic import is\n * inlined too and the piece directory holds exactly one module.\n */\nexport function buildPieceBuildConfig(\n  options: PieceBuildConfigOptions,\n): InlineConfig {\n  return {\n    entry: { index: options.entry },\n    outDir: options.outDir,\n    platform: \"node\",\n    deps: {\n      alwaysBundle,\n      neverBundle: [],\n      // Inlining dependencies is the point here, so tsdown's hint about it\n      // would only be noise on every piece.\n      onlyAllowBundle: false,\n    },\n    outputOptions: { codeSplitting: false },\n    config,\n    clean,\n    dts,\n    sourcemap,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"build-config-CmdMi_wu.mjs","names":[],"sources":["../../connect/shared-deps.ts","../../clis/build-config.mts"],"sourcesContent":["import { satisfies, validRange } from \"semver\";\n\nexport type SharedDep = { specifier: string; package: string };\n\n/**\n * The dependency set Connect and loaded packages share via the import map.\n * `@powerhousedao/connect` is deliberately absent: it is the Connect app\n * itself (no importable exports), so there is nothing to share.\n */\nexport const SHARED_DEPS: readonly SharedDep[] = [\n  { specifier: \"document-model\", package: \"document-model\" },\n  {\n    specifier: \"@powerhousedao/document-engineering\",\n    package: \"@powerhousedao/document-engineering\",\n  },\n  { specifier: \"@powerhousedao/shared\", package: \"@powerhousedao/shared\" },\n  {\n    specifier: \"@powerhousedao/shared/registry/urls\",\n    package: \"@powerhousedao/shared\",\n  },\n  {\n    specifier: \"@powerhousedao/design-system/connect\",\n    package: \"@powerhousedao/design-system\",\n  },\n  {\n    specifier: \"@powerhousedao/reactor-browser\",\n    package: \"@powerhousedao/reactor-browser\",\n  },\n  // Connect already vendors zod (it is in DEFAULT_VENDOR_INCLUDE, so the\n  // import map publishes an entry for it) and every generated project already\n  // declares it as a peerDependency -- yet it was missing from this set, so\n  // each package inlined a private copy anyway. It is the single biggest\n  // dependency left in a minimal package.\n  { specifier: \"zod\", package: \"zod\" },\n];\n\nexport const SHARED_DEP_SPECIFIERS: readonly string[] = SHARED_DEPS.map(\n  (d) => d.specifier,\n);\n\n/**\n * The `@powerhousedao/shared` subpaths the production vendor bundles. The\n * bare root is deliberately absent: its type barrel references node-only\n * modules (`clis/`), which the current vite/rolldown cannot bundle for the\n * browser — vendoring the root fails the build (a pre-existing latent\n * issue). A package that imports the bare root is simply not shared; it\n * bundles its own copy.\n */\nexport const SHARED_SUBPATHS: readonly string[] = [\n  \"connect\",\n  \"document-model\",\n  \"processors\",\n  \"document-drive\",\n  \"registry\",\n  \"registry/urls\",\n  \"registry/manifest-slim\",\n];\n\n/**\n * The specifiers a package build may safely externalize onto the host's\n * import map — i.e. the ones the vendor actually publishes an entry for.\n *\n * `@powerhousedao/shared` is narrowed to SHARED_SUBPATHS rather than taken as\n * a prefix: the bare root is never vendored (see SHARED_SUBPATHS), and\n * neither are its other subpaths (`analytics`, `constants`, `clis`, ...).\n * Externalizing those would leave a bare specifier in the package's output\n * that nothing in the import map resolves, so the package would fail to load\n * at runtime instead of simply bundling its own copy.\n */\nexport const EXTERNALIZABLE_SHARED_SPECIFIERS: readonly string[] = [\n  ...new Set([\n    ...SHARED_DEP_SPECIFIERS.filter((s) => s !== \"@powerhousedao/shared\"),\n    ...SHARED_SUBPATHS.map((s) => `@powerhousedao/shared/${s}`),\n  ]),\n];\n\n/** Split a specifier into its package name and subpath (\"\" for a root). */\nexport function parseDepSpec(spec: string): { pkg: string; sub: string } {\n  if (spec.startsWith(\"@\")) {\n    const parts = spec.split(\"/\");\n    return { pkg: parts.slice(0, 2).join(\"/\"), sub: parts.slice(2).join(\"/\") };\n  }\n  const i = spec.indexOf(\"/\");\n  return i === -1\n    ? { pkg: spec, sub: \"\" }\n    : { pkg: spec.slice(0, i), sub: spec.slice(i + 1) };\n}\n\nfunction isSharedSpecifier(spec: string, specs: readonly string[]): boolean {\n  return specs.some((s) => spec === s || spec.startsWith(s + \"/\"));\n}\n\n/**\n * Return the import/export specifiers in `source` that are a shared\n * specifier (or a subpath of one), sorted. Heuristic: only statement\n * positions are scanned (`from \"x\"`, `import \"x\"`, `import(\"x\")`;\n * `export … from \"x\"` is covered by the `from` pattern), so import-like\n * text inside comments or strings can be reported too. That errs toward\n * over-reporting, which is the safe direction for the advisory build\n * warning.\n */\nexport function findSharedImports(\n  source: string,\n  specs: readonly string[] = SHARED_DEP_SPECIFIERS,\n): string[] {\n  const found = new Set<string>();\n  const patterns = [\n    /\\bfrom\\s+[\"']([^\"'\\\\]+)[\"']/g,\n    /\\bimport\\s+[\"']([^\"'\\\\]+)[\"']/g,\n    /\\bimport\\s*\\(\\s*[\"']([^\"'\\\\]+)[\"']\\s*\\)/g,\n  ];\n  for (const re of patterns) {\n    for (const m of source.matchAll(re)) {\n      const spec = m[1];\n      if (isSharedSpecifier(spec, specs)) found.add(spec);\n    }\n  }\n  return [...found].sort();\n}\n\n/**\n * Rewrite a package source for blob import in a worker context (import maps\n * don't apply there): shared specifiers become their mapped URLs, and\n * relative (`./`, `../`) specifiers become absolute against `sourceUrl`\n * (a blob URL has no directory to resolve against). `#` subpath imports are\n * deliberately left alone: they resolve via the package's own\n * `package.json` \"imports\" field, which the rewrite cannot reproduce.\n * Returns the input unchanged when nothing matched.\n */\nexport function rewritePackageSource(\n  source: string,\n  sourceUrl: string,\n  imports: Record<string, string>,\n): string {\n  if (!Object.keys(imports).length) return source;\n  const base = new URL(sourceUrl);\n  const map = (spec: string): string | null => {\n    const mapped = imports[spec];\n    if (mapped) return mapped;\n    if (spec.startsWith(\"./\") || spec.startsWith(\"../\")) {\n      return new URL(spec, base).href;\n    }\n    return null;\n  };\n  let out = source;\n  // The quote character is captured and reused: a source that quotes its\n  // specifiers with ' would otherwise never match the replacement and be\n  // left un-rewritten — silently, since the specifier still maps.\n  for (const re of [\n    /\\bfrom\\s+([\"'])([^\"'\\\\]+)\\1/g,\n    /\\bimport\\s+([\"'])([^\"'\\\\]+)\\1/g,\n    /\\bimport\\s*\\(\\s*([\"'])([^\"'\\\\]+)\\1\\s*\\)/g,\n  ]) {\n    out = out.replace(re, (match, quote: string, spec: string) => {\n      // The match contains the quoted specifier exactly once and the\n      // captured group has no quotes/backslashes ([^\"'\\\\]), so a literal\n      // replace is safe.\n      const mapped = map(spec);\n      return mapped\n        ? match.replace(`${quote}${spec}${quote}`, `${quote}${mapped}${quote}`)\n        : match;\n    });\n  }\n  return out;\n}\n\nexport type SharedDepMismatch = {\n  package: string;\n  required: string;\n  provided: string;\n};\n\nexport type PackageDeps = {\n  dependencies?: Record<string, unknown>;\n  peerDependencies?: Record<string, unknown>;\n};\n\n/**\n * Compare a package's declared ranges against the host's version table.\n * `hostVersions` defines the checked set (only deps present in it are\n * checked). `*`, non-semver protocols (workspace:, file:, git:, npm:, URLs)\n * and unparseable ranges never mismatch.\n */\nexport function checkSharedDeps(\n  pkgJson: PackageDeps,\n  hostVersions: Record<string, string>,\n): SharedDepMismatch[] {\n  const out: SharedDepMismatch[] = [];\n  const entries = [\n    ...Object.entries(pkgJson.dependencies ?? {}),\n    ...Object.entries(pkgJson.peerDependencies ?? {}),\n  ];\n  for (const [dep, range] of entries) {\n    const provided = hostVersions[dep];\n    if (provided === undefined || typeof range !== \"string\") continue;\n    if (range === \"*\" || /^[a-z]+:/i.test(range)) continue;\n    if (!validRange(range)) continue;\n    if (!satisfies(provided, range, { includePrerelease: true })) {\n      out.push({ package: dep, required: range, provided });\n    }\n  }\n  return out;\n}\n\nexport function formatSharedDepWarnings(\n  mismatches: SharedDepMismatch[],\n): string[] {\n  return mismatches.map(\n    (m) =>\n      `${m.package}: requires ${m.required}, Connect provides ${m.provided}`,\n  );\n}\n","import { esmExternalRequirePlugin } from \"rolldown/plugins\";\nimport type { InlineConfig } from \"tsdown\";\nimport {\n  EXTERNALIZABLE_SHARED_SPECIFIERS,\n  findSharedImports,\n} from \"../connect/shared-deps.js\";\n\nconst entry = [\n  \"index.ts\",\n  \"document-models/index.ts\",\n  \"document-models/*/index.ts\",\n  \"document-models/*/module.ts\",\n  \"editors/index.ts\",\n  \"editors/*/index.ts\",\n  \"editors/*/module.ts\",\n  \"subgraphs/index.ts\",\n  \"subgraphs/*/index.ts\",\n  \"processors/index.ts\",\n  \"processors/*/index.ts\",\n];\n\n// ./pieces is node-only for the same reason ./reactor is browser-only: a piece\n// is loaded and run by a host process, never by the browser. Only the list of\n// pieces builds here; each piece is its own build (buildPieceBuildConfig), so\n// two pieces never share a chunk and each ships as one self-contained module.\nconst nodeEntry = [...entry, \"pieces/index.ts\"];\n\n// Where a package's pieces live, one directory per piece, as the node entry\n// glob spells it; `ph build` expands it against the project to find them.\nexport const PIECE_ENTRY_GLOB = \"pieces/*/index.ts\";\n\n// ./reactor is browser-only: the SharedWorker needs it, the node build does not.\nexport const browserEntry = [...entry, \"reactor/index.ts\"];\n\nconst alwaysBundle = [\"**\"];\n\n// React must be external so `import ... from \"react\"` stays a bare import and\n// resolves to the host's React at runtime; bundled, a chunk would carry a second\n// React. In the browser build the externals below belong to esmExternalRequirePlugin\n// alone: rolldown converts a CommonJS `require(\"react\")` into an import only for\n// externals the plugin owns, and listed in neverBundle too the top-level external\n// wins, leaving a browser bundle with a require it cannot serve. use-sync-external-store\n// under zustand, and so under @xyflow/react, is the case that found this.\nconst reactExternals = [\n  \"react\",\n  \"react-dom\",\n  \"react/jsx-runtime\",\n  \"react-dom/client\",\n];\n\nconst nodeNeverBundle = [\n  // we know that we don't want connect inside connect\n  \"@powerhousedao/connect\",\n  // published code would never need the cli\n  \"@powerhousedao/ph-cli\",\n  // the reactor-api host must provide a single class identity for\n  // BaseSubgraph/BaseProcessor — inlining a copy here breaks the\n  // prototype-chain check the package loader uses to detect subgraphs.\n  \"@powerhousedao/reactor-api\",\n  // react is resolved from esm.sh\n  \"react\",\n  \"react-dom\",\n  \"react/jsx-runtime\",\n  \"react-dom/client\",\n  // build tools\n  \"tailwindcss\",\n  \"vitest\",\n  \"tsdown\",\n  \"@tailwindcss/cli\",\n  \"@vitejs/plugin-react\",\n  // testing tools\n  \"@testing-library/jest-dom\",\n  \"@testing-library/react\",\n  \"@testing-library/user-event\",\n  // types\n  \"@types/node\",\n  \"@types/react\",\n  \"@types/react-dom\",\n  // exclude pglite wasm/data chunks\n  \"@electric-sql/pglite\",\n  \"@electric-sql/pglite-tools\",\n];\n\n// The node build keeps React in neverBundle: node has createRequire, so a\n// CommonJS require of an external resolves there without the plugin.\nconst browserNeverBundle = nodeNeverBundle.filter(\n  (spec) => typeof spec !== \"string\" || !reactExternals.includes(spec),\n);\n\nconst copy = [{ from: \"powerhouse.manifest.json\", to: \"dist\" }];\n\nconst config = false;\nconst clean = true;\n// types are emitted via a separate tsc command\nconst dts = false;\nconst sourcemap = true;\n\n// Shared deps are externalized from every package build: the host (Connect)\n// resolves them to one bundled copy via the import map, so a package must\n// not inline its own copy (two instances of the same dep break identity\n// checks and double the download). One regexp per specifier covers the root\n// and every subpath (rolldown `external` accepts strings and regexps, not\n// function matchers, in this toolchain).\n//\n// Only the specifiers the vendor publishes are externalized — see\n// EXTERNALIZABLE_SHARED_SPECIFIERS. Externalizing one the import map has no\n// entry for would leave an unresolvable bare specifier in the output.\nconst sharedNeverBundle = EXTERNALIZABLE_SHARED_SPECIFIERS.map(\n  (s) => new RegExp(`^${s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\")}(/.*)?$`),\n);\n\nconst baseBrowserConfig = {\n  entry: browserEntry,\n  platform: \"browser\" as const,\n  copy,\n  config,\n  clean,\n  dts,\n  sourcemap,\n  plugins: [\n    esmExternalRequirePlugin({\n      external: reactExternals,\n      skipDuplicateCheck: true,\n    }),\n  ],\n  inputOptions: {\n    experimental: { resolveNewUrlToAsset: true },\n  },\n};\n\nexport type BrowserBuildConfigOptions = {\n  /** Externalize the shared dependency set (default: true). */\n  sharedDeps?: boolean;\n};\n\nexport function buildBrowserBuildConfig(\n  options: BrowserBuildConfigOptions = {},\n): InlineConfig {\n  const sharedDeps = options.sharedDeps ?? true;\n  return {\n    ...baseBrowserConfig,\n    deps: {\n      alwaysBundle,\n      neverBundle: [\n        ...browserNeverBundle,\n        ...(sharedDeps ? sharedNeverBundle : []),\n      ],\n    },\n  };\n}\n\n// Kept for existing callers: the default (shared deps externalized).\nexport const browserBuildConfig = buildBrowserBuildConfig();\n\n/**\n * Shared specs a source imports but the built output no longer references as\n * bare imports — the bundler inlined them, which is exactly what the\n * external set is meant to prevent.\n */\nexport function findBundledSharedDeps(\n  importedSpecs: string[],\n  outputs: readonly { path: string; content: string }[],\n): string[] {\n  return importedSpecs.filter(\n    (spec) =>\n      !outputs.some((f) => findSharedImports(f.content, [spec]).includes(spec)),\n  );\n}\n\nexport type NodeBuildConfigOptions = {\n  /** Externalize the shared dependency set (default: true). */\n  sharedDeps?: boolean;\n};\n\n/**\n * The node build externalizes the same shared set as the browser build, for\n * the same reason the `@powerhousedao/reactor-api` entry in `nodeNeverBundle`\n * already gives: the host provides these, and a package carrying its own copy\n * is a second class identity as well as dead weight. What differs is only how\n * the import is resolved at runtime -- Connect's import map in the browser,\n * ordinary node resolution here, which works because these are declared for\n * the consumer to provide (`document-model`, `@powerhousedao/reactor-browser`\n * and `zod` are peerDependencies of every generated project).\n */\nexport function buildNodeBuildConfig(\n  options: NodeBuildConfigOptions = {},\n): InlineConfig {\n  const sharedDeps = options.sharedDeps ?? true;\n  return {\n    entry: nodeEntry,\n    deps: {\n      alwaysBundle,\n      neverBundle: [\n        ...nodeNeverBundle,\n        ...(sharedDeps ? sharedNeverBundle : []),\n      ],\n    },\n    platform: \"node\",\n    config,\n    clean,\n    dts,\n    sourcemap,\n  };\n}\n\n// Kept for existing callers: the default (shared deps externalized).\nexport const nodeBuildConfig: InlineConfig = buildNodeBuildConfig();\n\nexport type PieceBuildConfigOptions = {\n  /** The piece's source entry, relative to the project: `pieces/<dir>/index.ts`. */\n  entry: string;\n  /** Where the piece lands: `<outDir>/node/pieces/<dir>`. */\n  outDir: string;\n};\n\n/**\n * One piece, bundled whole. A piece runs in a forked worker with no\n * node_modules beside it, so nothing the piece imports can be left to the\n * host: the framework, its dependencies and the shared set that every other\n * module kind externalizes are all inlined here, and only node built-ins stay\n * external. Code splitting is off for the same reason, so a dynamic import is\n * inlined too and the piece directory holds exactly one module.\n */\nexport function buildPieceBuildConfig(\n  options: PieceBuildConfigOptions,\n): InlineConfig {\n  return {\n    entry: { index: options.entry },\n    outDir: options.outDir,\n    platform: \"node\",\n    deps: {\n      alwaysBundle,\n      neverBundle: [],\n      // Inlining dependencies is the point here, so tsdown's hint about it\n      // would only be noise on every piece.\n      onlyBundle: false,\n    },\n    outputOptions: { codeSplitting: false },\n    config,\n    clean,\n    dts,\n    sourcemap,\n  };\n}\n"],"mappings":"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"}

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

@@ -1,24 +1,25 @@
-import { t as InlineConfig } from "./index-CyAv0ucZ.mjs";
-
+import { t as InlineConfig } from "./index-DpixpHXl.mjs";
 //#region clis/build-config.d.mts
-declare const PIECE_ENTRY_GLOB = "pieces/*/index.ts";
-declare const browserEntry: string[];
-type BrowserBuildConfigOptions = {
-  /** Externalize the shared dependency set (default: true). */sharedDeps?: boolean;
+export declare const PIECE_ENTRY_GLOB = "pieces/*/index.ts";
+export declare const browserEntry: string[];
+export type BrowserBuildConfigOptions = {
+  /** Externalize the shared dependency set (default: true). */
+  sharedDeps?: boolean;
 };
-declare function buildBrowserBuildConfig(options?: BrowserBuildConfigOptions): InlineConfig;
-declare const browserBuildConfig: InlineConfig;
+export declare function buildBrowserBuildConfig(options?: BrowserBuildConfigOptions): InlineConfig;
+export declare const browserBuildConfig: InlineConfig;
 /**
  * Shared specs a source imports but the built output no longer references as
  * bare imports — the bundler inlined them, which is exactly what the
  * external set is meant to prevent.
  */
-declare function findBundledSharedDeps(importedSpecs: string[], outputs: readonly {
+export declare function findBundledSharedDeps(importedSpecs: string[], outputs: readonly {
   path: string;
   content: string;
 }[]): string[];
-type NodeBuildConfigOptions = {
-  /** Externalize the shared dependency set (default: true). */sharedDeps?: boolean;
+export type NodeBuildConfigOptions = {
+  /** Externalize the shared dependency set (default: true). */
+  sharedDeps?: boolean;
 };
 /**
  * The node build externalizes the same shared set as the browser build, for
@@ -30,10 +31,12 @@ type NodeBuildConfigOptions = {
  * the consumer to provide (`document-model`, `@powerhousedao/reactor-browser`
  * and `zod` are peerDependencies of every generated project).
  */
-declare function buildNodeBuildConfig(options?: NodeBuildConfigOptions): InlineConfig;
-declare const nodeBuildConfig: InlineConfig;
-type PieceBuildConfigOptions = {
-  /** The piece's source entry, relative to the project: `pieces/<dir>/index.ts`. */entry: string; /** Where the piece lands: `<outDir>/node/pieces/<dir>`. */
+export declare function buildNodeBuildConfig(options?: NodeBuildConfigOptions): InlineConfig;
+export declare const nodeBuildConfig: InlineConfig;
+export type PieceBuildConfigOptions = {
+  /** The piece's source entry, relative to the project: `pieces/<dir>/index.ts`. */
+  entry: string;
+  /** Where the piece lands: `<outDir>/node/pieces/<dir>`. */
   outDir: string;
 };
 /**
@@ -44,7 +47,7 @@ type PieceBuildConfigOptions = {
  * external. Code splitting is off for the same reason, so a dynamic import is
  * inlined too and the piece directory holds exactly one module.
  */
-declare function buildPieceBuildConfig(options: PieceBuildConfigOptions): InlineConfig;
+export declare function buildPieceBuildConfig(options: PieceBuildConfigOptions): InlineConfig;
 //#endregion
-export { BrowserBuildConfigOptions, NodeBuildConfigOptions, PIECE_ENTRY_GLOB, PieceBuildConfigOptions, browserBuildConfig, browserEntry, buildBrowserBuildConfig, buildNodeBuildConfig, buildPieceBuildConfig, findBundledSharedDeps, nodeBuildConfig };
+export {};
 //# sourceMappingURL=build-config.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"build-config.d.mts","names":[],"sources":["../../clis/build-config.mts"],"mappings":";;;cA6Ba,gBAAA;AAAA,cAGA,YAAA;AAAA,KAkGD,yBAAA;EArGiB,6DAuG3B,UAAA;AAAA;AAAA,iBAGc,uBAAA,CACd,OAAA,GAAS,yBAAA,GACR,YAAA;AAAA,cAeU,kBAAA,EAAkB,YAAA;;;;;AAtB/B;iBA6BgB,qBAAA,CACd,aAAA,YACA,OAAA;EAAoB,IAAA;EAAc,OAAA;AAAA;AAAA,KAQxB,sBAAA;EAlC2B,6DAoCrC,UAAA;AAAA;;;;;;AAnBF;;;;;iBAgCgB,oBAAA,CACd,OAAA,GAAS,sBAAA,GACR,YAAA;AAAA,cAoBU,eAAA,EAAiB,YAAA;AAAA,KAElB,uBAAA;EAjDyB,kFAmDnC,KAAA,UAjDoB;EAmDpB,MAAA;AAAA;;;AA3CF;;;;;AAeA;iBAuCgB,qBAAA,CACd,OAAA,EAAS,uBAAA,GACR,YAAA"}
+{"version":3,"file":"build-config.d.mts","names":[],"sources":["../../clis/build-config.mts"],"mappings":";;qBA6Ba;qBAGA;YAkGD;;EAEV;;wBAGc,wBACd,UAAS,4BACR;qBAeU,oBAAkB;;;;;;wBAOf,sBACd,yBACA;EAAoB;EAAc;;YAQxB;;EAEV;;;;;;;;;;;;wBAac,qBACd,UAAS,yBACR;qBAoBU,iBAAiB;YAElB;;EAEV;;EAEA;;;;;;;;;;wBAWc,sBACd,SAAS,0BACR"}

package/dist/clis/build-config.mjs

@@ -1,2 +1,2 @@
-import { a as buildNodeBuildConfig, c as nodeBuildConfig, i as buildBrowserBuildConfig, n as browserBuildConfig, o as buildPieceBuildConfig, r as browserEntry, s as findBundledSharedDeps, t as PIECE_ENTRY_GLOB } from "./build-config-BkfXtfV8.mjs";
+import { a as buildNodeBuildConfig, c as nodeBuildConfig, i as buildBrowserBuildConfig, n as browserBuildConfig, o as buildPieceBuildConfig, r as browserEntry, s as findBundledSharedDeps, t as PIECE_ENTRY_GLOB } from "./build-config-CmdMi_wu.mjs";
 export { PIECE_ENTRY_GLOB, browserBuildConfig, browserEntry, buildBrowserBuildConfig, buildNodeBuildConfig, buildPieceBuildConfig, findBundledSharedDeps, nodeBuildConfig };

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

@@ -1,36 +1,37 @@
-import { t as InlineConfig } from "./index-CyAv0ucZ.mjs";
-import { t as Manifest } from "./types-DXhVHupa.mjs";
-import * as node_fs0 from "node:fs";
-
+import { t as InlineConfig } from "./index-DpixpHXl.mjs";
+import { t as Manifest } from "./types-CMFHKrgv.mjs";
 //#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. */
+export 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 = {
+export type PieceBuildTarget = {
   projectRoot: string;
   outDir: string;
   pieces: PiecePlan[];
 };
-type PackagePiece = {
+export type PackagePiece = {
   name: string;
   version: string;
   entry?: string;
   bundle?: string;
 };
-type PieceMetadata = Record<string, unknown> & {
+export type PieceMetadata = Record<string, unknown> & {
   displayName?: string;
   description?: string;
   actions?: Record<string, unknown>;
   triggers?: Record<string, unknown>;
 };
-type DescribedPiece = {
+export type DescribedPiece = {
   name: string;
   version: string;
   metadata: PieceMetadata;
 };
-type DescribeResult = {
+export type DescribeResult = {
   list: PackagePiece[];
   pieces: DescribedPiece[];
   errors: {
@@ -38,58 +39,63 @@ type DescribeResult = {
     message: string;
   }[];
 };
-type BuiltPiece = {
+export 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. */
+  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 = {
+export 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>;
+export 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. */
+export declare function statSafe(p: string): import("node:fs").Stats | null;
+export declare function expandEntryGlobs(root: string, globs: string[]): string[];
+export declare function planPieces(projectRoot: string, outDir: string): PiecePlan[];
+export declare function createJsonReplacer(): (this: unknown, _key: string, value: unknown) => {} | null | undefined;
+export 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";
+export 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";
+export declare function describePieces(projectRoot: string, listPath: string): DescribeResult;
+export 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: {
+export declare function resolvePieceLocation(piece: PackagePiece, projectRoot: string, outDir: string): PieceLocation;
+export declare function pieceListPath(target: {
   projectRoot: string;
   outDir: string;
 }): string;
-declare function assertPiecesOutDir(target: {
+export declare function assertPiecesOutDir(target: {
   outDir: string;
   pieces: PiecePlan[];
 }): void;
-declare function assertPieceVersion(piece: PackagePiece, pkg: PackageIdentity): void;
-declare function piecePackageJson(options: {
+export declare function assertPieceVersion(piece: PackagePiece, pkg: PackageIdentity): void;
+export 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[]): {
+export declare function pieceDescriptor(piece: PackagePiece, metadata: PieceMetadata): Record<string, unknown>;
+export 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;
+export declare function buildPieces(target: PieceBuildTarget, pkg: PackageIdentity, options: PieceBuildOptions): Promise<BuiltPiece[]>;
+export 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 };
+export {};
 //# sourceMappingURL=build-pieces.d.mts.map

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

@@ -1 +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"}
+{"version":3,"file":"build-pieces.d.mts","names":[],"sources":["../../clis/build-pieces.mts"],"mappings":";;;YA4BY;;EAEV;;EAEA;;EAEA;;YAKU;EACV;EACA;EACA,QAAQ;;YAKE;EACV;EACA;EACA;EACA;;YAKU,gBAAgB;EAC1B;EACA;EACA,UAAU;EACV,WAAW;;YAGD;EACV;EACA;EACA,UAAU;;YAGA;EACV,MAAM;EACN,QAAQ;EACR;IAAU;IAAc;;;YAGd;EACV;EACA;EACA;EACA;;EAEA;;EAEA;;YAGU;EACV;EACA;EACA;;YAGU;;EAEV,SAAS,QAAQ,iBAAiB;;wBAKpB,SAAS,8BAAS;wBAUlB,iBAAiB,cAAc;wBA4B/B,WAAW,qBAAqB,iBAAiB;wBAejD,uBAAkB,eAEK,cAAc;qBAiBxC;qBAiEA;wBAsFG,eACd,qBACA,mBACC;YA0BS;;EAEV;;EAEA;EACA;;wBAKc,qBACd,OAAO,cACP,qBACA,iBACC;wBAmCa,cAAc;EAC5B;EACA;;wBAac,mBAAmB;EACjC;EACA,QAAQ;;wBAWM,mBACd,OAAO,cACP,KAAK;wBAWS,iBAAiB;EAC/B;EACA;EACA;EACA;EACA;IACE;wBAgBY,gBACd,OAAO,cACP,UAAU,gBACT;wBAUa,qBACd,UAAU,UACV,OAAO;EACJ,UAAU;EAAU;;wBAkCH,YACpB,QAAQ,kBACR,KAAK,iBACL,SAAS,oBACR,QAAQ;wBA4GK,iBACd,QAAQ,kBACR,OAAO"}

package/dist/clis/build-pieces.mjs

@@ -1,4 +1,4 @@
-import { o as buildPieceBuildConfig, t as PIECE_ENTRY_GLOB } from "./build-config-BkfXtfV8.mjs";
+import { o as buildPieceBuildConfig, t as PIECE_ENTRY_GLOB } from "./build-config-CmdMi_wu.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";
@@ -217,7 +217,8 @@ function resolvePieceLocation(piece, projectRoot, outDir) {
 	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);
+	const piecesRoot = resolve(projectRoot, outDir, "node", "pieces");
+	const inside = relative(piecesRoot, 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`);

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

@@ -1 +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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"}
+{"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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"}

package/dist/clis/command-names.d.mts

@@ -1,5 +1,5 @@
 //#region clis/command-names.d.ts
-declare const phCliCommandNames: readonly ["generate", "vetra", "connect", "build", "publish", "list", "l", "access-token", "registry-login", "inspect", "is", "migrate", "switchboard", "reactor", "login", "logout", "install", "add", "i", "uninstall", "remove"];
+export declare const phCliCommandNames: readonly ["generate", "vetra", "connect", "build", "publish", "list", "l", "access-token", "registry-login", "inspect", "is", "migrate", "switchboard", "reactor", "login", "logout", "install", "add", "i", "uninstall", "remove"];
 //#endregion
-export { phCliCommandNames };
+export {};
 //# sourceMappingURL=command-names.d.mts.map

package/dist/clis/command-names.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"command-names.d.mts","names":[],"sources":["../../clis/command-names.ts"],"mappings":";cAEa,iBAAA"}
+{"version":3,"file":"command-names.d.mts","names":[],"sources":["../../clis/command-names.ts"],"mappings":";qBAEa"}

package/dist/clis/command-names.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"command-names.mjs","names":[],"sources":["../../clis/command-names.ts"],"sourcesContent":["// Hardcoded so ph-cmd's dispatch doesn't have to evaluate phCliHelpCommands.\n// The compile-time guard in args/help.ts catches drift.\nexport const phCliCommandNames = [\n  \"generate\",\n  \"vetra\",\n  \"connect\",\n  \"build\",\n  \"publish\",\n  \"list\",\n  \"l\",\n  \"access-token\",\n  \"registry-login\",\n  \"inspect\",\n  \"is\",\n  \"migrate\",\n  \"switchboard\",\n  \"reactor\",\n  \"login\",\n  \"logout\",\n  \"install\",\n  \"add\",\n  \"i\",\n  \"uninstall\",\n  \"remove\",\n] as const;\n"],"mappings":";AAEA,MAAa,oBAAoB;CAC/B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"command-names.mjs","names":[],"sources":["../../clis/command-names.ts"],"sourcesContent":["// Hardcoded so ph-cmd's dispatch doesn't have to evaluate phCliHelpCommands.\n// The compile-time guard in args/help.ts catches drift.\nexport const phCliCommandNames = [\n  \"generate\",\n  \"vetra\",\n  \"connect\",\n  \"build\",\n  \"publish\",\n  \"list\",\n  \"l\",\n  \"access-token\",\n  \"registry-login\",\n  \"inspect\",\n  \"is\",\n  \"migrate\",\n  \"switchboard\",\n  \"reactor\",\n  \"login\",\n  \"logout\",\n  \"install\",\n  \"add\",\n  \"i\",\n  \"uninstall\",\n  \"remove\",\n] as const;\n"],"mappings":";AAEA,MAAa,oBAAoB;CAC/B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}

package/dist/clis/constants.d.mts

@@ -1,2 +1,3 @@
-import { A as PIECES_FRAMEWORK_PACKAGE, B as VERSIONED_DEPENDENCIES, C as LEGACY_LINT_FORMAT_FILES, D as PH_BIN, E as PEER_EXTERNAL_DEPENDENCIES, F as PROJECT_PORT_BAND_SWITCHBOARD, G as externalDevDependencies, H as VERSIONED_PEER_DEPENDENCIES, I as PROJECT_PORT_BAND_VETRA_CONNECT, K as packageJsonExports, L as REACTOR_API_PACKAGE, M as POWERHOUSE_GLOBAL_DIR, N as PROJECT_PORT_BAND_SIZE, O as PH_GLOBAL_DIR_NAME, P as PROJECT_PORT_BAND_STUDIO, R as SECONDS_IN_DAY, S as LEGACY_LINT_FORMAT_DEPENDENCIES, T as MINIMUM_NODE_VERSION, U as defaultManifest, V as VERSIONED_DEV_DEPENDENCIES, W as externalDependencies, _ as DRIVES_PRESERVE_STRATEGIES, a as DEFAULT_CONFIG, b as GRAPHQL_TAG_PACKAGE, c as DEFAULT_CONNECT_STUDIO_PORT, d as DEFAULT_REGISTRY_URL, f as DEFAULT_RENOWN_URL, g as DEFAULT_VETRA_DRIVE_ID, h as DEFAULT_VETRA_CONNECT_PORT, i as BOILERPLATE_DEPENDENCY_OVERRIDES, j as POWERHOUSE_CONFIG_FILE, k as PH_GLOBAL_PROJECT_NAME, l as DEFAULT_EXPIRY_DAYS, m as DEFAULT_TIMEOUT, n as ANALYTICS_ENGINE_CORE_PACKAGE, o as DEFAULT_CONNECT_OUTDIR, p as DEFAULT_SWITCHBOARD_PORT, q as packageScripts, r as BOILERPLATE_ALLOWED_BUILDS, s as DEFAULT_CONNECT_PREVIEW_PORT, u as DEFAULT_EXPIRY_SECONDS, v as FEATURE_DEPENDENCIES, w as LOG_LEVELS, x as HOME_DIR, y as GRAPHQL_PACKAGE, z as SERVICE_ACTIONS } from "./types-DXhVHupa.mjs";
-export { ANALYTICS_ENGINE_CORE_PACKAGE, BOILERPLATE_ALLOWED_BUILDS, BOILERPLATE_DEPENDENCY_OVERRIDES, DEFAULT_CONFIG, DEFAULT_CONNECT_OUTDIR, DEFAULT_CONNECT_PREVIEW_PORT, DEFAULT_CONNECT_STUDIO_PORT, DEFAULT_EXPIRY_DAYS, DEFAULT_EXPIRY_SECONDS, DEFAULT_REGISTRY_URL, DEFAULT_RENOWN_URL, DEFAULT_SWITCHBOARD_PORT, DEFAULT_TIMEOUT, DEFAULT_VETRA_CONNECT_PORT, DEFAULT_VETRA_DRIVE_ID, DRIVES_PRESERVE_STRATEGIES, FEATURE_DEPENDENCIES, GRAPHQL_PACKAGE, GRAPHQL_TAG_PACKAGE, HOME_DIR, LEGACY_LINT_FORMAT_DEPENDENCIES, LEGACY_LINT_FORMAT_FILES, LOG_LEVELS, MINIMUM_NODE_VERSION, PEER_EXTERNAL_DEPENDENCIES, PH_BIN, PH_GLOBAL_DIR_NAME, PH_GLOBAL_PROJECT_NAME, PIECES_FRAMEWORK_PACKAGE, POWERHOUSE_CONFIG_FILE, POWERHOUSE_GLOBAL_DIR, PROJECT_PORT_BAND_SIZE, PROJECT_PORT_BAND_STUDIO, PROJECT_PORT_BAND_SWITCHBOARD, PROJECT_PORT_BAND_VETRA_CONNECT, REACTOR_API_PACKAGE, SECONDS_IN_DAY, SERVICE_ACTIONS, VERSIONED_DEPENDENCIES, VERSIONED_DEV_DEPENDENCIES, VERSIONED_PEER_DEPENDENCIES, defaultManifest, externalDependencies, externalDevDependencies, packageJsonExports, packageScripts };
+import { A as PIECES_FRAMEWORK_PACKAGE, B as VERSIONED_DEPENDENCIES, C as LEGACY_LINT_FORMAT_FILES, D as PH_BIN, E as PEER_EXTERNAL_DEPENDENCIES, F as PROJECT_PORT_BAND_SWITCHBOARD, G as externalDevDependencies, H as VERSIONED_PEER_DEPENDENCIES, I as PROJECT_PORT_BAND_VETRA_CONNECT, K as packageJsonExports, L as REACTOR_API_PACKAGE, M as POWERHOUSE_GLOBAL_DIR, N as PROJECT_PORT_BAND_SIZE, O as PH_GLOBAL_DIR_NAME, P as PROJECT_PORT_BAND_STUDIO, R as SECONDS_IN_DAY, S as LEGACY_LINT_FORMAT_DEPENDENCIES, T as MINIMUM_NODE_VERSION, U as defaultManifest, V as VERSIONED_DEV_DEPENDENCIES, W as externalDependencies, _ as DRIVES_PRESERVE_STRATEGIES, a as DEFAULT_CONFIG, b as GRAPHQL_TAG_PACKAGE, c as DEFAULT_CONNECT_STUDIO_PORT, d as DEFAULT_REGISTRY_URL, f as DEFAULT_RENOWN_URL, g as DEFAULT_VETRA_DRIVE_ID, h as DEFAULT_VETRA_CONNECT_PORT, i as BOILERPLATE_DEPENDENCY_OVERRIDES, j as POWERHOUSE_CONFIG_FILE, k as PH_GLOBAL_PROJECT_NAME, l as DEFAULT_EXPIRY_DAYS, m as DEFAULT_TIMEOUT, n as ANALYTICS_ENGINE_CORE_PACKAGE, o as DEFAULT_CONNECT_OUTDIR, p as DEFAULT_SWITCHBOARD_PORT, q as packageScripts, r as BOILERPLATE_ALLOWED_BUILDS, s as DEFAULT_CONNECT_PREVIEW_PORT, u as DEFAULT_EXPIRY_SECONDS, v as FEATURE_DEPENDENCIES, w as LOG_LEVELS, x as HOME_DIR, y as GRAPHQL_PACKAGE, z as SERVICE_ACTIONS } from "./types-CMFHKrgv.mjs";
+export { ANALYTICS_ENGINE_CORE_PACKAGE, BOILERPLATE_ALLOWED_BUILDS, BOILERPLATE_DEPENDENCY_OVERRIDES, DEFAULT_CONFIG, DEFAULT_CONNECT_OUTDIR, DEFAULT_CONNECT_PREVIEW_PORT, DEFAULT_CONNECT_STUDIO_PORT, DEFAULT_EXPIRY_DAYS, DEFAULT_EXPIRY_SECONDS, DEFAULT_REGISTRY_URL, DEFAULT_RENOWN_URL, DEFAULT_SWITCHBOARD_PORT, DEFAULT_TIMEOUT, DEFAULT_VETRA_CONNECT_PORT, DEFAULT_VETRA_DRIVE_ID, DRIVES_PRESERVE_STRATEGIES, FEATURE_DEPENDENCIES, GRAPHQL_PACKAGE, GRAPHQL_TAG_PACKAGE, HOME_DIR, LEGACY_LINT_FORMAT_DEPENDENCIES, LEGACY_LINT_FORMAT_FILES, LOG_LEVELS, MINIMUM_NODE_VERSION, PEER_EXTERNAL_DEPENDENCIES, PH_BIN, PH_GLOBAL_DIR_NAME, PH_GLOBAL_PROJECT_NAME, PIECES_FRAMEWORK_PACKAGE, POWERHOUSE_CONFIG_FILE, POWERHOUSE_GLOBAL_DIR, PROJECT_PORT_BAND_SIZE, PROJECT_PORT_BAND_STUDIO, PROJECT_PORT_BAND_SWITCHBOARD, PROJECT_PORT_BAND_VETRA_CONNECT, REACTOR_API_PACKAGE, SECONDS_IN_DAY, SERVICE_ACTIONS, VERSIONED_DEPENDENCIES, VERSIONED_DEV_DEPENDENCIES, VERSIONED_PEER_DEPENDENCIES, defaultManifest, externalDependencies, externalDevDependencies, packageJsonExports, packageScripts };
+export {};