refactor(gui): move the snapshot-store engine into the client runtime
The data layer no longer depends on the React glue package, and business plugins no longer depend on web-react at all: - The store engine (zustand vanilla + immer + persist + dev freeze), defineStore, and shallowEqual move to @deepseek-ai/dsh-client-runtime, exported from the ./client main entry — no ./store subpath survives on either package (the web-react one is deleted, none is opened on runtime). - Store products are bare snapshot sources: useSelector leaves SnapshotStore/StoreInstance and Session; every hook is composed at the binding site in web-react's renderer (per-source cached uSES binding). The SlotRendererHost sessions face carries bare observables only. - SessionProvider becomes a standard-kit seat: an entry whose children declare a session-scope slot receives the framework component as a prop, retiring the last value import of web-react from plugin packages. UseSession and the session-area types now live in ui-slots. - web-react shrinks to the shell-only React glue (renderer, providers, uSES bridge); zustand/immer belong to runtime alone; the module-table seed and tsdown externals drop the web-react/store seat. - NODE_ENV replacement is defined once in the shared tsdown client preset (browser bundles inline the engine and lost vite's define); the 3-line process.env typecheck shim moves to runtime with the engine. - Stray tsc artifacts (.js/.d.ts/.d.ts.map beside sources under src/) swept repo-wide; they shadow real sources under vitest resolution. Verified: both aggregate typecheck programs at zero; 604 client tests green; repo-wide grep for web-react/store at zero; real-host playwright run 7/7 including persist round-trip. ci: fix test/docs
This commit is contained in:
@@ -14,7 +14,7 @@
|
||||
* consumer merges keys in and the intersection is what keeps them string-typed.
|
||||
* The rule fires on the empty-map view, not on real redundancy. */
|
||||
import type { ReactNode } from 'react'
|
||||
import type { BoundActions, HandleOf, PropsStore, StoreDecl } from './store.ts'
|
||||
import type { BoundActions, HandleOf, PropsStore, SnapshotSelectorHook, StoreDecl } from './store.ts'
|
||||
|
||||
export * from './store.ts'
|
||||
export * from './renderer.ts'
|
||||
@@ -98,6 +98,32 @@ export type PropsRuntime<K extends keyof SlotMap & string> =
|
||||
/** renderSlot dispatch options: keyed dispatch key, list filtering, empty fallback. */
|
||||
export interface RenderOpts { entryKey?: string; only?: string; fallback?: ReactNode }
|
||||
|
||||
/**
|
||||
* Conversation-session selector hook alias for props contracts. Wide by
|
||||
* default at this dependency-inverted layer; the runtime narrows at its
|
||||
* export seam (`UseSession<ConversationSnapshot>`).
|
||||
*/
|
||||
export type UseSession<Snap extends object = object> = SnapshotSelectorHook<Snap>
|
||||
|
||||
/** Props of the standard-kit SessionProvider seat (render-prop form). */
|
||||
export interface SessionAreaProps {
|
||||
/** No-session body (also covers a current id whose session cannot be resolved). */
|
||||
empty?: (() => ReactNode) | undefined
|
||||
/** Session body; the framework remounts it per session (key=sessionId). */
|
||||
children: (sessionId: SessionIdOf) => ReactNode
|
||||
}
|
||||
|
||||
/**
|
||||
* The framework-wired session area component (slot terminal design §7):
|
||||
* subscribes to the current-session selection internally (design fiat ① —
|
||||
* selection authority lives with runtime sessions) and switches between the
|
||||
* session body and the empty branch. Delivered as a standard seat to every
|
||||
* entry whose children declaration contains a session-scope slot (the
|
||||
* derivation rides {@link PropsRenderSlots}); the value is injected by the
|
||||
* installed renderer — business code never imports it.
|
||||
*/
|
||||
export type SessionProviderComponent = (props: SessionAreaProps) => ReactNode
|
||||
|
||||
/**
|
||||
* Child-slot render share: `renderSlot` statically narrowed to the entry's
|
||||
* declared children keys. Delegation is plain props passing (hand
|
||||
@@ -117,7 +143,12 @@ export type PropsRenderSlots<S extends keyof SlotMap & string> = {
|
||||
*/
|
||||
renderSlot: <K extends S>(key: K, owner: OwnerOf<K>, opts?: RenderOpts) => ReactNode
|
||||
readonly __renders?: ((key: S) => void) | undefined
|
||||
}
|
||||
} & ('session' extends ScopeOf<S>
|
||||
// The SessionProvider seat rides the same source as renderSlot: declaring
|
||||
// a session-scope child is what makes a session area exist, so the seat
|
||||
// derives from the children key set's scopes (renderer injects the value).
|
||||
? { SessionProvider: SessionProviderComponent }
|
||||
: object)
|
||||
|
||||
/**
|
||||
* Registration-position component shape: the bare call signature, so composed
|
||||
|
||||
@@ -16,19 +16,33 @@ export interface HostObservable<T> {
|
||||
|
||||
/**
|
||||
* Type-erased store instance face at the render seam (the typed twin is
|
||||
* {@link StoreInstance}): selector hook plus draft-stripped action callbacks.
|
||||
* Typing lands at the component seam via {@link PropsStore}.
|
||||
* {@link StoreInstance}): a bare snapshot source plus the draft-stripped
|
||||
* action callbacks. No React hook crosses this seam — the render machinery
|
||||
* binds `useStore` from the source at its own side (cached per instance);
|
||||
* typing lands at the component seam via {@link PropsStore}.
|
||||
*/
|
||||
export interface StoreInstanceLike {
|
||||
readonly useSelector: unknown
|
||||
/** Current state snapshot (uSES getSnapshot side). */
|
||||
getSnapshot(): unknown
|
||||
/**
|
||||
* Subscribe to state changes (uSES subscribe side).
|
||||
* @param fn - change callback.
|
||||
* @returns unsubscribe.
|
||||
*/
|
||||
subscribe(fn: () => void): () => void
|
||||
/** Baked write callbacks (delivered to components as `actions`). */
|
||||
readonly actions: Record<string, (...params: never[]) => void>
|
||||
}
|
||||
|
||||
/** Session standard kit resolved per session id (identity-stable per session scope; a recreated scope yields a new cell). */
|
||||
export interface SessionCell {
|
||||
sessionId: string
|
||||
/** Bound conversation-snapshot selector hook (wide here; runtime narrows at its export seam). */
|
||||
useSession: unknown
|
||||
/**
|
||||
* Bare conversation-snapshot source (wide here; runtime narrows at its
|
||||
* export seam). The React side binds the `useSession` hook per cell —
|
||||
* hooks never appear on the host contract.
|
||||
*/
|
||||
session: HostObservable<unknown>
|
||||
}
|
||||
|
||||
/** renderSlot dispatch options at the machinery level: keyed dispatch key, list filtering, empty fallback. */
|
||||
|
||||
@@ -51,19 +51,19 @@ export interface StoreSpec<T, A extends ActionsDecl<T>> {
|
||||
|
||||
/**
|
||||
* Live engine instance: the create() product consumed by the render machinery
|
||||
* and by component tests (fed straight into props as useStore/actions).
|
||||
* Production components and render paths never call create() themselves —
|
||||
* instance lifecycle is the framework's.
|
||||
* and by tests. A bare snapshot source plus the baked write set — no React
|
||||
* hook rides the engine product (the engine lives in the React-free runtime);
|
||||
* the render machinery binds the `useStore` hook from this source on its own
|
||||
* side, cached per instance. Production components and render paths never
|
||||
* call create() themselves — instance lifecycle is the framework's.
|
||||
*/
|
||||
export interface StoreInstance<T, A extends ActionsDecl<T>> {
|
||||
/** Selector hook bound to this instance (delivered to components as `useStore`). */
|
||||
readonly useSelector: SnapshotSelectorHook<T>
|
||||
/** Baked write callbacks (delivered to components as `actions`). */
|
||||
readonly actions: BakedActions<T, A>
|
||||
/** Current state snapshot (test assertions; machinery). */
|
||||
/** Current state snapshot (uSES getSnapshot side; test assertions). */
|
||||
getSnapshot(): T
|
||||
/**
|
||||
* Subscribe to state changes.
|
||||
* Subscribe to state changes (uSES subscribe side).
|
||||
* @param fn - change callback.
|
||||
* @returns unsubscribe.
|
||||
*/
|
||||
@@ -130,8 +130,8 @@ export type PropsStore<H> = H extends StoreHandle<infer T, infer A>
|
||||
: object
|
||||
|
||||
/**
|
||||
* The defineStore contract (implementation lives in web-react, bound to the
|
||||
* snapshot-store engine): spec in, handle out, with T inferred from `init`
|
||||
* and the actions table constrained by T.
|
||||
* The defineStore contract (implementation lives in the runtime package,
|
||||
* bound to the snapshot-store engine): spec in, handle out, with T inferred
|
||||
* from `init` and the actions table constrained by T.
|
||||
*/
|
||||
export type DefineStore = <T, A extends ActionsDecl<T>>(spec: StoreSpec<T, A>) => StoreHandle<T, A>
|
||||
|
||||
Reference in New Issue
Block a user