@nice2dev/ui 1.0.21 → 1.0.22

package/dist/index.d.ts

@@ -130,7 +130,7 @@ import { ICUValues } from '@nice2dev/ui-core';
 import { IndexedDBAdapter } from '@nice2dev/ui-core';
 import { InputStyleVariant } from '@nice2dev/ui-core';
 import { ITracelessPolicy } from '@nice2dev/ui-core';
-import { JSX as JSX_2 } from 'react/jsx-runtime';
+import { JSX as JSX_2 } from 'react';
 import { KeyboardShortcut } from '@nice2dev/ui-core';
 import { LayoutPreferences } from '@nice2dev/ui-core';
 import { LeakDetectorConfig } from '@nice2dev/ui-core';
@@ -178,6 +178,7 @@ import { NiceBreakpoints } from '@nice2dev/ui-core';
 import { NiceCacheConfig } from '@nice2dev/ui-core';
 import { NiceChangeMeta } from '@nice2dev/ui-core';
 import { NiceChangeReason } from '@nice2dev/ui-core';
+import { NiceComponentTutorial } from '@nice2dev/ui-core';
 import { NiceComponentType } from '@nice2dev/ui-core';
 import { NiceCrossTabSyncConfig } from '@nice2dev/ui-core';
 import { NiceCursorLoadOptions } from '@nice2dev/ui-core';
@@ -258,6 +259,7 @@ import { niceReduxActions } from '@nice2dev/ui-core';
 import { NiceReduxMiddlewareConfig } from '@nice2dev/ui-core';
 import { niceReduxReducer } from '@nice2dev/ui-core';
 import { NiceRequestDeduplicator } from '@nice2dev/ui-core';
+import { NiceResolvedTutorialStep } from '@nice2dev/ui-core';
 import { NiceResponsiveValue } from '@nice2dev/ui-core';
 import { NiceRestConfig } from '@nice2dev/ui-core';
 import { NiceRTLConfig } from '@nice2dev/ui-core';
@@ -317,6 +319,11 @@ import { NiceTone } from '@nice2dev/ui-core';
 import { NiceTouchTarget } from '@nice2dev/ui-core';
 import { NiceTransitionState } from '@nice2dev/ui-core';
 import { NiceTranslateFn } from '@nice2dev/ui-core';
+import { NiceTutorialButton } from '@nice2dev/ui-core';
+import { NiceTutorialButtonProps } from '@nice2dev/ui-core';
+import { NiceTutorialsContextValue } from '@nice2dev/ui-core';
+import { NiceTutorialsProvider } from '@nice2dev/ui-core';
+import { NiceTutorialStepDef } from '@nice2dev/ui-core';
 import { NiceURLState } from '@nice2dev/ui-core';
 import { NiceURLStateConfig } from '@nice2dev/ui-core';
 import { NiceUserMenuResponse } from '@nice2dev/ui-core';
@@ -358,7 +365,9 @@ import { removeTheme } from '@nice2dev/ui-core';
 import { RenderStats } from '@nice2dev/ui-core';
 import { RenderTiming } from '@nice2dev/ui-core';
 import { resolveDisplayStyleConfig } from '@nice2dev/ui-core';
+import { resolveStepsI18n } from '@nice2dev/ui-core';
 import { resolveTracelessPolicy } from '@nice2dev/ui-core';
+import { resolveTutorial } from '@nice2dev/ui-core';
 import { RestAPISyncAdapter } from '@nice2dev/ui-core';
 import { SafeAreaInsets } from '@nice2dev/ui-core';
 import { saveBaseline } from '@nice2dev/ui-core';
@@ -559,6 +568,8 @@ import { useNiceTransition } from '@nice2dev/ui-core';
 import { UseNiceTransitionOptions } from '@nice2dev/ui-core';
 import { UseNiceTransitionResult } from '@nice2dev/ui-core';
 import { useNiceTranslation } from '@nice2dev/ui-core';
+import { useNiceTutorials } from '@nice2dev/ui-core';
+import { useNiceTutorialsEnabled } from '@nice2dev/ui-core';
 import { useOrientation } from '@nice2dev/ui-core';
 import { usePan } from '@nice2dev/ui-core';
 import { UsePanOptions } from '@nice2dev/ui-core';
@@ -3888,6 +3899,28 @@ export declare interface EntityMapping {
     onError?: string;
 }
 
