@nice2dev/ui-core 1.1.7 → 1.1.10

package/CHANGELOG.md

@@ -1,5 +1,151 @@
 # @nice2dev/ui-core — Changelog
 
+## 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
+
+- 1.1.9 — themes reach the controls again, every control has a rendered demo, no breaking changes.
+
+  **Theming.** `NiceThemeProvider`, `applyTheme` and `NiceThemePreview` write the `--nice-*` tokens
+  again, so a theme recolours the controls and not only the app's own CSS — since 1.1.7 only
+  light/dark switched. The provider's scope wins over values set on `:root`, as it did before 1.1.7:
+  put a brand colour into the theme rather than on `<html>`. Alias tokens are computed in the theme
+  scope, not only on `:root`. About 1,600 places that used a text token as a background or border, or
+  a surface token as text colour, now use the token of the right role. `--nice-warning-light` and
+  `--nice-danger-light` are the light shade of the status colour, like `--nice-success-light`
+  (new: `--nice-color-warning-light`, `--nice-color-error-light`); backgrounds use `--nice-*-bg`.
+
+  **Styles that never shipped.** Six stylesheets in `@nice2dev/ui` were unreachable from its entry
+  point, so `NiceLiveDataGrid`, `NiceTaskInbox`, `NiceBPMNDesigner`, `NiceInstanceMonitor`,
+  `NiceIntegrationHub`, `NiceRulesEngine` and `NiceVideoEditor` rendered unstyled; eleven more
+  components had no stylesheet at all; `workflow.css` read its spacing scale as pixels; and
+  `NiceModuleGrid` was styled for a `<table>` it does not render.
+
+  **Language.** `useNiceTranslation()` returns `{ t, lang }` and dates are formatted in the interface
+  language rather than the browser's (`ui-presentations` adds `useNiceLang()`). `NiceInvoiceLineEditor`
+  takes its currency and units from the active language unless you pass them. `NiceAuditLog`,
+  `NiceRecordingPanel`, the four game-engine editors and `NiceTemplateEditor` are translated, the
+  game-engine dictionary is actually registered, and 136 ui-audio strings have English defaults
+  instead of rendering raw keys.
+
+  **Canvas and document colours.** Canvas never resolves `var()`: the QR and barcode generators drew a
+  black rectangle, the whiteboard lost its colours and light presets parsed to `NaN`. Data colours are
+  resolved first now. Colours stored in documents — slide templates, theme presets, brand kits,
+  exports — are literals, so a saved document looks the same in every theme.
+
+  **Fixes found by the new demos.** All 895 controls now have a rendered showcase demo, and roughly
+  every third new demo exposed a bug. `ui-platform`: the service worker re-registered on every
+  render, a screen permission prompt appeared on mount, reconnects and start-up tasks ran twice,
+  valid EAN-13 codes were rejected. `ui-ai`: `createProviderFromConfig` dropped the endpoint path —
+  OpenAI, Anthropic and Groq were called without `/v1` and Azure always threw — and the theme
+  generator failed on every request. `ui-communication`: the local participant appeared twice in a
+  conference and `activeConversationId` was ignored. `ui-buildings`: automation days were saved as
+  indices (both forms are read now), the row toggle changed the selected rule instead of the clicked
+  one, and floor-plan devices were drawn in the corner. `ui-mobile`: `NiceTouchTable` rendered invalid
+  table markup. `ui-diagrams`: arrowheads grew with the stroke width and transition clicks never fired.
+  `ui-3d`: opening a code editor before the 3D view broke the whole app. `ui-presentations`: the editor
+  clipped slides in columns narrower than 800 px.
+
+  **Additive API only.** `@nice2dev/ui-platform` now exports its hooks, provider aliases and Props / Ref
+  types. Nothing was renamed or removed.
+
+## 1.1.8
+
+### Patch Changes
+
+- 1.1.8 — old problems closed, no breaking changes.
+
+  **English-first UI.** Text that was hardcoded Polish now goes through `t()` with an English
+  default: the planning views, the whole of `@nice2dev/ui-printing`, smart home, backup, the
+  navigation and settings panels, `@nice2dev/ui-buildings` end to end, the photo editor and the
+  presentation Q&A panel. The dictionary gains 566 keys in en, pl, de, fr, es and uk, so an app
+  with `locale="pl"` reads as before. Three prop defaults changed with it:
+  `NiceInvoiceLineEditor` (`currencySymbol` `'zł'` → `'$'`, `units` → English) and
+  `NiceTimeoutFeedback`'s two messages.
+
+  **Icons.** No emoji, unicode glyphs or inline `<svg>` are used as icons any more — not in JSX,
+  not in `icon:` data fields, not on canvas. Ten icons in `icons-business` / `icons-education`
+  that drew their artwork as `<text>` use paths now, and the behaviour-tree palette names resolve
+  to real `NiceIcon` builtins (`shield` and `repeat` are new; 176 in total).
+
+  **Fixes.** The shadcn adapter reads the host's `--primary` / `--accent` again instead of
+  producing invalid `hsl(#hex)`; `ui-diagrams` ships the 21 translation keys its components were
+  already asking for; `--nice-font-size-2xl` is declared; `NiceScheduler` warns in development
+  when it ignores a `currentDate`, `view` or `events` change; `ui-buildings` typechecks clean and
+  `DeviceProtocol` accepts `'mqtt'`.
+
+  **Docs.** `doc.json` no longer lists CSS variables no component implements; eleven components
+  document the tokens their stylesheets really read.
+
 ## 1.1.7
 
 ### Patch Changes

