@ubean/islands 0.1.8 → 0.1.9

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { UbeanIslandsPluginOptions, transformVueSfcIslands, ubeanIslandsPlugin } from "./vite.js";
+import { ISLANDS_REGISTRY_VIRTUAL_ID, IslandComponentEntry, IslandComponentMap, UbeanIslandsPluginOptions, collectIslandComponents, generateRegistryModule, parseScriptImports, resolveIslandImportPath, scanIslandDirectiveNames, transformVueSfcIslands, ubeanIslandsPlugin } from "./vite.js";
 //#region src/types.d.ts
 type ClientDirective = 'client:load' | 'client:idle' | 'client:visible' | 'client:media' | 'client:only';
 interface IslandDefinition {
@@ -37,4 +37,4 @@ declare const hydrationStrategyMeta: Record<ClientDirective, {
 declare function getIslandsBootstrapScript(): string;
 declare function getIslandsClearScript(): string;
 //#endregion
-export { type ClientDirective, type ClientHydrationStrategy, type IslandDefinition, type IslandSsrOptions, type IslandsContext, type UbeanIslandsPluginOptions, createIslandsContext, generateIslandPlaceholder, getIslandsBootstrapScript, getIslandsClearScript, getIslandsScript, hydrationStrategyMeta, registerIsland, renderIslandPlaceholder, transformVueSfcIslands, ubeanIslandsPlugin };
+export { type ClientDirective, type ClientHydrationStrategy, ISLANDS_REGISTRY_VIRTUAL_ID, type IslandComponentEntry, type IslandComponentMap, type IslandDefinition, type IslandSsrOptions, type IslandsContext, type UbeanIslandsPluginOptions, collectIslandComponents, createIslandsContext, generateIslandPlaceholder, generateRegistryModule, getIslandsBootstrapScript, getIslandsClearScript, getIslandsScript, hydrationStrategyMeta, parseScriptImports, registerIsland, renderIslandPlaceholder, resolveIslandImportPath, scanIslandDirectiveNames, transformVueSfcIslands, ubeanIslandsPlugin };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { transformVueSfcIslands, ubeanIslandsPlugin } from "./vite.js";
+import { ISLANDS_REGISTRY_VIRTUAL_ID, collectIslandComponents, generateRegistryModule, parseScriptImports, resolveIslandImportPath, scanIslandDirectiveNames, transformVueSfcIslands, ubeanIslandsPlugin } from "./vite.js";
 //#region src/types.ts
 function createIslandsContext() {
 	return {
@@ -65,4 +65,4 @@ function getIslandsClearScript() {
 	return `(function(){function clearIslands(){var islands=document.querySelectorAll('ubean-island[data-island-id]');islands.forEach(function(el){if(el.getAttribute('data-directive')!=='client:only'){return}el.innerHTML='';el.setAttribute('data-cleared','true')})}if(document.readyState==='loading'){document.addEventListener('DOMContentLoaded',clearIslands)}else{clearIslands()}})();`;
 }
 //#endregion
-export { createIslandsContext, generateIslandPlaceholder, getIslandsBootstrapScript, getIslandsClearScript, getIslandsScript, hydrationStrategyMeta, registerIsland, renderIslandPlaceholder, transformVueSfcIslands, ubeanIslandsPlugin };
+export { ISLANDS_REGISTRY_VIRTUAL_ID, collectIslandComponents, createIslandsContext, generateIslandPlaceholder, generateRegistryModule, getIslandsBootstrapScript, getIslandsClearScript, getIslandsScript, hydrationStrategyMeta, parseScriptImports, registerIsland, renderIslandPlaceholder, resolveIslandImportPath, scanIslandDirectiveNames, transformVueSfcIslands, ubeanIslandsPlugin };

package/dist/runtime.js

@@ -120,6 +120,8 @@ function hydrateIslands(options = {}) {
 function resolveComponent(name, components, getComponent) {
 	if (components[name]) return components[name];
 	if (getComponent) return getComponent(name);
+	const registered = Object.keys(components);
+	console.warn(`[ubean:islands] Island component "${name}" not found in registry.\nPossible causes:\n  1. Component is globally registered or dynamically imported — pass it via hydrateIslands({ components: { ${name}: YourComp } })\n  2. Component name mismatch between template tag and import\n  3. Component is auto-imported by unplugin-vue-components (no static import → not in auto-registry)\nRegistered components: ${registered.length > 0 ? registered.join(", ") : "(none)"}`);
 	return null;
 }
 //#endregion

package/dist/virtual-registry.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `virtual:ubean-islands-registry` 的 TypeScript 类型声明。
+ *
+ * 此虚拟模块由 `ubeanIslandsPlugin` 在构建/开发期生成,导出扫描到的 island 组件注册表。
+ * 详见 `docs/islands-auto-registry.md`（方案 C）。
+ *
+ * 用户项目通常无需手动引用此声明 —— 只要 `tsconfig.json` 的 `include` 涵盖了
+ * `node_modules/@ubean/islands/dist/**`,TypeScript 会自动发现此 ambient 声明。
+ * 若未自动发现,可在项目的 `env.d.ts` 中添加:
+ * ```ts
+ * /// <reference types="@ubean/islands" />
+ * ```
+ * 或手动声明 `declare module 'virtual:ubean-islands-registry'`。
+ */
+declare module 'virtual:ubean-islands-registry' {
+  import type { Component } from 'vue';
+  /**
+   * 自动扫描得到的 island 组件注册表。
+   *
+   * - key:模板中使用的组件标签名(如 `<IslandCounter client:load />` 中的 `IslandCounter`)
+   * - value:对应的 Vue 组件(可能是同步组件或返回 Promise 的懒加载函数)
+   *
+   * 当未扫描到任何 island 组件时,导出空对象 `{}`。
+   */
+  export const islands: Record<string, Component | (() => Promise<Component>)>;
+}

package/dist/vite.d.ts

@@ -1,6 +1,80 @@
 import { Plugin } from "vite";
 //#region src/vite.d.ts
 type ClientDirective = 'client:load' | 'client:idle' | 'client:visible' | 'client:media' | 'client:only';
+/**
+ * 一个 island 组件的注册条目。
+ *
+ * - `name`：模板中使用的标签名（如 `<IslandCounter client:load />` 中的 `IslandCounter`）
+ * - `importPath`：组件文件的绝对路径或 bare specifier（来自 `<script setup>` 的 import）
+ * - `sourceFile`：发现该 island 的源文件绝对路径，用于调试与 HMR 失效
+ */
+interface IslandComponentEntry {
+  name: string;
+  importPath: string;
+  sourceFile: string;
+}
+/** Plugin 内部的 island 组件收集表：组件名 → 条目 */
+type IslandComponentMap = Map<string, IslandComponentEntry>;
+/**
+ * 从 `<script setup>` / `<script>` 内容中解析 default import 与 `default as` 别名，
+ * 建立 { 局部名 → import 路径 } 映射。
+ *
+ * 仅处理静态 import 语句；动态 import、re-export 不在识别范围内
+ * （这类用法无法静态分析 → 由运行时 `getComponent` 兜底或用户手动注册）。
+ *
+ * 支持形式：
+ *   import Foo from './Foo.vue'
+ *   import Foo from "some-lib"
+ *   import Foo, { bar } from './Foo.vue'
+ *   import { default as Foo, bar } from './Foo.vue'
+ *   import { default as Foo } from './Foo.vue'
+ */
+declare function parseScriptImports(scriptContent: string): Map<string, string>;
+/**
+ * 扫描模板内容，返回所有带 `client:xxx` 指令的组件标签名集合。
+ *
+ * 复用 `findTagAt` 的标签解析逻辑，确保与 `transformTemplate` 的识别规则一致
+ * （仅匹配首字母大写的组件标签）。
+ *
+ * 与 `transformTemplate` 对称：非 island 标签会递归扫描其 innerHTML，
+ * island 标签不递归（其子内容属于该 island 的 SSR 输出，不作为独立 island）。
+ */
+declare function scanIslandDirectiveNames(template: string): Set<string>;
+/**
+ * 将相对 import 路径解析为绝对路径；bare specifier（如 `vue`、`some-lib`）原样返回。
+ */
+declare function resolveIslandImportPath(importPath: string, sourceFile: string): string;
+/**
+ * 从 Vue SFC 源码中收集 island 组件信息。
+ *
+ * 步骤：
+ * 1. 提取 `<script setup>` / `<script>` 内容
+ * 2. 解析 import 语句，建立 { 局部名 → import 路径 } 映射
+ * 3. 扫描模板中的 `<Comp client:xxx />` 指令，得到组件名集合
+ * 4. 交集：既在 import 映射中、又在 island 指令集合中的组件
+ * 5. 将相对 import 路径解析为绝对路径
+ *
+ * 对未在 import 映射中的 island 组件（如全局注册、动态 import、defineAsyncComponent），
+ * 输出警告，提示用户手动注册。
+ */
+declare function collectIslandComponents(code: string, sourceFile: string): IslandComponentEntry[];
+/**
+ * 生成 `virtual:ubean-islands-registry` 模块内容。
+ *
+ * 输出示例：
+ * ```ts
+ * import __island_0 from '/src/components/IslandCounter.vue';
+ * import __island_1 from '/src/components/IslandMedia.vue';
+ *
+ * export const islands = {
+ *   "IslandCounter": __island_0,
+ *   "IslandMedia": __island_1
+ * };
+ * ```
+ *
+ * 当 map 为空时，返回 `export const islands = {};` 保证下游 import 不会因模块缺失而报错。
+ */
+declare function generateRegistryModule(components: IslandComponentMap): string;
 declare function transformVueSfcIslands(code: string, filePath: string): {
   code: string;
   islandCount: number;
@@ -8,6 +82,8 @@ declare function transformVueSfcIslands(code: string, filePath: string): {
 interface UbeanIslandsPluginOptions {
   enabled?: boolean;
 }
+/** virtual:ubean-islands-registry 的虚拟模块 ID（遵循 AGENTS.md §8 教训 #7：用 `virtual:ubean-` 前缀） */
+declare const ISLANDS_REGISTRY_VIRTUAL_ID = "virtual:ubean-islands-registry";
 declare function ubeanIslandsPlugin(_options?: UbeanIslandsPluginOptions): Plugin;
 //#endregion
-export { ClientDirective, UbeanIslandsPluginOptions, transformVueSfcIslands, ubeanIslandsPlugin };
+export { ClientDirective, ISLANDS_REGISTRY_VIRTUAL_ID, IslandComponentEntry, IslandComponentMap, UbeanIslandsPluginOptions, collectIslandComponents, generateRegistryModule, parseScriptImports, resolveIslandImportPath, scanIslandDirectiveNames, transformVueSfcIslands, ubeanIslandsPlugin };

package/dist/vite.js

@@ -1,3 +1,4 @@
+import { dirname, resolve } from "node:path";
 //#region src/vite.ts
 const CLIENT_DIRECTIVES = [
 	"client:load",
@@ -10,6 +11,182 @@ const DIRECTIVE_RE = /\bclient:(load|idle|visible|media|only)\b/;
 function isVueSfc(id) {
 	return /\.vue(?:\?.*)?$/.test(id) && !id.includes("&type=");
 }
+/**
+* 判断 id 是否为 SFC 主模块（非 `?vue&type=...` 子查询）。
+*
+* 收集 island 组件时需要同时访问 `<script setup>` 与 `<template>` 块，
+* 因此只对 SFC 主模块运行；模板子查询只含模板内容，无法解析 import。
+*/
+function isMainVueSfc(id) {
+	return id.split("?")[0].endsWith(".vue");
+}
+/**
+* 从 `<script setup>` / `<script>` 内容中解析 default import 与 `default as` 别名，
+* 建立 { 局部名 → import 路径 } 映射。
+*
+* 仅处理静态 import 语句；动态 import、re-export 不在识别范围内
+* （这类用法无法静态分析 → 由运行时 `getComponent` 兜底或用户手动注册）。
+*
+* 支持形式：
+*   import Foo from './Foo.vue'
+*   import Foo from "some-lib"
+*   import Foo, { bar } from './Foo.vue'
+*   import { default as Foo, bar } from './Foo.vue'
+*   import { default as Foo } from './Foo.vue'
+*/
+function parseScriptImports(scriptContent) {
+	const map = /* @__PURE__ */ new Map();
+	if (!scriptContent) return map;
+	const defaultRe = /import\s+([A-Za-z_$][\w$]*)(?:\s*,\s*(?:\{[^}]*\}|\*\s+as\s+[A-Za-z_$][\w$]*))?\s+from\s+['"]([^'"]+)['"]/g;
+	let m;
+	while ((m = defaultRe.exec(scriptContent)) !== null) {
+		const localName = m[1];
+		const importPath = m[2];
+		if (!map.has(localName)) map.set(localName, importPath);
+	}
+	const namedDefaultRe = /import\s+\{([^}]*)\}\s+from\s+['"]([^'"]+)['"]/g;
+	while ((m = namedDefaultRe.exec(scriptContent)) !== null) {
+		const clause = m[1];
+		const importPath = m[2];
+		const asMatch = clause.match(/\bdefault\s+as\s+([A-Za-z_$][\w$]*)/);
+		if (asMatch) {
+			const localName = asMatch[1];
+			if (!map.has(localName)) map.set(localName, importPath);
+		}
+	}
+	return map;
+}
+/**
+* 扫描模板内容，返回所有带 `client:xxx` 指令的组件标签名集合。
+*
+* 复用 `findTagAt` 的标签解析逻辑，确保与 `transformTemplate` 的识别规则一致
+* （仅匹配首字母大写的组件标签）。
+*
+* 与 `transformTemplate` 对称：非 island 标签会递归扫描其 innerHTML，
+* island 标签不递归（其子内容属于该 island 的 SSR 输出，不作为独立 island）。
+*/
+function scanIslandDirectiveNames(template) {
+	const names = /* @__PURE__ */ new Set();
+	scan(template);
+	return names;
+	function scan(t) {
+		let pos = 0;
+		while (pos < t.length) {
+			const lt = t.indexOf("<", pos);
+			if (lt === -1) break;
+			if (t[lt + 1] === "/" || t[lt + 1] === "!" || t[lt + 1] === "?") {
+				pos = lt + 1;
+				continue;
+			}
+			const tag = findTagAt(t, lt);
+			if (!tag) {
+				pos = lt + 1;
+				continue;
+			}
+			if (CLIENT_DIRECTIVES.some((d) => tag.attrs.has(d))) names.add(tag.tagName);
+			if (!tag.selfClosing) scan(tag.innerHTML);
+			pos = tag.end;
+		}
+	}
+}
+/**
+* 将相对 import 路径解析为绝对路径；bare specifier（如 `vue`、`some-lib`）原样返回。
+*/
+function resolveIslandImportPath(importPath, sourceFile) {
+	if (importPath.startsWith(".")) return resolve(dirname(sourceFile), importPath);
+	return importPath;
+}
+/**
+* 从 Vue SFC 源码中收集 island 组件信息。
+*
+* 步骤：
+* 1. 提取 `<script setup>` / `<script>` 内容
+* 2. 解析 import 语句，建立 { 局部名 → import 路径 } 映射
+* 3. 扫描模板中的 `<Comp client:xxx />` 指令，得到组件名集合
+* 4. 交集：既在 import 映射中、又在 island 指令集合中的组件
+* 5. 将相对 import 路径解析为绝对路径
+*
+* 对未在 import 映射中的 island 组件（如全局注册、动态 import、defineAsyncComponent），
+* 输出警告，提示用户手动注册。
+*/
+function collectIslandComponents(code, sourceFile) {
+	const scriptContent = extractScriptBlock(code);
+	const templateContent = extractTemplateBlock(code)?.content ?? "";
+	if (!templateContent) return [];
+	if (!DIRECTIVE_RE.test(templateContent)) return [];
+	const importMap = parseScriptImports(scriptContent);
+	const islandNames = scanIslandDirectiveNames(templateContent);
+	const entries = [];
+	for (const name of islandNames) {
+		const importPath = importMap.get(name);
+		if (!importPath) {
+			console.warn(`[ubean:islands] Component "${name}" used with client:xxx directive in ${sourceFile} has no corresponding static import in <script setup>. It will not be auto-registered. Add it manually via hydrateIslands({ components: { ${name}: YourComp } }) or pass a getComponent() resolver.`);
+			continue;
+		}
+		const absolutePath = resolveIslandImportPath(importPath, sourceFile);
+		entries.push({
+			name,
+			importPath: absolutePath,
+			sourceFile
+		});
+	}
+	return entries;
+}
+/**
+* 提取 SFC 中 `<script setup>` 或 `<script>` 块的内容。
+*
+* 优先返回 `<script setup>`；若不存在则返回普通 `<script>`；都没有则返回空字符串。
+* 与 `extractTemplateBlock` 对称，使用简单字符串匹配避免引入 SFC 编译器依赖。
+*/
+function extractScriptBlock(code) {
+	const setupMatch = code.match(/<script\s+[^>]*setup[^>]*>/);
+	if (setupMatch && setupMatch.index !== void 0) {
+		const openTagEnd = setupMatch.index + setupMatch[0].length;
+		const closeIdx = code.indexOf("<\/script>", openTagEnd);
+		if (closeIdx !== -1) return code.slice(openTagEnd, closeIdx);
+	}
+	const plainMatch = code.match(/<script(?!\s[^>]*setup)[^>]*>/);
+	if (plainMatch && plainMatch.index !== void 0) {
+		const openTagEnd = plainMatch.index + plainMatch[0].length;
+		const closeIdx = code.indexOf("<\/script>", openTagEnd);
+		if (closeIdx !== -1) return code.slice(openTagEnd, closeIdx);
+	}
+	return "";
+}
+/**
+* 生成 `virtual:ubean-islands-registry` 模块内容。
+*
+* 输出示例：
+* ```ts
+* import __island_0 from '/src/components/IslandCounter.vue';
+* import __island_1 from '/src/components/IslandMedia.vue';
+*
+* export const islands = {
+*   "IslandCounter": __island_0,
+*   "IslandMedia": __island_1
+* };
+* ```
+*
+* 当 map 为空时，返回 `export const islands = {};` 保证下游 import 不会因模块缺失而报错。
+*/
+function generateRegistryModule(components) {
+	if (components.size === 0) return "export const islands = {};";
+	const imports = [];
+	const entries = [];
+	let idx = 0;
+	for (const [name, entry] of components) {
+		const varName = `__island_${idx++}`;
+		imports.push(`import ${varName} from ${JSON.stringify(entry.importPath)};`);
+		entries.push(`  ${JSON.stringify(name)}: ${varName},`);
+	}
+	return [
+		...imports,
+		"",
+		"export const islands = {",
+		...entries,
+		"};"
+	].join("\n");
+}
 function extractTemplateBlock(code) {
 	const openMatch = code.match(/<template([^>]*)>/);
 	if (!openMatch) return null;
@@ -163,7 +340,7 @@ function transformTemplate(template, islandCounter, filePath) {
 		if (directive === "client:media" && mediaRaw && mediaRaw !== true) mediaStr = ` data-media="${escapeAttr(String(mediaRaw).replace(/^["']|["']$/g, ""))}"`;
 		const props = collectStaticProps(tag.attrs);
 		const propsJson = escapeAttr(JSON.stringify(props));
-		out += `<ubean-island data-island-id="${islandId}" data-component="${tag.tagName}" data-directive="${directive}" data-props="${propsJson}"${mediaStr}>`;
+		out += `<ubean-island v-once data-island-id="${islandId}" data-component="${tag.tagName}" data-directive="${directive}" data-props="${propsJson}"${mediaStr}>`;
 		out += tag.selfClosing ? "" : tag.innerHTML;
 		out += `</ubean-island>`;
 		pos = tag.end;
@@ -187,9 +364,53 @@ function transformVueSfcIslands(code, filePath) {
 		islandCount: counter.count
 	};
 }
+/** virtual:ubean-islands-registry 的虚拟模块 ID（遵循 AGENTS.md §8 教训 #7：用 `virtual:ubean-` 前缀） */
+const ISLANDS_REGISTRY_VIRTUAL_ID = "virtual:ubean-islands-registry";
+/** Vite 内部解析后的虚拟模块 ID（`\0` 前缀防止其他插件处理） */
+const ISLANDS_REGISTRY_RESOLVED_ID = `\0${ISLANDS_REGISTRY_VIRTUAL_ID}`;
 function ubeanIslandsPlugin(_options = {}) {
 	let viteConfig;
 	let enabled = true;
+	let devServer;
+	const islandComponents = /* @__PURE__ */ new Map();
+	const entriesByFile = /* @__PURE__ */ new Map();
+	const transformedFiles = /* @__PURE__ */ new Set();
+	/**
+	* 用某次扫描结果更新 island 组件注册表。
+	*
+	* - 先清理该源文件之前贡献、现已不再使用的组件条目（若其他文件未引用）
+	* - 再添加新条目；同名组件若 import 路径不同 → 警告（首次发现的路径优先）
+	* - 返回 registry 是否发生变化（用于决定是否触发 HMR）
+	*/
+	function updateRegistry(entries, sourceFile) {
+		let changed = false;
+		const oldNames = entriesByFile.get(sourceFile) ?? /* @__PURE__ */ new Set();
+		const newNames = new Set(entries.map((e) => e.name));
+		for (const name of oldNames) {
+			if (newNames.has(name)) continue;
+			let stillUsed = false;
+			for (const [otherFile, names] of entriesByFile) {
+				if (otherFile === sourceFile) continue;
+				if (names.has(name)) {
+					stillUsed = true;
+					break;
+				}
+			}
+			if (!stillUsed && islandComponents.has(name)) {
+				islandComponents.delete(name);
+				changed = true;
+			}
+		}
+		for (const entry of entries) {
+			const existing = islandComponents.get(entry.name);
+			if (!existing) {
+				islandComponents.set(entry.name, entry);
+				changed = true;
+			} else if (existing.importPath !== entry.importPath) console.warn(`[ubean:islands] Component "${entry.name}" is imported from different paths:\n  existing: "${existing.importPath}" (in ${existing.sourceFile})\n  new:      "${entry.importPath}" (in ${sourceFile})\nUsing the first-seen path. To fix, ensure all imports use the same path.`);
+		}
+		entriesByFile.set(sourceFile, newNames);
+		return changed;
+	}
 	return {
 		name: "ubean:islands",
 		enforce: "pre",
@@ -197,13 +418,37 @@ function ubeanIslandsPlugin(_options = {}) {
 			viteConfig = config;
 			enabled = _options.enabled !== false;
 		},
+		configureServer(server) {
+			devServer = server;
+		},
+		resolveId(id) {
+			if (id === "virtual:ubean-islands-registry") return ISLANDS_REGISTRY_RESOLVED_ID;
+		},
+		load(id) {
+			if (id !== ISLANDS_REGISTRY_RESOLVED_ID) return void 0;
+			return generateRegistryModule(islandComponents);
+		},
 		transform(code, id) {
 			if (!enabled) return null;
 			if (!isVueSfc(id)) return null;
 			if (!DIRECTIVE_RE.test(code)) return null;
-			return transformVueSfcIslands(code, id.split("?")[0].replace(viteConfig.root, "").replace(/^[/\\]/, ""));
+			const absolutePath = id.split("?")[0];
+			const result = transformVueSfcIslands(code, absolutePath.replace(viteConfig.root, "").replace(/^[/\\]/, ""));
+			if (isMainVueSfc(id)) {
+				const registryChanged = updateRegistry(collectIslandComponents(code, absolutePath), absolutePath);
+				const isHmrUpdate = transformedFiles.has(absolutePath);
+				transformedFiles.add(absolutePath);
+				if (registryChanged && devServer && isHmrUpdate) {
+					const mod = devServer.moduleGraph.getModuleById(ISLANDS_REGISTRY_RESOLVED_ID);
+					if (mod) {
+						devServer.moduleGraph.invalidateModule(mod);
+						devServer.ws.send({ type: "full-reload" });
+					}
+				}
+			}
+			return result;
 		}
 	};
 }
 //#endregion
-export { transformVueSfcIslands, ubeanIslandsPlugin };
+export { ISLANDS_REGISTRY_VIRTUAL_ID, collectIslandComponents, generateRegistryModule, parseScriptImports, resolveIslandImportPath, scanIslandDirectiveNames, transformVueSfcIslands, ubeanIslandsPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/islands",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Islands architecture for ubean (Vite plugin for client:load/idle/visible/media/only directives, bootstrap script, client hydrate runtime)",
   "files": [
     "dist"
@@ -21,6 +21,10 @@
     "./runtime": {
       "types": "./dist/runtime.d.ts",
       "import": "./dist/runtime.js"
+    },
+    "./virtual-registry": {
+      "types": "./dist/virtual-registry.d.ts",
+      "import": null
     }
   },
   "dependencies": {
@@ -41,7 +45,7 @@
     }
   },
   "scripts": {
-    "build": "vp pack",
+    "build": "vp pack && cp src/virtual-registry.d.ts dist/virtual-registry.d.ts",
     "dev": "vp pack --watch",
     "test": "vp test",
     "typecheck": "tsc --noEmit --skipLibCheck"