dsh-web-search-pro 0.2.1 → 0.2.3

package/lib/types/client/group-order.d.ts

@@ -0,0 +1,26 @@
+/**
+ * "Search order": the order a plain search tries its engines, and the order each platform tries its backends, as lists one
+ * moves, adds to and removes from (not as a comma text). Below the engine list sits the order a search would really use, with a
+ * sentence on why it differs from the list; the platforms are rows with a dialog. Everything stages into the same draft the sticky
+ * save bar writes: `engines` and `platformBackends` as they are, `sources.confidence.<id>` for the confidence box of a row.
+ * @module web-search-pro/client/group-order
+ */
+import { type Card } from './field-rows.tsx';
+/** The chain a plain search would try, from the draft, and one sentence on why it is not the list as written. */
+export declare function EffectiveChain({ card }: {
+    card: Card;
+}): import("react").JSX.Element;
+export declare function EngineOrder({ card }: {
+    card: Card;
+}): import("react").JSX.Element;
+/** The body of the platform dialog: the chain as a list with its buttons, the backends that can still be added, and "Restore default". */
+export declare function PlatformForm({ card, platform }: {
+    card: Card;
+    platform: string;
+}): import("react").JSX.Element;
+export declare function PlatformList({ card }: {
+    card: Card;
+}): import("react").JSX.Element;
+export declare function OrderGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;

package/lib/types/client/group-runtime.d.ts

@@ -0,0 +1,15 @@
+/**
+ * "Runtime and backends": the CLI / OpenCLI / Agent Reach switches, the Twitter / X login values (a dialog), the JSON objects
+ * that shape backends (Playwright, platform backend chains, CLI adapters) and the platform settings (custom platforms,
+ * selectors, browser bindings), each as a list with its own dialog. The backend order of the platforms and the custom CLIs have their own
+ * groups ("Search order", "Custom CLI"); their raw JSON is under "Advanced".
+ * @module web-search-pro/client/group-runtime
+ */
+import { type Card } from './field-rows.tsx';
+/** The two values twitter-cli needs: the controls of the dialog. */
+export declare function TwitterForm({ card }: {
+    card: Card;
+}): import("react").JSX.Element;
+export declare function RuntimeGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;

package/lib/types/client/group-sources.d.ts

@@ -0,0 +1,46 @@
+/**
+ * "Sources": how sources are ranked (policy, priority, disabled) and a list of the sources that need a key or an address: a
+ * row per source (name, tier, whether its key is set, and the "常用" mark), and one edit dialog per source holding its key
+ * reference, write-only key, endpoint and request budget. The anonymous sources are a folded reference table. Edits stage into
+ * the same draft the sticky save bar writes; a dialog has no save button of its own.
+ * @module web-search-pro/client/group-sources
+ */
+import { type Card } from './field-rows.tsx';
+import { type SourceDef } from './field-keys.ts';
+import type { CredentialId } from './form.ts';
+/** The write-only key of a source. It shows whether a key is stored, never the key. */
+export declare function SecretRow({ card, id, label }: {
+    card: Card;
+    id: CredentialId;
+    label: string;
+}): import("react").JSX.Element;
+/** Whether a source is usable as far as the card can tell: its key is stored, or (SearXNG) its address is set. */
+export declare function useSourceReady(card: Card, def: SourceDef): {
+    ready: boolean;
+    loading: boolean;
+};
+/** The controls of one source: reference name, write-only key, endpoint, extras and request budget. */
+export declare function SourceForm({ card, def }: {
+    card: Card;
+    def: SourceDef;
+}): import("react").JSX.Element;
+/** One source's edit dialog. */
+export declare function SourceDialog({ card, def, onClose }: {
+    card: Card;
+    def: SourceDef;
+    onClose: () => void;
+}): import("react").JSX.Element;
+/** One row of the sources list. */
+export declare function SourceItem({ card, def, onEdit }: {
+    card: Card;
+    def: SourceDef;
+    onEdit: () => void;
+}): import("react").JSX.Element;
+/** Open dialog state shared by the Common and Sources groups: one source at a time. */
+export declare function SourceList({ card, only }: {
+    card: Card;
+    only?: readonly string[];
+}): import("react").JSX.Element;
+export declare function SourcesGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;

package/lib/types/client/groups-basic.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The small groups: "Reading and evidence", "Network and cache", "Ranking weights" (advanced) and the built-in web tool
+ * "Route". Each is a handful of rows built from the same controls; the long explanations sit behind the `?`.
+ * @module web-search-pro/client/groups-basic
+ */
+import { type Card } from './field-rows.tsx';
+export declare function ReadingGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;
+export declare function NetworkGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;
+export declare function RankingGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;
+export declare function RouteGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;

package/lib/types/client/index.d.ts

@@ -1,6 +1,7 @@
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { Context } from './context-types.ts';
 import { type CredentialId, type RubricTextKey, type SettingField, type WebSearchCardState } from './form.ts';
+import type { TrialRequest } from '../rpc-types.ts';
 export declare const name = "web-search-pro-client";
 export declare const inject: string[];
 export declare const NS = "web-search-pro.card";
@@ -16,5 +17,12 @@ export type SettingsCardProps = PropsLocale<typeof NS> & {
     save: () => void;
     discard: () => void;
     refreshCredentials: () => void;
+    refreshStatus: () => void;
+    /** The agent overlay: read it again, drop entries (keys, or `'all'`), write one into the configuration and drop it. */
+    refreshOverlay: () => void;
+    revokeOverlay: (keys: readonly string[] | 'all') => void;
+    adoptOverlay: (key: string) => void;
+    runTrial: (request: TrialRequest) => void;
+    clearTrial: () => void;
 };
 export declare function apply(ctx: Context): void;

package/lib/types/client/json-list.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The settings that are whole JSON objects (custom providers, platform backend chains, CLI adapters, custom platforms, ...) as a
+ * list: a row each (name, how many entries it holds, "default" while it is empty) and one dialog with a code box and the
+ * server's own validation message. Nothing here is a second place the data lives: the box edits the same staged field.
+ * @module web-search-pro/client/json-list
+ */
+import { type Card } from './field-rows.tsx';
+/** How many entries a JSON object text holds; undefined when it is not an object. */
+export declare function entryCount(text: string): number | undefined;
+/** The code box of one JSON field. */
+export declare function JsonForm({ card, field }: {
+    card: Card;
+    field: string;
+}): import("react").JSX.Element;
+/** A list of JSON-object settings with its dialog. `fields` names which ones (see JSON_FIELDS). */
+export declare function JsonList({ card, fields }: {
+    card: Card;
+    fields: readonly string[];
+}): import("react").JSX.Element;
+/** The fields of one group of JSON settings. */
+export declare const jsonFieldsOf: (group: "judge" | "runtime" | "platform" | "advanced") => string[];