@nice2dev/ui-core 1.0.29 → 1.0.30

package/CHANGELOG.md

@@ -1,5 +1,140 @@
 # @nice2dev/ui-core — Changelog
 
+## 1.0.30
+
+### Patch Changes
+
+- 2f9e5d4: Showcase-feedback round 10 (editors state/props + bugs + datetime consolidation):
+  - NiceCheckbox: tri-state `indeterminate` now reaches all three states; expose
+    readOnly/loading/labelPlacement/errorPlacement in the props panel.
+  - NiceToggle/NiceRating: expose readOnly/loading/error/placement props; Rating
+    `loading` now replaces the stars with a spinner.
+  - NiceRadioGroup / NiceTagBox: implement `readOnly` (was ignored).
+  - NiceNumberInput: value stays right-aligned on blur; new `suffixSeparator` prop
+    (default false) gating the value↔suffix divider.
+  - NiceDatePicker: datetime shows a dot separator instead of the ISO `T` (emitted
+    value keeps `T`); datetime mode gains `showSeconds`, `minuteStep`, `showNow`,
+    and `hourFormat` (native picker) — ported from the now-removed
+    NiceDateTimePicker.
+  - NiceTimePicker: honor the `placeholder` prop.
+  - NiceSlider: more spacing around a left-placed label.
+
+  Removed **NiceDateTimePicker** (breaking): its datetime capability is covered by
+  NiceDatePicker's datetime mode; NiceForm, ui-forms `formUtils`, and ui-core
+  `adapters` now resolve datetime fields to NiceDatePicker.
+
+- 7771af3: Round-13 showcase-feedback fixes across ~23 controls.
+
+  **Behaviour / bug fixes**
+  - **NiceUpload** — restored the dropzone look (icon + themed box + hover tint;
+    `variant` now defaults to `"dropzone"`).
+  - **NiceCard** — `selected` now shows a ring (drawn on a `::after` pseudo-element
+    so the display-style inline chrome can't override it).
+  - **NiceMenu** — the active-item highlight fills the bar; `separated` (default)
+    gained a subtle toolbar surface.
+  - **NiceLookup** — implemented `disabled` (gray-out), `readOnly` (inert),
+    `loading` (spinner), and `labelPlacement` / `errorPlacement`.
+  - **NiceColorPicker** — the palette popup follows the theme instead of always
+    rendering light; hex input honours `withAlpha`; `withAlpha`/`compact` are now
+    documented. **`showInput` and `showRandom` now default to `false`** (was `true`).
+  - **NiceSignature** — theme-aware canvas (empty `penColor`/`backgroundColor`
+    resolve to the theme's text/background), plus a `label` prop and an
+    `onChangeDataUrl` callback ported from the removed NiceSignaturePad.
+  - **NiceSegmentedControl** — the active thumb is hidden while `loading`.
+  - **NiceAutocomplete** — multiple-mode selections render as separate bordered
+    chips with per-chip remove; the clear button matches the other controls.
+  - **NiceCalendar** — `multiple` works (uncontrolled fallback); `min`/`max` only
+    apply to complete ISO dates.
+  - **NiceDateRangeBox** — horizontal layout stays on one line; `labelPlacement`
+    works inline.
+  - **NicePickList** — drag-reorder works in both columns with insert-position
+    indicators. **When `sortable` is off (the default), both lists now auto-sort
+    alphabetically** (display-only; consumer arrays keep their order).
+  - **NiceColorPalette** — the hue ring supports press-and-drag.
+  - **NiceVirtualScroller** — `itemHeight`/`height` are honoured, and it gained
+    `size` + `disabled`/`loading`/`error` states.
+  - **NiceBusinessCard** — `variant` (card/inline/compact) and `showLogo` (with a
+    fallback avatar) now render.
+
+  **Breaking (patch, pre-1.2.0 convention)**
+  - **NiceSignaturePad is removed** — it duplicated **NiceSignature**. Its `label`
+    and data-URL value model were ported (`label`, `onChangeDataUrl`). Migrate to
+    `NiceSignature`; for a data-URL value use `onChangeDataUrl` or the imperative
+    `ref.toDataURL()`. (The separate touch-optimised `@nice2dev/ui-mobile`
+    `NiceSignaturePad` is unaffected.)
+
+- da12dfb: Round-17 showcase-feedback fixes (6 select/editor controls).
+  - **Select-dropdown standardization** — the menus of NiceSelect / NiceAutocomplete /
+    NiceLookup / NiceTreeSelect / NiceDropDownBox now abut the input (new
+    `--nice-dropdown-gap`, default `0px`, replacing a hardcoded 4px). NiceAutocomplete /
+    NiceLookup / NiceTreeSelect gain an optional `menuGap` prop. NiceDropDownBox's menu
+    gains the standard border (its `.nice-dropdown` had no CSS), and its clear `×` moved
+    inside the trigger (it was rendering below the control). NiceTreeSelect option rows
+    get more left padding.
+  - **NiceDateTimePicker** — the time-spinner ▲/▼ buttons now support press-and-hold
+    auto-repeat (new shared `useHoldRepeat` hook in `@nice2dev/ui-core`). (The 24-hour
+    default was a demo-seed issue, fixed in the showcase.)
+  - **NiceLookup** — `readOnly` no longer changes the control height (the chevron slot is
+    kept), and `errorPlacement="right"` no longer widens the field when there's no error.
+  - **NiceCardGroup** — new `readOnly` (blocks selection without dimming) and `errorText`
+    props; `size` now scales the child cards (they inherit the group size via context),
+    not just the grid gap.
+
+- bea5451: Round-18 showcase-feedback fixes (12 editor controls).
+  - **Select family** — NiceTreeSelect now has a stable trigger width (min-width like
+    NiceLookup, no longer tracking the value), its dropdown Search reuses the shared
+    `.nice-select__search` (left padding + normal vertical padding), and the empty state
+    gets padding. NiceAutocomplete inserts the option's DisplayName (label) on select
+    instead of the raw lowercase `value`. NiceLookup's `errorPlacement='right'` error is
+    absolutely positioned so it no longer widens the control.
+  - **NiceRangeSlider** — for `valuePlacement` right/bottom the value moves to a header
+    row above the track (mirroring NiceSlider) so it no longer overlaps the slider.
+  - **NiceDateRangeBox** — a stable `min-width` keeps disabled/readOnly from narrowing the
+    control; the loading spinner and `errorPlacement='right'` error align to the input row.
+  - **NiceDateTimePicker** — the time popup is now a slot-machine of vertical scroll-snap
+    columns for hours/minutes (animated, fade-masked); the ▲/▼ buttons keep hold-to-repeat
+    and typing a digit overwrites (INSERT).
+  - **NiceSkeleton** — new `animationSpeed` prop (seconds, default 1.8 ≈ 20% slower);
+    numeric-string `width`/`height` are coerced to px so both props apply.
+  - **NiceUpload** — new `labelPlacement` prop (`'right'` default | `'bottom'`): the text
+    sits beside the icon by default, below it when set.
+  - **NiceSignature** — the placeholder is translated (`signature.placeholder`, added to
+    the ui-core + i18n dictionaries for en/pl/de/fr/es/uk); the demo drops its synthetic
+    label + generic placeholder and the signature line is raised.
+  - **NiceColorPalette** — the collapsed field is a compact multi-colour strip at
+    NiceColorPicker's 32px height (chevron removed); the studio popup is split into
+    NiceTabs (Colors / Presets / Variations / Info / Schemes) and the swatch "kredki" are
+    reshaped into compact bars (chip + hex + remove ×) to the right of the wheel.
+  - **NiceGradientPicker** — redesigned to mirror NiceColorPicker/Palette: a compact 32×32
+    swatch field opens a portaled popup with NiceTabs (Editor / Presets / CSS); the
+    `NiceGradientValue`/`onChange` API and exported helpers are preserved.
+
+- 783d0db: fix(controls): showcase-feedback round 3 — core controls, deeply honed
+  - **NiceButton**: icon-only is a properly padded square (symmetric padding per size), `fullWidth` stretches to 100% width with normal height (no giant square), and the loading spinner no longer collapses the box (the icon is kept in flow, hidden).
+  - **NiceDropDownButton**: the portaled menu now carries the trigger's theme (fixes white-on-white rows in scoped themes) and hover/selected set both background and colour; `readOnly` is now visually distinct from `disabled` (own class, not greyed) while still blocking the menu.
+  - **NiceSegmentedControl**: the active thumb now fills the selected segment exactly (removed a double-counted container inset that left a gap).
+  - **NiceBadge**: `size` now scales width + font too (the display style no longer pins `fontSize`/`padding` inline, so the size class governs).
+  - **NiceCarousel**: slide switching / autoPlay / circular work again (no longer frozen by a bare controlled `activeIndex`), `size` has real rules (arrow size + viewport height), and a new `fullWidth` prop (default `true`) toggles fill-vs-content width.
+  - **NicePDFViewer**: shows `1 / 1` and `100%` and stays interactive (non-positive controlled `page`/`zoom` are ignored); print converts a `data:` URI to a Blob URL so the tab actually prints.
+  - **NiceQRCode / NiceBarcodeGenerator**: the default module/bar colour follows the element's own theme surface (dark → light, light → dark) via a ref-aware `useThemeIsDark`; empty `color`/`background` are guarded.
+  - **NiceTooltip**: new `position: 'auto'` (now the default) picks the on-screen side with the most room (collision detection).
+  - **NiceFAQ**: items collapse regardless of `animateExpand` (only the transition is gated on it).
+  - **NiceTimeline**: horizontal mode draws its connector line and centres the item text; the body line renders at ~70%.
+  - **NiceDivider**: the text variant fills its container so the flanking lines are visible.
+  - **NiceSkeleton**: grouped rows (`count > 1`) get a definite width so `text`/`rect` variants render and animate (not just `circle`).
+
+  `useThemeIsDark` now accepts an optional element ref and resolves against that element's nearest theme scope (backwards-compatible: no-arg still observes `<html>`).
+
+- 9816474: fix(controls): showcase-feedback round 6 — data + nav controls (8 items)
+  - **NiceTabs**: `vertical` now lays out as a sidebar (tab list left, content right) instead of stacking, and the panel keeps a stable size so switching tabs doesn't make the control jump.
+  - **NiceTable**: sort icons match NiceDataGrid — a neutral double-chevron when idle, a single up/down chevron for asc/desc, muted (new `sort` NiceIcon).
+  - **NiceDataGrid**: the aggregate summary is pinned directly above the pagination (no more jump on page change — it's no longer a sticky `<tfoot>`); the Filter button is now a proper `nice-btn` with a filter icon; toolbar placeholder glyphs (`?`/`??`) replaced with NiceIcons.
+  - **NiceList**: `size` now scales row density/font; `disabled`/`readOnly`/`error` states work; the loading spinner is centered and hides the search bar; new optional `header` prop that stays visible during loading.
+  - **NiceMenu**: bar-variant (separated/ghost/borderless) item highlight fills the item box edge-to-edge (no gap frame, no rounded-pill shrink; rounding only on the bar's outer corners).
+  - **NiceContextMenu**: item highlight fills each row (removed the container top/bottom padding and added `overflow:hidden`, so no top gap, no side overflow, corners clipped to the container).
+
+  Plus demo polish: NiceCardView cards now have a coloured header, status badge and footer actions; the NiceSpeedDialAction demo drops its bounded container (just the button).
+
 ## 1.0.29
 
 ### Patch Changes

package/dist/core/hooks.d.ts

@@ -19,6 +19,18 @@ export declare function useLongPress(callback: () => void, holdMs?: number): {
     onPointerUp: () => void;
     onPointerCancel: () => void;
 };
+/**
+ * Press-and-hold auto-repeat for stepper buttons. `start(action)` repeats `action`
+ * at an accelerating rate while held (first repeat after 400ms, then speeding up to
+ * ~30ms); `stop()` ends it. Keep the button's own `onClick` for a single tap and
+ * wire `start`/`stop` to `onPointerDown` / `onPointerUp` + `onPointerLeave` (works
+ * for mouse, touch and pen). Used by NiceNumberInput and NiceDateTimePicker's time
+ * spinners.
+ */
+export declare function useHoldRepeat(): {
+    start: (action: () => void) => void;
+    stop: () => void;
+};
 /**
  * Returns a stable unique HTML id. Passes through `externalId` when provided,
  * otherwise generates one via React's `useId()`.

package/dist/core/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":"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"}

package/dist/core/i18nDictionaries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18nDictionaries.d.ts","sourceRoot":"","sources":["../../src/core/i18nDictionaries.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,+IAuBvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAi6KtE,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBpF,CAAC"}
+{"version":3,"file":"i18nDictionaries.d.ts","sourceRoot":"","sources":["../../src/core/i18nDictionaries.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,+IAuBvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAu6KtE,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBpF,CAAC"}

package/dist/core/icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/core/icons.tsx"],"names":[],"mappings":"AACA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAqNtE,yFAAyF;AACzF,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAU5D,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;AAW3F,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAE5D,CAAC;AAiDF;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CA0C5C,CAAC;AAKF;;;GAGG;AACH,wBAAgB,WAAW;uBAKf,KAAK,CAAC,SAAS,GAAG,MAAM,GAAG,SAAS,SACpC,YAAY,GAAG,MAAM,KAC1B,KAAK,CAAC,SAAS;EAarB;AAED,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,UAA6B,CAAC"}
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/core/icons.tsx"],"names":[],"mappings":"AACA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAuNtE,yFAAyF;AACzF,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAU5D,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;AAW3F,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAE5D,CAAC;AAiDF;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CA0C5C,CAAC;AAKF;;;GAGG;AACH,wBAAgB,WAAW;uBAKf,KAAK,CAAC,SAAS,GAAG,MAAM,GAAG,SAAS,SACpC,YAAY,GAAG,MAAM,KAC1B,KAAK,CAAC,SAAS;EAarB;AAED,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,UAA6B,CAAC"}

package/dist/core/useThemeIsDark.d.ts

@@ -1,15 +1,22 @@
+import type { RefObject } from 'react';
 /**
  * Live boolean indicating whether the active theme renders as "dark".
  *
- * Resolution order:
- * 1. `<html data-theme="dark|light">` attribute (explicit consumer wins)
- * 2. `nice-dark` / `nice-light` (and bare `dark`) class on `<html>`
- * 3. `--text-primary` CSS variable luminance (light text → dark theme)
+ * Resolution order (evaluated against the nearest theme scope of `ref`, or
+ * `<html>` when no ref is given):
+ * 1. `data-theme="dark|light"` on the nearest scoped ancestor (explicit wins)
+ * 2. `nice-dark` / `nice-light` (and bare `dark`) class on that scope
+ * 3. the element's own resolved `--text-primary` luminance (light text → dark)
  * 4. `prefers-color-scheme: dark` media query as last-resort fallback
  *
- * Updates whenever any of the above change (MutationObserver on `<html>`
- * attributes/class/style + media-query listener), so canvas-based renderers
- * (QR, barcode, charts…) stay in sync without consumers wiring `useDarkMode`.
+ * Pass a `ref` to a rendered element (e.g. a canvas) so the result reflects the
+ * element's **own** surface — `NiceThemeProvider` themes a scoped container, not
+ * `<html>`, so a canvas nested under a scoped provider must read its own scope,
+ * not the document root. Without a ref it observes `<html>` as before.
+ *
+ * Updates whenever the observed scope (or `<html>`) attributes/class/style or the
+ * media query change, so canvas-based renderers (QR, barcode, charts…) stay in
+ * sync without consumers wiring `useDarkMode`.
  */
-export declare function useThemeIsDark(): boolean;
+export declare function useThemeIsDark(ref?: RefObject<HTMLElement | null>): boolean;
 //# sourceMappingURL=useThemeIsDark.d.ts.map

package/dist/core/useThemeIsDark.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useThemeIsDark.d.ts","sourceRoot":"","sources":["../../src/core/useThemeIsDark.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,IAAI,OAAO,CA4BxC"}
+{"version":3,"file":"useThemeIsDark.d.ts","sourceRoot":"","sources":["../../src/core/useThemeIsDark.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,OAAO,CAoC3E"}