@huanlin/dsh-plugin-input-history 0.1.2 → 0.3.0

package/lib/types/client/index.js

@@ -1,170 +1,62 @@
-/**
- * dsh-plugin-input-history — browser half.
- *
- * Two registrations:
- *   - `conversation.composer.dock` list slot (id `dsh-plugin-input-history`,
- *     order 100) — renders an invisible anchor that collects history from
- *     `session.nodes` every render. The dock is session-scoped; DSH treats
- *     blank sessions as "hero" and suppresses the dock, so history
- *     collection only runs in active sessions. That is fine: the first
- *     message in a blank session is collected after the session becomes
- *     active (the message makes it non-blank).
- *   - A document-level `keydown` listener attached in `apply` (NOT in the
- *     dock component) — this ensures the listener is always active,
- *     including in hero/blank mode where the dock is suppressed. The
- *     listener uses the native `value` setter + `dispatchEvent('input')`
- *     to feed history text into the textarea, which triggers InputBar's
- *     `onChange` → `keyboard.setDraft` — the same path the user's typing
- *     takes.
- *
- * History is collected from `user` and `steering` conversation nodes as
- * they appear in any session's `ConversationSnapshot`, persisted to
- * `localStorage` (FIFO, 500 entries), and shared across all sessions
- * in the same browser profile.
- *
- * @module @huanlin/dsh-plugin-input-history/client
- */
-import { HistoryDock, getHistoryStore } from "./HistoryDock.js";
-import { isImeComposition } from "./ime.js";
-import { cursorLineInfo, findComposerTextarea } from "./dom.js";
-import { nextIndex, entryAt } from "./history.js";
-import { en, NS, zh } from "./locales.js";
-import { dicts } from "./dictionaries.js";
-/** Required services: slots + locale. */
-export const inject = ['slots', 'locale'];
-/**
- * Navigation cursor + saved draft for the keydown listener. Module-scoped
- * because the listener is attached once in `apply` and must persist across
- * dock mount/unmount cycles.
- */
-let navCursor = null;
-let savedDraft = null;
-/**
- * Client plugin body: register the dock + attach the keydown listener.
- *
- * @param ctx - client root context.
- */
-export function apply(ctx) {
-    ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'dsh-plugin-input-history: dictionaries');
-    // better-locale override: register the 19-language dicts so a selected
-    // override language (with DSH on 'en') replaces the plugin's copy. The
-    // service is optional — no better-locale, no dicts.
-    // Activation-order-safe: re-check ctx.get('betterLocale') on every locale
-    // revision bump (better-locale bumps on activation + override switch).
-    ctx.effect(() => {
-        let dispose;
-        const sync = () => {
-            dispose?.();
-            dispose = undefined;
-            const store = ctx.get('betterLocale');
-            if (store !== undefined) {
-                dispose = store.register(NS, dicts);
-            }
-        };
-        sync();
-        const unsubscribe = ctx.locale.subscribe(sync);
-        return () => {
-            unsubscribe();
-            dispose?.();
-        };
-    }, 'dsh-plugin-input-history: better-locale override dicts');
-    // The dock collects history from session.nodes. It is session-scoped;
-    // in hero/blank mode it is suppressed, but the keydown listener below
-    // still works (it reads from the module-scope HistoryStore, which
-    // persists across dock mount/unmount cycles via localStorage).
-    ctx.slots.inject('conversation.composer.dock', () => ctx.slots.register({
-        name: 'conversation.composer.dock',
-        id: 'dsh-plugin-input-history',
-        order: 100,
-        locale: NS,
-    }, HistoryDock));
-    // Attach the document-level keydown listener. This lives in `apply`
-    // (not in the dock component) so it stays active even when the dock is
-    // suppressed (hero/blank sessions — ConversationRoot.tsx:79-80 treats
-    // blank sessions as hero, and line 156 skips the dock render).
-    ctx.effect(() => {
-        if (typeof document === 'undefined')
-            return () => { };
-        const handler = (event) => {
-            if (event.key !== 'ArrowUp' && event.key !== 'ArrowDown')
-                return;
-            if (isImeComposition(event))
-                return;
-            if (event.defaultPrevented)
-                return;
-            const textarea = findComposerTextarea(event.target);
-            if (textarea === null)
-                return;
-            if (event.target !== textarea)
-                return;
-            // Skip if the textarea is readOnly or disabled — hero mode's
-            // workspace-picker trigger, or a submitting machine phase.
-            if (textarea.readOnly || textarea.disabled)
-                return;
-            const store = getHistoryStore();
-            const history = store.list;
-            // Multi-line boundary check.
-            const info = cursorLineInfo(textarea.value, textarea.selectionStart, textarea.selectionEnd);
-            if (event.key === 'ArrowUp' && !info.atFirstLine)
-                return;
-            if (event.key === 'ArrowDown' && !info.atLastLine)
-                return;
-            const dir = event.key === 'ArrowUp' ? 'up' : 'down';
-            const next = nextIndex(navCursor, history.length, dir);
-            // Down off the newest end: restore the saved draft (if any).
-            if (next === null) {
-                const saved = savedDraft;
-                navCursor = null;
-                if (saved !== null) {
-                    setNativeTextareaValue(textarea, saved);
-                    savedDraft = null;
-                }
-                event.preventDefault();
-                return;
-            }
-            // Entering history: save the current draft the first time we
-            // navigate away from "not navigating".
-            if (navCursor === null && savedDraft === null) {
-                savedDraft = textarea.value;
-            }
-            const entry = entryAt(history, next);
-            if (entry === null)
-                return;
-            navCursor = next;
-            setNativeTextareaValue(textarea, entry);
-            event.preventDefault();
-        };
-        document.addEventListener('keydown', handler, false);
-        return () => {
-            document.removeEventListener('keydown', handler, false);
-        };
-    }, 'dsh-plugin-input-history: keydown listener');
-}
-/**
- * Set the textarea value via the native prototype setter and dispatch an
- * `input` event so React's controlled-component onChange fires.
- *
- * React 18 tracks the textarea's value internally; directly assigning
- * `textarea.value = x` does NOT trigger React's onChange because React's
- * value tracker compares against its last-seen value. Using the native
- * prototype setter bypasses React's tracker, and the dispatched `input`
- * event makes React detect the change and run InputBar's `onChange` →
- * `keyboard.setDraft(next)`. This is the same technique used by
- * browser automation libraries (Playwright, Testing Library) to simulate
- * user typing in React controlled inputs.
- *
- * @param textarea - the target textarea element.
- * @param value - the new value to set.
- */
-function setNativeTextareaValue(textarea, value) {
-    const proto = window.HTMLTextAreaElement.prototype;
-    const descriptor = Object.getOwnPropertyDescriptor(proto, 'value');
-    if (descriptor === undefined || descriptor.set === undefined) {
-        // Fallback: direct assignment (may not trigger React onChange in
-        // all browsers, but better than nothing).
-        textarea.value = value;
-        return;
-    }
-    descriptor.set.call(textarea, value);
-    textarea.dispatchEvent(new Event('input', { bubbles: true }));
-}
+/**
+ * dsh-plugin-input-history — browser half.
+ *
+ * One registration: the `conversation.composer.dock` list slot (id
+ * `dsh-plugin-input-history`, order 100) mounts the invisible dock entry
+ * that owns both plugin behaviors — prompt-history collection from the
+ * Chat target's user/steering nodes, and the capture-phase document
+ * keydown listener that navigates the composer draft through
+ * `inputActions.setDraft`. See [HistoryDock.tsx](./HistoryDock.tsx) for
+ * the data flow; the dock is session-scoped, so in hero/blank mode the
+ * plugin is dormant (no input machine exists there to drive).
+ *
+ * History is collected from `user` and `steering` chat nodes of any active
+ * session, persisted to `localStorage` (FIFO, 500 entries), and shared
+ * across all sessions in the same browser profile.
+ *
+ * @module @huanlin/dsh-plugin-input-history/client
+ */
+import { HistoryDock } from "./HistoryDock.js";
+import { en, NS, zh } from "./locales.js";
+import { dicts } from "./dictionaries.js";
+/** Required services: slots + locale. */
+export const inject = ['slots', 'locale'];
+/**
+ * Client plugin body: register the dock + locale dictionaries.
+ *
+ * @param ctx - client root context.
+ */
+export function apply(ctx) {
+    ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'dsh-plugin-input-history: dictionaries');
+    // better-locale override: register the 19-language dicts so a selected
+    // override language (with DSH on 'en') replaces the plugin's copy. The
+    // service is optional — no better-locale, no dicts.
+    // Activation-order-safe: re-check ctx.get('betterLocale') on every locale
+    // revision bump (better-locale bumps on activation + override switch).
+    ctx.effect(() => {
+        let dispose;
+        const sync = () => {
+            dispose?.();
+            dispose = undefined;
+            const store = ctx.get('betterLocale');
+            if (store !== undefined) {
+                dispose = store.register(NS, dicts);
+            }
+        };
+        sync();
+        const unsubscribe = ctx.locale.subscribe(sync);
+        return () => {
+            unsubscribe();
+            dispose?.();
+        };
+    }, 'dsh-plugin-input-history: better-locale override dicts');
+    // The dock collects history from the Chat target's nodes and attaches the
+    // capture-phase keydown listener. It is session-scoped; in hero/blank mode
+    // it is unmounted and the plugin is dormant (no input machine exists there).
+    ctx.slots.inject('conversation.composer.dock', () => ctx.slots.register({
+        name: 'conversation.composer.dock',
+        id: 'dsh-plugin-input-history',
+        order: 100,
+        locale: NS,
+    }, HistoryDock));
+}