+/**
+ * Scaffold a {@link NiceViewDefinitionV2} from an entity:
+ * - `grid` → a single `dataGrid` cell over a `rows` rest data source (columns from fields);
+ * - `form` / `detail` → field controls (mapped by dataType) laid out `perRow` per row,
+ *   two-way bound to a `record` data source (`detail` is read-only and omits the PK).
+ * Universal — any entity with a `fields[]` array works (defaults to the OmniVerk shape).
+ */
+export declare function entityToViewV2(entity: NiceEntityLike, kind?: NiceEntityViewKind, options?: EntityToViewV2Options): NiceViewDefinitionV2;
+
+export declare interface EntityToViewV2Options {
+    /** dataType → controlType overrides (merged over {@link NICE_DATATYPE_CONTROL_MAP}). */
+    fieldControlMap?: Record<string, string>;
+    /** Cells per row for form/detail. Default 2. */
+    perRow?: number;
+    /** Grid column count. Default 12. */
+    columns?: number;
+    /** Data source endpoint (rest). Default = entity name. */
+    endpoint?: string;
+    id?: string;
+    name?: string;
+}
+
 export declare type ERPAggregateFunction = 'sum' | 'avg' | 'count' | 'min' | 'max' | 'first' | 'last' | 'distinctCount' | 'runningSum';
 
 export declare interface ERPChartConfig {
@@ -6728,6 +6761,9 @@ export { NICE_BUILTIN_ICONS }
 /** All built-in style preset keys (export for convenience when populating the `presets` prop). */
 export declare const NICE_COLOR_PRESET_KEYS: NiceColorPreset[];
 
+/** Default mapping: entity field `dataType` (lower-cased) → registry control type. */
+export declare const NICE_DATATYPE_CONTROL_MAP: Record<string, string>;
+
 export { NICE_DISPLAY_STYLE_INFO }
 
 export { NICE_DISPLAY_STYLES }
@@ -6877,6 +6913,26 @@ export declare interface NiceAchievementBadgeProps {
     id?: string;
 }
 
+export declare const NiceActionBuilder: ForwardRefExoticComponent<NiceActionBuilderProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceActionBuilderProps {
+    /** Current actions (controlled). */
+    value: NiceViewAction[];
+    /** Change callback with the full updated array. */
+    onChange: (actions: NiceViewAction[]) => void;
+    /** Available custom handler names (for `type: 'custom'`). */
+    handlers?: string[];
+    /** Available data source keys (for `refresh`). */
+    dataSources?: string[];
+    /** Render read-only. */
+    readOnly?: boolean;
+    /** Add-button label. Default `'+ Add action'`. */
+    addLabel?: string;
+    className?: string;
+    style?: React.CSSProperties;
+    'data-testid'?: string;
+}
+
 /** Context provided to action handlers at execution time. */
 export declare interface NiceActionContext {
     /** Current data sources keyed by name */
@@ -7494,6 +7550,8 @@ export declare interface NiceAutomationRuleEditorProps extends NiceBaseProps {
     onChange: (rule: AutomationRuleDto) => void;
     availableDevices: SmartDeviceDto[];
     availableScenes?: SmartSceneDto[];
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare const NiceAvatar: default_2.FC<NiceAvatarProps>;
@@ -7551,7 +7609,7 @@ export declare interface NiceBackTopProps extends NiceStandardProps {
     onScroll?: () => void;
 }
 
-export declare function NiceBackupDiffViewer({ diffs, title, defaultMode, defaultActions, className, style, }: NiceBackupDiffViewerProps): JSX_2.Element;
+export declare function NiceBackupDiffViewer({ diffs, title, defaultMode, defaultActions, className, style, }: NiceBackupDiffViewerProps): default_2.JSX.Element;
 
 export declare interface NiceBackupDiffViewerProps {
     /** Array of individual entity diffs */
@@ -7566,7 +7624,7 @@ export declare interface NiceBackupDiffViewerProps {
     style?: default_2.CSSProperties;
 }
 
-export declare function NiceBackupList({ entries, onRestore, onDownload, onDelete, onCompare, onEditTags, onRowClick, onCreateBackup, pageSize, loading, className, style, }: NiceBackupListProps): JSX_2.Element;
+export declare function NiceBackupList({ entries, onRestore, onDownload, onDelete, onCompare, onEditTags, onRowClick, onCreateBackup, pageSize, loading, className, style, }: NiceBackupListProps): default_2.JSX.Element;
 
 export declare interface NiceBackupListProps {
     /** List of backup entries to display */
@@ -7593,7 +7651,7 @@ export declare interface NiceBackupListProps {
     style?: default_2.CSSProperties;
 }
 
-export declare function NiceBackupRestoreDialog({ open, entry, plan, loading, progress, error, onDryRun, onConfirm, onClose, }: NiceBackupRestoreDialogProps): JSX_2.Element | null;
+export declare function NiceBackupRestoreDialog({ open, entry, plan, loading, progress, error, onDryRun, onConfirm, onClose, }: NiceBackupRestoreDialogProps): default_2.JSX.Element | null;
 
 export declare interface NiceBackupRestoreDialogProps {
     /** Whether the dialog is visible */
@@ -7616,7 +7674,7 @@ export declare interface NiceBackupRestoreDialogProps {
     onClose?: () => void;
 }
 
-export declare function NiceBackupScheduler({ value, onChange, onSave, loading, className, style, }: NiceBackupSchedulerProps): JSX_2.Element;
+export declare function NiceBackupScheduler({ value, onChange, onSave, loading, className, style, }: NiceBackupSchedulerProps): default_2.JSX.Element;
 
 export declare interface NiceBackupSchedulerProps {
     /** Current schedule configuration */
@@ -7631,7 +7689,7 @@ export declare interface NiceBackupSchedulerProps {
     style?: default_2.CSSProperties;
 }
 
-export declare function NiceBackupStatusBadge({ status, createdAt, showAge, warningDays, criticalDays, tags, maxTags, size, animate, className, style, }: NiceBackupStatusBadgeProps): JSX_2.Element;
+export declare function NiceBackupStatusBadge({ status, createdAt, showAge, warningDays, criticalDays, tags, maxTags, size, animate, className, style, }: NiceBackupStatusBadgeProps): default_2.JSX.Element;
 
 export declare interface NiceBackupStatusBadgeProps {
     status: BackupStatus;
@@ -7655,7 +7713,7 @@ export declare interface NiceBackupStatusBadgeProps {
     style?: default_2.CSSProperties;
 }
 
-export declare function NiceBackupTagEditor({ tags, onChange, suggestions, allowDeleteAutoTags, maxManualTags, className, style, }: NiceBackupTagEditorProps): JSX_2.Element;
+export declare function NiceBackupTagEditor({ tags, onChange, suggestions, allowDeleteAutoTags, maxManualTags, tutorial, className, style, }: NiceBackupTagEditorProps): default_2.JSX.Element;
 
 export declare interface NiceBackupTagEditorProps {
     /** Current tags */
@@ -7674,6 +7732,8 @@ export declare interface NiceBackupTagEditorProps {
     maxManualTags?: number;
     className?: string;
     style?: default_2.CSSProperties;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare const NiceBadge: default_2.FC<NiceBadgeProps>;
@@ -8172,7 +8232,7 @@ export declare interface NiceCardProps extends NiceBaseProps {
     onClick?: () => void;
 }
 
-export declare function NiceCardView<T extends NiceCardViewItem>({ items, renderCard, columns, gap, searchable, searchField, searchPlaceholder, loading, emptyText, onCardClick, className, style, accessMode, id, }: NiceCardViewProps<T>): JSX_2.Element | null;
+export declare function NiceCardView<T extends NiceCardViewItem>({ items, renderCard, columns, gap, searchable, searchField, searchPlaceholder, loading, emptyText, onCardClick, className, style, accessMode, id, }: NiceCardViewProps<T>): default_2.JSX.Element | null;
 
 /** An item displayed by the {@link NiceCardView} component. */
 declare interface NiceCardViewItem {
@@ -8816,8 +8876,20 @@ export declare interface NiceCodeEditorProps {
      * LSP bridge configuration. If provided, connects Monaco to the LSP server for enhanced language features.
      */
     lsp?: NiceCodeEditorLspConfig;
+    /**
+     * Extra TypeScript/JavaScript declaration sources fed to Monaco for IntelliSense
+     * (e.g. a generated `ctx.d.ts` describing a script context). Each entry is registered
+     * via `monaco.languages.typescript.{typescript|javascript}Defaults.addExtraLib`.
+     * Only takes effect for `javascript` / `typescript` languages. Re-applied when the array changes.
+     */
+    extraLibs?: Array<{
+        content: string;
+        filePath?: string;
+    }>;
     /** Additional CSS class */
     className?: string;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
     /** Test ID */
     'data-testid'?: string;
 }
@@ -9384,6 +9456,8 @@ export declare interface NiceComponentDesignerProps {
     theme?: 'light' | 'dark';
     /** Additional class name */
     className?: string;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare interface NiceComponentEntry {
@@ -9425,6 +9499,8 @@ export declare interface NiceComponentPlaygroundProps extends NiceBaseProps {
     defaultDisplayStyle?: NiceDisplayStyle;
 }
 
+export { NiceComponentTutorial }
+
 export { NiceComponentType }
 
 /** Full type mapping registry. */
@@ -10074,6 +10150,8 @@ export declare interface NiceCropEditorProps {
     style?: default_2.CSSProperties;
     /** Test ID */
     'data-testid'?: string;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 /** Cross-platform schema metadata attached to a view definition. */
@@ -10288,7 +10366,7 @@ export declare interface NiceDataDiffViewerProps extends NiceBaseProps {
     onSelectRecord?: (table: string, recordId: string) => void;
 }
 
-export declare function NiceDataGrid<T extends Record<string, any>>({ columns, data: dataProp, keyField, dataSource, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, selectable, selectedKeys: controlledSelected, onSelectionChange, pagination, pageSize: initPageSize, page: controlledPage, onPageChange, totalRows, searchable, searchPlaceholder, virtualScroll, rowHeight, groupBy, groupRender, onCellEdit, editMode, formItems, formColumns, editFormTitle, formProps, onRowEdit, onRowAdd, onRowDelete: _onRowDelete, bulkActions, onBulkDelete, exportCsv, exportFilename, detailRow, expandedRowKeys: controlledExpandedRows, onExpandedRowChange, columnReorder: _columnReorder, onColumnReorder: _onColumnReorder, columnResize, rowDraggable, onRowReorder, striped, compact, loading: loadingProp, emptyText, toolbar, onRowClick, pinnedTopKeys, pinnedBottomKeys, colSpan: colSpanFn, showStatusBar, contextMenuItems, onContextMenuAction, printFriendly, keyboardNavigation, focusedCell: controlledFocusedCell, onFocusedCellChange, cellRangeSelection, selectedCellRange: controlledCellRange, onCellRangeChange, clipboard, clipboardFormat, onBeforeCopy, onCopy, onPaste, quickFilters, activeQuickFilters: controlledQuickFilters, onQuickFilterChange, columnGroups: _columnGroups, stateStorageKey, initialState, onStateChange, flashRowKeys, flashDuration, autoFitColumns: _autoFitColumns, showColumnStats: _showColumnStats, rowIndicator, frozenRows: _frozenRows, className, style, accessMode, id, displayStyle, }: NiceDataGridProps<T>): JSX_2.Element | null;
+export declare function NiceDataGrid<T extends Record<string, any>>({ columns, data: dataProp, keyField, dataSource, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, selectable, selectedKeys: controlledSelected, onSelectionChange, pagination, pageSize: initPageSize, page: controlledPage, onPageChange, totalRows, searchable, searchPlaceholder, virtualScroll, rowHeight, groupBy, groupRender, onCellEdit, editMode, formItems, formColumns, editFormTitle, formProps, onRowEdit, onRowAdd, onRowDelete: _onRowDelete, bulkActions, onBulkDelete, exportCsv, exportFilename, detailRow, expandedRowKeys: controlledExpandedRows, onExpandedRowChange, columnReorder: _columnReorder, onColumnReorder: _onColumnReorder, columnResize, rowDraggable, onRowReorder, striped, compact, loading: loadingProp, emptyText, toolbar, onRowClick, pinnedTopKeys, pinnedBottomKeys, colSpan: colSpanFn, showStatusBar, contextMenuItems, onContextMenuAction, printFriendly, keyboardNavigation, focusedCell: controlledFocusedCell, onFocusedCellChange, cellRangeSelection, selectedCellRange: controlledCellRange, onCellRangeChange, clipboard, clipboardFormat, onBeforeCopy, onCopy, onPaste, quickFilters, activeQuickFilters: controlledQuickFilters, onQuickFilterChange, columnGroups: _columnGroups, stateStorageKey, initialState, onStateChange, flashRowKeys, flashDuration, autoFitColumns: _autoFitColumns, showColumnStats: _showColumnStats, rowIndicator, frozenRows: _frozenRows, className, style, accessMode, id, displayStyle, }: NiceDataGridProps<T>): default_2.JSX.Element | null;
 
 export declare namespace NiceDataGrid {
     var displayName: string;
@@ -10567,6 +10645,8 @@ export declare interface NiceDataMergeBuilderProps extends NiceBaseProps {
     onPreview?: (sourceId: string, targetId: string) => void;
     onMerge?: (config: MergeConfig) => void;
     onCancel?: () => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare const NiceDataSnapshot: default_2.FC<NiceDataSnapshotProps>;
@@ -10810,7 +10890,7 @@ export declare interface NiceDeviceControlCardProps extends NiceBaseProps {
     controlLayout?: ControlLayout;
 }
 
-export declare function NiceDiagramDesigner({ initialSchema, onChange, onExport, className, style, }: NiceDiagramDesignerProps): JSX.Element;
+export declare function NiceDiagramDesigner({ initialSchema, onChange, onExport, className, style, tutorial, }: NiceDiagramDesignerProps): JSX.Element;
 
 export declare interface NiceDiagramDesignerProps {
     /** Initial diagram schema. Accepts the canonical {@link DiagramSchema} or a looser input where nodes only need `id/x/y/label` and edges may use `from`/`to` aliases. */
@@ -10847,6 +10927,8 @@ export declare interface NiceDiagramDesignerProps {
     className?: string;
     /** Style */
     style?: default_2.CSSProperties;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export { NiceDirection }
@@ -11010,7 +11092,7 @@ export declare interface NiceDocumentApprovalFlowProps extends NiceFormFieldProp
     locale?: string;
 }
 
-export declare function NiceDocumentationViewer({ doc, component: _component, renderPreview: _renderPreview, defaultTab, sections, compact, enableCodeEdit, className, style, }: NiceDocumentationViewerProps): JSX_2.Element;
+export declare function NiceDocumentationViewer({ doc, component: _component, renderPreview: _renderPreview, defaultTab, sections, compact, enableCodeEdit, className, style, }: NiceDocumentationViewerProps): default_2.JSX.Element;
 
 export declare interface NiceDocumentationViewerProps {
     /** Component documentation data */
@@ -11105,6 +11187,8 @@ export declare interface NiceDocumentEditorProps extends NiceBaseProps {
     showToc?: boolean;
     /** Show find & replace bar (Ctrl+F). */
     showFindReplace?: boolean;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare interface NiceDocumentInfo {
@@ -11507,8 +11591,29 @@ export declare interface NiceEnergyChartProps extends NiceBaseProps {
     onDrillDown?: (bucket: string) => void;
 }
 
+/** Minimal entity field descriptor (OmniVerk `ModuleEntityField`-compatible). */
+export declare interface NiceEntityFieldLike {
+    name: string;
+    displayName?: string;
+    dataType?: string;
+    isRequired?: boolean;
+    isPrimaryKey?: boolean;
+    [k: string]: unknown;
+}
+
+/** Minimal entity descriptor (OmniVerk `ModuleEntity`-compatible). */
+export declare interface NiceEntityLike {
+    name?: string;
+    displayName?: string;
+    fields?: NiceEntityFieldLike[];
+    [k: string]: unknown;
+}
+
 export { NiceEntityMenuDto }
 
+/** View kinds this scaffolder supports. */
+export declare type NiceEntityViewKind = 'form' | 'detail' | 'grid';
+
 export declare const NiceERPReportDesigner: default_2.FC<NiceERPReportDesignerProps>;
 
 export declare interface NiceERPReportDesignerProps extends NiceBaseProps {
@@ -11538,6 +11643,8 @@ export declare interface NiceERPReportDesignerProps extends NiceBaseProps {
     showDataPanel?: boolean;
     /** Show toolbar */
     showToolbar?: boolean;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 /**
@@ -11550,7 +11657,7 @@ export declare class NiceErrorBoundary extends Component<NiceErrorBoundaryProps,
     static getDerivedStateFromError(error: Error): NiceErrorBoundaryState;
     componentDidCatch(error: Error, errorInfo: default_2.ErrorInfo): void;
     handleReset: () => void;
-    render(): string | number | boolean | Iterable<default_2.ReactNode> | JSX_2.Element | null | undefined;
+    render(): string | number | boolean | Iterable<default_2.ReactNode> | default_2.JSX.Element | null | undefined;
 }
 
 /** Props for the {@link NiceErrorBoundary} component. */
@@ -12130,6 +12237,8 @@ export declare interface NiceFilterBuilderProps extends NiceBaseProps {
     presets?: NiceFilterPreset[];
     onSavePreset?: (preset: NiceFilterPreset) => void;
     onDeletePreset?: (name: string) => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export { NiceFilterCondition }
@@ -13041,6 +13150,22 @@ export declare interface NiceHighlightProps extends NiceStandardProps {
     caseSensitive?: boolean;
 }
 
+/** A single trigger → handler binding. */
+export declare interface NiceHookBinding {
+    id: string;
+    /** Id of the {@link NiceLifecycleTrigger} this binding fires on. */
+    trigger: string;
+    /** Id of the bound handler, or a free-form handler reference when no `handlers` list is given. */
+    handler: string;
+    /** Execution order within the trigger (lower runs first). */
+    order: number;
+    /** Whether the binding is active. */
+    enabled: boolean;
+    /** Optional condition expression gating execution. */
+    condition?: string;
+    description?: string;
+}
+
 /** Configuration for the hot-swap manager. */
 export declare interface NiceHotSwapConfig {
     /** Module import resolver. */
@@ -13110,7 +13235,6 @@ declare interface NiceHtmlEditorAIRef {
 /** Available toolbar commands for the {@link NiceHtmlEditor}. */
 export declare type NiceHtmlEditorCommand = 'bold' | 'italic' | 'underline' | 'strikethrough' | 'h1' | 'h2' | 'h3' | 'ul' | 'ol' | 'link' | 'unlink' | 'undo' | 'redo' | 'clear' | 'table' | 'image' | 'code' | 'markdown' | 'blockquote' | 'hr' | 'fontSize' | 'fontColor' | 'bgColor' | 'subscript' | 'superscript' | 'indent' | 'outdent' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'fullscreen' | 'removeFormat' | 'print' | 'source' | 'emoji' | 'findReplace';
 
-/** Props for the {@link NiceHtmlEditor} component � a WYSIWYG rich-text editor with toolbar, mentions, and image upload. */
 export declare interface NiceHtmlEditorProps extends NiceFormFieldProps {
     value: string;
     onChange: (html: string) => void;
@@ -13142,6 +13266,8 @@ export declare interface NiceHtmlEditorProps extends NiceFormFieldProps {
         label: string;
         html: string;
     }[];
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 declare interface NiceHTMLOptions extends NiceExportOptions {
@@ -13289,6 +13415,8 @@ export declare interface NiceImageEditorProps extends NiceBaseProps {
     onChange?: (state: NiceImageEditorState) => void;
     width?: number | string;
     height?: number | string;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare interface NiceImageEditorState {
@@ -13571,6 +13699,8 @@ export declare interface NiceInvoiceLineEditorProps extends NiceFormFieldProps {
     maxLines?: number;
     /** Fires with computed totals whenever lines change. */
     onTotalsChange?: (totals: InvoiceTotals) => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 declare interface NiceJSONOptions extends NiceExportOptions {
@@ -13632,6 +13762,8 @@ export declare interface NiceKanbanBoardProps extends NiceBaseProps, TracelessSt
     onCardCreate?: (newCard: NiceKanbanCard) => void;
     /** Called when the user requests deletion from the popup form. */
     onCardDelete?: (cardKey: string | number) => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 /** A card on the {@link NiceKanbanBoard}. */
@@ -13684,6 +13816,51 @@ export { NiceKeyboardHint }
 
 export { NiceKeyboardHintProps }
 
+export declare const NiceKeyValueEditor: ForwardRefExoticComponent<NiceKeyValueEditorProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceKeyValueEditorProps extends NiceBaseProps {
+    /** Current rows (controlled). */
+    value: NiceKeyValuePair[];
+    /** Change callback with the full updated array. */
+    onChange: (pairs: NiceKeyValuePair[]) => void;
+    /** Allow toggling a row's value between text and secret (adds a lock toggle). */
+    allowSecret?: boolean;
+    /** Show a per-row enable/disable checkbox. */
+    allowToggle?: boolean;
+    /** Show a per-row description input. */
+    allowDescription?: boolean;
+    /** Suggested keys (rendered via a shared `<datalist>`). */
+    keySuggestions?: string[];
+    /** Placeholder for the key input. Default `'Key'`. */
+    keyPlaceholder?: string;
+    /** Placeholder for the value input. Default `'Value'`. */
+    valuePlaceholder?: string;
+    /** Label for the add-row button. Default `'Add'`. */
+    addLabel?: string;
+    /** Render read-only (no editing, no add/remove). */
+    readOnly?: boolean;
+    /** Highlight duplicate keys. Default `true`. */
+    duplicateKeyWarning?: boolean;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
+}
+
+/** A single key/value row. */
+export declare interface NiceKeyValuePair {
+    /** Stable id (used as React key when present). */
+    id?: string;
+    /** The key/name. */
+    key: string;
+    /** The value. */
+    value: string;
+    /** `'secret'` renders the value masked with a reveal toggle. Default `'text'`. */
+    type?: 'text' | 'secret';
+    /** Whether the row is active. Only meaningful when `allowToggle` is set. */
+    enabled?: boolean;
+    /** Optional description / note. Only shown when `allowDescription` is set. */
+    description?: string;
+}
+
 export declare const NiceKioskShell: ForwardRefExoticComponent<NiceKioskShellProps & RefAttributes<HTMLDivElement>>;
 
 export declare interface NiceKioskShellProps extends NiceBaseProps {
@@ -13853,6 +14030,47 @@ export declare interface NiceLeaderboardProps {
     id?: string;
 }
 
+/** A handler that can be bound to a trigger (e.g. a script). */
+export declare interface NiceLifecycleHandlerOption {
+    id: string;
+    label: string;
+    description?: string;
+}
+
+export declare const NiceLifecycleHooksEditor: ForwardRefExoticComponent<NiceLifecycleHooksEditorProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceLifecycleHooksEditorProps extends NiceBaseProps {
+    /** Available triggers. */
+    triggers: NiceLifecycleTrigger[];
+    /** Current bindings (controlled). */
+    bindings: NiceHookBinding[];
+    /** Available handlers. When omitted, the handler field is a free-text input. */
+    handlers?: NiceLifecycleHandlerOption[];
+    /** Change callback with the full updated bindings array. */
+    onChange: (bindings: NiceHookBinding[]) => void;
+    /** Show up/down controls to reorder bindings within a trigger. Default `true`. */
+    allowReorder?: boolean;
+    /** Show a condition input per binding. Default `false`. */
+    allowCondition?: boolean;
+    /** Group triggers by their `group` field. Default `false`. */
+    groupByTrigger?: boolean;
+    /** Render read-only. */
+    readOnly?: boolean;
+    /** Custom handler picker (overrides the default select / text input). */
+    renderHandlerPicker?: (binding: NiceHookBinding, set: (patch: Partial<NiceHookBinding>) => void) => React.ReactNode;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
+}
+
+/** A trigger that handlers can be bound to (e.g. `EntityCreated:Article`). */
+export declare interface NiceLifecycleTrigger {
+    id: string;
+    label: string;
+    /** Optional grouping key (shown as a section header when `groupByTrigger`). */
+    group?: string;
+    description?: string;
+}
+
 /**
  * Modal image viewer. Renders a full-screen overlay with prev/next
  * navigation, optional zoom + download buttons, and a counter.
@@ -14145,7 +14363,7 @@ export declare const NiceLiveDataGrid: <T extends LiveGridRow = LiveGridRow>(pro
     ref?: default_2.ForwardedRef<NiceLiveDataGridRef<T>>;
 }) => ReturnType<typeof NiceLiveDataGridInner>;
 
-declare function NiceLiveDataGridInner<T extends LiveGridRow = LiveGridRow>({ columns, data: initialData, dataSource, rowKey, showConnectionStatus, highlightDuration, updateAnimation, maxRows, selectable, selectedIds, onSelectionChange, onRowClick, onUpdate, onConnectionStatusChange, emptyContent, loadingContent, sortable, sortField, sortDirection, onSortChange, virtualized: _virtualized, rowHeight, height, className, style, }: NiceLiveDataGridProps<T>, ref: default_2.ForwardedRef<NiceLiveDataGridRef<T>>): JSX_2.Element;
+declare function NiceLiveDataGridInner<T extends LiveGridRow = LiveGridRow>({ columns, data: initialData, dataSource, rowKey, showConnectionStatus, highlightDuration, updateAnimation, maxRows, selectable, selectedIds, onSelectionChange, onRowClick, onUpdate, onConnectionStatusChange, emptyContent, loadingContent, sortable, sortField, sortDirection, onSortChange, virtualized: _virtualized, rowHeight, height, className, style, }: NiceLiveDataGridProps<T>, ref: default_2.ForwardedRef<NiceLiveDataGridRef<T>>): default_2.JSX.Element;
 
 /** Props for NiceLiveDataGrid */
 export declare interface NiceLiveDataGridProps<T extends LiveGridRow = LiveGridRow> extends NiceBaseProps {
@@ -14384,6 +14602,45 @@ export declare interface NiceLockButtonProps extends NiceBaseProps {
     label?: string;
 }
 
+export declare const NiceLogConsole: ForwardRefExoticComponent<NiceLogConsoleProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceLogConsoleProps extends NiceBaseProps {
+    /** Entries to render, oldest → newest. */
+    entries: NiceLogEntry[];
+    /** Max height before the body scrolls. Number → px. Default `240`. */
+    maxHeight?: number | string;
+    /** Auto-scroll to the newest entry when `entries` grows. Default `true`. */
+    autoScroll?: boolean;
+    /** Show a per-entry timestamp gutter. Default `true`. */
+    showTimestamps?: boolean;
+    /** When set, only entries whose level is included are rendered. */
+    levelFilter?: NiceLogLevel[];
+    /** When provided, a "Clear" button is shown in the header. */
+    onClear?: () => void;
+    /** Header title. When omitted (and no `onClear`) the header is hidden. */
+    title?: string;
+    /** Content shown when there are no (visible) entries. Default `'No output'`. */
+    emptyText?: React.ReactNode;
+    /** Label for the clear button. Default `'Clear'`. */
+    clearLabel?: string;
+    /** Monospace font family override. */
+    fontFamily?: string;
+}
+
+/** A single line emitted to the console. */
+export declare interface NiceLogEntry {
+    /** Severity — drives colour and optional filtering. Defaults to `'log'`. */
+    level?: NiceLogLevel;
+    /** Human-readable message. */
+    message: string;
+    /** When the entry was produced. Epoch ms or `Date`. */
+    timestamp?: number | Date;
+    /** Optional structured payload appended (pretty-printed JSON) below the message. */
+    data?: unknown;
+    /** Optional source/tag shown as a dim prefix (e.g. a script or provider id). */
+    source?: string;
+}
+
 export declare const NiceLoginForm: ForwardRefExoticComponent<NiceLoginFormProps & RefAttributes<HTMLFormElement>>;
 
 /** Props for the {@link NiceLoginForm} component — a pre-built login form with username, password, remember-me, and social links. */
@@ -14426,6 +14683,9 @@ export declare interface NiceLoginFormProps extends NiceStandardProps {
     passwordPlaceholder?: string;
 }
 
+/** Severity of a single console entry. */
+export declare type NiceLogLevel = 'log' | 'info' | 'warn' | 'error' | 'debug';
+
 export declare const NiceLogo: default_2.ForwardRefExoticComponent<NiceLogoProps & default_2.RefAttributes<HTMLElement>>;
 
 export declare interface NiceLogoProps {
@@ -14544,9 +14804,11 @@ export declare interface NiceLowCodeStudioProps {
     onSave?: (design: DesignState) => void;
     /** Additional class name */
     className?: string;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
-export declare function NiceMAM({ assets: initialAssets, folders: initialFolders, collections: initialCollections, people: initialPeople, currentUser, uploadEndpoint: _uploadEndpoint, enableAITagging, enableFaceRecognition, maxUploadSize: _maxUploadSize, allowedTypes: _allowedTypes, onUpload: _onUpload, onDelete, onAnalyze, onDetectFaces, onSelectionChange: _onSelectionChange, onPreview, renderAssetCard, className, style, children, ...baseProps }: NiceMAMProps): JSX_2.Element;
+export declare function NiceMAM({ assets: initialAssets, folders: initialFolders, collections: initialCollections, people: initialPeople, currentUser, uploadEndpoint: _uploadEndpoint, enableAITagging, enableFaceRecognition, maxUploadSize: _maxUploadSize, allowedTypes: _allowedTypes, onUpload: _onUpload, onDelete, onAnalyze, onDetectFaces, onSelectionChange: _onSelectionChange, onPreview, renderAssetCard, className, style, children, ...baseProps }: NiceMAMProps): default_2.JSX.Element;
 
 export declare interface NiceMAMProps extends NiceBaseProps {
     /** Initial assets */
@@ -14701,6 +14963,8 @@ export declare interface NiceMarkdownEditorProps extends NiceBaseProps {
     showLineNumbers?: boolean;
     onExportHtml?: (html: string) => void;
     onImageUpload?: (file: File) => Promise<string>;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare type NiceMarkdownPreviewMode = 'side' | 'tab' | 'none';
@@ -15056,6 +15320,8 @@ export declare interface NiceMergeRequestBuilderProps extends NiceBaseProps {
     onCancel?: () => void;
     onBranchChange?: (source: string, target: string) => void;
     onPreview?: (data: MergeRequestData) => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare const NiceModal: default_2.FC<NiceModalProps>;
@@ -16405,6 +16671,8 @@ export declare interface NicePageBuilderProps {
     previewMode?: 'desktop' | 'tablet' | 'mobile';
     /** Additional class name */
     className?: string;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 /**
@@ -16576,6 +16844,8 @@ export declare interface NicePDFAnnotationEditorProps extends NiceFormFieldProps
     onAnnotationClick?: (annotation: PDFAnnotation) => void;
     /** Fires when an annotation is deleted. */
     onAnnotationDelete?: (id: string) => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 declare interface NicePDFOptions extends NiceExportOptions {
@@ -16850,6 +17120,8 @@ export declare interface NicePipelineEditorProps extends NiceBaseProps {
     onSave: () => void;
     onRun: () => void;
     onValidate: () => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare const NicePipelineMonitor: default_2.FC<NicePipelineMonitorProps>;
@@ -17823,6 +18095,8 @@ export declare interface NiceRecipeEditorProps extends NiceBaseProps {
     saveLabel?: string;
     /** Custom Cancel button label. */
     cancelLabel?: string;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 /**
@@ -18095,6 +18369,8 @@ export declare interface NiceResolvedPermissions {
     denied: Map<string, Set<RbacAction>>;
 }
 
+export { NiceResolvedTutorialStep }
+
 export declare const NiceResourceAllocation: default_2.ForwardRefExoticComponent<NiceResourceAllocationProps & default_2.RefAttributes<NiceResourceAllocationRef>>;
 
 export declare interface NiceResourceAllocationProps extends NiceBaseProps {
@@ -18248,6 +18524,48 @@ export declare interface NiceRetryPanelProps extends NiceStandardProps {
     icon?: default_2.ReactNode;
 }
 
+/** A single revision/version entry. */
+export declare interface NiceRevision {
+    id: string;
+    /** Short label (e.g. "v12" or a commit subject). */
+    label?: string;
+    author?: string;
+    /** When the revision was created. Epoch ms or `Date`. */
+    timestamp: number | Date;
+    /** Inline content. When omitted, `loadContent` is used for diffing. */
+    content?: string;
+    /** Longer description / change summary. */
+    summary?: string;
+    tags?: string[];
+}
+
+export declare const NiceRevisionHistory: ForwardRefExoticComponent<NiceRevisionHistoryProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceRevisionHistoryProps extends NiceBaseProps {
+    /** Revisions, newest first (rendered in given order). */
+    revisions: NiceRevision[];
+    /** Language for diff syntax highlighting. Default `'plaintext'`. */
+    language?: NiceCodeLanguage;
+    /** Selected (modified / right side) revision id. Uncontrolled when omitted. */
+    selectedId?: string;
+    /** Compare-against (original / left side) revision id. Uncontrolled when omitted. */
+    compareWithId?: string;
+    /** Called when the selected revision changes. */
+    onSelect?: (id: string) => void;
+    /** Called when the compare pair changes. */
+    onCompare?: (compareWithId: string, selectedId: string) => void;
+    /** Called when the user rolls back to a revision. */
+    onRollback?: (id: string) => void;
+    /** Lazily resolve a revision's content (when not provided inline). */
+    loadContent?: (id: string) => Promise<string>;
+    /** Render the side-by-side diff pane. Default `true`. */
+    showDiff?: boolean;
+    /** Rollback button label. Default `'Restore'`. */
+    rollbackLabel?: string;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
+}
+
 /**
  * Decorative corner ribbon that hangs from the top of its wrapped
  * element. Positioning is relative to a `position: relative` shim
@@ -18512,6 +18830,8 @@ export declare interface NiceSceneActionBuilderProps extends NiceBaseProps {
     availableRooms?: SmartRoomDto[];
     showPreview?: boolean;
     maxActions?: number;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare const NiceSceneBar: default_2.FC<NiceSceneBarProps>;
@@ -18700,6 +19020,64 @@ export declare interface NiceSchedulerServiceData {
 /** Available calendar views for the {@link NiceScheduler}. */
 export declare type NiceSchedulerView = 'day' | 'week' | 'workWeek' | 'month' | 'dayRange' | 'monthRange' | 'agenda' | 'timeline';
 
+export declare const NiceScriptRunner: ForwardRefExoticComponent<NiceScriptRunnerProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceScriptRunnerProps extends NiceBaseProps {
+    /** Script source (controlled). */
+    value: string;
+    /** Script change callback. */
+    onChange?: (value: string) => void;
+    /** Editor language. Default `'javascript'`. */
+    language?: NiceCodeLanguage;
+    /**
+     * Executes the script. Receives the current code and parsed input.
+     * Return (or resolve) a {@link NiceScriptRunResult}. Throwing is also supported —
+     * the error is surfaced in the result pane.
+     */
+    onRun: (code: string, input: unknown) => Promise<NiceScriptRunResult> | NiceScriptRunResult;
+    /** Sample input (entity/payload). Edited as JSON; parsed before `onRun`. */
+    input?: unknown;
+    /** Called with the parsed input when the input editor changes. */
+    onInputChange?: (input: unknown) => void;
+    /** Show the input editor. Defaults to `true` when `input` is provided. */
+    showInputPanel?: boolean;
+    /** Declaration libs forwarded to the code editor for IntelliSense (e.g. `ctx.d.ts`). */
+    extraLibs?: Array<{
+        content: string;
+        filePath?: string;
+    }>;
+    /** Editor height. Number → px. Default `260`. */
+    height?: number | string;
+    /** Externally-controlled running state. When omitted, the component manages its own. */
+    running?: boolean;
+    /** Debounced auto-run on code/input change. Default `false`. */
+    autoRun?: boolean;
+    /** Debounce for `autoRun`, ms. Default `600`. */
+    autoRunDelay?: number;
+    /** Panel arrangement. Default `'vertical'` (editor on top, output below). */
+    layout?: 'horizontal' | 'vertical';
+    /** Run button label. Default `'Run'`. */
+    runLabel?: string;
+    /** Editor theme. Default `'auto'`. */
+    theme?: 'auto' | 'light' | 'dark' | 'vs' | 'vs-dark';
+    /** Optional guided tour. `true` = built-in; array/object = custom steps. Shows a "?" button. */
+    tutorial?: NiceComponentTutorial;
+}
+
+/** Outcome of a single script run, returned by {@link NiceScriptRunnerProps.onRun}. */
+export declare interface NiceScriptRunResult {
+    /** Whether the run succeeded. */
+    ok: boolean;
+    /** Returned value (pretty-printed in the result pane). */
+    result?: unknown;
+    /** Log lines captured during the run. */
+    logs?: NiceLogEntry[];
+    /** Error message when `ok` is false. */
+    error?: string;
+    /** Wall-clock duration in milliseconds (shown in the status bar). */
+    durationMs?: number;
+}
+
 export declare const NiceScrollView: default_2.FC<NiceScrollViewProps>;
 
 /** Props for the {@link NiceScrollView} component — a styled scrollable container with configurable scrollbar visibility. */
@@ -18889,7 +19267,7 @@ export declare interface NiceSectionProps extends NiceStandardProps {
  * - `NiceToolbar` — long horizontal strip with separators / spacers /
  *   custom widgets, typically above content.
  */
-export declare function NiceSegmentedControl<T = string>({ options, value: controlledValue, defaultValue, onChange, size, block, disabled, className, style, 'data-testid': testId, }: NiceSegmentedControlProps<T>): JSX_2.Element;
+export declare function NiceSegmentedControl<T = string>({ options, value: controlledValue, defaultValue, onChange, size, block, disabled, className, style, 'data-testid': testId, }: NiceSegmentedControlProps<T>): default_2.JSX.Element;
 
 export declare namespace NiceSegmentedControl {
     var displayName: string;
@@ -19451,7 +19829,7 @@ export declare interface NiceSliderProps extends Omit<NiceFormFieldProps, 'label
     showTickLabels?: boolean;
 }
 
-export declare function NiceSortable<T extends Record<string, unknown>>({ items, keyField, onReorder, renderItem, direction, handle, group: _group, disabled, className, style, }: NiceSortableProps<T>): JSX_2.Element;
+export declare function NiceSortable<T extends Record<string, unknown>>({ items, keyField, onReorder, renderItem, direction, handle, group: _group, disabled, className, style, }: NiceSortableProps<T>): default_2.JSX.Element;
 
 export declare namespace NiceSortable {
     var displayName: string;
@@ -19811,6 +20189,8 @@ export declare interface NiceStateDesignerProps extends NiceBaseProps {
     onStoreChange?: (store: StoreDefinition) => void;
     onExport?: (code: string, format: ExportFormat_2) => void;
     onSave?: (store: StoreDefinition) => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export { NiceStateIO }
@@ -19982,7 +20362,7 @@ export declare interface NiceStoryMeta {
     parameters?: Record<string, unknown>;
 }
 
-export declare function NiceStreamDashboard({ platforms: initialPlatforms, scenes: initialScenes, config: initialConfig, enableWebRTC: _enableWebRTC, rtmpServerUrl: _rtmpServerUrl, maxChatMessages: _maxChatMessages, autoRecord, recordingPath: _recordingPath, onStreamStart, onStreamStop, onChatMessage: _onChatMessage, onAlert, onAnalyticsUpdate: _onAnalyticsUpdate, onVODCreated, renderPreview, renderChatMessage, className, style, children, ...baseProps }: NiceStreamDashboardProps): JSX_2.Element;
+export declare function NiceStreamDashboard({ platforms: initialPlatforms, scenes: initialScenes, config: initialConfig, enableWebRTC: _enableWebRTC, rtmpServerUrl: _rtmpServerUrl, maxChatMessages: _maxChatMessages, autoRecord, recordingPath: _recordingPath, onStreamStart, onStreamStop, onChatMessage: _onChatMessage, onAlert, onAnalyticsUpdate: _onAnalyticsUpdate, onVODCreated, renderPreview, renderChatMessage, className, style, children, ...baseProps }: NiceStreamDashboardProps): default_2.JSX.Element;
 
 export declare interface NiceStreamDashboardProps extends NiceBaseProps {
     /** Initial platform connections */
@@ -20225,7 +20605,7 @@ export declare interface NiceTabItem {
     content?: default_2.ReactNode;
 }
 
-export declare function NiceTable<T extends Record<string, any>>({ columns, data, striped, compact, emptyText, className, style, accessMode, id, displayStyle, }: NiceTableProps<T>): JSX_2.Element | null;
+export declare function NiceTable<T extends Record<string, any>>({ columns, data, striped, compact, emptyText, className, style, accessMode, id, displayStyle, }: NiceTableProps<T>): default_2.JSX.Element | null;
 
 /** Column definition for the {@link NiceTable} component. */
 export declare interface NiceTableColumn<T = any> {
@@ -20557,6 +20937,8 @@ export declare interface NiceTestBuilderProps extends NiceBaseProps {
     onExport?: (code: string) => void;
     onRun?: (suiteId: string) => void;
     onRunAll?: () => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export { NiceTestWrapper }
@@ -20651,6 +21033,8 @@ export declare interface NiceThemeBuilderProps extends NiceBaseProps {
     showPreview?: boolean;
     /** Layout placement of the preview pane (default: 'right') */
     previewPlacement?: 'right' | 'bottom';
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 /** Editable sections in the {@link NiceThemeBuilder}. */
@@ -20918,7 +21302,7 @@ export { NiceThemeVariantProvider }
 
 export { NiceThemeVariantProviderProps }
 
-export declare function NiceTileView<T extends NiceTileViewItem>({ items, tileWidth, tileHeight, direction, renderTile, onTileClick, loading, emptyText, className, style, }: NiceTileViewProps<T>): JSX_2.Element;
+export declare function NiceTileView<T extends NiceTileViewItem>({ items, tileWidth, tileHeight, direction, renderTile, onTileClick, loading, emptyText, className, style, }: NiceTileViewProps<T>): default_2.JSX.Element;
 
 /** A tile item displayed by the {@link NiceTileView} component. */
 declare interface NiceTileViewItem {
@@ -21489,7 +21873,7 @@ export declare interface NiceTopologyData {
 
 export { NiceTouchTarget }
 
-export declare function NiceTranscoder({ jobs: initialJobs, profiles: initialProfiles, presets: customPresets, maxConcurrent, autoStart, defaultOutputDir, showThumbnails, enableDragDrop, onJobStatusChange, onJobComplete: _onJobComplete, onJobError: _onJobError, onProgress: _onProgress, renderJobItem, className, style, children, ...baseProps }: NiceTranscoderProps): JSX_2.Element;
+export declare function NiceTranscoder({ jobs: initialJobs, profiles: initialProfiles, presets: customPresets, maxConcurrent, autoStart, defaultOutputDir, showThumbnails, enableDragDrop, onJobStatusChange, onJobComplete: _onJobComplete, onJobError: _onJobError, onProgress: _onProgress, renderJobItem, className, style, children, ...baseProps }: NiceTranscoderProps): default_2.JSX.Element;
 
 export declare interface NiceTranscoderProps extends NiceBaseProps {
     /** Initial jobs */
@@ -21537,7 +21921,7 @@ export declare interface NiceTreeContextMenuItem {
     disabled?: boolean;
 }
 
-export declare function NiceTreeGrid<T extends NiceTreeGridNode>({ columns, data, keyField, parentKeyField, nested, childrenField, expandedKeys: controlledExpanded, onExpandedChange, defaultExpandAll, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, selectable, selectedKeys: controlledSelected, onSelectionChange, searchable, searchPlaceholder, striped, compact, loading, emptyText, toolbar, onRowClick, className, style, }: NiceTreeGridProps<T>): JSX_2.Element;
+export declare function NiceTreeGrid<T extends NiceTreeGridNode>({ columns, data, keyField, parentKeyField, nested, childrenField, expandedKeys: controlledExpanded, onExpandedChange, defaultExpandAll, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, selectable, selectedKeys: controlledSelected, onSelectionChange, searchable, searchPlaceholder, striped, compact, loading, emptyText, toolbar, onRowClick, className, style, }: NiceTreeGridProps<T>): default_2.JSX.Element;
 
 /** A row node in the {@link NiceTreeGrid} (supports index-signature for dynamic fields). */
 export declare interface NiceTreeGridNode {
@@ -21596,7 +21980,7 @@ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTree
     onRowClick?: (row: T) => void;
 }
 
-export declare function NiceTreeList<T extends NiceTreeListNode>({ columns, data, keyField, parentKeyField, expandedKeys: controlledExpanded, onExpandedChange, selectedKeys, onSelectionChange, selectable, loading, emptyText, className, style, accessMode, id, }: NiceTreeListProps<T>): JSX_2.Element | null;
+export declare function NiceTreeList<T extends NiceTreeListNode>({ columns, data, keyField, parentKeyField, expandedKeys: controlledExpanded, onExpandedChange, selectedKeys, onSelectionChange, selectable, loading, emptyText, className, style, accessMode, id, }: NiceTreeListProps<T>): default_2.JSX.Element | null;
 
 /** A tree-list node for the {@link NiceTreeList} component. */
 export declare interface NiceTreeListNode {
@@ -21836,6 +22220,22 @@ export declare interface NiceTruncateProps extends NiceStandardProps {
 
 export declare const NiceTutorial: default_2.FC<NiceTutorialProps>;
 
+export { NiceTutorialButton }
+
+export { NiceTutorialButtonProps }
+
+export declare const NiceTutorialHost: default_2.FC<NiceTutorialHostProps>;
+
+export declare interface NiceTutorialHostProps {
+    /** Global enable flag (default `true`). Set `false` to hide every "?" button. */
+    enabled?: boolean;
+    /** Override NiceTutorial control labels (merged over the i18n defaults). */
+    labels?: NiceTutorialProps['labels'];
+    /** Extra props forwarded to the underlying NiceTutorial (autoplay, placement…). */
+    tutorialProps?: Omit<NiceTutorialProps, 'steps' | 'active' | 'onFinish' | 'onSkip' | 'labels'>;
+    children: default_2.ReactNode;
+}
+
 /** Props for the {@link NiceTutorial} component — a guided walkthrough overlay with step-by-step highlighting. */
 export declare interface NiceTutorialProps {
     /** Array of ordered tutorial steps */
@@ -21863,6 +22263,14 @@ export declare interface NiceTutorialProps {
         finish?: string;
         skip?: string;
         stepOf?: string;
+        /** Play autoplay button (default "Play"). */
+        play?: string;
+        /** Pause autoplay button (default "Pause"). */
+        pause?: string;
+        /** Aria-label for the speed slider (default "Speed"). */
+        speed?: string;
+        /** Aria-label / tooltip for the tooltip close icon (default "Close"). */
+        close?: string;
     };
     /** Animation duration in ms (default 300) */
     animationDuration?: number;
@@ -21870,6 +22278,36 @@ export declare interface NiceTutorialProps {
     overlayOpacity?: number;
     /** Z-index for the overlay (default 10000) */
     zIndex?: number;
+    /**
+     * Where the control buttons (skip / prev / next / play) sit.
+     * - `'floating-bottom'` (default): fixed strip at bottom-center of the
+     *   viewport. The buttons never move between steps and never overlap with
+     *   the tooltip body.
+     * - `'inline'`: inside the tooltip footer (legacy behaviour — buttons
+     *   re-position with each step).
+     */
+    buttonsPlacement?: 'floating-bottom' | 'inline';
+    /**
+     * How control buttons render.
+     * - `'icon'` (default): round icon-only buttons.
+     * - `'icon-text'`: icon with the label next to it.
+     * - `'text'`: text label only (legacy).
+     */
+    buttonsDisplay?: 'icon' | 'icon-text' | 'text';
+    /**
+     * Show the PLAY/PAUSE button + progress bar + speed slider. Default `true`.
+     * Disable to hide all autoplay controls.
+     */
+    showAutoplay?: boolean;
+    /** Initial autoplay interval in ms-per-step. Default `5000`. */
+    autoplayInterval?: number;
+    /** Min/max range for the speed slider in ms-per-step. Defaults `{ min: 2000, max: 15000 }`. */
+    autoplaySpeedRange?: {
+        min: number;
+        max: number;
+    };
+    /** Called whenever autoplay state changes. */
+    onAutoplayChange?: (playing: boolean) => void;
 }
 
 export declare const NiceTutorialProvider: default_2.FC<NiceTutorialProviderProps>;
@@ -21880,6 +22318,10 @@ export declare interface NiceTutorialProviderProps {
     children: default_2.ReactNode;
 }
 
+export { NiceTutorialsContextValue }
+
+export { NiceTutorialsProvider }
+
 /** A single step in a {@link NiceTutorial} flow. */
 export declare interface NiceTutorialStep {
     /** CSS selector or ref-based query to find the target element */
@@ -21910,6 +22352,8 @@ export declare interface NiceTutorialStep {
     disableInteraction?: boolean;
 }
 
+export { NiceTutorialStepDef }
+
 /** Single type mapping entry. */
 export declare interface NiceTypeMappingEntry {
     /** Universal control type key (used in JSON schema). */
@@ -22263,7 +22707,7 @@ export declare interface NiceVectorMapProps extends NiceStandardProps {
     showTooltip?: boolean;
 }
 
-export declare function NiceVideoAnnotator({ video: initialVideo, annotations: initialAnnotations, markers: initialMarkers, transcription: initialTranscription, speakers: initialSpeakers, currentUser, enableSpatialAnnotations, enableTranscription, enableComments, enableReview: _enableReview, autoSaveInterval: _autoSaveInterval, onAnnotationsChange, onMarkersChange, onTranscriptionChange: _onTranscriptionChange, onAutoSave: _onAutoSave, onFrameExtracted, renderAnnotation, editorSize, className, style, children, ...baseProps }: NiceVideoAnnotatorProps): JSX_2.Element;
+export declare function NiceVideoAnnotator({ video: initialVideo, annotations: initialAnnotations, markers: initialMarkers, transcription: initialTranscription, speakers: initialSpeakers, currentUser, enableSpatialAnnotations, enableTranscription, enableComments, enableReview: _enableReview, autoSaveInterval: _autoSaveInterval, onAnnotationsChange, onMarkersChange, onTranscriptionChange: _onTranscriptionChange, onAutoSave: _onAutoSave, onFrameExtracted, renderAnnotation, editorSize, className, style, children, ...baseProps }: NiceVideoAnnotatorProps): default_2.JSX.Element;
 
 export declare interface NiceVideoAnnotatorProps extends NiceBaseProps {
     /** Editor layout size (minimal / compact / standard / fullscreen). */
@@ -22336,6 +22780,8 @@ export declare interface NiceVideoEditorProps extends NiceBaseProps {
     onAutoSave?: (project: VideoProject) => void;
     /** Read-only mode */
     readOnly?: boolean;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare type NiceViewAccessLevel = 'hidden' | 'readonly' | 'editable';
@@ -22361,6 +22807,10 @@ export declare interface NiceViewAction {
     dataSourceKey?: string;
     /** For custom: handler name registered in the view registry */
     handler?: string;
+    /** For script: inline source executed by the host (never by the UI). */
+    script?: string;
+    /** For script: language of {@link script}. */
+    language?: 'js' | 'csharp';
     /** Additional payload */
     params?: Record<string, unknown>;
     /** Confirmation dialog text (if set, action requires user confirmation) */
@@ -22371,7 +22821,7 @@ export declare interface NiceViewAction {
     errorMessage?: string;
 }
 
-export declare type NiceViewActionType = 'navigate' | 'apiCall' | 'setField' | 'openDialog' | 'closeDialog' | 'submit' | 'refresh' | 'custom';
+export declare type NiceViewActionType = 'navigate' | 'apiCall' | 'setField' | 'openDialog' | 'closeDialog' | 'submit' | 'refresh' | 'script' | 'custom';
 
 /** Binding expression that maps a component prop to a data field or expression. */
 export declare interface NiceViewBinding {
@@ -22568,6 +23018,23 @@ export declare interface NiceViewDiffResult {
     summary: string[];
 }
 
+export declare const NiceViewEditor: ForwardRefExoticComponent<NiceViewEditorProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceViewEditorProps extends NiceStandardProps {
+    /** The view to edit (controlled). */
+    value?: NiceViewDefinitionV2;
+    /** Change callback with the full updated view. */
+    onChange?: (view: NiceViewDefinitionV2) => void;
+    /** Control registry for the live preview. Default `defaultViewRegistry`. */
+    registry?: NiceViewRegistry;
+    /** Entities available for "New from entity" + binding field hints. */
+    entities?: NiceEntityLike[];
+    /** Save callback (shows a Save button when provided). */
+    onSave?: (view: NiceViewDefinitionV2) => void;
+    /** Editor height. Default `560`. */
+    height?: number | string;
+}
+
 /** Event-to-action mapping on a cell. */
 export declare interface NiceViewEventBinding {
     /** DOM/component event name (e.g. "onClick", "onValueChange", "onRowClick") */
@@ -23209,6 +23676,8 @@ export declare interface NiceWorkflowDesignerV2Props extends NiceBaseProps {
     showValidation?: boolean;
     onTest?: (workflow: NiceWorkflowDefinition) => void;
     onPublish?: (workflow: NiceWorkflowDefinition) => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare interface NiceWorkflowState {
@@ -24576,6 +25045,8 @@ export declare interface ReportBuilderProps {
         fields?: string[];
     }>;
     className?: string;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare interface ReportData {
@@ -24649,8 +25120,12 @@ export { resolveDisplayStyleConfig }
 /** Resolve permissions for a set of user roles. */
 export declare function resolvePermissions(userRoleIds: string[], policy: NiceRbacPolicy): NiceResolvedPermissions;
 
+export { resolveStepsI18n }
+
 export { resolveTracelessPolicy }
 
+export { resolveTutorial }
+
 export declare interface Resource {
     id: string;
     name: string;
@@ -27557,6 +28032,10 @@ export { useNiceTranslation }
 
 export declare function useNiceTutorial(): TutorialContextValue;
 
+export { useNiceTutorials }
+
+export { useNiceTutorialsEnabled }
+
 export declare const useNiceValidation: () => ValidationContextValue | null;
 
 /**