@lmzhen/dsh-evolution-client-kit 0.0.0 → 0.30.28

package/README.md

@@ -1 +1,9 @@
-# placeholder
+# @lmzhen/dsh-evolution-client-kit
+
+Browser-side seams and lifecycle shared by the evolution family's sidebar panels.
+It owns the client contract types, generated route/state/contract tables, design tokens, and
+one `registerSidebarPanel` entry point that installs the locale, stylesheet, row, and keyed
+main body. It is a library, not a plugin row: it declares no `dsh.client` entry.
+
+Feature panels keep their own Panel/Store/api and icon; only the platform-facing lifecycle
+lives here. settings-ui keeps its settings-section lifecycle, but shares the generated tables.

package/lib/generated/contracts.generated.js

@@ -0,0 +1 @@
+export {};

package/lib/generated/fallbacks.generated.js

@@ -0,0 +1,18 @@
+//#region lib/types/generated/fallbacks.generated.js
+/**
+* The command-face fallback for every Host surface, generated from evolution-commands'
+* COMMAND_FALLBACKS (the ONE home). When the platform's connection carrier is absent (E-325) the
+* panels render this hint instead of a bare HTTP failure — same use case, command face.
+*/
+const FALLBACKS = {
+	approval: { command: "/evolution pending … /evolution approve <id> … /evolution reject <id> … /evolution release <id>" },
+	"skill-history": { command: "/evolution restore <name> [v]（查看：/evolution skills history <name>）" },
+	"skill-health": { command: "/evolution skills refresh（健康行：/evolution doctor）" },
+	merge: { command: "/evolution merge status / pending / approve <id> / report" },
+	diagnostics: {
+		command: "/evolution doctor",
+		platformCli: "dsh --json /evolution doctor"
+	}
+};
+//#endregion
+export { FALLBACKS };

package/lib/generated/route-client.generated.js

@@ -0,0 +1,96 @@
+//#region lib/types/generated/route-client.generated.js
+/** Classify a non-2xx status: 401/403/404 keep their own kind, everything else is a server answer. */
+function classify(status) {
+	if (status === 401) return {
+		kind: "unauthenticated",
+		status: 401
+	};
+	if (status === 403) return {
+		kind: "forbidden",
+		status: 403
+	};
+	if (status === 404) return {
+		kind: "unmounted",
+		status: 404
+	};
+	return {
+		kind: "server",
+		status
+	};
+}
+/**
+* One request, no retries and no body parsing for the platform's admission answers.
+* @param doFetch - the fetch in use (the browser's, or a spec's stub).
+* @param path - the exact route path from the generated ROUTES table.
+* @param init - standard RequestInit.
+* @returns the data, or the classified failure (network/parse failures read as 'server').
+*/
+async function requestJson(doFetch, path, init) {
+	let response;
+	try {
+		response = await doFetch(path, init);
+	} catch (error) {
+		return {
+			ok: false,
+			failure: {
+				kind: "server",
+				status: 0,
+				detail: error instanceof Error ? error.message : String(error)
+			}
+		};
+	}
+	if (!response.ok) return {
+		ok: false,
+		failure: classify(response.status)
+	};
+	let body;
+	try {
+		body = await response.json();
+	} catch {
+		return {
+			ok: false,
+			failure: {
+				kind: "server",
+				status: response.status
+			}
+		};
+	}
+	if (typeof body === "object" && body !== null) {
+		const record = body;
+		if (record.ok === true) return {
+			ok: true,
+			data: record.data
+		};
+		const nested = record.error;
+		const errorRecord = typeof nested === "object" && nested !== null ? nested : void 0;
+		const code = typeof record.code === "string" && record.code !== "" ? record.code : typeof errorRecord?.code === "string" ? errorRecord.code : void 0;
+		const message = typeof record.message === "string" && record.message !== "" ? record.message : typeof errorRecord?.message === "string" ? errorRecord.message : void 0;
+		if (record.ok === false && code !== void 0 && message !== void 0 && message !== "") return {
+			ok: false,
+			failure: {
+				kind: "refused",
+				code,
+				message
+			}
+		};
+	}
+	return {
+		ok: false,
+		failure: {
+			kind: "server",
+			status: response.status
+		}
+	};
+}
+/** The one-sentence rendering legacy callers attach to a classified failure. */
+function failureMessage(failure) {
+	switch (failure.kind) {
+		case "refused": return failure.message;
+		case "server": return failure.status === 0 ? failure.detail === void 0 || failure.detail === "" ? "网络错误：无法连接宿主" : failure.detail : "HTTP " + String(failure.status);
+		case "unauthenticated": return "HTTP 401";
+		case "forbidden": return "HTTP 403";
+		case "unmounted": return "HTTP 404";
+	}
+}
+//#endregion
+export { classify, failureMessage, requestJson };

package/lib/generated/routes.generated.js

@@ -0,0 +1,35 @@
+//#region lib/types/generated/routes.generated.js
+/**
+* Every family host path, generated from evolution-core's HOST_ROUTES (the ONE declaration).
+* A browser half cannot import the host package at runtime (client bundles keep @deepseek-ai/*
+* external), so the table is mirrored here mechanically; a rename in core regenerates all three
+* client copies, and the generator's --check makes a stale copy red.
+*/
+const ROUTES = {
+	approval: {
+		pending: "/api/dsh-evolution/approval/pending",
+		preview: "/api/dsh-evolution/approval/preview",
+		approve: "/api/dsh-evolution/approval/approve",
+		reject: "/api/dsh-evolution/approval/reject"
+	},
+	"skill-history": {
+		skills: "/api/dsh-evolution/skill-history/skills",
+		versions: "/api/dsh-evolution/skill-history/versions",
+		diff: "/api/dsh-evolution/skill-history/versions/diff",
+		body: "/api/dsh-evolution/skill-history/versions/body",
+		undo: "/api/dsh-evolution/skill-history/undo",
+		health: "/api/dsh-evolution/skill-history/health"
+	},
+	"skill-health": { rows: "/api/dsh-evolution/skill-health/rows" },
+	merge: {
+		view: "/api/dsh-evolution/merge/view",
+		rows: "/api/dsh-evolution/merge/rows",
+		run: "/api/dsh-evolution/merge/run",
+		runs: "/api/dsh-evolution/merge/runs",
+		body: "/api/dsh-evolution/merge/body",
+		history: "/api/dsh-evolution/merge/history"
+	},
+	diagnostics: { view: "/api/dsh-evolution/diagnostics" }
+};
+//#endregion
+export { ROUTES };

