every-plugin 2.10.1 → 3.0.0-rc.0

package/dist/ui/manifest/descriptor.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.mts","names":[],"sources":["../../../src/ui/manifest/descriptor.ts"],"mappings":";;;;;;;;;UAWiB;EACf;EACA;EACA;EACA;;UAGe;EACf;EACA,QAAQ;;UAGO;EACf;EACA,SAAS,eAAe;;UAGT;EACf;EACA,QAAQ;;UAGO;EACf;EACA;EACA,SAAS,eAAe;;;UAKT;iBAED,IAAI,OAAO,WAAW;iBAItB,OAAO,UAAU,cAAc,uBAC7C,MAAM;EAEN,QAAQ,iBAAiB;EACzB,SAAS,gBAAgB,gBAAgB;;;iBAS3B,WAAW,OAAO,UAAU,MAAM,eAAe,YAAY;UAa5D;;EAEf;EACA,SAAS;IAAQ;IAAa;;EAC9B,WAAW;;;;;;;;iBASS,SAAS,OAAO,yBAAyB"}

package/dist/ui/manifest/descriptor.mjs

@@ -0,0 +1,61 @@
+import { MOUNT_REGISTRY_VERSION } from "./mount-registry.mjs";
+
+//#region src/ui/manifest/descriptor.ts
+function App(input) {
+	return input;
+}
+function Plugin(name) {
+	return {
+		local: (path) => ({
+			name,
+			source: {
+				kind: "local",
+				path
+			}
+		}),
+		remote: (mfName, url) => ({
+			name,
+			source: {
+				kind: "remote",
+				mfName,
+				url
+			}
+		})
+	};
+}
+/** Flatten an app against the registry of apps: `extends` inherits the base's plugins, child wins. */
+function resolveApp(input, apps) {
+	const base = input.extends ? apps[input.extends] : void 0;
+	if (input.extends && !base) throw new Error(`extends target "${input.extends}" not found`);
+	const plugins = {};
+	for (const [key, ref] of Object.entries(base?.plugins ?? {})) plugins[key] = {
+		key,
+		...ref
+	};
+	for (const [key, ref] of Object.entries(input.plugins)) plugins[key] = {
+		key,
+		...ref
+	};
+	return {
+		name: input.name,
+		plugins
+	};
+}
+/**
+* Composition digest — sha256 (WebCrypto) over everything that determines
+* the tree: app name, plugin keys, MF names, manifests, and the imported
+* `MOUNT_REGISTRY_VERSION`. Deployment URLs are deliberately excluded so
+* disk and prod paths digest identically (hydration parity).
+*/
+async function digestOf(input) {
+	const bytes = new TextEncoder().encode(JSON.stringify({
+		...input,
+		mountRegistryVersion: 5
+	}));
+	const hash = await crypto.subtle.digest("SHA-256", bytes);
+	return Array.from(new Uint8Array(hash)).map((b) => b.toString(16).padStart(2, "0")).join("").slice(0, 16);
+}
+
+//#endregion
+export { App, Plugin, digestOf, resolveApp };
+//# sourceMappingURL=descriptor.mjs.map

package/dist/ui/manifest/descriptor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.mjs","names":[],"sources":["../../../src/ui/manifest/descriptor.ts"],"sourcesContent":["import { MOUNT_REGISTRY_VERSION } from \"./mount-registry\";\n\n/**\n * Shape-of-028 descriptor slice (ADR 0005 / plan 028) — composition-resolver\n * surface only. Pure data: `App({...})` returns a typed object. `extends`\n * resolves child-wins over the base app's plugins (publish-time flattening\n * model of wayfinder ticket 08). Plan 028 will declaration-merge\n * `KnownPlugins` from generated types; until then the interface is empty and\n * `Plugin(\"bogus\")` does not compile.\n */\n\nexport interface RemoteSource {\n  kind: \"local\" | \"remote\";\n  path?: string;\n  mfName?: string;\n  url?: string;\n}\n\nexport interface PluginRef {\n  key: string;\n  source: RemoteSource;\n}\n\nexport interface ResolvedApp {\n  name: string;\n  plugins: Record<string, PluginRef>;\n}\n\nexport interface PluginRefInput {\n  name: string;\n  source: RemoteSource;\n}\n\nexport interface AppInput {\n  name: string;\n  extends?: string;\n  plugins: Record<string, PluginRefInput>;\n}\n\n/** Declaration-merged from generated types by plan 028 — must stay an interface (types cannot merge). */\n// biome-ignore lint/suspicious/noEmptyInterface: declaration-merge surface\nexport interface KnownPlugins {}\n\nexport function App(input: AppInput): AppInput {\n  return input;\n}\n\nexport function Plugin<K extends Extract<keyof KnownPlugins, string>>(\n  name: K,\n): {\n  local: (path: string) => PluginRefInput;\n  remote: (mfName: string, url: string) => PluginRefInput;\n} {\n  return {\n    local: (path) => ({ name, source: { kind: \"local\", path } }),\n    remote: (mfName, url) => ({ name, source: { kind: \"remote\", mfName, url } }),\n  };\n}\n\n/** Flatten an app against the registry of apps: `extends` inherits the base's plugins, child wins. */\nexport function resolveApp(input: AppInput, apps: Record<string, AppInput>): ResolvedApp {\n  const base = input.extends ? apps[input.extends] : undefined;\n  if (input.extends && !base) throw new Error(`extends target \"${input.extends}\" not found`);\n  const plugins: Record<string, PluginRef> = {};\n  for (const [key, ref] of Object.entries(base?.plugins ?? {})) {\n    plugins[key] = { key, ...ref };\n  }\n  for (const [key, ref] of Object.entries(input.plugins)) {\n    plugins[key] = { key, ...ref };\n  }\n  return { name: input.name, plugins };\n}\n\nexport interface CompositionDigestInput {\n  /** optional app label — deliberately NOT a tree-identity input; omit for server/client parity */\n  appName?: string;\n  plugins: Array<{ key: string; mfName: string }>;\n  manifests: Array<unknown>;\n}\n\n/**\n * Composition digest — sha256 (WebCrypto) over everything that determines\n * the tree: app name, plugin keys, MF names, manifests, and the imported\n * `MOUNT_REGISTRY_VERSION`. Deployment URLs are deliberately excluded so\n * disk and prod paths digest identically (hydration parity).\n */\nexport async function digestOf(input: CompositionDigestInput): Promise<string> {\n  const bytes = new TextEncoder().encode(\n    JSON.stringify({ ...input, mountRegistryVersion: MOUNT_REGISTRY_VERSION }),\n  );\n  const hash = await crypto.subtle.digest(\"SHA-256\", bytes);\n  return Array.from(new Uint8Array(hash))\n    .map((b) => b.toString(16).padStart(2, \"0\"))\n    .join(\"\")\n    .slice(0, 16);\n}\n"],"mappings":";;;AA2CA,SAAgB,IAAI,OAA2B;CAC7C,OAAO;AACT;AAEA,SAAgB,OACd,MAIA;CACA,OAAO;EACL,QAAQ,UAAU;GAAE;GAAM,QAAQ;IAAE,MAAM;IAAS;GAAK;EAAE;EAC1D,SAAS,QAAQ,SAAS;GAAE;GAAM,QAAQ;IAAE,MAAM;IAAU;IAAQ;GAAI;EAAE;CAC5E;AACF;;AAGA,SAAgB,WAAW,OAAiB,MAA6C;CACvF,MAAM,OAAO,MAAM,UAAU,KAAK,MAAM,WAAW;CACnD,IAAI,MAAM,WAAW,CAAC,MAAM,MAAM,IAAI,MAAM,mBAAmB,MAAM,QAAQ,YAAY;CACzF,MAAM,UAAqC,CAAC;CAC5C,KAAK,MAAM,CAAC,KAAK,QAAQ,OAAO,QAAQ,MAAM,WAAW,CAAC,CAAC,GACzD,QAAQ,OAAO;EAAE;EAAK,GAAG;CAAI;CAE/B,KAAK,MAAM,CAAC,KAAK,QAAQ,OAAO,QAAQ,MAAM,OAAO,GACnD,QAAQ,OAAO;EAAE;EAAK,GAAG;CAAI;CAE/B,OAAO;EAAE,MAAM,MAAM;EAAM;CAAQ;AACrC;;;;;;;AAeA,eAAsB,SAAS,OAAgD;CAC7E,MAAM,QAAQ,IAAI,YAAY,CAAC,CAAC,OAC9B,KAAK,UAAU;EAAE,GAAG;EAAO;CAA6C,CAAC,CAC3E;CACA,MAAM,OAAO,MAAM,OAAO,OAAO,OAAO,WAAW,KAAK;CACxD,OAAO,MAAM,KAAK,IAAI,WAAW,IAAI,CAAC,CAAC,CACpC,KAAK,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAC3C,KAAK,EAAE,CAAC,CACR,MAAM,GAAG,EAAE;AAChB"}

