@nice2dev/ui 1.3.17 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/CHANGELOG.md +146 -0
  2. package/README.md +29 -2
  3. package/dist/{NiceDataGrid-aNPAHsWy.cjs → NiceDataGrid-BT6iCUgP.cjs} +1 -1
  4. package/dist/NiceForm-Bysp66Ef.cjs +1 -0
  5. package/dist/{NiceMention-CMqAGvO0.cjs → NiceMention-sc8W-DwH.cjs} +1 -1
  6. package/dist/NiceModuleLifecyclePanel-DBQPCa_V.cjs +1 -0
  7. package/dist/{NiceSavedQueryPanel-JHrSlHAV.cjs → NiceSavedQueryPanel-BbznsXFd.cjs} +1 -1
  8. package/dist/{NiceScheduler-2TwOZq-y.cjs → NiceScheduler-3Ez0zSQJ.cjs} +1 -1
  9. package/dist/{core-lazy-Cda-D35m.cjs → core-lazy-CL4ZIxF-.cjs} +1 -1
  10. package/dist/data/treeDragSession.mjs +52 -46
  11. package/dist/data.cjs +1 -1
  12. package/dist/editors/inputs/NiceAutocomplete.mjs +44 -46
  13. package/dist/editors/pickers/NiceDateTimePicker.mjs +1 -1
  14. package/dist/editors/pickers/pickerCommons.mjs +284 -87
  15. package/dist/editors/pickers/themePickerHelpers.mjs +10 -8
  16. package/dist/editors.cjs +1 -1
  17. package/dist/index.cjs +162 -162
  18. package/dist/index.d.ts +253 -31
  19. package/dist/index.mjs +1517 -1483
  20. package/dist/navigation/NiceIconRail.mjs +74 -53
  21. package/dist/navigation/NiceNavShell.mjs +855 -807
  22. package/dist/navigation/NiceSetupWizard.mjs +287 -278
  23. package/dist/navigation/NiceSidebarNav.mjs +1487 -1144
  24. package/dist/navigation/navItemDrag.mjs +42 -0
  25. package/dist/navigation/navShellPane.mjs +16 -11
  26. package/dist/navigation/sidebarColors.mjs +61 -50
  27. package/dist/navigation/sidebarNavTypes.mjs +1 -0
  28. package/dist/navigation/sidebarSearch.mjs +28 -0
  29. package/dist/navigation.cjs +1 -1
  30. package/dist/navigation.d.ts +70 -21
  31. package/dist/pickerCommons-CwcCc8Qi.cjs +1 -0
  32. package/dist/planning/NiceResourceAllocation.mjs +31 -31
  33. package/dist/style.css +4 -4
  34. package/dist/tools/NiceThemeDesigner.mjs +781 -708
  35. package/dist/tools/NiceThemePreview.mjs +344 -282
  36. package/dist/tools/themeCatalog.mjs +28 -44
  37. package/dist/tools/themeCatalogArchive.mjs +38 -0
  38. package/dist/tools/themeDesigner/ThemeSetEditors.mjs +400 -0
  39. package/dist/tools/themeDesigner/ThemeValueField.mjs +146 -0
  40. package/dist/tools/themeDesigner/themeDesignerPaths.mjs +105 -0
  41. package/package.json +4 -4
  42. package/dist/NiceForm-BtRBLffD.cjs +0 -1
  43. package/dist/NiceModuleLifecyclePanel-ugNtHimh.cjs +0 -1
  44. package/dist/pickerCommons-BWglYl6J.cjs +0 -1
package/dist/index.d.ts CHANGED
@@ -37,6 +37,7 @@ import { clearLeakReports } from '@nice2dev/ui-core';
37
37
  import { clearProfilingData } from '@nice2dev/ui-core';
38
38
  import { clickOnActivationKey } from '@nice2dev/ui-core';
39
39
  import { CognitiveAccessibilityOptions } from '@nice2dev/ui-core';
40
+ import { colorSetSnapshot } from '@nice2dev/ui-core';
40
41
  import { ColumnFormulas } from '@nice2dev/ui-core';
41
42
  import { COMMON_SHORTCUTS } from '@nice2dev/ui-core';
42
43
  import { Component } from 'react';
@@ -75,6 +76,7 @@ import { DENSITY_VALUES } from '@nice2dev/ui-core';
75
76
  import { DensityVariant } from '@nice2dev/ui-core';
76
77
  import { deprecateProp } from '@nice2dev/ui-core';
77
78
  import { deprecateSymbol } from '@nice2dev/ui-core';
79
+ import { deriveColorSet } from '@nice2dev/ui-core';
78
80
  import { deserializeTheme } from '@nice2dev/ui-core';
79
81
  import { detectGamepadFamily } from '@nice2dev/ui-core';
80
82
  import { Dispatch } from 'react';
@@ -127,6 +129,7 @@ import { getPerformanceReport } from '@nice2dev/ui-core';
127
129
  import { getProfilingStats } from '@nice2dev/ui-core';
128
130
  import { getRecentTimings } from '@nice2dev/ui-core';
129
131
  import { getSlowRenders } from '@nice2dev/ui-core';
132
+ import { getThemeValue } from '@nice2dev/ui-core';
130
133
  import { getTracelessBadgeInfo } from '@nice2dev/ui-core';
131
134
  import { GraphQLSubscriptionConfig } from '@nice2dev/ui-core';
132
135
  import { GraphQLSubscriptionSource } from '@nice2dev/ui-core';
@@ -173,6 +176,10 @@ import { NICE_DISPLAY_STYLES } from '@nice2dev/ui-core';
173
176
  import { NICE_INPUT_DEFAULTS } from '@nice2dev/ui-core';
174
177
  import { NICE_INTENT_EVENT } from '@nice2dev/ui-core';
