@case-framework/survey-editor-ui 0.3.3 → 0.4.0

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" | "muted" | "card" | "custom" | null | undefined;
-    spacing?: "default" | "dense" | "loose" | "custom" | "relaxed" | null | undefined;
+    variant?: "default" | "secondary" | "accent" | "custom" | "muted" | "card" | null | undefined;
+    spacing?: "default" | "custom" | "dense" | "loose" | "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/index.d.ts

@@ -1,6 +1,6 @@
 export { RichTextBlockEditor, type RichTextBlockEditorChange, type RichTextBlockEditorProps, } from './rich-text-block-editor';
 export { RichTextContentView, type RichTextContentViewProps } from './rich-text-content-view';
-export { createRichTextEditorValueFromContent, createRichTextEditorValueFromText, getRichTextContentFromEditorState, writeContentToEditor, } from './rich-text-survey-content';
+export { createRichTextEditorValueFromContent, createRichTextEditorValueFromText, getRichTextContentFromEditorState, type RichTextSerializationOptions, writeContentToEditor, } from './rich-text-survey-content';
 export type { RichTextImageAssetOption } from './types';
 export { DEFAULT_BLOCK_CONTENT_POLICY, DEFAULT_COMPACT_CONTENT_POLICY, isBlockContentPolicyVariant, mergeRichTextContentPolicy, sanitizeContentForPolicy, } from './content-policy';
 export type { RichTextContentPolicy, RichTextEditorVariant, RichTextStyleAttribute, RichTextSupportedBlockType, } from './content-policy';

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

@@ -2,6 +2,10 @@ import { Content, RichTextContent } from '@case-framework/survey-core';
 import { EditorState, SerializedEditorState } from 'lexical';
 import { RichTextContentPolicy } from './content-policy';
 export declare function writeContentToEditor(content?: Content, policy?: RichTextContentPolicy): void;
-export declare function getRichTextContentFromEditorState(editorState: EditorState, policy?: RichTextContentPolicy): RichTextContent;
+export interface RichTextSerializationOptions {
+    /** Excludes the editor-only final paragraph used as a convenient caret target. */
+    excludeTrailingEmptyParagraph?: boolean;
+}
+export declare function getRichTextContentFromEditorState(editorState: EditorState, policy?: RichTextContentPolicy, options?: RichTextSerializationOptions): RichTextContent;
 export declare function createRichTextEditorValueFromContent(content?: Content, policy?: RichTextContentPolicy): SerializedEditorState;
 export declare function createRichTextEditorValueFromText(text?: string, policy?: RichTextContentPolicy): SerializedEditorState;

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

@@ -0,0 +1,19 @@
+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, linksEnabled, blockAlignmentEnabled, surfaceRef, toolbarClassName, styleControls, templateVariables, bulletListsEnabled, headingsEnabled, infoBoxesEnabled, imagesEnabled, separatorsEnabled, }: {
+    editable: boolean;
+    visibility: "active" | "always";
+    position: "flow" | "above";
+    linksEnabled: boolean;
+    blockAlignmentEnabled: boolean;
+    surfaceRef: RefObject<HTMLDivElement | null>;
+    toolbarClassName?: string;
+    styleControls: RichTextStyleControl[];
+    templateVariables: RichTextTemplateVariable[];
+    bulletListsEnabled: boolean;
+    headingsEnabled: boolean;
+    infoBoxesEnabled: boolean;
+    imagesEnabled: boolean;
+    separatorsEnabled: boolean;
+}): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,4 @@
+import { LexicalEditor } from 'lexical';
+import { SlashCommandItem } from './rich-text-editor-utils';
+/** Applies a policy-filtered slash/toolbar command at the current Lexical selection. */
+export declare function $applyRichTextCommand(editor: LexicalEditor, item: SlashCommandItem): void;

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

