webloom-framework 0.3.0 → 0.4.1

package/dist/messagePortServiceTransport-BYprNvQY.d.ts

@@ -0,0 +1,264 @@
+import { T as PluginSetup, K as Capability, bj as RuntimeUnitImplementationRegistry, aH as PluginIntentSnapshot, aF as PluginIntentController, a$ as ResourceRegistry, aZ as ResourceDefinition, bd as RuntimeSnapshot, R as RuntimeKind, aN as PluginStateKind, Y as CapabilityBridge } from './runtimeTypes-DquUCHz-.js';
+import { R as ReceivePortLedger, a as RuntimeLimitsInput, b as RuntimeBudget } from './sharedWorkerHost-KI7TIGdX.js';
+
+interface RuntimeUnitImplementation {
+    /** 产品标识。 */
+    pluginId: string;
+    /** 稳定运行单元标识。 */
+    unitId: string;
+    /** 当前环境的可执行入口。 */
+    setup: PluginSetup;
+    /** 当前 realm 的 typed capability 定义。 */
+    capabilities?: readonly Capability[];
+}
+/** 创建一个拒绝重复注册、按产品和单元查找实现的运行时注册表。 */
+declare function createRuntimeUnitImplementationRegistry(implementations?: readonly RuntimeUnitImplementation[]): RuntimeUnitImplementationRegistry & {
+    register(implementation: RuntimeUnitImplementation): void;
+    unregister(pluginId: string, unitId: string): void;
+};
+
+interface CreatePluginIntentControllerOptions {
+    /** 当前控制面启动身份；Worker 重启时应传入新值。 */
+    authorityInstanceId?: string;
+    /** Worker 恢复后读取的平台意图。 */
+    initial?: Partial<PluginIntentSnapshot>;
+    /** 将候选快照原子写入平台存储；缺省表示内存控制面（测试用）。 */
+    persist?: (snapshot: PluginIntentSnapshot) => Promise<void>;
+    /** 有界去重记录数量，避免 commandId 永久增长。 */
+    maxCommandRecords?: number;
+}
+/** 创建单一控制面上的插件意图控制器。 */
+declare function createPluginIntentController(options?: CreatePluginIntentControllerOptions): PluginIntentController;
+
+/**
+ * 资源注册表实现
+ *
+ * 设计缘由：管理资源定义的注册和查询，支持 owner-aware 生命周期。
+ * 重复 id 抛错，disable 时可回收。
+ */
+
+/** 资源注册表实现 */
+declare function createResourceRegistry(): ResourceRegistry;
+/** Internal runtime hook; deliberately absent from ResourceRegistry's public type. */
+declare function registerOwnedResource(registry: ResourceRegistry, ownerId: string, definition: ResourceDefinition<any, any>): void;
+
+declare const RUNTIME_PROTOCOL_VERSION: "webloom.runtime.v1";
+declare const RUNTIME_SNAPSHOT_TYPE: "webloom.runtime.v1.snapshot";
+declare const RUNTIME_ERROR_TYPE: "webloom.runtime.v1.runtime-error";
+declare const RUNTIME_CALL_TYPE: "webloom.runtime.v1.call";
+declare const RUNTIME_RESULT_TYPE: "webloom.runtime.v1.result";
+declare const RUNTIME_ERROR_MESSAGE_TYPE: "webloom.runtime.v1.error";
+declare const RUNTIME_CANCEL_TYPE: "webloom.runtime.v1.cancel";
+declare const RUNTIME_NEXT_TYPE: "webloom.runtime.v1.next";
+declare const RUNTIME_CREDIT_TYPE: "webloom.runtime.v1.credit";
+interface RuntimeSnapshotUnit {
+    /** 插件标识。 */
+    readonly pluginId: string;
+    /** 单元标识。 */
+    readonly unitId: string;
+    /** Runtime。 */
+    readonly runtime: RuntimeKind;
+    /** 实例标识。 */
+    readonly instanceId?: string;
+    /** 状态。 */
+    readonly state: PluginStateKind;
+}
+type RuntimeSnapshotMessage = RuntimeSnapshot & {
+    readonly type: typeof RUNTIME_SNAPSHOT_TYPE;
+};
+interface RuntimeErrorMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_ERROR_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** 结构化错误码。 */
+    readonly code: string;
+    /** 脱敏消息。 */
+    readonly message: string;
+    /** 失败阶段。 */
+    readonly phase: "validate" | "wait" | "dispatch" | "execute" | "receive" | "dispose";
+    /** 可选插件标识。 */
+    readonly pluginId?: string;
+    /** 可选单元标识。 */
+    readonly unitId?: string;
+}
+interface RuntimeCallMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_CALL_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** 方向内唯一 call id。 */
+    readonly callId: string;
+    /** capability 标识。 */
+    readonly capabilityId: string;
+    /** 契约版本。 */
+    readonly contractVersion: string;
+    /** exposure 身份。 */
+    readonly serviceInstanceId: string;
+    /** 调用模式。 */
+    readonly mode: "unary" | "stream";
+    /** 本次派发的剩余预算。 */
+    readonly timeoutMs: number;
+    /** 已 parser 验证的请求。 */
+    readonly request: unknown;
+    /** 产品操作标识。 */
+    readonly operationId?: string;
+    /** 领域授权标识。 */
+    readonly grantId?: string;
+    /** stream 初始 credit。 */
+    readonly initialCredit?: number;
+}
+interface RuntimeUnaryResultMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_RESULT_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** call id。 */
+    readonly callId: string;
+    /** exposure 身份。 */
+    readonly serviceInstanceId: string;
+    /** unary 结果。 */
+    readonly result: unknown;
+}
+interface RuntimeStreamReadyMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_RESULT_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** call id。 */
+    readonly callId: string;
+    /** exposure 身份。 */
+    readonly serviceInstanceId: string;
+    /** stream 建立确认。 */
+    readonly streamReady: true;
+}
+interface RuntimeStreamDoneMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_RESULT_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** call id。 */
+    readonly callId: string;
+    /** exposure 身份。 */
+    readonly serviceInstanceId: string;
+    /** stream 正常结束。 */
+    readonly done: true;
+}
+type RuntimeResultMessage = RuntimeUnaryResultMessage | RuntimeStreamReadyMessage | RuntimeStreamDoneMessage;
+interface RuntimeErrorResponseMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_ERROR_MESSAGE_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** call id。 */
+    readonly callId: string;
+    /** exposure 身份。 */
+    readonly serviceInstanceId: string;
+    /** 结构化错误。 */
+    readonly error: {
+        readonly code: string;
+        readonly message: string;
+        readonly phase: RuntimeErrorMessage["phase"];
+        readonly details?: Readonly<Record<string, unknown>>;
+    };
+}
+interface RuntimeCancelMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_CANCEL_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** call id。 */
+    readonly callId: string;
+    /** exposure 身份。 */
+    readonly serviceInstanceId: string;
+}
+interface RuntimeNextMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_NEXT_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** call id。 */
+    readonly callId: string;
+    /** exposure 身份。 */
+    readonly serviceInstanceId: string;
+    /** 连续序号。 */
+    readonly sequence: number;
+    /** parser 验证的 item。 */
+    readonly item: unknown;
+}
+interface RuntimeCreditMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_CREDIT_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** call id。 */
+    readonly callId: string;
+    /** exposure 身份。 */
+    readonly serviceInstanceId: string;
+    /** 新增 credit。 */
+    readonly count: number;
+}
+type RuntimeWireMessage = RuntimeSnapshotMessage | RuntimeErrorMessage | RuntimeCallMessage | RuntimeResultMessage | RuntimeErrorResponseMessage | RuntimeCancelMessage | RuntimeNextMessage | RuntimeCreditMessage;
+interface RuntimeMessageCodec {
+    /** 严格验证并冻结 v4 message。 */
+    encode(message: RuntimeWireMessage): RuntimeWireMessage;
+    /** 严格解析 v4 message；旧协议直接拒绝。 */
+    decode(value: unknown): RuntimeWireMessage;
+}
+declare function createRuntimeMessageCodec(): RuntimeMessageCodec;
+declare function isRuntimeSnapshot(value: RuntimeWireMessage): value is RuntimeSnapshotMessage;
+
+interface RuntimeReceiveMetadata {
+    /** 本次 MessageEvent 实际携带的业务 MessagePort；仅 transport 本地使用。 */
+    readonly ports?: readonly MessagePort[];
+    /** 由物理 endpoint transport 创建的一次性接收资源账本。 */
+    readonly ledger?: ReceivePortLedger;
+    /** 物理 endpoint 已完成一次 codec decode。 */
+    readonly decoded?: boolean;
+}
+interface RuntimeTransport {
+    /** 发送已验证 v4 message；transfer 由契约 extractor 提供。 */
+    send(message: RuntimeWireMessage, transfer?: readonly Transferable[]): void;
+    /** 订阅接收 message 及本次事件的本地 transfer 元数据。 */
+    subscribe(listener: (message: RuntimeWireMessage, metadata?: RuntimeReceiveMetadata) => void): () => void;
+    /** 关闭本端传输。 */
+    close?(): void;
+    /** 物理 endpoint 对 decode/接收账本错误的统一通知。 */
+    subscribeError?(listener: (error: unknown, metadata?: RuntimeReceiveMetadata) => void): () => void;
+}
+interface CreateCapabilityBridgeOptions {
+    /** 底层双向 transport。 */
+    readonly transport: RuntimeTransport;
+    /** 预期的对端 Runtime 类型。 */
+    readonly remoteRuntimeKind?: RuntimeKind;
+    /** 预期的对端逻辑 Runtime id。 */
+    readonly remoteRuntimeId?: string;
+    /** 默认调用预算。 */
+    readonly defaultCallTimeoutMs?: number;
+    /** 可信 Runtime/advanced 装配提供的预算；只能收紧 v4 默认值。 */
+    readonly limits?: RuntimeLimitsInput;
+    /** 可选的 Runtime 方向共享计数器。 */
+    readonly budget?: RuntimeBudget;
+}
+/** 创建按 peer 绑定、可撤销且支持 typed stream 的 bridge。 */
+declare function createCapabilityBridge(options: CreateCapabilityBridgeOptions): CapabilityBridge & {
+    readonly pendingCallCount: number;
+    readonly activeStreamCount: number;
+    readonly retainedPayloadBytes: number;
+};
+/** 内部 typed transfer 校验 helper；不接受 call 级临时 transfer 数组。 */
+declare function validateTransferables(value: unknown, transfer: readonly Transferable[] | undefined, limits?: RuntimeLimitsInput): readonly Transferable[];
+
+interface MessagePortLike {
+    addEventListener(type: "message" | "messageerror", listener: (event: MessageEvent) => void): void;
+    removeEventListener(type: "message" | "messageerror", listener: (event: MessageEvent) => void): void;
+    postMessage(message: unknown, transfer?: readonly Transferable[]): void;
+    start?(): void;
+    close?(): void;
+}
+/** 将一个真实 MessagePort 绑定为双向 v4 transport。 */
+declare function createMessagePortRuntimeTransport(port: MessagePortLike, options?: {
+    readonly limits?: RuntimeLimitsInput;
+}): RuntimeTransport;
+
+export { createCapabilityBridge as A, createMessagePortRuntimeTransport as B, type CreateCapabilityBridgeOptions as C, createPluginIntentController as D, createResourceRegistry as E, createRuntimeMessageCodec as F, createRuntimeUnitImplementationRegistry as G, isRuntimeSnapshot as H, registerOwnedResource as I, validateTransferables as J, type MessagePortLike as M, type RuntimeCallMessage as R, type RuntimeTransport as a, type CreatePluginIntentControllerOptions as b, RUNTIME_CALL_TYPE as c, RUNTIME_CANCEL_TYPE as d, RUNTIME_CREDIT_TYPE as e, RUNTIME_ERROR_MESSAGE_TYPE as f, RUNTIME_ERROR_TYPE as g, RUNTIME_NEXT_TYPE as h, RUNTIME_PROTOCOL_VERSION as i, RUNTIME_RESULT_TYPE as j, RUNTIME_SNAPSHOT_TYPE as k, type RuntimeCancelMessage as l, type RuntimeCreditMessage as m, type RuntimeErrorMessage as n, type RuntimeErrorResponseMessage as o, type RuntimeMessageCodec as p, type RuntimeNextMessage as q, type RuntimeReceiveMetadata as r, type RuntimeResultMessage as s, type RuntimeSnapshotMessage as t, type RuntimeSnapshotUnit as u, type RuntimeStreamDoneMessage as v, type RuntimeStreamReadyMessage as w, type RuntimeUnaryResultMessage as x, type RuntimeUnitImplementation as y, type RuntimeWireMessage as z };