package/lib/generated/states.generated.js

@@ -0,0 +1,42 @@
+import { createElement } from "react";
+//#region lib/types/generated/states.generated.js
+/** Map one classified answer onto the card's four states. */
+function loadStateOf(answer, isEmpty) {
+	if (!answer.ok) return {
+		phase: "failed",
+		failure: answer.failure
+	};
+	return isEmpty(answer.data) ? { phase: "empty" } : {
+		phase: "ready",
+		data: answer.data
+	};
+}
+/** A neutral/ warn/ fail block; a fail block is role=alert so assistive tech announces it. */
+function Block(props) {
+	const tone = props.tone ?? "neutral";
+	return createElement("div", {
+		"data-tone": tone,
+		...tone === "fail" ? { role: "alert" } : {}
+	}, props.title === void 0 ? null : createElement("div", { "data-tone-title": tone }, props.title), props.children);
+}
+/** One classified failure as a reader-facing sentence. */
+function failureText(failure, t) {
+	switch (failure.kind) {
+		case "unauthenticated": return t("failureUnauthorized");
+		case "forbidden": return t("failureForbidden");
+		case "unmounted": return t("failureUnmounted");
+		case "server": return failure.status === 0 ? t("failureServer") : t("failureServer") + " (HTTP " + String(failure.status) + ")";
+		case "refused": return failure.message;
+	}
+}
+/** The failed-state block: sentence + (when the surface exists but is unreachable) the command fallback. */
+function FailureBlock(props) {
+	const hint = props.fallback === void 0 ? null : createElement("div", { "data-tone-hint": "true" }, props.t("fallbackHint", { command: props.fallback.command }));
+	return Block({
+		tone: "fail",
+		title: failureText(props.failure, props.t),
+		children: hint
+	});
+}
+//#endregion
+export { Block, FailureBlock, failureText, loadStateOf };

package/lib/index.js

@@ -0,0 +1,84 @@
+import { ROUTES } from "./generated/routes.generated.js";
+import { FALLBACKS } from "./generated/fallbacks.generated.js";
+import "./generated/contracts.generated.js";
+import { Block, FailureBlock, failureText, loadStateOf } from "./generated/states.generated.js";
+import { TOKENS, TOKEN_CSS, tokenVars } from "./tokens.js";
+//#region lib/types/panel.js
+function interpolate(text, values) {
+	if (values === void 0) return text;
+	return text.replace(/\{(\w+)\}/g, (_match, key) => String(values[key] ?? ""));
+}
+function injectStyles(doc, css, tagId) {
+	if (doc === void 0) return () => {};
+	if (doc.querySelector("style[data-plugin-css=\"" + tagId + "\"]") !== null) return () => {};
+	const tag = doc.createElement("style");
+	tag.setAttribute("data-plugin-css", tagId);
+	tag.textContent = css;
+	doc.head.append(tag);
+	return () => {
+		tag.remove();
+	};
+}
+/**
+* Register one sidebar row and its main body under one lifecycle.
+* @param ctx - the client context carrying the slots and locale seats.
+* @param spec - the feature-specific row/body descriptor.
+*/
+function registerSidebarPanel(ctx, spec) {
+	const seam = ctx;
+	let registered = false;
+	ctx.effect(() => {
+		try {
+			const dispose = seam.locale.register(spec.namespace, spec.dictionaries);
+			registered = true;
+			return dispose;
+		} catch (error) {
+			ctx.logger.warn(spec.namespace + ": the locale seat refused the dictionary (" + String(error) + "); the panel falls back to the bundle copy");
+			return () => {};
+		}
+	}, spec.namespace + ": locale");
+	ctx.effect(() => injectStyles(typeof document === "undefined" ? void 0 : document, spec.styles.css, spec.styles.tagId), spec.namespace + ": styles");
+	const fallback = spec.dictionaries[spec.fallback ?? "zh"];
+	const lookup = (key) => {
+		const own = fallback[key] ?? key;
+		if (!registered) return own;
+		try {
+			return seam.locale.bind(spec.namespace)(key);
+		} catch {
+			return own;
+		}
+	};
+	const t = (key, values) => interpolate(lookup(key), values);
+	const label = () => lookup("entry.label");
+	seam.slots.inject("sidebar.panellist", function* () {
+		yield seam.slots.register({
+			name: "sidebar.panellist",
+			id: spec.id,
+			order: spec.order,
+			label
+		}, spec.icon);
+		yield seam.slots.register({
+			name: "main",
+			key: spec.id,
+			inject: () => spec.body(t)
+		}, spec.component);
+	});
+}
+//#endregion
+//#region lib/types/workspace.js
+/**
+* Best-effort workspace id; a seat that is absent or refuses leaves the panel in local scope.
+* @param ctx - the client context.
+* @returns the current workspace id, or undefined.
+*/
+function panelWorkspaceId(ctx) {
+	const get = ctx.get;
+	if (typeof get !== "function") return void 0;
+	for (const name of ["workspace", "uiWorkspace"]) try {
+		const seat = get.call(ctx, name);
+		const id = seat?.workspaceId ?? seat?.currentWorkspaceId;
+		if (typeof id === "string" && id.trim() !== "") return id;
+	} catch {}
+}
+//#endregion
+export { Block, FALLBACKS, FailureBlock, ROUTES, TOKENS, TOKEN_CSS, failureText, loadStateOf, panelWorkspaceId, registerSidebarPanel, tokenVars };

package/lib/tokens.js

