@deepseek-ai/dsh-client-resources 0.1.5-alpha.1 → 0.1.5-alpha.2

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/client/resources/README.md
-README.md: 7c32293c8d4250b11f8beaaf473a62145c915bce
-README.zh.md: b53089a2449f379f43156f610b587656a998ece3
+README.md: 6b5afc82230be6930c41a01a584aeed39f596c37
+README.zh.md: 6b928883bb54cd4663efa7a20a7bc768d4f8399e

package/README.md

@@ -33,12 +33,12 @@ Nothing needs configuration to mount: the plugin provides `ctx.resources` and co
 <a id="read-a-resource"></a>
 ### Read a resource
 
-Every slot component receives `useResource` in its props. `useResource<P>(address)` names the protocol as the type argument and returns `{ status, value, failure, reload }`: `none` when no provider is registered for the address's protocol (or the address is not a `dsh-resource://` URL), `loading` while the provider has not yielded, `live` with the latest `ok` frame's value, and `failed` when the latest frame reported a failure, with that failure beside the last value. `reload()` asks the provider for a fresh value and is a no-op without one. Subscribing through the hook is what holds the resource open; a component that mounts while another holder keeps the resource alive reads the latest value at once.
+Every slot component receives `useResource` in its props. `useResource<P>(address)` names the protocol as the type argument and returns `{ status, value, failure }`: `none` when no provider is registered for the address's protocol (or the address is not a `dsh-resource://` URL), `loading` while the provider has not yielded, `live` with the latest `ok` frame's value, and `failed` when the latest frame reported a failure, with that failure beside the last value. Subscribing through the hook is what holds the resource open; a component that mounts while another holder keeps the resource alive reads the latest value at once.
 
 <a id="provide-a-protocol"></a>
 ### Provide a protocol
 
-The protocol's owning client package declares its value type in `ResourceProtocolMap` and registers one provider as an owned effect. `open` yields `RemoteResult` frames: the current content first and one frame per later change, with a failure as an `ok: false` frame rather than a throw; it must stop when `signal` aborts. `reload` is optional:
+The protocol's owning client package declares its value type in `ResourceProtocolMap` and registers one provider as an owned effect. `open` yields `RemoteResult` frames: the current content first and one frame per later change, with a failure as an `ok: false` frame rather than a throw; it must stop when `signal` aborts:
 
 ```ts ignore-check
 declare module '@deepseek-ai/dsh-client-ui-slots' {
@@ -54,7 +54,6 @@ export function apply(ctx) {
       yield await readNote(address, signal)
       for await (const change of followNote(address, signal)) yield change
     },
-    reload(address) { requestReread(address) },
   }), 'my-notes: note resource provider')
 }
 ```
@@ -72,7 +71,7 @@ A protocol has exactly one provider; a second registration throws. Registering a
 <a id="lifecycle"></a>
 ### Lifecycle
 
-One record per address holds a snapshot store, a holder count (hook subscribers plus pins), and the running stream's `AbortController`. The first holder opens the provider's stream; every later holder shares it; the last holder's release aborts the stream and resets the snapshot to idle (`loading` with a provider, `none` without). Records are kept for the page lifetime so `source()` stays reference-stable across React's render-then-subscribe window and a StrictMode remount. `reload` is one function per record and never changes.
+One record per address holds a snapshot store, a holder count (hook subscribers plus pins), and the running stream's `AbortController`. The first holder opens the provider's stream; every later holder shares it; the last holder's release aborts the stream and resets the snapshot to idle (`loading` with a provider, `none` without). Records are kept for the page lifetime so `source()` stays reference-stable across React's render-then-subscribe window and a StrictMode remount.
 
 <a id="failures"></a>
 ### Failures

package/README.zh.md

@@ -33,12 +33,12 @@ kind: "package-reference"
 <a id="read-a-resource"></a>
 ### 读取资源
 
