@vobs/runtime 1.7.8 → 1.8.1

package/dist/hmr.cjs

@@ -32,6 +32,141 @@ __export(hmr_exports, {
   updateHmrModule: () => updateHmrModule
 });
 module.exports = __toCommonJS(hmr_exports);
+
+// packages/runtime/src/error.ts
+var _VobsError = class _VobsError extends Error {
+  constructor(options) {
+    super(options.message);
+    this.name = "VobsError";
+    this.code = options.code;
+    this.severity = options.severity ?? "error";
+    this.layer = options.layer ?? "runtime";
+    this.cause = options.cause;
+    this.fix = options.fix;
+    this.location = options.location;
+    this.trace = options.trace;
+    this.example = options.example;
+    this.docs = options.docs;
+    this.codeFrame = options.codeFrame;
+  }
+};
+__name(_VobsError, "VobsError");
+var VobsError = _VobsError;
+function isVobsError(value) {
+  return value instanceof VobsError || Boolean(value && typeof value === "object" && typeof value.code === "string" && typeof value.message === "string");
+}
+__name(isVobsError, "isVobsError");
+function isForeignVobsError(value) {
+  return value instanceof Error && value.name === "VobsError" && typeof value.code === "string";
+}
+__name(isForeignVobsError, "isForeignVobsError");
+function describeUnknown(value) {
+  if (value === null || value === void 0) return String(value);
+  if (typeof value === "string") return value;
+  if (typeof value === "object") {
+    const message = value.message;
+    if (typeof message === "string" && message !== "") return message;
+    try {
+      return JSON.stringify(value) ?? String(value);
+    } catch {
+      return String(value);
+    }
+  }
+  return String(value);
+}
+__name(describeUnknown, "describeUnknown");
+function adoptVobsError(value, defaults) {
+  return new VobsError({
+    code: value.code,
+    message: value.message,
+    severity: value.severity ?? defaults.severity,
+    layer: value.layer ?? defaults.layer,
+    cause: value.cause ?? (value instanceof Error ? value : void 0),
+    fix: value.fix ?? defaults.fix,
+    location: value.location,
+    trace: value.trace,
+    example: value.example,
+    docs: value.docs,
+    codeFrame: value.codeFrame
+  });
+}
+__name(adoptVobsError, "adoptVobsError");
+function normalizeVobsError(value, defaults = {}) {
+  if (value instanceof VobsError) return value;
+  if (isForeignVobsError(value)) return adoptVobsError(value, defaults);
+  if (value instanceof Error) {
+    const metadata = value;
+    const code = defaults.code ?? (typeof metadata.vobsCode === "string" ? metadata.vobsCode : void 0);
+    if (code) {
+      defineErrorMetadata(value, "code", code);
+      if (value.code !== code) {
+        return new VobsError({
+          code,
+          message: value.message,
+          severity: defaults.severity ?? "error",
+          layer: defaults.layer ?? "runtime",
+          cause: value,
+          fix: defaults.fix ?? (typeof metadata.vobsHint === "string" ? metadata.vobsHint : void 0)
+        });
+      }
+    }
+    defineErrorMetadata(value, "severity", defaults.severity ?? "error");
+    defineErrorMetadata(value, "layer", defaults.layer ?? "runtime");
+    const fix = defaults.fix ?? (typeof metadata.vobsHint === "string" ? metadata.vobsHint : void 0);
+    if (fix) defineErrorMetadata(value, "fix", fix);
+    const source = metadata.vobsSource;
+    if (source && typeof source === "object" && typeof source.file === "string" && typeof source.line === "number" && typeof source.column === "number") {
+      defineErrorMetadata(value, "location", source);
+    }
+    return value;
+  }
+  if (isVobsError(value)) return adoptVobsError(value, defaults);
+  return new VobsError({
+    code: defaults.code ?? "VOBS_UNKNOWN",
+    message: describeUnknown(value),
+    severity: defaults.severity ?? "error",
+    layer: defaults.layer ?? "runtime",
+    cause: void 0,
+    fix: defaults.fix
+  });
+}
+__name(normalizeVobsError, "normalizeVobsError");
+function defineErrorMetadata(target, key, value) {
+  if (key in target) return;
+  try {
+    Object.defineProperty(target, key, { configurable: true, enumerable: false, value, writable: true });
+  } catch {
+  }
+}
+__name(defineErrorMetadata, "defineErrorMetadata");
+function formatVobsError(value, options = {}) {
+  const error = normalizeVobsError(value);
+  const code = error.code || "VOBS_UNKNOWN";
+  const severity = error.severity || "error";
+  if (options.environment === "production") return `[Vobs ${code}] ${error.message}`;
+  const lines = [`[Vobs ${capitalize(severity)}] ${error.message}`, `Code: ${code}`];
+  if (error.location) lines.push(`Location: ${error.location.file}:${error.location.line}:${error.location.column}`);
+  if (error.codeFrame) lines.push("", error.codeFrame);
+  if (error.cause !== void 0) lines.push(`Cause: ${formatCause(error.cause)}`);
+  if (error.trace?.length) lines.push("", `Trace: ${error.trace.join(" \u2192 ")}`);
+  if (error.fix) lines.push("", `Fix: ${error.fix}`);
+  if (error.example) lines.push("", `Example:
+${error.example}`);
+  if (error.docs) lines.push(`Docs: ${error.docs}`);
+  if (options.includeStack && error.stack) lines.push("", error.stack);
+  return lines.join("\n");
+}
+__name(formatVobsError, "formatVobsError");
+function formatCause(value) {
+  return value instanceof Error ? `${value.name}: ${value.message}` : String(value);
+}
+__name(formatCause, "formatCause");
+function capitalize(value) {
+  return value.slice(0, 1).toUpperCase() + value.slice(1);
+}
+__name(capitalize, "capitalize");
+
+// packages/runtime/src/hmr.ts
 var globalTarget = globalThis;
 var hmrGlobal = globalTarget.__VOBS_HMR__ ?? { modules: /* @__PURE__ */ new Map(), states: /* @__PURE__ */ new Map() };
 globalTarget.__VOBS_HMR__ = hmrGlobal;
@@ -69,7 +204,8 @@ function updateHmrModule(moduleId, nextModule) {
   for (const instance of instances) {
     try {
       instance.refresh();
-    } catch {
+    } catch (error) {
+      console.error(formatVobsError(error, { includeStack: true }));
     }
   }
 }

