@changfenhuang/dsh-genui 0.9.8 → 0.9.9

package/lib/types/client/blocks/advanced.d.ts

@@ -101,4 +101,4 @@ export declare const BreadcrumbNode: import("react").NamedExoticComponent<{
  * names stay independent. The model round-trip takes seconds, so a few
  * hundred ms of trailing delay is imperceptible — and it stops bursts of
  * queued user turns.
- */ 
+ */

package/lib/types/client/blocks/checkbox.d.ts

@@ -0,0 +1,17 @@
+import type { GenuiCheckbox } from '../spec.ts';
+import type { AnswersState, GenuiBlockProps } from './state.ts';
+/**
+ * Checkbox with two backwards-compatible modes:
+ *
+ * - no `group`: legacy local toggle + optional per-click action;
+ * - with `group`: local-only multi-select state collected by a sibling submit.
+ *
+ * A persisted group key wins over `checked`, including an explicit empty
+ * array. This lets a user clear every default-checked option without those
+ * defaults reappearing after refresh.
+ */
+export declare function CheckboxNode({ node, onAction, answers }: {
+    node: GenuiCheckbox;
+    onAction?: GenuiBlockProps['onAction'];
+    answers?: AnswersState | undefined;
+}): import("react").JSX.Element;

package/lib/types/client/blocks/forms.d.ts

@@ -7,14 +7,9 @@ export declare function RadioNode({ node, onAction, answers }: {
 }): import("react").JSX.Element;
 /** Resolve a question's correct label from its metadata. */
 export declare function correctLabelOf(m: QuestionMeta): string | undefined;
-/** Submit: the "交卷" control of a grouped-radio block. LOCAL-FIRST (v2.6):
- * when at least one question carries `answer` data the click grades IN PLACE
- * — score, per-question right/wrong, explanations — with zero model round
- * trip, and locks the questions until 重新作答 resets them. Only when NO
- * question has answers does it fall back to firing ONE action
- * (`{type:'submit', answers, total, answered}`). Disabled until the
- * selection criteria are met (all listed groups answered, or ≥1 answer
- * without a group list); the hint shows the progress. */
+/** Submit: collect grouped radio and checkbox answers. Radio-only scopes keep
+ * LOCAL-FIRST grading; when checkbox selections participate, the click falls
+ * back to the aggregation action so multi-select data is never discarded. */
 export declare function SubmitNode({ node, onAction, answers }: {
     node: GenuiSubmit;
     onAction?: GenuiBlockProps['onAction'];

package/lib/types/client/blocks/state.d.ts

@@ -1,8 +1,8 @@
 /**
  * Shared block-level state types: the block props contract and the answers
- * registry (grouped radios → submit grading). Lives OUTSIDE GenuiBlock.tsx so
- * the per-family block modules can import the types without a cycle back
- * into the block shell.
+ * registry (grouped radios / checkboxes → submit aggregation). Lives OUTSIDE
+ * GenuiBlock.tsx so the per-family block modules can import the types without
+ * a cycle back into the block shell.
  * @module @changfenhuang/dsh-genui/client/blocks/state
  */
 import type { GenuiSpec } from '../spec.ts';
@@ -17,10 +17,11 @@ export interface GenuiBlockProps {
     onAction?: ((action: string, payload: Record<string, unknown>) => void) | undefined;
     /**
      * v2.7: durable-state key (session + slot + content fingerprint). When set,
-     * interaction state (radio answers, submit lock, field values) persists to
-     * localStorage and restores on refresh / re-render of the same content.
-     * Changing this key also starts a fresh in-memory interaction-state lifetime;
-     * callers only provide stateKey — GenuiBlock owns the matching React identity.
+     * interaction state (radio answers, checkbox groups, submit lock, field
+     * values) persists to localStorage and restores on refresh / re-render of
+     * the same content. Changing this key also starts a fresh in-memory
+     * interaction-state lifetime; callers only provide stateKey — GenuiBlock
+     * owns the matching React identity.
      */
     stateKey?: string | undefined;
 }
@@ -33,15 +34,17 @@ export interface QuestionMeta {
     /** Shown after local grading. */
     explanation?: string | undefined;
 }
-/** Block-wide answers registry (v2.5/v2.6): grouped radios record selections
- * and register their question metadata here; a sibling `submit` node either
- * grades IN PLACE (questions carry `answer` data) or collects everything
- * into ONE action. Lives in GenuiBlock state so re-renders keep the
- * selections, threaded down through the recursive render walk. Answers are
- * plain group → chosen-option-label strings (the display label lives in
- * QuestionMeta; localStorage stores the same string table — no migration). */
+/** Block-wide aggregation state. Grouped radios store one selected label in
+ * `answers`; grouped checkboxes store a selected-label array in
+ * `multiAnswers`. Keeping the registries separate preserves the existing
+ * radio/local-grading string contract while allowing submit to expose one
+ * unified `answers` payload (`string | string[]`). */
 export interface AnswersState {
     answers: Record<string, string>;
+    /** Grouped checkbox selections. An empty array is meaningful: the user
+     * explicitly cleared the group, so model-provided `checked` defaults must
+     * not reappear after a durable restore. */
+    multiAnswers: Record<string, string[]>;
     /** Field values by id (input/textarea with an `id`), collected by submit. */
     fields: Record<string, string>;
     /** Field ids whose value must never be persisted or collected (secrets). */
@@ -52,6 +55,7 @@ export interface AnswersState {
     /** Bumped by every reset; radios use it as their remount key. */
     round: number;
     setAnswer: (group: string, choice: string) => void;
+    setMultiAnswer: (group: string, choice: string, checked: boolean) => void;
     setField: (id: string, value: string) => void;
     registerSecretField: (id: string) => void;
     registerMeta: (group: string, meta: QuestionMeta) => void;

package/lib/types/client/dom-fence.d.ts

@@ -1,6 +1,6 @@
 import { type Root } from 'react-dom/client';
 import type { Context } from '@deepseek-ai/cordis';
-import type { SessionId } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
 /** Override the React root factory (tests / tuning). */
 export declare function setDomRootFactory(factory: (container: HTMLElement) => Root): void;
 /**

package/lib/types/client/genui-runtime/diagnostics.d.ts

@@ -0,0 +1,18 @@
+export interface GenuiDiagnostic {
+    readonly kind: 'alias' | 'unknown-field';
+    readonly path: string;
+    readonly message: string;
+    readonly type?: string;
+    readonly field?: string;
+    readonly canonical?: string;
+}
+/**
+ * Diagnose unknown direct fields on native nodes.
+ *
+ * Unknown types are intentionally skipped so custom renderers retain their
+ * opaque extension payloads. Native unknown fields are warnings, not errors.
+ *
+ * @param value - Canonical or raw GenUI value.
+ * @returns Stable field diagnostics in tree order.
+ */
+export declare function diagnoseUnknownGenuiFields(value: unknown): GenuiDiagnostic[];

package/lib/types/client/genui-runtime/index.d.ts

@@ -0,0 +1 @@
+export { GENUI_LIMITS } from './limits.ts';

package/lib/types/client/genui-runtime/limits.d.ts

@@ -0,0 +1,54 @@
+/** Resource limits shared by GenUI repair, validation, and rendering. */
+export declare const GENUI_LIMITS: {
+    /** Maximum nesting depth of the component tree. */
+    readonly maxDepth: 8;
+    /** Maximum total nodes across the whole spec. */
+    readonly maxNodes: 200;
+    /** Maximum length of any plain string field. */
+    readonly maxString: 2000;
+    /** Maximum length of a `code` body. */
+    readonly maxCode: 12000;
+    /** Maximum length of a mermaid source. */
+    readonly maxMermaid: 8000;
+    /** Maximum `grid` columns. */
+    readonly maxGridCols: 12;
+    /** Maximum `tabs` count. */
+    readonly maxTabs: 12;
+    /** Maximum `accordion` items. */
+    readonly maxAccordionItems: 24;
+    /** Maximum `list` items. */
+    readonly maxListItems: 50;
+    /** Maximum `select`/`radio` options. */
+    readonly maxOptions: 50;
+    /** Maximum `table` rows / columns. */
+    readonly maxTableRows: 50;
+    readonly maxTableCols: 12;
+    /** Maximum `chart` data points per series. */
+    readonly maxChartPoints: 60;
+    /** Maximum `plot` series and per-series parameters. */
+    readonly maxPlotSeries: 8;
+    readonly maxPlotParams: 6;
+    /** Maximum `scene3d` meshes. */
+    readonly maxMeshes: 5;
+    /** Maximum `quiz` options. */
+    readonly maxQuizOptions: 8;
+    /** Maximum `steps` / `timeline` / `breadcrumb` / `keyvalue` entries. */
+    readonly maxSteps: 24;
+    readonly maxTimelineItems: 24;
+    readonly maxBreadcrumbItems: 12;
+    readonly maxKeyValuePairs: 24;
+    /** Maximum `file-tree` nesting. */
+    readonly maxTreeDepth: 6;
+    /** Maximum `diagram` nodes / edges / zones / focal accents. */
+    readonly maxDiagramNodes: 9;
+    readonly maxDiagramEdges: 12;
+    readonly maxDiagramZones: 3;
+    readonly maxDiagramFocal: 2;
+    readonly maxDiagramLabel: 14;
+    /** Maximum depth of an `echart` option object. */
+    readonly maxEChartOptionDepth: 10;
+    /** Maximum length of any single array inside an `echart` option. */
+    readonly maxEChartArrayLen: 500;
+    /** Maximum entries traversed while sanitizing an `echart` option. */
+    readonly maxEChartOptionNodes: 2000;
+};

package/lib/types/client/genui-runtime/normalize.d.ts

@@ -0,0 +1,15 @@
+import type { GenuiDiagnostic } from './diagnostics.ts';
+/**
+ * Normalize a raw GenUI value into canonical field names.
+ *
+ * Only deterministic aliases and structural aliases are changed. Resource
+ * limits, type repair, security filtering, and semantic validation remain in
+ * the guard layer. Unknown component types are returned opaque.
+ *
+ * @param value - Raw GenUI spec or bare native component.
+ * @returns Canonical value and stable alias diagnostics.
+ */
+export declare function normalizeGenuiSpec(value: unknown): {
+    value: unknown;
+    warnings: GenuiDiagnostic[];
+};

package/lib/types/client/genui-runtime/schema.d.ts

@@ -0,0 +1,73 @@
+/** Runtime metadata shared by GenUI normalization and diagnostics. */
+export type ComponentFieldKind = 'string' | 'string-or-null' | 'number' | 'boolean' | 'nodes' | 'array' | 'object' | 'unknown';
+/** A conditional rule for fields whose presence depends on another field. */
+export interface ComponentConditionalRule {
+    readonly kind: 'required-if';
+    readonly when: {
+        readonly field: string;
+        readonly equals: unknown;
+    };
+    readonly required: readonly string[];
+    readonly message?: string;
+}
+/** A field rule that requires at least one member of a field group. */
+export interface ComponentOneOfRule {
+    readonly kind: 'one-of-required';
+    readonly fields: readonly string[];
+    readonly message?: string;
+}
+/** Runtime metadata naming a component-specific semantic validator. */
+export interface ComponentValidatorMetadata {
+    readonly name: string;
+    readonly [key: string]: unknown;
+}
+/** Runtime schema for an object nested inside a native component field. */
+export interface ComponentRecordSchema {
+    readonly required: readonly string[];
+    readonly fields: Readonly<Record<string, ComponentFieldKind>>;
+    readonly enums: Readonly<Record<string, readonly string[]>>;
+    readonly nested: Readonly<Record<string, ComponentRecordSchema>>;
+}
+export interface ComponentSchema {
+    readonly required: readonly string[];
+    readonly fields: Readonly<Record<string, ComponentFieldKind>>;
+    readonly enums: Readonly<Record<string, readonly string[]>>;
+    /** Explicit optional field kinds; `fields` remains the complete field map. */
+    readonly optional: Readonly<Record<string, ComponentFieldKind>>;
+    readonly aliases: Readonly<Record<string, string>>;
+    readonly oneOfRequired: readonly (readonly string[])[];
+    readonly conditionalRequired: readonly ComponentConditionalRule[];
+    readonly rules: readonly (ComponentOneOfRule | ComponentConditionalRule)[];
+    readonly nested: Readonly<Record<string, ComponentRecordSchema>>;
+    readonly validator?: ComponentValidatorMetadata;
+}
+/** Canonical enum domains shared by schema validation and repair. */
+export declare const TEXT_SIZES: readonly ["h1", "h2", "h3", "body", "muted", "caption"];
+export declare const BUTTON_TONES: readonly ["primary", "danger", "success", "ghost"];
+export declare const BADGE_TONES: readonly ["success", "warn", "danger", "accent"];
+export declare const INPUT_TYPES: readonly ["text", "email", "password", "color"];
+export declare const CALLOUT_TONES: readonly ["info", "success", "warning", "error"];
+export declare const CHART_KINDS: readonly ["bars", "line", "donut"];
+export declare const PLOT_KINDS: readonly ["line", "area", "scatter"];
+export declare const MEDIA_ASPECT_RATIOS: readonly ["16:9", "4:3", "1:1", "9:16"];
+export declare const MESH_SHAPES: readonly ["box", "sphere", "cone", "cylinder", "torus"];
+export declare const FILE_TYPES: readonly ["file", "dir"];
+export declare const DIAGRAM_KINDS: readonly ["architecture", "it-state", "flowchart", "sequence", "state", "er", "timeline", "swimlane", "quadrant", "radar", "loop", "nested", "tree", "org-chart", "layers", "venn", "pyramid", "bar", "line", "gantt", "scatter", "high-level", "process", "medallion", "data-flow", "dp-integration", "dp-security-matrix"];
+export declare const DIAGRAM_NODE_TYPES: readonly ["focal", "backend", "store", "external", "input", "optional", "security"];
+export declare const DIAGRAM_VARIANTS: readonly ["light", "dark", "editorial"];
+export declare const DIAGRAM_EDGE_KINDS: readonly ["solid", "dashed", "accent", "link"];
+export declare const DIAGRAM_ROUTES: readonly ["auto", "orthogonal", "straight"];
+export declare const ECHART_PRESETS: readonly ["bar", "line", "area", "pie", "scatter"];
+/** Root GenUI specification metadata used by diagnostics. */
+export declare const GENUI_SPEC_SCHEMA: ComponentSchema;
+/** Backwards-friendly short alias for the root specification schema. */
+export declare const SPEC_SCHEMA: ComponentSchema;
+/**
+ * Native component field metadata.
+ *
+ * This is intentionally explicit rather than inferred from TypeScript
+ * interfaces: the registry is also consumed at runtime by normalization and
+ * diagnostics, where erased interfaces are unavailable.
+ */
+export declare const COMPONENT_SCHEMAS: Readonly<Record<string, ComponentSchema>>;
+export declare const GENUI_NATIVE_TYPES: ReadonlySet<string>;

package/lib/types/client/genui-runtime/value-utils.d.ts

@@ -0,0 +1,18 @@
+/** Shared primitive sanitizers used by the GenUI guard. */
+/** String field: truncate a string to `cap`, or undefined when not a string. */
+export declare function str(value: unknown, cap: number): string | undefined;
+export declare function color(value: unknown): string | undefined;
+/** Keep only http(s) and mailto link targets. */
+export declare function safeHref(value: unknown): string | undefined;
+/** Keep browser-reachable http(s) or same-origin relative media paths. */
+export declare function safeMediaSrc(value: unknown): string | undefined;
+/** Finite-number field: clamp into [min, max], or undefined when not finite. */
+export declare function num(value: unknown, min: number, max: number): number | undefined;
+/** Integer field: clamp into [min, max], or undefined when not a finite number. */
+export declare function int(value: unknown, min: number, max: number): number | undefined;
+/** Optional enum field: the value when it matches, otherwise undefined. */
+export declare function enu<T extends string>(value: unknown, values: readonly T[]): T | undefined;
+/** Plain object (not array, not null). */
+export declare function obj(value: unknown): Record<string, unknown> | undefined;
+/** Preserve an optional field only when its value exists. */
+export declare function opt<K extends string, V>(key: K, value: V | undefined): Partial<Record<K, V>>;

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

@@ -19,66 +19,7 @@
  *   are elided.
  */
 import type { GenuiSpec } from './spec.ts';
-/** Hard resource limits enforced by repair (and mirrored at render time). */
-export declare const GENUI_LIMITS: {
-    /** Maximum nesting depth of the component tree. */
-    readonly maxDepth: 8;
-    /** Maximum total nodes across the whole spec. */
-    readonly maxNodes: 200;
-    /** Maximum length of any plain string field. */
-    readonly maxString: 2000;
-    /** Maximum length of a `code` body. */
-    readonly maxCode: 12000;
-    /** Maximum length of a mermaid source. */
-    readonly maxMermaid: 8000;
-    /** Maximum `grid` columns. */
-    readonly maxGridCols: 12;
-    /** Maximum `tabs` count. */
-    readonly maxTabs: 12;
-    /** Maximum `accordion` items. */
-    readonly maxAccordionItems: 24;
-    /** Maximum `list` items. */
-    readonly maxListItems: 50;
-    /** Maximum `select`/`radio` options. */
-    readonly maxOptions: 50;
-    /** Maximum `table` rows / columns. */
-    readonly maxTableRows: 50;
-    readonly maxTableCols: 12;
-    /** Maximum `chart` data points per series. */
-    readonly maxChartPoints: 60;
-    /** Maximum `plot` series and per-series parameters. */
-    readonly maxPlotSeries: 8;
-    readonly maxPlotParams: 6;
-    /** Maximum `scene3d` meshes. */
-    readonly maxMeshes: 5;
-    /** Maximum `quiz` options. */
-    readonly maxQuizOptions: 8;
-    /** Maximum `steps` / `timeline` / `breadcrumb` / `keyvalue` entries. */
-    readonly maxSteps: 24;
-    readonly maxTimelineItems: 24;
-    readonly maxBreadcrumbItems: 12;
-    readonly maxKeyValuePairs: 24;
-    /** Maximum `file-tree` nesting. */
-    readonly maxTreeDepth: 6;
-    /** Maximum `diagram` nodes / edges / zones / focal accents (editorial
-     * complexity budget, mirroring diagram-design's §7 limits). */
-    readonly maxDiagramNodes: 9;
-    readonly maxDiagramEdges: 12;
-    readonly maxDiagramZones: 3;
-    readonly maxDiagramFocal: 2;
-    readonly maxDiagramLabel: 14;
-    /** Maximum depth of an `echart` option object (prevents pathological nested
-     * ECharts configs from stalling the guard walk). */
-    readonly maxEChartOptionDepth: 10;
-    /** Maximum length of any single array inside an `echart` option (prevents
-     * a model from stalling rendering with `series.data` of hundreds of
-     * thousands of points). */
-    readonly maxEChartArrayLen: 500;
-    /** Maximum total entries (object keys + array elements) traversed while
-     * sanitizing an `echart` option. Bounds the walk so a pathologically
-     * large option object cannot stall the guard. */
-    readonly maxEChartOptionNodes: 2000;
-};
+import type { GenuiDiagnostic } from './genui-runtime/diagnostics.ts';
 /** Result of `validateGenuiSpec`. */
 export interface GenuiValidation {
     ok: boolean;
@@ -86,12 +27,14 @@ export interface GenuiValidation {
     errors: string[];
 }
 /**
- * Deterministically repair a raw spec value into a renderable GenuiSpec.
- * Returns null only when the root is not an object with an `items` array
- * (a bare component root is wrapped into a col first — the documented fence
- * vocabulary allows single-component bodies); every other defect is healed by
- * dropping/clamping/truncating. Idempotent: repairing a repaired spec is a
- * no-op.
+ * Deterministically repair a raw spec into a renderable GenuiSpec.
+ *
+ * Alias normalization is performed before the existing resource, type, and
+ * security repair rules. The result remains idempotent and keeps the legacy
+ * public API used by the fence renderer and client components.
+ *
+ * @param value - Raw GenUI spec or bare component.
+ * @returns Repaired canonical spec, or null for an invalid root.
  */
 export declare function repairGenuiSpec(value: unknown): GenuiSpec | null;
 /**
@@ -115,6 +58,8 @@ export declare const GENUI_NODE_TYPES: ReadonlySet<string>;
  * @returns declared node count up to the ceiling.
  */
 export declare function countDeclaredGenuiNodes(value: unknown, cap?: number): number;
+/** Count native nodes that survived repair, excluding opaque custom nodes. */
+export declare function countRenderedNativeGenuiNodes(value: unknown, cap?: number): number;
 /**
  * Return field-level chart errors without changing other repairable component families.
  * @param value - raw GenUI spec.
@@ -122,10 +67,54 @@ export declare function countDeclaredGenuiNodes(value: unknown, cap?: number): n
  */
 export declare function validateGenuiChartSemantics(value: unknown): string[];
 /**
- * Validate a raw spec value against the white list and limits, collecting
- * human-readable problems. Unlike repair this never mutates: it is a
- * diagnostic for tests and tooling. Unknown `type`s are reported (a plugin
- * custom type is valid only when a renderer is registered — the guard cannot
- * know, so it flags them as warnings).
+ * Validate a raw GenUI value after deterministic alias normalization.
+ *
+ * Validation therefore only sees canonical fields; repairable aliases do not
+ * produce false required-field errors. Structural and semantic defects remain
+ * errors, while native unknown fields are exposed by the warning diagnostics
+ * returned from `processGenuiSpec`.
+ *
+ * @param value - Raw GenUI spec or bare component.
+ * @returns Validation result with human-readable errors.
  */
 export declare function validateGenuiSpec(value: unknown): GenuiValidation;
+export interface GenuiProcessResult {
+    /** Canonical alias-normalized input value. */
+    value: unknown;
+    /** Alias-normalized value, provided as an explicit descriptive alias. */
+    normalized: unknown;
+    /** Canonical repaired value consumed by the renderer. */
+    repaired: GenuiSpec | null;
+    /** Renderer-facing alias for `repaired`. */
+    spec: GenuiSpec | null;
+    /** Structural and semantic validation errors. */
+    errors: string[];
+    /** Alias and native unknown-field warnings. */
+    warnings: GenuiDiagnostic[];
+    /** Native nodes declared in the canonical input, before repair drops. */
+    declaredCount: number;
+    /** Nodes present in the repaired tree. */
+    renderedCount: number;
+    /** Native nodes declared before repair, excluding custom payloads. */
+    declaredNativeCount: number;
+    /** Native nodes present after repair, excluding custom and file-tree data. */
+    renderedNativeCount: number;
+    /** All rendered component nodes, including opaque custom nodes. */
+    renderedTotalCount: number;
+}
+/**
+ * Run the shared canonical GenUI pipeline.
+ *
+ * The pipeline normalizes aliases, applies the existing deterministic repair
+ * and security filters, validates the canonical input, and reports native
+ * declarations that disappeared during repair. Custom nodes stay opaque and
+ * do not participate in native unknown-field diagnostics.
+ *
+ * @param value - Raw GenUI spec or bare component.
+ * @returns Canonical input, repaired output, diagnostics, and node counts.
+ */
+export declare function processGenuiSpec(value: unknown): GenuiProcessResult;
+/** Return whether the only process errors describe an intentional budget tail cut. */
+export declare function isIntentionalBudgetCut(processed: GenuiProcessResult): boolean;
+/** Decide whether a repaired spec is safe to expose to any GenUI renderer. */
+export declare function isRenderableProcess(processed: GenuiProcessResult): boolean;

package/lib/types/client/interaction-store.d.ts

@@ -1,6 +1,7 @@
 /**
  * Interaction-state store: durable per-block GenUI interaction state
- * (radio answers, submit lock, input/textarea values) in localStorage.
+ * (radio answers, checkbox groups, submit lock, input/textarea values) in
+ * localStorage.
  *
  * LOCAL-FIRST persistence: a ```dsh-ui block's interactive state survives
  * page refresh and session reopen because it is keyed by
@@ -10,13 +11,17 @@
  * share state because their content fingerprints differ.
  *
  * Bounded: at most MAX_BLOCKS entries, LRU-evicted on write; each block's
- * payload is small (answers map + a few field values).
+ * payload is small (answer maps + a few field values).
  * @module @changfenhuang/dsh-genui/client/interaction-store
  */
 /** Durable state of one UI block. */
 export interface BlockInteractionState {
     /** group → chosen option label (radio aggregation answers). */
     answers?: Record<string, string>;
+    /** group → chosen option labels (checkbox aggregation answers). Empty arrays
+     * are retained so an explicitly cleared group wins over `checked` defaults
+     * after refresh. */
+    multiAnswers?: Record<string, string[]>;
     /** True after a local grading: the paper stays graded across refresh. */
     locked?: boolean;
     /** field id → current value (input/textarea with an `id`). */

package/lib/types/client/panel-command.d.ts

@@ -15,7 +15,7 @@
  * re-run render_ui) or through another /panel.
  */
 import type { InputTriggerSource } from '@deepseek-ai/dsh-client-ui-input-trigger/client';
-import type { SessionId } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { GenuiSpec } from './spec.ts';
 /** Default panel content published by `/panel`: the component overview. */
 export declare const DEFAULT_PANEL_SPEC: GenuiSpec;

package/lib/types/client/primitive-labels.d.ts

@@ -0,0 +1,11 @@
+/** Localized labels required by the rc.1 DSH UI primitives. */
+import type { DiffBlockLabels, JsonTreeLabels } from '@deepseek-ai/dsh-client-ui-primitives';
+/** Chrome labels for an inline GenUI diff block. */
+export declare const DIFF_BLOCK_LABELS: DiffBlockLabels;
+/** Copy labels for a code block rendered inside a GenUI fence or node. */
+export declare const CODE_BLOCK_LABELS: {
+    readonly copyLabel: "复制";
+    readonly copiedLabel: "复制成功";
+};
+/** Chrome labels for an inline GenUI JSON tree. */
+export declare const JSON_TREE_LABELS: JsonTreeLabels;

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

@@ -51,7 +51,7 @@ export interface GenuiInput {
     label?: string;
     placeholder?: string;
     value?: string;
-    inputType?: 'text' | 'email' | 'password';
+    inputType?: 'text' | 'email' | 'password' | 'color';
     /** v2: when set, interaction sends this action back to the model. */
     action?: string;
     /**
@@ -84,6 +84,12 @@ export interface GenuiCheckbox {
     checked?: boolean;
     /** v2: when set, interaction sends this action back to the model. */
     action?: string;
+    /**
+     * Aggregation group name. When set, toggles stay local and update the
+     * block-wide multi-answer registry instead of firing the per-click action;
+     * a sibling `submit` collects the selected labels as a string array.
+     */
+    group?: string;
 }
 export interface GenuiLink {
     type: 'link';
@@ -314,23 +320,17 @@ export interface GenuiRadio {
     /** v2.6: per-question explanation shown after local grading. */
     explanation?: string;
 }
-/** Submit node: collects the answers of sibling `radio` groups in this block.
- * LOCAL-FIRST: when the questions carry `answer` data the click grades IN
- * PLACE — score, per-question right/wrong, explanations — with no model
- * round trip, and locks the questions until "重新作答" resets them. Only when
- * NO question carries answers does it fall back to firing ONE action
- * (`{type:'submit', answers, total, answered}`). */
+/** Submit node: collects sibling `radio` and grouped `checkbox` answers in
+ * this block. LOCAL-FIRST grading still applies to radio-only question scopes;
+ * aggregation scopes can emit strings for radio groups and string arrays for
+ * checkbox groups in the same `answers` object. */
 export interface GenuiSubmit {
     type: 'submit';
     label: string;
     /**
-     * Optional action name. Local-first: when ANY question in scope carries
-     * `answer` data the click grades IN PLACE with zero model round trip, so
-     * no action is needed — the spec stays valid without one. Only when NO
-     * question has local answers does the submit need an action to collect
-     * `{type:'submit', answers, total, answered}`; without one the button
-     * renders disabled (honest affordance). Also fired as the reset hook if
-     * `resetAction` is absent.
+     * Optional action name. Local-first: when the in-scope questions can be
+     * graded entirely locally, no action is needed. Aggregation submits require
+     * an action and emit `{type:'submit', answers, total, answered}`.
      */
     action?: string;
     /**
@@ -341,9 +341,9 @@ export interface GenuiSubmit {
     resetAction?: string;
     /**
      * Optional explicit group list to wait for; when absent the submit enables
-     * once at least one grouped radio has an answer. When present it stays
-     * disabled until EVERY listed group has a recorded answer (the hint shows
-     * the progress).
+     * once at least one grouped answer (or filled field) exists. When present
+     * it stays disabled until EVERY listed radio/checkbox group has a non-empty
+     * recorded answer (the hint shows the progress).
      */
     groups?: string[];
 }

package/lib/types/plugin/chart-contract.d.ts

@@ -1,7 +1,9 @@
 /**
- * Validate the native chart contract all the way to something the renderer
- * can actually draw. The shared guard still owns field/type validation; this
- * layer adds renderer-specific invariants that would otherwise produce an
- * empty line/donut chart or a grouped-bars shell with no points.
+ * Validate chart nodes using the guard's shared native renderability contract.
+ * The plugin-facing API remains stable while the guard remains the single
+ * owner of chart field and renderer-semantic rules.
+ *
+ * @param value - Raw GenUI spec or bare chart node.
+ * @returns Chart errors in deterministic tree order.
  */
 export declare function validateRenderableChartSemantics(value: unknown): string[];

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

@@ -5,13 +5,10 @@
  * model the language exists, so a session without the plugin simply never
  * emits fences and nothing changes.
  *
- * The section is a convention section (order 100-199), placed after the bash
- * guidance so the model sees it among its output-format rules.
+ * The section uses the host's centrally allocated structured-output placement.
  * @module @changfenhuang/dsh-genui
  */
 import { Context } from '@deepseek-ai/cordis';
-/** Convention: tool guidance uses 100–199; bash's section is 104. */
-export declare const GENUI_SECTION_ORDER = 105;
 /** The fence language description injected into every assembled system prompt.
  *  Deliberately slim: the `genui` skill carries the full component→field
  *  mapping; this section keeps only the contract that must always be