@case-framework/survey-editor-ui 0.6.0 → 0.7.0

package/README.md

@@ -12,6 +12,11 @@ For repository development and custom item registration, see
 Save or Back. The host owns persistence, routing, and its header; the editor
 owns survey mutations and undo/redo history.
 
+The main editor export includes the assistant launcher UI. Host applications
+must provide versions of `ai` and `@ai-sdk/react` compatible with the peer
+ranges in `package.json`. The assistant's Mastra peers remain optional because
+they are only needed by server integrations.
+
 Use `controllerRef` for host-triggered commands and `onHostStateChange` to keep
 host controls in sync with the editor:
 
@@ -163,3 +168,83 @@ system.
   shared UI stylesheet and theme configuration belong to the consuming
   workspace rather than being independently repeated by every component
   package.
+
+## Standalone rich text editing
+
+`RichTextEditor` and `RichTextBlockEditor` work without `SurveyEditor` or a survey
+configuration provider. They automatically supply default English translations,
+tooltips, and confirmation dialogs. Wrap one or more editors in the exported
+`RichTextEditorProvider` to configure their UI language or translation overrides:
+
+```tsx
+import {
+  RichTextBlockEditor,
+  RichTextEditorProvider,
+  type RichTextEditorProps,
+} from "@case-framework/survey-editor-ui";
+import { useState } from "react";
+
+function NoticeEditor() {
+  const [value, setValue] = useState<RichTextEditorProps["value"]>();
+  return (
+    <div className="survey-editor">
+      <RichTextEditorProvider language="nl">
+        <RichTextBlockEditor
+          aria-label="Notice content"
+          value={value}
+          onChange={(change) => setValue(change.value)}
+          toolbarMode="docked"
+          dockedToolbarVisibility="always"
+          styleControls={[
+            { kind: "weight", value: "strong" },
+            { kind: "italic", value: "italic" },
+            { kind: "underline", value: "underline" },
+          ]}
+          contentPolicy={{
+            allowLinks: false,
+            allowTemplateVariables: false,
+            allowedBlockTypes: { image: false, separator: false, infoBox: false },
+          }}
+        />
+      </RichTextEditorProvider>
+    </div>
+  );
+}
+```
+
+Use this in a client component in Next.js. Apply the host styling setup above;
+the provider does not import CSS or install an application toaster.
+
+`language` selects bundled English/Dutch UI messages, with English fallback.
+`localizations` merges overrides using the existing editor message keys (for
+example `defaultEditors.imagePopover`). An optional `translate(key, values)`
+callback takes precedence when the host owns translation. Toolbar, block-menu, and link-editor labels use the `richTextEditor` message namespace.
+Within a survey, rich text automatically inherits the survey's translator,
+including custom catalogs. A nested provider can override it for a specific editor.
+
+Formatting, toolbar modes, read-only behavior (`editable`), templates, links,
+and block restrictions remain per-editor props. Asset resolution, registration,
+and deletion are optional callbacks; no survey store is required. Content remains
+the same serialized Lexical JSON (`change.value`), so existing documents and
+renderers remain compatible. Content policies configure editing behavior; hosts
+must still validate persisted documents against their own accepted content rules.
+
+### Document heading levels
+
+`RichTextContentPolicy.allowedHeadingLevels` configures the heading choices in the
+block toolbar, slash menu, and `#` shortcuts. It defaults to `[1, 2]`; existing
+disallowed levels normalize to the nearest permitted shallower level (or the minimum
+permitted level). An empty list converts headings to paragraphs while retaining content
+and formatting. This applies to pasted content, loaded JSON, and serialized content. For notices, use `[1, 2, 3, 4, 5]` with
+`headingLevelOffset={1}` on both `RichTextBlockEditor` and `RichTextContentView`.
+Document level 1 then renders as HTML `h2`, through level 5 as `h6`. Choices that
+would exceed HTML `h6` are omitted. The offset changes rendering, not saved JSON.
+The standalone editor defaults to offset 0; survey fields use offset 1 to match
+the survey player. Keep an editor's offset stable while editing; changing it
+recreates the Lexical editor.
+
+In editable mode, correcting a supplied value to satisfy the heading policy calls
+`onChange` once with the normalized editor value, even before the user types.
+Controlled hosts should accept that value so saving matches the visible document.
+Ordinary synchronization of an already-valid value and read-only normalization do
+not emit this callback.

package/dist/src/components/c-ui/dot-background.d.ts

