@nice2dev/ui-diagrams 1.1.9 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,144 @@
 # @nice2dev/ui-diagrams — Changelog
 
+## 1.2.0
+
+### Minor Changes
+
+- 3a4939d: 1.2.0 — the API cleanup announced for this version, dictionaries per language by default, and
+  three new controls. **Breaking:** every removal has a replacement, listed name by name in
+  `documentation/omniverk/OMNIVERK_UPGRADE_1.2.0.md`.
+
+  **Removed (breaking).** All 118 `@deprecated` names: the aliases without the `Nice` prefix in
+  `ui-audio`, `ui-graphics` and `ui-3d`; `NiceBarcodeGenerator` (→ `NiceBarcode`), `NiceFloorPlanCanvas`
+  (→ `NiceSpatialEditor` in `@nice2dev/ui-buildings`), the v2 props and types of `NiceTopNav`,
+  `NiceProgress.showLabel`, `NiceCountryPicker.showDialCode` / `showFlag`, `type` on
+  `NiceDateTimePicker` / `NiceDateRangeBox` (→ `dateFormatPreset`); `ZoneOccupancy` in
+  `ui-buildings` and `events`, the `SmartHome*` types; the icon variant `flat` (→ `cutout`) and
+  `NiceIconEditor` (→ `NiceVectorEditor`); `NiceSizeLegacy`; the `snapGrid` module of `ui-diagrams` (→
+  `@nice2dev/spatial-core`); the opt-in stylesheet `@nice2dev/ui/css/legacy-bg-text-aliases.css`, which
+  formed an alias cycle with `style.css`. Props that were accepted and never read — 19 on
+  `NiceModuleGrid`, and more on `NiceAutocomplete`, `NiceTaskInbox`, `NiceConsentBanner`, the
+  building and communication controls, four `ui-audio` panels and `NiceStreamDashboard` — are gone
+  from the types. `NiceResourceAllocation` in `ui-erp` is `NiceCapacityPlanner` (the one in `ui`
+  keeps its name); `NiceGenericPlayerStageVisualizer` (→ `NiceStageVisualizer`) and
+  `NiceCubeBrowserProps` are removed. The `@nice2dev/ui/overlays` entry calls its modal, drawer,
+  bottom sheet and context menu `NiceOverlayModal`, `NiceOverlayDrawer`, `NiceOverlayBottomSheet` and
+  `NiceOverlayContextMenu`: the old names belonged to different components of `@nice2dev/ui`.
+
+  **Dictionaries per language.** `NiceI18nProvider` loads only the language in use, with `import()`
+  (it was `NiceI18nLazyProvider` in 1.1.10, which stays as the same component); the controls show their
+  built-in English until it arrives — `await loadNiceDictionary(lang)` before the first render to start
+  in the language. Nothing on the main entry of `@nice2dev/i18n` imports a dictionary any more:
+  `NICE_I18N_DICTIONARIES`, `createTranslator`, `NICE_I18N_VARIANTS` / `resolvePlVariant` and the
+  translation tooling moved to the new entry `@nice2dev/i18n/all`, and `@nice2dev/ui-core` no longer
+  re-exports the dictionary map. `@nice2dev/ui` with what it bundles: 1283 kB → 952 kB gzip loaded up
+  front. The `ui-audio` controls read the app's `NiceI18nProvider` now; their own provider overrides it.
+
+  **New controls.** `NiceRecurrenceEditor`, `NiceStopwatch`, `NiceCountdownTimer` (`@nice2dev/ui`) and
+  `NicePasswordGenerator` (`@nice2dev/auth`), plus `recurrenceDates()` and `generatePassword()`.
+  `NiceScheduler` honours a weekly rule's `byDay`, which it ignored.
+
+  **Visible changes.** The palette meets WCAG AA for text on every fill: darker fills in the light
+  theme, dark text on the fills of the dark theme (new `--nice-text-on-success` / `-error` / `-info` /
+  `-accent` / `-warning`; `NiceThemeText` takes `onSuccess`, `onError`, `onInfo`, `onWarning`). Mobile
+  and platform panels follow the app theme instead of `prefers-color-scheme`. Swipes in
+  `NiceSwipeActions`, `NiceTouchTable` and `NiceMobileCalendar` work with a mouse and a pen. The
+  `ui-forms` editors have the intended spacing (it was four times too large). `NiceMAM`,
+  `NiceTranscoder`, `NiceVideoAnnotator` and `NiceStreamDashboard` use `nice-`-prefixed BEM classes.
+
+  **Fixes.** Controls that invented results ask the host instead: `NiceIntegrationHub`,
+  `NiceMLStudio` (`onExperimentRun` may return metrics), `NiceRemoteManagement`
+  (`onCaptureScreenshot`), `NicePoseDetector` (`detector`), `NiceBatchScannerProvider`,
+  `NiceCacheStrategies`; `NiceLowCodeStudio` accepts dropped components. Controls that did nothing
+  work or say why they are off: `NiceStreamDashboard` adds sources, sends chat and runs the chosen
+  transition (new `onAddPlatform`, `onSendChatMessage`, `onTransition`, `onScreenshot`,
+  `onOpenAudioMixer`, `onOpenSettings`; `receiveChatMessage` feeds incoming chat), `NiceMLStudio`
+  downloads through `onModelDownload`, `NiceETLBuilder` saves through `onSave` (its Save button had
+  no handler), `NiceTranscoder` makes jobs of picked and dropped files, `NiceAutomationEditor` offers
+  the trigger types its model has. Texts of about fifty components go
+  through `t()` in six languages, among them the AI data grid, chart and form builders, the ML
+  studio, the report designer, the song picker, `NiceProtocolConfig`, `NiceETLBuilder` and
+  `NiceInlineHelp` — every key the controls pass to `t()` now has a dictionary entry, so none of
+  them stays English under another language; `NiceDataGridAI` sorts on a query in any language, not
+  only in English. `NiceWindow`, `NiceConsole`, `NiceFileManager` and `NiceGitManager` no longer
+  crash when `accessMode` switches to or from `'hidden'`. Ids come from `createId()` (`@nice2dev/ui-core`), so nothing throws
+  outside a secure context as `crypto.randomUUID()` did on plain http. `ui-3d` runs on three r183
+  without its deprecation warnings. `NiceRemoteManagement` calls the handlers of the latest render.
+  The AI hint popover and the `ui-platform` panels follow the app theme, not the system's or a
+  `.dark` class on the host. `NiceCommandPalette` has styles and its search filters;
+  `NiceTimeoutFeedback` starts its clock; `NiceOfflineBanner` takes `online`; Monaco's workers in
+  `NiceCodeEditor` load; the `ui-audio` panels that used Bootstrap classes use Nice controls; colours
+  that reached a canvas as `var(…)` (karaoke lanes and notes) are resolved first.
+
+## 1.1.10
+
+### Patch Changes
+
+- The package description on npm shows a dash instead of the mis-encoded "—".
+- 1.1.10 — the additive part of OmniVerk's 1.2.0 list: ui-audio builds without optional packages, one
+  i18n context, dictionaries per language, data props optional. No breaking changes.
+
+  **`@nice2dev/ui-audio` no longer breaks the consumer's build.** It imported `react-bootstrap`,
+  `recharts`, `react-window`, `react-youtube` and `pitchy` statically while declaring none of them
+  (only optional entries in `peerDependenciesMeta`), so a Vite app without them failed with "failed to
+  resolve import". Loading them with `import()` is no way out: Vite 8 (Rolldown) resolves dynamic
+  imports at build time and fails the same way, which made `hls.js` and `phaser` mandatory too.
+  `react-bootstrap`, `recharts`, `react-window` and `phaser` are now gone from the code
+  (`NiceBarFillEditor` uses Nice controls, `NiceVocalPerformanceReport` uses `NiceChart` /
+  `NicePieChart`, the karaoke editor list uses `NiceVirtualScroller`, `NiceKaraokePhaserRenderer`
+  renders with the DOM and keeps its name); `pitchy`, `react-youtube` and `hls.js` are regular
+  `dependencies`. Found on the way: in live mode the vocal performance report subtracted UltraStar note
+  numbers from MIDI pitch, so every singer got thousands of cents of deviation and 0 % accuracy — it now
+  compares pitch within the octave, as the scoring does; `NiceBarFillEditor` put a colour into a
+  percentage slider.
+
+  **Every package declares what its bundle imports.** A new CI gate checks every `import`, `import()`
+  and `require()` in the published `dist` against `dependencies` and non-optional `peerDependencies`.
+  To reach zero: `@nice2dev/licensing` no longer has `require('webpack')` in its main bundle (the webpack
+  plugin uses `compiler.webpack`; webpack 4 gets a warning instead of feature flags) and `react` is a
+  required peer; `@nice2dev/erp-adapter` lists `@microsoft/signalr` in `dependencies` (still loaded on
+  first use); `@nice2dev/icons-cursor` declares its `react-dom` peer; `@nice2dev/ui-printing` treats
+  `@nice2dev/ui` as a required peer.
+
+  **One copy of each package, one i18n context.** `@nice2dev/ui` carried its own copy of
+  `@nice2dev/ui-core` and `@nice2dev/i18n`, and `ui-forms`, `ui-api`, `ui-bi`, `ui-designers`, `ui-math`
+  and `ui-video` each carried a copy of all of `@nice2dev/ui` (about 4.4 MB each). Every copy had its own
+  React contexts: a `NiceI18nProvider` imported from `@nice2dev/i18n` did not reach the controls of
+  `@nice2dev/ui`, which kept their English defaults and `lang` `'en'`, and the dictionaries ended up in
+  an app several times. These packages now import `@nice2dev/*` instead (`ui-forms` 4.4 MB → 82 kB).
+  Keep every `@nice2dev/*` package on the same version.
+
+  **Dictionaries per language.** `NiceI18nLazyProvider` takes the same props as `NiceI18nProvider`
+  (`t`, `lang`, `overrides`, plus `fallback` and `onError`) but loads only the active language's
+  dictionary, with `import()`; until it arrives the controls show their built-in English (or
+  `fallback`), and with `t` nothing is loaded at all. Also `loadNiceDictionary(lang)`, to start in a
+  language without a flash of English, and `getLoadedNiceDictionary(lang)`. Exported from
+  `@nice2dev/i18n`, `@nice2dev/ui-core` and `@nice2dev/ui`; in the `i18n` build every language is its own
+  file. `NiceI18nProvider` and `NICE_I18N_DICTIONARIES` are unchanged and still bring all 30 dictionaries.
+  `NiceTestWrapper` (ui-core) and `NiceShowcase` (ui) use the lazy provider now, so they no longer pull
+  every dictionary into the apps that bundle them.
+
+  **Data props are optional.** These controls threw a `TypeError` without data and now render empty:
+  `NiceTreeView.nodes`, `NiceAccordion.items`, `NiceCascadeSelect.options`, `NiceAutocomplete.options`,
+  `NiceAuditLog.entries`, `NiceDocumentVersionList.versions`, `NicePermissionMatrix.roles` / `actions`,
+  `WizardStep.content`, `NiceDiagramViewer.document`, `NiceOrgChartVisualizer.data`,
+  `NiceSpatialViewer.document`, and in `@nice2dev/events` the lists of `NiceGiftRegistry`,
+  `NiceParticipantList`, `NiceExpenseSplit`, `NiceSeatingChart`, `NiceMediaCollage` and `NiceEventMedia`.
+  `NiceMap` without `center` centres on its markers (the whole world without markers), `NiceCountdown`
+  without `targetDate` shows zero and never calls `onComplete`, `NiceChat` without `onSend` is read-only
+  (no input), and `NiceInvitationDesigner` gains `defaultTemplate`. A CI ratchet counts the required
+  array props that remain.
+
+  **Smaller fixes.** `NicePieChart` draws a 100 % slice as a full circle instead of nothing. In
+  development `NiceThemeProvider` warns when `--nice-primary` / `--nice-color-primary` (or another linked
+  pair) resolves to nothing on `:root` — usually an alias cycle in the app's CSS; the theming guides say
+  which side to set. `@nice2dev/game-engine` exports `createAnimationClip`, `AnimatorController` and
+  `createAnimatorController` (two modules exported each name, so `export *` dropped all three); the other
+  implementations are `StateMachineAnimatorController`, `createStateMachineAnimatorController`,
+  `createTimelineAnimationClip` and `createRetargetingAnimationClip`.
+
+  Nothing was renamed or removed.
+
 ## 1.1.9
 
 ### Patch Changes