package/lib/types/index.d.ts

@@ -1,25 +1,24 @@
-/**
- * dsh-plugin-input-history — host plugin entry.
- *
- * Client-only plugin: the host half has no runtime work. The browser half
- * (`./client`) registers an invisible entry in `conversation.composer.dock`
- * that attaches a document-level `keydown` listener and implements
- * terminal-style prompt history navigation (ArrowUp/ArrowDown) over the
- * composer textarea.
- *
- * History is collected from `user` and `steering` conversation nodes as
- * they appear in any session's `ConversationSnapshot`, persisted to
- * `localStorage` (FIFO, capacity 500), and shared across all sessions
- * in the same browser profile.
- *
- * @module @huanlin/dsh-plugin-input-history
- */
-import type { Context } from '@deepseek-ai/cordis';
-export declare const name = "dsh-plugin-input-history";
-export declare const inject: string[];
-/**
- * Host apply — no-op. The history navigation is a pure client-side UI
- * contribution; no host-side resources are used.
- * @param _ctx - host context (unused).
- */
-export declare function apply(_ctx: Context): void;
+/**
+ * dsh-plugin-input-history — host plugin entry.
+ *
+ * Client-only plugin: the host half has no runtime work. The browser half
+ * (`./client`) registers an invisible entry in `conversation.composer.dock`
+ * that collects prompt history from the Chat target's user/steering nodes
+ * and implements terminal-style history navigation (ArrowUp/ArrowDown) over
+ * the composer's Lexical surface through `inputActions.setDraft`.
+ *
+ * History is collected from `user` and `steering` chat nodes of any active
+ * session, persisted to `localStorage` (FIFO, capacity 500), and shared
+ * across all sessions in the same browser profile.
+ *
+ * @module @huanlin/dsh-plugin-input-history
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "dsh-plugin-input-history";
+export declare const inject: string[];
+/**
+ * Host apply — no-op. The history navigation is a pure client-side UI
+ * contribution; no host-side resources are used.
+ * @param _ctx - host context (unused).
+ */
+export declare function apply(_ctx: Context): void;