175
178
  import { NICE_INTENTS } from '@nice2dev/ui-core';
179
+ import { NICE_THEME_ARCHIVE } from '@nice2dev/ui-core';
180
+ import { NICE_THEME_CURATED } from '@nice2dev/ui-core';
181
+ import { NICE_THEME_CURATED_PACKS } from '@nice2dev/ui-core';
182
+ import { NICE_THEME_DEFAULT } from '@nice2dev/ui-core';
176
183
  import { NICE_THEME_GALLERY } from '@nice2dev/ui-core';
177
184
  import { NICE_THEME_PACK_FONT_LINKS } from '@nice2dev/ui-core';
178
185
  import { NICE_THEME_PACK_FONT_LINKS_EXTENDED } from '@nice2dev/ui-core';
@@ -204,6 +211,9 @@ import { NiceButtonPromptProps } from '@nice2dev/ui-core';
204
211
  import { NiceCacheConfig } from '@nice2dev/ui-core';
205
212
  import { NiceChangeMeta } from '@nice2dev/ui-core';
206
213
  import { NiceChangeReason } from '@nice2dev/ui-core';
214
+ import { NiceColorLevel } from '@nice2dev/ui-core';
215
+ import { NiceColorSet } from '@nice2dev/ui-core';
216
+ import { NiceColorSetMode } from '@nice2dev/ui-core';
207
217
  import { NiceComponentTutorial } from '@nice2dev/ui-core';
208
218
  import { NiceComponentType } from '@nice2dev/ui-core';
209
219
  import { NiceCrossTabSyncConfig } from '@nice2dev/ui-core';
@@ -317,6 +327,8 @@ import { niceReduxActions } from '@nice2dev/ui-core';
317
327
  import { NiceReduxMiddlewareConfig } from '@nice2dev/ui-core';
318
328
  import { niceReduxReducer } from '@nice2dev/ui-core';
319
329
  import { NiceRequestDeduplicator } from '@nice2dev/ui-core';
330
+ import { NiceResolvedLevel } from '@nice2dev/ui-core';
331
+ import { NiceResolvedTheme } from '@nice2dev/ui-core';
320
332
  import { NiceResolvedTutorialStep } from '@nice2dev/ui-core';
321
333
  import { NiceResponsiveValue } from '@nice2dev/ui-core';
322
334
  import { NiceRestConfig } from '@nice2dev/ui-core';
@@ -326,6 +338,7 @@ import { NiceRTLProviderProps } from '@nice2dev/ui-core';
326
338
  import { NiceSaveWorkspaceStateRequest } from '@nice2dev/ui-core';
327
339
  import { NiceScrollContainer } from '@nice2dev/ui-core';
328
340
  import { niceSelectors } from '@nice2dev/ui-core';
341
+ import { NiceSideNavRole } from '@nice2dev/ui-core';
329
342
  import { NiceSignalRConfig } from '@nice2dev/ui-core';
330
343
  import { NiceSize } from '@nice2dev/ui-core';
331
344
  import { NiceSkipLink } from '@nice2dev/ui-core';
@@ -345,14 +358,18 @@ import { NiceStandardFieldProps } from '@nice2dev/ui-core';
345
358
  import { NiceStandardProps } from '@nice2dev/ui-core';
346
359
  import { NiceStateIO } from '@nice2dev/ui-core';
347
360
  import { NiceStateSnapshot } from '@nice2dev/ui-core';
361
+ import { NiceSurfaceRole } from '@nice2dev/ui-core';
348
362
  import { NiceSwipeableListItem } from '@nice2dev/ui-core';
349
363
  import { NiceSwipeableListItemProps } from '@nice2dev/ui-core';
350
364
  import { NiceTabDescriptor } from '@nice2dev/ui-core';
351
365
  import { NiceTestWrapper } from '@nice2dev/ui-core';
352
366
  import { NiceTestWrapperProps } from '@nice2dev/ui-core';
353
367
  import { NiceTheme } from '@nice2dev/ui-core';
368
+ import { NiceThemeArchive } from '@nice2dev/ui-core';
354
369
  import { NiceThemeBackgroundImage } from '@nice2dev/ui-core';
355
370
  import { NiceThemeBackgrounds } from '@nice2dev/ui-core';
371
+ import { niceThemeBankingV2 } from '@nice2dev/ui-core';
372
+ import { niceThemeBlackTieGala } from '@nice2dev/ui-core';
356
373
  import { niceThemeBlue } from '@nice2dev/ui-core';
357
374
  import { niceThemeBootstrap } from '@nice2dev/ui-core';
358
375
  import { NiceThemeBorders } from '@nice2dev/ui-core';
@@ -360,20 +377,32 @@ import { NiceThemeColors } from '@nice2dev/ui-core';
360
377
  import { NiceThemeContext } from '@nice2dev/ui-core';
361
378
  import { niceThemeDark } from '@nice2dev/ui-core';
362
379
  import { NiceThemeDarkMode } from '@nice2dev/ui-core';
380
+ import { NiceThemeDiagnostic } from '@nice2dev/ui-core';
363
381
  import { niceThemeFluent } from '@nice2dev/ui-core';
382
+ import { niceThemeFluentV2 } from '@nice2dev/ui-core';
383
+ import { NiceThemeGradient } from '@nice2dev/ui-core';
364
384
  import { niceThemeHighContrast } from '@nice2dev/ui-core';
385
+ import { NiceThemeLayout } from '@nice2dev/ui-core';
365
386
  import { niceThemeLight } from '@nice2dev/ui-core';
366
387
  import { niceThemeMaterial } from '@nice2dev/ui-core';
388
+ import { niceThemeMinimalism } from '@nice2dev/ui-core';
389
+ import { niceThemeObsidianV2 } from '@nice2dev/ui-core';
390
+ import { niceThemeOnyxV2 } from '@nice2dev/ui-core';
367
391
  import { NiceThemePack } from '@nice2dev/ui-core';