package/README.md

@@ -56,12 +56,6 @@ This package ships unstyled component logic. Import the shared CSS bundle once a
 import '@nice2dev/ui/style.css';
 ```
 
-Optional: opt into the legacy shorthand token aliases (`--bg-*`, `--text-*`, `--border-*`, ...) when migrating from a custom design-token system:
-
-```tsx
-import '@nice2dev/ui/css/legacy-bg-text-aliases.css';
-```
-
 ## License
 
 MIT © NiceToDev

package/dist/__tests__/canvasCallbacks.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/rendersEmpty.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/DiagramCanvas.d.ts

@@ -38,6 +38,10 @@ export interface DiagramCanvasProps {
     onNodeCollapse?: (nodeId: string) => void;
     /** Interaction trigger callback */
     onInteraction?: (nodeId: string, interactionId: string) => void;
+    /** The pointer entered a node (its id) or left it (`null`). */
+    onNodeHover?: (nodeId: string | null) => void;
+    /** A group's label was clicked. */
+    onGroupClick?: (groupId: string) => void;
     /** Whether the canvas is interactive (editor) or read-only (viewer) */
     interactive?: boolean;
     /** Show grid */

package/dist/components/NiceDiagramViewer.d.ts

@@ -1,8 +1,8 @@
 import { default as React } from 'react';
 import { NiceDiagramDocument } from '../types/diagramTypes';
 export interface NiceDiagramViewerProps {
-    /** The document to display */
-    document: NiceDiagramDocument;
+    /** The document to display. Optional: without one the viewer shows an empty canvas. */
+    document?: NiceDiagramDocument;
     /** Language (default: en) */
     lang?: 'en' | 'pl';
     /** Auto-play animations on mount */

package/dist/components/NiceOrgChartVisualizer.d.ts

@@ -30,8 +30,8 @@ export interface OrgChartData {
     metadata?: Record<string, unknown>;
 }
 export interface OrgChartVisualizerProps {
-    /** Organization data */
-    data: OrgChartData;
+    /** Organization data. Optional: without it the chart renders empty. */
+    data?: OrgChartData;
     /** Root employee ID (CEO). Auto-detected if not provided */
     rootEmployeeId?: string;
     /** Called when an employee is clicked */