@nice2dev/ui 1.0.21 → 1.0.23

package/dist/index.d.ts

@@ -75,7 +75,9 @@ import { Dispatch } from 'react';
 import { DisplayPreferences } from '@nice2dev/ui-core';
 import { endMark } from '@nice2dev/ui-core';
 import { FillVariant } from '@nice2dev/ui-core';
+import { filterGroupToWhere } from '@nice2dev/ui-core';
 import { filterNiceThemePacksByTag } from '@nice2dev/ui-core';
+import { FilterToSqlOptions } from '@nice2dev/ui-core';
 import { forceGC } from '@nice2dev/ui-core';
 import { formatICU } from '@nice2dev/ui-core';
 import { formatShortcut } from '@nice2dev/ui-core';
@@ -130,7 +132,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 +180,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 +261,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';
@@ -271,6 +275,7 @@ import { NiceSkipLink } from '@nice2dev/ui-core';
 import { NiceSkipLinkProps } from '@nice2dev/ui-core';
 import { NiceSortDirection } from '@nice2dev/ui-core';
 import { NiceSortExpression } from '@nice2dev/ui-core';
+import { NiceSqlWhere } from '@nice2dev/ui-core';
 import { NiceSSEConfig } from '@nice2dev/ui-core';
 import { NiceSSEDataSource } from '@nice2dev/ui-core';
 import { NiceSSEMessage } from '@nice2dev/ui-core';
@@ -317,6 +322,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 +368,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';
@@ -371,6 +383,7 @@ import { SHADOW_VALUES } from '@nice2dev/ui-core';
 import { ShadowVariant } from '@nice2dev/ui-core';
 import { simulateKeyboard } from '@nice2dev/ui-core';
 import { simulateType } from '@nice2dev/ui-core';
+import { sortModelToOrderBy } from '@nice2dev/ui-core';
 import { startMark } from '@nice2dev/ui-core';
 import { StorageAdapter } from '@nice2dev/ui-core';
 import { StorageAuditResult } from '@nice2dev/ui-core';
@@ -559,6 +572,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';
@@ -719,6 +734,8 @@ export { aggregate }
 
 export { AggregateFunction }
 
+declare type AggregateFunction_2 = 'COUNT' | 'SUM' | 'AVG' | 'MIN' | 'MAX' | 'COUNT_DISTINCT';
+
 export { AggregateSpec }
 
 export declare type AggregationFunction = 'sum' | 'min' | 'max' | 'count' | 'avg';
@@ -2472,6 +2489,8 @@ declare interface ComputedField {
     dependencies: string[];
 }
 
+declare type ConditionOperator = '=' | '!=' | '>' | '<' | '>=' | '<=' | 'LIKE' | 'NOT LIKE' | 'IN' | 'NOT IN' | 'IS NULL' | 'IS NOT NULL' | 'BETWEEN';
+
 /**
  * Confidence band configuration.
  */
@@ -3116,7 +3135,7 @@ export declare function deserializeRbacPolicy(json: string): NiceRbacPolicy;
 
 export { deserializeTheme }
 