package/dist/ui/manifest/generator.cjs

@@ -0,0 +1,128 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_mount_registry = require('./mount-registry.cjs');
+const require_route_config = require('./route-config.cjs');
+const require_ui_manifest_contract = require('./contract.cjs');
+const require_manifest_schema = require('./manifest-schema.cjs');
+require('./index.cjs');
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let node_fs_promises = require("node:fs/promises");
+let _tanstack_router_generator = require("@tanstack/router-generator");
+
+//#region src/ui/manifest/generator.ts
+const idOf = (node) => (node.routePath ?? "").replace(/^\//, "");
+function importPathOf(file) {
+	return `./routes/${file.replace(/\.tsx$/, "").replace(/\.ts$/, "")}`;
+}
+async function generateUiManifest(options) {
+	const { workspaceRoot, pluginName, routesDirectory = "./src/routes", generatedRouteTree = "./src/routeTree.gen.ts", srcDir = "./src", typeImport = "everything-dev/ui/manifest", emitRouteTree = true } = options;
+	const generator = new _tanstack_router_generator.Generator({
+		config: (0, _tanstack_router_generator.getConfig)({
+			target: "react",
+			routesDirectory,
+			generatedRouteTree: emitRouteTree ? generatedRouteTree : "./node_modules/.cache/manifest-compose/routeTree.gen.ts",
+			routeFileIgnorePrefix: "-",
+			routeFileIgnorePattern: "\\.(test|spec)\\.(ts|tsx)$",
+			disableLogging: true
+		}, workspaceRoot),
+		root: workspaceRoot
+	});
+	await generator.run();
+	const crawling = await generator.getCrawlingResult();
+	if (!crawling) throw new Error(`scan produced no result for ${pluginName}`);
+	const { rootRouteNode, routeFileResult } = crawling;
+	if (!rootRouteNode) throw new Error(`no __root found for ${pluginName}`);
+	const routes = [];
+	const errors = [];
+	for (const node of routeFileResult) {
+		const isRootLevel = node.parent === void 0 || node.parent === rootRouteNode;
+		if (node._fsRouteType === "__root") continue;
+		if (isRootLevel && (node._fsRouteType === "pathless_layout" || node._fsRouteType === "layout")) {
+			const id = idOf(node);
+			const segment = id.split("/").at(-1) ?? "";
+			if (!segment.startsWith("_")) continue;
+			const mount = require_mount_registry.resolveMountSegment(segment.slice(1));
+			if (!mount) {
+				errors.push(`unknown mount "_${segment.slice(1)}" (${node.filePath}); known: ${Object.keys(require_mount_registry.MOUNT_REGISTRY).join(", ")}`);
+				continue;
+			}
+			routes.push({
+				id,
+				type: "layout",
+				mount,
+				file: node.filePath
+			});
+			continue;
+		}
+		const isIndex = node._fsRouteType === "static" && node.cleanedPath === "/";
+		routes.push({
+			id: idOf(node),
+			type: isIndex ? "index" : node._fsRouteType === "pathless_layout" || node._fsRouteType === "layout" ? "layout" : "route",
+			path: isIndex ? "/" : node.cleanedPath === "/" || node.cleanedPath === "" ? void 0 : node.cleanedPath,
+			file: node.filePath,
+			parentId: node.parent && node.parent !== rootRouteNode ? idOf(node.parent) : void 0
+		});
+	}
+	for (const record of routes) {
+		if (record.type === "layout" && record.mount) continue;
+		if (record.parentId) continue;
+		const firstSegment = record.id.split("/")[0] ?? "";
+		if (firstSegment.startsWith("_")) {
+			if (!require_mount_registry.resolveMountSegment(firstSegment.slice(1))) errors.push(`unknown mount "_${firstSegment.slice(1)}" (${record.file}); known: ${Object.keys(require_mount_registry.MOUNT_REGISTRY).join(", ")}`);
+		} else errors.push(`route "${record.id}" (${record.file}) must live under a mount — root-level pathed routes have no gate`);
+	}
+	const siblingPathClaims = /* @__PURE__ */ new Map();
+	for (const record of routes) {
+		if (record.type === "layout" || record.path === void 0) continue;
+		const claimKey = `${record.parentId ?? ""}::${record.path}`;
+		const claimant = siblingPathClaims.get(claimKey);
+		if (claimant) {
+			errors.push(`duplicate path "${record.path}" under "${record.parentId ?? "mount root"}": "${claimant}" and "${record.id}" (${record.file})`);
+			continue;
+		}
+		siblingPathClaims.set(claimKey, record.id);
+	}
+	if (errors.length > 0) throw new Error(`manifest generation failed for ${pluginName}:\n  ${errors.join("\n  ")}`);
+	const manifest = require_manifest_schema.PluginManifestSchema.parse({
+		name: pluginName,
+		manifestVersion: 2,
+		routes
+	});
+	const resolvedSrc = node_path.default.resolve(workspaceRoot, srcDir);
+	await (0, node_fs_promises.mkdir)(resolvedSrc, { recursive: true });
+	await writeIfChanged(node_path.default.join(resolvedSrc, require_ui_manifest_contract.MANIFEST_FILENAME), `${JSON.stringify(manifest, null, 2)}\n`);
+	const loaderLines = routes.filter((r) => r.file).map((r) => `  ${JSON.stringify(r.id)}: () => import(${JSON.stringify(importPathOf(r.file))}).then((m) => pick(m.Route.options)),`);
+	const rootImport = `import { Route as __rootRoute } from ${JSON.stringify(importPathOf(rootRouteNode.filePath ?? "__root"))};`;
+	const routeConfigSource = `// Generated by manifest-gen. DO NOT EDIT.
+// Inputs: src/routes/** only.
+import type { RouteConfigModule, RouteOptionsBundle } from ${JSON.stringify(typeImport)};
+
+const pick = (o: any): RouteOptionsBundle => ({
+${require_route_config.ROUTE_OPTION_KEYS.map((key) => `  ${key}: o?.${key},`).join("\n")}
+});
+
+${rootImport}
+
+export const routeConfigLoaders: RouteConfigModule["routeConfigLoaders"] = {
+${loaderLines.join("\n")}
+};
+
+export const rootMeta = pick(__rootRoute.options);
+`;
+	await writeIfChanged(node_path.default.join(resolvedSrc, require_ui_manifest_contract.ROUTE_CONFIG_FILENAME), routeConfigSource);
+	return manifest;
+}
+/**
+* Identical content is never re-written: the dev watcher is timestamp-based,
+* so an unconditional write re-triggers compilation — which runs this
+* generator again — an infinite regen loop.
+*/
+async function writeIfChanged(file, contents) {
+	if (await (0, node_fs_promises.readFile)(file, "utf8").catch(() => void 0) === contents) return;
+	await (0, node_fs_promises.writeFile)(file, contents);
+}
+
+//#endregion
+exports.generateUiManifest = generateUiManifest;
+//# sourceMappingURL=generator.cjs.map

package/dist/ui/manifest/generator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.cjs","names":["Generator","getConfig","resolveMountSegment","MOUNT_REGISTRY","PluginManifestSchema","path","mkdir","MANIFEST_FILENAME","ROUTE_OPTION_KEYS","ROUTE_CONFIG_FILENAME","readFile","writeFile"],"sources":["../../../src/ui/manifest/generator.ts"],"sourcesContent":["import { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { Generator, getConfig } from \"@tanstack/router-generator\";\nimport {\n  MANIFEST_FILENAME,\n  MANIFEST_VERSION,\n  type PluginManifest,\n  PluginManifestSchema,\n  ROUTE_CONFIG_FILENAME,\n  type RouteRecord,\n  resolveMountSegment,\n} from \"./index\";\nimport { MOUNT_REGISTRY } from \"./mount-registry\";\nimport { ROUTE_OPTION_KEYS } from \"./route-config\";\n\n/**\n * The load-bearing generator step (ADR 0008 §2). Rides\n * `@tanstack/router-generator`'s scan (Generator.run + getCrawlingResult)\n * and emits, per ui source workspace:\n *\n *   - src/routeTree.gen.ts   via the stock generator run (plugin-local\n *                            standalone DX — never consumed by the host)\n *   - src/manifest.gen.json  pure data: ids, paths, nesting, mounts, files\n *   - src/routeConfig.gen.ts generated import map of per-route option\n *                            bundles + lifted `__root` meta\n *\n * Nothing hand-maintained: the only inputs are the route files. Root-level\n * pathless layouts derive mounts via the registry; unknown mounts, routes\n * under a missing mount layout, and duplicate sibling paths are hard errors\n * here (cross-plugin path collisions are enforced at construction time —\n * see `constructTree`).\n */\n\nexport interface ManifestGeneratorOptions {\n  /** ui source workspace root (ui/ or plugins/<id>/ui/) */\n  workspaceRoot: string;\n  /** composition-identity plugin key written into the manifest */\n  pluginName: string;\n  routesDirectory?: string;\n  generatedRouteTree?: string;\n  srcDir?: string;\n  /** module specifier the generated routeConfig imports its types from */\n  typeImport?: string;\n  /**\n   * When false, the stock routeTree write is redirected to a scratch path —\n   * for builds where TanStackRouterRspack owns src/routeTree.gen.ts (its\n   * autoCodeSplitting options differ); only manifest + routeConfig persist.\n   */\n  emitRouteTree?: boolean;\n}\n\ninterface ScanNode {\n  routePath?: string;\n  cleanedPath?: string;\n  filePath?: string;\n  parent?: ScanNode | undefined;\n  _fsRouteType?: string;\n}\n\nconst idOf = (node: { routePath?: string }): string => (node.routePath ?? \"\").replace(/^\\//, \"\");\n\nfunction importPathOf(file: string): string {\n  return `./routes/${file.replace(/\\.tsx$/, \"\").replace(/\\.ts$/, \"\")}`;\n}\n\nexport async function generateUiManifest(\n  options: ManifestGeneratorOptions,\n): Promise<PluginManifest> {\n  const {\n    workspaceRoot,\n    pluginName,\n    routesDirectory = \"./src/routes\",\n    generatedRouteTree = \"./src/routeTree.gen.ts\",\n    srcDir = \"./src\",\n    typeImport = \"everything-dev/ui/manifest\",\n    emitRouteTree = true,\n  } = options;\n\n  const routeTreeTarget = emitRouteTree\n    ? generatedRouteTree\n    : \"./node_modules/.cache/manifest-compose/routeTree.gen.ts\";\n\n  const generator = new Generator({\n    config: getConfig(\n      {\n        target: \"react\",\n        routesDirectory,\n        generatedRouteTree: routeTreeTarget,\n        routeFileIgnorePrefix: \"-\",\n        routeFileIgnorePattern: \"\\\\.(test|spec)\\\\.(ts|tsx)$\",\n        disableLogging: true,\n      },\n      workspaceRoot,\n    ),\n    root: workspaceRoot,\n  });\n  await generator.run();\n  const crawling = await generator.getCrawlingResult();\n  if (!crawling) throw new Error(`scan produced no result for ${pluginName}`);\n\n  const { rootRouteNode, routeFileResult } = crawling;\n  if (!rootRouteNode) throw new Error(`no __root found for ${pluginName}`);\n\n  const routes: RouteRecord[] = [];\n  const errors: string[] = [];\n\n  for (const node of routeFileResult as ScanNode[]) {\n    const isRootLevel = node.parent === undefined || node.parent === rootRouteNode;\n\n    if (node._fsRouteType === \"__root\") {\n      continue;\n    }\n\n    if (\n      isRootLevel &&\n      (node._fsRouteType === \"pathless_layout\" || node._fsRouteType === \"layout\")\n    ) {\n      const id = idOf(node);\n      const segment = id.split(\"/\").at(-1) ?? \"\";\n      if (!segment.startsWith(\"_\")) continue;\n      const mount = resolveMountSegment(segment.slice(1));\n      if (!mount) {\n        errors.push(\n          `unknown mount \"_${segment.slice(1)}\" (${node.filePath}); known: ${Object.keys(MOUNT_REGISTRY).join(\", \")}`,\n        );\n        continue;\n      }\n      routes.push({ id, type: \"layout\", mount, file: node.filePath });\n      continue;\n    }\n\n    const isIndex = node._fsRouteType === \"static\" && node.cleanedPath === \"/\";\n    routes.push({\n      id: idOf(node),\n      type: isIndex\n        ? \"index\"\n        : node._fsRouteType === \"pathless_layout\" || node._fsRouteType === \"layout\"\n          ? \"layout\"\n          : \"route\",\n      path: isIndex\n        ? \"/\"\n        : node.cleanedPath === \"/\" || node.cleanedPath === \"\"\n          ? undefined\n          : node.cleanedPath,\n      file: node.filePath,\n      parentId: node.parent && node.parent !== rootRouteNode ? idOf(node.parent) : undefined,\n    });\n  }\n\n  for (const record of routes) {\n    if (record.type === \"layout\" && record.mount) continue;\n    if (record.parentId) continue;\n    const firstSegment = record.id.split(\"/\")[0] ?? \"\";\n    if (firstSegment.startsWith(\"_\")) {\n      const mount = resolveMountSegment(firstSegment.slice(1));\n      if (!mount) {\n        errors.push(\n          `unknown mount \"_${firstSegment.slice(1)}\" (${record.file}); known: ${Object.keys(MOUNT_REGISTRY).join(\", \")}`,\n        );\n      }\n    } else {\n      errors.push(\n        `route \"${record.id}\" (${record.file}) must live under a mount — root-level pathed routes have no gate`,\n      );\n    }\n  }\n\n  const siblingPathClaims = new Map<string, string>();\n  for (const record of routes) {\n    if (record.type === \"layout\" || record.path === undefined) continue;\n    const claimKey = `${record.parentId ?? \"\"}::${record.path}`;\n    const claimant = siblingPathClaims.get(claimKey);\n    if (claimant) {\n      errors.push(\n        `duplicate path \"${record.path}\" under \"${record.parentId ?? \"mount root\"}\": \"${claimant}\" and \"${record.id}\" (${record.file})`,\n      );\n      continue;\n    }\n    siblingPathClaims.set(claimKey, record.id);\n  }\n\n  if (errors.length > 0) {\n    throw new Error(`manifest generation failed for ${pluginName}:\\n  ${errors.join(\"\\n  \")}`);\n  }\n\n  const manifest: PluginManifest = PluginManifestSchema.parse({\n    name: pluginName,\n    manifestVersion: MANIFEST_VERSION,\n    routes,\n  });\n\n  const resolvedSrc = path.resolve(workspaceRoot, srcDir);\n  await mkdir(resolvedSrc, { recursive: true });\n  await writeIfChanged(\n    path.join(resolvedSrc, MANIFEST_FILENAME),\n    `${JSON.stringify(manifest, null, 2)}\\n`,\n  );\n\n  const loaderLines = routes\n    .filter((r) => r.file)\n    .map(\n      (r) =>\n        `  ${JSON.stringify(r.id)}: () => import(${JSON.stringify(importPathOf(r.file!))}).then((m) => pick(m.Route.options)),`,\n    );\n  const rootImport = `import { Route as __rootRoute } from ${JSON.stringify(importPathOf(rootRouteNode.filePath ?? \"__root\"))};`;\n\n  const routeConfigSource = `// Generated by manifest-gen. DO NOT EDIT.\n// Inputs: src/routes/** only.\nimport type { RouteConfigModule, RouteOptionsBundle } from ${JSON.stringify(typeImport)};\n\nconst pick = (o: any): RouteOptionsBundle => ({\n${ROUTE_OPTION_KEYS.map((key) => `  ${key}: o?.${key},`).join(\"\\n\")}\n});\n\n${rootImport}\n\nexport const routeConfigLoaders: RouteConfigModule[\"routeConfigLoaders\"] = {\n${loaderLines.join(\"\\n\")}\n};\n\nexport const rootMeta = pick(__rootRoute.options);\n`;\n\n  await writeIfChanged(path.join(resolvedSrc, ROUTE_CONFIG_FILENAME), routeConfigSource);\n\n  return manifest;\n}\n\n/**\n * Identical content is never re-written: the dev watcher is timestamp-based,\n * so an unconditional write re-triggers compilation — which runs this\n * generator again — an infinite regen loop.\n */\nasync function writeIfChanged(file: string, contents: string): Promise<void> {\n  const existing = await readFile(file, \"utf8\").catch(() => undefined);\n  if (existing === contents) return;\n  await writeFile(file, contents);\n}\n"],"mappings":"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"}

