@monotykamary/dsh-client-ui-settings-plugins 0.1.0-rc.10

package/lib/types/client/web-search-card-controller.d.ts

@@ -0,0 +1,91 @@
+/**
+ * The web-search card's staged form over the `web-search-deepseek` settings
+ * namespace.
+ *
+ * The key is the one control that does not live in the section: its literal
+ * never rides a response, so the card learns only whether one is configured
+ * and writes it through the credentials domain, addressed by the reference the
+ * section names. It is still staged with the rest of the form, so one save
+ * covers everything the card shows.
+ */
+import type { IApiClient } from '@monotykamary/dsh-client-connection/client';
+import type { SettingsScope, SnapshotStore } from '@monotykamary/dsh-client-runtime/client';
+import { type CardActions, type CardFieldState, type CardShell } from './card-form.ts';
+/**
+ * Namespace of the DeepSeek search provider. Spelled here rather than
+ * imported: a client package must not depend on a Host package.
+ */
+export declare const WEB_SEARCH_NS = "web-search-deepseek";
+/** The search-provider fields this card edits. */
+export interface WebSearchSettings {
+    /** Credential reference naming the environment key. */
+    apiKeyEnv?: string;
+    /** Provider endpoint; blank inherits the provider default. */
+    baseURL?: string;
+    /** Maximum searches served within one request. */
+    maxUses?: number;
+}
+/** What the web-search card renders. */
+export interface WebSearchCardState extends CardShell {
+    /** Provider endpoint. */
+    baseURL: CardFieldState;
+    /** Searches allowed per request. */
+    maxUses: CardFieldState;
+    /** The staged credential, which starts blank on every load. */
+    apiKey: CardFieldState;
+    /** Whether the Host reports a credential configured for the referenced key. */
+    apiKeyConfigured: boolean;
+    /** Whether the credentials domain accepts a write for it; false disables the control. */
+    apiKeyWritable: boolean;
+}
+/** The registration-side face the web-search card's slot entry injects. */
+export interface WebSearchCardFace extends CardActions {
+    hooks: {
+        /** Card snapshot bound by the renderer as useWebSearchCard. */
+        webSearchCard: SnapshotStore<WebSearchCardState>;
+    };
+}
+/** Bridges the `web-search-deepseek` scope and the credentials domain onto the card. */
+export declare class WebSearchCardController {
+    private readonly scope;
+    private readonly api;
+    private readonly form;
+    private readonly store;
+    private credential;
+    /**
+     * @param scope - the bound settings scope for the `web-search-deepseek` namespace.
+     * @param api - wire face used for the credential the section references.
+     */
+    constructor(scope: SettingsScope<WebSearchSettings>, api: Pick<IApiClient, 'credentials'>);
+    private projection;
+    /**
+     * Ask the credentials domain about the reference the section currently names.
+     *
+     * The answer is stored with the reference it describes: `apiKeyEnv` can
+     * change between the request and its response, and two reads can settle out
+     * of order, so a response is published only while it still answers for the
+     * reference in force.
+     */
+    private readCredential;
+    /**
+     * Re-read after the Host reports a change to the reference this card watches.
+     *
+     * A key can be written from somewhere else — the Models page addresses the
+     * same reference — and the settings section does not change when it is, so
+     * without this the badge keeps reporting a state the Host already replaced.
+     * @param ref - the reference the Host reports as changed.
+     */
+    refreshCredential(ref: string): void;
+    /**
+     * Build the face the card's slot registration injects.
+     * @returns the card's snapshot and its form actions.
+     */
+    inject(): WebSearchCardFace;
+    /**
+     * Write the staged key, then re-read whether the Host now holds one.
+     * @param value - the staged credential literal.
+     * @returns whether the Host reports a configured credential afterwards.
+     */
+    private writeKey;
+}
+//# sourceMappingURL=web-search-card-controller.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Plugins settings surface, node half. The empty apply exists so the plugin
+ * appears in the host cordis.yml / Loader; the browser half owns the section
+ * and its configurable tab through exports["./client"], discovered from the
+ * package.json dsh.client declaration. Every section this page edits is owned
+ * by the Host plugin that registered it, so this package registers no
+ * namespace of its own.
+ */
+/** Host plugin body — no host-side behavior for this surface plugin. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

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

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@monotykamary/dsh-client-ui-settings-plugins",
+  "description": "Plugins settings section with feature-owned tabs and configurable host-plane plugin cards",
+  "version": "0.1.0-rc.10",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-settings-plugins"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@monotykamary/dsh-client-connection",
+        "@monotykamary/dsh-client-locale",
+        "@monotykamary/dsh-client-runtime",
+        "@monotykamary/dsh-client-ui-settings",
+        "@monotykamary/dsh-api-remotes"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "react": "^18.2.0",
+    "@monotykamary/cordis": "^4.0.1",
+    "@monotykamary/dsh-client-locale": "^0.1.0-rc.10",
+    "@monotykamary/dsh-client-connection": "^0.1.0-rc.10",
+    "@monotykamary/dsh-client-runtime": "^0.1.0-rc.10",
+    "@monotykamary/dsh-client-ui-settings": "^0.1.0-rc.10",
+    "@monotykamary/dsh-api-remotes": "^0.1.0-rc.10",
+    "@monotykamary/dsh-client-ui-primitives": "^0.1.0-rc.10",
+    "@monotykamary/dsh-invariants": "^0.1.0-rc.10",
+    "@monotykamary/dsh-client-web-react": "^0.1.0-rc.10",
+    "@monotykamary/dsh-client-ui-slots": "^0.1.0-rc.10"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "@monotykamary/cordis": "^4.0.1",
+    "@monotykamary/dsh-api-remotes": "^0.1.0-rc.10",
+    "@monotykamary/dsh-client-runtime": "^0.1.0-rc.10",
+    "@monotykamary/dsh-client-locale": "^0.1.0-rc.10",
+    "@monotykamary/dsh-client-connection": "^0.1.0-rc.10",
+    "@monotykamary/dsh-client-test-runtime": "^0.1.0-rc.10",
+    "@monotykamary/dsh-client-ui-slots": "^0.1.0-rc.10",
+    "@monotykamary/dsh-client-ui-settings": "^0.1.0-rc.10",
+    "@monotykamary/dsh-client-ui-primitives": "^0.1.0-rc.10",
+    "@monotykamary/dsh-client-web-react": "^0.1.0-rc.10",
+    "@monotykamary/dsh-invariants": "^0.1.0-rc.10"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "dependencies": {
+    "clsx": "^2.0.0"
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}