@@ -0,0 +1,57 @@
+//#region lib/types/tokens.js
+/**
+* The family client scale - GENERATED from packages/scripts/client-tokens.json. Do not edit.
+*
+* The shared client kit carries this file, because the scale is one fact: `verify-client-tokens.mjs`
+* (a gate step) fails when the kit copy drifts from the source. The kit bundles into each browser
+* half at build time, so no runtime module-table row is needed.
+*
+* Usage: put `tokenVars(...)` for your root class in the package stylesheet, then read
+* `var(--evo-group-name)` in its rules.
+* Regenerate with: node packages/scripts/gen-client-tokens.mjs packages
+* @module dsh-evolution-client-scale
+*/
+/** Every custom property of the scale, in the source order. */
+const TOKENS = {
+	"--evo-type-lg": "calc(1em + 2px)",
+	"--evo-type-body": "1em",
+	"--evo-type-sm": "calc(1em - 1px)",
+	"--evo-type-xs": "calc(1em - 2px)",
+	"--evo-space-2": "2px",
+	"--evo-space-4": "4px",
+	"--evo-space-6": "6px",
+	"--evo-space-8": "8px",
+	"--evo-space-10": "10px",
+	"--evo-space-12": "12px",
+	"--evo-space-14": "14px",
+	"--evo-space-16": "16px",
+	"--evo-space-20": "20px",
+	"--evo-radius-chip": "4px",
+	"--evo-radius-control": "8px",
+	"--evo-radius-surface": "12px",
+	"--evo-radius-pill": "999px",
+	"--evo-hairline-width": ".5px",
+	"--evo-hairline-marker": "2px",
+	"--evo-measure-read": "80ch",
+	"--evo-leading-base": "1.5",
+	"--evo-tone-quiet": "var(--dsw-alias-label-secondary)",
+	"--evo-tone-primary": "var(--dsw-alias-brand-primary)",
+	"--evo-tone-danger": "var(--dsw-alias-state-error-primary)",
+	"--evo-tone-success": "var(--dsw-alias-state-success-primary)",
+	"--evo-focus-ring": "2px solid var(--dsw-alias-label-primary)",
+	"--evo-focus-offset": "-2px",
+	"--evo-cap-aside": "280px",
+	"--evo-cap-block": "260px"
+};
+/** The declarations, without a selector. */
+const TOKEN_CSS = "--evo-type-lg:calc(1em + 2px);--evo-type-body:1em;--evo-type-sm:calc(1em - 1px);--evo-type-xs:calc(1em - 2px);--evo-space-2:2px;--evo-space-4:4px;--evo-space-6:6px;--evo-space-8:8px;--evo-space-10:10px;--evo-space-12:12px;--evo-space-14:14px;--evo-space-16:16px;--evo-space-20:20px;--evo-radius-chip:4px;--evo-radius-control:8px;--evo-radius-surface:12px;--evo-radius-pill:999px;--evo-hairline-width:.5px;--evo-hairline-marker:2px;--evo-measure-read:80ch;--evo-leading-base:1.5;--evo-tone-quiet:var(--dsw-alias-label-secondary);--evo-tone-primary:var(--dsw-alias-brand-primary);--evo-tone-danger:var(--dsw-alias-state-error-primary);--evo-tone-success:var(--dsw-alias-state-success-primary);--evo-focus-ring:2px solid var(--dsw-alias-label-primary);--evo-focus-offset:-2px;--evo-cap-aside:280px;--evo-cap-block:260px";
+/**
+* The scale, declared on one element so it never leaks into the host shell.
+* @param scope - the selector the custom properties are declared on.
+* @returns the declaration block to put in the stylesheet.
+*/
+function tokenVars(scope) {
+	return scope + "{--evo-type-lg:calc(1em + 2px);--evo-type-body:1em;--evo-type-sm:calc(1em - 1px);--evo-type-xs:calc(1em - 2px);--evo-space-2:2px;--evo-space-4:4px;--evo-space-6:6px;--evo-space-8:8px;--evo-space-10:10px;--evo-space-12:12px;--evo-space-14:14px;--evo-space-16:16px;--evo-space-20:20px;--evo-radius-chip:4px;--evo-radius-control:8px;--evo-radius-surface:12px;--evo-radius-pill:999px;--evo-hairline-width:.5px;--evo-hairline-marker:2px;--evo-measure-read:80ch;--evo-leading-base:1.5;--evo-tone-quiet:var(--dsw-alias-label-secondary);--evo-tone-primary:var(--dsw-alias-brand-primary);--evo-tone-danger:var(--dsw-alias-state-error-primary);--evo-tone-success:var(--dsw-alias-state-success-primary);--evo-focus-ring:2px solid var(--dsw-alias-label-primary);--evo-focus-offset:-2px;--evo-cap-aside:280px;--evo-cap-block:260px}";
+}
+//#endregion
+export { TOKENS, TOKEN_CSS, tokenVars };

package/lib/types/generated/contracts.generated.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Literal mirror of the frozen Host diagnostics contract (W1 §2.8 / core diagnostics.ts). The browser
+ * build keeps every @deepseek-ai/* specifier external, so the client CANNOT import the host type — the
+ * shape is mirrored mechanically here instead. The key unions are rendered from core diagnostics.ts by
+ * the generator, so a key change regenerates all three copies (a stale copy fails --check).
+ */
+export type DiagnosticsSchemaVersion = 2;
+export type DiagnosticsFactKey = 'platform-line' | 'family-version' | 'install-form' | 'preset-ids' | 'readonly-contract' | 'upgrade-order' | 'fallback-map';
+export type DiagnosticsRuntimeKey = 'subagent-channel' | 'restricted-preset' | 'host-surface' | 'session-fold' | 'platform-services' | 'runs' | 'platform-pairing' | 'install-form-detected';
+export type DiagnosticStatus = 'ok' | 'warn' | 'fail' | 'unknown';
+export interface DocFactRow {
+    readonly key: DiagnosticsFactKey;
+    readonly label: string;
+    readonly value: string;
+    readonly home: string;
+}
+export interface DiagnosticRow {
+    readonly key: DiagnosticsRuntimeKey;
+    readonly label: string;
+    readonly status: DiagnosticStatus;
+    readonly detail?: string;
+    readonly remedy?: string;
+}
+export interface DiagnosticsView {
+    readonly schemaVersion: DiagnosticsSchemaVersion;
+    readonly generatedAt: string;
+    readonly facts: readonly DocFactRow[];
+    readonly runtime: readonly DiagnosticRow[];
+}
+/** The installation form the doctor reports (W8 install-form-detected row). */
+export type InstallFormId = 'M1' | 'M2' | 'M3' | 'M4';
+/** One surface's command-face path(s) — the client `fallbacks.generated.ts` table's row type. */
+export interface FallbackHint {
+    readonly command: string;
+    readonly platformCli?: string;
+}
+//# sourceMappingURL=contracts.generated.d.ts.map