package/dist/ui/manifest/generator.d.cts

@@ -0,0 +1,41 @@
+import { PluginManifest } from "./manifest-schema.cjs";
+import "./index.cjs";
+//#region src/ui/manifest/generator.d.ts
+/**
+ * The load-bearing generator step (ADR 0008 §2). Rides
+ * `@tanstack/router-generator`'s scan (Generator.run + getCrawlingResult)
+ * and emits, per ui source workspace:
+ *
+ *   - src/routeTree.gen.ts   via the stock generator run (plugin-local
+ *                            standalone DX — never consumed by the host)
+ *   - src/manifest.gen.json  pure data: ids, paths, nesting, mounts, files
+ *   - src/routeConfig.gen.ts generated import map of per-route option
+ *                            bundles + lifted `__root` meta
+ *
+ * Nothing hand-maintained: the only inputs are the route files. Root-level
+ * pathless layouts derive mounts via the registry; unknown mounts, routes
+ * under a missing mount layout, and duplicate sibling paths are hard errors
+ * here (cross-plugin path collisions are enforced at construction time —
+ * see `constructTree`).
+ */
+interface ManifestGeneratorOptions {
+  /** ui source workspace root (ui/ or plugins/<id>/ui/) */
+  workspaceRoot: string;
+  /** composition-identity plugin key written into the manifest */
+  pluginName: string;
+  routesDirectory?: string;
+  generatedRouteTree?: string;
+  srcDir?: string;
+  /** module specifier the generated routeConfig imports its types from */
+  typeImport?: string;
+  /**
+   * When false, the stock routeTree write is redirected to a scratch path —
+   * for builds where TanStackRouterRspack owns src/routeTree.gen.ts (its
+   * autoCodeSplitting options differ); only manifest + routeConfig persist.
+   */
+  emitRouteTree?: boolean;
+}
+declare function generateUiManifest(options: ManifestGeneratorOptions): Promise<PluginManifest>;
+//#endregion
+export { ManifestGeneratorOptions, generateUiManifest };
+//# sourceMappingURL=generator.d.cts.map

