@nice2dev/ui-core 1.1.6 → 1.1.9

package/CHANGELOG.md

@@ -1,5 +1,130 @@
 # @nice2dev/ui-core — Changelog
 
+## 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
+
+- Close the three items left open in the 1.1.6 response to OmniVerk.
+
+  **Every value control works without state in the parent.** The `audit-controllable-state` gate
+  counted 87 value props that were required with no `default*`, so the control could not render from a
+  manifest without data. It now reports 0 and gates CI at `--max=0`. 48 controls gained `default*` props
+  through `useControllableState` (existing `value` + handler call sites behave as before); 33 read-only
+  data lists are optional with a stable empty default; 4 props paired with a handler only by name are
+  optional; `NiceWhiteboard` and `NiceMetricsDashboard` render an empty state until a session or
+  dashboard arrives. Additive API only — nothing renamed or removed.
+
+  - `NicePivotGrid.fields`, `NiceScheduler.events` and `NiceGitHooks.hooks` are controlled only together
+    with their change handler, as `NiceScheduler` already documented for `currentDate`/`view`. A bare
+    prop stays an initial value; prop plus handler now always wins (later prop updates used to be
+    ignored). `NiceGitHooks.onHookChange` is now called; `onHooksChange` and
+    `NiceLocaleManager.onTranslationsChange` are new.
+  - `NiceCodeEditor` / `NiceCodeDiffEditor` no longer report a value written from the prop back through
+    `onChange`, and call the latest handler rather than the one captured at mount.
+  - `NiceHtmlEditor` no longer rewrites its content on every render (React 19 compares the
+    `dangerouslySetInnerHTML` object, not its string), which moved the caret; the HTML source and
+    Markdown views can be closed again.
+  - Selections seeded once from the first item (access manager, automation/scene editors, git diff
+    viewer, ribbon, setup wizard) follow data that arrives after mount.
+  - `useControllableState`: new `fallbackValue` seed that never triggers the value/default clash warning;
+    two functional updates in one tick no longer lose the first; `onChange` is called with one argument
+    when there is no meta. `UseControllableStateOptions` is now a union type alias.
+
+  **`--nice-*` is the source of truth for design tokens.** Controls read only `--nice-*` (9,225 reads in
+  339 files). The unprefixed names (`--color-primary`, `--bg-primary`, `--text-muted`, …) stay declared
+  as aliases pointing at the Nice tokens, so reading them works, but setting them no longer repaints Nice
+  controls. Apps that relied on that can import `@nice2dev/ui/css/legacy-bg-text-aliases.css` after
+  `style.css` (removed in 1.2), or set `--nice-color-primary` and friends directly. 13 tokens that were
+  read and never declared (`--color-danger`, `--text-on-primary`, `--color-white`, …) are defined; the
+  dark blocks define the canonical names, so `.nice-dark` on `<body>` no longer leaves them on light
+  values; `--nice-primary-bg` and `--nice-selected-bg` are a primary tint instead of falling through to
+  grey. New gate `audit-token-names`.
+
+  **Node ESM and `require()`.** `@nice2dev/spatial-core` imports from plain Node ESM (51 relative
+  specifiers gained extensions, enforced by `nodenext`), and so does `@nice2dev/ui-buildings`, which
+  failed through it. `require()` works for `ui-3d`, `ui-graphics` and `game-engine`. The package-exports
+  gate now loads every entry in both module systems.
+
+  **Hygiene.** Sources are prettier-formatted and CI gates on it; 640 stale `.d.ts` files were removed
+  from source trees (never published).
+
 ## 1.1.6
 
 No changes in this release.

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/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;

package/dist/core/useControllableState.d.ts

@@ -1,14 +1,30 @@
 import type { NiceChangeMeta, NiceOnChange } from './standardProps';
-export interface UseControllableStateOptions<T, TEvent = unknown> {
-    /** Controlled value. When defined, hook is in controlled mode. */
-    value?: T;
+/**
+ * Where uncontrolled state is seeded from. Two roles that used to share one field:
+ * `defaultValue` is the consumer's raw `default*` prop (the only thing the
+ * value+default clash warning looks at), `fallbackValue` is the control's own
+ * empty seed (`''`, `[]`, `0`) and never triggers a warning. One of them must be
+ * a `T`, so the returned value is always a `T`.
+ */
+export type UseControllableStateSeed<T> = {
     /** Initial value used in uncontrolled mode. */
     defaultValue: T;
+    /** Seed used when `defaultValue` is undefined. */
+    fallbackValue?: T;
+} | {
+    /** The consumer's `default*` prop, possibly undefined. */
+    defaultValue?: T | undefined;
+    /** Seed used when `defaultValue` is undefined. Never triggers the clash warning. */
+    fallbackValue: T;
+};
+export type UseControllableStateOptions<T, TEvent = unknown> = {
+    /** Controlled value. When defined, hook is in controlled mode. */
+    value?: T;
     /** Change callback invoked in both modes. */
     onChange?: NiceOnChange<T, TEvent>;
     /** Component name (used for dev warnings). */
     componentName?: string;
-}
+} & UseControllableStateSeed<T>;
 export type UseControllableStateReturn<T, TEvent = unknown> = readonly [
     T,
     (next: T | ((prev: T) => T), meta?: NiceChangeMeta<TEvent>) => void,