@zenbujs/core 0.0.5 → 0.0.8

package/dist/{link-c0_aLWQ3.mjs → link-glX89NV5.mjs}

@@ -1,7 +1,12 @@
-import { t as loadConfig } from "./load-config-xMf2wxH8.mjs";
+import { n as __exportAll } from "./chunk-DsiFFCwN.mjs";
+import { t as loadConfig } from "./load-config-C4Oe2qZO.mjs";
 import fs from "node:fs";
 import path from "node:path";
 //#region src/cli/commands/link.ts
+var link_exports = /* @__PURE__ */ __exportAll({
+	linkProject: () => linkProject,
+	runLink: () => runLink
+});
 const CONFIG_NAMES = [
 	"zenbu.config.ts",
 	"zenbu.config.mts",
@@ -79,13 +84,7 @@ function resolveRegistryDir(opts) {
 	if (opts.manifest.devAppPath) return path.resolve(manifestDir, opts.manifest.devAppPath, "types");
 	const appRoot = findAppRoot(manifestDir);
 	if (appRoot) return path.join(appRoot, "types");
-	console.error(`zen link: could not determine target types directory for ${opts.manifestPath}.`);
-	console.error(`         Try one of:`);
-	console.error(`         - run from inside an app dir (with a zenbu.config.ts),`);
-	console.error(`         - add a "devAppPath" field to ${path.basename(opts.manifestPath)} pointing at the host app,`);
-	console.error(`         - create a tsconfig.local.json with a "#registry/*" path mapping,`);
-	console.error(`         - or pass --registry <dir>.`);
-	process.exit(1);
+	throw new Error(`zen link: could not determine target types directory for ${opts.manifestPath}.\n         Try one of:\n         - run from inside an app dir (with a zenbu.config.ts),\n         - add a "devAppPath" field to ${path.basename(opts.manifestPath)} pointing at the host app,\n         - create a tsconfig.local.json with a "#registry/*" path mapping,\n         - or pass --registry <dir>.`);
 }
 function expandGlob(baseDir, pattern) {
 	if (!pattern.includes("*")) {
@@ -103,15 +102,12 @@ function expandGlob(baseDir, pattern) {
 }
 function discoverServices(baseDir, serviceGlobs) {
 	const entries = [];
-	const classRe = /export\s+class\s+(\w+)\s+extends\s+(?:Service\b|serviceWithDeps\s*\()/;
-	const keyRe = /static\s+key\s*=\s*["']([^"']+)["']/;
+	const classKeyRe = /export\s+class\s+(\w+)\s+extends\s+Service\.create\s*\(\s*\{[\s\S]*?\bkey\s*:\s*["']([^"']+)["']/;
 	for (const glob of serviceGlobs) for (const filePath of expandGlob(baseDir, glob)) {
-		const content = fs.readFileSync(filePath, "utf8");
-		const classMatch = content.match(classRe);
-		const keyMatch = content.match(keyRe);
-		if (classMatch && keyMatch) entries.push({
-			className: classMatch[1],
-			key: keyMatch[1],
+		const match = fs.readFileSync(filePath, "utf8").match(classKeyRe);
+		if (match) entries.push({
+			className: match[1],
+			key: match[2],
 			filePath
 		});
 	}
@@ -150,7 +146,7 @@ function generateServicesFile(registryDir, allServices) {
 	return [
 		"// Generated by: zen link",
 		"",
-		`import type { CoreServiceRouter } from "@zenbujs/core/registry"`,
+		`import type { CoreServiceRouter } from "@zenbujs/core/registry-generated"`,
 		...imports,
 		"",
 		`type ServiceBase =\n${SERVICE_BASE_LITERAL}`,
@@ -190,7 +186,7 @@ function generatePreloadsFile(registryDir, allPreloads) {
 	return [
 		"// Generated by: zen link",
 		"",
-		`import type { CorePreloads } from "@zenbujs/core/registry"`,
+		`import type { CorePreloads } from "@zenbujs/core/registry-generated"`,
 		...imports,
 		"",
 		"export type PluginPreloads = {",
@@ -220,7 +216,7 @@ function generateEventsFile(registryDir, allEvents) {
 	return [
 		"// Generated by: zen link",
 		"",
-		`import type { CoreEvents } from "@zenbujs/core/registry"`,
+		`import type { CoreEvents } from "@zenbujs/core/registry-generated"`,
 		...imports,
 		"",
 		"/**",
@@ -245,6 +241,7 @@ function generateRegisterFile() {
 	return [
 		"// Generated by: zen link",
 		"",
+		`import type {} from "@zenbujs/core/registry"`,
 		`import type { DbRoot } from "./db-sections"`,
 		`import type { ServiceRouter } from "./services"`,
 		`import type { PluginEvents } from "./events"`,
@@ -280,7 +277,7 @@ function generateDbSectionsFile(registryDir, allSchemas) {
 	return [
 		"// Generated by: zen link",
 		"",
-		`import type { CoreDbSections } from "@zenbujs/core/registry"`,
+		`import type { CoreDbSections } from "@zenbujs/core/registry-generated"`,
 		...imports,
 		"",
 		"export type PluginDbSections = {",
@@ -367,18 +364,26 @@ function parseLinkArgs(argv) {
 	let manifestArg = null;
 	let typesConfigArg = null;
 	let registryOverride = null;
+	let surfaceOutArg = null;
+	let augmentOutArg = null;
 	for (let i = 0; i < argv.length; i++) {
 		const arg = argv[i];
 		if (arg === "--registry" && i + 1 < argv.length) registryOverride = argv[++i];
 		else if (arg.startsWith("--registry=")) registryOverride = arg.slice(11);
 		else if (arg === "--types-config" && i + 1 < argv.length) typesConfigArg = argv[++i];
 		else if (arg.startsWith("--types-config=")) typesConfigArg = arg.slice(15);
+		else if (arg === "--out" && i + 1 < argv.length) surfaceOutArg = argv[++i];
+		else if (arg.startsWith("--out=")) surfaceOutArg = arg.slice(6);
+		else if (arg === "--augment-out" && i + 1 < argv.length) augmentOutArg = argv[++i];
+		else if (arg.startsWith("--augment-out=")) augmentOutArg = arg.slice(14);
 		else if (!arg.startsWith("-") && !manifestArg) manifestArg = arg;
 	}
 	return {
 		manifestArg,
 		typesConfigArg,
-		registryOverride
+		registryOverride,
+		surfaceOutArg,
+		augmentOutArg
 	};
 }
 /**
@@ -386,26 +391,27 @@ function parseLinkArgs(argv) {
 * export is a `definePlugin({...})`). Resolved upstream by `loadConfig` so
 * we just consume the resolved record here.
 */
-function linkResolvedPlugin(plugin, existing) {
-	console.log(`Linking types "${plugin.name}" from ${plugin.dir}`);
+function linkResolvedPlugin(plugin, existing, opts) {
+	const log = opts.quiet ? () => {} : (msg) => console.log(msg);
+	log(`Linking types "${plugin.name}" from ${plugin.dir}`);
 	const serviceGlobs = plugin.services.map((abs) => path.relative(plugin.dir, abs).split(path.sep).join("/"));
 	const serviceEntries = discoverServices(plugin.dir, serviceGlobs);
-	console.log(`  Found ${serviceEntries.length} service(s)`);
+	log(`  Found ${serviceEntries.length} service(s)`);
 	const schemaEntry = plugin.schemaPath ? {
 		name: plugin.name,
 		schemaPath: plugin.schemaPath
 	} : null;
-	if (schemaEntry) console.log(`  Schema: ${schemaEntry.schemaPath}`);
+	if (schemaEntry) log(`  Schema: ${schemaEntry.schemaPath}`);
 	const preloadEntry = plugin.preloadPath ? {
 		name: plugin.name,
 		preloadPath: plugin.preloadPath
 	} : null;
-	if (preloadEntry) console.log(`  Preload: ${preloadEntry.preloadPath}`);
+	if (preloadEntry) log(`  Preload: ${preloadEntry.preloadPath}`);
 	const eventsEntry = plugin.eventsPath ? {
 		name: plugin.name,
 		eventsPath: plugin.eventsPath
 	} : null;
-	if (eventsEntry) console.log(`  Events: ${eventsEntry.eventsPath}`);
+	if (eventsEntry) log(`  Events: ${eventsEntry.eventsPath}`);
 	existing.services.set(plugin.name, serviceEntries);
 	if (schemaEntry) existing.schemas.set(plugin.name, schemaEntry);
 	if (preloadEntry) existing.preloads.set(plugin.name, preloadEntry);
@@ -414,39 +420,116 @@ function linkResolvedPlugin(plugin, existing) {
 	else existing.events.delete(plugin.name);
 }
 /**
-* Variant for the framework-internal `--types-config <path>` flow where the
-* input is a small JSON file (e.g. `packages/core/zenbu-types.config.json`).
-* Used by `pnpm link:types` inside core to bake its own services/registry
-* types without going through a `zenbu.config.ts`.
+* Generator: `<core>/src/registry-generated.ts` — the publishable
+* type surface that downstream apps' `zen link`-generated files
+* import from `@zenbujs/core/registry-generated`.
+*
+* Imports use public package exports (`@zenbujs/core/services`,
+* `/events`, `/schema`) so the file resolves in any consumer
+* regardless of how `@zenbujs/core` is installed.
 */
-function linkTypesConfig(jsonPath, existing) {
-	const manifest = JSON.parse(fs.readFileSync(jsonPath, "utf8"));
-	const pluginName = manifest.name;
-	const baseDir = path.dirname(jsonPath);
-	console.log(`Linking types "${pluginName}" from ${baseDir}`);
-	const serviceEntries = discoverServices(baseDir, manifest.services ?? []);
-	console.log(`  Found ${serviceEntries.length} service(s)`);
-	const schemaEntry = manifest.schema ? {
-		name: pluginName,
-		schemaPath: path.resolve(baseDir, manifest.schema)
-	} : null;
-	if (schemaEntry) console.log(`  Schema: ${schemaEntry.schemaPath}`);
-	const preloadEntry = manifest.preload ? {
-		name: pluginName,
-		preloadPath: path.resolve(baseDir, manifest.preload)
-	} : null;
-	if (preloadEntry) console.log(`  Preload: ${preloadEntry.preloadPath}`);
-	const eventsEntry = manifest.events ? {
-		name: pluginName,
-		eventsPath: path.resolve(baseDir, manifest.events)
-	} : null;
-	if (eventsEntry) console.log(`  Events: ${eventsEntry.eventsPath}`);
-	existing.services.set(pluginName, serviceEntries);
-	if (schemaEntry) existing.schemas.set(pluginName, schemaEntry);
-	if (preloadEntry) existing.preloads.set(pluginName, preloadEntry);
-	else existing.preloads.delete(pluginName);
-	if (eventsEntry) existing.events.set(pluginName, eventsEntry);
-	else existing.events.delete(pluginName);
+function generateCoreSurfaceFile(args) {
+	const sorted = [...args.services].sort((a, b) => a.className.localeCompare(b.className));
+	const importedNames = sorted.map((s) => `  ${s.className},`).join("\n");
+	const routerEntries = sorted.map((s) => {
+		return `  ${/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(s.key) ? s.key : `"${s.key}"`}: ExtractRpcMethods<${s.className}>;`;
+	}).join("\n");
+	const lines = [
+		"// Generated by: pnpm link:types",
+		"// DO NOT EDIT. Regenerated automatically (also wired into `prebuild`).",
+		""
+	];
+	if (sorted.length > 0) {
+		lines.push("import type {");
+		lines.push(importedNames);
+		lines.push(`} from "@zenbujs/core/services"`);
+	}
+	if (args.hasEvents) lines.push(`import type { Events as Events_core } from "@zenbujs/core/events"`);
+	if (args.hasSchema) lines.push(`import type { SchemaRoot as SchemaRoot_core } from "@zenbujs/core/schema"`);
+	lines.push("");
+	lines.push(`type ServiceBase =\n${SERVICE_BASE_LITERAL}`);
+	lines.push("");
+	lines.push("type ExtractRpcMethods<T> = {");
+	lines.push("  [K in Exclude<keyof T, ServiceBase | `_${string}`> as T[K] extends (");
+	lines.push("    ...args: any[]");
+	lines.push("  ) => any");
+	lines.push("    ? K");
+	lines.push("    : never]: T[K]");
+	lines.push("}");
+	lines.push("");
+	lines.push("export type CoreServiceRouter = {");
+	if (routerEntries.length > 0) lines.push(routerEntries);
+	lines.push("}");
+	lines.push("");
+	lines.push(`export type CoreEvents = ${args.hasEvents ? "Events_core" : "{}"}`);
+	lines.push("");
+	lines.push("export type CoreDbSections = {");
+	if (args.hasSchema) lines.push("  core: SchemaRoot_core;");
+	lines.push("}");
+	lines.push("");
+	lines.push("export type CorePreloads = {}");
+	lines.push("");
+	return lines.join("\n");
+}
+/**
+* Generator: `<core>/types/zenbu-register.ts` — local-only
+* augmentation that drives core's OWN typecheck. Pulls
+* `Core*` types from the relative path `../src/registry-generated`
+* (so it works without depending on package self-resolution) and
+* declares the `ZenbuRegister` augmentation. NOT in
+* `package.json#files`; never reaches downstream consumers (where
+* it would conflict with their own augmentation).
+*/
+function generateCoreAugmentFile() {
+	return [
+		"// Generated by: pnpm link:types",
+		"// DO NOT EDIT. Local-only augmentation (NOT shipped via package.json#files).",
+		"// Drives core's own typecheck so useRpc()/useEvents()/useDb() resolve",
+		"// to the registered surface inside packages/core/src/.",
+		"",
+		`import type {} from "@zenbujs/core/registry"`,
+		`import type {`,
+		`  CoreServiceRouter,`,
+		`  CoreEvents,`,
+		`  CoreDbSections,`,
+		`} from "../src/registry-generated"`,
+		"",
+		`declare module "@zenbujs/core/registry" {`,
+		"  interface ZenbuRegister {",
+		"    rpc: CoreServiceRouter",
+		"    events: CoreEvents",
+		"    db: { plugin: CoreDbSections }",
+		"  }",
+		"}",
+		"",
+		"export {}",
+		""
+	].join("\n");
+}
+/**
+* Two-file write for the `--types-config` flow: the publishable
+* surface (`registry-generated.ts`) plus the local-only
+* augmentation (`zenbu-register.ts`). Skips writes when content is
+* identical so downstream watchers (Vite, tsc --watch) don't see
+* spurious mtime bumps.
+*/
+function writeCoreSurfaceFiles(args) {
+	const surface = generateCoreSurfaceFile({
+		services: args.services,
+		hasEvents: args.hasEvents,
+		hasSchema: args.hasSchema
+	});
+	const augment = generateCoreAugmentFile();
+	for (const [target, body] of [[args.surfaceOut, surface], [args.augmentOut, augment]]) {
+		fs.mkdirSync(path.dirname(target), { recursive: true });
+		let prev = null;
+		try {
+			prev = fs.readFileSync(target, "utf8");
+		} catch {}
+		if (prev === body) continue;
+		fs.writeFileSync(target, body);
+		if (!args.quiet) console.log(`  Wrote ${target}`);
+	}
 }
 /**
 * Per-install bootstrap for a plugin. The plugin ships a portable
@@ -472,7 +555,7 @@ function linkTypesConfig(jsonPath, existing) {
 * `"extends": "./tsconfig.local.json"`. The generated file then carries
 * `paths` + `include`, which TS merges into the IDE's resolved program.
 */
-function writePluginTsconfigLocal(pluginDir, registryDir) {
+function writePluginTsconfigLocal(pluginDir, registryDir, opts) {
 	const ownTsconfig = path.join(pluginDir, "tsconfig.json");
 	if (!fs.existsSync(ownTsconfig)) return;
 	for (const name of CONFIG_NAMES) if (fs.existsSync(path.join(pluginDir, name))) return;
@@ -490,23 +573,67 @@ function writePluginTsconfigLocal(pluginDir, registryDir) {
 	} catch {}
 	if (prev === next) return;
 	fs.writeFileSync(target, next);
-	console.log(`  Wrote ${target}`);
+	if (!opts.quiet) console.log(`  Wrote ${target}`);
+}
+/**
+* Programmatic variant of `zen link` for the host-project flow. Throws on
+* any error instead of `process.exit`. Used by:
+*   - `runLink` (CLI entry)
+*   - `link-watcher.ts` (file watcher used by `zen dev`)
+*
+* `quiet: true` suppresses the per-step console output the CLI emits — the
+* watcher uses this so the dev terminal stays clean across rapid edits.
+*/
+async function linkProject(projectDir, opts = {}) {
+	const log = opts.quiet ? () => {} : (msg) => console.log(msg);
+	const { resolved, pluginSourceFiles } = await loadConfig(projectDir);
+	const registryDir = resolveRegistryDir({
+		manifestPath: resolved.configPath,
+		manifest: {},
+		registryOverride: opts.registryOverride ?? null
+	});
+	log(`Registry: ${registryDir}`);
+	fs.mkdirSync(registryDir, { recursive: true });
+	const existing = readExistingRegistry(registryDir);
+	for (const plugin of resolved.plugins) linkResolvedPlugin(plugin, existing, { quiet: !!opts.quiet });
+	writeRegistryFiles(registryDir, existing, { quiet: !!opts.quiet });
+	for (const plugin of resolved.plugins) writePluginTsconfigLocal(plugin.dir, registryDir, { quiet: !!opts.quiet });
+	return {
+		registryDir,
+		resolvedConfigPath: resolved.configPath,
+		pluginSourceFiles,
+		resolved
+	};
 }
 async function runLink(argv) {
-	const { manifestArg, typesConfigArg, registryOverride } = parseLinkArgs(argv);
+	const { manifestArg, typesConfigArg, registryOverride, surfaceOutArg, augmentOutArg } = parseLinkArgs(argv);
 	if (typesConfigArg) {
 		const typeConfigPath = path.resolve(typesConfigArg);
-		const registryDir = resolveRegistryDir({
-			manifestPath: typeConfigPath,
-			manifest: JSON.parse(fs.readFileSync(typeConfigPath, "utf8")),
-			registryOverride
-		});
-		console.log(`Registry: ${registryDir}`);
-		fs.mkdirSync(registryDir, { recursive: true });
-		const existing = readExistingRegistry(registryDir);
-		linkTypesConfig(typeConfigPath, existing);
-		writeRegistryFiles(registryDir, existing);
-		console.log("Done.");
+		const rootManifest = JSON.parse(fs.readFileSync(typeConfigPath, "utf8"));
+		const baseDir = path.dirname(typeConfigPath);
+		const surfaceOut = surfaceOutArg ? path.resolve(surfaceOutArg) : path.join(baseDir, "src", "registry-generated.ts");
+		const augmentOut = augmentOutArg ? path.resolve(augmentOutArg) : path.join(baseDir, "types", "zenbu-register.ts");
+		try {
+			console.log(`Linking core types from ${baseDir}`);
+			const services = discoverServices(baseDir, rootManifest.services ?? []);
+			console.log(`  Found ${services.length} service(s)`);
+			const hasEvents = !!rootManifest.events;
+			const hasSchema = !!rootManifest.schema;
+			if (rootManifest.events) console.log(`  Events: ${path.resolve(baseDir, rootManifest.events)}`);
+			if (rootManifest.schema) console.log(`  Schema: ${path.resolve(baseDir, rootManifest.schema)}`);
+			writeCoreSurfaceFiles({
+				services,
+				hasEvents,
+				hasSchema,
+				surfaceOut,
+				augmentOut,
+				quiet: false
+			});
+			console.log("Done.");
+		} catch (err) {
+			console.error(err instanceof Error ? err.message : err);
+			process.exit(1);
+		}
 		return;
 	}
 	const projectDir = manifestArg ? path.resolve(manifestArg) : findProjectDir(process.cwd());
@@ -515,21 +642,15 @@ async function runLink(argv) {
 		console.error("          For internal framework types, pass --types-config <path>.");
 		process.exit(1);
 	}
-	const { resolved } = await loadConfig(projectDir);
-	const registryDir = resolveRegistryDir({
-		manifestPath: resolved.configPath,
-		manifest: {},
-		registryOverride
-	});
-	console.log(`Registry: ${registryDir}`);
-	fs.mkdirSync(registryDir, { recursive: true });
-	const existing = readExistingRegistry(registryDir);
-	for (const plugin of resolved.plugins) linkResolvedPlugin(plugin, existing);
-	writeRegistryFiles(registryDir, existing);
-	for (const plugin of resolved.plugins) writePluginTsconfigLocal(plugin.dir, registryDir);
-	console.log("Done.");
+	try {
+		await linkProject(projectDir, { registryOverride });
+		console.log("Done.");
+	} catch (err) {
+		console.error(err instanceof Error ? err.message : err);
+		process.exit(1);
+	}
 }
-function writeRegistryFiles(registryDir, existing) {
+function writeRegistryFiles(registryDir, existing, opts) {
 	const writes = [
 		["services.ts", generateServicesFile(registryDir, existing.services)],
 		["db-sections.ts", generateDbSectionsFile(registryDir, existing.schemas)],
@@ -539,9 +660,14 @@ function writeRegistryFiles(registryDir, existing) {
 	];
 	for (const [name, body] of writes) {
 		const target = path.join(registryDir, name);
+		let prev = null;
+		try {
+			prev = fs.readFileSync(target, "utf8");
+		} catch {}
+		if (prev === body) continue;
 		fs.writeFileSync(target, body);
-		console.log(`  Wrote ${target}`);
+		if (!opts.quiet) console.log(`  Wrote ${target}`);
 	}
 }
 //#endregion
-export { runLink };
+export { link_exports as n, linkProject as t };

package/dist/{load-config-xMf2wxH8.mjs → load-config-C4Oe2qZO.mjs}

@@ -1,5 +1,5 @@
 import { n as __exportAll } from "./chunk-DsiFFCwN.mjs";
-import { i as resolveBuildConfig } from "./build-config-C3a-o3_B.mjs";
+import { i as resolveBuildConfig } from "./build-config-pWdmLnrk.mjs";
 import { createRequire } from "node:module";
 import fs from "node:fs";
 import path from "node:path";
@@ -114,6 +114,8 @@ async function loadConfig(projectDir) {
 	})()?.isDirectory()) throw new Error(`${configPath}: uiEntrypoint must point at a directory; got ${config.uiEntrypoint}.`);
 	const splashPath = path.join(uiEntrypointPath, "splash.html");
 	if (!fs.existsSync(splashPath)) throw new Error(`${configPath}: uiEntrypoint directory ${config.uiEntrypoint} is missing required \`splash.html\`. The splash file is shown raw (no Vite) during the brief window between Electron startup and the app's first paint.`);
+	const installingCandidate = path.join(uiEntrypointPath, "installing.html");
+	const installingPath = fs.existsSync(installingCandidate) ? installingCandidate : void 0;
 	const plugins = [];
 	const pluginSourceFiles = [];
 	for (const entry of config.plugins) {
@@ -128,8 +130,10 @@ async function loadConfig(projectDir) {
 			dbPath,
 			uiEntrypointPath,
 			splashPath,
+			installingPath,
 			plugins,
 			build: resolveBuildConfig(config.build ?? {
+				hostVersion: "0.0.0",
 				source: ".",
 				include: ["**/*"]
 			})

package/dist/loaders/zenbu.mjs

@@ -15,6 +15,13 @@ const stats = {
 let resolvedPayload = null;
 let resolvedPluginSourceFiles = [];
 /**
+* Set of absolute service file paths derived from the resolved payload.
+* Used by the `file://` branch in `load()` to decide which user files
+* should have `runtime.register(...)` auto-injected. Refreshed alongside
+* `resolvedPayload` whenever the loader picks up a new config snapshot.
+*/
+let serviceFileSet = /* @__PURE__ */ new Set();
+/**
 * Number of times we've materialized the plugin root since boot. 
 */
 let pluginsRootInvocations = 0;
@@ -22,6 +29,7 @@ function initialize(data) {
 	if (data?.payload) {
 		resolvedPayload = data.payload;
 		resolvedPluginSourceFiles = data.pluginSourceFiles ?? [];
+		serviceFileSet = collectServiceFiles(data.payload);
 	}
 	if (data?.tracePort) {
 		tracePort = data.tracePort;
@@ -54,6 +62,86 @@ function buildSource(imports) {
 	return imports.map((specifier) => `import ${JSON.stringify(specifier)}\n`).join("");
 }
 /**
+* Matches the canonical service declaration shape after the upstream HMR
+* loader (dynohot) has transformed the module. Dynohot strips the
+* `export` keyword and minifies the source, so the regex must not
+* require `export` and must tolerate a non-whitespace separator (e.g.
+* `;class Foo extends Service.create(...)`). The `\b` boundary still
+* rejects `subclass Foo` matches inside identifiers/comments.
+*
+*     export class FooService extends Service.create({ ... }) { ... }
+*     ;class FooService extends Service.create({...}) {...}        // post-dynohot
+*
+* `zen link` runs on the original on-disk source (pre-dynohot), so it
+* keeps the `export` requirement in `discoverServices` to avoid matching
+* non-exported helper classes.
+*/
+const SERVICE_CLASS_RE = /\bclass\s+(\w+)\s+extends\s+Service\.create\s*\(/g;
+/**
+* Decode the loader's `source` payload (which Node permits as string,
+* Buffer, ArrayBuffer, or any TypedArray) into a plain UTF-8 string.
+*/
+function decodeSource(source) {
+	if (typeof source === "string") return source;
+	if (source instanceof Uint8Array) return Buffer.from(source).toString("utf8");
+	if (source instanceof ArrayBuffer) return Buffer.from(source).toString("utf8");
+	return String(source);
+}
+/**
+* Tail-append a `runtime.register(<Class>, import.meta)` call to the
+* loader result so user service files don't have to carry the boilerplate.
+*
+* - Idempotent: if the source already contains `runtime.register(`
+*   (manual migration leftover, or a user choosing to register
+*   explicitly), we leave it untouched.
+* - Errors loudly when zero or multiple service classes are found, since
+*   the runtime's HMR model is "one slot per import.meta".
+* - The runtime singleton imported here resolves through the loader's
+*   own `@zenbujs/core` short-circuit in `resolve()`, so the registered
+*   class lands in the same registry the rest of the framework reads.
+*/
+function appendAutoRegister(downstream, filePath) {
+	if (!downstream || typeof downstream !== "object") return downstream;
+	const result = downstream;
+	if (result.format !== "module") return downstream;
+	if (result.source == null) return downstream;
+	const source = decodeSource(result.source);
+	if (/\bruntime\s*\.\s*register\s*\(/.test(source)) return {
+		...result,
+		source
+	};
+	SERVICE_CLASS_RE.lastIndex = 0;
+	const matches = [...source.matchAll(SERVICE_CLASS_RE)];
+	if (matches.length === 0) throw new Error(`[zenbu-loader] auto-register: no \`class <Name> extends Service.create({ ... })\` found in ${filePath}.\n         Either rewrite the class to use Service.create or add an explicit \`runtime.register(<Class>, import.meta)\`.`);
+	if (matches.length > 1) {
+		const names = matches.map((m) => m[1]).join(", ");
+		throw new Error(`[zenbu-loader] auto-register: ${matches.length} service classes (${names}) in ${filePath}.\n         The HMR model is one service per file; split into separate files.`);
+	}
+	const tail = `\n;import { runtime as __zenbu_runtime__ } from "@zenbujs/core/runtime";\n__zenbu_runtime__.register(${matches[0][1]}, import.meta);\n`;
+	return {
+		...result,
+		source: source + tail
+	};
+}
+/**
+* Expand each plugin's `services` glob list into a flat set of absolute
+* file paths. Consulted by the `file://` branch in `load()` to decide
+* whether to auto-inject `runtime.register(...)` for the loaded module.
+*
+* Glob expansion uses the same `expandGlob` (and therefore the same
+* `fs.readdirSync` snapshot) that `buildPluginBarrel` uses, so the set
+* stays in lockstep with what the barrel actually imports.
+*/
+function collectServiceFiles(payload) {
+	const set = /* @__PURE__ */ new Set();
+	for (const plugin of payload.plugins) for (const entry of plugin.services) {
+		const resolved = path.isAbsolute(entry) ? entry : path.resolve(plugin.dir, entry);
+		if (resolved.includes("*")) for (const f of expandGlob(resolved)) set.add(f);
+		else set.add(resolved);
+	}
+	return set;
+}
+/**
 * Read the resolved config from the process global. setup-gate populates
 * this before registering our loader, so by the time `load()` is invoked
 * the snapshot is always present.
@@ -99,6 +187,7 @@ function getResolvedConfig(configPath) {
 	const fresh = resolveConfigViaSubprocess(path.dirname(configPath));
 	resolvedPayload = fresh.payload;
 	resolvedPluginSourceFiles = fresh.pluginSourceFiles;
+	serviceFileSet = collectServiceFiles(fresh.payload);
 	return fresh;
 }
 /**
@@ -243,6 +332,19 @@ function loadImpl(url, context, nextLoad) {
 			shortCircuit: true
 		};
 	}
+	if (url.startsWith("file://")) {
+		let filePath;
+		try {
+			filePath = fileURLToPath(url);
+		} catch {
+			filePath = "";
+		}
+		if (filePath && serviceFileSet.has(filePath)) {
+			const downstream = nextLoad(url, context);
+			if (downstream && typeof downstream.then === "function") return Promise.resolve(downstream).then((r) => appendAutoRegister(r, filePath));
+			return appendAutoRegister(downstream, filePath);
+		}
+	}
 	if (url.startsWith("zenbu:barrel?")) {
 		const params = new URL(url).searchParams;
 		const pluginRaw = decodeURIComponent(params.get("plugin") ?? "");

package/dist/node-loader.mjs

@@ -1,4 +1,4 @@
-import { n as require_lib, t as zenbuAdviceTransform } from "./transform-CmFYPmt8.mjs";
+import { n as require_lib, t as zenbuAdviceTransform } from "./transform-BzrwkEdf.mjs";
 import { fileURLToPath } from "node:url";
 //#region ../advice/src/node-loader.ts
 var import_lib = require_lib();

package/dist/{publish-source-Dill72NS.mjs → publish-source-Dq2c0iOw.mjs}

@@ -1,5 +1,5 @@
-import { t as loadConfig } from "./load-config-xMf2wxH8.mjs";
-import { n as init, r as push } from "./mirror-sync-PDzxhf1w.mjs";
+import { t as loadConfig } from "./load-config-C4Oe2qZO.mjs";
+import { n as init, r as push } from "./mirror-sync-pYU6f3-c.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import { execFileSync } from "node:child_process";