@nice2dev/ui-presentations 1.2.0 → 1.2.2

package/CHANGELOG.md

@@ -1,5 +1,147 @@
 # @nice2dev/ui-presentations — Changelog
 
+## 1.2.2
+
+### Patch Changes
+
+- 06eb0d2: 1.2.2 — library texts through the translator, a translator in the packages that had none, and the
+  end of the hook-dependency warnings. Nothing removed or renamed. Upgrade notes:
+  `documentation/omniverk/OMNIVERK_UPGRADE_1.2.2.md`.
+
+  **Translations.** 2,825 new keys in the global dictionary (en, pl, de, fr, es, uk), 80 in the local
+  dictionaries of ui-math, ui-diagrams and ui-presentations: column headers, option labels, texts in
+  conditions and templates, messages given to setters, labels returned by helpers, Polish texts that
+  were the English default. Relative dates through `Intl.RelativeTimeFormat`, plural forms through
+  `…One` / `…Many` keys. ui-science, ui-platform, ui-mobile, auth, licensing, templates, social and
+  the icon tools translate through `useNiceTranslation` (new peer `@nice2dev/ui-core ^1.2.0`);
+  ui-security reads the global translator when its own provider is absent.
+
+  **Additions.** `labelKey` on ui-mobile `TabItem` and `SwipeAction` (the presets set it);
+  `registerWebAuthn` / `authenticateWebAuthn` take the WebAuthn options `NiceWebAuthnButton` used to
+  drop (defaults unchanged); `NiceKeyboardHint` shows `descriptionKey`. Eight icons in
+  `@nice2dev/icons` — `NtdPoint`, `NtdSegment`, `NtdPerpendicular`, `NtdParallel`, `NtdMidpoint`,
+  `NtdAngleBisector`, `NtdGroup`, `NtdUngroup` — and the same names as `NiceIcon` built-ins.
+
+  **Behaviour changes, agreed.** ui-math, ui-diagrams and ui-presentations follow the app's global
+  `NiceI18nProvider` language when their own provider is absent (they stayed English);
+  `NicePresentationEditor` without `lang` takes the surrounding language. Icons drawn as glyphs are
+  Nice icons: the `NiceGeometry` tools, Align / Group / Ungroup / Layout of the diagram toolbar, the
+  presentation grid toggle, zoom and "Add Track" of `NiceDMXTimeline`. icons-gaming and
+  icons-filetypes name an icon by its `title` and are decorative without one, like `createIcon`
+  (screen readers read "GiHeart" or "DOCX file icon"); new optional `title` on the gaming icon props.
+
+  **Hook dependencies (161 → 0).** Fixed along the way: `NiceLowPowerMode` re-rendered forever from
+  mount and overflowed the stack on wake; `GenericPlayer` / `NiceGenericPlayerStage` restarted the
+  track on a volume change; `NiceDMXTimeline` called `onPlay` on every frame and missed cues added
+  during playback; `NiceConflictResolution` `autoResolve` never resolved; `NiceMAM` selected by the
+  previous filter; `NiceRulesEngine` "Run All" kept only the last result; `NiceCodeEditor` saved with
+  the first render's `onSave`; a consumer's cursor handler switched off `NiceCodeEditorAI`
+  completion; `useRadioStream` lost a volume set before the first play; `NiceGameEditor` shortcuts,
+  `useVoiceControl` continuous sessions, `NiceDeviceTrust` with a host storing the score.
+
+## 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

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

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

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

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

package/dist/components/NicePresentationEditor.d.ts

@@ -10,7 +10,10 @@ export interface NicePresentationEditorProps {
     onExport?: (format: string, content: string) => void;
     /** Launch presentation mode */
     onPresent?: (doc: Readonly<NicePresentationDocument>, startSlide?: number) => void;
-    /** Language */
+    /**
+     * Language. Default (1.2.2): the language around the editor - this package's provider, else the
+     * app's global one; before, always English.
+     */
     lang?: 'en' | 'pl';
     showToolbar?: boolean;
     showThumbnails?: boolean;

package/dist/core/i18n.d.ts

@@ -10,7 +10,18 @@ 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>;
+/**
+ * This package's translator: under its `NiceI18nProvider`, that provider's language; without one
+ * (since 1.2.2), the language of the app's global `NiceI18nProvider` — English when this package
+ * has no dictionary for it. Before 1.2.2 the controls stayed English without the package's own
+ * provider, whatever language the app used.
+ */
 export declare function useNiceTranslation(): NiceTranslateFn;
 /**
  * The language set on the nearest `NiceI18nProvider` (`'en'` outside one).