package/lib/types/generated/contracts.generated.js

@@ -0,0 +1,3 @@
+// GENERATED by packages/scripts/gen-client-seam.mjs from evolution-core diagnostics.ts + templates/client/contracts.ts.tmpl — do not edit.
+export {};
+//# sourceMappingURL=contracts.generated.js.map

package/lib/types/generated/fallbacks.generated.d.ts

@@ -0,0 +1,8 @@
+import type { FallbackHint } from './contracts.generated.ts';
+/**
+ * The command-face fallback for every Host surface, generated from evolution-commands'
+ * COMMAND_FALLBACKS (the ONE home). When the platform's connection carrier is absent (E-325) the
+ * panels render this hint instead of a bare HTTP failure — same use case, command face.
+ */
+export declare const FALLBACKS: Readonly<Record<'approval' | 'skill-history' | 'skill-health' | 'merge' | 'diagnostics', FallbackHint>>;
+//# sourceMappingURL=fallbacks.generated.d.ts.map

package/lib/types/generated/fallbacks.generated.js

@@ -0,0 +1,25 @@
+// GENERATED by packages/scripts/gen-client-seam.mjs from evolution-commands COMMAND_FALLBACKS — do not edit.
+/**
+ * The command-face fallback for every Host surface, generated from evolution-commands'
+ * COMMAND_FALLBACKS (the ONE home). When the platform's connection carrier is absent (E-325) the
+ * panels render this hint instead of a bare HTTP failure — same use case, command face.
+ */
+export const FALLBACKS = {
+    approval: {
+        command: '/evolution pending … /evolution approve <id> … /evolution reject <id> … /evolution release <id>',
+    },
+    'skill-history': {
+        command: '/evolution restore <name> [v]（查看：/evolution skills history <name>）',
+    },
+    'skill-health': {
+        command: '/evolution skills refresh（健康行：/evolution doctor）',
+    },
+    merge: {
+        command: '/evolution merge status / pending / approve <id> / report',
+    },
+    diagnostics: {
+        command: '/evolution doctor',
+        platformCli: 'dsh --json /evolution doctor',
+    },
+};
+//# sourceMappingURL=fallbacks.generated.js.map

package/lib/types/generated/route-client.generated.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The four-state transport classifier every family client shares (W7 §2). The platform owns
+ * admission (401/403/404 are its answers, not ours), so the client reads the STATUS only for those
+ * three and never tries to interpret a platform body. Everything the family route itself answers
+ * keeps its business envelope: 2xx + {ok:true,data} or 2xx + {ok:false,code,message}.
+ */
+export type RouteFailure = {
+    readonly kind: 'unauthenticated';
+    readonly status: 401;
+} | {
+    readonly kind: 'forbidden';
+    readonly status: 403;
+} | {
+    readonly kind: 'unmounted';
+    readonly status: 404;
+} | {
+    readonly kind: 'server';
+    readonly status: number;
+    readonly detail?: string;
+} | {
+    readonly kind: 'refused';
+    readonly code: string;
+    readonly message: string;
+};
+/** One route answer: the data, or the classified failure. */
+export type RouteAnswer<T> = {
+    readonly ok: true;
+    readonly data: T;
+} | {
+    readonly ok: false;
+    readonly failure: RouteFailure;
+};
+/** Classify a non-2xx status: 401/403/404 keep their own kind, everything else is a server answer. */
+export declare function classify(status: number): RouteFailure;
+/**
+ * One request, no retries and no body parsing for the platform's admission answers.
+ * @param doFetch - the fetch in use (the browser's, or a spec's stub).
+ * @param path - the exact route path from the generated ROUTES table.
+ * @param init - standard RequestInit.
+ * @returns the data, or the classified failure (network/parse failures read as 'server').
+ */
+export declare function requestJson<T>(doFetch: typeof fetch, path: string, init?: RequestInit): Promise<RouteAnswer<T>>;
+/** The one-sentence rendering legacy callers attach to a classified failure. */
+export declare function failureMessage(failure: RouteFailure): string;
+//# sourceMappingURL=route-client.generated.d.ts.map

package/lib/types/generated/route-client.generated.js

@@ -0,0 +1,62 @@
+// GENERATED by packages/scripts/gen-client-seam.mjs from packages/scripts/templates/client/route-client.ts.tmpl — do not edit.
+/** Classify a non-2xx status: 401/403/404 keep their own kind, everything else is a server answer. */
+export function classify(status) {
+    if (status === 401)
+        return { kind: 'unauthenticated', status: 401 };
+    if (status === 403)
+        return { kind: 'forbidden', status: 403 };
+    if (status === 404)
+        return { kind: 'unmounted', status: 404 };
+    return { kind: 'server', status };
+}
+/**
+ * One request, no retries and no body parsing for the platform's admission answers.
+ * @param doFetch - the fetch in use (the browser's, or a spec's stub).
+ * @param path - the exact route path from the generated ROUTES table.
+ * @param init - standard RequestInit.
+ * @returns the data, or the classified failure (network/parse failures read as 'server').
+ */
+export async function requestJson(doFetch, path, init) {
+    let response;
+    try {
+        response = await doFetch(path, init);
+    }
+    catch (error) {
+        return { ok: false, failure: { kind: 'server', status: 0, detail: error instanceof Error ? error.message : String(error) } };
+    }
+    if (!response.ok)
+        return { ok: false, failure: classify(response.status) };
+    let body;
+    try {
+        body = await response.json();
+    }
+    catch {
+        return { ok: false, failure: { kind: 'server', status: response.status } };
+    }
+    if (typeof body === 'object' && body !== null) {
+        const record = body;
+        if (record.ok === true)
+            return { ok: true, data: record.data };
+        const nested = record.error;
+        const errorRecord = typeof nested === 'object' && nested !== null ? nested : undefined;
+        const code = typeof record.code === 'string' && record.code !== '' ? record.code : typeof errorRecord?.code === 'string' ? errorRecord.code : undefined;
+        const message = typeof record.message === 'string' && record.message !== '' ? record.message : typeof errorRecord?.message === 'string' ? errorRecord.message : undefined;
+        if (record.ok === false && code !== undefined && message !== undefined && message !== '') {
+            return { ok: false, failure: { kind: 'refused', code, message } };
+        }
+    }
+    return { ok: false, failure: { kind: 'server', status: response.status } };
+}
+/** The one-sentence rendering legacy callers attach to a classified failure. */
+export function failureMessage(failure) {
+    switch (failure.kind) {
+        case 'refused': return failure.message;
+        case 'server': return failure.status === 0
+            ? (failure.detail === undefined || failure.detail === '' ? '网络错误：无法连接宿主' : failure.detail)
+            : 'HTTP ' + String(failure.status);
+        case 'unauthenticated': return 'HTTP 401';
+        case 'forbidden': return 'HTTP 403';
+        case 'unmounted': return 'HTTP 404';
+    }
+}
+//# sourceMappingURL=route-client.generated.js.map

