@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.
- package/CHANGELOG.md +90 -0
- package/dist/{NiceDataGrid-BwiBkE3u.cjs → NiceDataGrid-aNPAHsWy.cjs} +1 -1
- package/dist/NiceEventOrchestrator.doc-Dwtq2s_L.cjs +6 -0
- package/dist/{NiceForm-Cxvh2O6y.cjs → NiceForm-BtRBLffD.cjs} +1 -1
- package/dist/{NiceMention-CYTx04JY.cjs → NiceMention-CMqAGvO0.cjs} +1 -1
- package/dist/NiceModuleLifecyclePanel-ugNtHimh.cjs +1 -0
- package/dist/{NicePagination-CKsAP38Q.cjs → NicePagination-D7XxeNFz.cjs} +1 -1
- package/dist/{NiceSavedQueryPanel-CN1rCPFs.cjs → NiceSavedQueryPanel-JHrSlHAV.cjs} +1 -1
- package/dist/{NiceScheduler-K8ZAqFCQ.cjs → NiceScheduler-2TwOZq-y.cjs} +1 -1
- package/dist/{core-lazy-DfNWyf__.cjs → core-lazy-Cda-D35m.cjs} +1 -1
- package/dist/data.cjs +1 -1
- package/dist/docs/NiceEventOrchestrator.doc.json.mjs +19 -19
- package/dist/editors/inputs/NiceNumberInput.mjs +27 -27
- package/dist/editors.cjs +1 -1
- package/dist/index.cjs +220 -220
- package/dist/index.d.ts +129 -62
- package/dist/index.mjs +912 -910
- package/dist/lazy.cjs +1 -1
- package/dist/navigation/NiceFirstRunPreferences.mjs +55 -54
- package/dist/navigation/NiceNavShell.mjs +429 -429
- package/dist/navigation/NiceSetupWizard.mjs +333 -317
- package/dist/navigation/NiceSidebarNav.mjs +1111 -1039
- package/dist/navigation/menuBuilderModel.mjs +1 -1
- package/dist/navigation/sidebarColors.mjs +67 -39
- package/dist/navigation/sidebarNavTypes.mjs +16 -14
- package/dist/navigation/sidebarPrefs/NiceSidebarPrefsDisplay.mjs +120 -42
- package/dist/navigation.cjs +1 -1
- package/dist/navigation.d.ts +32 -6
- package/dist/{no-code-BQqK8mvU.cjs → no-code-B3BHeyG-.cjs} +1 -1
- package/dist/no-code.cjs +1 -1
- package/dist/style.css +2 -2
- package/dist/tools/NiceThemeDesigner.mjs +1359 -900
- package/dist/tools/NiceThemePreview.mjs +18 -18
- package/dist/tools/themeCatalog.mjs +50 -0
- package/dist/workflow/NiceWorkflowDesigner.mjs +452 -898
- package/package.json +5 -5
- package/dist/NiceEventOrchestrator.doc-CxjsLxBG.cjs +0 -6
- 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
|
-
/**
|
|
13636
|
-
|
|
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
|
|
16239
|
-
* - `spinner`: animated rotating mark
|
|
16240
|
-
* - `logo`: full mark + wordmark side-by-side
|
|
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.
|
|
17697
|
-
* `
|
|
17698
|
-
*
|
|
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?:
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
|
|
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
|
|
28247
|
-
setColorStyle: (v:
|
|
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
|
|
28400
|
-
* - `'
|
|
28401
|
-
*
|
|
28402
|
-
*
|
|
28403
|
-
*
|
|
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:
|
|
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),
|