package/dist/ui/manifest/generator.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.cts","names":[],"sources":["../../../src/ui/manifest/generator.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;UAiCiB;;EAEf;;EAEA;EACA;EACA;EACA;;EAEA;;;;;;EAMA;;iBAiBoB,mBACpB,SAAS,2BACR,QAAQ"}

package/dist/ui/manifest/generator.d.mts

@@ -0,0 +1,41 @@
+import { PluginManifest } from "./manifest-schema.mjs";
+import "./index.mjs";
+//#region src/ui/manifest/generator.d.ts
+/**
+ * The load-bearing generator step (ADR 0008 §2). Rides
+ * `@tanstack/router-generator`'s scan (Generator.run + getCrawlingResult)
+ * and emits, per ui source workspace:
+ *
+ *   - src/routeTree.gen.ts   via the stock generator run (plugin-local
+ *                            standalone DX — never consumed by the host)
+ *   - src/manifest.gen.json  pure data: ids, paths, nesting, mounts, files
+ *   - src/routeConfig.gen.ts generated import map of per-route option
+ *                            bundles + lifted `__root` meta
+ *
+ * Nothing hand-maintained: the only inputs are the route files. Root-level
+ * pathless layouts derive mounts via the registry; unknown mounts, routes
+ * under a missing mount layout, and duplicate sibling paths are hard errors
+ * here (cross-plugin path collisions are enforced at construction time —
+ * see `constructTree`).
+ */
+interface ManifestGeneratorOptions {
+  /** ui source workspace root (ui/ or plugins/<id>/ui/) */
+  workspaceRoot: string;
+  /** composition-identity plugin key written into the manifest */
+  pluginName: string;
+  routesDirectory?: string;
+  generatedRouteTree?: string;
+  srcDir?: string;
+  /** module specifier the generated routeConfig imports its types from */
+  typeImport?: string;
+  /**
+   * When false, the stock routeTree write is redirected to a scratch path —
+   * for builds where TanStackRouterRspack owns src/routeTree.gen.ts (its
+   * autoCodeSplitting options differ); only manifest + routeConfig persist.
+   */
+  emitRouteTree?: boolean;
+}
+declare function generateUiManifest(options: ManifestGeneratorOptions): Promise<PluginManifest>;
+//#endregion
+export { ManifestGeneratorOptions, generateUiManifest };
+//# sourceMappingURL=generator.d.mts.map

