@nice2dev/ui 1.3.15 → 1.3.17

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 (38) hide show
  1. package/CHANGELOG.md +90 -0
  2. package/dist/{NiceDataGrid-BwiBkE3u.cjs → NiceDataGrid-aNPAHsWy.cjs} +1 -1
  3. package/dist/NiceEventOrchestrator.doc-Dwtq2s_L.cjs +6 -0
  4. package/dist/{NiceForm-Cxvh2O6y.cjs → NiceForm-BtRBLffD.cjs} +1 -1
  5. package/dist/{NiceMention-CYTx04JY.cjs → NiceMention-CMqAGvO0.cjs} +1 -1
  6. package/dist/NiceModuleLifecyclePanel-ugNtHimh.cjs +1 -0
  7. package/dist/{NicePagination-CKsAP38Q.cjs → NicePagination-D7XxeNFz.cjs} +1 -1
  8. package/dist/{NiceSavedQueryPanel-CN1rCPFs.cjs → NiceSavedQueryPanel-JHrSlHAV.cjs} +1 -1
  9. package/dist/{NiceScheduler-K8ZAqFCQ.cjs → NiceScheduler-2TwOZq-y.cjs} +1 -1
  10. package/dist/{core-lazy-DfNWyf__.cjs → core-lazy-Cda-D35m.cjs} +1 -1
  11. package/dist/data.cjs +1 -1
  12. package/dist/docs/NiceEventOrchestrator.doc.json.mjs +19 -19
  13. package/dist/editors/inputs/NiceNumberInput.mjs +27 -27
  14. package/dist/editors.cjs +1 -1
  15. package/dist/index.cjs +220 -220
  16. package/dist/index.d.ts +129 -62
  17. package/dist/index.mjs +912 -910
  18. package/dist/lazy.cjs +1 -1
  19. package/dist/navigation/NiceFirstRunPreferences.mjs +55 -54
  20. package/dist/navigation/NiceNavShell.mjs +429 -429
  21. package/dist/navigation/NiceSetupWizard.mjs +333 -317
  22. package/dist/navigation/NiceSidebarNav.mjs +1111 -1039
  23. package/dist/navigation/menuBuilderModel.mjs +1 -1
  24. package/dist/navigation/sidebarColors.mjs +67 -39
  25. package/dist/navigation/sidebarNavTypes.mjs +16 -14
  26. package/dist/navigation/sidebarPrefs/NiceSidebarPrefsDisplay.mjs +120 -42
  27. package/dist/navigation.cjs +1 -1
  28. package/dist/navigation.d.ts +32 -6
  29. package/dist/{no-code-BQqK8mvU.cjs → no-code-B3BHeyG-.cjs} +1 -1
  30. package/dist/no-code.cjs +1 -1
  31. package/dist/style.css +2 -2
  32. package/dist/tools/NiceThemeDesigner.mjs +1359 -900
  33. package/dist/tools/NiceThemePreview.mjs +18 -18
  34. package/dist/tools/themeCatalog.mjs +50 -0
  35. package/dist/workflow/NiceWorkflowDesigner.mjs +452 -898
  36. package/package.json +5 -5
  37. package/dist/NiceEventOrchestrator.doc-CxjsLxBG.cjs +0 -6
  38. package/dist/NiceModuleLifecyclePanel-DHHAjwQx.cjs +0 -1
package/dist/index.d.ts CHANGED
@@ -7324,6 +7324,16 @@ export { NICE_INTENT_EVENT }
7324
7324
 
7325
7325
  export { NICE_INTENTS }
7326
7326
 
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
+ */
7332
+ export declare const NICE_THEME_CATALOG: NiceThemeCatalogCategory[];
7333
+
7334
+ /** Every catalog theme once, by name — a pack wins over a plain theme of the same name. */
7335
+ export declare const NICE_THEME_CATALOG_ENTRIES: NiceThemeCatalogEntry[];
7336
+
7327
7337
  export { NICE_THEME_GALLERY }
7328
7338
 
7329
7339
  export { NICE_THEME_PACK_FONT_LINKS }