-每个 slot 组件都在 props 上收到 `useResource`。`useResource<P>(address)` 以类型参数命名协议，返回 `{ status, value, failure, reload }`：地址协议没有提供方（或地址不是 `dsh-resource://` URL）时为 `none`，提供方尚未产出值时为 `loading`，`live` 携带最新一个 `ok` 帧的值，`failed` 表示最新一帧报告了失败，失败放在最后一个值旁。`reload()` 请提供方给一个新值，没有提供方时是空操作。通过 hook 订阅就是钉住资源的方式；另一个持有者让资源保持存活时，新挂载的组件立刻读到最新值。
+每个 slot 组件都在 props 上收到 `useResource`。`useResource<P>(address)` 以类型参数命名协议，返回 `{ status, value, failure }`：地址协议没有提供方（或地址不是 `dsh-resource://` URL）时为 `none`，提供方尚未产出值时为 `loading`，`live` 携带最新一个 `ok` 帧的值，`failed` 表示最新一帧报告了失败，失败放在最后一个值旁。通过 hook 订阅就是钉住资源的方式；另一个持有者让资源保持存活时，新挂载的组件立刻读到最新值。
 
 <a id="provide-a-protocol"></a>
 ### 提供协议
 
-协议所属的客户端包在 `ResourceProtocolMap` 声明其值类型，并以自有 effect 注册一个提供方。`open` 产出 `RemoteResult` 帧：先是当前内容，之后每次变化一帧，失败以 `ok: false` 帧而非抛错表达；必须在 `signal` 中止时停止。`reload` 可选：
+协议所属的客户端包在 `ResourceProtocolMap` 声明其值类型，并以自有 effect 注册一个提供方。`open` 产出 `RemoteResult` 帧：先是当前内容，之后每次变化一帧，失败以 `ok: false` 帧而非抛错表达；必须在 `signal` 中止时停止：
 
 ```ts ignore-check
 declare module '@deepseek-ai/dsh-client-ui-slots' {
@@ -54,7 +54,6 @@ export function apply(ctx) {
       yield await readNote(address, signal)
       for await (const change of followNote(address, signal)) yield change
     },
-    reload(address) { requestReread(address) },
   }), 'my-notes: note resource provider')
 }
 ```