package/dist/ui/manifest/generator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.mts","names":[],"sources":["../../../src/ui/manifest/generator.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;UAiCiB;;EAEf;;EAEA;EACA;EACA;EACA;;EAEA;;;;;;EAMA;;iBAiBoB,mBACpB,SAAS,2BACR,QAAQ"}

package/dist/ui/manifest/generator.mjs

@@ -0,0 +1,125 @@
+import { MOUNT_REGISTRY, resolveMountSegment } from "./mount-registry.mjs";
+import { ROUTE_OPTION_KEYS } from "./route-config.mjs";
+import { MANIFEST_FILENAME, ROUTE_CONFIG_FILENAME } from "./contract.mjs";
+import { MANIFEST_VERSION, PluginManifestSchema } from "./manifest-schema.mjs";
+import "./index.mjs";
+import path from "node:path";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { Generator, getConfig } from "@tanstack/router-generator";
+
+//#region src/ui/manifest/generator.ts
+const idOf = (node) => (node.routePath ?? "").replace(/^\//, "");
+function importPathOf(file) {
+	return `./routes/${file.replace(/\.tsx$/, "").replace(/\.ts$/, "")}`;
+}
+async function generateUiManifest(options) {
+	const { workspaceRoot, pluginName, routesDirectory = "./src/routes", generatedRouteTree = "./src/routeTree.gen.ts", srcDir = "./src", typeImport = "everything-dev/ui/manifest", emitRouteTree = true } = options;
+	const generator = new Generator({
+		config: getConfig({
+			target: "react",
+			routesDirectory,
+			generatedRouteTree: emitRouteTree ? generatedRouteTree : "./node_modules/.cache/manifest-compose/routeTree.gen.ts",
+			routeFileIgnorePrefix: "-",
+			routeFileIgnorePattern: "\\.(test|spec)\\.(ts|tsx)$",
+			disableLogging: true
+		}, workspaceRoot),
+		root: workspaceRoot
+	});
+	await generator.run();
+	const crawling = await generator.getCrawlingResult();
+	if (!crawling) throw new Error(`scan produced no result for ${pluginName}`);
+	const { rootRouteNode, routeFileResult } = crawling;
+	if (!rootRouteNode) throw new Error(`no __root found for ${pluginName}`);
+	const routes = [];
+	const errors = [];
+	for (const node of routeFileResult) {
+		const isRootLevel = node.parent === void 0 || node.parent === rootRouteNode;
+		if (node._fsRouteType === "__root") continue;
+		if (isRootLevel && (node._fsRouteType === "pathless_layout" || node._fsRouteType === "layout")) {
+			const id = idOf(node);
+			const segment = id.split("/").at(-1) ?? "";
+			if (!segment.startsWith("_")) continue;
+			const mount = resolveMountSegment(segment.slice(1));
+			if (!mount) {
+				errors.push(`unknown mount "_${segment.slice(1)}" (${node.filePath}); known: ${Object.keys(MOUNT_REGISTRY).join(", ")}`);
+				continue;
+			}
+			routes.push({
+				id,
+				type: "layout",
+				mount,
+				file: node.filePath
+			});
+			continue;
+		}
+		const isIndex = node._fsRouteType === "static" && node.cleanedPath === "/";
+		routes.push({
+			id: idOf(node),
+			type: isIndex ? "index" : node._fsRouteType === "pathless_layout" || node._fsRouteType === "layout" ? "layout" : "route",
+			path: isIndex ? "/" : node.cleanedPath === "/" || node.cleanedPath === "" ? void 0 : node.cleanedPath,
+			file: node.filePath,
+			parentId: node.parent && node.parent !== rootRouteNode ? idOf(node.parent) : void 0
+		});
+	}
+	for (const record of routes) {
+		if (record.type === "layout" && record.mount) continue;
+		if (record.parentId) continue;
+		const firstSegment = record.id.split("/")[0] ?? "";
+		if (firstSegment.startsWith("_")) {
+			if (!resolveMountSegment(firstSegment.slice(1))) errors.push(`unknown mount "_${firstSegment.slice(1)}" (${record.file}); known: ${Object.keys(MOUNT_REGISTRY).join(", ")}`);
+		} else errors.push(`route "${record.id}" (${record.file}) must live under a mount — root-level pathed routes have no gate`);
+	}
+	const siblingPathClaims = /* @__PURE__ */ new Map();
+	for (const record of routes) {
+		if (record.type === "layout" || record.path === void 0) continue;
+		const claimKey = `${record.parentId ?? ""}::${record.path}`;
+		const claimant = siblingPathClaims.get(claimKey);
+		if (claimant) {
+			errors.push(`duplicate path "${record.path}" under "${record.parentId ?? "mount root"}": "${claimant}" and "${record.id}" (${record.file})`);
+			continue;
+		}
+		siblingPathClaims.set(claimKey, record.id);
+	}
+	if (errors.length > 0) throw new Error(`manifest generation failed for ${pluginName}:\n  ${errors.join("\n  ")}`);
+	const manifest = PluginManifestSchema.parse({
+		name: pluginName,
+		manifestVersion: 2,
+		routes
+	});
+	const resolvedSrc = path.resolve(workspaceRoot, srcDir);
+	await mkdir(resolvedSrc, { recursive: true });
+	await writeIfChanged(path.join(resolvedSrc, MANIFEST_FILENAME), `${JSON.stringify(manifest, null, 2)}\n`);
+	const loaderLines = routes.filter((r) => r.file).map((r) => `  ${JSON.stringify(r.id)}: () => import(${JSON.stringify(importPathOf(r.file))}).then((m) => pick(m.Route.options)),`);
+	const rootImport = `import { Route as __rootRoute } from ${JSON.stringify(importPathOf(rootRouteNode.filePath ?? "__root"))};`;
+	const routeConfigSource = `// Generated by manifest-gen. DO NOT EDIT.
+// Inputs: src/routes/** only.
+import type { RouteConfigModule, RouteOptionsBundle } from ${JSON.stringify(typeImport)};
+
+const pick = (o: any): RouteOptionsBundle => ({
+${ROUTE_OPTION_KEYS.map((key) => `  ${key}: o?.${key},`).join("\n")}
+});
+
+${rootImport}
+
+export const routeConfigLoaders: RouteConfigModule["routeConfigLoaders"] = {
+${loaderLines.join("\n")}
+};
+
+export const rootMeta = pick(__rootRoute.options);
+`;
+	await writeIfChanged(path.join(resolvedSrc, ROUTE_CONFIG_FILENAME), routeConfigSource);
+	return manifest;
+}
+/**
+* Identical content is never re-written: the dev watcher is timestamp-based,
+* so an unconditional write re-triggers compilation — which runs this
+* generator again — an infinite regen loop.
+*/
+async function writeIfChanged(file, contents) {
+	if (await readFile(file, "utf8").catch(() => void 0) === contents) return;
+	await writeFile(file, contents);
+}
+
+//#endregion
+export { generateUiManifest };
+//# sourceMappingURL=generator.mjs.map

package/dist/ui/manifest/generator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.mjs","names":[],"sources":["../../../src/ui/manifest/generator.ts"],"sourcesContent":["import { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { Generator, getConfig } from \"@tanstack/router-generator\";\nimport {\n  MANIFEST_FILENAME,\n  MANIFEST_VERSION,\n  type PluginManifest,\n  PluginManifestSchema,\n  ROUTE_CONFIG_FILENAME,\n  type RouteRecord,\n  resolveMountSegment,\n} from \"./index\";\nimport { MOUNT_REGISTRY } from \"./mount-registry\";\nimport { ROUTE_OPTION_KEYS } from \"./route-config\";\n\n/**\n * The load-bearing generator step (ADR 0008 §2). Rides\n * `@tanstack/router-generator`'s scan (Generator.run + getCrawlingResult)\n * and emits, per ui source workspace:\n *\n *   - src/routeTree.gen.ts   via the stock generator run (plugin-local\n *                            standalone DX — never consumed by the host)\n *   - src/manifest.gen.json  pure data: ids, paths, nesting, mounts, files\n *   - src/routeConfig.gen.ts generated import map of per-route option\n *                            bundles + lifted `__root` meta\n *\n * Nothing hand-maintained: the only inputs are the route files. Root-level\n * pathless layouts derive mounts via the registry; unknown mounts, routes\n * under a missing mount layout, and duplicate sibling paths are hard errors\n * here (cross-plugin path collisions are enforced at construction time —\n * see `constructTree`).\n */\n\nexport interface ManifestGeneratorOptions {\n  /** ui source workspace root (ui/ or plugins/<id>/ui/) */\n  workspaceRoot: string;\n  /** composition-identity plugin key written into the manifest */\n  pluginName: string;\n  routesDirectory?: string;\n  generatedRouteTree?: string;\n  srcDir?: string;\n  /** module specifier the generated routeConfig imports its types from */\n  typeImport?: string;\n  /**\n   * When false, the stock routeTree write is redirected to a scratch path —\n   * for builds where TanStackRouterRspack owns src/routeTree.gen.ts (its\n   * autoCodeSplitting options differ); only manifest + routeConfig persist.\n   */\n  emitRouteTree?: boolean;\n}\n\ninterface ScanNode {\n  routePath?: string;\n  cleanedPath?: string;\n  filePath?: string;\n  parent?: ScanNode | undefined;\n  _fsRouteType?: string;\n}\n\nconst idOf = (node: { routePath?: string }): string => (node.routePath ?? \"\").replace(/^\\//, \"\");\n\nfunction importPathOf(file: string): string {\n  return `./routes/${file.replace(/\\.tsx$/, \"\").replace(/\\.ts$/, \"\")}`;\n}\n\nexport async function generateUiManifest(\n  options: ManifestGeneratorOptions,\n): Promise<PluginManifest> {\n  const {\n    workspaceRoot,\n    pluginName,\n    routesDirectory = \"./src/routes\",\n    generatedRouteTree = \"./src/routeTree.gen.ts\",\n    srcDir = \"./src\",\n    typeImport = \"everything-dev/ui/manifest\",\n    emitRouteTree = true,\n  } = options;\n\n  const routeTreeTarget = emitRouteTree\n    ? generatedRouteTree\n    : \"./node_modules/.cache/manifest-compose/routeTree.gen.ts\";\n\n  const generator = new Generator({\n    config: getConfig(\n      {\n        target: \"react\",\n        routesDirectory,\n        generatedRouteTree: routeTreeTarget,\n        routeFileIgnorePrefix: \"-\",\n        routeFileIgnorePattern: \"\\\\.(test|spec)\\\\.(ts|tsx)$\",\n        disableLogging: true,\n      },\n      workspaceRoot,\n    ),\n    root: workspaceRoot,\n  });\n  await generator.run();\n  const crawling = await generator.getCrawlingResult();\n  if (!crawling) throw new Error(`scan produced no result for ${pluginName}`);\n\n  const { rootRouteNode, routeFileResult } = crawling;\n  if (!rootRouteNode) throw new Error(`no __root found for ${pluginName}`);\n\n  const routes: RouteRecord[] = [];\n  const errors: string[] = [];\n\n  for (const node of routeFileResult as ScanNode[]) {\n    const isRootLevel = node.parent === undefined || node.parent === rootRouteNode;\n\n    if (node._fsRouteType === \"__root\") {\n      continue;\n    }\n\n    if (\n      isRootLevel &&\n      (node._fsRouteType === \"pathless_layout\" || node._fsRouteType === \"layout\")\n    ) {\n      const id = idOf(node);\n      const segment = id.split(\"/\").at(-1) ?? \"\";\n      if (!segment.startsWith(\"_\")) continue;\n      const mount = resolveMountSegment(segment.slice(1));\n      if (!mount) {\n        errors.push(\n          `unknown mount \"_${segment.slice(1)}\" (${node.filePath}); known: ${Object.keys(MOUNT_REGISTRY).join(\", \")}`,\n        );\n        continue;\n      }\n      routes.push({ id, type: \"layout\", mount, file: node.filePath });\n      continue;\n    }\n\n    const isIndex = node._fsRouteType === \"static\" && node.cleanedPath === \"/\";\n    routes.push({\n      id: idOf(node),\n      type: isIndex\n        ? \"index\"\n        : node._fsRouteType === \"pathless_layout\" || node._fsRouteType === \"layout\"\n          ? \"layout\"\n          : \"route\",\n      path: isIndex\n        ? \"/\"\n        : node.cleanedPath === \"/\" || node.cleanedPath === \"\"\n          ? undefined\n          : node.cleanedPath,\n      file: node.filePath,\n      parentId: node.parent && node.parent !== rootRouteNode ? idOf(node.parent) : undefined,\n    });\n  }\n\n  for (const record of routes) {\n    if (record.type === \"layout\" && record.mount) continue;\n    if (record.parentId) continue;\n    const firstSegment = record.id.split(\"/\")[0] ?? \"\";\n    if (firstSegment.startsWith(\"_\")) {\n      const mount = resolveMountSegment(firstSegment.slice(1));\n      if (!mount) {\n        errors.push(\n          `unknown mount \"_${firstSegment.slice(1)}\" (${record.file}); known: ${Object.keys(MOUNT_REGISTRY).join(\", \")}`,\n        );\n      }\n    } else {\n      errors.push(\n        `route \"${record.id}\" (${record.file}) must live under a mount — root-level pathed routes have no gate`,\n      );\n    }\n  }\n\n  const siblingPathClaims = new Map<string, string>();\n  for (const record of routes) {\n    if (record.type === \"layout\" || record.path === undefined) continue;\n    const claimKey = `${record.parentId ?? \"\"}::${record.path}`;\n    const claimant = siblingPathClaims.get(claimKey);\n    if (claimant) {\n      errors.push(\n        `duplicate path \"${record.path}\" under \"${record.parentId ?? \"mount root\"}\": \"${claimant}\" and \"${record.id}\" (${record.file})`,\n      );\n      continue;\n    }\n    siblingPathClaims.set(claimKey, record.id);\n  }\n\n  if (errors.length > 0) {\n    throw new Error(`manifest generation failed for ${pluginName}:\\n  ${errors.join(\"\\n  \")}`);\n  }\n\n  const manifest: PluginManifest = PluginManifestSchema.parse({\n    name: pluginName,\n    manifestVersion: MANIFEST_VERSION,\n    routes,\n  });\n\n  const resolvedSrc = path.resolve(workspaceRoot, srcDir);\n  await mkdir(resolvedSrc, { recursive: true });\n  await writeIfChanged(\n    path.join(resolvedSrc, MANIFEST_FILENAME),\n    `${JSON.stringify(manifest, null, 2)}\\n`,\n  );\n\n  const loaderLines = routes\n    .filter((r) => r.file)\n    .map(\n      (r) =>\n        `  ${JSON.stringify(r.id)}: () => import(${JSON.stringify(importPathOf(r.file!))}).then((m) => pick(m.Route.options)),`,\n    );\n  const rootImport = `import { Route as __rootRoute } from ${JSON.stringify(importPathOf(rootRouteNode.filePath ?? \"__root\"))};`;\n\n  const routeConfigSource = `// Generated by manifest-gen. DO NOT EDIT.\n// Inputs: src/routes/** only.\nimport type { RouteConfigModule, RouteOptionsBundle } from ${JSON.stringify(typeImport)};\n\nconst pick = (o: any): RouteOptionsBundle => ({\n${ROUTE_OPTION_KEYS.map((key) => `  ${key}: o?.${key},`).join(\"\\n\")}\n});\n\n${rootImport}\n\nexport const routeConfigLoaders: RouteConfigModule[\"routeConfigLoaders\"] = {\n${loaderLines.join(\"\\n\")}\n};\n\nexport const rootMeta = pick(__rootRoute.options);\n`;\n\n  await writeIfChanged(path.join(resolvedSrc, ROUTE_CONFIG_FILENAME), routeConfigSource);\n\n  return manifest;\n}\n\n/**\n * Identical content is never re-written: the dev watcher is timestamp-based,\n * so an unconditional write re-triggers compilation — which runs this\n * generator again — an infinite regen loop.\n */\nasync function writeIfChanged(file: string, contents: string): Promise<void> {\n  const existing = await readFile(file, \"utf8\").catch(() => undefined);\n  if (existing === contents) return;\n  await writeFile(file, contents);\n}\n"],"mappings":"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"}