package/lib/types/generated/routes.generated.d.ts

@@ -0,0 +1,39 @@
+/** One host data-plane surface the browser half can call. */
+export type SurfaceId = 'approval' | 'skill-history' | 'skill-health' | 'merge' | 'diagnostics';
+/**
+ * Every family host path, generated from evolution-core's HOST_ROUTES (the ONE declaration).
+ * A browser half cannot import the host package at runtime (client bundles keep @deepseek-ai/*
+ * external), so the table is mirrored here mechanically; a rename in core regenerates all three
+ * client copies, and the generator's --check makes a stale copy red.
+ */
+export declare const ROUTES: {
+    readonly approval: {
+        readonly pending: "/api/dsh-evolution/approval/pending";
+        readonly preview: "/api/dsh-evolution/approval/preview";
+        readonly approve: "/api/dsh-evolution/approval/approve";
+        readonly reject: "/api/dsh-evolution/approval/reject";
+    };
+    readonly 'skill-history': {
+        readonly skills: "/api/dsh-evolution/skill-history/skills";
+        readonly versions: "/api/dsh-evolution/skill-history/versions";
+        readonly diff: "/api/dsh-evolution/skill-history/versions/diff";
+        readonly body: "/api/dsh-evolution/skill-history/versions/body";
+        readonly undo: "/api/dsh-evolution/skill-history/undo";
+        readonly health: "/api/dsh-evolution/skill-history/health";
+    };
+    readonly 'skill-health': {
+        readonly rows: "/api/dsh-evolution/skill-health/rows";
+    };
+    readonly merge: {
+        readonly view: "/api/dsh-evolution/merge/view";
+        readonly rows: "/api/dsh-evolution/merge/rows";
+        readonly run: "/api/dsh-evolution/merge/run";
+        readonly runs: "/api/dsh-evolution/merge/runs";
+        readonly body: "/api/dsh-evolution/merge/body";
+        readonly history: "/api/dsh-evolution/merge/history";
+    };
+    readonly diagnostics: {
+        readonly view: "/api/dsh-evolution/diagnostics";
+    };
+};
+//# sourceMappingURL=routes.generated.d.ts.map

package/lib/types/generated/routes.generated.js

@@ -0,0 +1,38 @@
+// GENERATED by packages/scripts/gen-client-seam.mjs from evolution-core HOST_ROUTES — do not edit.
+/**
+ * Every family host path, generated from evolution-core's HOST_ROUTES (the ONE declaration).
+ * A browser half cannot import the host package at runtime (client bundles keep @deepseek-ai/*
+ * external), so the table is mirrored here mechanically; a rename in core regenerates all three
+ * client copies, and the generator's --check makes a stale copy red.
+ */
+export const ROUTES = {
+    approval: {
+        pending: '/api/dsh-evolution/approval/pending',
+        preview: '/api/dsh-evolution/approval/preview',
+        approve: '/api/dsh-evolution/approval/approve',
+        reject: '/api/dsh-evolution/approval/reject',
+    },
+    'skill-history': {
+        skills: '/api/dsh-evolution/skill-history/skills',
+        versions: '/api/dsh-evolution/skill-history/versions',
+        diff: '/api/dsh-evolution/skill-history/versions/diff',
+        body: '/api/dsh-evolution/skill-history/versions/body',
+        undo: '/api/dsh-evolution/skill-history/undo',
+        health: '/api/dsh-evolution/skill-history/health',
+    },
+    'skill-health': {
+        rows: '/api/dsh-evolution/skill-health/rows',
+    },
+    merge: {
+        view: '/api/dsh-evolution/merge/view',
+        rows: '/api/dsh-evolution/merge/rows',
+        run: '/api/dsh-evolution/merge/run',
+        runs: '/api/dsh-evolution/merge/runs',
+        body: '/api/dsh-evolution/merge/body',
+        history: '/api/dsh-evolution/merge/history',
+    },
+    diagnostics: {
+        view: '/api/dsh-evolution/diagnostics',
+    },
+};
+//# sourceMappingURL=routes.generated.js.map

package/lib/types/generated/states.generated.d.ts

@@ -0,0 +1,43 @@
+import { type ReactNode } from 'react';
+import type { RouteAnswer, RouteFailure } from './route-client.generated.ts';
+import type { FallbackHint } from './contracts.generated.ts';
+/**
+ * The four-state base of every family card (W7 §2). Load states are read from the generated
+ * route-client's answer — a card owns no HTTP vocabulary and no second state machine.
+ */
+export type LoadState<T> = {
+    readonly phase: 'loading';
+} | {
+    readonly phase: 'ready';
+    readonly data: T;
+} | {
+    readonly phase: 'empty';
+} | {
+    readonly phase: 'failed';
+    readonly failure: RouteFailure;
+};
+/** Map one classified answer onto the card's four states. */
+export declare function loadStateOf<T>(answer: RouteAnswer<T>, isEmpty: (data: T) => boolean): LoadState<T>;
+/** The locale lookup every block calls (the platform's own `t`). */
+export interface Translate {
+    (key: string, values?: Readonly<Record<string, string | number>>): string;
+}
+export type BlockTone = 'neutral' | 'warn' | 'fail';
+export interface BlockProps {
+    readonly tone?: BlockTone;
+    readonly title?: string;
+    readonly children?: ReactNode;
+}
+/** A neutral/ warn/ fail block; a fail block is role=alert so assistive tech announces it. */
+export declare function Block(props: BlockProps): ReactNode;
+export interface FailureBlockProps {
+    readonly failure: RouteFailure;
+    readonly t: Translate;
+    /** The command-face fallback for this surface (rendered on unmounted/failed answers). */
+    readonly fallback?: FallbackHint | undefined;
+}
+/** One classified failure as a reader-facing sentence. */
+export declare function failureText(failure: RouteFailure, t: Translate): string;
+/** The failed-state block: sentence + (when the surface exists but is unreachable) the command fallback. */
+export declare function FailureBlock(props: FailureBlockProps): ReactNode;
+//# sourceMappingURL=states.generated.d.ts.map