package/lib/types/index.js

@@ -1,26 +1,25 @@
-/**
- * dsh-plugin-input-history — host plugin entry.
- *
- * Client-only plugin: the host half has no runtime work. The browser half
- * (`./client`) registers an invisible entry in `conversation.composer.dock`
- * that attaches a document-level `keydown` listener and implements
- * terminal-style prompt history navigation (ArrowUp/ArrowDown) over the
- * composer textarea.
- *
- * History is collected from `user` and `steering` conversation nodes as
- * they appear in any session's `ConversationSnapshot`, persisted to
- * `localStorage` (FIFO, capacity 500), and shared across all sessions
- * in the same browser profile.
- *
- * @module @huanlin/dsh-plugin-input-history
- */
-export const name = 'dsh-plugin-input-history';
-export const inject = [];
-/**
- * Host apply — no-op. The history navigation is a pure client-side UI
- * contribution; no host-side resources are used.
- * @param _ctx - host context (unused).
- */
-export function apply(_ctx) {
-    // Client-only plugin: all work happens in src/client/index.ts.
-}
+/**
+ * dsh-plugin-input-history — host plugin entry.
+ *
+ * Client-only plugin: the host half has no runtime work. The browser half
+ * (`./client`) registers an invisible entry in `conversation.composer.dock`
+ * that collects prompt history from the Chat target's user/steering nodes
+ * and implements terminal-style history navigation (ArrowUp/ArrowDown) over
+ * the composer's Lexical surface through `inputActions.setDraft`.
+ *
+ * History is collected from `user` and `steering` chat nodes of any active
+ * session, persisted to `localStorage` (FIFO, capacity 500), and shared
+ * across all sessions in the same browser profile.
+ *
+ * @module @huanlin/dsh-plugin-input-history
+ */
+export const name = 'dsh-plugin-input-history';
+export const inject = [];
+/**
+ * Host apply — no-op. The history navigation is a pure client-side UI
+ * contribution; no host-side resources are used.
+ * @param _ctx - host context (unused).
+ */
+export function apply(_ctx) {
+    // Client-only plugin: all work happens in src/client/index.ts.
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huanlin/dsh-plugin-input-history",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "publishConfig": {
     "access": "public"
   },