package/dist/ui/manifest/index.cjs

@@ -0,0 +1,35 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_identity = require('../../identity.cjs');
+const require_mount_registry = require('./mount-registry.cjs');
+const require_descriptor = require('./descriptor.cjs');
+const require_nav = require('./nav.cjs');
+const require_construct = require('./construct.cjs');
+const require_ui_manifest_contract = require('./contract.cjs');
+const require_manifest_schema = require('./manifest-schema.cjs');
+
+exports.App = require_descriptor.App;
+exports.CORE_UI_PLUGIN_KEY = require_ui_manifest_contract.CORE_UI_PLUGIN_KEY;
+exports.ComposePayloadSchema = require_manifest_schema.ComposePayloadSchema;
+exports.MANIFEST_FILENAME = require_ui_manifest_contract.MANIFEST_FILENAME;
+exports.MANIFEST_VERSION = require_manifest_schema.MANIFEST_VERSION;
+exports.MOUNTS = require_mount_registry.MOUNTS;
+exports.MOUNT_ALIASES = require_mount_registry.MOUNT_ALIASES;
+exports.MOUNT_REGISTRY = require_mount_registry.MOUNT_REGISTRY;
+exports.MOUNT_REGISTRY_VERSION = require_mount_registry.MOUNT_REGISTRY_VERSION;
+exports.ManifestSchema = require_manifest_schema.ManifestSchema;
+exports.PLUGIN_UI_SHARED_EXPOSES = require_ui_manifest_contract.PLUGIN_UI_SHARED_EXPOSES;
+exports.Plugin = require_descriptor.Plugin;
+exports.PluginManifestSchema = require_manifest_schema.PluginManifestSchema;
+exports.ROUTE_CONFIG_FILENAME = require_ui_manifest_contract.ROUTE_CONFIG_FILENAME;
+exports.RouteRecordSchema = require_manifest_schema.RouteRecordSchema;
+exports.SUPPORTED_MANIFEST_VERSION = require_manifest_schema.SUPPORTED_MANIFEST_VERSION;
+exports.UI_EXPOSES = require_ui_manifest_contract.UI_EXPOSES;
+exports.UI_REMOTE_ENTRY_FILENAME = require_ui_manifest_contract.UI_REMOTE_ENTRY_FILENAME;
+exports.UI_REMOTE_SERVER_ENTRY_FILENAME = require_ui_manifest_contract.UI_REMOTE_SERVER_ENTRY_FILENAME;
+exports.compareNavItems = require_nav.compareNavItems;
+exports.constructTree = require_construct.constructTree;
+exports.digestOf = require_descriptor.digestOf;
+exports.parsePluginManifest = require_manifest_schema.parsePluginManifest;
+exports.resolveApp = require_descriptor.resolveApp;
+exports.resolveMountSegment = require_mount_registry.resolveMountSegment;
+exports.sanitizeContainerName = require_identity.containerName;