368
392
  import { NiceThemePackId } from '@nice2dev/ui-core';
369
393
  import { NiceThemePackMeta } from '@nice2dev/ui-core';
394
+ import { NiceThemePreviewRoles } from '@nice2dev/ui-core';
370
395
  import { NiceThemeProvider } from '@nice2dev/ui-core';
371
396
  import { NiceThemeProviderProps } from '@nice2dev/ui-core';
397
+ import { NiceThemeScrollbar } from '@nice2dev/ui-core';
372
398
  import { NiceThemeShadows } from '@nice2dev/ui-core';
399
+ import { niceThemeShadowV2 } from '@nice2dev/ui-core';
400
+ import { niceThemeSlateV2 } from '@nice2dev/ui-core';
373
401
  import { NiceThemeSpacing } from '@nice2dev/ui-core';
374
402
  import { NiceThemeText } from '@nice2dev/ui-core';
375
403
  import { NiceThemeTransitions } from '@nice2dev/ui-core';
376
404
  import { NiceThemeTypography } from '@nice2dev/ui-core';
405
+ import { NiceThemeValue } from '@nice2dev/ui-core';
377
406
  import { NiceThemeVariantConfigurator } from '@nice2dev/ui-core';
378
407
  import { NiceThemeVariantConfiguratorProps } from '@nice2dev/ui-core';
379
408
  import { NiceThemeVariantProvider } from '@nice2dev/ui-core';
@@ -405,6 +434,7 @@ import { OpenAPIGeneratedUI } from '@nice2dev/ui-core';
405
434
  import { OpenAPIProperty } from '@nice2dev/ui-core';
406
435
  import { OpenAPISchema } from '@nice2dev/ui-core';
407
436
  import { PanGesture } from '@nice2dev/ui-core';
437
+ import { parseThemeRef } from '@nice2dev/ui-core';
408
438
  import { PerformanceMark as PerformanceMark_2 } from '@nice2dev/ui-core';
409
439
  import { PinchGesture } from '@nice2dev/ui-core';
410
440
  import { pivot } from '@nice2dev/ui-core';
@@ -425,11 +455,14 @@ import { ReduxAction } from '@nice2dev/ui-core';
425
455
  import { ReduxMiddleware } from '@nice2dev/ui-core';
426
456
  import { RefAttributes } from 'react';
427
457
  import { removeTheme } from '@nice2dev/ui-core';
458
+ import { renameThemeRef } from '@nice2dev/ui-core';
428
459
  import { RenderStats } from '@nice2dev/ui-core';
429
460
  import { RenderTiming } from '@nice2dev/ui-core';
430
461
  import { resolveCssColor } from '@nice2dev/ui-core';
431
462
  import { resolveDisplayStyleConfig } from '@nice2dev/ui-core';
432
463
  import { resolveStepsI18n } from '@nice2dev/ui-core';
464
+ import { resolveTheme } from '@nice2dev/ui-core';
465
+ import { resolveThemeValue } from '@nice2dev/ui-core';
433
466
  import { resolveTracelessPolicy } from '@nice2dev/ui-core';
434
467
  import { resolveTutorial } from '@nice2dev/ui-core';
435
468
  import { RestAPISyncAdapter } from '@nice2dev/ui-core';
@@ -458,6 +491,10 @@ import { TableStyleVariant } from '@nice2dev/ui-core';
458
491
  import { TabStyleVariant } from '@nice2dev/ui-core';
459
492
  import { takeMemorySnapshot } from '@nice2dev/ui-core';
460
493
  import { testId } from '@nice2dev/ui-core';
494
+ import { THEME_DEFAULT_LINKS } from '@nice2dev/ui-core';
495
+ import { THEME_HEADER_CURVE } from '@nice2dev/ui-core';
496
+ import { THEME_HIGHLIGHT_CURVE } from '@nice2dev/ui-core';
497
+ import { THEME_SURFACE_PATHS } from '@nice2dev/ui-core';
461
498
  import { themeAbyss } from '@nice2dev/ui-core';
462
499
  import { themeAfricanEarth } from '@nice2dev/ui-core';
463
500
  import { themeAmber } from '@nice2dev/ui-core';
@@ -527,7 +564,10 @@ import { themePastelRose } from '@nice2dev/ui-core';
527
564
  import { themePastelSage } from '@nice2dev/ui-core';
528
565
  import { themePastelSky } from '@nice2dev/ui-core';
529
566
  import { themePink } from '@nice2dev/ui-core';
567
+ import { themePreviewRoles } from '@nice2dev/ui-core';
530
568
  import { themeRealEstate } from '@nice2dev/ui-core';
569
+ import { themeRefsIn } from '@nice2dev/ui-core';
570
+ import { themeRefsOf } from '@nice2dev/ui-core';
531
571
  import { themeRetrowave } from '@nice2dev/ui-core';
532
572
  import { themeRose } from '@nice2dev/ui-core';
533
573
  import { themeRuby } from '@nice2dev/ui-core';
@@ -732,6 +772,7 @@ import { withLeakTracking } from '@nice2dev/ui-core';
732
772
  import { withOptimisticUpdates } from '@nice2dev/ui-core';
733
773
  import { withPolling } from '@nice2dev/ui-core';
734
774
  import { withWhyDidYouRender } from '@nice2dev/ui-core';
775
+ import { wouldCreateCycle } from '@nice2dev/ui-core';
735
776
  import { ZustandAdapterConfig } from '@nice2dev/ui-core';
736
777
 
737
778
  export { accessModeAttrs }