package/lib/types/generated/states.generated.js

@@ -0,0 +1,31 @@
+// GENERATED by packages/scripts/gen-client-seam.mjs from packages/scripts/templates/client/states.ts.tmpl — do not edit.
+import { createElement } from 'react';
+/** Map one classified answer onto the card's four states. */
+export function loadStateOf(answer, isEmpty) {
+    if (!answer.ok)
+        return { phase: 'failed', failure: answer.failure };
+    return isEmpty(answer.data) ? { phase: 'empty' } : { phase: 'ready', data: answer.data };
+}
+/** A neutral/ warn/ fail block; a fail block is role=alert so assistive tech announces it. */
+export function Block(props) {
+    const tone = props.tone ?? 'neutral';
+    return createElement('div', { 'data-tone': tone, ...tone === 'fail' ? { role: 'alert' } : {} }, props.title === undefined ? null : createElement('div', { 'data-tone-title': tone }, props.title), props.children);
+}
+/** One classified failure as a reader-facing sentence. */
+export function failureText(failure, t) {
+    switch (failure.kind) {
+        case 'unauthenticated': return t('failureUnauthorized');
+        case 'forbidden': return t('failureForbidden');
+        case 'unmounted': return t('failureUnmounted');
+        case 'server': return failure.status === 0 ? t('failureServer') : t('failureServer') + ' (HTTP ' + String(failure.status) + ')';
+        case 'refused': return failure.message;
+    }
+}
+/** The failed-state block: sentence + (when the surface exists but is unreachable) the command fallback. */
+export function FailureBlock(props) {
+    const hint = props.fallback === undefined
+        ? null
+        : createElement('div', { 'data-tone-hint': 'true' }, props.t('fallbackHint', { command: props.fallback.command }));
+    return Block({ tone: 'fail', title: failureText(props.failure, props.t), children: hint });
+}
+//# sourceMappingURL=states.generated.js.map

package/lib/types/index.d.ts

@@ -0,0 +1,10 @@
+/** Shared browser seams and panel lifecycle for the evolution family. */
+export type { ClientSeam, ConfigFormLike, ConfigFormSnapshotLike, ConfigFormsSeat, LocaleSeat, PanelBodyOptions, PanelRowOptions, SettingsFace, SlotsSeat } from './seam.ts';
+export { registerSidebarPanel, type SidebarPanelSpec, type Translate } from './panel.ts';
+export { panelWorkspaceId } from './workspace.ts';
+export { ROUTES } from './generated/routes.generated.ts';
+export { FALLBACKS } from './generated/fallbacks.generated.ts';
+export * from './generated/contracts.generated.ts';
+export * from './generated/states.generated.ts';
+export { TOKEN_CSS, TOKENS, tokenVars } from './tokens.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.js

@@ -0,0 +1,8 @@
+export { registerSidebarPanel } from "./panel.js";
+export { panelWorkspaceId } from "./workspace.js";
+export { ROUTES } from "./generated/routes.generated.js";
+export { FALLBACKS } from "./generated/fallbacks.generated.js";
+export * from "./generated/contracts.generated.js";
+export * from "./generated/states.generated.js";
+export { TOKEN_CSS, TOKENS, tokenVars } from "./tokens.js";
+//# sourceMappingURL=index.js.map

package/lib/types/panel.d.ts

@@ -0,0 +1,44 @@
+/**
+ * One registration path for a sidebar panel: locale, stylesheet, row and body.
+ * @module @lmzhen/dsh-evolution-client-kit
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+import type { ReactNode } from 'react';
+/** Dictionary lookup used by the panel body and row label. */
+export type Translate = (key: string, values?: Readonly<Record<string, string | number>>) => string;
+/** The feature-specific part of one sidebar panel. */
+export interface SidebarPanelSpec<Face> {
+    /** The row id; the keyed main body uses the same value. */
+    id: string;
+    /** Row order in the global panel list. */
+    order: number;
+    /** Locale namespace owned by this panel. */
+    namespace: string;
+    dictionaries: {
+        zh: Record<string, string>;
+        en: Record<string, string>;
+    };
+    /** Fallback dictionary when the locale seat refuses or is absent. */
+    fallback?: 'zh' | 'en';
+    /** Panel stylesheet and the tag id that makes injection idempotent. */
+    styles: {
+        css: string;
+        tagId: string;
+    };
+    /** The row glyph. */
+    icon: (props: {
+        size?: number;
+        active?: boolean;
+    }) => ReactNode;
+    /** The body component; the seat spreads the face as its props. */
+    component: (props: never) => ReactNode;
+    /** The body face factory; receives the bound translator. */
+    body: (t: Translate) => Face;
+}
+/**
+ * Register one sidebar row and its main body under one lifecycle.
+ * @param ctx - the client context carrying the slots and locale seats.
+ * @param spec - the feature-specific row/body descriptor.
+ */
+export declare function registerSidebarPanel<Face>(ctx: ClientContext, spec: SidebarPanelSpec<Face>): void;
+//# sourceMappingURL=panel.d.ts.map

package/lib/types/panel.js

