@nice2dev/ui 1.3.16 → 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/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 }
@@ -16238,9 +16248,11 @@ export declare type NiceLogoSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | number;
16238
16248
  /**
16239
16249
  * Brand mark variant.
16240
16250
  * - `mark` (default): symbol only — diamond + triangle (NtdOmniVerk).
16241
- * - `badge`: rounded-square enclosed mark (NtdOmniVerkBadge), good for favicons / chips.
16242
- * - `spinner`: animated rotating mark (NtdOmniVerkSpinner) — use for loading states.
16243
- * - `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.
16244
16256
  */
16245
16257
  export declare type NiceLogoVariant = 'mark' | 'badge' | 'spinner' | 'logo';
16246
16258
 
@@ -23198,6 +23210,26 @@ export { niceThemeBootstrap }
23198
23210
 
23199
23211
  export { NiceThemeBorders }
23200
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
+
23201
23233
  export { NiceThemeColors }
23202
23234
 
23203
23235
  export { NiceThemeContext }
@@ -23233,15 +23265,49 @@ export declare const NiceThemeDesigner: default_2.ForwardRefExoticComponent<Nice
23233
23265
  displayName: string;
23234
23266
  };
23235
23267
 
23236
- /** 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
+ */
23237
23272
  export declare interface NiceThemeDesignerProps extends NiceBaseProps {
23238
- /** 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
+ */
23239
23277
  theme?: NiceTheme;
23240
- /** 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
+ */
23241
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;
23242
23308
  /** Sections to show (default: all) */
23243
23309
  sections?: NiceThemeDesignerSection[];
23244
- /** Called when theme changes */
23310
+ /** Called when the edited theme changes — every edit, undo and redo. */
23245
23311
  onChange?: (theme: NiceTheme) => void;
23246
23312
  /**
23247
23313
  * Called when user clicks Apply, after the theme went to the page: the enclosing
@@ -23265,6 +23331,9 @@ export declare interface NiceThemeDesignerProps extends NiceBaseProps {
23265
23331
  tutorial?: NiceComponentTutorial;
23266
23332
  }
23267
23333
 
23334
+ /** The two screens of the {@link NiceThemeDesigner}: the themes tree and the editor. */
23335
+ export declare type NiceThemeDesignerScreen = 'browser' | 'edit';
23336
+
23268
23337
  /** Editable sections in the {@link NiceThemeDesigner}. */
23269
23338
  export declare type NiceThemeDesignerSection = 'general' | 'colors' | 'backgrounds' | 'background-image' | 'text' | 'borders' | 'spacing' | 'typography' | 'shadows' | 'transitions' | 'nesting';
23270
23339
 
@@ -26033,50 +26102,14 @@ export declare interface NiceWorkflowDefinition {
26033
26102
  bpmn?: BPMNProcessDefinition;
26034
26103
  }
26035
26104
 
26036
- export declare const NiceWorkflowDesigner: default_2.FC<NiceWorkflowDesignerProps>;
26037
-
26038
- export declare interface NiceWorkflowDesignerProps extends NiceBaseProps {
26039
- workflow?: NiceWorkflowDefinition;
26040
- /** Convenience: flat node list mapped into `workflow.states` when `workflow` is omitted. */
26041
- nodes?: Array<{
26042
- id: string;
26043
- type?: string;
26044
- label?: string;
26045
- name?: string;
26046
- x?: number;
26047
- y?: number;
26048
- }>;
26049
- /** Convenience: flat edge list mapped into `workflow.transitions` when `workflow` is omitted. */
26050
- edges?: Array<{
26051
- id?: string;
26052
- from?: string;
26053
- to?: string;
26054
- source?: string;
26055
- target?: string;
26056
- fromStateId?: string;
26057
- toStateId?: string;
26058
- name?: string;
26059
- label?: string;
26060
- }>;
26061
- onChange?: (workflow: NiceWorkflowDefinition) => void;
26062
- entityFields?: NiceFieldDescriptor[];
26063
- availableActions?: NiceWorkflowActionType[];
26064
- availableUsers?: NiceUserInfo[];
26065
- availableRoles?: NiceRoleInfo[];
26066
- readOnly?: boolean;
26067
- showMinimap?: boolean;
26068
- showToolbar?: boolean;
26069
- showValidation?: boolean;
26070
- onTest?: (workflow: NiceWorkflowDefinition) => void;
26071
- onPublish?: (workflow: NiceWorkflowDefinition) => void;
26072
- /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
26073
- tutorial?: NiceComponentTutorial;
26074
- }
26075
-
26076
26105
  export declare interface NiceWorkflowState {
26077
26106
  id: string;
26078
26107
  name: string;
26079
- 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 & {});
26080
26113
  color?: string;
26081
26114
  icon?: string;
26082
26115
  position: {