sqs-dsh-better-input 0.1.0

package/lib/client/templates-controller.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Client-side store for the prompt template library. Mirrors the settings
+ * controller: an external-store class consumed via useSyncExternalStore,
+ * one sticky initial fetch (also kicked off by the `/` trigger warm hook),
+ * and optimistic list updates after save/remove so the menu and the settings
+ * section stay in sync without refetching.
+ */
+import type { TemplateWire } from '../remote-contract.js';
+import type { BetterInputRemote } from '../remote.js';
+export type TemplatesSnapshot = {
+    readonly status: 'loading' | 'ready' | 'error';
+    readonly templates: readonly TemplateWire[];
+    readonly detail: string;
+};
+/** Form state: tags stay a raw comma-separated string until save. */
+export type TemplateDraft = {
+    readonly id?: string;
+    readonly name: string;
+    readonly description: string;
+    readonly tags: string;
+    readonly content: string;
+};
+type Listener = () => void;
+export declare class TemplatesController {
+    private readonly remote;
+    private snapshot;
+    private readonly listeners;
+    private disposed;
+    private loadPromise;
+    constructor(remote: BetterInputRemote);
+    readonly getSnapshot: () => TemplatesSnapshot;
+    readonly subscribe: (listener: Listener) => (() => void);
+    readonly byId: (id: string) => TemplateWire | undefined;
+    /** Kick off the one-time initial fetch; safe to call repeatedly. */
+    readonly ensureLoaded: () => void;
+    refresh(): Promise<void>;
+    /** Create or update one template; resolves false when the call failed. */
+    save(draft: TemplateDraft): Promise<boolean>;
+    /** Remove one template; resolves false when the call failed. */
+    remove(id: string): Promise<boolean>;
+    dispose(): void;
+    private emit;
+}
+export declare function useTemplatesSnapshot(controller: TemplatesController): TemplatesSnapshot;
+export {};

package/lib/client/templates-section.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Settings section for the prompt template library: list saved templates,
+ * create/edit through an inline form, and delete with a two-step confirm.
+ * Mirrors the settings section conventions (framework-injected `t` + local
+ * frame/field components + dsw CSS variables).
+ */
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { TemplatesController } from './templates-controller.js';
+/** The framework-injected `t` seat for the BetterInput namespace. */
+type Translate = TranslateNS<'better-input'>;
+export type TemplatesSectionProps = {
+    readonly close: () => void;
+    readonly t: Translate;
+    readonly templatesController: TemplatesController;
+};
+export declare function TemplatesSection({ t, templatesController }: TemplatesSectionProps): import("react").JSX.Element;
+export {};

package/lib/client/templates-source.d.ts

@@ -0,0 +1,16 @@
+import type { InputTriggerSource } from '@deepseek-ai/dsh-client-ui-input-trigger/client';
+import type { TemplatesController } from './templates-controller.js';
+/** Unique source name on the `/` trigger (the menu group title). */
+export declare const TEMPLATES_SOURCE_NAME = "better-input-templates";
+/**
+ * The input-trigger source that inserts stored prompt templates as literal
+ * text on the `/` trigger.
+ *
+ * - `warm()` prefetches the template list when the input box mounts, so the
+ *   first `/` keystroke already shows entries.
+ * - `candidates()` filters by name / description / tag substring.
+ * - `onPick()` returns `{ text: content }` — the trigger token span is
+ *   replaced by the template body, so `/name` never persists in the draft
+ *   and no lexicon/codec registration is needed.
+ */
+export declare function createTemplatesSource(controller: TemplatesController): InputTriggerSource;

package/lib/client/voice-session.d.ts

@@ -0,0 +1,35 @@
+export type VoiceInputState = 'idle' | 'starting' | 'recording' | 'transcribing' | 'polishing' | 'error' | 'polish-error';
+export type VoiceInputSessionSnapshot = {
+    readonly state: VoiceInputState;
+    readonly detail: string;
+};
+type Listener = () => void;
+type StopListener = () => void;
+export declare const VOICE_ERROR_DISMISS_MS = 2600;
+/**
+ * Shared voice-input state for one session, written from scratch for
+ * sqs-dsh-better-input. The microphone button and the recognition bar both
+ * subscribe; the bar can request stop/cancel through the same instance.
+ */
+export declare class VoiceInputSession {
+    private snapshot;
+    private readonly listeners;
+    private readonly stopListeners;
+    private readonly cancelListeners;
+    private epoch;
+    private errorTimer;
+    captureEpoch(): number;
+    isCurrentEpoch(epoch: number): boolean;
+    readonly getSnapshot: () => VoiceInputSessionSnapshot;
+    readonly subscribe: (listener: Listener) => (() => void);
+    readonly onStopRequested: (listener: StopListener) => (() => void);
+    readonly onCancelRequested: (listener: StopListener) => (() => void);
+    setState(state: VoiceInputState, detail?: string): void;
+    requestStop(): void;
+    requestCancel(): void;
+    dispose(): void;
+    private clearErrorTimer;
+    private emit;
+}
+export declare function useVoiceInputSession(session: VoiceInputSession): VoiceInputSessionSnapshot;
+export {};

package/lib/client/web-speech.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Browser Web Speech recognition session, written from scratch for
+ * sqs-dsh-better-input. Wraps SpeechRecognition / webkitSpeechRecognition with a
+ * small structural interface so no DOM lib augmentation is required.
+ */
+export type WebSpeechState = 'starting' | 'recording' | 'stopped' | 'error';
+export type WebSpeechSessionOptions = {
+    language: string;
+    onStart?: () => void;
+    onInterim: (text: string) => void;
+    onFinal: (text: string) => void;
+    onError: (error: Error) => void;
+    onEnd: (text: string) => void;
+};
+export declare function isWebSpeechAvailable(): boolean;
+export declare class WebSpeechSession {
+    private readonly recognition;
+    private readonly options;
+    private active;
+    private stopping;
+    private finalText;
+    private lastHeard;
+    private ended;
+    private silent;
+    constructor(options: WebSpeechSessionOptions);
+    start(): void;
+    stop(): void;
+    abort(): void;
+    private handleResult;
+    private handleError;
+    private handleEnd;
+    private fail;
+    private endOnce;
+}
+export declare function appendSpeech(current: string, next: string): string;

package/lib/client.d.ts

@@ -0,0 +1 @@
+export { apply, inject } from './client/index.js';