@@ -17,10 +17,6 @@
       "types": "./lib/types/index.d.ts",
       "import": "./lib/index.js"
     },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "import": "./lib/invariant.js"
-    },
     "./client": {
       "types": "./lib/types/client/index.d.ts",
       "default": "./lib/client.js"
@@ -38,41 +34,42 @@
     },
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-ui-slots",
-        "@deepseek-ai/dsh-client-ui-conversation"
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-chat",
+        "@deepseek-ai/dsh-client-ui-renderer"
       ],
       "platform": "web"
     }
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
-    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-chat": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
   "peerDependenciesMeta": {
-    "@deepseek-ai/dsh-client-locale": {
+    "@deepseek-ai/cordis": {
       "optional": true
     },
-    "@deepseek-ai/dsh-client-runtime": {
+    "@deepseek-ai/dsh-client-locale": {
       "optional": true
     },
-    "@deepseek-ai/dsh-client-ui-conversation": {
+    "@deepseek-ai/dsh-client-ui-chat": {
       "optional": true
     },
-    "@deepseek-ai/dsh-client-ui-slots": {
+    "@deepseek-ai/dsh-client-ui-conversation": {
       "optional": true
     },
-    "@deepseek-ai/dsh-invariants": {
+    "@deepseek-ai/dsh-client-ui-renderer": {
       "optional": true
     },
-    "@deepseek-ai/cordis": {
+    "@deepseek-ai/dsh-client-ui-slots": {
       "optional": true
     },
     "react": {

package/lib/invariant.js

@@ -1,24 +0,0 @@
-//#region src/invariant.ts
-const PACKAGE_NAME = "@huanlin/dsh-plugin-input-history";
-/** Cordis companion plugin name. */
-const name = "dsh-plugin-input-history-invariant";
-/** Service required before the companion can reserve package ownership. */
-const inject = ["invariants"];
-/**
-* No runtime invariant: the single `conversation.composer.dock` slot
-* registration is a registry-owned contribution whose disposal is proven
-* by the HMR-safety spec. The plugin's only mutable state is the
-* localStorage-backed history array, whose lifecycle is bounded by the
-* browser profile (not the cordis fiber) and whose write path is
-* last-writer-wins with try/catch containment.
-*/
-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 };

package/lib/types/invariant.d.ts

@@ -1,16 +0,0 @@
-/**
- * Package-owned invariant companion for `@huanlin/dsh-plugin-input-history`.
- *
- * @module @huanlin/dsh-plugin-input-history/invariant
- */
-import type { Context } from '@deepseek-ai/cordis';
-/** Cordis companion plugin name. */
-export declare const name = "dsh-plugin-input-history-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>;

package/lib/types/invariant.js

@@ -1,26 +0,0 @@
-/**
- * Package-owned invariant companion for `@huanlin/dsh-plugin-input-history`.
- *
- * @module @huanlin/dsh-plugin-input-history/invariant
- */
-const PACKAGE_NAME = '@huanlin/dsh-plugin-input-history';
-/** Cordis companion plugin name. */
-export const name = 'dsh-plugin-input-history-invariant';
-/** Service required before the companion can reserve package ownership. */
-export const inject = ['invariants'];
-/**
- * No runtime invariant: the single `conversation.composer.dock` slot
- * registration is a registry-owned contribution whose disposal is proven
- * by the HMR-safety spec. The plugin's only mutable state is the
- * localStorage-backed history array, whose lifecycle is bounded by the
- * browser profile (not the cordis fiber) and whose write path is
- * last-writer-wins with try/catch containment.
- */
-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.
- */
-export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-/* jscpd:ignore-end */