package/dist/hmr.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hmr.ts"],"sourcesContent":["import type { VobsNode } from './fragment'\n\nexport type HmrComponent<Props extends object = Record<string, unknown>> =\n  (props: Props) => VobsNode\n\nexport interface HmrStateStore {\n  get<T>(key: string, initial: T | (() => T)): T\n  set<T>(key: string, value: T): void\n  has(key: string): boolean\n  delete(key: string): void\n  clear(): void\n}\n\nexport interface HmrInstance {\n  node: VobsNode\n  parent: Node | null\n  refresh(): void\n}\n\ninterface HmrModuleState {\n  readonly components: Map<string, HmrComponent>\n  readonly state: Map<string, unknown>\n  readonly instances: Set<HmrInstance>\n}\n\ninterface HmrGlobal {\n  modules: Map<string, HmrModuleState>\n  /** 编译器生成的 hmrStateRef 注册表：键为 `${moduleId}#${声明名}`，值跨模块重执行保活。 */\n  states: Map<string, unknown>\n}\n\nconst globalTarget = globalThis as typeof globalThis & { __VOBS_HMR__?: HmrGlobal }\nconst hmrGlobal = globalTarget.__VOBS_HMR__ ?? { modules: new Map<string, HmrModuleState>(), states: new Map<string, unknown>() }\nglobalTarget.__VOBS_HMR__ = hmrGlobal\n\nexport function resolveComponent<Props extends object>(\n  component: HmrComponent<Props>,\n  moduleId: string,\n  exportName: string\n): HmrComponent<Props> {\n  const module = getModule(moduleId)\n  const existing = module.components.get(exportName)\n  if (existing) return existing as HmrComponent<Props>\n\n  const proxy = ((props: Props) => {\n    const current = (proxy as HmrComponent<Props> & { current: HmrComponent<Props> }).current\n    return current(props)\n  }) as HmrComponent<Props> & { current: HmrComponent<Props> }\n  proxy.current = component\n  Object.defineProperties(proxy, {\n    displayName: { configurable: true, value: component.name || exportName },\n    hmrKey: { configurable: false, value: `${moduleId}:${exportName}` }\n  })\n  module.components.set(exportName, proxy as HmrComponent)\n  return proxy\n}\n\nexport function updateHmrModule(moduleId: string, nextModule: Record<string, unknown>): void {\n  const module = hmrGlobal.modules.get(moduleId)\n  if (!module) return\n  let changed = false\n  for (const [name, proxy] of module.components) {\n    const next = nextModule[name]\n    if (typeof next !== 'function') continue\n    const hmrProxy = proxy as HmrComponent & { current: HmrComponent; displayName?: string }\n    hmrProxy.current = next as HmrComponent\n    Object.defineProperty(hmrProxy, 'displayName', { configurable: true, value: next.name || name })\n    changed = true\n  }\n  if (!changed) return\n  // 快照后正序遍历：实例在自身渲染开始前注册，祖先必然先于后代入列——\n  // 祖先先刷新会 dispose 上一轮渲染作用域，其树内旧后代实例的 refresh\n  // 命中已销毁守卫被跳过，避免同一组件在一次热更新中重渲染两次。\n  // 同时 refresh 重渲染以新代码创建的全新实例不在快照中，天然不会再刷新。\n  const instances = [...module.instances]\n  for (const instance of instances) {\n    try {\n      instance.refresh()\n    } catch {\n      // HMR failures remain application errors on the next normal render.\n    }\n  }\n}\n\nexport function disposeHmrModule(_moduleId: string): void {\n  // State and component proxies intentionally survive module disposal.\n}\n\nexport function createHmrStateStore(moduleId: string): HmrStateStore {\n  const state = getModule(moduleId).state\n  return {\n    get<T>(key: string, initial: T | (() => T)): T {\n      if (!state.has(key)) state.set(key, typeof initial === 'function' ? (initial as () => T)() : initial)\n      return state.get(key) as T\n    },\n    set<T>(key: string, value: T): void {\n      state.set(key, value)\n    },\n    has: key => state.has(key),\n    delete: key => { state.delete(key) },\n    clear: () => { state.clear() }\n  }\n}\n\n/**\n * 编译器为模块顶层 state() 声明生成的取值入口。键为 `${moduleId}#${声明名}`，\n * 与手动 store 键空间隔离。模块热更新重执行时复用既有信号实例：旧导入方持有的\n * 实例与新模块实例共享同一份状态，消除\"两份模块、两份状态\"导致的编辑不生效/页面半边失灵。\n */\nexport function hmrStateRef<T>(key: string, create: () => T): T {\n  const states = hmrGlobal.states\n  if (states.has(key)) return states.get(key) as T\n  const value = create()\n  states.set(key, value)\n  return value\n}\n\nexport function registerHmrInstance(moduleId: string, instance: HmrInstance): () => void {\n  const instances = getModule(moduleId).instances\n  instances.add(instance)\n  return () => instances.delete(instance)\n}\n\nexport function markHmrInstanceMounted(node: VobsNode, parent: Node): void {\n  const instance = hmrInstances.get(node as object)\n  if (instance) instance.parent = parent\n}\n\nfunction getModule(moduleId: string): HmrModuleState {\n  let module = hmrGlobal.modules.get(moduleId)\n  if (!module) {\n    module = { components: new Map(), state: new Map(), instances: new Set() }\n    hmrGlobal.modules.set(moduleId, module)\n  }\n  return module\n}\n\nconst hmrInstances = new WeakMap<object, HmrInstance>()\n\nexport function associateHmrInstance(node: VobsNode, instance: HmrInstance): void {\n  hmrInstances.set(node as object, instance)\n}\n"],"mappings":"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","names":["module"]}
+{"version":3,"sources":["../src/hmr.ts","../src/error.ts"],"sourcesContent":["import type { VobsNode } from './fragment'\nimport { formatVobsError } from './error'\n\nexport type HmrComponent<Props extends object = Record<string, unknown>> =\n  (props: Props) => VobsNode\n\nexport interface HmrStateStore {\n  get<T>(key: string, initial: T | (() => T)): T\n  set<T>(key: string, value: T): void\n  has(key: string): boolean\n  delete(key: string): void\n  clear(): void\n}\n\nexport interface HmrInstance {\n  node: VobsNode\n  parent: Node | null\n  refresh(): void\n}\n\ninterface HmrModuleState {\n  readonly components: Map<string, HmrComponent>\n  readonly state: Map<string, unknown>\n  readonly instances: Set<HmrInstance>\n}\n\ninterface HmrGlobal {\n  modules: Map<string, HmrModuleState>\n  /** 编译器生成的 hmrStateRef 注册表：键为 `${moduleId}#${声明名}`，值跨模块重执行保活。 */\n  states: Map<string, unknown>\n}\n\nconst globalTarget = globalThis as typeof globalThis & { __VOBS_HMR__?: HmrGlobal }\nconst hmrGlobal = globalTarget.__VOBS_HMR__ ?? { modules: new Map<string, HmrModuleState>(), states: new Map<string, unknown>() }\nglobalTarget.__VOBS_HMR__ = hmrGlobal\n\nexport function resolveComponent<Props extends object>(\n  component: HmrComponent<Props>,\n  moduleId: string,\n  exportName: string\n): HmrComponent<Props> {\n  const module = getModule(moduleId)\n  const existing = module.components.get(exportName)\n  if (existing) return existing as HmrComponent<Props>\n\n  const proxy = ((props: Props) => {\n    const current = (proxy as HmrComponent<Props> & { current: HmrComponent<Props> }).current\n    return current(props)\n  }) as HmrComponent<Props> & { current: HmrComponent<Props> }\n  proxy.current = component\n  Object.defineProperties(proxy, {\n    displayName: { configurable: true, value: component.name || exportName },\n    hmrKey: { configurable: false, value: `${moduleId}:${exportName}` }\n  })\n  module.components.set(exportName, proxy as HmrComponent)\n  return proxy\n}\n\nexport function updateHmrModule(moduleId: string, nextModule: Record<string, unknown>): void {\n  const module = hmrGlobal.modules.get(moduleId)\n  if (!module) return\n  let changed = false\n  for (const [name, proxy] of module.components) {\n    const next = nextModule[name]\n    if (typeof next !== 'function') continue\n    const hmrProxy = proxy as HmrComponent & { current: HmrComponent; displayName?: string }\n    hmrProxy.current = next as HmrComponent\n    Object.defineProperty(hmrProxy, 'displayName', { configurable: true, value: next.name || name })\n    changed = true\n  }\n  if (!changed) return\n  // 快照后正序遍历：实例在自身渲染开始前注册，祖先必然先于后代入列——\n  // 祖先先刷新会 dispose 上一轮渲染作用域，其树内旧后代实例的 refresh\n  // 命中已销毁守卫被跳过，避免同一组件在一次热更新中重渲染两次。\n  // 同时 refresh 重渲染以新代码创建的全新实例不在快照中，天然不会再刷新。\n  const instances = [...module.instances]\n  for (const instance of instances) {\n    try {\n      instance.refresh()\n    } catch (error) {\n      /*\n       * 静默吞掉会让开发者以为热更新成功了，而屏幕上是旧的 —— 最容易被当成\n       * 「改了没生效」查半天。刷新失败本身不冒泡（下一次正常渲染会再抛），\n       * 但必须留下记录。\n       */\n      console.error(formatVobsError(error, { includeStack: true }))\n    }\n  }\n}\n\nexport function disposeHmrModule(_moduleId: string): void {\n  // State and component proxies intentionally survive module disposal.\n}\n\nexport function createHmrStateStore(moduleId: string): HmrStateStore {\n  const state = getModule(moduleId).state\n  return {\n    get<T>(key: string, initial: T | (() => T)): T {\n      if (!state.has(key)) state.set(key, typeof initial === 'function' ? (initial as () => T)() : initial)\n      return state.get(key) as T\n    },\n    set<T>(key: string, value: T): void {\n      state.set(key, value)\n    },\n    has: key => state.has(key),\n    delete: key => { state.delete(key) },\n    clear: () => { state.clear() }\n  }\n}\n\n/**\n * 编译器为模块顶层 state() 声明生成的取值入口。键为 `${moduleId}#${声明名}`，\n * 与手动 store 键空间隔离。模块热更新重执行时复用既有信号实例：旧导入方持有的\n * 实例与新模块实例共享同一份状态，消除\"两份模块、两份状态\"导致的编辑不生效/页面半边失灵。\n */\nexport function hmrStateRef<T>(key: string, create: () => T): T {\n  const states = hmrGlobal.states\n  if (states.has(key)) return states.get(key) as T\n  const value = create()\n  states.set(key, value)\n  return value\n}\n\nexport function registerHmrInstance(moduleId: string, instance: HmrInstance): () => void {\n  const instances = getModule(moduleId).instances\n  instances.add(instance)\n  return () => instances.delete(instance)\n}\n\nexport function markHmrInstanceMounted(node: VobsNode, parent: Node): void {\n  const instance = hmrInstances.get(node as object)\n  if (instance) instance.parent = parent\n}\n\nfunction getModule(moduleId: string): HmrModuleState {\n  let module = hmrGlobal.modules.get(moduleId)\n  if (!module) {\n    module = { components: new Map(), state: new Map(), instances: new Set() }\n    hmrGlobal.modules.set(moduleId, module)\n  }\n  return module\n}\n\nconst hmrInstances = new WeakMap<object, HmrInstance>()\n\nexport function associateHmrInstance(node: VobsNode, instance: HmrInstance): void {\n  hmrInstances.set(node as object, instance)\n}\n","/** Shared error protocol used by the runtime, compiler and DevTools. */\nexport type VobsErrorSeverity = 'error' | 'warning' | 'info'\nexport type VobsErrorLayer =\n  | 'compiler'\n  | 'runtime'\n  | 'constraint'\n  | 'permission'\n  | 'ssr'\n  | 'http'\n  | 'resource'\n\nexport interface VobsErrorLocation {\n  readonly file: string\n  readonly line: number\n  readonly column: number\n}\n\nexport interface VobsErrorOptions {\n  readonly code: string\n  readonly message: string\n  readonly severity?: VobsErrorSeverity\n  readonly layer?: VobsErrorLayer\n  readonly cause?: unknown\n  readonly fix?: string\n  readonly location?: VobsErrorLocation\n  readonly trace?: readonly string[]\n  readonly example?: string\n  readonly docs?: string\n  readonly codeFrame?: string\n}\n\nexport interface VobsErrorDefaults {\n  readonly code?: string\n  readonly severity?: VobsErrorSeverity\n  readonly layer?: VobsErrorLayer\n  readonly fix?: string\n}\n\n/** A framework error with stable machine-readable metadata. */\nexport class VobsError extends Error {\n  readonly code: string\n  readonly severity: VobsErrorSeverity\n  readonly layer: VobsErrorLayer\n  readonly cause?: unknown\n  readonly fix?: string\n  readonly location?: VobsErrorLocation\n  readonly trace?: readonly string[]\n  readonly example?: string\n  readonly docs?: string\n  readonly codeFrame?: string\n\n  constructor(options: VobsErrorOptions) {\n    super(options.message)\n    this.name = 'VobsError'\n    this.code = options.code\n    this.severity = options.severity ?? 'error'\n    this.layer = options.layer ?? 'runtime'\n    this.cause = options.cause\n    this.fix = options.fix\n    this.location = options.location\n    this.trace = options.trace\n    this.example = options.example\n    this.docs = options.docs\n    this.codeFrame = options.codeFrame\n  }\n}\n\nexport function createVobsError(options: VobsErrorOptions): VobsError {\n  return new VobsError(options)\n}\n\n/**\n * 结构化识别（不依赖 `instanceof`）。\n *\n * **不能要求 `layer` 也齐全** —— 原来要求 code + message + layer 三者都是字符串，\n * 于是调用方递一个 `{ code, message }` 就会被判为「不是 VobsError」，掉进最后的\n * `String(value)` 兜底，输出 `[object Object]`：诊断系统自己把诊断丢了。\n * layer 缺失在下面构造时会补上默认值，没有理由在识别阶段就否掉。\n */\nexport function isVobsError(value: unknown): value is VobsError {\n  return value instanceof VobsError\n    || Boolean(value && typeof value === 'object'\n      && typeof (value as { code?: unknown }).code === 'string'\n      && typeof (value as { message?: unknown }).message === 'string')\n}\n\n/**\n * 别的打包副本造的 VobsError。\n *\n * tsup `splitting: false` 让 error.ts 同时进 `dist/index.js` 与 `dist/error.js`，\n * 两份类互不 `instanceof`。字段齐全，只是身份不同 —— 识别出来复制成本地实例。\n */\nfunction isForeignVobsError(value: unknown): value is Error & VobsErrorOptions {\n  return value instanceof Error\n    && value.name === 'VobsError'\n    && typeof (value as { code?: unknown }).code === 'string'\n}\n\n/** 兜底取消息：至少要能读出对象上的 message，别再输出 `[object Object]`。 */\nfunction describeUnknown(value: unknown): string {\n  if (value === null || value === undefined) return String(value)\n  if (typeof value === 'string') return value\n  if (typeof value === 'object') {\n    const message = (value as { message?: unknown }).message\n    if (typeof message === 'string' && message !== '') return message\n    try {\n      return JSON.stringify(value) ?? String(value)\n    } catch {\n      return String(value)\n    }\n  }\n  return String(value)\n}\n\n/** 把任意来源的「类 VobsError」字段复制成本地实例。 */\nfunction adoptVobsError(\n  value: VobsErrorOptions & { cause?: unknown },\n  defaults: VobsErrorDefaults\n): VobsError {\n  return new VobsError({\n    code: value.code,\n    message: value.message,\n    severity: value.severity ?? defaults.severity,\n    layer: value.layer ?? defaults.layer,\n    cause: value.cause ?? (value instanceof Error ? value : undefined),\n    fix: value.fix ?? defaults.fix,\n    location: value.location,\n    trace: value.trace,\n    example: value.example,\n    docs: value.docs,\n    codeFrame: value.codeFrame\n  })\n}\n\n/** Convert thrown strings and third-party errors without losing their message. */\nexport function normalizeVobsError(value: unknown, defaults: VobsErrorDefaults = {}): VobsError {\n  // 本地实例：原样返回，保持同一性与已有 stack\n  if (value instanceof VobsError) return value\n\n  // 别的副本造的：复制成本地实例，下游 instanceof 才成立\n  if (isForeignVobsError(value)) return adoptVobsError(value, defaults)\n\n  if (value instanceof Error) {\n    // Preserve the original Error identity so boundaries and DevTools can\n    // correlate event/effect phases without creating duplicate diagnostics.\n    const metadata = value as Error & {\n      readonly vobsCode?: unknown\n      readonly vobsHint?: unknown\n      readonly vobsSource?: unknown\n    }\n    const code = defaults.code ?? (typeof metadata.vobsCode === 'string' ? metadata.vobsCode : undefined)\n    if (code) {\n      defineErrorMetadata(value, 'code', code)\n      /*\n       * 冻结 / 不可扩展的第三方 Error 上挂不上元数据。原来这里静默吞掉，\n       * 于是 normalize 的结果 code 是 undefined（打印成 VOBS_UNKNOWN）。\n       * 挂不上就复制成本地实例，别把 code 丢了。\n       */\n      if ((value as { code?: unknown }).code !== code) {\n        return new VobsError({\n          code,\n          message: value.message,\n          severity: defaults.severity ?? 'error',\n          layer: defaults.layer ?? 'runtime',\n          cause: value,\n          fix: defaults.fix ?? (typeof metadata.vobsHint === 'string' ? metadata.vobsHint : undefined)\n        })\n      }\n    }\n    defineErrorMetadata(value, 'severity', defaults.severity ?? 'error')\n    defineErrorMetadata(value, 'layer', defaults.layer ?? 'runtime')\n    const fix = defaults.fix ?? (typeof metadata.vobsHint === 'string' ? metadata.vobsHint : undefined)\n    if (fix) defineErrorMetadata(value, 'fix', fix)\n    const source = metadata.vobsSource\n    if (source && typeof source === 'object'\n      && typeof (source as { file?: unknown }).file === 'string'\n      && typeof (source as { line?: unknown }).line === 'number'\n      && typeof (source as { column?: unknown }).column === 'number') {\n      defineErrorMetadata(value, 'location', source)\n    }\n    return value as VobsError\n  }\n\n  // 结构化对象（可能缺 layer，甚至缺 severity）：补齐后构造成本地 VobsError\n  if (isVobsError(value)) return adoptVobsError(value as VobsErrorOptions, defaults)\n\n  return new VobsError({\n    code: defaults.code ?? 'VOBS_UNKNOWN',\n    message: describeUnknown(value),\n    severity: defaults.severity ?? 'error',\n    layer: defaults.layer ?? 'runtime',\n    cause: undefined,\n    fix: defaults.fix\n  })\n}\n\nfunction defineErrorMetadata(target: Error, key: string, value: unknown): void {\n  if (key in target) return\n  try {\n    Object.defineProperty(target, key, { configurable: true, enumerable: false, value, writable: true })\n  } catch {\n    // 冻结 / 不可扩展的第三方 Error：元数据挂不上。调用方会用「写完再读回」判断\n    // 是否成功，失败时改成复制成本地实例，而不是静默丢掉 code。\n  }\n}\n\nexport interface FormatVobsErrorOptions {\n  readonly environment?: 'development' | 'production'\n  readonly includeStack?: boolean\n}\n\n/** Format a concise, actionable message for terminals and dev overlays. */\nexport function formatVobsError(\n  value: unknown,\n  options: FormatVobsErrorOptions = {}\n): string {\n  const error = normalizeVobsError(value)\n  const code = error.code || 'VOBS_UNKNOWN'\n  const severity = error.severity || 'error'\n  if (options.environment === 'production') return `[Vobs ${code}] ${error.message}`\n\n  const lines = [`[Vobs ${capitalize(severity)}] ${error.message}`, `Code: ${code}`]\n  if (error.location) lines.push(`Location: ${error.location.file}:${error.location.line}:${error.location.column}`)\n  if (error.codeFrame) lines.push('', error.codeFrame)\n  if (error.cause !== undefined) lines.push(`Cause: ${formatCause(error.cause)}`)\n  if (error.trace?.length) lines.push('', `Trace: ${error.trace.join(' → ')}`)\n  if (error.fix) lines.push('', `Fix: ${error.fix}`)\n  if (error.example) lines.push('', `Example:\\n${error.example}`)\n  if (error.docs) lines.push(`Docs: ${error.docs}`)\n  if (options.includeStack && error.stack) lines.push('', error.stack)\n  return lines.join('\\n')\n}\n\nfunction formatCause(value: unknown): string {\n  return value instanceof Error ? `${value.name}: ${value.message}` : String(value)\n}\n\nfunction capitalize(value: string): string {\n  return value.slice(0, 1).toUpperCase() + value.slice(1)\n}\n"],"mappings":"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","names":["module"]}

package/dist/hmr.js

@@ -1,6 +1,139 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
+// packages/runtime/src/error.ts
+var _VobsError = class _VobsError extends Error {
+  constructor(options) {
+    super(options.message);
+    this.name = "VobsError";
+    this.code = options.code;
+    this.severity = options.severity ?? "error";
+    this.layer = options.layer ?? "runtime";
+    this.cause = options.cause;
+    this.fix = options.fix;
+    this.location = options.location;
+    this.trace = options.trace;
+    this.example = options.example;
+    this.docs = options.docs;
+    this.codeFrame = options.codeFrame;
+  }
+};
+__name(_VobsError, "VobsError");
+var VobsError = _VobsError;
+function isVobsError(value) {
+  return value instanceof VobsError || Boolean(value && typeof value === "object" && typeof value.code === "string" && typeof value.message === "string");
+}
+__name(isVobsError, "isVobsError");
+function isForeignVobsError(value) {
+  return value instanceof Error && value.name === "VobsError" && typeof value.code === "string";
+}
+__name(isForeignVobsError, "isForeignVobsError");
+function describeUnknown(value) {
+  if (value === null || value === void 0) return String(value);
+  if (typeof value === "string") return value;
+  if (typeof value === "object") {
+    const message = value.message;
+    if (typeof message === "string" && message !== "") return message;
+    try {
+      return JSON.stringify(value) ?? String(value);
+    } catch {
+      return String(value);
+    }
+  }
+  return String(value);
+}
+__name(describeUnknown, "describeUnknown");
+function adoptVobsError(value, defaults) {
+  return new VobsError({
+    code: value.code,
+    message: value.message,
+    severity: value.severity ?? defaults.severity,
+    layer: value.layer ?? defaults.layer,
+    cause: value.cause ?? (value instanceof Error ? value : void 0),
+    fix: value.fix ?? defaults.fix,
+    location: value.location,
+    trace: value.trace,
+    example: value.example,
+    docs: value.docs,
+    codeFrame: value.codeFrame
+  });
+}
+__name(adoptVobsError, "adoptVobsError");
+function normalizeVobsError(value, defaults = {}) {
+  if (value instanceof VobsError) return value;
+  if (isForeignVobsError(value)) return adoptVobsError(value, defaults);
+  if (value instanceof Error) {
+    const metadata = value;
+    const code = defaults.code ?? (typeof metadata.vobsCode === "string" ? metadata.vobsCode : void 0);
+    if (code) {
+      defineErrorMetadata(value, "code", code);
+      if (value.code !== code) {
+        return new VobsError({
+          code,
+          message: value.message,
+          severity: defaults.severity ?? "error",
+          layer: defaults.layer ?? "runtime",
+          cause: value,
+          fix: defaults.fix ?? (typeof metadata.vobsHint === "string" ? metadata.vobsHint : void 0)
+        });
+      }
+    }
+    defineErrorMetadata(value, "severity", defaults.severity ?? "error");
+    defineErrorMetadata(value, "layer", defaults.layer ?? "runtime");
+    const fix = defaults.fix ?? (typeof metadata.vobsHint === "string" ? metadata.vobsHint : void 0);
+    if (fix) defineErrorMetadata(value, "fix", fix);
+    const source = metadata.vobsSource;
+    if (source && typeof source === "object" && typeof source.file === "string" && typeof source.line === "number" && typeof source.column === "number") {
+      defineErrorMetadata(value, "location", source);
+    }
+    return value;
+  }
+  if (isVobsError(value)) return adoptVobsError(value, defaults);
+  return new VobsError({
+    code: defaults.code ?? "VOBS_UNKNOWN",
+    message: describeUnknown(value),
+    severity: defaults.severity ?? "error",
+    layer: defaults.layer ?? "runtime",
+    cause: void 0,
+    fix: defaults.fix
+  });
+}
+__name(normalizeVobsError, "normalizeVobsError");
+function defineErrorMetadata(target, key, value) {
+  if (key in target) return;
+  try {
+    Object.defineProperty(target, key, { configurable: true, enumerable: false, value, writable: true });
+  } catch {
+  }
+}
+__name(defineErrorMetadata, "defineErrorMetadata");
+function formatVobsError(value, options = {}) {
+  const error = normalizeVobsError(value);
+  const code = error.code || "VOBS_UNKNOWN";
+  const severity = error.severity || "error";
+  if (options.environment === "production") return `[Vobs ${code}] ${error.message}`;
+  const lines = [`[Vobs ${capitalize(severity)}] ${error.message}`, `Code: ${code}`];
+  if (error.location) lines.push(`Location: ${error.location.file}:${error.location.line}:${error.location.column}`);
+  if (error.codeFrame) lines.push("", error.codeFrame);
+  if (error.cause !== void 0) lines.push(`Cause: ${formatCause(error.cause)}`);
+  if (error.trace?.length) lines.push("", `Trace: ${error.trace.join(" \u2192 ")}`);
+  if (error.fix) lines.push("", `Fix: ${error.fix}`);
+  if (error.example) lines.push("", `Example:
+${error.example}`);
+  if (error.docs) lines.push(`Docs: ${error.docs}`);
+  if (options.includeStack && error.stack) lines.push("", error.stack);
+  return lines.join("\n");
+}
+__name(formatVobsError, "formatVobsError");
+function formatCause(value) {
+  return value instanceof Error ? `${value.name}: ${value.message}` : String(value);
+}
+__name(formatCause, "formatCause");
+function capitalize(value) {
+  return value.slice(0, 1).toUpperCase() + value.slice(1);
+}
+__name(capitalize, "capitalize");
+
 // packages/runtime/src/hmr.ts
 var globalTarget = globalThis;
 var hmrGlobal = globalTarget.__VOBS_HMR__ ?? { modules: /* @__PURE__ */ new Map(), states: /* @__PURE__ */ new Map() };
@@ -39,7 +172,8 @@ function updateHmrModule(moduleId, nextModule) {
   for (const instance of instances) {
     try {
       instance.refresh();
-    } catch {
+    } catch (error) {
+      console.error(formatVobsError(error, { includeStack: true }));
     }
   }
 }

package/dist/hmr.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hmr.ts"],"sourcesContent":["import type { VobsNode } from './fragment'\n\nexport type HmrComponent<Props extends object = Record<string, unknown>> =\n  (props: Props) => VobsNode\n\nexport interface HmrStateStore {\n  get<T>(key: string, initial: T | (() => T)): T\n  set<T>(key: string, value: T): void\n  has(key: string): boolean\n  delete(key: string): void\n  clear(): void\n}\n\nexport interface HmrInstance {\n  node: VobsNode\n  parent: Node | null\n  refresh(): void\n}\n\ninterface HmrModuleState {\n  readonly components: Map<string, HmrComponent>\n  readonly state: Map<string, unknown>\n  readonly instances: Set<HmrInstance>\n}\n\ninterface HmrGlobal {\n  modules: Map<string, HmrModuleState>\n  /** 编译器生成的 hmrStateRef 注册表：键为 `${moduleId}#${声明名}`，值跨模块重执行保活。 */\n  states: Map<string, unknown>\n}\n\nconst globalTarget = globalThis as typeof globalThis & { __VOBS_HMR__?: HmrGlobal }\nconst hmrGlobal = globalTarget.__VOBS_HMR__ ?? { modules: new Map<string, HmrModuleState>(), states: new Map<string, unknown>() }\nglobalTarget.__VOBS_HMR__ = hmrGlobal\n\nexport function resolveComponent<Props extends object>(\n  component: HmrComponent<Props>,\n  moduleId: string,\n  exportName: string\n): HmrComponent<Props> {\n  const module = getModule(moduleId)\n  const existing = module.components.get(exportName)\n  if (existing) return existing as HmrComponent<Props>\n\n  const proxy = ((props: Props) => {\n    const current = (proxy as HmrComponent<Props> & { current: HmrComponent<Props> }).current\n    return current(props)\n  }) as HmrComponent<Props> & { current: HmrComponent<Props> }\n  proxy.current = component\n  Object.defineProperties(proxy, {\n    displayName: { configurable: true, value: component.name || exportName },\n    hmrKey: { configurable: false, value: `${moduleId}:${exportName}` }\n  })\n  module.components.set(exportName, proxy as HmrComponent)\n  return proxy\n}\n\nexport function updateHmrModule(moduleId: string, nextModule: Record<string, unknown>): void {\n  const module = hmrGlobal.modules.get(moduleId)\n  if (!module) return\n  let changed = false\n  for (const [name, proxy] of module.components) {\n    const next = nextModule[name]\n    if (typeof next !== 'function') continue\n    const hmrProxy = proxy as HmrComponent & { current: HmrComponent; displayName?: string }\n    hmrProxy.current = next as HmrComponent\n    Object.defineProperty(hmrProxy, 'displayName', { configurable: true, value: next.name || name })\n    changed = true\n  }\n  if (!changed) return\n  // 快照后正序遍历：实例在自身渲染开始前注册，祖先必然先于后代入列——\n  // 祖先先刷新会 dispose 上一轮渲染作用域，其树内旧后代实例的 refresh\n  // 命中已销毁守卫被跳过，避免同一组件在一次热更新中重渲染两次。\n  // 同时 refresh 重渲染以新代码创建的全新实例不在快照中，天然不会再刷新。\n  const instances = [...module.instances]\n  for (const instance of instances) {\n    try {\n      instance.refresh()\n    } catch {\n      // HMR failures remain application errors on the next normal render.\n    }\n  }\n}\n\nexport function disposeHmrModule(_moduleId: string): void {\n  // State and component proxies intentionally survive module disposal.\n}\n\nexport function createHmrStateStore(moduleId: string): HmrStateStore {\n  const state = getModule(moduleId).state\n  return {\n    get<T>(key: string, initial: T | (() => T)): T {\n      if (!state.has(key)) state.set(key, typeof initial === 'function' ? (initial as () => T)() : initial)\n      return state.get(key) as T\n    },\n    set<T>(key: string, value: T): void {\n      state.set(key, value)\n    },\n    has: key => state.has(key),\n    delete: key => { state.delete(key) },\n    clear: () => { state.clear() }\n  }\n}\n\n/**\n * 编译器为模块顶层 state() 声明生成的取值入口。键为 `${moduleId}#${声明名}`，\n * 与手动 store 键空间隔离。模块热更新重执行时复用既有信号实例：旧导入方持有的\n * 实例与新模块实例共享同一份状态，消除\"两份模块、两份状态\"导致的编辑不生效/页面半边失灵。\n */\nexport function hmrStateRef<T>(key: string, create: () => T): T {\n  const states = hmrGlobal.states\n  if (states.has(key)) return states.get(key) as T\n  const value = create()\n  states.set(key, value)\n  return value\n}\n\nexport function registerHmrInstance(moduleId: string, instance: HmrInstance): () => void {\n  const instances = getModule(moduleId).instances\n  instances.add(instance)\n  return () => instances.delete(instance)\n}\n\nexport function markHmrInstanceMounted(node: VobsNode, parent: Node): void {\n  const instance = hmrInstances.get(node as object)\n  if (instance) instance.parent = parent\n}\n\nfunction getModule(moduleId: string): HmrModuleState {\n  let module = hmrGlobal.modules.get(moduleId)\n  if (!module) {\n    module = { components: new Map(), state: new Map(), instances: new Set() }\n    hmrGlobal.modules.set(moduleId, module)\n  }\n  return module\n}\n\nconst hmrInstances = new WeakMap<object, HmrInstance>()\n\nexport function associateHmrInstance(node: VobsNode, instance: HmrInstance): void {\n  hmrInstances.set(node as object, instance)\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/error.ts","../src/hmr.ts"],"sourcesContent":["/** Shared error protocol used by the runtime, compiler and DevTools. */\nexport type VobsErrorSeverity = 'error' | 'warning' | 'info'\nexport type VobsErrorLayer =\n  | 'compiler'\n  | 'runtime'\n  | 'constraint'\n  | 'permission'\n  | 'ssr'\n  | 'http'\n  | 'resource'\n\nexport interface VobsErrorLocation {\n  readonly file: string\n  readonly line: number\n  readonly column: number\n}\n\nexport interface VobsErrorOptions {\n  readonly code: string\n  readonly message: string\n  readonly severity?: VobsErrorSeverity\n  readonly layer?: VobsErrorLayer\n  readonly cause?: unknown\n  readonly fix?: string\n  readonly location?: VobsErrorLocation\n  readonly trace?: readonly string[]\n  readonly example?: string\n  readonly docs?: string\n  readonly codeFrame?: string\n}\n\nexport interface VobsErrorDefaults {\n  readonly code?: string\n  readonly severity?: VobsErrorSeverity\n  readonly layer?: VobsErrorLayer\n  readonly fix?: string\n}\n\n/** A framework error with stable machine-readable metadata. */\nexport class VobsError extends Error {\n  readonly code: string\n  readonly severity: VobsErrorSeverity\n  readonly layer: VobsErrorLayer\n  readonly cause?: unknown\n  readonly fix?: string\n  readonly location?: VobsErrorLocation\n  readonly trace?: readonly string[]\n  readonly example?: string\n  readonly docs?: string\n  readonly codeFrame?: string\n\n  constructor(options: VobsErrorOptions) {\n    super(options.message)\n    this.name = 'VobsError'\n    this.code = options.code\n    this.severity = options.severity ?? 'error'\n    this.layer = options.layer ?? 'runtime'\n    this.cause = options.cause\n    this.fix = options.fix\n    this.location = options.location\n    this.trace = options.trace\n    this.example = options.example\n    this.docs = options.docs\n    this.codeFrame = options.codeFrame\n  }\n}\n\nexport function createVobsError(options: VobsErrorOptions): VobsError {\n  return new VobsError(options)\n}\n\n/**\n * 结构化识别（不依赖 `instanceof`）。\n *\n * **不能要求 `layer` 也齐全** —— 原来要求 code + message + layer 三者都是字符串，\n * 于是调用方递一个 `{ code, message }` 就会被判为「不是 VobsError」，掉进最后的\n * `String(value)` 兜底，输出 `[object Object]`：诊断系统自己把诊断丢了。\n * layer 缺失在下面构造时会补上默认值，没有理由在识别阶段就否掉。\n */\nexport function isVobsError(value: unknown): value is VobsError {\n  return value instanceof VobsError\n    || Boolean(value && typeof value === 'object'\n      && typeof (value as { code?: unknown }).code === 'string'\n      && typeof (value as { message?: unknown }).message === 'string')\n}\n\n/**\n * 别的打包副本造的 VobsError。\n *\n * tsup `splitting: false` 让 error.ts 同时进 `dist/index.js` 与 `dist/error.js`，\n * 两份类互不 `instanceof`。字段齐全，只是身份不同 —— 识别出来复制成本地实例。\n */\nfunction isForeignVobsError(value: unknown): value is Error & VobsErrorOptions {\n  return value instanceof Error\n    && value.name === 'VobsError'\n    && typeof (value as { code?: unknown }).code === 'string'\n}\n\n/** 兜底取消息：至少要能读出对象上的 message，别再输出 `[object Object]`。 */\nfunction describeUnknown(value: unknown): string {\n  if (value === null || value === undefined) return String(value)\n  if (typeof value === 'string') return value\n  if (typeof value === 'object') {\n    const message = (value as { message?: unknown }).message\n    if (typeof message === 'string' && message !== '') return message\n    try {\n      return JSON.stringify(value) ?? String(value)\n    } catch {\n      return String(value)\n    }\n  }\n  return String(value)\n}\n\n/** 把任意来源的「类 VobsError」字段复制成本地实例。 */\nfunction adoptVobsError(\n  value: VobsErrorOptions & { cause?: unknown },\n  defaults: VobsErrorDefaults\n): VobsError {\n  return new VobsError({\n    code: value.code,\n    message: value.message,\n    severity: value.severity ?? defaults.severity,\n    layer: value.layer ?? defaults.layer,\n    cause: value.cause ?? (value instanceof Error ? value : undefined),\n    fix: value.fix ?? defaults.fix,\n    location: value.location,\n    trace: value.trace,\n    example: value.example,\n    docs: value.docs,\n    codeFrame: value.codeFrame\n  })\n}\n\n/** Convert thrown strings and third-party errors without losing their message. */\nexport function normalizeVobsError(value: unknown, defaults: VobsErrorDefaults = {}): VobsError {\n  // 本地实例：原样返回，保持同一性与已有 stack\n  if (value instanceof VobsError) return value\n\n  // 别的副本造的：复制成本地实例，下游 instanceof 才成立\n  if (isForeignVobsError(value)) return adoptVobsError(value, defaults)\n\n  if (value instanceof Error) {\n    // Preserve the original Error identity so boundaries and DevTools can\n    // correlate event/effect phases without creating duplicate diagnostics.\n    const metadata = value as Error & {\n      readonly vobsCode?: unknown\n      readonly vobsHint?: unknown\n      readonly vobsSource?: unknown\n    }\n    const code = defaults.code ?? (typeof metadata.vobsCode === 'string' ? metadata.vobsCode : undefined)\n    if (code) {\n      defineErrorMetadata(value, 'code', code)\n      /*\n       * 冻结 / 不可扩展的第三方 Error 上挂不上元数据。原来这里静默吞掉，\n       * 于是 normalize 的结果 code 是 undefined（打印成 VOBS_UNKNOWN）。\n       * 挂不上就复制成本地实例，别把 code 丢了。\n       */\n      if ((value as { code?: unknown }).code !== code) {\n        return new VobsError({\n          code,\n          message: value.message,\n          severity: defaults.severity ?? 'error',\n          layer: defaults.layer ?? 'runtime',\n          cause: value,\n          fix: defaults.fix ?? (typeof metadata.vobsHint === 'string' ? metadata.vobsHint : undefined)\n        })\n      }\n    }\n    defineErrorMetadata(value, 'severity', defaults.severity ?? 'error')\n    defineErrorMetadata(value, 'layer', defaults.layer ?? 'runtime')\n    const fix = defaults.fix ?? (typeof metadata.vobsHint === 'string' ? metadata.vobsHint : undefined)\n    if (fix) defineErrorMetadata(value, 'fix', fix)\n    const source = metadata.vobsSource\n    if (source && typeof source === 'object'\n      && typeof (source as { file?: unknown }).file === 'string'\n      && typeof (source as { line?: unknown }).line === 'number'\n      && typeof (source as { column?: unknown }).column === 'number') {\n      defineErrorMetadata(value, 'location', source)\n    }\n    return value as VobsError\n  }\n\n  // 结构化对象（可能缺 layer，甚至缺 severity）：补齐后构造成本地 VobsError\n  if (isVobsError(value)) return adoptVobsError(value as VobsErrorOptions, defaults)\n\n  return new VobsError({\n    code: defaults.code ?? 'VOBS_UNKNOWN',\n    message: describeUnknown(value),\n    severity: defaults.severity ?? 'error',\n    layer: defaults.layer ?? 'runtime',\n    cause: undefined,\n    fix: defaults.fix\n  })\n}\n\nfunction defineErrorMetadata(target: Error, key: string, value: unknown): void {\n  if (key in target) return\n  try {\n    Object.defineProperty(target, key, { configurable: true, enumerable: false, value, writable: true })\n  } catch {\n    // 冻结 / 不可扩展的第三方 Error：元数据挂不上。调用方会用「写完再读回」判断\n    // 是否成功，失败时改成复制成本地实例，而不是静默丢掉 code。\n  }\n}\n\nexport interface FormatVobsErrorOptions {\n  readonly environment?: 'development' | 'production'\n  readonly includeStack?: boolean\n}\n\n/** Format a concise, actionable message for terminals and dev overlays. */\nexport function formatVobsError(\n  value: unknown,\n  options: FormatVobsErrorOptions = {}\n): string {\n  const error = normalizeVobsError(value)\n  const code = error.code || 'VOBS_UNKNOWN'\n  const severity = error.severity || 'error'\n  if (options.environment === 'production') return `[Vobs ${code}] ${error.message}`\n\n  const lines = [`[Vobs ${capitalize(severity)}] ${error.message}`, `Code: ${code}`]\n  if (error.location) lines.push(`Location: ${error.location.file}:${error.location.line}:${error.location.column}`)\n  if (error.codeFrame) lines.push('', error.codeFrame)\n  if (error.cause !== undefined) lines.push(`Cause: ${formatCause(error.cause)}`)\n  if (error.trace?.length) lines.push('', `Trace: ${error.trace.join(' → ')}`)\n  if (error.fix) lines.push('', `Fix: ${error.fix}`)\n  if (error.example) lines.push('', `Example:\\n${error.example}`)\n  if (error.docs) lines.push(`Docs: ${error.docs}`)\n  if (options.includeStack && error.stack) lines.push('', error.stack)\n  return lines.join('\\n')\n}\n\nfunction formatCause(value: unknown): string {\n  return value instanceof Error ? `${value.name}: ${value.message}` : String(value)\n}\n\nfunction capitalize(value: string): string {\n  return value.slice(0, 1).toUpperCase() + value.slice(1)\n}\n","import type { VobsNode } from './fragment'\nimport { formatVobsError } from './error'\n\nexport type HmrComponent<Props extends object = Record<string, unknown>> =\n  (props: Props) => VobsNode\n\nexport interface HmrStateStore {\n  get<T>(key: string, initial: T | (() => T)): T\n  set<T>(key: string, value: T): void\n  has(key: string): boolean\n  delete(key: string): void\n  clear(): void\n}\n\nexport interface HmrInstance {\n  node: VobsNode\n  parent: Node | null\n  refresh(): void\n}\n\ninterface HmrModuleState {\n  readonly components: Map<string, HmrComponent>\n  readonly state: Map<string, unknown>\n  readonly instances: Set<HmrInstance>\n}\n\ninterface HmrGlobal {\n  modules: Map<string, HmrModuleState>\n  /** 编译器生成的 hmrStateRef 注册表：键为 `${moduleId}#${声明名}`，值跨模块重执行保活。 */\n  states: Map<string, unknown>\n}\n\nconst globalTarget = globalThis as typeof globalThis & { __VOBS_HMR__?: HmrGlobal }\nconst hmrGlobal = globalTarget.__VOBS_HMR__ ?? { modules: new Map<string, HmrModuleState>(), states: new Map<string, unknown>() }\nglobalTarget.__VOBS_HMR__ = hmrGlobal\n\nexport function resolveComponent<Props extends object>(\n  component: HmrComponent<Props>,\n  moduleId: string,\n  exportName: string\n): HmrComponent<Props> {\n  const module = getModule(moduleId)\n  const existing = module.components.get(exportName)\n  if (existing) return existing as HmrComponent<Props>\n\n  const proxy = ((props: Props) => {\n    const current = (proxy as HmrComponent<Props> & { current: HmrComponent<Props> }).current\n    return current(props)\n  }) as HmrComponent<Props> & { current: HmrComponent<Props> }\n  proxy.current = component\n  Object.defineProperties(proxy, {\n    displayName: { configurable: true, value: component.name || exportName },\n    hmrKey: { configurable: false, value: `${moduleId}:${exportName}` }\n  })\n  module.components.set(exportName, proxy as HmrComponent)\n  return proxy\n}\n\nexport function updateHmrModule(moduleId: string, nextModule: Record<string, unknown>): void {\n  const module = hmrGlobal.modules.get(moduleId)\n  if (!module) return\n  let changed = false\n  for (const [name, proxy] of module.components) {\n    const next = nextModule[name]\n    if (typeof next !== 'function') continue\n    const hmrProxy = proxy as HmrComponent & { current: HmrComponent; displayName?: string }\n    hmrProxy.current = next as HmrComponent\n    Object.defineProperty(hmrProxy, 'displayName', { configurable: true, value: next.name || name })\n    changed = true\n  }\n  if (!changed) return\n  // 快照后正序遍历：实例在自身渲染开始前注册，祖先必然先于后代入列——\n  // 祖先先刷新会 dispose 上一轮渲染作用域，其树内旧后代实例的 refresh\n  // 命中已销毁守卫被跳过，避免同一组件在一次热更新中重渲染两次。\n  // 同时 refresh 重渲染以新代码创建的全新实例不在快照中，天然不会再刷新。\n  const instances = [...module.instances]\n  for (const instance of instances) {\n    try {\n      instance.refresh()\n    } catch (error) {\n      /*\n       * 静默吞掉会让开发者以为热更新成功了，而屏幕上是旧的 —— 最容易被当成\n       * 「改了没生效」查半天。刷新失败本身不冒泡（下一次正常渲染会再抛），\n       * 但必须留下记录。\n       */\n      console.error(formatVobsError(error, { includeStack: true }))\n    }\n  }\n}\n\nexport function disposeHmrModule(_moduleId: string): void {\n  // State and component proxies intentionally survive module disposal.\n}\n\nexport function createHmrStateStore(moduleId: string): HmrStateStore {\n  const state = getModule(moduleId).state\n  return {\n    get<T>(key: string, initial: T | (() => T)): T {\n      if (!state.has(key)) state.set(key, typeof initial === 'function' ? (initial as () => T)() : initial)\n      return state.get(key) as T\n    },\n    set<T>(key: string, value: T): void {\n      state.set(key, value)\n    },\n    has: key => state.has(key),\n    delete: key => { state.delete(key) },\n    clear: () => { state.clear() }\n  }\n}\n\n/**\n * 编译器为模块顶层 state() 声明生成的取值入口。键为 `${moduleId}#${声明名}`，\n * 与手动 store 键空间隔离。模块热更新重执行时复用既有信号实例：旧导入方持有的\n * 实例与新模块实例共享同一份状态，消除\"两份模块、两份状态\"导致的编辑不生效/页面半边失灵。\n */\nexport function hmrStateRef<T>(key: string, create: () => T): T {\n  const states = hmrGlobal.states\n  if (states.has(key)) return states.get(key) as T\n  const value = create()\n  states.set(key, value)\n  return value\n}\n\nexport function registerHmrInstance(moduleId: string, instance: HmrInstance): () => void {\n  const instances = getModule(moduleId).instances\n  instances.add(instance)\n  return () => instances.delete(instance)\n}\n\nexport function markHmrInstanceMounted(node: VobsNode, parent: Node): void {\n  const instance = hmrInstances.get(node as object)\n  if (instance) instance.parent = parent\n}\n\nfunction getModule(moduleId: string): HmrModuleState {\n  let module = hmrGlobal.modules.get(moduleId)\n  if (!module) {\n    module = { components: new Map(), state: new Map(), instances: new Set() }\n    hmrGlobal.modules.set(moduleId, module)\n  }\n  return module\n}\n\nconst hmrInstances = new WeakMap<object, HmrInstance>()\n\nexport function associateHmrInstance(node: VobsNode, instance: HmrInstance): void {\n  hmrInstances.set(node as object, instance)\n}\n"],"mappings":"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","names":[]}