@@ -45,8 +45,8 @@ declare const dotBackgroundSpacingVariants: {
 type DotBackgroundVariant = keyof typeof dotBackgroundColorVariants;
 type DotBackgroundSpacingVariant = keyof typeof dotBackgroundSpacingVariants;
 declare const dotBackgroundVariants: (props?: ({
-    variant?: "default" | "secondary" | "accent" | "custom" | "card" | "muted" | null | undefined;
-    spacing?: "default" | "custom" | "dense" | "loose" | "relaxed" | null | undefined;
+    variant?: "default" | "secondary" | "accent" | "muted" | "card" | "custom" | null | undefined;
+    spacing?: "default" | "dense" | "loose" | "custom" | "relaxed" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 type DotBackgroundStyle = React.CSSProperties & {
     "--dot-background-color"?: string;

package/dist/src/components/rich-text/content-policy.d.ts

@@ -1,4 +1,4 @@
-import { Content, RichTextStyle } from '@case-framework/survey-core';
+import { Content, RichTextHeadingBlock, RichTextStyle } from '@case-framework/survey-core';
 export type RichTextEditorVariant = "compact" | "block";
 export type RichTextSupportedBlockType = "paragraph" | "bulletList" | "image" | "separator" | "heading" | "infoBox";
 export type RichTextStyleAttribute = keyof RichTextStyle;
@@ -6,6 +6,12 @@ export interface RichTextContentPolicy {
     variant?: RichTextEditorVariant;
     allowedBlockTypes?: Partial<Record<RichTextSupportedBlockType, boolean>>;
     allowedStyleAttributes?: Partial<Record<RichTextStyleAttribute, boolean>>;
+    /**
+     * Allowed document heading levels; defaults to [1, 2]. An empty list disables headings.
+     * Headings must also be enabled by allowedBlockTypes.heading; false takes precedence.
+     * Disallowed levels normalize to the nearest permitted shallower level (or the minimum).
+     */
+    allowedHeadingLevels?: readonly RichTextHeadingBlock["level"][];
     allowLinks?: boolean;
     allowTemplateVariables?: boolean;
     allowLineBreaks?: boolean;
@@ -17,3 +23,6 @@ export declare const DEFAULT_BLOCK_CONTENT_POLICY: RichTextContentPolicy;
 export declare function mergeRichTextContentPolicy(base: RichTextContentPolicy, override?: RichTextContentPolicy): RichTextContentPolicy;
 export declare function sanitizeContentForPolicy(content: Content | undefined, policy?: RichTextContentPolicy): Content | undefined;
 export declare function isBlockContentPolicyVariant(policy?: RichTextContentPolicy): boolean;
+export declare function getAllowedHeadingLevels(policy?: RichTextContentPolicy): RichTextHeadingBlock["level"][];
+/** Null means headings are disabled; preserve content as a paragraph. */
+export declare function resolveHeadingLevelForPolicy(level: RichTextHeadingBlock["level"], policy?: RichTextContentPolicy): RichTextHeadingBlock["level"] | null;

package/dist/src/components/rich-text/nodes/survey-rich-text-heading-node.d.ts

@@ -11,6 +11,7 @@ export declare class SurveyRichTextHeadingNode extends ParagraphNode {
     static clone(node: SurveyRichTextHeadingNode): SurveyRichTextHeadingNode;
     constructor(level?: RichTextHeadingBlock["level"], key?: string);
     getHeadingLevel(): RichTextHeadingBlock["level"];
+    setHeadingLevel(level: RichTextHeadingBlock["level"]): this;
     createDOM(config: EditorConfig): HTMLElement;
     updateDOM(prevNode: SurveyRichTextHeadingNode): boolean;
     static importDOM(): DOMConversionMap | null;
@@ -19,7 +20,9 @@ export declare class SurveyRichTextHeadingNode extends ParagraphNode {
     };
     static importJSON(serializedNode: SerializedSurveyRichTextHeadingNode): SurveyRichTextHeadingNode;
     exportJSON(): SerializedSurveyRichTextHeadingNode;
-    /** Backspace at block start: replace heading with a paragraph (same children and block styles). */
+    /** Replace this heading with a paragraph, preserving children, selection, and block styles. */
+    convertToParagraph(): ParagraphNode;
+    /** Lexical's backspace-at-block-start handler. */
     collapseAtStart(): boolean;
     insertNewAfter(rangeSelection: RangeSelection, restoreSelection?: boolean): ParagraphNode;
 }

package/dist/src/components/rich-text-editor/plugins/block-shortcut-plugin.d.ts

@@ -1,7 +1,9 @@
+import { RichTextHeadingBlock } from '@case-framework/survey-core';
 export interface BlockShortcutPluginProps {
     bulletListsEnabled: boolean;
     headingsEnabled: boolean;
+    allowedHeadingLevels: readonly RichTextHeadingBlock["level"][];
 }
 /** Converts an exact marker-only root paragraph while the space key is being handled. */
-export declare function $convertBlockShortcut(bulletListsEnabled: boolean, headingsEnabled: boolean): boolean;
-export declare function BlockShortcutPlugin({ bulletListsEnabled, headingsEnabled, }: BlockShortcutPluginProps): null;
+export declare function $convertBlockShortcut(bulletListsEnabled: boolean, headingsEnabled: boolean, allowedHeadingLevels?: readonly RichTextHeadingBlock["level"][]): boolean;
+export declare function BlockShortcutPlugin({ bulletListsEnabled, headingsEnabled, allowedHeadingLevels, }: BlockShortcutPluginProps): null;

package/dist/src/components/rich-text-editor/plugins/docked-toolbar-plugin.d.ts

@@ -1,7 +1,8 @@
+import { RichTextHeadingBlock } from '@case-framework/survey-core';
 import { RefObject } from 'react';
 import { RichTextStyleControl, RichTextTemplateVariable } from '../rich-text-editor-utils';
 /** A stable, in-flow toolbar for longer block editors. */
-export declare function DockedToolbarPlugin({ editable, visibility, position, editorOwnerId, sticky, linksEnabled, blockAlignmentEnabled, surfaceRef, toolbarClassName, styleControls, templateVariables, bulletListsEnabled, headingsEnabled, infoBoxesEnabled, imagesEnabled, separatorsEnabled, }: {
+export declare function DockedToolbarPlugin({ editable, visibility, position, editorOwnerId, sticky, linksEnabled, blockAlignmentEnabled, surfaceRef, toolbarClassName, styleControls, templateVariables, bulletListsEnabled, headingsEnabled, allowedHeadingLevels, infoBoxesEnabled, imagesEnabled, separatorsEnabled, }: {
     editable: boolean;
     visibility: "active" | "always";
     position: "flow" | "above";
@@ -15,6 +16,7 @@ export declare function DockedToolbarPlugin({ editable, visibility, position, ed
     templateVariables: RichTextTemplateVariable[];
     bulletListsEnabled: boolean;
     headingsEnabled: boolean;
+    allowedHeadingLevels: readonly RichTextHeadingBlock["level"][];
     infoBoxesEnabled: boolean;
     imagesEnabled: boolean;
     separatorsEnabled: boolean;

package/dist/src/components/rich-text-editor/plugins/heading-policy-plugin.d.ts

@@ -0,0 +1,13 @@
+import { LexicalEditor, SerializedEditorState } from 'lexical';
+import { RichTextContentPolicy } from '../../rich-text/content-policy';
+/** Normalize within the original Lexical transaction so paste and undo stay atomic. */
+export declare function registerHeadingPolicy(editor: LexicalEditor, policy: RichTextContentPolicy): () => void;
+/**
+ * Normalize incoming JSON before controlled-value comparison and synchronization.
+ * This keeps the sync target consistent with the heading transform's result,
+ * preventing repeated reapplication of a disallowed value supplied by the host.
+ */
+export declare function normalizeHeadingValue(value: SerializedEditorState, policy: RichTextContentPolicy): SerializedEditorState;
+export declare function HeadingPolicyPlugin({ policy }: {
+    policy: RichTextContentPolicy;
+}): null;

package/dist/src/components/rich-text-editor/plugins/link-shortcut-plugin.d.ts

@@ -0,0 +1,3 @@
+export declare function $convertLinkShortcut(insertSpace?: boolean): boolean;
+export declare function $pasteLinkShortcut(text: string): boolean;
+export declare function LinkShortcutPlugin(): null;

package/dist/src/components/rich-text-editor/plugins/slash-command-menu-plugin.d.ts

@@ -1,10 +1,12 @@
+import { RichTextHeadingBlock } from '@case-framework/survey-core';
 import { RefObject } from 'react';
 import { RichTextStyleControl, RichTextTemplateVariable } from '../rich-text-editor-utils';
-export declare function SlashCommandMenuPlugin({ editable, linksEnabled, bulletListsEnabled, headingsEnabled, infoBoxesEnabled, imagesEnabled, separatorsEnabled, editorOwnerId, surfaceRef, styleControls, templateVariables, commandMenuClassName, }: {
+export declare function SlashCommandMenuPlugin({ editable, linksEnabled, bulletListsEnabled, headingsEnabled, allowedHeadingLevels, infoBoxesEnabled, imagesEnabled, separatorsEnabled, editorOwnerId, surfaceRef, styleControls, templateVariables, commandMenuClassName, }: {
     editable: boolean;
     linksEnabled: boolean;
     bulletListsEnabled?: boolean;
     headingsEnabled?: boolean;
+    allowedHeadingLevels: readonly RichTextHeadingBlock["level"][];
     infoBoxesEnabled?: boolean;
     imagesEnabled?: boolean;
     separatorsEnabled?: boolean;

package/dist/src/components/rich-text-editor/plugins/sync-editor-value-plugin.d.ts

@@ -1,4 +1,7 @@
-import { SerializedEditorState } from 'lexical';
-export declare function SyncEditorValuePlugin({ value }: {
+import { EditorState, SerializedEditorState } from 'lexical';
+export declare function SyncEditorValuePlugin({ value, normalizationSource, onNormalize, }: {
     value?: SerializedEditorState | null;
+    /** The supplied value before a policy correction; absent for ordinary synchronization. */
+    normalizationSource?: SerializedEditorState;
+    onNormalize?: (state: EditorState) => void;
 }): null;

package/dist/src/components/rich-text-editor/rich-text-editor-provider.d.ts

@@ -0,0 +1,18 @@
+import { ReactNode } from 'react';
+import { LocalizationCatalog, LocalizationTranslate } from '@case-framework/ui-localization';
+export interface RichTextEditorProviderProps {
+    children: ReactNode;
+    /** UI language, independent of the document language. Defaults to English. */
+    language?: string;
+    /** Overrides merged with the toolkit's bundled English and Dutch messages. */
+    localizations?: LocalizationCatalog;
+    /** Optional host translator; takes precedence over language and localizations. */
+    translate?: LocalizationTranslate;
+}
+/** Supplies rich text UI services without survey state, workspace, or assistant dependencies. */
+export declare function RichTextEditorProvider({ children, language, localizations, translate, }: RichTextEditorProviderProps): import("react").JSX.Element;
+/** Reuse a host provider, or supply defaults for an editor rendered on its own. */
+export declare function RichTextEditorBoundary({ children }: {
+    children: ReactNode;
+}): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import('react').ReactPortal | import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+export declare function useRichTextTranslation(namespace?: string): LocalizationTranslate;

package/dist/src/components/rich-text-editor/rich-text-editor-utils.d.ts

@@ -1,3 +1,4 @@
+import { LocalizationTranslate } from '@case-framework/ui-localization';
 import { RichTextInfoBoxTone } from '../../../components/rich-text/nodes/rich-text-info-box-node';
 import { SurveyRichTextHeadingNode } from '../../../components/rich-text/nodes/survey-rich-text-heading-node';
 import { EditorConfig, ElementFormatType, LexicalCommand, LexicalEditor, LexicalNode, NodeKey, ParagraphNode, RangeSelection, SerializedEditorState, SerializedTextNode, Spread, TextFormatType, TextNode } from 'lexical';
@@ -45,7 +46,7 @@ export type SlashCommandGroupId = "formatting" | "blocks" | "insert";
 /**
  * Block styles exposed by the rich-text toolbar.
  */
-export type RichTextBlockStyle = "bullet-list" | "heading-1" | "heading-2" | "paragraph";
+export type RichTextBlockStyle = "bullet-list" | `heading-${RichTextHeadingBlock["level"]}` | "paragraph";
 export type RichTextBlockSelectionStyle = RichTextBlockStyle | "mixed";
 export declare const SLASH_COMMAND_GROUP_ORDER: Record<SlashCommandGroupId, number>;
 export type SlashCommandItem = {
@@ -109,13 +110,27 @@ export type SlashCommandItem = {
 };
 export declare function getTemplateVariableText(templateKey: string): string;
 export declare function getStyleControlKey(control: RichTextStyleControl): string;
-export declare function resolveStyleControl(control: RichTextStyleControl): {
-    label: string;
-    title: string;
+export declare function getStyleControlStyle(control: RichTextStyleControl): {
     property: string;
     value: string;
 };
-export declare function getSlashCommandItems(styleControls: RichTextStyleControl[], templateVariables: RichTextTemplateVariable[], linksEnabled?: boolean, bulletListsEnabled?: boolean, headingsEnabled?: boolean, infoBoxesEnabled?: boolean, imagesEnabled?: boolean, separatorsEnabled?: boolean): SlashCommandItem[];
+export declare function getStyleControlLabels(control: RichTextStyleControl, t: LocalizationTranslate): {
+    label: string;
+    title: string;
+};
+interface SlashCommandItemsOptions {
+    t: LocalizationTranslate;
+    styleControls: RichTextStyleControl[];
+    templateVariables: RichTextTemplateVariable[];
+    linksEnabled?: boolean;
+    bulletListsEnabled?: boolean;
+    headingsEnabled?: boolean;
+    allowedHeadingLevels?: readonly RichTextHeadingBlock["level"][];
+    infoBoxesEnabled?: boolean;
+    imagesEnabled?: boolean;
+    separatorsEnabled?: boolean;
+}
+export declare function getSlashCommandItems({ t, styleControls, templateVariables, linksEnabled, bulletListsEnabled, headingsEnabled, allowedHeadingLevels, infoBoxesEnabled, imagesEnabled, separatorsEnabled, }: SlashCommandItemsOptions): SlashCommandItem[];
 export declare function $insertSurveyRichTextHeading(level: RichTextHeadingBlock["level"]): boolean;
 export declare function $insertSurveyRichTextParagraph(): boolean;
 /** Returns a shared style, "mixed" for supported mixed blocks, or null if unsupported. */
@@ -225,3 +240,5 @@ export declare class RichTextLinkNode extends TextNode {
 export declare function $createTemplateVariableNode(templateKey: string): TemplateVariableNode;
 export declare function $createRichTextLinkNode(text: string, url: string): RichTextLinkNode;
 export declare function $isRichTextLinkNode(node: unknown): node is RichTextLinkNode;
+/** Preserve legacy survey labels for the default [1, 2] policy; otherwise number levels explicitly. */
+export declare function getHeadingLabel(level: RichTextHeadingBlock["level"], allowedLevels: readonly RichTextHeadingBlock["level"][], t: LocalizationTranslate): string;

package/dist/src/components/rich-text-editor/rich-text-editor.d.ts

@@ -37,6 +37,8 @@ export interface RichTextEditorProps {
     templateVariables?: RichTextTemplateVariable[];
     editorVariant?: "compact" | "block";
     contentPolicy?: RichTextContentPolicy;
+    /** HTML heading offset; document levels remain unchanged. Defaults to 0. */
+    headingLevelOffset?: 0 | 1 | 2 | 3 | 4 | 5;
     resolveImageAssetUrl?: (assetId: string) => string | undefined;
     imageAssets?: RichTextImageAssetOption[];
     /** When set, the image popover can add a new embedded survey image asset and return its id. */
@@ -45,10 +47,11 @@ export interface RichTextEditorProps {
     imageAssetDeletion?: RichTextImageAssetDeletionHandlers;
     linksEnabled?: boolean;
     "aria-label"?: string;
+    /** Reports user edits and policy corrections to supplied values. Read-only value synchronization does not report corrections. */
     onChange?: (change: RichTextEditorChange) => void;
     onFocus?: () => void;
     onBlur?: () => void;
     onKeyDown?: KeyboardEventHandler<HTMLDivElement>;
     onKeyDownCapture?: KeyboardEventHandler<HTMLDivElement>;
 }
-export declare function RichTextEditor({ id, value, placeholder, autoFocus, autoFocusSelection, editable, wrapperClassName, surfaceClassName, contentClassName, endOfContentEditingArea, placeholderClassName, toolbarClassName, toolbarMode, dockedToolbarVisibility, dockedToolbarPosition, dockedToolbarSticky, commandMenuClassName, styleControls, templateVariables, editorVariant, contentPolicy, resolveImageAssetUrl, imageAssets, registerImageAsset, imageAssetDeletion, linksEnabled, "aria-label": ariaLabel, onChange, onFocus, onBlur, onKeyDown, onKeyDownCapture, }: RichTextEditorProps): import("react").JSX.Element;
+export declare function RichTextEditor(props: RichTextEditorProps): import("react").JSX.Element;

package/dist/src/index.d.ts

@@ -12,3 +12,5 @@ export type { CreateComposedEditorRegistryOptions, CreateRegistryEntriesOptions,
 export type { SurveyEditorProps, SurveyEditorController, SurveyEditorHostState, SurveyEditorStateChange, SurveyEditorWorkspace, SurveyEditorWorkspacePanelOptions, SurveyEditorAssistantController, SurveyAssistantSnapshotOptions, CreateSnapshotSurveyEditorAIProviderOptions, UseSurveyEditorAssistantIntegrationOptions, SurveyEditorAITaskCacheOptions, SurveyEditorAITaskExecution, SurveyEditorAITaskExecutor, SurveyEditorLocation, EditorItemDefinition, EditorItemDefinitionRegistry, ItemInitialDataContext, ComposedEditorItemRegistry, EntriesToComposedEditorRegistryOptions, EntriesToParticipantRegistryOptions, ItemEditorComponentProps, ItemIconComponent, ItemPreviewComponentProps, ItemPreviewMode, ItemRegistryEntry, ItemRendererComponentProps, ItemSearchAdapter, RegistryValidationIssue, RegistryValidationMode, RegistryValidationOptions, RegistryValidationResult, SurveyPlayerItemRegistry, SurveyEditorAIProvider, SurveyAIRequestOptions, RichTextEditorChange, RichTextEditorProps, RichTextBlockEditorChange, RichTextBlockEditorProps, RichTextContentPolicy, RichTextLinkPayload, RichTextStyleControl, RichTextTemplateVariable, RichTextContentViewProps, RichTextEditorVariant, RichTextStyleAttribute, RichTextSupportedBlockType, SerializedRichTextLinkNode, SerializedTemplateVariableNode, SurveyImageAssetManagerProps, ParsedSurveySession, ParsedSurveySessionFormat, } from './modules/survey-editor';
 export type { SurveyEditorDateLocales } from './modules/survey-editor/localization/date-fns';
 export type { FilepickerDropzoneLabels, FilepickerDropzoneProps, } from './components/c-ui/filepicker-dropzone';
+export { RichTextEditorProvider } from './components/rich-text-editor/rich-text-editor-provider';
+export type { RichTextEditorProviderProps } from './components/rich-text-editor/rich-text-editor-provider';

package/dist/src/lib/utils.d.ts

@@ -1,2 +1 @@
-import { ClassValue } from 'clsx';
-export declare function cn(...inputs: ClassValue[]): string;
+export { cn } from 'cn';

package/dist/src/modules/default-item-registry/items/choice/editor/option-create.d.ts

@@ -1,5 +1,5 @@
 import { Content } from '@case-framework/survey-core';
-import { ChoiceOptionConfig } from '../model';
+import { ChoiceOptionConfig } from '@case-framework/survey-items/choice';
 interface ChoiceOptionCreateProps {
     isOpen: boolean;
     open: () => void;

package/dist/src/modules/default-item-registry/items/choice/editor/option-editor-card.d.ts

@@ -1,6 +1,6 @@
 import { Content, SurveyItemTranslations } from '@case-framework/survey-core';
-import { FormItemConfig } from '../../form/model';
-import { ChoiceOptionConfig } from '../model';
+import { FormItemConfig } from '@case-framework/survey-items/form';
+import { ChoiceOptionConfig } from '@case-framework/survey-items/choice';
 interface ChoiceOptionEditorCardProps {
     option: ChoiceOptionConfig;
     existingOptions: ChoiceOptionConfig[];

package/dist/src/modules/default-item-registry/items/choice/editor/response-options-list.d.ts

@@ -1,6 +1,6 @@
 import { Content } from '@case-framework/survey-core';
 import { default as React } from 'react';
-import { ChoiceOptionConfig } from '../model';
+import { ChoiceOptionConfig } from '@case-framework/survey-items/choice';
 export interface ChoiceOptionListItem {
     option: ChoiceOptionConfig;
     label: string;

package/dist/src/modules/default-item-registry/items/form/editor/config-editor.d.ts

@@ -1,5 +1,5 @@
 import { SurveyItemTranslations } from '@case-framework/survey-core';
-import { FormItemConfig } from '../model';
+import { FormItemConfig } from '@case-framework/survey-items/form';
 interface FormConfigEditorProps {
     itemId: string;
     config: FormItemConfig;

package/dist/src/modules/default-item-registry/items/form/editor/editor-metadata.d.ts

@@ -0,0 +1,10 @@
+import { FormFieldType, FormFieldValidationType } from '@case-framework/survey-items/form';
+export declare const FORM_BROWSER_AUTOCOMPLETE_OPTIONS: readonly ["name", "given-name", "family-name", "nickname", "email", "username", "organization", "organization-title", "street-address", "address-line1", "address-line2", "address-level2", "address-level1", "postal-code", "country-name", "tel", "url", "one-time-code"];
+export interface FormFieldValidationSuggestion {
+    type: FormFieldValidationType;
+    label: string;
+    description: string;
+    valueKind: "none" | "number" | "text" | "date";
+    defaultValue?: number | string;
+}
+export declare function getFormFieldValidationSuggestions(type: FormFieldType): FormFieldValidationSuggestion[];

package/dist/src/modules/default-item-registry/items/form/editor/field-edit-dialog.d.ts

@@ -1,4 +1,4 @@
-import { FormFieldConfig } from '../model';
+import { FormFieldConfig } from '@case-framework/survey-items/form';
 interface FormFieldEditDialogProps {
     open: boolean;
     field: FormFieldConfig | null;

package/dist/src/modules/default-item-registry/items/form/editor/field-group-layout-dialog.d.ts

@@ -1,4 +1,4 @@
-import { FormFieldGroupLayoutConfig } from '../model';
+import { FormFieldGroupLayoutConfig } from '@case-framework/survey-items/form';
 interface FormFieldGroupLayoutDialogProps {
     open: boolean;
     initialLayout: FormFieldGroupLayoutConfig;

package/dist/src/modules/default-item-registry/items/form/editor/field-item-preview.d.ts

@@ -1,4 +1,4 @@
-import { FormFieldType } from '../model';
+import { FormFieldType } from '@case-framework/survey-items/form';
 export interface FormFieldItemPreviewProps {
     codingKey: string;
     fieldType: FormFieldType;

package/dist/src/modules/default-item-registry/items/form/editor/field-key-dialog.d.ts

@@ -1,4 +1,4 @@
-import { FormFieldConfig } from '../model';
+import { FormFieldConfig } from '@case-framework/survey-items/form';
 interface FormFieldKeyDialogProps {
     open: boolean;
     field: FormFieldConfig | null;

package/dist/src/modules/default-item-registry/items/form/editor/field-sort-dialog.d.ts

@@ -1,4 +1,4 @@
-import { FormFieldConfig } from '../model';
+import { FormFieldConfig } from '@case-framework/survey-items/form';
 interface FormFieldSortDialogProps {
     open: boolean;
     groupId: string | null;

package/dist/src/modules/default-item-registry/items/form/editor/field-type-shared.d.ts

@@ -1,12 +1,12 @@
-import { FormFieldType } from '../model';
+import { FormFieldType } from '@case-framework/survey-items/form';
 export declare const FORM_FIELD_TYPES: ("number" | "input" | "select" | "textarea" | "switch" | "slider" | "datepicker")[];
 export declare const FORM_FIELD_TYPE_ICON: {
-    input: react.ForwardRefExoticComponent<any>;
-    textarea: react.ForwardRefExoticComponent<any>;
-    number: react.ForwardRefExoticComponent<any>;
-    datepicker: react.ForwardRefExoticComponent<any>;
-    switch: react.ForwardRefExoticComponent<any>;
-    select: react.ForwardRefExoticComponent<any>;
-    slider: react.ForwardRefExoticComponent<any>;
+    input: import('react').ForwardRefExoticComponent<Omit<import('lucide-react').LucideProps, "ref"> & import('react').RefAttributes<SVGSVGElement>>;
+    textarea: import('react').ForwardRefExoticComponent<Omit<import('lucide-react').LucideProps, "ref"> & import('react').RefAttributes<SVGSVGElement>>;
+    number: import('react').ForwardRefExoticComponent<Omit<import('lucide-react').LucideProps, "ref"> & import('react').RefAttributes<SVGSVGElement>>;
+    datepicker: import('react').ForwardRefExoticComponent<Omit<import('lucide-react').LucideProps, "ref"> & import('react').RefAttributes<SVGSVGElement>>;
+    switch: import('react').ForwardRefExoticComponent<Omit<import('lucide-react').LucideProps, "ref"> & import('react').RefAttributes<SVGSVGElement>>;
+    select: import('react').ForwardRefExoticComponent<Omit<import('lucide-react').LucideProps, "ref"> & import('react').RefAttributes<SVGSVGElement>>;
+    slider: import('react').ForwardRefExoticComponent<Omit<import('lucide-react').LucideProps, "ref"> & import('react').RefAttributes<SVGSVGElement>>;
 };
 export declare function getFormFieldTypeLabel(t: (key: string) => string, fieldType: FormFieldType): string;

package/dist/src/modules/default-item-registry/items/form/editor/response-field-groups-list.d.ts

@@ -1,4 +1,4 @@
-import { FormFieldType, FormFieldGroupConfig } from '../model';
+import { FormFieldType, FormFieldGroupConfig } from '@case-framework/survey-items/form';
 interface FormResponseFieldGroupsListProps {
     itemId: string;
     items: FormFieldGroupConfig[];

package/dist/src/modules/default-item-registry/items/form/editor/simple-field-editor.d.ts

@@ -1,4 +1,4 @@
-import { FormFieldConfig } from '../model';
+import { FormFieldConfig } from '@case-framework/survey-items/form';
 export declare function SimpleFormFieldEditor({ field, onSave, onCustomize, }: {
     field: FormFieldConfig;
     onSave: (nextField: FormFieldConfig) => void;

package/dist/src/modules/survey-editor/assistant/apply.d.ts

@@ -1,18 +1,9 @@
 import { SurveyEditor as SurveyEditorCore } from '@case-framework/survey-core/editor';
 import { ComposedEditorItemRegistry } from '../registry';
-import { SurveyApplyResult, SurveyBatchApplyResult, SurveyChangeSet, SurveyDocumentVersion } from '@case-framework/survey-assistant/protocol';
-export interface SurveyAssistantEditorApplyResult extends SurveyApplyResult {
-    editor?: SurveyEditorCore;
-}
+import { SurveyBatchApplyResult, SurveyChangeSet, SurveyDocumentVersion } from '@case-framework/survey-assistant/protocol';
 export interface SurveyAssistantEditorBatchApplyResult extends SurveyBatchApplyResult {
     editor?: SurveyEditorCore;
 }
-interface ApplySurveyAssistantChangeInput {
-    change: SurveyChangeSet;
-    currentPrecondition: SurveyDocumentVersion;
-    editor: SurveyEditorCore;
-    itemRegistry: ComposedEditorItemRegistry;
-}
 interface ApplySurveyAssistantChangesInput {
     changes: SurveyChangeSet[];
     currentPrecondition: SurveyDocumentVersion;
@@ -25,5 +16,4 @@ export declare const resolveSelectedLocaleAfterAssistantApply: ({ availableLocal
     selectedLocale: string;
 }) => string;
 export declare const applySurveyAssistantChangesToEditor: ({ changes, currentPrecondition, editor, itemRegistry, }: ApplySurveyAssistantChangesInput) => SurveyAssistantEditorBatchApplyResult;
-export declare const applySurveyAssistantChangeToEditor: ({ change, currentPrecondition, editor, itemRegistry, }: ApplySurveyAssistantChangeInput) => SurveyAssistantEditorApplyResult;
 export {};

package/dist/src/modules/survey-editor/assistant/index.d.ts

@@ -1,2 +1,2 @@
-export { applySurveyAssistantChangeToEditor, applySurveyAssistantChangesToEditor, resolveSelectedLocaleAfterAssistantApply, type SurveyAssistantEditorApplyResult, type SurveyAssistantEditorBatchApplyResult, } from './apply';
+export { applySurveyAssistantChangesToEditor, resolveSelectedLocaleAfterAssistantApply, type SurveyAssistantEditorBatchApplyResult, } from './apply';
 export { buildSurveyAssistantItemRegistryManifest, buildSurveyAssistantSnapshot, type SurveyAssistantSnapshotOptions, type SurveyEditorAssistantController, } from './snapshot';

package/dist/src/modules/survey-editor/assistant/snapshot.d.ts

@@ -1,6 +1,6 @@
 import { SurveyEditor } from '@case-framework/survey-core/editor';
 import { SurveyEditorLocation } from '../navigation/types';
-import { SurveyApplyResult, SurveyAssistantItemRegistryManifest, SurveyAssistantSnapshot, SurveyBatchApplyResult, SurveyChangeSet } from '@case-framework/survey-assistant/protocol';
+import { SurveyAssistantItemRegistryManifest, SurveyAssistantSnapshot, SurveyBatchApplyResult, SurveyChangeSet } from '@case-framework/survey-assistant/protocol';
 import { ComposedEditorItemRegistry } from '../registry';
 export interface SurveyAssistantSnapshotOptions {
     createdAt?: string;
@@ -18,7 +18,6 @@ export interface SurveyAssistantSnapshotOptions {
 }
 export interface SurveyEditorAssistantController {
     getSnapshot(options?: SurveyAssistantSnapshotOptions): SurveyAssistantSnapshot;
-    applyAssistantChange(change: SurveyChangeSet): SurveyApplyResult;
     applyAssistantChanges(changes: SurveyChangeSet[]): SurveyBatchApplyResult;
 }
 interface BuildSurveyAssistantSnapshotInput {

package/dist/src/modules/survey-editor/hooks/focus-when-available.d.ts

@@ -0,0 +1,8 @@
+type FocusTarget = Pick<HTMLElement, "focus">;
+interface FocusWhenAvailableOptions {
+    maxAttempts?: number;
+    requestFrame?: (callback: FrameRequestCallback) => number;
+    cancelFrame?: (handle: number) => void;
+}
+export declare const focusWhenAvailable: (findTarget: () => FocusTarget | null | undefined, { maxAttempts, requestFrame, cancelFrame, }?: FocusWhenAvailableOptions) => (() => void);
+export {};

package/dist/src/modules/survey-editor/hooks/item-clipboard-shortcut.d.ts

@@ -0,0 +1,16 @@
+import { SurveyItemClipboardData } from '@case-framework/survey-core/editor';
+export type ItemClipboardShortcut = "copy" | "paste";
+interface ItemClipboardShortcutEvent {
+    altKey: boolean;
+    ctrlKey: boolean;
+    defaultPrevented: boolean;
+    isComposing: boolean;
+    key: string;
+    metaKey: boolean;
+    repeat: boolean;
+    shiftKey: boolean;
+}
+export declare const hasActiveTextSelection: () => boolean;
+export declare const parseSurveyItemClipboardValue: (value: string | null) => SurveyItemClipboardData | null;
+export declare const resolveItemClipboardShortcut: (event: ItemClipboardShortcutEvent, textSelectionActive?: boolean) => ItemClipboardShortcut | null;
+export {};

package/dist/src/modules/survey-editor/routes/editor/_components/expression-diagnostics-status-model.d.ts

@@ -0,0 +1,10 @@
+import { SurveyExpressionReferenceDiagnostic } from '@case-framework/survey-core';
+export interface ExpressionDiagnosticsStatusModel {
+    advisoryGroups: Array<{
+        diagnostics: SurveyExpressionReferenceDiagnostic[];
+        kind: "display-dependency" | "general";
+    }>;
+    blockingDiagnostics: SurveyExpressionReferenceDiagnostic[];
+    repairPrompt?: string;
+}
+export declare const createExpressionDiagnosticsStatusModel: (diagnostics: SurveyExpressionReferenceDiagnostic[]) => ExpressionDiagnosticsStatusModel;

package/dist/src/modules/survey-editor/routes/editor/_components/workspace-presets.d.ts

@@ -5,7 +5,7 @@ export declare const editorWorkspacePresets: {
         readonly left: {
             readonly id: "outline";
             readonly defaultOpen: true;
-            readonly defaultSize: 240;
+            readonly defaultSize: 288;
             readonly minSize: 160;
             readonly maxSize: 720;
         };
@@ -13,7 +13,7 @@ export declare const editorWorkspacePresets: {
             readonly id: "assistant";
             readonly defaultOpen: false;
             readonly defaultOpenAtViewportWidth: 1280;
-            readonly defaultSize: 360;
+            readonly defaultSize: 288;
             readonly minSize: 280;
             readonly maxSize: 520;
             readonly allowContentOverflow: true;
@@ -25,7 +25,7 @@ export declare const editorWorkspacePresets: {
         readonly left: {
             readonly id: "outline";
             readonly defaultOpen: true;
-            readonly defaultSize: 240;
+            readonly defaultSize: 288;
             readonly minSize: 160;
             readonly maxSize: 720;
         };
@@ -33,7 +33,7 @@ export declare const editorWorkspacePresets: {
             readonly id: "assistant";
             readonly defaultOpen: false;
             readonly defaultOpenAtViewportWidth: 1280;
-            readonly defaultSize: 360;
+            readonly defaultSize: 288;
             readonly minSize: 280;
             readonly maxSize: 520;
             readonly allowContentOverflow: true;
@@ -45,7 +45,7 @@ export declare const editorWorkspacePresets: {
         readonly left: {
             readonly id: "outline";
             readonly defaultOpen: true;
-            readonly defaultSize: 240;
+            readonly defaultSize: 288;
             readonly minSize: 160;
             readonly maxSize: 720;
         };
@@ -53,7 +53,7 @@ export declare const editorWorkspacePresets: {
             readonly id: "assistant";
             readonly defaultOpen: false;
             readonly defaultOpenAtViewportWidth: 1280;
-            readonly defaultSize: 360;
+            readonly defaultSize: 288;
             readonly minSize: 280;
             readonly maxSize: 520;
             readonly allowContentOverflow: true;
@@ -66,7 +66,7 @@ export declare const editorWorkspacePresets: {
             readonly id: "assistant";
             readonly defaultOpen: false;
             readonly defaultOpenAtViewportWidth: 1280;
-            readonly defaultSize: 360;
+            readonly defaultSize: 288;
             readonly minSize: 280;
             readonly maxSize: 520;
             readonly allowContentOverflow: true;