@nice2dev/icons 1.3.8 → 1.3.9

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # @nice2dev/icons — Changelog
 
+## 1.3.9
+
+### Patch Changes
+
+- f5f6251: **NiceIconPicker: a bindable value, stored as HTML, with icons stacked in its panel; a tidier NiceIconStacker.**
+
+  NiceIconPicker:
+
+  - Binds both ways: `value` / `defaultValue` + `onChange` (and `values` / `defaultValues` in
+    multi-select). Without a value it keeps its own selection — before, an uncontrolled picker showed
+    nothing after a pick.
+  - `valueFormat="html"`: the value is the icon drawn as an `<svg>` (1em, `currentColor`) to store in a
+    database, with what it was drawn from in `data-ntd-*` attributes, so the picker reads it back. The
+    ids inside are named after the drawing, so the markup can sit in another page. `parseIconHtml(html)`
+    reads it; `NiceIconHtml` draws it in React from the data, never injecting the markup.
+  - `stackable`: an "Overlays" tab in the panel with the NiceIconStacker — icons put on the chosen one,
+    nested, placed, sized, with text and colours; the stack goes into the same HTML (the default format
+    then). Swapping the icon keeps its stack.
+  - `displayMode`: the trigger shows the icon alone or the icon and its name; `optionDisplayMode` lists
+    the panel's icons alone or with names. Names show without `Ntd` everywhere (grid, search, names
+    read aloud), or as the entry's new `label`.
+  - `name` (a hidden input for forms), `aria-label` (the field's label, the icon's name after it), `id`,
+    `testId`, `iconProps` (what the icons are drawn with; the accent now follows the page background,
+    so cut-outs and stacked icons show in a dark theme).
+  - The panel opens above the trigger when there is more room there and never grows past what the
+    window and clipping ancestors leave visible.
+  - Fixed: the favourites star was a button inside the icon's button (invalid HTML, a console error);
+    with several icons selected the trigger shows their count (it showed the first icon); Escape while
+    picking an icon to stack goes back to the stack.
+
+  NiceIconStacker:
+
+  - Laid out to fit the picker's panel and less technical: the stack drawn large and small, the layers
+    as a list (select one to edit it — new icons go into it; Delete removes it), and under it the
+    selected layer only — its position on a pad shaped like its parent instead of a list of
+    `half-top-left`-style values, its size and text; turn, nudge, colours (swatches) and binding fold
+    under "More", the JSX code under "JSX code". Names show without `Ntd`.
+  - `onAddClick(target)` (the add button asks the host for the icon), the handle's `add(icon?)`,
+    `iconLabel`, `showCode`, `keepBase`.
+  - `addStackLayer` / `removeStackLayer` / `iconDisplayName` exported; new layers get short ids (`'1'`,
+    `'2'`…).
+
+  Behaviour changes: `values` passed as a constant `[]` no longer falls back to the picker's own
+  selection (a frozen controlled value, as with any controlled prop); the stacker's DOM is new (tests
+  that queried its `select` or radios need updating).
+
 ## 1.3.8
 
 ### Patch Changes