package/dist/react.d.ts

@@ -1,57 +1,70 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { m as PluginHost, ad as PluginState, a as PluginGraph, c as PluginReverseDep, aa as PluginIntentSubmissionResult, P as PluginManifest, aF as ResourceStoreApi, aD as ResourceSnapshot } from './createPluginHost-BVsUCDKN.js';
+import { W as WindowApp, l as RuntimeHandle, K as Capability, Z as CapabilityClient, X as AppLike, aM as PluginState, a as PluginGraph, c as PluginReverseDep, aI as PluginIntentSubmissionResult, P as PluginManifest, C as CapabilityDescriptor, k as ResourceStoreApi, b0 as ResourceSnapshot } from './runtimeTypes-DquUCHz-.js';
 
-declare const PluginHostContext: react.Context<PluginHost | undefined>;
-interface PluginHostProviderProps {
-    host: PluginHost;
-    children: ReactNode;
+type WebLoomApp = WindowApp | RuntimeHandle;
+declare const WebLoomContext: react.Context<WebLoomApp | undefined>;
+interface WebLoomProviderProps {
+    /** 稳定的 WindowApp 或 RuntimeHandle。 */
+    readonly app: WebLoomApp;
+    /** React 子树。 */
+    readonly children: ReactNode;
 }
-declare function PluginHostProvider({ host, children }: PluginHostProviderProps): react_jsx_runtime.JSX.Element;
-declare function usePluginHost(): PluginHost;
-/**
- * 订阅 host.version：host 每次 enable / disable / unregister 后 version 递增，
- * 订阅组件会重新渲染。这是"硬切换 001"让 React 层感知 host 变化的关键 hook。
- */
-declare function useHostVersion(): number;
+declare function WebLoomProvider({ app, children }: WebLoomProviderProps): react_jsx_runtime.JSX.Element;
+declare function useWebLoomApp(): WebLoomApp;
+/** app 状态的稳定外部订阅；hook 实现按 selector 再做引用保持。 */
+declare function useAppSubscription(): WebLoomApp;
 
-declare function useCapability<T>(key: string): T;
-/** 读取可选兼容 capability；缺失时返回 undefined，不把页面渲染打崩。 */
-declare function useOptionalCapability<T>(key: string): T | undefined;
-declare function useHasCapability(key: string): boolean;
+/** 获取 typed capability；远程 proxy 的构造本身不等待 Worker。 */
+declare function useCapability<C extends Capability>(capability: C): CapabilityClient<C>;
+/** 当前目录没有 capability 时返回 undefined。 */
+declare function useOptionalCapability<C extends Capability>(capability: C): CapabilityClient<C> | undefined;
+/** 对 typed capability 做当前目录查询。 */
+declare function useHasCapability<C extends Capability>(capability: C): boolean;
 
-declare function useRegistry<T>(selector: (host: PluginHost) => T): T;
+/** 从 App 诊断快照派生无领域 selector。 */
+declare function useRegistry<T>(selector: (app: AppLike) => T): T;
 
 interface UsePluginRuntime {
+    /** 读取插件状态。 */
     state(id: string): PluginState;
+    /** 读取静态图。 */
     graph(): PluginGraph;
-    reverseDeps(id: string): PluginReverseDep[];
+    /** 读取反向依赖。 */
+    reverseDeps(id: string): readonly PluginReverseDep[];
+    /** 启动插件。 */
     enable(id: string): Promise<void>;
+    /** 停止插件。 */
     disable(id: string): Promise<{
         ok: true;
     } | {
         ok: false;
         reason: string;
     }>;
-    /** 提交产品级绝对启停意图；accepted 只表示意图已持久化。 */
+    /** 提交启停意图。 */
     submitIntent(id: string, desiredEnabled: boolean): Promise<PluginIntentSubmissionResult>;
+    /** 删除插件。 */
     unregister(id: string): Promise<void>;
+    /** Host/App 修订。 */
     version(): number;
+    /** 插件 id。 */
     manifests(): string[];
+    /** 插件 id。 */
     installed(): string[];
+    /** 当前是否运行。 */
     isEnabled(id: string): boolean;
-    /** 拿单条 plugin 的 manifest。id 未知时返回 undefined。 */
+    /** 清单。 */
     getManifest(id: string): PluginManifest | undefined;
-    /**
-     * 探测 capability 是否存在。供 UI 判断"依赖的 capability 是否满足"，
-     * 依赖列表里写的是 capability key（如 "route.registry"），不是 plugin id。
-     */
-    hasCapability(key: string): boolean;
+    /** typed descriptor 当前是否已暴露。 */
+    hasCapability(capability: CapabilityDescriptor): boolean;
 }
+/** 领域插件管理 hook；只能在 WindowApp 上使用。 */
 declare function usePluginRuntime(): UsePluginRuntime;
-/** 旧调用方兼容：单纯拿 host 引用。 */
-declare function useHost(): PluginHost;
+/** 精确订阅一个插件的状态。 */
+declare function usePluginState(pluginId: string): PluginState | undefined;
+/** 读取 App 状态的 selector；无关状态变化保持上一次选择结果。 */
+declare function useRuntimeSelector<T>(selector: (snapshot: ReturnType<ReturnType<typeof useWebLoomApp>["state"]>) => T, equality?: (left: T, right: T) => boolean): T;
 
 /**
  * useResource React Hook
@@ -77,4 +90,4 @@ declare function countRender(name: string): void;
 declare function getRenderCount(name: string): number;
 declare function resetRenderCounters(): void;
 
-export { PluginHostContext, PluginHostProvider, type PluginHostProviderProps, type UsePluginRuntime, countRender, getRenderCount, resetRenderCounters, useCapability, useHasCapability, useHost, useHostVersion, useOptionalCapability, usePluginHost, usePluginRuntime, useRegistry, useResource, useResourceSelector };
+export { type UsePluginRuntime, type WebLoomApp, WebLoomContext, WebLoomProvider, type WebLoomProviderProps, countRender, getRenderCount, resetRenderCounters, useAppSubscription, useCapability, useHasCapability, useOptionalCapability, usePluginRuntime, usePluginState, useRegistry, useResource, useResourceSelector, useRuntimeSelector, useWebLoomApp };

package/dist/react.js

@@ -1,98 +1,89 @@
-import { createContext, useState, useEffect, useContext, useMemo, useCallback, useSyncExternalStore, useRef } from 'react';
+import { hostForWindowApp } from './chunk-HJKPKWI7.js';
+import { createContext, useContext, useCallback, useSyncExternalStore, useMemo, useRef } from 'react';
 import { jsx } from 'react/jsx-runtime';
 
-// src/react/PluginHostProvider.tsx
-var PluginHostContext = createContext(void 0);
-function PluginHostProvider({ host, children }) {
-  const [version, setVersion] = useState(host.version());
-  useEffect(() => {
-    return host.subscribe((snap) => {
-      setVersion(snap.version);
-    });
-  }, [host]);
-  return /* @__PURE__ */ jsx(PluginHostContext.Provider, { value: host, children });
-}
-function usePluginHost() {
-  const host = useContext(PluginHostContext);
-  if (!host) throw new Error("PluginHostContext is missing");
-  return host;
-}
-function useHostVersion() {
-  const host = usePluginHost();
-  const [v, setV] = useState(host.version());
-  useEffect(() => host.subscribe((s) => setV(s.version)), [host]);
-  return v;
-}
-function useCapability(key) {
-  const host = usePluginHost();
-  const version = useHostVersion();
-  return useMemo(() => host.capabilities.get(key), [host, version, key]);
-}
-function useOptionalCapability(key) {
-  const host = usePluginHost();
-  const version = useHostVersion();
-  return useMemo(() => host.capabilities.has(key) ? host.capabilities.get(key) : void 0, [host, version, key]);
-}
-function useHasCapability(key) {
-  const host = usePluginHost();
-  const version = useHostVersion();
-  return useMemo(() => host.capabilities.has(key), [host, version, key]);
+var WebLoomContext = createContext(void 0);
+function WebLoomProvider({ app, children }) {
+  return /* @__PURE__ */ jsx(WebLoomContext.Provider, { value: app, children });
 }
-function useRegistry(selector) {
-  const host = usePluginHost();
-  const version = useHostVersion();
-  return useMemo(() => selector(host), [version, host, selector]);
+function useWebLoomApp() {
+  const app = useContext(WebLoomContext);
+  if (!app) throw new Error("WebLoomProvider is missing");
+  return app;
+}
+function useAppSubscription() {
+  return useWebLoomApp();
+}
+function subscribeApp(app, listener) {
+  return app.subscribe(listener);
+}
+function useCapability(capability) {
+  const app = useWebLoomApp();
+  const subscribe = useCallback((listener) => subscribeApp(app, listener), [app]);
+  const getSnapshot = useCallback(() => app.capability(capability), [app, capability]);
+  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+function useOptionalCapability(capability) {
+  const app = useWebLoomApp();
+  const subscribe = useCallback((listener) => subscribeApp(app, listener), [app]);
+  const getSnapshot = useCallback(() => app.optionalCapability(capability), [app, capability]);
+  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+function useHasCapability(capability) {
+  return useOptionalCapability(capability) !== void 0;
+}
+function hostFor(app) {
+  return hostForWindowApp(app);
 }
 function usePluginRuntime() {
-  const host = usePluginHost();
-  const version = useHostVersion();
+  const app = useWebLoomApp();
+  const subscribe = useCallback((listener) => app.subscribe(listener), [app]);
+  const getSnapshot = useCallback(() => app.state(), [app]);
+  const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
   return useMemo(() => {
-    const api = {
-      state(id) {
-        return host.state(id);
-      },
-      graph() {
-        return host.graph();
-      },
-      reverseDeps(id) {
-        return host.reverseDeps(id);
-      },
-      enable(id) {
-        return host.enable(id);
-      },
-      disable(id) {
-        return host.disable(id);
-      },
-      submitIntent(id, desiredEnabled) {
-        return host.submitIntent(id, desiredEnabled);
-      },
-      unregister(id) {
-        return host.unregister(id);
-      },
-      version() {
-        return host.version();
-      },
-      manifests() {
-        return host.manifests();
-      },
-      installed() {
-        return host.installed();
-      },
-      isEnabled(id) {
-        return host.state(id).kind === "enabled";
-      },
-      getManifest(id) {
-        return host.getManifest(id);
-      },
-      hasCapability(key) {
-        return host.capabilities.has(key);
-      }
+    if (app.runtimeKind !== "window-main") throw new Error("Plugin runtime controls require a WindowApp");
+    const host = hostFor(app);
+    return {
+      state: (id) => host.state(id),
+      graph: () => host.graph(),
+      reverseDeps: (id) => host.reverseDeps(id),
+      enable: (id) => host.enable(id),
+      disable: (id) => host.disable(id),
+      submitIntent: (id, desiredEnabled) => host.submitIntent(id, desiredEnabled),
+      unregister: (id) => host.unregister(id),
+      version: () => snapshot.revision,
+      manifests: () => host.manifests(),
+      installed: () => host.installed(),
+      isEnabled: (id) => host.state(id).kind === "enabled",
+      getManifest: (id) => host.getManifest(id),
+      hasCapability: (capability) => host.capabilities.has(capability)
     };
-    return api;
-  }, [host, version]);
+  }, [app, snapshot.revision]);
+}
+function usePluginState(pluginId) {
+  const app = useWebLoomApp();
+  const subscribe = useCallback((listener) => app.subscribe(listener), [app]);
+  const getSnapshot = useCallback(() => app.pluginState?.(pluginId), [app, pluginId]);
+  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+function useRuntimeSelector(selector, equality = Object.is) {
+  const app = useWebLoomApp();
+  const last = useMemo(() => ({ has: false, value: void 0 }), []);
+  const subscribe = useCallback((listener) => app.subscribe(listener), [app]);
+  const getSnapshot = useCallback(() => {
+    const next = selector(app.state());
+    if (last.has && equality(last.value, next)) return last.value;
+    last.has = true;
+    last.value = next;
+    return next;
+  }, [app, selector, equality, last]);
+  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
 }
-function useHost() {
-  return usePluginHost();
+
+// src/react/useRegistry.ts
+function useRegistry(selector) {
+  const app = useWebLoomApp();
+  return useRuntimeSelector(() => selector(app));
 }
 function useResource(store, definitionId, args) {
   const subscribe = useCallback((callback) => {
@@ -172,6 +163,6 @@ function resetRenderCounters() {
   counters.clear();
 }
 
-export { PluginHostContext, PluginHostProvider, countRender, getRenderCount, resetRenderCounters, useCapability, useHasCapability, useHost, useHostVersion, useOptionalCapability, usePluginHost, usePluginRuntime, useRegistry, useResource, useResourceSelector };
+export { WebLoomContext, WebLoomProvider, countRender, getRenderCount, resetRenderCounters, useAppSubscription, useCapability, useHasCapability, useOptionalCapability, usePluginRuntime, usePluginState, useRegistry, useResource, useResourceSelector, useRuntimeSelector, useWebLoomApp };
 //# sourceMappingURL=react.js.map
 //# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react/PluginHostProvider.tsx","../src/react/useCapability.ts","../src/react/useRegistry.ts","../src/react/usePluginRuntime.ts","../src/react/useResource.ts","../src/react/useResourceSelector.ts","../src/react/renderCounter.ts"],"names":["useMemo","useCallback","useSyncExternalStore"],"mappings":"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","file":"react.js","sourcesContent":["// packages/runtime/src/react/PluginHostProvider.tsx\n// 把 PluginHost 注入 React 树。\n// 设计缘由：组件层只通过 hooks 访问能力，不要直接 import 内部模块。\n// 硬切换 001：host 进入运行期可卸载，host.version 变化要触发订阅者重渲染。\n\nimport { createContext, type ReactNode, useContext, useEffect, useState } from \"react\";\nimport type { PluginHost } from \"../host/createPluginHost.js\";\n\nexport const PluginHostContext = createContext<PluginHost | undefined>(undefined);\n\nexport interface PluginHostProviderProps {\n  host: PluginHost;\n  children: ReactNode;\n}\n\nexport function PluginHostProvider({ host, children }: PluginHostProviderProps) {\n  // 订阅 host 变化：每次 enable / disable / unregister 后 bump version，\n  // 我们把 version 透到 state 触发子树重渲染（hooks 自身也用 useHostVersion）。\n  const [version, setVersion] = useState<number>(host.version());\n  useEffect(() => {\n    return host.subscribe((snap) => {\n      setVersion(snap.version);\n    });\n  }, [host]);\n  // version 仅作为\"key 变化\"挂在这里，不再通过 context 暴露（避免误用）。\n  void version;\n  return <PluginHostContext.Provider value={host}>{children}</PluginHostContext.Provider>;\n}\n\nexport function usePluginHost(): PluginHost {\n  const host = useContext(PluginHostContext);\n  if (!host) throw new Error(\"PluginHostContext is missing\");\n  return host;\n}\n\n/**\n * 订阅 host.version：host 每次 enable / disable / unregister 后 version 递增，\n * 订阅组件会重新渲染。这是\"硬切换 001\"让 React 层感知 host 变化的关键 hook。\n */\nexport function useHostVersion(): number {\n  const host = usePluginHost();\n  const [v, setV] = useState<number>(host.version());\n  useEffect(() => host.subscribe((s) => setV(s.version)), [host]);\n  return v;\n}\n","// packages/runtime/src/react/useCapability.ts\n// 组件读取 capability 的唯一入口。\n// 设计缘由：业务组件不得直接调用 host.capabilities.get()，\n// 一律通过 hook 走，确保调用路径可观察。\n//\n// 硬切换 001：capability 在 plugin disable 时被 revoke。\n// 组件如果仍然用 has/capability 缓存结果，旧值会\"看起来还能用\"。\n// 改为基于 host.version 重新求值：disable 后 version 递增 -> 重渲染 ->\n// has/capability 走新值。\n\nimport { useMemo } from \"react\";\nimport { usePluginHost, useHostVersion } from \"./PluginHostProvider.js\";\n\nexport function useCapability<T>(key: string): T {\n  const host = usePluginHost();\n  const version = useHostVersion();\n  return useMemo(() => host.capabilities.get<T>(key), [host, version, key]);\n}\n\n/** 读取可选兼容 capability；缺失时返回 undefined，不把页面渲染打崩。 */\nexport function useOptionalCapability<T>(key: string): T | undefined {\n  const host = usePluginHost();\n  const version = useHostVersion();\n  return useMemo(() => host.capabilities.has(key) ? host.capabilities.get<T>(key) : undefined, [host, version, key]);\n}\n\nexport function useHasCapability(key: string): boolean {\n  const host = usePluginHost();\n  const version = useHostVersion();\n  return useMemo(() => host.capabilities.has(key), [host, version, key]);\n}\n","// packages/runtime/src/react/useRegistry.ts\n// 通用 registry 读取 hook：基于 host.version 重新计算 selector 输出。\n//\n// 硬切换 001：runtime 进入热卸载模型后，host 可能在 React 挂载后变化。\n// 我们用 useHostVersion() 触发重新计算；selector 仍然纯同步（host 是稳定\n// 引用），不会出现 useSyncExternalStore 那种 snapshot 误判。\n//\n// 用法：\n//   const routes = useRegistry(h => h.routes.list());\n//   const route = useRegistry(h => h.routes.byPath('/poker'));\n// 不再假定\"host 挂载后不变\"。\n\nimport { useMemo } from \"react\";\nimport type { PluginHost } from \"../host/createPluginHost.js\";\nimport { usePluginHost, useHostVersion } from \"./PluginHostProvider.js\";\n\nexport function useRegistry<T>(selector: (host: PluginHost) => T): T {\n  const host = usePluginHost();\n  const version = useHostVersion();\n  // version 变化时强制重算 selector；selector host 是稳定引用。\n  return useMemo(() => selector(host), [version, host, selector]);\n}\n","// packages/runtime/src/react/usePluginRuntime.ts\n// 插件运行时操作 hook。\n// 设计缘由（硬切换 001）：\n//   - UI 层（plugin manager）需要 enable / disable 插件。\n//   - 业务组件可能需要查 graph / state。\n//   - 把这些操作收拢到 hook，调用方拿到的是一个稳定 API 对象。\n\nimport { useMemo } from \"react\";\nimport type { PluginGraph, PluginState, PluginReverseDep, PluginManifest } from \"../contracts/plugin.js\";\nimport type { PluginIntentSubmissionResult } from \"../contracts/lifecycle.js\";\nimport type { PluginHost } from \"../host/createPluginHost.js\";\nimport { usePluginHost, useHostVersion } from \"./PluginHostProvider.js\";\n\nexport interface UsePluginRuntime {\n  state(id: string): PluginState;\n  graph(): PluginGraph;\n  reverseDeps(id: string): PluginReverseDep[];\n  enable(id: string): Promise<void>;\n  disable(id: string): Promise<{ ok: true } | { ok: false; reason: string }>;\n  /** 提交产品级绝对启停意图；accepted 只表示意图已持久化。 */\n  submitIntent(id: string, desiredEnabled: boolean): Promise<PluginIntentSubmissionResult>;\n  unregister(id: string): Promise<void>;\n  version(): number;\n  manifests(): string[];\n  installed(): string[];\n  isEnabled(id: string): boolean;\n  /** 拿单条 plugin 的 manifest。id 未知时返回 undefined。 */\n  getManifest(id: string): PluginManifest | undefined;\n  /**\n   * 探测 capability 是否存在。供 UI 判断\"依赖的 capability 是否满足\"，\n   * 依赖列表里写的是 capability key（如 \"route.registry\"），不是 plugin id。\n   */\n  hasCapability(key: string): boolean;\n}\n\nexport function usePluginRuntime(): UsePluginRuntime {\n  const host = usePluginHost();\n  const version = useHostVersion();\n  return useMemo<UsePluginRuntime>(() => {\n    const api: UsePluginRuntime = {\n      state(id) {\n        return host.state(id);\n      },\n      graph() {\n        return host.graph();\n      },\n      reverseDeps(id) {\n        return host.reverseDeps(id);\n      },\n      enable(id) {\n        return host.enable(id);\n      },\n      disable(id) {\n        return host.disable(id);\n      },\n      submitIntent(id, desiredEnabled) {\n        return host.submitIntent(id, desiredEnabled);\n      },\n      unregister(id) {\n        return host.unregister(id);\n      },\n      version() {\n        return host.version();\n      },\n      manifests() {\n        return host.manifests();\n      },\n      installed() {\n        return host.installed();\n      },\n      isEnabled(id) {\n        return host.state(id).kind === \"enabled\";\n      },\n      getManifest(id) {\n        return host.getManifest(id);\n      },\n      hasCapability(key) {\n        return host.capabilities.has(key);\n      }\n    };\n    return api;\n  }, [host, version]);\n}\n\n/** 旧调用方兼容：单纯拿 host 引用。 */\nexport function useHost(): PluginHost {\n  return usePluginHost();\n}\n","/**\n * useResource React Hook\n *\n * 设计缘由：负责 ensure + useSyncExternalStore 订阅并返回完整 snapshot。\n * 不暴露 store 内部可变对象。\n */\n\nimport { useCallback, useSyncExternalStore } from \"react\";\nimport type { ResourceSnapshot } from \"../contracts/resource.js\";\nimport type { ResourceStoreApi } from \"../resources/resourceStore.js\";\n\n/** useResource hook：返回完整资源快照 */\nexport function useResource<T>(\n  store: ResourceStoreApi,\n  definitionId: string,\n  args: readonly string[]\n): ResourceSnapshot<T> {\n  const subscribe = useCallback((callback: () => void) => {\n    return store.subscribe(definitionId, args, callback);\n  }, [store, definitionId, ...args]);\n\n  const getSnapshot = useCallback((): ResourceSnapshot<T> => {\n    return store.ensure<T>(definitionId, args);\n  }, [store, definitionId, ...args]);\n\n  const getServerSnapshot = useCallback((): ResourceSnapshot<T> => {\n    // SSR 稳定快照\n    return {\n      key: [definitionId, ...args],\n      status: \"pending\",\n      data: undefined,\n      revision: 0,\n    };\n  }, [definitionId, ...args]);\n\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n}\n","/**\n * useResourceSelector React Hook\n *\n * 设计缘由：只在 selector 结果发生语义变化时重渲染。\n * selector 和 equality 必须为纯函数。\n */\n\nimport { useSyncExternalStore, useCallback, useRef } from \"react\";\nimport type { ResourceSnapshot } from \"../contracts/resource.js\";\nimport type { ResourceStoreApi } from \"../resources/resourceStore.js\";\n\n/** 默认相等判断：Object.is */\nfunction defaultEquality<T>(a: T, b: T): boolean {\n  return Object.is(a, b);\n}\n\n/** useResourceSelector hook：只在 selector 结果变化时重渲染 */\nexport function useResourceSelector<T, TSelected>(\n  store: ResourceStoreApi,\n  definitionId: string,\n  args: readonly string[],\n  selector: (snapshot: ResourceSnapshot<T>) => TSelected,\n  equality: (a: TSelected, b: TSelected) => boolean = defaultEquality\n): TSelected {\n  const selectedRef = useRef<TSelected>();\n  const hasSelectedRef = useRef(false);\n  const sourceSnapshotRef = useRef<ResourceSnapshot<T>>();\n  const selectorRef = useRef(selector);\n  const equalityRef = useRef(equality);\n\n  // 更新 refs\n  selectorRef.current = selector;\n  equalityRef.current = equality;\n\n  const subscribe = useCallback(\n    (callback: () => void) => {\n      return store.subscribe(definitionId, args, callback);\n    },\n    [store, definitionId, ...args]\n  );\n\n  const getSnapshot = useCallback((): TSelected => {\n    const snapshot = store.ensure<T>(definitionId, args);\n\n    // React's useSyncExternalStore requires referentially stable results when\n    // the backing store did not change. A selector may legitimately allocate\n    // (for example `rows.slice().sort(...)`), so equality alone cannot uphold\n    // that requirement when callers use reference equality.\n    if (hasSelectedRef.current && sourceSnapshotRef.current === snapshot) {\n      return selectedRef.current as TSelected;\n    }\n\n    const selected = selectorRef.current(snapshot);\n\n    // 检查是否变化\n    if (\n      hasSelectedRef.current &&\n      equalityRef.current(selectedRef.current as TSelected, selected)\n    ) {\n      sourceSnapshotRef.current = snapshot;\n      return selectedRef.current as TSelected;\n    }\n\n    selectedRef.current = selected as TSelected;\n    hasSelectedRef.current = true;\n    sourceSnapshotRef.current = snapshot;\n    return selected;\n  }, [store, definitionId, ...args]);\n\n  const getServerSnapshot = useCallback((): TSelected => {\n    const snapshot: ResourceSnapshot<T> = {\n      key: [definitionId, ...args],\n      status: \"pending\",\n      data: undefined,\n      revision: 0,\n    };\n    return selectorRef.current(snapshot);\n  }, [definitionId, ...args]);\n\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n}\n","// 仅用于开发/测试观察组件 render 次数；生产构建中保持 no-op。\n\nconst counters = new Map<string, number>();\n\nfunction enabled(): boolean {\n  const env = (import.meta as ImportMeta & { env?: { DEV?: boolean } }).env;\n  return env?.DEV !== false;\n}\n\nexport function countRender(name: string): void {\n  if (!enabled()) return;\n  counters.set(name, (counters.get(name) ?? 0) + 1);\n}\n\nexport function getRenderCount(name: string): number {\n  return counters.get(name) ?? 0;\n}\n\nexport function resetRenderCounters(): void {\n  counters.clear();\n}\n"]}
+{"version":3,"sources":["../src/react/PluginHostProvider.tsx","../src/react/useCapability.ts","../src/react/usePluginRuntime.ts","../src/react/useRegistry.ts","../src/react/useResource.ts","../src/react/useResourceSelector.ts","../src/react/renderCounter.ts"],"names":["useCallback","useSyncExternalStore"],"mappings":"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","file":"react.js","sourcesContent":["// React 绑定只保存 App，不复制一套 Host 状态。\n\nimport { createContext, type ReactNode, useContext } from \"react\";\nimport type { AppLike, RuntimeHandle, WindowApp } from \"../runtime/runtimeTypes.js\";\n\nexport type WebLoomApp = WindowApp | RuntimeHandle;\nexport const WebLoomContext = createContext<WebLoomApp | undefined>(undefined);\n\nexport interface WebLoomProviderProps {\n  /** 稳定的 WindowApp 或 RuntimeHandle。 */\n  readonly app: WebLoomApp;\n  /** React 子树。 */\n  readonly children: ReactNode;\n}\n\nexport function WebLoomProvider({ app, children }: WebLoomProviderProps) {\n  return <WebLoomContext.Provider value={app}>{children}</WebLoomContext.Provider>;\n}\n\nexport function useWebLoomApp(): WebLoomApp {\n  const app = useContext(WebLoomContext);\n  if (!app) throw new Error(\"WebLoomProvider is missing\");\n  return app;\n}\n\n/** app 状态的稳定外部订阅；hook 实现按 selector 再做引用保持。 */\nexport function useAppSubscription(): WebLoomApp {\n  return useWebLoomApp();\n}\n","import { useCallback, useSyncExternalStore } from \"react\";\nimport type { Capability, CapabilityClient } from \"../contracts/capability.js\";\nimport { useWebLoomApp } from \"./PluginHostProvider.js\";\n\nfunction subscribeApp(app: { subscribe(listener: () => void): () => void }, listener: () => void): () => void {\n  return app.subscribe(listener);\n}\n\n/** 获取 typed capability；远程 proxy 的构造本身不等待 Worker。 */\nexport function useCapability<C extends Capability>(capability: C): CapabilityClient<C> {\n  const app = useWebLoomApp();\n  const subscribe = useCallback((listener: () => void) => subscribeApp(app, listener), [app]);\n  const getSnapshot = useCallback(() => (app as unknown as { capability<C extends Capability>(capability: C): CapabilityClient<C> }).capability(capability), [app, capability]);\n  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n/** 当前目录没有 capability 时返回 undefined。 */\nexport function useOptionalCapability<C extends Capability>(capability: C): CapabilityClient<C> | undefined {\n  const app = useWebLoomApp();\n  const subscribe = useCallback((listener: () => void) => subscribeApp(app, listener), [app]);\n  const getSnapshot = useCallback(() => (app as unknown as { optionalCapability<C extends Capability>(capability: C): CapabilityClient<C> | undefined }).optionalCapability(capability), [app, capability]);\n  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n/** 对 typed capability 做当前目录查询。 */\nexport function useHasCapability<C extends Capability>(capability: C): boolean {\n  return useOptionalCapability(capability) !== undefined;\n}\n","import { useCallback, useMemo, useSyncExternalStore } from \"react\";\nimport type { CapabilityDescriptor } from \"../contracts/capability.js\";\nimport type { PluginGraph, PluginManifest, PluginReverseDep, PluginState } from \"../contracts/plugin.js\";\nimport type { PluginIntentSubmissionResult } from \"../contracts/lifecycle.js\";\nimport { hostForWindowApp } from \"../runtime/windowRuntime.js\";\nimport type { WindowApp } from \"../runtime/runtimeTypes.js\";\nimport { useWebLoomApp } from \"./PluginHostProvider.js\";\n\nexport interface UsePluginRuntime {\n  /** 读取插件状态。 */\n  state(id: string): PluginState;\n  /** 读取静态图。 */\n  graph(): PluginGraph;\n  /** 读取反向依赖。 */\n  reverseDeps(id: string): readonly PluginReverseDep[];\n  /** 启动插件。 */\n  enable(id: string): Promise<void>;\n  /** 停止插件。 */\n  disable(id: string): Promise<{ ok: true } | { ok: false; reason: string }>;\n  /** 提交启停意图。 */\n  submitIntent(id: string, desiredEnabled: boolean): Promise<PluginIntentSubmissionResult>;\n  /** 删除插件。 */\n  unregister(id: string): Promise<void>;\n  /** Host/App 修订。 */\n  version(): number;\n  /** 插件 id。 */\n  manifests(): string[];\n  /** 插件 id。 */\n  installed(): string[];\n  /** 当前是否运行。 */\n  isEnabled(id: string): boolean;\n  /** 清单。 */\n  getManifest(id: string): PluginManifest | undefined;\n  /** typed descriptor 当前是否已暴露。 */\n  hasCapability(capability: CapabilityDescriptor): boolean;\n}\n\nfunction hostFor(app: WindowApp) {\n  return hostForWindowApp(app);\n}\n\n/** 领域插件管理 hook；只能在 WindowApp 上使用。 */\nexport function usePluginRuntime(): UsePluginRuntime {\n  const app = useWebLoomApp();\n  const subscribe = useCallback((listener: () => void) => app.subscribe(listener), [app]);\n  const getSnapshot = useCallback(() => app.state(), [app]);\n  const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n  return useMemo(() => {\n    if (app.runtimeKind !== \"window-main\") throw new Error(\"Plugin runtime controls require a WindowApp\");\n    const host = hostFor(app);\n    return {\n      state: (id: string) => host.state(id),\n      graph: () => host.graph(),\n      reverseDeps: (id: string) => host.reverseDeps(id),\n      enable: (id: string) => host.enable(id),\n      disable: (id: string) => host.disable(id),\n      submitIntent: (id: string, desiredEnabled: boolean) => host.submitIntent(id, desiredEnabled),\n      unregister: (id: string) => host.unregister(id),\n      version: () => snapshot.revision,\n      manifests: () => host.manifests(),\n      installed: () => host.installed(),\n      isEnabled: (id: string) => host.state(id).kind === \"enabled\",\n      getManifest: (id: string) => host.getManifest(id),\n      hasCapability: (capability: CapabilityDescriptor) => host.capabilities.has(capability),\n    } satisfies UsePluginRuntime;\n  }, [app, snapshot.revision]);\n}\n\n/** 精确订阅一个插件的状态。 */\nexport function usePluginState(pluginId: string): PluginState | undefined {\n  const app = useWebLoomApp();\n  const subscribe = useCallback((listener: () => void) => app.subscribe(listener), [app]);\n  const getSnapshot = useCallback(() => app.pluginState?.(pluginId), [app, pluginId]);\n  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n/** 读取 App 状态的 selector；无关状态变化保持上一次选择结果。 */\nexport function useRuntimeSelector<T>(selector: (snapshot: ReturnType<ReturnType<typeof useWebLoomApp>[\"state\"]>) => T, equality: (left: T, right: T) => boolean = Object.is): T {\n  const app = useWebLoomApp();\n  const last = useMemo(() => ({ has: false, value: undefined as T }), []);\n  const subscribe = useCallback((listener: () => void) => app.subscribe(listener), [app]);\n  const getSnapshot = useCallback(() => {\n    const next = selector(app.state());\n    if (last.has && equality(last.value, next)) return last.value;\n    last.has = true;\n    last.value = next;\n    return next;\n  }, [app, selector, equality, last]);\n  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n","import { useCallback } from \"react\";\nimport type { AppLike } from \"../runtime/runtimeTypes.js\";\nimport { useRuntimeSelector } from \"./usePluginRuntime.js\";\nimport { useWebLoomApp } from \"./PluginHostProvider.js\";\n\n/** 从 App 诊断快照派生无领域 selector。 */\nexport function useRegistry<T>(selector: (app: AppLike) => T): T {\n  const app = useWebLoomApp();\n  return useRuntimeSelector(() => selector(app));\n}\n","/**\n * useResource React Hook\n *\n * 设计缘由：负责 ensure + useSyncExternalStore 订阅并返回完整 snapshot。\n * 不暴露 store 内部可变对象。\n */\n\nimport { useCallback, useSyncExternalStore } from \"react\";\nimport type { ResourceSnapshot } from \"../contracts/resource.js\";\nimport type { ResourceStoreApi } from \"../resources/resourceStore.js\";\n\n/** useResource hook：返回完整资源快照 */\nexport function useResource<T>(\n  store: ResourceStoreApi,\n  definitionId: string,\n  args: readonly string[]\n): ResourceSnapshot<T> {\n  const subscribe = useCallback((callback: () => void) => {\n    return store.subscribe(definitionId, args, callback);\n  }, [store, definitionId, ...args]);\n\n  const getSnapshot = useCallback((): ResourceSnapshot<T> => {\n    return store.ensure<T>(definitionId, args);\n  }, [store, definitionId, ...args]);\n\n  const getServerSnapshot = useCallback((): ResourceSnapshot<T> => {\n    // SSR 稳定快照\n    return {\n      key: [definitionId, ...args],\n      status: \"pending\",\n      data: undefined,\n      revision: 0,\n    };\n  }, [definitionId, ...args]);\n\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n}\n","/**\n * useResourceSelector React Hook\n *\n * 设计缘由：只在 selector 结果发生语义变化时重渲染。\n * selector 和 equality 必须为纯函数。\n */\n\nimport { useSyncExternalStore, useCallback, useRef } from \"react\";\nimport type { ResourceSnapshot } from \"../contracts/resource.js\";\nimport type { ResourceStoreApi } from \"../resources/resourceStore.js\";\n\n/** 默认相等判断：Object.is */\nfunction defaultEquality<T>(a: T, b: T): boolean {\n  return Object.is(a, b);\n}\n\n/** useResourceSelector hook：只在 selector 结果变化时重渲染 */\nexport function useResourceSelector<T, TSelected>(\n  store: ResourceStoreApi,\n  definitionId: string,\n  args: readonly string[],\n  selector: (snapshot: ResourceSnapshot<T>) => TSelected,\n  equality: (a: TSelected, b: TSelected) => boolean = defaultEquality\n): TSelected {\n  const selectedRef = useRef<TSelected>();\n  const hasSelectedRef = useRef(false);\n  const sourceSnapshotRef = useRef<ResourceSnapshot<T>>();\n  const selectorRef = useRef(selector);\n  const equalityRef = useRef(equality);\n\n  // 更新 refs\n  selectorRef.current = selector;\n  equalityRef.current = equality;\n\n  const subscribe = useCallback(\n    (callback: () => void) => {\n      return store.subscribe(definitionId, args, callback);\n    },\n    [store, definitionId, ...args]\n  );\n\n  const getSnapshot = useCallback((): TSelected => {\n    const snapshot = store.ensure<T>(definitionId, args);\n\n    // React's useSyncExternalStore requires referentially stable results when\n    // the backing store did not change. A selector may legitimately allocate\n    // (for example `rows.slice().sort(...)`), so equality alone cannot uphold\n    // that requirement when callers use reference equality.\n    if (hasSelectedRef.current && sourceSnapshotRef.current === snapshot) {\n      return selectedRef.current as TSelected;\n    }\n\n    const selected = selectorRef.current(snapshot);\n\n    // 检查是否变化\n    if (\n      hasSelectedRef.current &&\n      equalityRef.current(selectedRef.current as TSelected, selected)\n    ) {\n      sourceSnapshotRef.current = snapshot;\n      return selectedRef.current as TSelected;\n    }\n\n    selectedRef.current = selected as TSelected;\n    hasSelectedRef.current = true;\n    sourceSnapshotRef.current = snapshot;\n    return selected;\n  }, [store, definitionId, ...args]);\n\n  const getServerSnapshot = useCallback((): TSelected => {\n    const snapshot: ResourceSnapshot<T> = {\n      key: [definitionId, ...args],\n      status: \"pending\",\n      data: undefined,\n      revision: 0,\n    };\n    return selectorRef.current(snapshot);\n  }, [definitionId, ...args]);\n\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n}\n","// 仅用于开发/测试观察组件 render 次数；生产构建中保持 no-op。\n\nconst counters = new Map<string, number>();\n\nfunction enabled(): boolean {\n  const env = (import.meta as ImportMeta & { env?: { DEV?: boolean } }).env;\n  return env?.DEV !== false;\n}\n\nexport function countRender(name: string): void {\n  if (!enabled()) return;\n  counters.set(name, (counters.get(name) ?? 0) + 1);\n}\n\nexport function getRenderCount(name: string): number {\n  return counters.get(name) ?? 0;\n}\n\nexport function resetRenderCounters(): void {\n  counters.clear();\n}\n"]}