@deepseek-ai/dsh-client-ui-slots 0.1.2-alpha.3 → 0.1.2-alpha.4

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/ui-slots/README.md
-README.md: 7b5b55c7f640d290b569354a1d2ce1771fcbf871
-README.zh.md: 3212304227048c5334695395160378c7dfb19fb3
+README.md: 037b2de5f1ea23e103dfb9adf766fa309cccc36f
+README.zh.md: 521b4be18b30cf27d7e89b33b02f2e4a2c9e144e

package/README.md

@@ -101,3 +101,5 @@ These limits define the registry's scaling behavior and accepted type noise; the
 None.
 
 </details>
+
+**Runtime invariant:** No companion is published. A zero-dependency pure registry core — it emits no cordis events itself (the `ui-renderer` SlotRegistry owns the event bridge and its invariants); define/register/dispose sequencing is asserted directly by this package's behavior specs.

package/README.zh.md

@@ -101,3 +101,5 @@ register 调用可以用 `store: defineStore(...)` 声明 store 席位：`init`
 无。
 
 </details>
+
+**运行时不变式：** 不发布伴生入口。这是零依赖纯 registry core，本身不发出 Cordis 事件；`ui-renderer` SlotRegistry 负责事件桥及其不变式。

package/lib/types/index.d.ts

@@ -10,7 +10,7 @@
  */
 import type { ReactNode } from 'react';
 import type { BoundActions, HandleOf, PropsStore, SnapshotSelectorHook, StoreDecl } from '@deepseek-ai/dsh-client-store';
-import type { HostObservable } from './renderer.ts';
+import type { HostObservable, KeyedStandardSource } from './renderer.ts';
 export * from './store.ts';
 export * from './renderer.ts';
 /** Slot contract table. Owners extend via declaration merging; entries are {@link SlotEntryDef}. */
@@ -312,6 +312,20 @@ export type SlotComponent<P> = (props: P) => ReactNode;
  * not participate in render-occurrence context.
  */
 export type HooksSources = Record<string, HostObservable<unknown>>;
+/** Registrant keyed-hooks compartment: stable key-to-observable resolvers. */
+export type KeyedHooksSources = Record<string, KeyedStandardSource>;
+/** Selector Hook over an open family of keyed observable sources. */
+export type KeyedSnapshotSelectorHook<Snapshot> = {
+    /** @param key - source key. @returns the current value, or absence when the source is unavailable. */
+    (key: string): Snapshot | undefined;
+    /**
+     * @param key - source key.
+     * @param selector - projection over the current keyed value.
+     * @param equal - optional selected-value equality.
+     * @returns the selected value.
+     */
+    <Selected>(key: string, selector: (value: Snapshot | undefined) => Selected, equal?: (left: Selected, right: Selected) => boolean): Selected;
+};
 /** Framework-owned props visible while a slot-level contextual Hook is bound. */
 export type StandardPropsOf<K extends keyof SlotMap & string> = (ScopeOf<K> extends 'session' ? SessionStandardProps : ScopeOf<K> extends 'session-maybe' ? SessionMaybeStandardProps : object) & GlobalStandardProps;
 /**
@@ -336,6 +350,10 @@ export type SlotInjectFace<I extends object> = I extends {
 export type PropsHooks<HS extends HooksSources> = {
     [N in keyof HS & string as `use${Capitalize<N>}`]: SnapshotSelectorHook<HS[N] extends HostObservable<infer T> ? T : never>;
 };
+/** Selector-hook share synthesized from an entry inject keyed-hooks compartment. */
+export type PropsKeyedHooks<HS extends KeyedHooksSources> = {
+    [N in keyof HS & string as `use${Capitalize<N>}`]: KeyedSnapshotSelectorHook<HS[N] extends (key: string) => HostObservable<infer T> | undefined ? T : never>;
+};
 /**
  * The component-side view of an inject face: the reserved `hooks`
  * compartment (when declared) arrives as bound `use<Name>` selector hooks;
@@ -343,7 +361,11 @@ export type PropsHooks<HS extends HooksSources> = {
  */
 export type InjectFace<I extends object> = I extends {
     hooks: infer HS extends HooksSources;
-} ? Omit<I, 'hooks'> & PropsHooks<HS> : I;
+} ? I extends {
+    keyedHooks: infer KS extends KeyedHooksSources;
+} ? Omit<I, 'hooks' | 'keyedHooks'> & PropsHooks<HS> & PropsKeyedHooks<KS> : Omit<I, 'hooks'> & PropsHooks<HS> : I extends {
+    keyedHooks: infer KS extends KeyedHooksSources;
+} ? Omit<I, 'keyedHooks'> & PropsKeyedHooks<KS> : I;
 /**
  * The composed component props intersection: runtime share (SlotMap) +
  * child-render share (children declaration) + store share (declared handle) +

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-slots",
   "description": "Slot registry pure core: SlotMap declaration merging, single register composition API, four-share props types, store-seat types, renderer install seam",
-  "version": "0.1.2-alpha.3",
+  "version": "0.1.2-alpha.4",
   "publishConfig": {
     "access": "public"
   },
@@ -18,23 +18,17 @@
       "types": "./lib/types/index.d.ts",
       "default": "./lib/index.js"
     },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
-    },
     "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
   "license": "MIT",
   "devDependencies": {
     "@types/react": "~18.3.1",
-    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.4",
     "@deepseek-ai/cordis": "^4.0.2"
   },
   "files": [
     "lib/index.js",
-    "lib/invariant.js",
     "lib/types/**/*.d.ts"
   ],
   "peerDependencies": {

package/lib/invariant.js

@@ -1,27 +0,0 @@
-//#region lib/types/invariant.js
-/**
-* Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-slots`.
-* @module @deepseek-ai/dsh-client-ui-slots/invariant
-*/
-const PACKAGE_NAME = "@deepseek-ai/dsh-client-ui-slots";
-/** Cordis companion plugin name. */
-const name = "client-ui-slots-invariant";
-/** Service required before the companion can reserve package ownership. */
-const inject = ["invariants"];
-/**
-* No runtime invariant: a zero-dependency pure registry core — it emits no
-* cordis events itself (the `ui-renderer` SlotRegistry owns the event
-* bridge and its invariants); define/register/dispose sequencing is asserted
-* directly by this package's behavior specs.
-*/
-const install = () => {};
-/**
-* Register this package's invariant companion.
-* @param ctx - Cordis context carrying the invariant service.
-* @returns the installed registration's disposer after setup succeeds.
-*/
-const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-//#endregion
-export { apply, inject, name };
-
-//# sourceMappingURL=invariant.js.map

package/lib/types/invariant.d.ts

@@ -1,16 +0,0 @@
-/**
- * Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-slots`.
- * @module @deepseek-ai/dsh-client-ui-slots/invariant
- */
-import type { Context } from '@deepseek-ai/cordis';
-/** Cordis companion plugin name. */
-export declare const name = "client-ui-slots-invariant";
-/** Service required before the companion can reserve package ownership. */
-export declare const inject: string[];
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export declare const apply: (ctx: Context) => Promise<() => void>;
-//# sourceMappingURL=invariant.d.ts.map