package/dist/core/cssColor.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Canvas and WebGL APIs take a colour string but do not understand CSS custom properties:
+ * `ctx.fillStyle = 'var(--nice-bg, #fff)'` is silently ignored and the previous colour
+ * stays. `resolveCssColor` turns a `var(--name, fallback)` into the value it has on
+ * `element` (pass the canvas, so a theme scoped to a wrapper applies), falling back
+ * through nested `var()` fallbacks. Any other string is returned unchanged. An element
+ * that is not in the document (an offscreen canvas) resolves against the root.
+ *
+ * @example
+ * ctx.fillStyle = resolveCssColor('var(--nice-bg-primary, #fff)', ctx.canvas);
+ */
+export declare function resolveCssColor(color: string, element?: Element | OffscreenCanvas | null): string;

package/dist/core/hooks.d.ts

@@ -143,8 +143,9 @@ export declare function useBrandColors(imageSource: string | HTMLImageElement |
  *
  * @example
  * ```tsx
- * const palette = generatePaletteFromColor('var(--nice-primary, #3b82f6)');
- * // { light: 'var(--nice-primary-bg, #dbeafe)', base: 'var(--nice-primary, #3b82f6)', dark: 'var(--nice-primary-dark, #1e40af)', ... }
+ * const palette = generatePaletteFromColor('#3b82f6');
+ * // { lightest: '#…', …, base: '#3b82f6', …, text: '#000000', textInverse: '#ffffff' }
+ * // — hex in, hex out (the input is parsed as #rrggbb)
  * ```
  */
 export declare function generatePaletteFromColor(baseColor: string): {

package/dist/core/i18n.d.ts

@@ -6,4 +6,6 @@
  */
 export { NiceI18nProvider, useNiceTranslation } from '@nice2dev/i18n';
 export type { NiceTranslateFn, NiceSupportedLang, NiceI18nProviderProps } from '@nice2dev/i18n';
+export { NiceI18nLazyProvider, loadNiceDictionary, getLoadedNiceDictionary } from '@nice2dev/i18n';
+export type { NiceI18nLazyProviderProps } from '@nice2dev/i18n';
 export { NICE_SUPPORTED_LANGS, NICE_I18N_DICTIONARIES } from '@nice2dev/i18n';

package/dist/core/marks.d.ts

@@ -0,0 +1,40 @@
+import React from 'react';
+/**
+ * CSS-drawn marks — the SOURCE OF TRUTH (TODO_1.1.9 B6).
+ *
+ * Eight packages (`social`, `templates`, `ui-security`, `licensing`, `ui-mobile`,
+ * `ui-platform`, `ui-science`, `auth`) ship with `dependencies: {}` — react and react-dom
+ * peers only — so they cannot reach `@nice2dev/icons` for a glyph. Each had grown its own
+ * copy of the same shapes, in three different unit systems: `licensing/src/marks.tsx` in
+ * `em`, `auth`'s refresh ring in `px` inside `NiceCaptcha.css`, `social/src/shapes.tsx` as
+ * `clip-path`. Three implementations of one open ring is exactly the drift B6 named.
+ *
+ * This module is that one implementation. Packages that depend on `@nice2dev/ui-core`
+ * import it from here; the dependency-free ones carry a GENERATED copy, kept identical by
+ * `scripts/audit-marks-sync.mjs` (gate `P1.8 marks-sync`, regenerate with `--write`).
+ *
+ * Units are `em` throughout, so a mark scales with the control it sits in — the `px`
+ * version did not. Colour is always `currentColor`, which keeps a mark on the foreground
+ * side of the token roles the P1.5 ratchets enforce. Every mark is `aria-hidden`: the
+ * accessible name belongs to the button or label that contains it, never to the mark.
+ *
+ * This is the sanctioned exception to the "icons come from @nice2dev/icons only" rule in
+ * CLAUDE.md: it applies where an icon dependency is not available at all, and it draws
+ * geometry with borders rather than substituting a glyph or an emoji.
+ */
+export interface NiceMarkProps {
+    /** Merged over the mark's own inline style. */
+    style?: React.CSSProperties;
+}
+/** Tick, drawn as two borders of a rotated box. */
+export declare const CheckMark: React.FC<NiceMarkProps>;
+/** Open ring, read as "reload"; the button it sits in carries the accessible name. */
+export declare const RefreshMark: React.FC<NiceMarkProps>;
+/** Chevron for expand / collapse affordances. */
+export declare const ChevronMark: React.FC<NiceMarkProps & {
+    direction: 'up' | 'down';
+}>;
+/** Filled dot, for status and presence indicators. */
+export declare const DotMark: React.FC<NiceMarkProps>;
+/** Close affordance: two strokes crossed, instead of a `×` glyph. */
+export declare const CloseMark: React.FC<NiceMarkProps>;

package/dist/core/theme.d.ts

@@ -42,7 +42,7 @@ export interface NiceThemeBackgrounds {
 export interface NiceThemeBackgroundImage {
     /** Background type */
     type?: 'none' | 'solid' | 'gradient' | 'image' | 'pattern';
-    /** CSS gradient string (e.g. 'linear-gradient(135deg, var(--nice-accent, #667eea) 0%, var(--nice-accent-dark, #764ba2) 100%)') */
+    /** CSS gradient string (e.g. 'linear-gradient(135deg, var(--nice-accent, #667eea) 0%, var(--nice-color-accent-hover, #764ba2) 100%)') */
     gradient?: string;
     /** Image URL */
     imageUrl?: string;

package/dist/core/traceless.d.ts

@@ -355,6 +355,7 @@ export interface TracelessComplianceReport {
  */
 export interface TracelessBadgeInfo {
     mode: TracelessMode;
+    /** NiceIcon name for the mode (render with `<NiceIcon name={…} />`). */
     icon: string;
     color: string;
     label: string;