@@ -0,0 +1,56 @@
+function interpolate(text, values) {
+    if (values === undefined)
+        return text;
+    return text.replace(/\{(\w+)\}/g, (_match, key) => String(values[key] ?? ''));
+}
+function injectStyles(doc, css, tagId) {
+    if (doc === undefined)
+        return () => { };
+    if (doc.querySelector('style[data-plugin-css="' + tagId + '"]') !== null)
+        return () => { };
+    const tag = doc.createElement('style');
+    tag.setAttribute('data-plugin-css', tagId);
+    tag.textContent = css;
+    doc.head.append(tag);
+    return () => { tag.remove(); };
+}
+/**
+ * Register one sidebar row and its main body under one lifecycle.
+ * @param ctx - the client context carrying the slots and locale seats.
+ * @param spec - the feature-specific row/body descriptor.
+ */
+export function registerSidebarPanel(ctx, spec) {
+    const seam = ctx;
+    let registered = false;
+    ctx.effect(() => {
+        try {
+            const dispose = seam.locale.register(spec.namespace, spec.dictionaries);
+            registered = true;
+            return dispose;
+        }
+        catch (error) {
+            ctx.logger.warn(spec.namespace + ': the locale seat refused the dictionary (' + String(error) + '); the panel falls back to the bundle copy');
+            return () => { };
+        }
+    }, spec.namespace + ': locale');
+    ctx.effect(() => injectStyles(typeof document === 'undefined' ? undefined : document, spec.styles.css, spec.styles.tagId), spec.namespace + ': styles');
+    const fallback = spec.dictionaries[spec.fallback ?? 'zh'];
+    const lookup = (key) => {
+        const own = fallback[key] ?? key;
+        if (!registered)
+            return own;
+        try {
+            return seam.locale.bind(spec.namespace)(key);
+        }
+        catch {
+            return own;
+        }
+    };
+    const t = (key, values) => interpolate(lookup(key), values);
+    const label = () => lookup('entry.label');
+    seam.slots.inject('sidebar.panellist', function* () {
+        yield seam.slots.register({ name: 'sidebar.panellist', id: spec.id, order: spec.order, label }, spec.icon);
+        yield seam.slots.register({ name: 'main', key: spec.id, inject: () => spec.body(t) }, spec.component);
+    });
+}
+//# sourceMappingURL=panel.js.map

package/lib/types/seam.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The client seams shared by the family's sidebar panels.
+ *
+ * The browser bundle keeps platform specifiers external, so these seat shapes are the
+ * smallest contract the panels consume; keeping one copy prevents the three panels from
+ * drifting when the platform adds a field.
+ * @module @lmzhen/dsh-evolution-client-kit
+ */
+import type { ReactNode } from 'react';
+/** Registration options for the global sidebar row. */
+export interface PanelRowOptions {
+    name: 'sidebar.panellist';
+    id: string;
+    order: number;
+    /** The sidebar re-reads this on every projection, so a locale switch follows. */
+    label: () => string;
+}
+/** Registration options for the main-column body dispatched by the panel id. */
+export interface PanelBodyOptions {
+    name: 'main';
+    key: string;
+    /** The face handed to the component: data and callbacks only, never a service. */
+    inject: () => unknown;
+}
+/** The locale seat: one namespace registration and a bound translator. */
+export interface LocaleSeat {
+    register(namespace: string, dictionaries: {
+        zh: Record<string, string>;
+        en: Record<string, string>;
+    }): () => void;
+    bind(namespace: string): (key: string) => string;
+}
+/** The slot registry: an inject body may register and is disposed when it unmounts. */
+export interface SlotsSeat {
+    inject(name: string, body: () => Generator<() => void, void, void>): void;
+    register(options: PanelRowOptions | PanelBodyOptions, component: (props: never) => ReactNode): () => void;
+}
+/** Everything a sidebar panel asks the shell for. */
+export interface ClientSeam {
+    slots: SlotsSeat;
+    locale: LocaleSeat;
+}
+/** One client settings row's readable/writable face (platform configForms). */
+export interface ConfigFormSnapshotLike {
+    status: 'loading' | 'ready' | 'unavailable';
+    value: Record<string, unknown> | undefined;
+    writable: boolean;
+    revision?: number;
+}
+export interface ConfigFormLike {
+    getSnapshot(): ConfigFormSnapshotLike;
+    subscribe(listener: () => void): () => void;
+    set(field: string, value: unknown): Promise<boolean>;
+    unset(field: string): Promise<boolean>;
+}
+export interface ConfigFormsSeat {
+    get(entryId: string): ConfigFormLike;
+}
+export interface SettingsFace {
+    merge?: ConfigFormLike;
+    platform?: ConfigFormLike;
+}
+//# sourceMappingURL=seam.d.ts.map

package/lib/types/seam.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=seam.js.map

package/lib/types/tokens.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The family client scale - GENERATED from packages/scripts/client-tokens.json. Do not edit.
+ *
+ * The shared client kit carries this file, because the scale is one fact: `verify-client-tokens.mjs`
+ * (a gate step) fails when the kit copy drifts from the source. The kit bundles into each browser
+ * half at build time, so no runtime module-table row is needed.
+ *
+ * Usage: put `tokenVars(...)` for your root class in the package stylesheet, then read
+ * `var(--evo-group-name)` in its rules.
+ * Regenerate with: node packages/scripts/gen-client-tokens.mjs packages
+ * @module dsh-evolution-client-scale
+ */
+/** Every custom property of the scale, in the source order. */
+export declare const TOKENS: Readonly<Record<string, string>>;
+/** The declarations, without a selector. */
+export declare const TOKEN_CSS: string;
+/**
+ * The scale, declared on one element so it never leaks into the host shell.
+ * @param scope - the selector the custom properties are declared on.
+ * @returns the declaration block to put in the stylesheet.
+ */
+export declare function tokenVars(scope: string): string;
+//# sourceMappingURL=tokens.d.ts.map

package/lib/types/tokens.js

