@nice2dev/ui 1.0.22 → 1.0.24

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';
@@ -273,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';
@@ -380,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';
@@ -730,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';
@@ -2483,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.
  */
@@ -3127,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[];
@@ -3343,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 }
 
@@ -3900,15 +3908,15 @@ export declare interface EntityMapping {
 }
 
 /**
- * Scaffold a {@link NiceViewDefinitionV2} from an entity:
+ * 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 entityToViewV2(entity: NiceEntityLike, kind?: NiceEntityViewKind, options?: EntityToViewV2Options): NiceViewDefinitionV2;
+export declare function entityToView(entity: NiceEntityLike, kind?: NiceEntityViewKind, options?: EntityToViewOptions): NiceViewDefinition;
 
-export declare interface EntityToViewV2Options {
+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. */
@@ -4469,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
@@ -4716,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';
 
 /**
@@ -4953,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 }
 
@@ -4962,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;
@@ -5009,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. */
@@ -5038,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;
 
@@ -5699,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 {
@@ -6809,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}. */
@@ -10165,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;
 }
 
@@ -10366,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>): default_2.JSX.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;
@@ -10490,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;
@@ -10671,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. */
@@ -14683,8 +14774,11 @@ export declare interface NiceLoginFormProps extends NiceStandardProps {
     passwordPlaceholder?: string;
 }
 
-/** Severity of a single console entry. */
-export declare type NiceLogLevel = 'log' | 'info' | 'warn' | 'error' | 'debug';
+/**
+ * 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>>;
 
@@ -17675,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.
  */
@@ -17957,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"). */
@@ -19482,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 {
@@ -19510,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.
@@ -19533,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
@@ -20114,6 +20256,8 @@ export declare interface NiceSpreadsheetSheet {
     columnFilters?: Record<number, string>;
 }
 
+export { NiceSqlWhere }
+
 export { NiceSSEConfig }
 
 export { NiceSSEDataSource }
@@ -22852,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. */
@@ -22878,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) */
@@ -22890,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;
@@ -22957,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 */
@@ -22969,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. */
@@ -23022,17 +23166,19 @@ export declare const NiceViewEditor: ForwardRefExoticComponent<NiceViewEditorPro
 
 export declare interface NiceViewEditorProps extends NiceStandardProps {
     /** The view to edit (controlled). */
-    value?: NiceViewDefinitionV2;
+    value?: NiceViewDefinition;
     /** Change callback with the full updated view. */
-    onChange?: (view: NiceViewDefinitionV2) => void;
+    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: NiceViewDefinitionV2) => void;
+    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. */
@@ -23094,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) */
@@ -23206,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 NiceViewRendererV2: default_2.ForwardRefExoticComponent<NiceViewRendererV2Props & default_2.RefAttributes<HTMLDivElement>>;
+export declare const NiceViewRenderer: default_2.ForwardRefExoticComponent<NiceViewRendererProps & 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. */
@@ -23235,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;
@@ -23254,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;
 }
@@ -23280,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>;
@@ -23640,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<{
@@ -24647,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';
@@ -25599,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
@@ -25845,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;
@@ -26131,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';
 
@@ -28457,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;