@@ -13632,8 +13642,11 @@ export declare interface NiceFirstRunValues {
13632
13642
  language?: string;
13633
13643
  /** The menu folded to icons. */
13634
13644
  collapsed?: boolean;
13635
- /** How branch colours show: a bar by each item, or whole items filled. */
13636
- colorStyle?: 'bar' | 'fill';
13645
+ /**
13646
+ * How the menu shows colour: the theme's shades (`'theme'`, the default since 1.3.16), plus a bar
13647
+ * by each item in its branch colour, or whole items filled.
13648
+ */
13649
+ colorStyle?: SidebarNavColorStyle;
13637
13650
  }
13638
13651
 
13639
13652
  /**
@@ -16235,9 +16248,11 @@ export declare type NiceLogoSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | number;
16235
16248
  /**
16236
16249
  * Brand mark variant.
16237
16250
  * - `mark` (default): symbol only — diamond + triangle (NtdOmniVerk).
16238
- * - `badge`: rounded-square enclosed mark (NtdOmniVerkBadge), good for favicons / chips.
16239
- * - `spinner`: animated rotating mark (NtdOmniVerkSpinner) — use for loading states.
16240
- * - `logo`: full mark + wordmark side-by-side (NtdOmniVerkLogo).
16251
+ * - `badge`: rounded-square enclosed mark, good for favicons / chips.
16252
+ * - `spinner`: animated rotating mark — use for loading states.
16253
+ * - `logo`: full mark + wordmark side-by-side.
16254
+ *
16255
+ * Drawn inline here; @nice2dev/icons keeps only NtdOmniVerk and NtdOmniVerkAnimated since 1.3.17.
16241
16256
  */
16242
16257
  export declare type NiceLogoVariant = 'mark' | 'badge' | 'spinner' | 'logo';
16243
16258
 
@@ -17693,11 +17708,12 @@ export declare interface NiceNavShellProps {
17693
17708
  tabColors?: NiceNavShellTabColors;
17694
17709
  /**
17695
17710
  * How a tab shows its colour (1.3.3): `'bar'` — a line under the tab, `'fill'` — a tint with a
17696
- * bar along the top. Absent: the sidebar's `colorStyle` preference (Preferences → Display) of
17697
- * `sidebarUserId`, so the tabs follow the user's choice. Pass it when your own `sidebar` keeps
17698
- * its preferences elsewhere (e.g. on the server).
17711
+ * bar along the top, `'theme'` (1.3.16) — no colour, the theme's tabs. Absent: the sidebar's
17712
+ * `colorStyle` preference (Preferences → Display) of `sidebarUserId` (default `'theme'`), so the
17713
+ * tabs follow the user's choice. Pass it when your own `sidebar` keeps its preferences elsewhere
17714
+ * (e.g. on the server).
17699
17715
  */
17700
- colorStyle?: 'bar' | 'fill';
17716
+ colorStyle?: SidebarNavColorStyle;
17701
17717
  /** Extra props for the built-in NiceSidebarNav (rendered from `sidebarData`), e.g. `levelColors`. */
17702
17718
  sidebarProps?: Partial<NiceSidebarNavProps>;
17703
17719
  /**
@@ -23194,6 +23210,26 @@ export { niceThemeBootstrap }
23194
23210
 
23195
23211
  export { NiceThemeBorders }
23196
23212
 
23213
+ /** A category of the {@link NICE_THEME_CATALOG}. `label` is English; i18n key `theme.category.<id>`. */
23214
+ export declare interface NiceThemeCatalogCategory {
23215
+ id: string;
23216
+ label: string;
23217
+ entries: NiceThemeCatalogEntry[];
23218
+ }
23219
+
23220
+ /** One theme of the {@link NICE_THEME_CATALOG}, and the curated pack it comes from. */
23221
+ export declare interface NiceThemeCatalogEntry {
23222
+ /** The theme's name — unique across the catalog's entries. */
23223
+ name: string;
23224
+ theme: NiceTheme;
23225
+ /** The pack it comes from: a pack also brings a display style and variants. */
23226
+ pack?: NiceThemePack;
23227
+ /** Which pack collection (`NICE_THEME_PACK_LIST` or `NICE_THEME_PACK_LIST_EXTENDED`). */
23228
+ packList?: 'base' | 'extended';
23229
+ /** The id of its category. */
23230
+ category: string;
23231
+ }
23232
+
23197
23233
  export { NiceThemeColors }
23198
23234
 
23199
23235
  export { NiceThemeContext }
@@ -23229,15 +23265,49 @@ export declare const NiceThemeDesigner: default_2.ForwardRefExoticComponent<Nice
23229
23265
  displayName: string;
23230
23266
  };