@@ -72,7 +71,7 @@ export function apply(ctx) {
 <a id="lifecycle"></a>
 ### 生命周期
 
-每个地址一条记录，持有一个快照 store、一个持有者计数（hook 订阅者加 pin）与运行中流的 `AbortController`。第一个持有者打开提供方的流；之后的持有者共享它；最后一个持有者释放时中止流并把快照重置为空闲（有提供方为 `loading`，没有为 `none`）。记录在页面存续期内保留，使 `source()` 在 React 渲染到订阅的窗口与 StrictMode 重挂载之间保持引用稳定。`reload` 每条记录一个函数，永不变化。
+每个地址一条记录，持有一个快照 store、一个持有者计数（hook 订阅者加 pin）与运行中流的 `AbortController`。第一个持有者打开提供方的流；之后的持有者共享它；最后一个持有者释放时中止流并把快照重置为空闲（有提供方为 `loading`，没有为 `none`）。记录在页面存续期内保留，使 `source()` 在 React 渲染到订阅的窗口与 StrictMode 重挂载之间保持引用稳定。
 
 <a id="failures"></a>
 ### 失败

package/lib/client.js

@@ -23,12 +23,11 @@ window.__ModuleLoader__.load({
 			if (parsed.protocol !== `dsh-resource:`) return void 0;
 			return parsed.hostname === "" ? void 0 : parsed.hostname.toLowerCase();
 		}
-		function idle(status, reload) {
+		function idle(status) {
 			return {
 				status,
 				value: void 0,
-				failure: void 0,
-				reload
+				failure: void 0
 			};
 		}
 		/** The `ctx.resources` implementation. */
@@ -77,15 +76,11 @@ window.__ModuleLoader__.load({
 			}
 			create(address) {
 				const protocol = protocolOf(address);
-				const reload = () => {
-					this.providerOf(protocol)?.reload?.(address);
-				};
-				const store = (0, _deepseek_ai_dsh_client_store.createSnapshotStore)(idle(this.providerOf(protocol) === void 0 ? "none" : "loading", reload));
+				const store = (0, _deepseek_ai_dsh_client_store.createSnapshotStore)(idle(this.providerOf(protocol) === void 0 ? "none" : "loading"));
 				const record = {
 					address,
 					protocol,
 					store,
-					reload,
 					holders: 0,
 					controller: void 0,
 					source: {
@@ -119,7 +114,7 @@ window.__ModuleLoader__.load({
 				record.holders -= 1;
 				if (record.holders > 0) return;
 				this.stop(record);
-				record.store.set(idle(this.providerOf(record.protocol) === void 0 ? "none" : "loading", record.reload));
+				record.store.set(idle(this.providerOf(record.protocol) === void 0 ? "none" : "loading"));
 			}
 			/** The provider arrived: a held record opens its stream, an idle one turns `loading`. */
 			attach(record) {
@@ -127,19 +122,19 @@ window.__ModuleLoader__.load({
 					this.start(record);
 					return;
 				}
-				record.store.set(idle("loading", record.reload));
+				record.store.set(idle("loading"));
 			}
 			/** The provider left: the stream ends and the record reports `none`. */
 			detach(record) {
 				this.stop(record);
-				record.store.set(idle("none", record.reload));
+				record.store.set(idle("none"));
 			}
 			start(record) {
 				const provider = this.providerOf(record.protocol);
 				if (provider === void 0) return;
 				const controller = new AbortController();
 				record.controller = controller;
-				if (record.store.getSnapshot().status !== "loading") record.store.set(idle("loading", record.reload));
+				if (record.store.getSnapshot().status !== "loading") record.store.set(idle("loading"));
 				this.consume(record, provider, controller.signal);
 			}
 			stop(record) {
@@ -154,13 +149,11 @@ window.__ModuleLoader__.load({
 					record.store.set(frame.ok ? {
 						status: "live",
 						value: frame.value,
-						failure: void 0,
-						reload: record.reload
+						failure: void 0
 					} : {
 						status: "failed",
 						value: record.store.getSnapshot().value,
-						failure: frame.error,
-						reload: record.reload
+						failure: frame.error
 					});
 				}
 			}

package/lib/types/client/contract.d.ts

@@ -45,8 +45,6 @@ export interface ResourceSnapshot<Value> {
     readonly value: Value | undefined;
     /** The latest frame's failure; present only while `status` is `failed`. */
     readonly failure: RemoteFailure | undefined;
-    /** Ask the provider for a fresh frame; a no-op when its protocol has no provider or no `reload`. */
-    readonly reload: () => void;
 }
 /**
  * Global standard hook: the current state of one address, typed by the
@@ -74,11 +72,6 @@ export interface ResourceProvider<P extends ResourceProtocol> {
      * @returns the frame stream; it must stop once `ctx.signal` aborts.
      */
     open(address: string, ctx: ResourceOpenContext): AsyncIterable<RemoteResult<ResourceProtocolMap[P]>>;
-    /**
-     * Produce a fresh frame on the open stream. Absent when the protocol has no refresh.
-     * @param address - the full address, a `dsh-resource://<type>/…` URL.
-     */
-    reload?(address: string): void;
 }
 /**
  * The `ctx.resources` service. One resource is one address; it stays open

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-resources",
   "description": "Unified client resource model: protocol-registered providers turn URL addresses into live values, consumed through the useResource global standard hook",
-  "version": "0.1.5-alpha.1",
+  "version": "0.1.5-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -39,11 +39,11 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-alpha.1"
+    "@deepseek-ai/dsh-client-store": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.5-alpha.2"
   },
   "files": [
     "lib/index.js",