@nice2dev/ui-presentations 1.1.10 → 1.2.1

package/CHANGELOG.md

@@ -1,5 +1,178 @@
 # @nice2dev/ui-presentations — Changelog
 
+## 1.2.1
+
+### Patch Changes
+
+- 8c82c30: 1.2.1 — the decisions that waited since 1.2.0, and the debts the CI gates were holding. One API
+  change, agreed: `NiceIconSuggestorAI` suggests Nice icons only. Two stylesheets to import if you use
+  the packages: `@nice2dev/social/style.css`, `@nice2dev/ui-science/style.css`. Upgrade notes:
+  `documentation/omniverk/OMNIVERK_UPGRADE_1.2.1.md`.
+
+  **Tree-shaking.** An import from a package no longer brings the whole package. Module-level
+  statements that may have a side effect — a `displayName` assigned after each component (now
+  `Object.assign` inside `/* @__PURE__ */`, or under a development check for plain functions),
+  unannotated `forwardRef` / `memo` / `createContext` / icon-factory calls, spreads, registries filled
+  at import, `<style>` tags injected at import, a direct `eval` in ui-math — are gone. One import from
+  each of 53 packages: 5066.5 kB → 1171.6 kB (`@nice2dev/ui` 1928.2 kB → 12.9 kB, icon packs 48–275 kB
+  → 1.6–2.6 kB). `defaultViewRegistry` has the Nice\* input controls from the start, each loading its
+  module on first render; sixteen controls add their styles to `<head>` on first render.
+
+  **Dead code.** 405 source files no entry point imported (never on npm) are deleted;
+  `NiceClipboardStack` (`@nice2dev/ui`) and `NiceSampleBrowser` (`@nice2dev/ui-audio`), finished and
+  documented, are exported.
+
+  **ui-mobile draws Nice icons.** New peer `@nice2dev/icons ^1.2.0`; `TabIcons`, `DrawerIcons`,
+  `HeaderIcons`, the `NiceSwipeActions` presets and the `NiceInfiniteScroll` states are `Ntd*` icons
+  instead of pasted `<svg>`, simple glyphs are CSS marks. `@nice2dev/icons` adds `NtdReply` and
+  `NtdInbox`; an icon no longer throws without `window.matchMedia`.
+
+  **`NiceIconSuggestorAI` (breaking, agreed).** `AIIconLibrary` is `'nice'`; `svgPath` and `unicode`
+  left `AISuggestedIcon`; the preview is a `<NiceIcon>`, "Copy SVG" is "Copy JSX".
+
+  **Peer ranges.** Every internal `@nice2dev/*` peer is `^1.2.0` (was as wide as `^1.0.20`), except
+  `@nice2dev/icons ^1.2.1` where a package draws an icon new in 1.2.1: ui-mobile (`NtdReply`,
+  `NtdInbox`), ui-audio (`NtdMicrophoneOff`) and ui-security (`NtdBackspace`). ui-security, licensing
+  (`^1.2.0`) and templates (`^1.2.0`) gain the `@nice2dev/icons` peer: their glyph icons (`⌫`, `←`,
+  `→`, `↑`, `↓`) are Nice icons now. `@nice2dev/icons` adds `NtdBackspace`.
+
+  **Class names inside components.** 834 class names in library stylesheets had no `nice-` prefix
+  (`.tab-button`, `.status-badge`, `.selected`, …) and styled every element of that name on the page.
+  They follow `nice-{block}__{element}--{modifier}` now — no change on screen. The class theme hooks
+  next to `[data-theme]` on seven controls (`dark` on the AI chart / data grid / code and HTML
+  editors / form builder, `light-theme` on `NiceMAM` and `NiceVideoAnnotator`) are `nice-dark` /
+  `nice-light`; `NiceLowPowerMode` marks `<html>` with `nice-lpm-no-animations` /
+  `nice-lpm-reduced-quality`; the `NiceVideoEditor` of `@nice2dev/ui-video` styles its elements under
+  `nice-video-studio`, so they no longer collide with the `NiceVideoEditor` of `@nice2dev/ui`.
+  Rules for classes nothing rendered are gone, among them the stylesheet of `NiceGanttChart`, which
+  left ui-erp in 1.0.10.
+
+  **Translations.** About 3,400 UI texts in 32 packages were hard-coded; they go through `t()` now,
+  with the English text unchanged and pl / de / fr / es / uk in `@nice2dev/i18n` (ui-diagrams,
+  ui-presentations and ui-math in their own dictionaries). In `@nice2dev/events` and
+  `@nice2dev/admin` that includes column headers, option labels and the statuses and roles they used
+  to print raw (`checked-in`, `no-show`) — English labels for those come from the dictionary. ui-3d and ui-graphics read the app's
+  global translator, as ui-audio does since 1.2.0 — their own provider overrides it. ui-audio's
+  controls used 631 keys the dictionary did not have (English in every language), and the radio
+  player showed raw keys (`search_stations`). Texts that were hard-coded **in Polish** — in
+  `NiceSidebarNav`, `NiceNetworkDiscoveryPanel`, the backup and smart-home controls,
+  `NiceSavedQueryPanel`, `NiceNotificationPreferences`, the ui-buildings panels, the ui-printing
+  template editor and the photo editor — default to English now; Polish is in the dictionary. English
+  plurals glued on (`result{s}`) are two keys. `presentationsTranslator(lang)` (ui-presentations)
+  translates outside its provider.
+
+  **List props are optional.** 170 list props (`items`, `columns`, `data`, …) in 15 packages that
+  were required without a default are optional, with a stable empty default; every one of those
+  controls mounts without data (tested). `NiceStockChart` without data no longer computes NaN
+  coordinates.
+
+  **Unstyled components get stylesheets.** 98 components rendered class names no stylesheet had —
+  admin panels, auth forms, events rounds and pickers, the ERP invoice / purchase order / VAT table /
+  HR dashboard, the radio player, `NiceInbox`, PWA prompts, `NiceViewRenderer`, shells, smart-home,
+  … The fixed layout that sat in inline style objects is in classes now, so an app can override it;
+  values that depend on data stay inline. **`@nice2dev/social` and `@nice2dev/ui-science` ship a
+  stylesheet — import `@nice2dev/social/style.css` / `@nice2dev/ui-science/style.css`.** ui-science's
+  `sideEffects` is `["*.css"]`. Colours, spacing and radii in every stylesheet come from theme tokens
+  (visible in dark themes: `NiceRecipe` difficulty badges, transcoder states, warehouse heat map).
+
+  **Icons only from Nice.** About 130 glyphs (`×`, `→`, `↑`) and 100 pasted `<svg>` used as icons
+  are Nice icons; 11 `<svg>` stay as the control's own graphic (logos, spinners, checkbox mark). `NiceIcon`
+  gains `pin`, `mic-off`, `log-out`, `chevrons-left`, `chevrons-right`, `zoom-in`, `zoom-out`,
+  `navigation`, `refresh-ccw`, `minimize` and `smartphone`; `@nice2dev/icons` gains
+  `NtdMicrophoneOff`. The `icon` fields of the module, menu, tab, mode, quick-action, scene and admin
+  widget DTOs, notification channels and view toolbar items are rendered through `NiceIcon` — they
+  used to be printed as text. `NiceRatings` `thumbs` draws shapes instead of emoji.
+
+  **Dialogs instead of `window.prompt` / `confirm` / `alert`.** New `useNiceDialogs()` — `prompt`,
+  `confirm` and `alert` as promises on `NicePromptDialog` / `NiceConfirmDialog` — and
+  `NiceConfirmDialog.showReject`. Seventeen controls asked through the browser's blocking dialogs and
+  use the library's now (`NiceFileManager`, `NiceHtmlEditor`, `NiceViewRenderer` action `confirm`, the 3D,
+  vector and pixel editors, …). Keys pressed in `NicePromptDialog` / `NiceConfirmDialog` no longer
+  reach the page's shortcuts (Escape still closes them), and `NicePromptDialog`'s backdrop covers the
+  whole viewport.
+
+  **Smaller fixes.** `NiceFileManager.items` is optional. `NiceMLStudio` status badges: `draft`,
+  `registered`, `archived`, `cancelled` get a neutral colour, deploying / stopped deployments theirs.
+  Component docs (`doc.json`) list only props the components have. `NiceMobileTabs`: tabs beyond
+  `maxTabs` open from "More" (it only logged). `NiceInventoryManager`: new `onCreatePurchaseOrder`;
+  without it the "Create PO" button is gone (it only logged). Keyboard: `NiceNavShell` tabs follow the
+  WAI-ARIA tabs pattern, clickable `NiceDeviceTile` / `NiceCardGroup` cards and animated icons with
+  `trigger="click"` are focusable. ui-math: `CalculatorService.evaluate` parses instead of running
+  `new Function` (`asin`, `sinh`, `ceil`, exponents and `angleUnit` were wrong); `ExpressionParser`
+  takes `functions`, `constants`, `ignoreCase` and `strict`, multiplies implicitly (`2x`) and reads `^`
+  right to left. `InvoiceLine.vatRate` and `VatRate.rate` are documented as fractions (0.23).
+  `AmqpServerBinding` is `Record<string, never>`.
+
+## 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

package/README.md

@@ -67,12 +67,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/core/i18n.d.ts

@@ -10,6 +10,11 @@ export interface NiceI18nProviderProps {
     lang?: NicePresentationsLang;
     children: ReactNode;
 }
+/**
+ * The translator for one language — the provider's, and NicePresentationEditor's own: it renders
+ * the provider for its `lang`, so a hook in it would read the context above.
+ */
+export declare function presentationsTranslator(lang: NicePresentationsLang): NiceTranslateFn;
 export declare const NiceI18nProvider: React.FC<NiceI18nProviderProps>;
 export declare function useNiceTranslation(): NiceTranslateFn;
 /**