@@ -15,6 +15,7 @@ export interface RichTextEditorProps {
     value?: SerializedEditorState | null;
     placeholder?: string;
     autoFocus?: boolean;
+    autoFocusSelection?: "rootStart" | "rootEnd";
     editable?: boolean;
     wrapperClassName?: string;
     surfaceClassName?: string;
@@ -23,6 +24,12 @@ export interface RichTextEditorProps {
     endOfContentEditingArea?: boolean;
     placeholderClassName?: string;
     toolbarClassName?: string;
+    /** Floating is retained for compact editors; docked puts controls above block content. */
+    toolbarMode?: "floating" | "docked" | "none";
+    /** Applies to docked toolbars. */
+    dockedToolbarVisibility?: "active" | "always";
+    /** Whether a docked toolbar participates in flow or sits immediately above its editor surface. */
+    dockedToolbarPosition?: "flow" | "above";
     commandMenuClassName?: string;
     styleControls?: RichTextStyleControl[];
     templateVariables?: RichTextTemplateVariable[];
@@ -42,4 +49,4 @@ export interface RichTextEditorProps {
     onKeyDown?: KeyboardEventHandler<HTMLDivElement>;
     onKeyDownCapture?: KeyboardEventHandler<HTMLDivElement>;
 }
-export declare function RichTextEditor({ id, value, placeholder, autoFocus, editable, wrapperClassName, surfaceClassName, contentClassName, endOfContentEditingArea, placeholderClassName, toolbarClassName, commandMenuClassName, styleControls, templateVariables, editorVariant, contentPolicy, resolveImageAssetUrl, imageAssets, registerImageAsset, imageAssetDeletion, linksEnabled, "aria-label": ariaLabel, onChange, onFocus, onBlur, onKeyDown, onKeyDownCapture, }: RichTextEditorProps): import("react/jsx-runtime").JSX.Element;
+export declare function RichTextEditor({ id, value, placeholder, autoFocus, autoFocusSelection, editable, wrapperClassName, surfaceClassName, contentClassName, endOfContentEditingArea, placeholderClassName, toolbarClassName, toolbarMode, dockedToolbarVisibility, dockedToolbarPosition, commandMenuClassName, styleControls, templateVariables, editorVariant, contentPolicy, resolveImageAssetUrl, imageAssets, registerImageAsset, imageAssetDeletion, linksEnabled, "aria-label": ariaLabel, onChange, onFocus, onBlur, onKeyDown, onKeyDownCapture, }: RichTextEditorProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/modules/default-item-registry/items/choice/editor/{option-edit-dialog.d.ts → option-editor-card.d.ts}

@@ -1,21 +1,21 @@
 import { Content, SurveyItemTranslations } from '@case-framework/survey-core';
 import { FormItemConfig } from '../../form/model';
 import { ChoiceOptionConfig } from '../model';
-type ChoiceOptionEditorFocusField = "label" | "key" | "advanced";
-interface ChoiceOptionEditDialogProps {
-    open: boolean;
-    option: ChoiceOptionConfig | null;
+interface ChoiceOptionEditorCardProps {
+    option: ChoiceOptionConfig;
     existingOptions: ChoiceOptionConfig[];
     initialLabelContent?: Content;
-    initialFocusField?: ChoiceOptionEditorFocusField;
-    initialAdvancedOpen?: boolean;
     itemId: string;
     embeddedFormConfig: FormItemConfig;
     embeddedFormEditingConfig: FormItemConfig;
     selectedLocale: string;
     translationNamespace: string;
-    onSave: (option: ChoiceOptionConfig, labelContent?: Content) => void;
+    onCommit: (option: ChoiceOptionConfig, labelContent?: Content) => void;
+    onClose: () => void;
     onPersistEmbeddedForm: (applyChanges: (nextConfig: FormItemConfig, nextTranslations: SurveyItemTranslations) => void | boolean) => boolean;
 }
-export declare const ChoiceOptionEditDialog: React.FC<ChoiceOptionEditDialogProps>;
+export interface ChoiceOptionEditorCardHandle {
+    commit: () => boolean;
+}
+export declare const ChoiceOptionEditorCard: import('react').ForwardRefExoticComponent<ChoiceOptionEditorCardProps & import('react').RefAttributes<ChoiceOptionEditorCardHandle>>;
 export {};

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

@@ -1,14 +1,18 @@
 import { RichTextEditorChange } from '../../../../../../components/rich-text-editor';
 import { SerializedEditorState } from 'lexical';
-import { ReactNode } from 'react';
+import { ReactNode, RefObject } from 'react';
 interface ChoiceOptionEditorFieldsProps {
     draftKey: string;
     draftLabelEditorValue: SerializedEditorState;
     keyValidationMessage: string | null;
     labelEditorInstanceKey: number;
     labelAutoFocus?: boolean;
+    labelAutoFocusSelection?: "rootStart" | "rootEnd";
+    labelWrapperClassName?: string;
     keyAutoFocus?: boolean;
     keyRowTrailing?: ReactNode;
+    keyInputRef?: RefObject<HTMLInputElement | null>;
+    hideKeyField?: boolean;
     onDraftKeyChange: (value: string) => void;
     onDraftLabelChange: (change: RichTextEditorChange) => void;
     onSubmitShortcut?: () => void;

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

@@ -9,9 +9,10 @@ export interface ChoiceOptionListItem {
 interface ChoiceResponseOptionsListProps {
     itemId: string;
     items: ChoiceOptionListItem[];
-    onItemEditLabel: (optionId: string) => void;
-    onItemEditKey: (optionId: string) => void;
-    onItemEditEmbeddedForm: (optionId: string) => void;
+    editingOptionId?: string;
+    editorCard?: React.ReactNode;
+    directDeleteEnabled: boolean;
+    onItemEdit: (optionId: string) => void;
     onItemDuplicate: (optionId: string) => void;
     onItemDelete: (optionId: string) => void;
     onItemsReorder: (nextItems: ChoiceOptionConfig[]) => void;

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

@@ -0,0 +1,6 @@
+import { FormFieldConfig } from '../model';
+export declare function SimpleFormFieldEditor({ field, onSave, onCustomize, }: {
+    field: FormFieldConfig;
+    onSave: (nextField: FormFieldConfig) => void;
+    onCustomize: () => void;
+}): import("react/jsx-runtime").JSX.Element;

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

@@ -125,6 +125,8 @@ export interface FormFieldGroupConfig {
 }
 export interface FormItemConfig {
     id: string;
+    /** Editor-facing complexity level; it does not change participant behavior. */
+    authoringMode: "simple" | "custom";
     fieldGroups: FormFieldGroupConfig[];
 }
 export declare function createFormItemConfig(itemId: string): FormItemConfig;

package/dist/src/modules/default-item-registry/shared/question-editor/deferred-localized-rich-text-field.d.ts

@@ -17,6 +17,9 @@ export interface DeferredLocalizedRichTextFieldProps {
     placeholderClassName?: string;
     styleControls?: RichTextStyleControl[];
     templateVariables?: RichTextTemplateVariable[];
+    toolbarMode?: "floating" | "docked" | "none";
+    dockedToolbarVisibility?: "active" | "always";
+    dockedToolbarPosition?: "flow" | "above";
     resolveImageAssetUrl?: (assetId: string) => string | undefined;
     imageAssets?: RichTextImageAssetOption[];
 }

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

@@ -19,6 +19,11 @@ interface ApplySurveyAssistantChangesInput {
     editor: SurveyEditorCore;
     itemRegistry: ComposedEditorItemRegistry;
 }
+export declare const resolveSelectedLocaleAfterAssistantApply: ({ availableLocales, configuredFallbackLocale, selectedLocale, }: {
+    availableLocales: string[];
+    configuredFallbackLocale: string;
+    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, type SurveyAssistantEditorApplyResult, type SurveyAssistantEditorBatchApplyResult, } from './apply';
+export { applySurveyAssistantChangeToEditor, applySurveyAssistantChangesToEditor, resolveSelectedLocaleAfterAssistantApply, type SurveyAssistantEditorApplyResult, type SurveyAssistantEditorBatchApplyResult, } from './apply';
 export { buildSurveyAssistantItemRegistryManifest, buildSurveyAssistantSnapshot, type SurveyAssistantSnapshotOptions, type SurveyEditorAssistantController, } from './snapshot';

package/dist/src/modules/survey-editor/editor-card/add-items/constants.d.ts

@@ -1,5 +1,5 @@
-export declare const LAST_USED_ITEM_TYPE_KEY = "case.survey-editor.last-used-item-type";
-export declare const RECENT_ITEM_TYPES_KEY = "case.survey-editor.recent-item-types";
+export declare const LAST_USED_ADD_ITEM_PRESET_KEY = "case.survey-editor.last-used-add-item-preset";
+export declare const RECENT_ADD_ITEM_PRESETS_KEY = "case.survey-editor.recent-add-item-presets";
 export declare const MAX_RECENT_ITEM_TYPES = 5;
 export declare const DEFAULT_TOP_ITEM_TYPES: readonly ["infoItem", "formItem"];
 export declare const STRUCTURE_ITEM_TYPES: Set<string>;

package/dist/src/modules/survey-editor/editor-card/add-items/hooks/use-add-item-actions.d.ts

@@ -15,9 +15,9 @@ interface UseAddItemActionsParams {
     targetIndex?: number;
     rootItemId?: string;
     clipboardValue: string | null;
-    recordRecentItemType: (itemType: string) => void;
+    recordRecentPreset: (presetId: string) => void;
 }
-export declare function useAddItemActions({ editorItemRegistry, addItem, pasteItem, commitByUser, setPreferredPreviewItemId, closeDialog, targetGroupId, targetIndex, rootItemId, clipboardValue, recordRecentItemType, }: UseAddItemActionsParams): {
+export declare function useAddItemActions({ editorItemRegistry, addItem, pasteItem, commitByUser, setPreferredPreviewItemId, closeDialog, targetGroupId, targetIndex, rootItemId, clipboardValue, recordRecentPreset, }: UseAddItemActionsParams): {
     handleSelectOption: (option: ItemTypeOption) => void;
     pasteFromClipboard: () => void;
 };

package/dist/src/modules/survey-editor/editor-card/add-items/hooks/use-option-group-navigation.d.ts

@@ -2,8 +2,8 @@ import { FocusEvent as ReactFocusEvent, KeyboardEvent as ReactKeyboardEvent, Ref
 interface UseOptionGroupNavigationParams<TOption> {
     options: TOption[];
     onSelect: (option: TOption) => void;
+    groupSizes?: number[];
     rowSize?: number;
-    enableTabNavigation?: boolean;
 }
 export interface OptionGroupNavigation {
     groupRef: RefObject<HTMLDivElement | null>;
@@ -16,5 +16,5 @@ export interface OptionGroupNavigation {
     handleGroupBlur: (event: ReactFocusEvent<HTMLDivElement>) => void;
     handleGroupKeyDown: (event: ReactKeyboardEvent<HTMLDivElement>) => void;
 }
-export declare function useOptionGroupNavigation<TOption>({ options, onSelect, rowSize, enableTabNavigation, }: UseOptionGroupNavigationParams<TOption>): OptionGroupNavigation;
+export declare function useOptionGroupNavigation<TOption>({ options, onSelect, groupSizes, rowSize, }: UseOptionGroupNavigationParams<TOption>): OptionGroupNavigation;
 export {};

package/dist/src/modules/survey-editor/editor-card/add-items/initial-item-tree.d.ts

@@ -0,0 +1,13 @@
+import { SurveyItemCore, SurveyItemTranslations } from '@case-framework/survey-core';
+import { Target } from '@case-framework/survey-core/editor';
+import { ComposedEditorItemRegistry, ItemInitialData } from '../../../../../modules/survey-editor/registry';
+interface ItemIdLookup {
+    has(itemId: string): boolean;
+}
+interface AddInitialItemTreeOptions {
+    itemKey?: string;
+    targetIndex?: number;
+    existingItemIds?: ItemIdLookup;
+}
+export declare const addInitialItemTree: (initialItem: ItemInitialData, parentId: string, editorItemRegistry: Pick<ComposedEditorItemRegistry, "coreRegistry">, addItem: (target: Target | null, item: SurveyItemCore, content?: SurveyItemTranslations) => void, options?: AddInitialItemTreeOptions) => SurveyItemCore;
+export {};

package/dist/src/modules/survey-editor/editor-card/add-items/types.d.ts

@@ -2,6 +2,7 @@ import { LucideIcon } from 'lucide-react';
 import { ItemTypeInfos } from '../../../../../modules/survey-editor/utils/item-type-infos';
 export type AddDialogView = "entry" | "blank-item" | "structure" | "catalogue";
 export interface ItemTypeOption extends ItemTypeInfos {
+    presetId: string;
     itemType: string;
     categories: string[];
 }

package/dist/src/modules/survey-editor/editor-card/add-items/views/item-type-grid-view.d.ts

@@ -6,9 +6,6 @@ export interface ItemTypeGridSection {
     options: ItemTypeOption[];
 }
 interface ItemTypeGridViewProps {
-    search: string;
-    searchInputRef: RefObject<HTMLInputElement | null>;
-    searchPlaceholder: string;
     recentLabel: string;
     recentOptions: ItemTypeOption[];
     sections: ItemTypeGridSection[];
@@ -16,15 +13,11 @@ interface ItemTypeGridViewProps {
     activeIndex: number;
     isFocused: boolean;
     setActiveIndex: (index: number) => void;
-    onSearchChange: (search: string) => void;
-    onMoveFocusToGrid: () => void;
     onGroupFocus: () => void;
     onGroupBlur: (event: ReactFocusEvent<HTMLDivElement>) => void;
     onGroupKeyDown: (event: ReactKeyboardEvent<HTMLDivElement>) => void;
     onSelectOption: (option: ItemTypeOption) => void;
-    emptyMessage: string;
     gridLabel: string;
-    fullScreen: boolean;
 }
-export declare function ItemTypeGridView({ search, searchInputRef, searchPlaceholder, recentLabel, recentOptions, sections, optionGroupRef, activeIndex, isFocused, setActiveIndex, onSearchChange, onMoveFocusToGrid, onGroupFocus, onGroupBlur, onGroupKeyDown, onSelectOption, emptyMessage, gridLabel, fullScreen, }: ItemTypeGridViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function ItemTypeGridView({ recentLabel, recentOptions, sections, optionGroupRef, activeIndex, isFocused, setActiveIndex, onGroupFocus, onGroupBlur, onGroupKeyDown, onSelectOption, gridLabel, }: ItemTypeGridViewProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/src/modules/survey-editor/editor-card/item-editor-card.d.ts

@@ -11,13 +11,9 @@ interface NavItem {
     hasIndicator?: boolean;
     indicatorCount?: number;
 }
-interface SidePanelCard {
-    id: string;
+interface ConditionsPopoverConfig {
     title: string;
     description?: string;
-    icon: LucideIcon;
-    content?: ReactNode;
-    headerAction?: ReactNode;
 }
 interface ItemEditorCardProps {
     surveyItem: SurveyItemCore;
@@ -27,7 +23,7 @@ interface ItemEditorCardProps {
     };
     navItems?: NavItem[];
     layoutVariant?: "tabs" | "stacked";
-    sidePanelCards?: SidePanelCard[];
+    conditionsPopover?: ConditionsPopoverConfig;
     children: ReactNode;
 }
 declare const ItemEditorCard: React.FC<ItemEditorCardProps>;

package/dist/src/modules/survey-editor/editor-card/item-editor-context.d.ts

@@ -1,13 +1,15 @@
 import { ReactNode } from 'react';
+export type AddItemDialogMode = "assistant" | "browse";
 interface ItemEditorContextType {
     addItemDialogOpen: boolean;
     setAddItemDialogOpen: (open: boolean) => void;
-    openAddItemDialog: (targetParentId?: string, targetIndex?: number, pendingItemType?: string) => void;
+    openAddItemDialog: (targetParentId?: string, targetIndex?: number, pendingPresetId?: string, preferredMode?: AddItemDialogMode) => void;
     closeAddItemDialog: () => void;
     targetParentId: string | undefined;
     targetIndex: number | undefined;
-    pendingItemType: string | undefined;
-    clearPendingItemType: () => void;
+    pendingPresetId: string | undefined;
+    preferredAddItemDialogMode: AddItemDialogMode | undefined;
+    clearPendingPresetId: () => void;
     preferredPreviewItemId: string | null;
     setPreferredPreviewItemId: (itemId: string | null) => void;
 }
@@ -17,7 +19,7 @@ interface ItemEditorProviderProps {
 export declare const ItemEditorProvider: React.FC<ItemEditorProviderProps>;
 export declare const useItemEditor: () => ItemEditorContextType;
 export declare const useAddItemDialog: () => {
-    openAddItemDialog: (targetParentId?: string, targetIndex?: number, pendingItemType?: string) => void;
+    openAddItemDialog: (targetParentId?: string, targetIndex?: number, pendingPresetId?: string, preferredMode?: AddItemDialogMode) => void;
     closeAddItemDialog: () => void;
 };
 export {};

package/dist/src/modules/survey-editor/editor-card/item-key-editor.d.ts

@@ -4,6 +4,7 @@ interface ItemKeyEditorProps {
     currentItemKey?: SurveyItemKey;
     siblingKeys: string[];
     onChangeItemKey: (newKey: string) => void;
+    suppressInitialTooltipFocus?: boolean;
 }
 declare const ItemKeyEditor: (props: ItemKeyEditorProps) => import("react/jsx-runtime").JSX.Element;
 export default ItemKeyEditor;

package/dist/src/modules/survey-editor/editor-card/item-label-preview-and-editor.d.ts

@@ -5,6 +5,7 @@ interface ItemLabelPreviewAndEditorProps {
     maxSuggestions?: number;
     className?: string;
     onChangeItemLabel: (newLabel: string) => void;
+    suppressInitialTooltipFocus?: boolean;
 }
 declare const ItemLabelPreviewAndEditor: React.FC<ItemLabelPreviewAndEditorProps>;
 export default ItemLabelPreviewAndEditor;

package/dist/src/modules/survey-editor/editor-card/item-type-icon-with-tooltip.d.ts

@@ -3,6 +3,7 @@ interface ItemTypeIconWithTooltipProps {
     typeInfos: ItemTypeInfos;
     color?: string;
     iconClassName?: string;
+    preventAutoFocus?: boolean;
 }
-declare const ItemTypeIconWithTooltip: ({ typeInfos, color, iconClassName, }: ItemTypeIconWithTooltipProps) => import("react/jsx-runtime").JSX.Element;
+declare const ItemTypeIconWithTooltip: ({ typeInfos, color, iconClassName, preventAutoFocus, }: ItemTypeIconWithTooltipProps) => import("react/jsx-runtime").JSX.Element;
 export default ItemTypeIconWithTooltip;

package/dist/src/modules/survey-editor/navigation/location.d.ts

@@ -3,4 +3,12 @@ export type ItemFocusedSurveyEditorLocation = Exclude<SurveyEditorLocation, {
     view: "asset-manager";
 }>;
 export declare const surveyEditorLocationSupportsItemFocus: (location: SurveyEditorLocation) => location is ItemFocusedSurveyEditorLocation;
+/**
+ * Returns the item that is actively being authored or inspected.
+ *
+ * Preview navigation keeps its canvas focus (`itemId`) separate from the item
+ * whose inline editor is open (`editingItemId`). The latter is the actionable
+ * target and therefore must win when publishing editor context to consumers
+ * such as the survey assistant.
+ */
 export declare const getSurveyEditorFocusedItemId: (location: SurveyEditorLocation) => string | undefined;

package/dist/src/modules/survey-editor/registry/types.d.ts

@@ -50,14 +50,6 @@ export interface ItemInfos {
     icon: ItemIconComponent;
     labelByLocale: ItemLocaleMap;
     descriptionByLocale: ItemLocaleMap;
-    /**
-     * Optional recommendation shown when an author opens an empty survey preview.
-     * Entries are ordered by rank, allowing host registries to curate a simple first-step menu.
-     */
-    gettingStarted?: {
-        rank: number;
-        descriptionByLocale?: ItemLocaleMap;
-    };
     defaultItemClassName?: string;
     categories: ItemCategory[];
 }
@@ -91,16 +83,40 @@ export interface EditorItemDefinition {
     createItem?: (ctx: CreateItemContext) => string;
     searchAdapters?: ItemSearchAdapter[];
     includeDefaultSearchAdapter?: boolean;
+    addItemPresets?: AddItemPreset[];
 }
 /** Context available when the editor creates an item from a registry entry. */
 export interface ItemInitialDataContext {
     /** The language currently selected in the editor. */
     locale: string;
 }
+/** A named, author-facing way to create an item. */
+export interface AddItemPreset {
+    /** Globally stable catalog identity, for example `choice.single`. */
+    id: string;
+    labelByLocale: ItemLocaleMap;
+    descriptionByLocale: ItemLocaleMap;
+    icon?: ItemIconComponent;
+    defaultItemClassName?: string;
+    categories?: ItemCategory[];
+    defaultItemKeyPrefix?: string;
+    /** Omit to make this preset available only in the full Add item catalog. */
+    recommendation?: {
+        rank: number;
+        descriptionByLocale?: ItemLocaleMap;
+    };
+    getInitialItem: (context?: ItemInitialDataContext) => ItemInitialData;
+}
+/** A preset after it has been associated with its registry item's persisted type. */
+export interface ResolvedAddItemPreset extends AddItemPreset {
+    itemType: string;
+}
 export type EditorItemDefinitionRegistry = Record<string, EditorItemDefinition>;
 export interface ComposedEditorItemRegistry {
     coreRegistry: ItemTypeRegistry;
     definitions: EditorItemDefinitionRegistry;
+    /** All author-creatable catalog entries, resolved from registry item presets. */
+    addItemPresets?: ResolvedAddItemPreset[];
     /** Validated assistant capabilities, composed once with the registry. */
     assistantCapabilities: SurveyAssistantCapabilitySet;
     playerLocalizations: LocalizationCatalog;
@@ -150,6 +166,8 @@ export interface ItemRegistryEntry {
     getInitialItem?: (context?: ItemInitialDataContext) => ItemInitialData;
     /** Editor-only: custom creation flow (advanced) */
     createItem?: (ctx: CreateItemContext) => string;
+    /** Editor-only: author-facing creation presets. Without one, this item cannot be added. */
+    addItemPresets?: AddItemPreset[];
     /** Editor-only: hide from add-item options in non-root context */
     isRootOnly?: boolean;
 }

package/dist/src/modules/survey-editor/routes/editor/_components/editor-assistant-slot-context.d.ts

@@ -1,6 +1,14 @@
+import { SurveyAssistantThreadLauncher } from '@case-framework/survey-assistant/react';
 export interface EditorAssistantSlotContextValue {
     available: boolean;
+    threadLauncher?: SurveyAssistantThreadLauncher;
+    openPanel: () => void;
+    setOpenPanel: (openPanel: (() => void) | null) => void;
     setTarget: (target: HTMLDivElement | null) => void;
 }
 export declare const EditorAssistantSlotContext: import('react').Context<EditorAssistantSlotContextValue>;
 export declare const useEditorAssistantPanelAvailable: () => boolean;
+export declare const useEditorAssistantThreadLauncher: () => {
+    openPanel: () => void;
+    threadLauncher: SurveyAssistantThreadLauncher;
+} | null;

package/dist/src/modules/survey-editor/routes/editor/_components/editor-assistant-slot.d.ts

@@ -1,8 +1,12 @@
 import { ReactNode } from 'react';
+import { SurveyAssistantThreadLauncher } from '@case-framework/survey-assistant/react';
 interface EditorAssistantPanelProviderProps {
     children: ReactNode;
     panel?: ReactNode;
+    threadLauncher?: SurveyAssistantThreadLauncher;
 }
-export declare const EditorAssistantPanelProvider: ({ children, panel, }: EditorAssistantPanelProviderProps) => import("react/jsx-runtime").JSX.Element;
-export declare const EditorAssistantPanelSlot: () => import("react/jsx-runtime").JSX.Element;
+export declare const EditorAssistantPanelProvider: ({ children, panel, threadLauncher, }: EditorAssistantPanelProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const EditorAssistantPanelSlot: ({ openPanel }: {
+    openPanel?: () => void;
+}) => import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -3,6 +3,7 @@ import { SerializedSurveyEditor } from '@case-framework/survey-core/editor';
 import { EditorStateChangePayload } from './hooks/useEditorStateChange';
 import { SurveyEditorNavigationAdapter } from './navigation/types';
 import { SurveyEditorAssistantController } from './assistant';
+import { SurveyAssistantThreadLauncher } from '@case-framework/survey-assistant/react';
 import { ItemCategory, ItemLocaleMap, ItemRegistryEntry } from './registry';
 import { SurveyEditorAIProvider } from './ai/types';
 import { LocalizationCatalog } from '@case-framework/ui-localization';
@@ -26,6 +27,8 @@ export interface SurveyEditorProps {
     assistantControllerRef?: React.Ref<SurveyEditorAssistantController | null>;
     /** Optional host-rendered assistant UI shown in the editor workspace. */
     assistantPanel?: ReactNode;
+    /** Allows editor surfaces to create a new assistant thread and submit its first prompt. */
+    assistantThreadLauncher?: SurveyAssistantThreadLauncher;
     persistDebounceMs?: number;
     helpLink?: string;
     navigationAdapter?: SurveyEditorNavigationAdapter | null;