23231
23267
 
23232
- /** Props for the {@link NiceThemeDesigner} component — an advanced visual theme editor with section pickers, presets, live preview, and export. */
23268
+ /**
23269
+ * Props for the {@link NiceThemeDesigner} component — a themes tree (favourites, own themes, the
23270
+ * built-in catalog) and a full-window visual editor with undo, live preview, and export.
23271
+ */
23233
23272
  export declare interface NiceThemeDesignerProps extends NiceBaseProps {
23234
- /** Initial theme to edit (defaults to Light) */
23273
+ /**
23274
+ * The theme selected in the tree — or edited, with `startScreen="edit"` (defaults to Light). Read
23275
+ * once, at mount.
23276
+ */
23235
23277
  theme?: NiceTheme;
23236
- /** Preset themes to offer in the picker */
23278
+ /**
23279
+ * Built-in themes for the tree (default: the whole {@link NICE_THEME_CATALOG}). A list is grouped
23280
+ * by its themes' catalog categories; themes the catalog doesn't know go under "Presets".
23281
+ */
23237
23282
  presets?: NiceTheme[];
23283
+ /**
23284
+ * Own themes — the "My themes" group (controlled). Without it the designer keeps them itself, in
23285
+ * `localStorage` under `storageKey`.
23286
+ */
23287
+ themes?: NiceTheme[];
23288
+ /** Called with the new list when a theme is created, saved, imported, duplicated or deleted. */
23289
+ onThemesChange?: (themes: NiceTheme[]) => void;
23290
+ /** Names of the favourite themes (controlled). Without it the designer keeps them itself. */
23291
+ favorites?: string[];
23292
+ /** Called when a theme's star is toggled. */
23293
+ onFavoritesChange?: (names: string[]) => void;
23294
+ /**
23295
+ * The `localStorage` key prefix for the own themes and favourites the designer keeps itself
23296
+ * (default `'nice-theme-designer'`); `false` keeps them in memory only.
23297
+ */
23298
+ storageKey?: string | false;
23299
+ /**
23300
+ * Show Delete for own themes (default false). Tie it to the user's permission — built-in themes
23301
+ * can never be deleted.
23302
+ */
23303
+ allowDelete?: boolean;
23304
+ /** The screen it opens on (default `'browser'`); `'edit'` opens the editor on `theme`. */
23305
+ startScreen?: NiceThemeDesignerScreen;
23306
+ /** Called with the saved theme on Save and Save as copy. */
23307
+ onSave?: (theme: NiceTheme) => void;
23238
23308
  /** Sections to show (default: all) */
23239
23309
  sections?: NiceThemeDesignerSection[];
23240
- /** Called when theme changes */
23310
+ /** Called when the edited theme changes — every edit, undo and redo. */
23241
23311
  onChange?: (theme: NiceTheme) => void;
23242
23312
  /**
23243
23313
  * Called when user clicks Apply, after the theme went to the page: the enclosing
@@ -23261,6 +23331,9 @@ export declare interface NiceThemeDesignerProps extends NiceBaseProps {
23261
23331
  tutorial?: NiceComponentTutorial;
23262
23332
  }
23263
23333
 
23334
+ /** The two screens of the {@link NiceThemeDesigner}: the themes tree and the editor. */
23335
+ export declare type NiceThemeDesignerScreen = 'browser' | 'edit';
23336
+
23264
23337
  /** Editable sections in the {@link NiceThemeDesigner}. */
23265
23338
  export declare type NiceThemeDesignerSection = 'general' | 'colors' | 'backgrounds' | 'background-image' | 'text' | 'borders' | 'spacing' | 'typography' | 'shadows' | 'transitions' | 'nesting';
23266
23339
 
@@ -26029,50 +26102,14 @@ export declare interface NiceWorkflowDefinition {
26029
26102
  bpmn?: BPMNProcessDefinition;
26030
26103
  }
26031
26104
 
26032
- export declare const NiceWorkflowDesigner: default_2.FC<NiceWorkflowDesignerProps>;
26033
-
26034
- export declare interface NiceWorkflowDesignerProps extends NiceBaseProps {
26035
- workflow?: NiceWorkflowDefinition;
26036
- /** Convenience: flat node list mapped into `workflow.states` when `workflow` is omitted. */
26037
- nodes?: Array<{
26038
- id: string;
26039
- type?: string;
26040
- label?: string;
26041
- name?: string;
26042
- x?: number;
26043
- y?: number;
26044
- }>;
26045
- /** Convenience: flat edge list mapped into `workflow.transitions` when `workflow` is omitted. */
26046
- edges?: Array<{
26047
- id?: string;
26048
- from?: string;
26049
- to?: string;
26050
- source?: string;
26051
- target?: string;
26052
- fromStateId?: string;
26053
- toStateId?: string;
26054
- name?: string;
26055
- label?: string;
26056
- }>;
26057
- onChange?: (workflow: NiceWorkflowDefinition) => void;
26058
- entityFields?: NiceFieldDescriptor[];
26059
- availableActions?: NiceWorkflowActionType[];
26060
- availableUsers?: NiceUserInfo[];
26061
- availableRoles?: NiceRoleInfo[];
26062
- readOnly?: boolean;
26063
- showMinimap?: boolean;
26064
- showToolbar?: boolean;
26065
- showValidation?: boolean;
26066
- onTest?: (workflow: NiceWorkflowDefinition) => void;
26067
- onPublish?: (workflow: NiceWorkflowDefinition) => void;
26068
- /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
26069
- tutorial?: NiceComponentTutorial;
26070
- }
26071
-
26072
26105
  export declare interface NiceWorkflowState {
26073
26106
  id: string;
26074
26107
  name: string;
26075
- type: NiceWorkflowStateType;
26108
+ /**
26109
+ * One of the designer's step kinds (`NiceWorkflowDesigner` of `@nice2dev/ui-diagrams`,
26110
+ * `stepTypes`): the five built-in ones or an id of your own (1.3.17).
26111
+ */
26112
+ type: NiceWorkflowStateType | (string & {});
26076
26113
  color?: string;
26077
26114
  icon?: string;
26078
26115
  position: {
@@ -28074,6 +28111,11 @@ export declare interface SetupWizardStep {
28074
28111
  * The step that completes the wizard (1.3.14). When any step is `final`, only such a step calls
28075
28112
  * `onComplete`; every other one — the last one in view included — goes on to its `nextStep`
28076
28113
  * (or the next one) with `labels.next`. Without any `final` step, the last step completes.
28114
+ *
28115
+ * `false` (1.3.16): this step never completes, even while it is the only one or the last one in
28116
+ * view — for steps the host adds after it (a first choice that decides every step after it). Its
28117
+ * main button reads `labels.next`; pressed before the next step exists (e.g. the host adds the
28118
+ * steps in `validate`), the wizard moves on as soon as that step arrives.
28077
28119
  */
28078
28120
  final?: boolean;
28079
28121
  }
@@ -28152,6 +28194,9 @@ export declare interface SidebarNavBranchColors {
28152
28194
  levelColors?: string[];
28153
28195
  }
28154
28196
 
28197
+ /** How the sidebar tree and NavShell's tabs show colour — see {@link SidebarNavUserPrefs.colorStyle}. */
28198
+ export declare type SidebarNavColorStyle = 'theme' | 'bar' | 'fill';
28199
+
28155
28200
  /**
28156
28201
  * Top-level data node: one data source with all its navigation children.
28157
28202
  * modules → used in 'all' mode (depth: source → module → view → …)
@@ -28243,8 +28288,12 @@ export declare interface SidebarNavHelpers {
28243
28288
  setLeftClickBehavior: (v: 'focus-existing' | 'open-new') => void;
28244
28289
  /** Replace the per-mode ordering of item ids. Pass `null` to clear (revert to data-defined order). */
28245
28290
  reorderItems: (mode: SidebarNavMode, orderedIds: string[] | null) => void;
28246
- /** How level / branch colours show: a bar by each row (default) or the whole row filled. */
28247
- setColorStyle: (v: 'bar' | 'fill') => void;
28291
+ /** How the tree shows colour: the theme's shades (default), plus branch bars, or filled rows. */
28292
+ setColorStyle: (v: SidebarNavColorStyle) => void;
28293
+ /** A step per level (default) or no indentation (1.3.16). */
28294
+ setIndent: (v: SidebarNavUserPrefs['indent']) => void;
28295
+ /** What stays in view while the tree scrolls (1.3.16). */
28296
+ setStickyHeaders: (v: SidebarNavUserPrefs['stickyHeaders']) => void;
28248
28297
  /** How NiceNavShell opens pages: automatically, one at a time or in tabs (1.3.4). */
28249
28298
  setPageMode: (v: NiceNavShellPageMode) => void;
28250
28299
  /**
@@ -28396,16 +28445,34 @@ export declare interface SidebarNavUserPrefs {
28396
28445
  */
28397
28446
  itemOrder: Partial<Record<SidebarNavMode, string[]>>;
28398
28447
  /**
28399
- * How a level / branch colour shows (1.3.3; `levelColors`, a branch's `color`):
28400
- * - `'bar'` (default): a bar in the colour left of each row's arrow, and NavShell's tabs
28401
- * underlined in it;
28402
- * - `'fill'`: the whole row filled with it (text picked for contrast), and the tabs tinted
28403
- * with a bar along the top — the look of 1.3.2.
28448
+ * How the tree is coloured (1.3.3; `'theme'` and the default since 1.3.16):
28449
+ * - `'theme'` (default): the theme's colours, shaded by level — the source header in the
28450
+ * primary, each level under it lighter, pages a faint tint of their level; a theme's
28451
+ * `nesting.sidebar` or the sidebar's `levelColors` replaces the shades. Branch colours (e.g.
28452
+ * databases) paint nothing, and NavShell's tabs stay uncoloured;
28453
+ * - `'bar'`: the same shades, plus a branch's colour as a bar on the left edge of its rows and
28454
+ * NavShell's tabs underlined in it;
28455
+ * - `'fill'`: rows filled with the level / branch colours (text picked for contrast), and the
28456
+ * tabs tinted with a bar along the top — the look of 1.3.2.
28404
28457
  *
28405
28458
  * Set from the Display page of the preferences; `preferences={{ colorStyle: 'fill' }}` makes
28406
28459
  * `'fill'` the default.
28407
28460
  */
28408
- colorStyle: 'bar' | 'fill';
28461
+ colorStyle: SidebarNavColorStyle;
28462
+ /**
28463
+ * Indentation of the tree (1.3.16): `'steps'` (default) — a step per level; `'none'` — every
28464
+ * level starts at the same place and the shades alone show the level.
28465
+ */
28466
+ indent: 'steps' | 'none';
28467
+ /**
28468
+ * What stays in view while the tree scrolls (1.3.16):
28469
+ * - `'path'` (default): the source header above the tree, outside its scroll area (the
28470
+ * scrollbar starts a level lower), and the headers above the first visible row stuck under it,
28471
+ * one per level;
28472
+ * - `'root'`: only the source header stays;
28473
+ * - `'none'`: everything scrolls — the most room on a short screen.
28474
+ */
28475
+ stickyHeaders: 'path' | 'root' | 'none';
28409
28476
  /**
28410
28477
  * How NiceNavShell opens pages when it offers tabs (`tabsMode="enabled"`, 1.3.4):
28411
28478
  * - `'auto'` (default): in tabs in an installed app (a window of its own, no browser tab strip),