package/dist/ui/manifest/index.d.cts

@@ -0,0 +1,9 @@
+import { containerName } from "../../identity.cjs";
+import { CORE_UI_PLUGIN_KEY, MANIFEST_FILENAME, PLUGIN_UI_SHARED_EXPOSES, ROUTE_CONFIG_FILENAME, UI_EXPOSES, UI_REMOTE_ENTRY_FILENAME, UI_REMOTE_SERVER_ENTRY_FILENAME } from "./contract.cjs";
+import { ComposePayload, ComposePayloadSchema, ComposeRemote, MANIFEST_VERSION, ManifestSchema, PluginManifest, PluginManifestSchema, RouteRecord, RouteRecordSchema, SUPPORTED_MANIFEST_VERSION, parsePluginManifest } from "./manifest-schema.cjs";
+import { NavDeclaration, NavItem, NavManifest, compareNavItems } from "./nav.cjs";
+import { RouteConfigModule, RouteConfigRef, RouteOptionsBundle } from "./route-config.cjs";
+import { ConstructInput, ConstructPluginRef, ConstructedTree, GateUser, HostContext, ResolvedPlugin, constructTree } from "./construct.cjs";
+import { App, AppInput, CompositionDigestInput, KnownPlugins, Plugin, PluginRef, PluginRefInput, RemoteSource, ResolvedApp, digestOf, resolveApp } from "./descriptor.cjs";
+import { MOUNTS, MOUNT_ALIASES, MOUNT_REGISTRY, MOUNT_REGISTRY_VERSION, MountDef, MountId, resolveMountSegment } from "./mount-registry.cjs";
+export { App, type AppInput, CORE_UI_PLUGIN_KEY, type ComposePayload, ComposePayloadSchema, type ComposeRemote, type CompositionDigestInput, type ConstructInput, type ConstructPluginRef, type ConstructedTree, type GateUser, type HostContext, type KnownPlugins, MANIFEST_FILENAME, MANIFEST_VERSION, MOUNTS, MOUNT_ALIASES, MOUNT_REGISTRY, MOUNT_REGISTRY_VERSION, ManifestSchema, type MountDef, type MountId, type NavDeclaration, type NavItem, type NavManifest, PLUGIN_UI_SHARED_EXPOSES, Plugin, type PluginManifest, PluginManifestSchema, type PluginRef, type PluginRefInput, ROUTE_CONFIG_FILENAME, type RemoteSource, type ResolvedApp, type ResolvedPlugin, type RouteConfigModule, type RouteConfigRef, type RouteOptionsBundle, type RouteRecord, RouteRecordSchema, SUPPORTED_MANIFEST_VERSION, UI_EXPOSES, UI_REMOTE_ENTRY_FILENAME, UI_REMOTE_SERVER_ENTRY_FILENAME, compareNavItems, constructTree, digestOf, parsePluginManifest, resolveApp, resolveMountSegment, containerName as sanitizeContainerName };