@@ -2605,6 +2646,8 @@ declare interface CodeTemplate {
2605
2646
 
2606
2647
  export { CognitiveAccessibilityOptions }
2607
2648
 
2649
+ export { colorSetSnapshot }
2650
+
2608
2651
  export { ColumnFormulas }
2609
2652
 
2610
2653
  /** Column group for multi-level headers ({@link NiceDataGridProps.columnGroups}). */
@@ -3572,6 +3615,8 @@ export { deprecateProp }
3572
3615
 
3573
3616
  export { deprecateSymbol }
3574
3617
 
3618
+ export { deriveColorSet }
3619
+
3575
3620
  /** Derive {@link NiceExportColumn}s from the view's bound cells, falling back to data keys. */
3576
3621
  export declare function deriveExportColumns(view: NiceViewDefinition, rows: Array<Record<string, unknown>>): NiceExportColumn[];
3577
3622
 
@@ -5201,6 +5246,13 @@ export { filterGroupToWhere }
5201
5246
 
5202
5247
  export { filterNiceThemePacksByTag }
5203
5248
 
5249
+ /**
5250
+ * The items narrowed to `query` (already normalised): a matching item keeps everything under it, a
5251
+ * branch stays only when something below it matches. The ids of the branches above a match go into
5252
+ * `open` — they show open while the search lasts, whatever their stored state.
5253
+ */
5254
+ export declare function filterSidebarItems<T extends SearchableItem<T>>(items: T[], query: string, open: Set<string>): T[];
5255
+
5204
5256
  export { FilterToSqlOptions }
5205
5257
 
5206
5258
  export declare type FilterType = 'brightness' | 'contrast' | 'saturation' | 'hue' | 'blur' | 'sharpen' | 'grayscale' | 'sepia' | 'invert' | 'vignette' | 'chromaKey' | 'colorCorrection';
@@ -5571,6 +5623,8 @@ export { getRecentTimings }
5571
5623
 
5572
5624
  export { getSlowRenders }
5573
5625
 
5626
+ export { getThemeValue }
5627
+
5574
5628
  export { getTracelessBadgeInfo }
5575
5629
 
5576
5630
  export declare interface GitBlameEntry {
@@ -7324,16 +7378,23 @@ export { NICE_INTENT_EVENT }
7324
7378
 
7325
7379
  export { NICE_INTENTS }
7326
7380
 
7327
- /**
7328
- * Every built-in theme in categories: Theme Packs, Theme Packs Vol. 2, Core, then the gallery's
7329
- * eleven groups. A theme can sit in more than one category (a pack's theme is often a gallery theme
7330
- * too); {@link NICE_THEME_CATALOG_ENTRIES} lists each once.
7331
- */
7381
+ export { NICE_THEME_ARCHIVE }
7382
+
7383
+ /** The archived themes in categories, as the catalog had them before 1.4.0. */
7384
+ export declare const NICE_THEME_ARCHIVE_CATALOG: NiceThemeCatalogCategory[];
7385
+
7386
+ /** Every built-in theme in categories (1.4.0): Premium, Light, Dark. */
7332
7387
  export declare const NICE_THEME_CATALOG: NiceThemeCatalogCategory[];
7333
7388
 
7334
- /** Every catalog theme once, by name — a pack wins over a plain theme of the same name. */
7389
+ /** Every catalog theme once, by name. */
7335
7390
  export declare const NICE_THEME_CATALOG_ENTRIES: NiceThemeCatalogEntry[];
7336
7391
 
7392
+ export { NICE_THEME_CURATED }
7393
+
7394
+ export { NICE_THEME_CURATED_PACKS }
7395
+
7396
+ export { NICE_THEME_DEFAULT }
7397
+
7337
7398
  export { NICE_THEME_GALLERY }
7338
7399
 
7339
7400
  export { NICE_THEME_PACK_FONT_LINKS }
@@ -10139,6 +10200,8 @@ export declare interface NiceCollapsibleCardProps extends Omit<NiceStandardProps
10139
10200
 
10140
10201
  export declare type NiceCollapsibleCardTrigger = 'header' | 'icon';
10141
10202
 
10203
+ export { NiceColorLevel }
10204
+
10142
10205
  export declare const NiceColorPalette: default_2.ForwardRefExoticComponent<NiceColorPaletteProps & default_2.RefAttributes<HTMLDivElement>> & {
10143
10206
  displayName: string;
10144
10207
  };
@@ -10238,6 +10301,10 @@ export declare interface NiceColorPickerProps extends NiceFormFieldProps {
10238
10301
 
10239
10302
  export declare type NiceColorPreset = 'lightest-pastel' | 'bright-pastel' | 'shiny' | 'pastel' | 'full' | 'dark' | 'deep' | 'muted' | 'earth';
10240
10303
 
10304
+ export { NiceColorSet }
10305
+
10306
+ export { NiceColorSetMode }
10307
+
10241
10308
  export declare function NiceColumnChooser(props: NiceColumnChooserProps): default_2.ReactElement | null;
10242
10309
 
10243
10310
  export declare interface NiceColumnChooserColumn {
@@ -14715,6 +14782,8 @@ export declare interface NiceIconRailItem {
14715
14782
  /** A route the host opens when the button is pressed (no `onClick`). */
14716
14783
  route?: string;
14717
14784
  onClick?: () => void;
14785
+ /** A menu on right-click, the menu key or Shift+F10 (1.3.18) — e.g. moving or removing it. */
14786
+ menu?: NiceMenuItem[];
14718
14787
  }
14719
14788
 
14720
14789
  /** Props for the {@link NiceIconRail} component — a bar of icon buttons with captions. */
@@ -17643,6 +17712,16 @@ export declare function NiceNavShellPaneFooter({ children }: {
17643
17712
  children?: ReactNode;
17644
17713
  }): default_2.JSX.Element | null;
17645
17714
 
17715
+ /**
17716
+ * A header row of the page's own (1.3.18): in a merged tab it goes under this page's pane header and
17717
+ * stays put while the pane scrolls; anywhere else the children render where they stand. A host whose
17718
+ * pages publish into the shell's sticky header renders them here instead when
17719
+ * `useNiceNavShellPane()?.inSplit` — the mirror of {@link NiceNavShellPaneFooter}.
17720
+ */
17721
+ export declare function NiceNavShellPaneHeader({ children }: {
17722
+ children?: ReactNode;
17723
+ }): default_2.JSX.Element | null;
17724
+
17646
17725
  /** What a page rendered by NiceNavShell knows about its place. */
17647
17726
  export declare interface NiceNavShellPaneInfo {
17648
17727
  /** The route this content is rendered for. */
@@ -17656,6 +17735,12 @@ export declare interface NiceNavShellPaneInfo {
17656
17735
  * renders into; `null` elsewhere (and before the pane has mounted).
17657
17736
  */
17658
17737
  footerSlot: HTMLElement | null;
17738
+ /**
17739
+ * In a merged tab, the row under this pane's header that {@link NiceNavShellPaneHeader} renders
17740
+ * into — it stays put while the pane's content scrolls (1.3.18); `null` elsewhere (and before the
17741
+ * pane has mounted).
17742
+ */
17743
+ headerSlot: HTMLElement | null;
17659
17744
  }
17660
17745
 
17661
17746
  export declare type NiceNavShellPersistence = 'memory' | 'localStorage' | 'session';
@@ -20173,6 +20258,8 @@ export declare interface NiceResizableProps extends NiceBaseProps {
20173
20258
  /** Resize handle position for the {@link NiceResizable} component. */
20174
20259
  export declare type NiceResizeHandle = 'top' | 'right' | 'bottom' | 'left' | 'topRight' | 'bottomRight' | 'bottomLeft' | 'topLeft';
20175
20260
 
20261
+ export { NiceResolvedLevel }
20262
+
20176
20263
  /** Resolved permissions for a user. */
20177
20264
  export declare interface NiceResolvedPermissions {
20178
20265
  /** Allowed resource → actions set. */
@@ -20181,6 +20268,8 @@ export declare interface NiceResolvedPermissions {
20181
20268
  denied: Map<string, Set<RbacAction>>;
20182
20269
  }
20183
20270
 
20271
+ export { NiceResolvedTheme }
20272
+
20184
20273
  export { NiceResolvedTutorialStep }
20185
20274
 
20186
20275
  export declare const NiceResourceAllocation: default_2.ForwardRefExoticComponent<NiceResourceAllocationProps & default_2.RefAttributes<NiceResourceAllocationRef>> & {
@@ -21284,26 +21373,6 @@ export declare interface NiceSensorGaugePanelProps extends NiceBaseProps {
21284
21373
  animate?: boolean;
21285
21374
  }
21286
21375
 
21287
- /**
21288
- * {@link NiceSetupWizard} — Advanced multi-step setup wizard with branching, quick mode, and schema-driven forms.
21289
- *
21290
- * @example
21291
- * ```tsx
21292
- * <NiceSetupWizard
21293
- * layout="vertical"
21294
- * steps={[
21295
- * { id: 'welcome', title: 'Welcome', content: <WelcomeScreen /> },
21296
- * { id: 'account', title: 'Account', fields: [
21297
- * { id: 'email', type: 'email', label: 'Email', required: true },
21298
- * { id: 'password', type: 'password', label: 'Password', required: true },
21299
- * ]},
21300
- * { id: 'preferences', title: 'Preferences', optional: true, quickModeSkip: true },
21301
- * { id: 'done', title: 'Complete', content: <CompleteScreen /> },
21302
- * ]}
21303
- * onComplete={(values) => saveUser(values)}
21304
- * />
21305
- * ```
21306
- */
21307
21376
  export declare const NiceSetupWizard: default_2.ForwardRefExoticComponent<NiceSetupWizardProps & default_2.RefAttributes<HTMLDivElement>> & {
21308
21377
  displayName: string;
21309
21378
  };
@@ -21428,7 +21497,8 @@ export declare interface NiceSetupWizardProps {
21428
21497
  loadingText?: default_2.ReactNode;
21429
21498
  /**
21430
21499
  * The loading indicator — e.g. your brand's looping mark. Default: a spinner. It stops moving
21431
- * for users who ask for reduced motion (the default spinner does it itself).
21500
+ * for users who ask for reduced motion: CSS animations stop, and since 1.3.18 SVG (SMIL)
21501
+ * animations are paused too (the `Ntd*` icons hold still on their own).
21432
21502
  */
21433
21503
  loadingIndicator?: default_2.ReactNode;
21434
21504
  id?: string;
@@ -21512,6 +21582,11 @@ export declare type NiceShowcaseTab = 'about' | 'dashboard' | 'users' | 'data' |
21512
21582
  /** Context-menu / gesture actions that can be selectively disabled (e.g. for guests). */
21513
21583
  declare type NiceSidebarContextMenuAction = 'hide' | 'reorder' | 'rename' | 'newGroup' | 'collapseToggle';
21514
21584
 
21585
+ /**
21586
+ * NiceSidebarNav — the multi-mode navigation sidebar. Rows carried to the shortcuts or the
21587
+ * favourites (1.3.18) travel through a drag session: NiceNavShell's, which its tabs share, or —
21588
+ * on its own — one of the sidebar's.
21589
+ */
21515
21590
  export declare const NiceSidebarNav: ForwardRefExoticComponent<NiceSidebarNavProps & RefAttributes<HTMLDivElement>>;
21516
21591
 
21517
21592
  export declare interface NiceSidebarNavProps {
@@ -21669,6 +21744,33 @@ export declare interface NiceSidebarNavProps {
21669
21744
  railWidth?: number;
21670
21745
  /** The bar's button of the page in view; default the one whose `route` is `activeRoute`. */
21671
21746
  railActiveId?: string;
21747
+ /**
21748
+ * A last collapse level (1.3.18): past icons only, the sidebar folds to a column of the
21749
+ * shortcuts — `predefinedShortcuts`, then the user's (`shortcuts` in the preferences), which an
21750
+ * item's star and menu add and the button's own menu moves or removes. The footer then has two
21751
+ * buttons, a level down and a level up. Default `false`.
21752
+ */
21753
+ shortcutsRail?: boolean;
21754
+ /**
21755
+ * The host's shortcuts (e.g. an administrator's), first on the shortcuts rail; the user cannot
21756
+ * remove or move them.
21757
+ */
21758
+ predefinedShortcuts?: Omit<SidebarNavFavorite, 'addedAt'>[];
21759
+ /**
21760
+ * Whether users keep shortcuts of their own (default `true`). `false` — e.g. an administrator's
21761
+ * choice — leaves the rail to `predefinedShortcuts`: nothing offers to add one, and the stored ones
21762
+ * do not show.
21763
+ */
21764
+ allowUserShortcuts?: boolean;
21765
+ /**
21766
+ * How far the sidebar is folded (controlled, 1.3.18). `collapsed` / `onCollapsedChange` keep
21767
+ * working: `'icons'` and `'rail'` are collapsed. `'rail'` needs `shortcutsRail`.
21768
+ */
21769
+ collapseLevel?: SidebarNavCollapseLevel;
21770
+ /** How far the sidebar is folded at mount (uncontrolled; default `'expanded'`). */
21771
+ defaultCollapseLevel?: SidebarNavCollapseLevel;
21772
+ /** Called when the sidebar folds or unfolds a level. */
21773
+ onCollapseLevelChange?: (level: SidebarNavCollapseLevel) => void;
21672
21774
  /**
21673
21775
  * By role / By unit with two or more roles / units (1.3.13): a bar under the mode icons picks
21674
21776
  * one and the tree shows its modules (`activeGroupId` in the preferences). `false` lists them
@@ -21687,6 +21789,21 @@ export declare interface NiceSidebarNavProps {
21687
21789
  * `data` (By module first). Labels and icons of the parents come from `data` when they are in it.
21688
21790
  */
21689
21791
  getFavoritePath?: (favorite: SidebarNavFavorite) => SidebarNavPathEntry[] | undefined;
21792
+ /**
21793
+ * A search box above the tree (1.3.18) that narrows whatever the current mode shows — the tree of
21794
+ * All / By role / By unit, the Favourites list. Empty, everything shows; typing hides what does not
21795
+ * match (label or tooltip, case and diacritics ignored) and opens the branches above each match,
21796
+ * whatever their stored state. The Search mode leaves the mode icons then. Default `false`.
21797
+ */
21798
+ inlineSearch?: boolean;
21799
+ /** The search text (controlled). */
21800
+ searchText?: string;
21801
+ /** The search text at mount (uncontrolled). */
21802
+ defaultSearchText?: string;
21803
+ /** Called with the text as the user types it. */
21804
+ onSearchChange?: (text: string) => void;
21805
+ /** The box's placeholder. */
21806
+ searchPlaceholder?: string;
21690
21807
  /** Extra CSS class on the root element */
21691
21808
  className?: string;
21692
21809
  /** Size variant */
@@ -21756,6 +21873,8 @@ export declare interface NiceSidebarPrefsResetProps {
21756
21873
  userId?: string;
21757
21874
  }
21758
21875
 
21876
+ export { NiceSideNavRole }
21877
+
21759
21878
  export { NiceSignalRConfig }
21760
21879
 
21761
21880
  export declare const NiceSignature: default_2.ForwardRefExoticComponent<NiceSignatureProps & default_2.RefAttributes<NiceSignatureRef>>;
@@ -22690,6 +22809,8 @@ declare interface NiceSuffixOption {
22690
22809
  weight?: number;
22691
22810
  }
22692
22811
 
22812
+ export { NiceSurfaceRole }
22813
+
22693
22814
  /**
22694
22815
  * {@link NiceSurvey} — no scoring; collects responses and can display aggregate
22695
22816
  * (global) results via `results` / `fetchAggregateResults`.
@@ -23200,10 +23321,16 @@ export declare interface NiceTextInputProps extends Omit<NiceFormFieldProps, 'la
23200
23321
 
23201
23322
  export { NiceTheme }
23202
23323
 
23324
+ export { NiceThemeArchive }
23325
+
23203
23326
  export { NiceThemeBackgroundImage }
23204
23327
 
23205
23328
  export { NiceThemeBackgrounds }
23206
23329
 
23330
+ export { niceThemeBankingV2 }
23331
+
23332
+ export { niceThemeBlackTieGala }
23333
+
23207
23334
  export { niceThemeBlue }
23208
23335
 
23209
23336
  export { niceThemeBootstrap }
@@ -23224,8 +23351,8 @@ export declare interface NiceThemeCatalogEntry {
23224
23351
  theme: NiceTheme;
23225
23352
  /** The pack it comes from: a pack also brings a display style and variants. */
23226
23353
  pack?: NiceThemePack;
23227
- /** Which pack collection (`NICE_THEME_PACK_LIST` or `NICE_THEME_PACK_LIST_EXTENDED`). */
23228
- packList?: 'base' | 'extended';
23354
+ /** Which pack collection: the curated ones (1.4.0), or the archived base / extended packs. */
23355
+ packList?: 'curated' | 'base' | 'extended';
23229
23356
  /** The id of its category. */
23230
23357
  category: string;
23231
23358
  }
@@ -23335,16 +23462,30 @@ export declare interface NiceThemeDesignerProps extends NiceBaseProps {
23335
23462
  export declare type NiceThemeDesignerScreen = 'browser' | 'edit';
23336
23463
 
23337
23464
  /** Editable sections in the {@link NiceThemeDesigner}. */
23338
- export declare type NiceThemeDesignerSection = 'general' | 'colors' | 'backgrounds' | 'background-image' | 'text' | 'borders' | 'spacing' | 'typography' | 'shadows' | 'transitions' | 'nesting';
23465
+ export declare type NiceThemeDesignerSection = 'general' | 'colors' | 'backgrounds' | 'background-image' | 'text' | 'borders' | 'spacing' | 'typography' | 'shadows' | 'transitions' | 'nesting' | 'palette' | 'layout' | 'scrollbar';
23466
+
23467
+ export { NiceThemeDiagnostic }
23339
23468
 
23340
23469
  export { niceThemeFluent }
23341
23470
 
23471
+ export { niceThemeFluentV2 }
23472
+
23473
+ export { NiceThemeGradient }
23474
+
23342
23475
  export { niceThemeHighContrast }
23343
23476
 
23477
+ export { NiceThemeLayout }
23478
+
23344
23479
  export { niceThemeLight }
23345
23480
 
23346
23481
  export { niceThemeMaterial }
23347
23482
 
23483
+ export { niceThemeMinimalism }
23484
+
23485
+ export { niceThemeObsidianV2 }
23486
+
23487
+ export { niceThemeOnyxV2 }
23488
+
23348
23489
  export { NiceThemePack }
23349
23490
 
23350
23491
  export { NiceThemePackId }
@@ -23497,14 +23638,22 @@ export declare interface NiceThemePreviewProps extends NiceBaseProps {
23497
23638
  onTabChange?: (tab: NiceThemePreviewTab) => void;
23498
23639
  }
23499
23640
 
23641
+ export { NiceThemePreviewRoles }
23642
+
23500
23643
  export declare type NiceThemePreviewTab = 'general' | 'forms' | 'data' | 'feedback' | 'navigation';
23501
23644
 
23502
23645
  export { NiceThemeProvider }
23503
23646
 
23504
23647
  export { NiceThemeProviderProps }
23505
23648
 
23649
+ export { NiceThemeScrollbar }
23650
+
23506
23651
  export { NiceThemeShadows }
23507
23652
 
23653
+ export { niceThemeShadowV2 }
23654
+
23655
+ export { niceThemeSlateV2 }
23656
+
23508
23657
  export { NiceThemeSpacing }
23509
23658
 
23510
23659
  export { NiceThemeText }
@@ -23513,6 +23662,8 @@ export { NiceThemeTransitions }
23513
23662
 
23514
23663
  export { NiceThemeTypography }
23515
23664
 
23665
+ export { NiceThemeValue }
23666
+
23516
23667
  export { NiceThemeVariantConfigurator }
23517
23668
 
23518
23669
  export { NiceThemeVariantConfiguratorProps }
@@ -26184,6 +26335,12 @@ export declare type NodeShape = 'rectangle' | 'rounded-rectangle' | 'circle' | '
26184
26335
  /** Prevent importing entire library — enforce tree-shaking. */
26185
26336
  export declare const noFullImport: ESLintRule;
26186
26337
 
26338
+ /**
26339
+ * Text as the search compares it: lower case, without diacritics (NFD, combining marks dropped).
26340
+ * "ł" has no decomposition in Unicode, so it is mapped by hand — "lodz" finds "Łódź".
26341
+ */
26342
+ export declare function normalizeSidebarSearch(text: string): string;
26343
+
26187
26344
  /**
26188
26345
  * usePushNotifications — Push notification subscription management
26189
26346
  *
@@ -26430,6 +26587,8 @@ export declare function parseCLIArgs(argv: string[]): {
26430
26587
  args: Record<string, string>;
26431
26588
  };
26432
26589
 
26590
+ export { parseThemeRef }
26591
+
26433
26592
  /** Parse design tokens from CSS custom properties. */
26434
26593
  export declare function parseTokensFromCSS(css: string): FigmaDesignToken[];
26435
26594
 
@@ -27311,6 +27470,8 @@ export { removeTheme }
27311
27470
  /** Removes the node with `id` and its subtree. */
27312
27471
  export declare function removeTreeNode<T>(tree: readonly T[], id: string, options?: TreeEditOptions): T[];
27313
27472
 
27473
+ export { renameThemeRef }
27474
+
27314
27475
  export { RenderStats }
27315
27476
 
27316
27477
  export { RenderTiming }
@@ -27432,6 +27593,10 @@ export declare function resolveRolePermissions(roleId: string, roles: readonly N
27432
27593
 
27433
27594
  export { resolveStepsI18n }
27434
27595
 
27596
+ export { resolveTheme }
27597
+
27598
+ export { resolveThemeValue }
27599
+
27435
27600
  export { resolveTracelessPolicy }
27436
27601
 
27437
27602
  export { resolveTutorial }
@@ -27858,6 +28023,13 @@ export declare interface ScorecardCharacteristic {
27858
28023
 
27859
28024
  export { ScreenOrientation_2 as ScreenOrientation }
27860
28025
 
28026
+ declare interface SearchableItem<T> {
28027
+ id: string;
28028
+ label: ReactNode;
28029
+ tooltip?: ReactNode;
28030
+ children?: T[];
28031
+ }
28032
+
27861
28033
  /**
27862
28034
  * Search documentation content
27863
28035
  */
@@ -28177,6 +28349,12 @@ export declare interface SidebarFavoriteTreeNode {
28177
28349
  children: SidebarFavoriteTreeNode[];
28178
28350
  }
28179
28351
 
28352
+ /** Whether an item's label or tooltip contains `query` (already normalised). */
28353
+ export declare function sidebarItemMatches(item: {
28354
+ label: ReactNode;
28355
+ tooltip?: ReactNode;
28356
+ }, query: string): boolean;
28357
+
28180
28358
  declare type SidebarLevelShading = 'tint' | 'shade';
28181
28359
 
28182
28360
  /**
@@ -28194,6 +28372,12 @@ export declare interface SidebarNavBranchColors {
28194
28372
  levelColors?: string[];
28195
28373
  }
28196
28374
 
28375
+ /**
28376
+ * How far NiceSidebarNav is folded (1.3.18): `'expanded'` — the tree; `'icons'` — icons only;
28377
+ * `'rail'` — only the shortcuts, as a column of buttons (with `shortcutsRail`).
28378
+ */
28379
+ export declare type SidebarNavCollapseLevel = 'expanded' | 'icons' | 'rail';
28380
+
28197
28381
  /** How the sidebar tree and NavShell's tabs show colour — see {@link SidebarNavUserPrefs.colorStyle}. */
28198
28382
  export declare type SidebarNavColorStyle = 'theme' | 'bar' | 'fill';
28199
28383
 
@@ -28278,6 +28462,12 @@ export declare interface SidebarNavHelpers {
28278
28462
  removeFavoriteList: (id: string) => void;
28279
28463
  /** The list the Favourites view shows (1.3.13). */
28280
28464
  setActiveFavoriteList: (id: string) => void;
28465
+ /** Puts an item on the user's shortcuts (1.3.18), at `index` (default the end); once only. */
28466
+ addShortcut: (fav: SidebarNavFavorite, index?: number) => void;
28467
+ /** Takes an item off the user's shortcuts (1.3.18). */
28468
+ removeShortcut: (id: string) => void;
28469
+ /** Moves one of the user's shortcuts to `index` (1.3.18). */
28470
+ moveShortcut: (id: string, index: number) => void;
28281
28471
  /** The role / unit By role / By unit shows (1.3.13). */
28282
28472
  setActiveGroup: (mode: 'by-role' | 'by-unit', id: string) => void;
28283
28473
  setMaxDepth: (mode: SidebarNavMode, depth: number) => void;
@@ -28409,6 +28599,12 @@ export declare interface SidebarNavUserPrefs {
28409
28599
  favoriteLists?: SidebarNavFavoriteList[];
28410
28600
  /** The list the Favourites view shows (1.3.13); default the default list. */
28411
28601
  activeFavoriteListId?: string;
28602
+ /**
28603
+ * The user's shortcuts (1.3.18): the buttons of the shortcuts rail, the sidebar's last collapse
28604
+ * level (`shortcutsRail`), after the host's `predefinedShortcuts`. Added from an item's star or
28605
+ * menu; kept as plain data — an icon only as an icon name.
28606
+ */
28607
+ shortcuts?: SidebarNavFavorite[];
28412
28608
  /**
28413
28609
  * The user's answer to the first-run preferences (1.3.14): `'done'` (saved) or `'skipped'`.
28414
28610
  * No default — absent means "not asked yet".
@@ -29288,6 +29484,14 @@ export declare interface TextAnnotation extends AnnotationBase {
29288
29484
 
29289
29485
  declare type TextStyle = 'professional' | 'casual' | 'formal' | 'concise';
29290
29486
 
29487
+ export { THEME_DEFAULT_LINKS }
29488
+
29489
+ export { THEME_HEADER_CURVE }
29490
+
29491
+ export { THEME_HIGHLIGHT_CURVE }
29492
+
29493
+ export { THEME_SURFACE_PATHS }
29494
+
29291
29495
  export { themeAbyss }
29292
29496
 
29293
29497
  export { themeAfricanEarth }
@@ -29441,8 +29645,16 @@ export declare interface ThemePreviewColors {
29441
29645
  textColor: string;
29442
29646
  /** Border of the thumbnail and of the card (defaults to a translucent overlay). */
29443
29647
  border?: string;
29648
+ /**
29649
+ * The layout's colours (1.4.0, `themePreviewRoles`) — top bar, sidebar with its header levels,
29650
+ * highlight, body, panel. With them `'swatch'` / `'columns'` draws a column per role and `'page'` /
29651
+ * `'layout'` a small app; without them the shapes draw as before.
29652
+ */
29653
+ roles?: NiceThemePreviewRoles;
29444
29654
  }
29445
29655
 
29656
+ export { themePreviewRoles }
29657
+
29446
29658
  /**
29447
29659
  * Renders a tiny "page" or "swatch" thumbnail of a theme.
29448
29660
  *
@@ -29453,12 +29665,20 @@ export declare interface ThemePreviewColors {
29453
29665
  export declare const ThemePreviewSwatch: default_2.FC<{
29454
29666
  colors: ThemePreviewColors;
29455
29667
  size?: number;
29456
- shape?: 'page' | 'swatch';
29668
+ /**
29669
+ * `'page'` (default) — a page in miniature, or with `colors.roles` the app (`'layout'`);
29670
+ * `'swatch'` — stripes, or with roles a column per layout role (`'columns'`).
29671
+ */
29672
+ shape?: 'page' | 'swatch' | 'columns' | 'layout';
29457
29673
  className?: string;
29458
29674
  }>;
29459
29675
 
29460
29676
  export { themeRealEstate }
29461
29677
 
29678
+ export { themeRefsIn }
29679
+
29680
+ export { themeRefsOf }
29681
+
29462
29682
  export { themeRetrowave }
29463
29683
 
29464
29684
  export { themeRose }
@@ -31660,6 +31880,8 @@ export declare interface WorkflowTask {
31660
31880
  parentTaskId?: string;
31661
31881
  }
31662
31882
 
31883
+ export { wouldCreateCycle }
31884
+
31663
31885
  /** Whether `roleId` inheriting `parentId` would close a loop. */
31664
31886
  export declare function wouldCreateRoleCycle(roles: readonly NiceRoleDef[], roleId: string, parentId: string): boolean;
31665
31887