-export declare function deserializeViewV2(json: string): NiceViewDefinitionV2;
+export declare function deserializeView(json: string): NiceViewDefinition;
 
 declare interface DesignState {
     components: ComponentInstance[];
@@ -3332,7 +3351,7 @@ export declare function diffObjects(oldObj: Record<string, unknown>, newObj: Rec
 declare type DiffViewMode = 'split' | 'unified';
 
 /** Compare two view definitions and produce a diff. */
-export declare function diffViews(oldView: NiceViewDefinitionV2, newView: NiceViewDefinitionV2): NiceViewDiffResult;
+export declare function diffViews(oldView: NiceViewDefinition, newView: NiceViewDefinition): NiceViewDiffResult;
 
 export { DisplayPreferences }
 
@@ -3888,6 +3907,28 @@ export declare interface EntityMapping {
     onError?: string;
 }
 
+/**
+ * Scaffold a {@link NiceViewDefinition} 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 entityToView(entity: NiceEntityLike, kind?: NiceEntityViewKind, options?: EntityToViewOptions): NiceViewDefinition;
+
+export declare interface EntityToViewOptions {
+    /** 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 {
@@ -4436,7 +4477,7 @@ export declare interface ExpressionSet {
 }
 
 /** Extract all control types used in a view. */
-export declare function extractControlTypes(view: NiceViewDefinitionV2): string[];
+export declare function extractControlTypes(view: NiceViewDefinition): string[];
 
 /**
  * Extract all CSS variables from a doc
@@ -4683,8 +4724,12 @@ declare interface FileItemActions {
 
 export { FillVariant }
 
+export { filterGroupToWhere }
+
 export { filterNiceThemePacksByTag }
 
+export { FilterToSqlOptions }
+
 export declare type FilterType = 'brightness' | 'contrast' | 'saturation' | 'hue' | 'blur' | 'sharpen' | 'grayscale' | 'sepia' | 'invert' | 'vignette' | 'chromaKey' | 'colorCorrection';
 
 /**
@@ -4920,7 +4965,7 @@ export declare function generateAdapters(config: AdapterGeneratorConfig): Adapte
 export declare function generateAllForRbac(policy: NiceRbacPolicy): NiceGeneratedFile[];
 
 /** Generate all code files for a view definition. */
-export declare function generateAllForView(view: NiceViewDefinitionV2): NiceGeneratedFile[];
+export declare function generateAllForView(view: NiceViewDefinition): NiceGeneratedFile[];
 
 export { generateBadgeStyles }
 
@@ -4929,7 +4974,7 @@ export { generateButtonStyles }
 export { generateCardStyles }
 
 /** Generate a Dart model class from a view definition's data bindings. */
-export declare function generateDartModel(view: NiceViewDefinitionV2): NiceGeneratedFile;
+export declare function generateDartModel(view: NiceViewDefinition): NiceGeneratedFile;
 
 export declare interface GeneratedFile {
     path: string;
@@ -4976,13 +5021,13 @@ export declare function generateRbacTypescript(policy: NiceRbacPolicy): NiceGene
 export declare function generateScaffold(config: NiceScaffoldConfig): NiceScaffoldResult;
 
 /** Generate story files for multiple views. */
-export declare function generateStoriesFromViews(views: NiceViewDefinitionV2[], options?: {
+export declare function generateStoriesFromViews(views: NiceViewDefinition[], options?: {
     basePath?: string;
     showSource?: boolean;
 }): NiceStoryFile[];
 
 /** Generate a Storybook story file from a view definition. */
-export declare function generateStoryFromView(view: NiceViewDefinitionV2, options?: {
+export declare function generateStoryFromView(view: NiceViewDefinition, options?: {
     /** Storybook base path for the title. Default: "ERP Views". */
     basePath?: string;
     /** Whether to include a code panel. Default: true. */
@@ -5005,14 +5050,14 @@ export { generateTooltipStyles }
 export { generateTracelessComplianceReport }
 
 /** Generate a TypeScript interface from a view definition's data bindings. */
-export declare function generateTypescriptModel(view: NiceViewDefinitionV2): NiceGeneratedFile;
+export declare function generateTypescriptModel(view: NiceViewDefinition): NiceGeneratedFile;
 
 export { generateVariantCSS }
 
 export declare function generateVariations(baseHsv: HSV, count: number): string[];
 
 /** Generate a Storybook index/catalog page listing all view stories. */
-export declare function generateViewCatalog(views: NiceViewDefinitionV2[], options?: {
+export declare function generateViewCatalog(views: NiceViewDefinition[], options?: {
     basePath?: string;
 }): NiceStoryFile;
 
@@ -5666,6 +5711,8 @@ export declare type JobStatus = 'idle' | 'running' | 'completed' | 'failed' | 'c
 
 declare type JobStatus_2 = 'pending' | 'running' | 'success' | 'failure' | 'cancelled' | 'skipped' | 'waiting';
 
+declare type JoinType = 'INNER' | 'LEFT' | 'RIGHT' | 'FULL' | 'CROSS';
+
 export { KeyboardShortcut }
 
 declare interface Keyframe_2 {
@@ -6728,6 +6775,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 }
@@ -6773,10 +6823,38 @@ export { NiceAccessControl }
 
 export { NiceAccessControlProps }
 
+export declare const NiceAccessManager: ForwardRefExoticComponent<NiceAccessManagerProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceAccessManagerProps extends NiceBaseProps {
+    /** The RBAC model (controlled). */
+    value: NiceRbacModel;
+    /** Change callback with the full updated model. */
+    onChange: (model: NiceRbacModel) => void;
+    /** Render read-only. */
+    readOnly?: boolean;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
+}
+
 export { NiceAccessMode }
 
 export { NiceAccessPermissions }
 
+/** A node in the protected-resource tree (module → view/entity → …). */
+export declare interface NiceAccessResource {
+    id: string;
+    label: string;
+    type?: 'module' | 'view' | 'entity' | 'field' | 'action' | 'group';
+    children?: NiceAccessResource[];
+}
+
+/** A role/subject that access is granted to. */
+export declare interface NiceAccessRole {
+    id: string;
+    label: string;
+    description?: string;
+}
+
 export declare const NiceAccordion: default_2.FC<NiceAccordionProps>;
 
 /** A panel definition for the {@link NiceAccordion}. */
@@ -6877,6 +6955,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 +7592,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 +7651,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 +7666,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 +7693,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 +7716,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 +7731,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 +7755,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 +7774,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 +8274,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 +8918,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 +9498,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 +9541,8 @@ export declare interface NiceComponentPlaygroundProps extends NiceBaseProps {
     defaultDisplayStyle?: NiceDisplayStyle;
 }
 
+export { NiceComponentTutorial }
+
 export { NiceComponentType }
 
 /** Full type mapping registry. */
@@ -10074,6 +10192,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. */
@@ -10087,7 +10207,7 @@ export declare interface NiceCrossPlatformMeta {
 }
 
 /** Cross-platform view = standard view + cross-platform metadata. */
-export declare interface NiceCrossPlatformView extends NiceViewDefinitionV2 {
+export declare interface NiceCrossPlatformView extends NiceViewDefinition {
     crossPlatform?: NiceCrossPlatformMeta;
 }
 
@@ -10288,7 +10408,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, showAdvancedFilter, advancedFilter, onAdvancedFilterChange, filterFields, filterPresets, onSaveFilterPreset, onDeleteFilterPreset, 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;
@@ -10412,6 +10532,18 @@ export declare interface NiceDataGridProps<T extends Record<string, any> = any>
     sortField?: string;
     sortDirection?: SortDirection;
     onSort?: (field: string, direction: SortDirection) => void;
+    /** Show an "Advanced filter" toolbar button that opens a NiceFilterBuilder panel. */
+    showAdvancedFilter?: boolean;
+    /** The advanced filter tree (controlled). Applied client-side unless a dataSource is bound. */
+    advancedFilter?: NiceFilterGroup;
+    /** Change callback for the advanced filter. */
+    onAdvancedFilterChange?: (filter: NiceFilterGroup) => void;
+    /** Filterable fields for the builder. Defaults to the (filterable) columns. */
+    filterFields?: NiceFilterField[];
+    /** Saved filter presets shown in the builder. */
+    filterPresets?: NiceFilterPreset[];
+    onSaveFilterPreset?: (preset: NiceFilterPreset) => void;
+    onDeleteFilterPreset?: (name: string) => void;
     selectable?: boolean;
     selectedKeys?: Set<string>;
     onSelectionChange?: (keys: Set<string>) => void;
@@ -10567,6 +10699,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>;
@@ -10591,10 +10725,47 @@ export declare interface NiceDataSnapshotProps extends NiceBaseProps {
 
 export { NiceDataSource }
 
+export declare const NiceDataSourceBuilder: ForwardRefExoticComponent<NiceDataSourceBuilderProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceDataSourceBuilderProps extends NiceBaseProps {
+    /** The data source being edited (controlled). */
+    value?: NiceDataSourceDef;
+    /** Change callback with the full updated data source (incl. generated SQL). */
+    onChange?: (ds: NiceDataSourceDef) => void;
+    /** Tables available from the connected database schema(s) — host-supplied. */
+    schemas: NiceDataSourceSchemaTable[];
+    /** Optional ER/schema preview slot (e.g. NiceDatabaseSchemaViewer from ui-diagrams). */
+    renderSchemaPreview?: (schemas: NiceDataSourceSchemaTable[]) => React.ReactNode;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
+}
+
 export { NiceDataSourceConfig }
 
+/** A reusable, serializable data source (maps to a view-standard `query` source). */
+export declare interface NiceDataSourceDef {
+    key: string;
+    label?: string;
+    kind: 'query';
+    query: NiceQueryModel;
+    /** Generated SQL view (read-only artifact derived from `query`). */
+    sql: string;
+}
+
 export { NiceDataSourceEventMap }
 
+/** A table the host exposes from a connected database schema. */
+export declare interface NiceDataSourceSchemaTable {
+    name: string;
+    schema?: string;
+    columns: Array<{
+        name: string;
+        dataType: string;
+        isPrimaryKey?: boolean;
+        isForeignKey?: boolean;
+    }>;
+}
+
 export { NiceDataSourceState }
 
 /** Predefined date-format presets. */
@@ -10810,7 +10981,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 +11018,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 +11183,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 +11278,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 +11682,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 +11734,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 +11748,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 +12328,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 +13241,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 +13326,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 +13357,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 +13506,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 +13790,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 +13853,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 +13907,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 +14121,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 +14454,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 +14693,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 +14774,12 @@ export declare interface NiceLoginFormProps extends NiceStandardProps {
     passwordPlaceholder?: string;
 }
 
+/**
+ * Severity of a single console entry. `'trace'` sits below `'debug'` to mirror
+ * standard loggers (Microsoft.Extensions.Logging, Serilog, Python logging, …).
+ */
+export declare type NiceLogLevel = 'trace' | 'log' | 'info' | 'warn' | 'error' | 'debug';
+
 export declare const NiceLogo: default_2.ForwardRefExoticComponent<NiceLogoProps & default_2.RefAttributes<HTMLElement>>;
 
 export declare interface NiceLogoProps {
@@ -14544,9 +14898,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 +15057,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 +15414,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 +16765,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 +16938,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 +17214,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>;
@@ -17403,6 +17769,18 @@ export declare interface NiceQRCodeProps extends NiceStandardProps {
 /** Reed-Solomon error correction level for QR codes. */
 export declare type NiceQRErrorCorrection = 'L' | 'M' | 'Q' | 'H';
 
+/** The visual query model owned by the builder. */
+export declare interface NiceQueryModel {
+    tables: QueryTable[];
+    joins: QueryJoin[];
+    conditions: QueryCondition[];
+    sorts: QuerySort[];
+    groupBy: QueryGroupBy[];
+    distinct: boolean;
+    limit?: number;
+    offset?: number;
+}
+
 /**
  * {@link NiceQuestCard} — Displays a quest/task card with progress, rewards, deadline and action buttons.
  */
@@ -17685,6 +18063,16 @@ export declare interface NiceRbacDenyRule {
     actions: RbacAction[];
 }
 
+/** The full RBAC model: roles, the resource tree, the action columns, and grants. */
+export declare interface NiceRbacModel {
+    roles: NiceAccessRole[];
+    resources: NiceAccessResource[];
+    /** Action columns (view/create/edit/delete/…) applied per resource. */
+    actions: PermissionAction[];
+    /** `grants[resourceId]` is a `roleId:actionId → boolean|'inherited'` map. */
+    grants: Record<string, PermissionMatrixValue>;
+}
+
 /** Single permission granting or denying an action on a resource. */
 export declare interface NiceRbacPermission {
     /** Resource key (e.g. "sales.orders", "inventory.products"). */
@@ -17823,6 +18211,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 +18485,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 +18640,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 +18946,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 +19136,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 +19383,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;
@@ -19104,6 +19598,9 @@ export declare interface NiceShowcaseProps extends NiceBaseProps {
 /** Available showcase tabs for the {@link NiceShowcase} component. */
 export declare type NiceShowcaseTab = 'about' | 'dashboard' | 'users' | 'data' | 'forms' | 'scheduling' | 'files' | 'controls' | 'docs' | 'theme-designer';
 
+/** Context-menu / gesture actions that can be selectively disabled (e.g. for guests). */
+declare type NiceSidebarContextMenuAction = 'hide' | 'reorder' | 'rename' | 'newGroup' | 'collapseToggle';
+
 export declare const NiceSidebarNav: ForwardRefExoticComponent<NiceSidebarNavProps & RefAttributes<HTMLDivElement>>;
 
 export declare interface NiceSidebarNavProps {
@@ -19132,6 +19629,21 @@ export declare interface NiceSidebarNavProps {
     routeToUrl?: (route: string) => string;
     /** Enable the right-click context menu on view nodes. Default `true`. */
     contextMenu?: boolean;
+    /**
+     * Disable individual destructive context-menu actions (and the matching
+     * gestures). Listed actions render greyed-out; non-destructive actions
+     * ("Open in new tab", "Copy link", favorites) stay enabled. Useful for guest
+     * / demo panels that have no Preferences page to recover from accidental edits.
+     */
+    disabledContextMenuActions?: NiceSidebarContextMenuAction[];
+    /**
+     * Shorthand for read-only mode: disables every destructive context-menu
+     * action ('hide', 'reorder', 'rename', 'newGroup') and drag-reorder, while
+     * keeping navigation, expand/collapse and "Open in new tab" / "Copy link".
+     * Equivalent to passing the full destructive list to
+     * {@link disabledContextMenuActions}. Default `false`.
+     */
+    readonly?: boolean;
     /**
      * Override the initial enableModeIcons flag.
      * Can be toggled later via Preferences.
@@ -19155,12 +19667,20 @@ export declare interface NiceSidebarNavProps {
      */
     position?: 'left' | 'right';
     /**
-     * **Minimal mode** — hides the mode strip, sources, favorites and footer
-     * preferences, leaving only the navigation tree. Use for stripped-down
-     * shells (auth flows, embedded views) where the full taxonomy is overkill.
-     * Default `false`.
+     * **Minimal mode** — shorthand that hides the mode strip, source headers,
+     * the favorites view and the footer preferences, leaving only the navigation
+     * tree. Equivalent to setting all four `show*` flags below to `false`. The
+     * granular flags override it when set explicitly. Default `false`.
      */
     minimal?: boolean;
+    /** Show the mode-icon strip (Pinned / Recent / All / Prefs). Default `!minimal`. */
+    showModeStrip?: boolean;
+    /** Show source section headers above their trees. Default `!minimal`. */
+    showSources?: boolean;
+    /** Allow the Favorites view/mode. Default `!minimal`. */
+    showFavorites?: boolean;
+    /** Allow the footer Preferences view/mode. Default `!minimal`. */
+    showFooterPreferences?: boolean;
     /**
      * **Embedded mode** — render the sidebar inside another container (e.g. a
      * mobile drawer / hamburger menu). Forces full width, drops the footer with
@@ -19451,7 +19971,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;
@@ -19736,6 +20256,8 @@ export declare interface NiceSpreadsheetSheet {
     columnFilters?: Record<number, string>;
 }
 
+export { NiceSqlWhere }
+
 export { NiceSSEConfig }
 
 export { NiceSSEDataSource }
@@ -19811,6 +20333,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 +20506,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 +20749,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 +21081,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 +21177,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 +21446,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 +22017,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 +22065,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 +22124,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 +22364,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 +22407,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 +22422,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 +22462,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 +22496,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 +22851,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 +22924,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 +22951,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 +22965,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 {
@@ -22402,7 +22996,7 @@ export declare class NiceViewCache {
     /** Get a cached view definition. Returns undefined if not found or expired. */
     get(module: string, viewId: string): Promise<NiceViewCacheEntry | undefined>;
     /** Store a view definition in the cache. */
-    set(module: string, viewId: string, view: NiceViewDefinitionV2, etag?: string): Promise<void>;
+    set(module: string, viewId: string, view: NiceViewDefinition, etag?: string): Promise<void>;
     /** Remove a specific view from cache. */
     remove(module: string, viewId: string): Promise<void>;
     /** Clear all cached views. */
@@ -22428,7 +23022,7 @@ export declare interface NiceViewCacheConfig {
 /** Cached view entry with metadata. */
 export declare interface NiceViewCacheEntry {
     /** View definition */
-    view: NiceViewDefinitionV2;
+    view: NiceViewDefinition;
     /** ETag for conditional refresh */
     etag?: string;
     /** Timestamp when cached (ms since epoch) */
@@ -22440,7 +23034,7 @@ export declare interface NiceViewCacheEntry {
 }
 
 /** Extended cell definition with data binding, actions, and permissions. */
-export declare interface NiceViewCellV2 {
+export declare interface NiceViewCell {
     id: string;
     /** Component type key (maps to NiceViewRegistry) */
     controlType: string;
@@ -22507,7 +23101,7 @@ export declare interface NiceViewDataStore {
 }
 
 /** Full view definition v2 with data binding, actions, and permissions. */
-export declare interface NiceViewDefinitionV2 {
+export declare interface NiceViewDefinition {
     /** Unique view identifier */
     id: string;
     /** Display name */
@@ -22519,7 +23113,7 @@ export declare interface NiceViewDefinitionV2 {
     /** Grid columns count */
     columns?: number;
     /** Top-level rows */
-    rows?: NiceViewRowV2[];
+    rows?: NiceViewRow[];
     /** Optional nested container layout (replaces rows for complex layouts) */
     container?: NiceViewContainer;
     /** Alias for `container` — convenience root layout node. */
@@ -22568,6 +23162,25 @@ 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?: NiceViewDefinition;
+    /** Change callback with the full updated view. */
+    onChange?: (view: NiceViewDefinition) => 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: NiceViewDefinition) => void;
+    /** Editor height. Default `560`. */
+    height?: number | string;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
+}
+
 /** Event-to-action mapping on a cell. */
 export declare interface NiceViewEventBinding {
     /** DOM/component event name (e.g. "onClick", "onValueChange", "onRowClick") */
@@ -22627,7 +23240,7 @@ export declare class NiceViewFetchError extends Error {
 /** Result of a view fetch operation. */
 export declare interface NiceViewFetchResult {
     /** The fetched view definition (undefined if 304 Not Modified) */
-    view?: NiceViewDefinitionV2;
+    view?: NiceViewDefinition;
     /** HTTP status code */
     status: number;
     /** ETag from response (for conditional requests) */
@@ -22739,15 +23352,11 @@ export declare class NiceViewRegistry {
     clear(): void;
 }
 
-export declare const NiceViewRenderer: ForwardRefExoticComponent<NiceViewRendererV2Props & RefAttributes<HTMLDivElement>>;
-
-export declare type NiceViewRendererProps = NiceViewRendererV2Props;
+export declare const NiceViewRenderer: default_2.ForwardRefExoticComponent<NiceViewRendererProps & default_2.RefAttributes<HTMLDivElement>>;
 
-export declare const NiceViewRendererV2: default_2.ForwardRefExoticComponent<NiceViewRendererV2Props & default_2.RefAttributes<HTMLDivElement>>;
-
-export declare interface NiceViewRendererV2Props extends NiceBaseProps {
+export declare interface NiceViewRendererProps extends NiceBaseProps {
     /** The v2 view definition to render. */
-    view: NiceViewDefinitionV2;
+    view: NiceViewDefinition;
     /** Optional registry (uses defaultViewRegistry if omitted). */
     registry?: NiceViewRegistry;
     /** Data store providing bound data. */
@@ -22768,12 +23377,22 @@ export declare interface NiceViewRendererV2Props extends NiceBaseProps {
     }>;
     /** Record index for list/detail contexts. */
     recordIndex?: number;
+    /**
+     * Execute an inline V2 `script` action (the `'script'` action type). The renderer never
+     * evaluates script source itself — supply a host bridge here (e.g. a sandbox, or a
+     * Jint/Roslyn test endpoint). When omitted, `script` actions are skipped with a warning.
+     */
+    onRunScript?: (script: string, meta: {
+        language: 'js' | 'csharp';
+        action: NiceViewAction;
+        context: NiceActionContext;
+    }) => void | Promise<void>;
 }
 
 /** Row in a v2 layout. */
-export declare interface NiceViewRowV2 {
+export declare interface NiceViewRow {
     id: string;
-    cells: NiceViewCellV2[];
+    cells: NiceViewCell[];
     height?: string;
     /** Visibility expression */
     visibleWhen?: string;
@@ -22787,7 +23406,7 @@ export declare interface NiceViewSection {
     label?: string;
     icon?: string;
     /** Rows inside this section */
-    rows: NiceViewRowV2[];
+    rows: NiceViewRow[];
     /** Nested container (for deep layouts) */
     container?: NiceViewContainer;
 }
@@ -22813,7 +23432,7 @@ export declare interface NiceViewToolbarItem {
     items?: Omit<NiceViewToolbarItem, 'items'>[];
 }
 
-export declare type NiceViewUpdateListener = (view: NiceViewDefinitionV2) => void;
+export declare type NiceViewUpdateListener = (view: NiceViewDefinition) => void;
 
 export declare const NiceVirtualScroller: <T>(props: NiceVirtualScrollerProps<T> & {
     ref?: default_2.ForwardedRef<HTMLDivElement>;
@@ -23173,9 +23792,9 @@ export declare interface NiceWorkflowDefinition {
     bpmn?: BPMNProcessDefinition;
 }
 
-export declare const NiceWorkflowDesignerV2: default_2.FC<NiceWorkflowDesignerV2Props>;
+export declare const NiceWorkflowDesigner: default_2.FC<NiceWorkflowDesignerProps>;
 
-export declare interface NiceWorkflowDesignerV2Props extends NiceBaseProps {
+export declare interface NiceWorkflowDesignerProps extends NiceBaseProps {
     workflow?: NiceWorkflowDefinition;
     /** Convenience: flat node list mapped into `workflow.states` when `workflow` is omitted. */
     nodes?: Array<{
@@ -23209,6 +23828,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 {
@@ -24178,6 +24799,60 @@ export declare interface QualityPresetDefinition {
     profile: Partial<TranscodeProfile>;
 }
 
+declare interface QueryColumn {
+    name: string;
+    dataType: string;
+    isPrimaryKey?: boolean;
+    isForeignKey?: boolean;
+    selected: boolean;
+    alias?: string;
+    aggregate?: AggregateFunction_2;
+}
+
+declare interface QueryCondition {
+    id: string;
+    tableId: string;
+    column: string;
+    operator: ConditionOperator;
+    value: string;
+    value2?: string;
+    logicalOperator?: 'AND' | 'OR';
+    groupId?: string;
+}
+
+declare interface QueryGroupBy {
+    tableId: string;
+    column: string;
+}
+
+declare interface QueryJoin {
+    id: string;
+    type: JoinType;
+    leftTableId: string;
+    leftColumn: string;
+    rightTableId: string;
+    rightColumn: string;
+}
+
+declare interface QuerySort {
+    id: string;
+    tableId: string;
+    column: string;
+    direction: SortDirection_2;
+}
+
+declare interface QueryTable {
+    id: string;
+    name: string;
+    alias?: string;
+    schema?: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    columns: QueryColumn[];
+}
+
 /** Quest reward definition. */
 export declare interface QuestReward {
     type: 'xp' | 'badge' | 'item' | 'currency' | 'custom';
@@ -24576,6 +25251,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 +25326,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;
@@ -25124,7 +25805,7 @@ export declare function serializeRbacPolicy(policy: NiceRbacPolicy): string;
 
 export { serializeTheme }
 
-export declare function serializeViewV2(view: NiceViewDefinitionV2): string;
+export declare function serializeView(view: NiceViewDefinition): string;
 
 /**
  * useServiceWorker — Service Worker registration and update management
@@ -25370,6 +26051,7 @@ export declare interface SidebarNavHelpers {
     removeFavorite: (id: string) => void;
     setMaxDepth: (mode: SidebarNavMode, depth: number) => void;
     toggleCollapse: (nodeId: string) => void;
+    setCollapsed: (ids: string[], collapsed: boolean) => void;
     setAutoExpand: (v: boolean) => void;
     /** Set the user's preferred left-click behaviour for sidebar items. */
     setLeftClickBehavior: (v: 'focus-existing' | 'open-new') => void;
@@ -25656,6 +26338,10 @@ export declare interface SnapshotSchedule {
 /** Sort direction for grid columns (`null` = unsorted). */
 declare type SortDirection = 'asc' | 'desc' | null;
 
+declare type SortDirection_2 = 'ASC' | 'DESC';
+
+export { sortModelToOrderBy }
+
 /** Sort option */
 export declare type SortOption = 'name-asc' | 'name-desc' | 'date-asc' | 'date-desc' | 'size-asc' | 'size-desc' | 'relevance';
 
@@ -27557,6 +28243,10 @@ export { useNiceTranslation }
 
 export declare function useNiceTutorial(): TutorialContextValue;
 
+export { useNiceTutorials }
+
+export { useNiceTutorialsEnabled }
+
 export declare const useNiceValidation: () => ValidationContextValue | null;
 
 /**
@@ -27978,13 +28668,13 @@ export declare function validateModuleManifest(m: NiceModuleManifest): string[];
 export declare function validateRbacPolicy(policy: NiceRbacPolicy): string[];
 
 /** Validate a v2 view definition, returning an array of error messages. */
-export declare function validateViewDefinitionV2(view: NiceViewDefinitionV2): string[];
+export declare function validateViewDefinition(view: NiceViewDefinition): string[];
 
 /** Full validation of a view definition before deploy. */
-export declare function validateViewForDeploy(view: NiceViewDefinitionV2, config?: NiceValidatorConfig): NiceValidationReport;
+export declare function validateViewForDeploy(view: NiceViewDefinition, config?: NiceValidatorConfig): NiceValidationReport;
 
 /** Batch-validate multiple views. */
-export declare function validateViewsBatch(views: NiceViewDefinitionV2[], config?: NiceValidatorConfig): NiceValidationReport[];
+export declare function validateViewsBatch(views: NiceViewDefinition[], config?: NiceValidatorConfig): NiceValidationReport[];
 
 declare interface ValidationContextValue {
     register: (name: string, validate: () => NiceValidationResult) => void;