package/dist/ui/manifest/index.d.mts

@@ -0,0 +1,9 @@
+import { containerName } from "../../identity.mjs";
+import { CORE_UI_PLUGIN_KEY, MANIFEST_FILENAME, PLUGIN_UI_SHARED_EXPOSES, ROUTE_CONFIG_FILENAME, UI_EXPOSES, UI_REMOTE_ENTRY_FILENAME, UI_REMOTE_SERVER_ENTRY_FILENAME } from "./contract.mjs";
+import { ComposePayload, ComposePayloadSchema, ComposeRemote, MANIFEST_VERSION, ManifestSchema, PluginManifest, PluginManifestSchema, RouteRecord, RouteRecordSchema, SUPPORTED_MANIFEST_VERSION, parsePluginManifest } from "./manifest-schema.mjs";
+import { NavDeclaration, NavItem, NavManifest, compareNavItems } from "./nav.mjs";
+import { RouteConfigModule, RouteConfigRef, RouteOptionsBundle } from "./route-config.mjs";
+import { ConstructInput, ConstructPluginRef, ConstructedTree, GateUser, HostContext, ResolvedPlugin, constructTree } from "./construct.mjs";
+import { App, AppInput, CompositionDigestInput, KnownPlugins, Plugin, PluginRef, PluginRefInput, RemoteSource, ResolvedApp, digestOf, resolveApp } from "./descriptor.mjs";
+import { MOUNTS, MOUNT_ALIASES, MOUNT_REGISTRY, MOUNT_REGISTRY_VERSION, MountDef, MountId, resolveMountSegment } from "./mount-registry.mjs";
+export { App, type AppInput, CORE_UI_PLUGIN_KEY, type ComposePayload, ComposePayloadSchema, type ComposeRemote, type CompositionDigestInput, type ConstructInput, type ConstructPluginRef, type ConstructedTree, type GateUser, type HostContext, type KnownPlugins, MANIFEST_FILENAME, MANIFEST_VERSION, MOUNTS, MOUNT_ALIASES, MOUNT_REGISTRY, MOUNT_REGISTRY_VERSION, ManifestSchema, type MountDef, type MountId, type NavDeclaration, type NavItem, type NavManifest, PLUGIN_UI_SHARED_EXPOSES, Plugin, type PluginManifest, PluginManifestSchema, type PluginRef, type PluginRefInput, ROUTE_CONFIG_FILENAME, type RemoteSource, type ResolvedApp, type ResolvedPlugin, type RouteConfigModule, type RouteConfigRef, type RouteOptionsBundle, type RouteRecord, RouteRecordSchema, SUPPORTED_MANIFEST_VERSION, UI_EXPOSES, UI_REMOTE_ENTRY_FILENAME, UI_REMOTE_SERVER_ENTRY_FILENAME, compareNavItems, constructTree, digestOf, parsePluginManifest, resolveApp, resolveMountSegment, containerName as sanitizeContainerName };

package/dist/ui/manifest/index.mjs

@@ -0,0 +1,9 @@
+import { containerName } from "../../identity.mjs";
+import { MOUNTS, MOUNT_ALIASES, MOUNT_REGISTRY, MOUNT_REGISTRY_VERSION, resolveMountSegment } from "./mount-registry.mjs";
+import { App, Plugin, digestOf, resolveApp } from "./descriptor.mjs";
+import { compareNavItems } from "./nav.mjs";
+import { constructTree } from "./construct.mjs";
+import { CORE_UI_PLUGIN_KEY, MANIFEST_FILENAME, PLUGIN_UI_SHARED_EXPOSES, ROUTE_CONFIG_FILENAME, UI_EXPOSES, UI_REMOTE_ENTRY_FILENAME, UI_REMOTE_SERVER_ENTRY_FILENAME } from "./contract.mjs";
+import { ComposePayloadSchema, MANIFEST_VERSION, ManifestSchema, PluginManifestSchema, RouteRecordSchema, SUPPORTED_MANIFEST_VERSION, parsePluginManifest } from "./manifest-schema.mjs";
+
+export { App, CORE_UI_PLUGIN_KEY, ComposePayloadSchema, MANIFEST_FILENAME, MANIFEST_VERSION, MOUNTS, MOUNT_ALIASES, MOUNT_REGISTRY, MOUNT_REGISTRY_VERSION, ManifestSchema, PLUGIN_UI_SHARED_EXPOSES, Plugin, PluginManifestSchema, ROUTE_CONFIG_FILENAME, RouteRecordSchema, SUPPORTED_MANIFEST_VERSION, UI_EXPOSES, UI_REMOTE_ENTRY_FILENAME, UI_REMOTE_SERVER_ENTRY_FILENAME, compareNavItems, constructTree, digestOf, parsePluginManifest, resolveApp, resolveMountSegment, containerName as sanitizeContainerName };