@case-framework/survey-editor-ui 0.1.1

package/README.md

@@ -0,0 +1,90 @@
+# @case-framework/survey-editor-ui
+
+Authoring UI for CASE surveys, including the `SurveyEditor`. Participant-facing
+rendering is provided by the package dependency `@case-framework/survey-ui`.
+
+For repository development and custom item registration, see
+[Custom survey items](https://github.com/case-framework/case-survey-toolkit/blob/main/packages/survey-editor-ui/docs/custom-items.md).
+
+## SurveyEditor styling in a host project
+
+### Tailwind CSS v4 / shadcn host
+
+Do not import the complete `@case-framework/survey-ui/css` or
+`@case-framework/survey-editor-ui/css` assets in a standard shadcn application.
+Those generated stylesheets contain their own Tailwind base layer and global
+theme variables, which can collide with the host's Preflight, `:root`, `.dark`,
+and semantic tokens.
+
+Register both packages in the host's existing global stylesheet instead:
+
+```css
+@import "tailwindcss";
+@import "tw-animate-css";
+@import "shadcn/tailwind.css";
+
+@source "../node_modules/@case-framework/survey-ui/dist";
+@source "../node_modules/@case-framework/survey-editor-ui/dist";
+```
+
+The paths are relative to the stylesheet containing `@source`; adjust them for
+the host's directory layout. Both sources are necessary because the editor
+contains participant previews implemented by `@case-framework/survey-ui`.
+
+Import only the editor-specific, namespaced additions once in the application
+entry point:
+
+```tsx
+import "@case-framework/survey-editor-ui/editor-defaults.css";
+import "@case-framework/survey-editor-ui/editor-animations.css";
+```
+
+These assets use `survey-editor-*` selectors and `.survey-editor`-scoped
+variables. They do not define the host's global shadcn theme.
+
+Override the editor-specific CSS variables on the `.survey-editor` scope in the host stylesheet:
+
+```css
+.survey-editor {
+  --surface-bg-color: oklch(1 0 0);
+}
+```
+
+Available editor-scoped variables:
+
+- `--surface-bg-color`
+
+The editor uses the host's shared shadcn theme tokens, including `--background`,
+`--foreground`, `--card`, `--primary`, `--muted`, `--accent`, `--border`,
+`--input`, and `--ring`. Set those in the host theme as usual to make the editor
+chrome match the application.
+
+### Standalone/non-Tailwind host
+
+The complete precompiled assets remain available:
+
+```tsx
+import "@case-framework/survey-ui/css";
+import "@case-framework/survey-editor-ui/css";
+```
+
+They are application-level stylesheets, not isolated component styles. Import
+each only once. They currently include global theme and base rules, so review
+their cascade before combining them with another CSS framework or design
+system.
+
+## Sources
+
+- [Tailwind: detecting classes in source files](https://tailwindcss.com/docs/detecting-classes-in-source-files#explicitly-registering-sources)
+  documents `@source` for external component libraries and explains why
+  dependencies are not scanned automatically.
+- [Tailwind: Preflight](https://tailwindcss.com/docs/preflight) documents the
+  global base styles included by `@import "tailwindcss"`.
+- [shadcn: theming](https://ui.shadcn.com/docs/theming) recommends application-owned
+  semantic CSS variables.
+- [shadcn: Tailwind v4](https://ui.shadcn.com/docs/tailwind-v4) documents the
+  `@theme inline`, `:root`, and `.dark` arrangement used by shadcn hosts.
+- [shadcn: monorepo](https://ui.shadcn.com/docs/monorepo) demonstrates that the
+  shared UI stylesheet and theme configuration belong to the consuming
+  workspace rather than being independently repeated by every component
+  package.

package/dist/item-core-registry.cjs.js

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`./survey-editor-ui.cjs.js`);let e=require(`@case-framework/survey-ui`);var t={choiceItem:e.ChoiceItemCore,formItem:e.FormItemCore,infoItem:e.InfoItemCore};exports.ChoiceItemCore=e.ChoiceItemCore,exports.FormItemCore=e.FormItemCore,exports.InfoItemCore=e.InfoItemCore,exports.defaultItemCoreRegistry=t;
+//# sourceMappingURL=item-core-registry.cjs.js.map

package/dist/item-core-registry.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-core-registry.cjs.js","names":[],"sources":["../src/item-core-registry.ts"],"sourcesContent":["import type { ItemTypeRegistry } from \"@case-framework/survey-core\";\nimport { ChoiceItemCore, FormItemCore, InfoItemCore } from \"@case-framework/survey-ui\";\n\nexport const defaultItemCoreRegistry: ItemTypeRegistry = {\n  choiceItem: ChoiceItemCore,\n  formItem: FormItemCore,\n  infoItem: InfoItemCore,\n};\n\nexport { ChoiceItemCore, FormItemCore, InfoItemCore };\n"],"mappings":"mJAGA,IAAa,EAA4C,CACvD,WAAY,EAAA,eACZ,SAAU,EAAA,aACV,SAAU,EAAA,aACX"}

package/dist/item-core-registry.es.js

@@ -0,0 +1,11 @@
+import { ChoiceItemCore as e, FormItemCore as t, InfoItemCore as n } from "@case-framework/survey-ui";
+//#region src/item-core-registry.ts
+var r = {
+	choiceItem: e,
+	formItem: t,
+	infoItem: n
+};
+//#endregion
+export { e as ChoiceItemCore, t as FormItemCore, n as InfoItemCore, r as defaultItemCoreRegistry };
+
+//# sourceMappingURL=item-core-registry.es.js.map

package/dist/item-core-registry.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-core-registry.es.js","names":[],"sources":["../src/item-core-registry.ts"],"sourcesContent":["import type { ItemTypeRegistry } from \"@case-framework/survey-core\";\nimport { ChoiceItemCore, FormItemCore, InfoItemCore } from \"@case-framework/survey-ui\";\n\nexport const defaultItemCoreRegistry: ItemTypeRegistry = {\n  choiceItem: ChoiceItemCore,\n  formItem: FormItemCore,\n  infoItem: InfoItemCore,\n};\n\nexport { ChoiceItemCore, FormItemCore, InfoItemCore };\n"],"mappings":";;AAGA,IAAa,IAA4C;CACvD,YAAY;CACZ,UAAU;CACV,UAAU;CACX"}

package/dist/src/components/c-ui/alert-provider.d.ts

@@ -0,0 +1,18 @@
+import { ComponentProps, ReactNode } from 'react';
+import { AlertDialogCancel } from '../../../components/ui/alert-dialog';
+export interface AlertOptions {
+    title?: string;
+    description?: string;
+    buttonLabel?: string;
+    dismissButtonClassName?: string;
+    dismissButtonVariant?: ComponentProps<typeof AlertDialogCancel>["variant"];
+    children?: ReactNode;
+}
+export interface AlertApi {
+    (options: AlertOptions): Promise<void>;
+    dismiss: () => void;
+}
+export declare const AlertDialogProvider: ({ children }: {
+    children: ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const useAlert: () => AlertApi;

package/dist/src/components/c-ui/confirm-dialog.d.ts

@@ -0,0 +1,19 @@
+export interface RequireConfirmationInput {
+    confirmTerm: string;
+    /** Custom label with {{confirmTerm}} placeholder for the required term (bold). Default: "Type {{confirmTerm}} to confirm" */
+    label?: string;
+    hint?: string;
+}
+interface ConfirmDialogProps {
+    title: string;
+    description: string;
+    confirmButtonText: string;
+    cancelButtonText: string;
+    onConfirm: () => void;
+    onCancel: () => void;
+    variant: "default" | "destructive";
+    isOpen: boolean;
+    requireConfirmationInput?: RequireConfirmationInput;
+}
+declare const ConfirmDialog: (props: ConfirmDialogProps) => import("react/jsx-runtime").JSX.Element;
+export default ConfirmDialog;

package/dist/src/components/c-ui/confirm-provider.d.ts

@@ -0,0 +1,15 @@
+import { ReactNode } from 'react';
+import { RequireConfirmationInput } from './confirm-dialog';
+export type { RequireConfirmationInput };
+interface ConfirmOptions {
+    title?: string;
+    description?: string;
+    confirmButtonText?: string;
+    cancelButtonText?: string;
+    variant?: "default" | "destructive";
+    requireConfirmationInput?: RequireConfirmationInput;
+}
+export declare const ConfirmDialogProvider: ({ children }: {
+    children: ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const useConfirm: () => (options: ConfirmOptions) => Promise<boolean>;

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

@@ -0,0 +1,72 @@
+import * as React from "react";
+declare const dotBackgroundColorVariants: {
+    readonly default: {
+        readonly backgroundColor: "var(--background)";
+        readonly dotColor: "var(--border)";
+    };
+    readonly muted: {
+        readonly backgroundColor: "var(--muted)";
+        readonly dotColor: "color-mix(in oklab, var(--muted-foreground) 24%, transparent)";
+    };
+    readonly card: {
+        readonly backgroundColor: "var(--card)";
+        readonly dotColor: "color-mix(in oklab, var(--border) 90%, transparent)";
+    };
+    readonly accent: {
+        readonly backgroundColor: "var(--accent)";
+        readonly dotColor: "color-mix(in oklab, var(--accent-foreground) 18%, transparent)";
+    };
+    readonly secondary: {
+        readonly backgroundColor: "var(--secondary)";
+        readonly dotColor: "color-mix(in oklab, var(--secondary-foreground) 16%, transparent)";
+    };
+    readonly custom: {
+        readonly backgroundColor: "var(--background)";
+        readonly dotColor: "var(--border)";
+    };
+};
+declare const dotBackgroundSpacingVariants: {
+    readonly dense: {
+        readonly spacing: "0.875rem";
+    };
+    readonly default: {
+        readonly spacing: "1.25rem";
+    };
+    readonly relaxed: {
+        readonly spacing: "1.75rem";
+    };
+    readonly loose: {
+        readonly spacing: "2.25rem";
+    };
+    readonly custom: {
+        readonly spacing: "1.25rem";
+    };
+};
+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;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+type DotBackgroundStyle = React.CSSProperties & {
+    "--dot-background-color"?: string;
+    "--dot-background-dot-color"?: string;
+    "--dot-background-spacing"?: string;
+    "--dot-background-dot-size"?: string;
+};
+type DotBackgroundVars = {
+    backgroundColor?: string;
+    dotColor?: string;
+    spacing?: number | string;
+    dotSize?: number | string;
+};
+type DotBackgroundProps = Omit<React.ComponentProps<"div">, "style"> & {
+    asChild?: boolean;
+    variant?: DotBackgroundVariant;
+    spacing?: DotBackgroundSpacingVariant;
+    vars?: DotBackgroundVars;
+    style?: DotBackgroundStyle;
+};
+declare function DotBackground({ asChild, variant, spacing, vars, className, style, ...props }: DotBackgroundProps): import("react/jsx-runtime").JSX.Element;
+export { DotBackground, dotBackgroundColorVariants, dotBackgroundSpacingVariants, dotBackgroundVariants, };
+export type { DotBackgroundProps, DotBackgroundSpacingVariant, DotBackgroundStyle, DotBackgroundVariant, DotBackgroundVars, };

package/dist/src/components/c-ui/filepicker-dropzone.d.ts

@@ -0,0 +1,38 @@
+import { Accept, FileRejection, FileWithPath } from 'react-dropzone';
+import { Field } from '../../../components/ui/field';
+export interface FilepickerDropzoneLabels {
+    upload: string;
+    drag: string;
+    active: string;
+    reject: string;
+    rejectInvalidType: string;
+    rejectTooLarge: string;
+    rejectTooSmall: string;
+    rejectTooMany: string;
+    selectedCount: string;
+}
+export interface FilepickerDropzoneProps extends Omit<React.ComponentProps<typeof Field>, "children" | "onChange"> {
+    id: string;
+    name?: string;
+    label?: React.ReactNode;
+    description?: React.ReactNode;
+    error?: React.ReactNode;
+    accept?: Accept;
+    multiple?: boolean;
+    disabled?: boolean;
+    required?: boolean;
+    maxFiles?: number;
+    maxSize?: number;
+    minSize?: number;
+    icon?: React.ReactNode;
+    labelClassName?: string;
+    contentClassName?: string;
+    descriptionClassName?: string;
+    errorClassName?: string;
+    dropzoneClassName?: string;
+    labels?: Partial<FilepickerDropzoneLabels>;
+    onChange?: (files: readonly FileWithPath[]) => void;
+    onDropRejected?: (fileRejections: FileRejection[]) => void;
+}
+declare function FilepickerDropzone({ id, name, label, description, error, accept, multiple, disabled, required, maxFiles, maxSize, minSize, icon, className, labelClassName, contentClassName, descriptionClassName, errorClassName, dropzoneClassName, labels, onChange, onDropRejected, ...props }: FilepickerDropzoneProps): import("react/jsx-runtime").JSX.Element;
+export { FilepickerDropzone };

package/dist/src/components/c-ui/loading-button.d.ts

@@ -0,0 +1,9 @@
+import { buttonVariants } from '../../../components/ui/button';
+import { VariantProps } from 'class-variance-authority';
+import * as React from "react";
+type LoadingButtonProps = React.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {
+    asChild?: boolean;
+    isLoading?: boolean;
+};
+declare const LoadingButton: React.ForwardRefExoticComponent<Omit<LoadingButtonProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export { LoadingButton };

package/dist/src/components/common/content-editable-plain.d.ts

@@ -0,0 +1,17 @@
+import { KeyboardEvent } from 'react';
+export interface ContentEditablePlainProps {
+    id: string;
+    value: string;
+    placeholder?: string;
+    className?: string;
+    "aria-label"?: string;
+    onChange: (next: string) => void;
+    onFocus?: () => void;
+    onBlur?: () => void;
+    onKeyDown?: (event: KeyboardEvent<HTMLDivElement>) => void;
+}
+/**
+ * Plain-text contenteditable: line breaks allowed, paste stripped to text only.
+ * Syncs `value` from props only while unfocused to avoid clobbering the caret.
+ */
+export declare function ContentEditablePlain({ id, value, placeholder, className, "aria-label": ariaLabel, onChange, onFocus, onBlur, onKeyDown, }: ContentEditablePlainProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/common/sortable-tree.d.ts

@@ -0,0 +1,59 @@
+import { ReactNode } from 'react';
+export interface SortableTreePosition {
+    parentId: string;
+    index: number;
+}
+export interface SortableTreeMoveEvent<T> {
+    id: string;
+    item: T;
+    from: SortableTreePosition;
+    to: SortableTreePosition;
+}
+export interface SortableTreeDropEvent<T> extends SortableTreeMoveEvent<T> {
+    parent: T | null;
+}
+export type SortableTreeDropPosition = "before" | "inside" | "after";
+export interface SortableTreeRenderItemProps<T> {
+    item: T;
+    id: string;
+    parentId: string;
+    index: number;
+    depth: number;
+    indent: number;
+    isBranch: boolean;
+    isExpanded: boolean;
+    isDragging: boolean;
+    isDropTarget: boolean;
+    isDropParent: boolean;
+    dropPosition: SortableTreeDropPosition | null;
+    dropDepth: number | null;
+    isOverlay: boolean;
+    dragHandleRef: (element: Element | null) => void;
+    toggleExpanded: () => void;
+}
+export interface SortableTreeEmptyGroupProps<T> {
+    parent: T | null;
+    parentId: string;
+    depth: number;
+    indent: number;
+}
+export interface SortableTreeProps<T> {
+    items: readonly T[];
+    rootId: string;
+    getId: (item: T) => string;
+    getChildren: (item: T) => readonly T[];
+    renderItem: (props: SortableTreeRenderItemProps<T>) => ReactNode;
+    onMove: (event: SortableTreeMoveEvent<T>) => void;
+    isBranch?: (item: T) => boolean;
+    canDrag?: (item: T) => boolean;
+    canDrop?: (event: SortableTreeDropEvent<T>) => boolean;
+    expandedIds?: ReadonlySet<string>;
+    defaultExpandedIds?: Iterable<string>;
+    onExpandedChange?: (id: string, expanded: boolean) => void;
+    renderEmptyGroup?: (props: SortableTreeEmptyGroupProps<T>) => ReactNode;
+    ariaLabel?: string;
+    indent?: number;
+    className?: string;
+    levelClassName?: string;
+}
+export declare function SortableTree<T>({ items, rootId, getId, getChildren, renderItem, onMove, isBranch, canDrag, canDrop, expandedIds, defaultExpandedIds, onExpandedChange, renderEmptyGroup, ariaLabel, indent, className, levelClassName, }: SortableTreeProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/hooks/use-button-shortcut.d.ts

@@ -0,0 +1,18 @@
+export interface ButtonShortcutDefinition {
+    key: string;
+    modKey?: boolean;
+    metaKey?: boolean;
+    ctrlKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+}
+interface UseButtonShortcutOptions {
+    enabled?: boolean;
+    activeDurationMs?: number;
+    preventDefault?: boolean;
+    ignoreEditableTargets?: boolean;
+}
+export declare const useButtonShortcut: (ref: React.RefObject<HTMLButtonElement | null>, shortcut: ButtonShortcutDefinition, { enabled, activeDurationMs, preventDefault, ignoreEditableTargets, }?: UseButtonShortcutOptions) => {
+    isShortcutActive: boolean;
+};
+export {};

package/dist/src/components/hooks/use-document-keydown.d.ts

@@ -0,0 +1,7 @@
+export declare const isEditableKeyboardTarget: (target: EventTarget | null) => boolean;
+interface UseDocumentKeydownOptions {
+    enabled?: boolean;
+    ignoreEditableTargets?: boolean;
+}
+export declare const useDocumentKeydown: (onKeyDown: (event: KeyboardEvent) => void, { enabled, ignoreEditableTargets }?: UseDocumentKeydownOptions) => void;
+export {};

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

@@ -0,0 +1,19 @@
+import { Content, 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;
+export interface RichTextContentPolicy {
+    variant?: RichTextEditorVariant;
+    allowedBlockTypes?: Partial<Record<RichTextSupportedBlockType, boolean>>;
+    allowedStyleAttributes?: Partial<Record<RichTextStyleAttribute, boolean>>;
+    allowLinks?: boolean;
+    allowTemplateVariables?: boolean;
+    allowLineBreaks?: boolean;
+    /** When true, paragraph/heading/list-paragraph alignment may be edited and persisted. */
+    allowBlockAlignment?: boolean;
+}
+export declare const DEFAULT_COMPACT_CONTENT_POLICY: RichTextContentPolicy;
+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;

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

@@ -0,0 +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 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/nodes/rich-text-image-node.d.ts

@@ -0,0 +1,40 @@
+import { RichTextImageSize, SurveyContentImageSource } from '@case-framework/survey-core';
+import { DecoratorBlockNode, SerializedDecoratorBlockNode } from '@lexical/react/LexicalDecoratorBlockNode';
+import { ElementFormatType, LexicalNode, LexicalUpdateJSON, NodeKey, Spread } from 'lexical';
+import { JSX } from 'react';
+export type SerializedRichTextImageNode = Spread<{
+    source: SurveyContentImageSource;
+    alt?: string;
+    caption?: string;
+    size?: RichTextImageSize;
+}, SerializedDecoratorBlockNode>;
+export declare class RichTextImageNode extends DecoratorBlockNode {
+    __source: SurveyContentImageSource;
+    __alt?: string;
+    __caption: string;
+    __size?: RichTextImageSize;
+    static getType(): string;
+    static clone(node: RichTextImageNode): RichTextImageNode;
+    static importJSON(serializedNode: SerializedRichTextImageNode): RichTextImageNode;
+    constructor(source: SurveyContentImageSource, alt?: string, size?: RichTextImageSize, caption?: string, format?: SerializedDecoratorBlockNode["format"], key?: NodeKey);
+    updateFromJSON(serializedNode: LexicalUpdateJSON<SerializedRichTextImageNode>): this;
+    exportJSON(): SerializedRichTextImageNode;
+    getSource(): SurveyContentImageSource;
+    getAlt(): string | undefined;
+    getCaption(): string;
+    getSize(): RichTextImageSize | undefined;
+    setSource(source: SurveyContentImageSource): this;
+    setAlt(alt: string | undefined): this;
+    setCaption(caption: string): this;
+    setSize(size: RichTextImageSize | undefined): this;
+    decorate(): JSX.Element;
+}
+export declare function $createRichTextImageNode({ source, alt, size, caption, format, key, }: {
+    source: SurveyContentImageSource;
+    alt?: string;
+    size?: RichTextImageSize;
+    caption?: string;
+    format?: ElementFormatType;
+    key?: NodeKey;
+}): RichTextImageNode;
+export declare function $isRichTextImageNode(node: LexicalNode | null | undefined): node is RichTextImageNode;

package/dist/src/components/rich-text/nodes/rich-text-info-box-node.d.ts

@@ -0,0 +1,45 @@
+import { RichTextInfoBoxBlock } from '@case-framework/survey-core';
+import { DecoratorBlockNode, SerializedDecoratorBlockNode } from '@lexical/react/LexicalDecoratorBlockNode';
+import { LexicalNode, LexicalUpdateJSON, NodeKey, Spread } from 'lexical';
+import { JSX } from 'react';
+export type RichTextInfoBoxTone = NonNullable<RichTextInfoBoxBlock["tone"]>;
+export type SerializedRichTextInfoBoxNode = Spread<{
+    tone: RichTextInfoBoxTone;
+    title: string;
+    content: string;
+    collapsible: boolean;
+    defaultOpen: boolean;
+}, SerializedDecoratorBlockNode>;
+export declare class RichTextInfoBoxNode extends DecoratorBlockNode {
+    __tone: RichTextInfoBoxTone;
+    __title: string;
+    __content: string;
+    __collapsible: boolean;
+    __defaultOpen: boolean;
+    static getType(): string;
+    static clone(node: RichTextInfoBoxNode): RichTextInfoBoxNode;
+    static importJSON(serializedNode: SerializedRichTextInfoBoxNode): RichTextInfoBoxNode;
+    constructor(tone: RichTextInfoBoxTone, title: string, content: string, collapsible: boolean, defaultOpen: boolean, key?: NodeKey);
+    updateFromJSON(serializedNode: LexicalUpdateJSON<SerializedRichTextInfoBoxNode>): this;
+    exportJSON(): SerializedRichTextInfoBoxNode;
+    getTone(): RichTextInfoBoxTone;
+    setTone(tone: RichTextInfoBoxTone): void;
+    getTitle(): string;
+    setTitle(title: string): void;
+    getContent(): string;
+    setContent(content: string): void;
+    getCollapsible(): boolean;
+    setCollapsible(collapsible: boolean): void;
+    getDefaultOpen(): boolean;
+    setDefaultOpen(defaultOpen: boolean): void;
+    decorate(): JSX.Element;
+}
+export declare function $createRichTextInfoBoxNode({ tone, title, content, collapsible, defaultOpen, key, }: {
+    tone?: RichTextInfoBoxTone;
+    title?: string;
+    content?: string;
+    collapsible?: boolean;
+    defaultOpen?: boolean;
+    key?: NodeKey;
+}): RichTextInfoBoxNode;
+export declare function $isRichTextInfoBoxNode(node: LexicalNode | null | undefined): node is RichTextInfoBoxNode;

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

@@ -0,0 +1,27 @@
+import { RichTextHeadingBlock } from '@case-framework/survey-core';
+import { ParagraphNode, DOMConversionMap, EditorConfig, LexicalEditor, LexicalNode, RangeSelection, SerializedParagraphNode, Spread } from 'lexical';
+export type SerializedSurveyRichTextHeadingNode = Spread<{
+    level: RichTextHeadingBlock["level"];
+}, SerializedParagraphNode>;
+/** Block editor node for survey rich-text headings; serializes to core `heading` blocks. */
+export declare class SurveyRichTextHeadingNode extends ParagraphNode {
+    /** @internal */
+    __level: RichTextHeadingBlock["level"];
+    static getType(): string;
+    static clone(node: SurveyRichTextHeadingNode): SurveyRichTextHeadingNode;
+    constructor(level?: RichTextHeadingBlock["level"], key?: string);
+    getHeadingLevel(): RichTextHeadingBlock["level"];
+    createDOM(config: EditorConfig): HTMLElement;
+    updateDOM(prevNode: SurveyRichTextHeadingNode): boolean;
+    static importDOM(): DOMConversionMap | null;
+    exportDOM(editor: LexicalEditor): {
+        element: HTMLElement;
+    };
+    static importJSON(serializedNode: SerializedSurveyRichTextHeadingNode): SurveyRichTextHeadingNode;
+    exportJSON(): SerializedSurveyRichTextHeadingNode;
+    /** Backspace at block start: replace heading with a paragraph (same children and block styles). */
+    collapseAtStart(): boolean;
+    insertNewAfter(rangeSelection: RangeSelection, restoreSelection?: boolean): ParagraphNode;
+}
+export declare function $createSurveyRichTextHeadingNode(level?: RichTextHeadingBlock["level"]): SurveyRichTextHeadingNode;
+export declare function $isSurveyRichTextHeadingNode(node: LexicalNode | null | undefined): node is SurveyRichTextHeadingNode;

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

@@ -0,0 +1,8 @@
+import { RichTextEditorChange, RichTextEditorProps } from '../rich-text-editor/rich-text-editor';
+import { RichTextImageAssetOption } from './types';
+export type RichTextBlockEditorChange = RichTextEditorChange;
+export interface RichTextBlockEditorProps extends RichTextEditorProps {
+    resolveImageAssetUrl?: (assetId: string) => string | undefined;
+    imageAssets?: RichTextImageAssetOption[];
+}
+export declare function RichTextBlockEditor({ wrapperClassName, surfaceClassName, contentClassName, placeholderClassName, ...props }: RichTextBlockEditorProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,15 @@
+import { Content, RichTextHeadingBlock } from '@case-framework/survey-core';
+export interface RichTextContentViewProps {
+    content?: Content;
+    className?: string;
+    paragraphClassName?: string;
+    resolveImageAssetUrl?: (assetId: string) => string | undefined;
+    singleLine?: boolean;
+    /** Rendered at each line break when `singleLine` is true. */
+    singleLineNewlineIndicator?: string;
+    /** Minimum semantic heading level to render. Use this to avoid nested rich text creating page-level h1s. */
+    minHeadingLevel?: RichTextHeadingBlock["level"];
+    /** Semantic level offset applied before clamping. For example, 1 renders stored h1/h2 as h2/h3. */
+    headingLevelOffset?: number;
+}
+export declare function RichTextContentView({ content, className, paragraphClassName, resolveImageAssetUrl, singleLine, singleLineNewlineIndicator, minHeadingLevel, headingLevelOffset, }: RichTextContentViewProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,23 @@
+import { RichTextContentPolicy } from './content-policy';
+import { RichTextImageAssetOption } from './types';
+export interface RichTextImageAssetDeletionHandlers {
+    /** Total references to this asset across the survey (from committed content), per `Survey.getAssetUsages`. */
+    getUsageCount(assetId: string): number;
+    removeAsset(assetId: string): void;
+}
+interface RichTextEditorContextValue {
+    editorVariant: "compact" | "block";
+    contentPolicy?: RichTextContentPolicy;
+    editable: boolean;
+    resolveImageAssetUrl?: (assetId: string) => string | undefined;
+    imageAssets?: RichTextImageAssetOption[];
+    registerImageAsset?: (file: File) => Promise<string>;
+    /** When set, removing a local image with a single survey-wide reference can prompt to delete the embedded asset. */
+    imageAssetDeletion?: RichTextImageAssetDeletionHandlers;
+}
+export declare function RichTextEditorContextProvider({ value, children, }: {
+    value: RichTextEditorContextValue;
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useRichTextEditorContext(): RichTextEditorContextValue;
+export {};

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

@@ -0,0 +1 @@
+export { DEFAULT_RICH_TEXT_LINK_URL, sanitizeRichTextLinkUrl } from '../../../lib/rich-text-link-url';

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

@@ -0,0 +1,7 @@
+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 declare function createRichTextEditorValueFromContent(content?: Content, policy?: RichTextContentPolicy): SerializedEditorState;
+export declare function createRichTextEditorValueFromText(text?: string, policy?: RichTextContentPolicy): SerializedEditorState;

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

@@ -0,0 +1,6 @@
+export interface RichTextImageAssetOption {
+    assetId: string;
+    label: string;
+    alt?: string;
+    previewUrl?: string;
+}

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

@@ -0,0 +1,3 @@
+export { RichTextEditor, type RichTextEditorChange, type RichTextEditorProps, } from './rich-text-editor';
+export { APPLY_RICH_TEXT_STYLE_COMMAND, CONVERT_RICH_TEXT_LINK_TO_TEXT_COMMAND, INSERT_RICH_TEXT_LINK_COMMAND, INSERT_RICH_TEXT_TEMPLATE_VARIABLE_COMMAND, RichTextLinkNode, OPEN_RICH_TEXT_LINK_EDITOR_COMMAND, TemplateVariableNode, UPDATE_RICH_TEXT_LINK_COMMAND, createRichTextEditorValueFromPlainText, } from './rich-text-editor-utils';
+export type { RichTextLinkPayload, RichTextStyleControl, RichTextTemplateVariable, SerializedRichTextLinkNode, SerializedTemplateVariableNode, } from './rich-text-editor-utils';

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

@@ -0,0 +1,5 @@
+export interface CommandHandlerPluginProps {
+    /** When true, registers Lexical's horizontal rule insert command (block editor only). */
+    horizontalRuleCommandEnabled?: boolean;
+}
+export declare function CommandHandlerPlugin({ horizontalRuleCommandEnabled, }: CommandHandlerPluginProps): null;

package/dist/src/components/rich-text-editor/plugins/editable-mode-plugin.d.ts

@@ -0,0 +1,3 @@
+export declare function EditableModePlugin({ editable }: {
+    editable: boolean;
+}): null;

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

@@ -0,0 +1,11 @@
+import { RefObject } from 'react';
+import { RichTextStyleControl, RichTextTemplateVariable } from '../rich-text-editor-utils';
+export declare function FloatingToolbarPlugin({ editable, linksEnabled, blockAlignmentEnabled, surfaceRef, toolbarClassName, styleControls, templateVariables, }: {
+    editable: boolean;
+    linksEnabled: boolean;
+    blockAlignmentEnabled: boolean;
+    surfaceRef: RefObject<HTMLDivElement | null>;
+    toolbarClassName?: string;
+    styleControls: RichTextStyleControl[];
+    templateVariables: RichTextTemplateVariable[];
+}): import("react/jsx-runtime").JSX.Element | null;