@@ -0,0 +1,55 @@
+/**
+ * The family client scale - GENERATED from packages/scripts/client-tokens.json. Do not edit.
+ *
+ * The shared client kit carries this file, because the scale is one fact: `verify-client-tokens.mjs`
+ * (a gate step) fails when the kit copy drifts from the source. The kit bundles into each browser
+ * half at build time, so no runtime module-table row is needed.
+ *
+ * Usage: put `tokenVars(...)` for your root class in the package stylesheet, then read
+ * `var(--evo-group-name)` in its rules.
+ * Regenerate with: node packages/scripts/gen-client-tokens.mjs packages
+ * @module dsh-evolution-client-scale
+ */
+/** Every custom property of the scale, in the source order. */
+export const TOKENS = {
+    '--evo-type-lg': 'calc(1em + 2px)',
+    '--evo-type-body': '1em',
+    '--evo-type-sm': 'calc(1em - 1px)',
+    '--evo-type-xs': 'calc(1em - 2px)',
+    '--evo-space-2': '2px',
+    '--evo-space-4': '4px',
+    '--evo-space-6': '6px',
+    '--evo-space-8': '8px',
+    '--evo-space-10': '10px',
+    '--evo-space-12': '12px',
+    '--evo-space-14': '14px',
+    '--evo-space-16': '16px',
+    '--evo-space-20': '20px',
+    '--evo-radius-chip': '4px',
+    '--evo-radius-control': '8px',
+    '--evo-radius-surface': '12px',
+    '--evo-radius-pill': '999px',
+    '--evo-hairline-width': '.5px',
+    '--evo-hairline-marker': '2px',
+    '--evo-measure-read': '80ch',
+    '--evo-leading-base': '1.5',
+    '--evo-tone-quiet': 'var(--dsw-alias-label-secondary)',
+    '--evo-tone-primary': 'var(--dsw-alias-brand-primary)',
+    '--evo-tone-danger': 'var(--dsw-alias-state-error-primary)',
+    '--evo-tone-success': 'var(--dsw-alias-state-success-primary)',
+    '--evo-focus-ring': '2px solid var(--dsw-alias-label-primary)',
+    '--evo-focus-offset': '-2px',
+    '--evo-cap-aside': '280px',
+    '--evo-cap-block': '260px',
+};
+/** The declarations, without a selector. */
+export const TOKEN_CSS = '--evo-type-lg:calc(1em + 2px);--evo-type-body:1em;--evo-type-sm:calc(1em - 1px);--evo-type-xs:calc(1em - 2px);--evo-space-2:2px;--evo-space-4:4px;--evo-space-6:6px;--evo-space-8:8px;--evo-space-10:10px;--evo-space-12:12px;--evo-space-14:14px;--evo-space-16:16px;--evo-space-20:20px;--evo-radius-chip:4px;--evo-radius-control:8px;--evo-radius-surface:12px;--evo-radius-pill:999px;--evo-hairline-width:.5px;--evo-hairline-marker:2px;--evo-measure-read:80ch;--evo-leading-base:1.5;--evo-tone-quiet:var(--dsw-alias-label-secondary);--evo-tone-primary:var(--dsw-alias-brand-primary);--evo-tone-danger:var(--dsw-alias-state-error-primary);--evo-tone-success:var(--dsw-alias-state-success-primary);--evo-focus-ring:2px solid var(--dsw-alias-label-primary);--evo-focus-offset:-2px;--evo-cap-aside:280px;--evo-cap-block:260px';
+/**
+ * The scale, declared on one element so it never leaks into the host shell.
+ * @param scope - the selector the custom properties are declared on.
+ * @returns the declaration block to put in the stylesheet.
+ */
+export function tokenVars(scope) {
+    return scope + '{' + TOKEN_CSS + '}';
+}
+//# sourceMappingURL=tokens.js.map

package/lib/types/workspace.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Read the panel workspace id from either workspace service shape.
+ * @module @lmzhen/dsh-evolution-client-kit
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+/**
+ * Best-effort workspace id; a seat that is absent or refuses leaves the panel in local scope.
+ * @param ctx - the client context.
+ * @returns the current workspace id, or undefined.
+ */
+export declare function panelWorkspaceId(ctx: ClientContext): string | undefined;
+//# sourceMappingURL=workspace.d.ts.map

package/lib/types/workspace.js

@@ -0,0 +1,21 @@
+/**
+ * Best-effort workspace id; a seat that is absent or refuses leaves the panel in local scope.
+ * @param ctx - the client context.
+ * @returns the current workspace id, or undefined.
+ */
+export function panelWorkspaceId(ctx) {
+    const get = ctx.get;
+    if (typeof get !== 'function')
+        return undefined;
+    for (const name of ['workspace', 'uiWorkspace']) {
+        try {
+            const seat = get.call(ctx, name);
+            const id = seat?.workspaceId ?? seat?.currentWorkspaceId;
+            if (typeof id === 'string' && id.trim() !== '')
+                return id;
+        }
+        catch { /* optional service: absence is the local scope */ }
+    }
+    return undefined;
+}
+//# sourceMappingURL=workspace.js.map

package/package.json

@@ -1,17 +1,66 @@
 {
   "name": "@lmzhen/dsh-evolution-client-kit",
-  "version": "0.0.0",
-  "description": "placeholder for npm trusted publishing; replaced by CI 0.30.26",
+  "description": "Shared browser seams and lifecycle for the evolution family sidebar panels (community build)",
+  "version": "0.30.28",
   "private": false,
-  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/lmzhen/dsh-evolution.git"
+    "url": "git+https://github.com/lmzhen/dsh-evolution.git",
+    "directory": "packages/evolution-client-kit"
   },
-  "publishConfig": {
-    "access": "public"
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./generated/contracts": {
+      "types": "./lib/types/generated/contracts.generated.d.ts",
+      "default": "./lib/generated/contracts.generated.js"
+    },
+    "./generated/fallbacks": {
+      "types": "./lib/types/generated/fallbacks.generated.d.ts",
+      "default": "./lib/generated/fallbacks.generated.js"
+    },
+    "./generated/route-client": {
+      "types": "./lib/types/generated/route-client.generated.d.ts",
+      "default": "./lib/generated/route-client.generated.js"
+    },
+    "./generated/routes": {
+      "types": "./lib/types/generated/routes.generated.d.ts",
+      "default": "./lib/generated/routes.generated.js"
+    },
+    "./generated/states": {
+      "types": "./lib/types/generated/states.generated.d.ts",
+      "default": "./lib/generated/states.generated.js"
+    },
+    "./tokens": {
+      "types": "./lib/types/tokens.d.ts",
+      "default": "./lib/tokens.js"
+    },
+    "./package.json": "./package.json"
   },
   "files": [
-    "README.md"
-  ]
+    "lib/**/*.js",
+    "lib/types/**/*.d.ts",
+    "package.json"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.5",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.5",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0"
+  },
+  "engines": {
+    "dsh": ">=0.2.1-rc.2 <0.2.2-0"
+  }
 }