@nice2dev/icons 1.3.8 → 1.3.10

package/CHANGELOG.md

@@ -1,5 +1,104 @@
 # @nice2dev/icons — Changelog
 
+## 1.3.10
+
+### Patch Changes
+
+- c694c87: **NiceIconPicker: a stack in every value format, stored as short code by default.**
+
+  `stackable` no longer needs HTML. With the default `valueFormat="name"` a plain icon stays its export
+  name (`NtdFolder`, as before), and a stack becomes short code. A folder with a star in its corner is
+  `Folder(Star@tr)`: 15 characters, against close to 1 kB as HTML.
+
+  The code nests like a function call, parent first, and gives each setting a sign of its own:
+
+  - `( , )`: what sits in the icon;
+  - `:o`: variant;
+  - `@tr`: position (`c t b l r`, corners, `h…` halfway);
+  - `%40`: size;
+  - `^15`: turn;
+  - `~5/-3`: nudge;
+  - `#2a2`: colours;
+  - `'3'`: text, with its own colour and size after it;
+  - `{count}`: bound text.
+
+  Names drop `Ntd`; a name or colour with one of the signs goes in backticks.
+
+  - **`valueFormat="json"`:** the same tree as JsonML, `["Folder",["Star",{"a":"tr"}]]`.
+    `valueFormat="html"` stays as in 1.3.9.
+  - **Every format is read, whatever the picker writes:** names, code, JSON and the HTML of 1.3.9.
+    Changing the format later breaks no stored value.
+  - **New:**
+    - `formatIconValue(layers, 'name' | 'json')` and `parseIconValue(text)`, outside React;
+    - `NiceIconValue`, which draws a stored value in any format and never injects markup.
+  - **`NiceIconHtml`** is now a deprecated wrapper of `NiceIconValue`.
+  - **`renderIconStack` / `NiceIconStack`** resolve a name without `Ntd` (`Star` → `NtdStar`).
+
+  Behaviour change: `stackable` without `valueFormat` used to write HTML (1.3.9) and now writes the
+  code. Pass `valueFormat="html"` to keep HTML. Values stored as HTML are still read; the next change
+  writes the picker's format.
+
+- 4409530: Icons, showcase feedback round 40:
+
+  - **NtdFrameCorners** (new): the four-corner selection frame, shared with NtdGroup.
+  - NtdGroup: the frame is 2× the stroke width in the filled variants. Duotone shows the frame and
+    the top-left object in primary and the other object in secondary; vivid puts the frame in the
+    accent colour.
+  - NtdShuffle: redrawn as two S-curves, 2× the stroke width except in `outline`. The arrow
+    underneath breaks where the arrows cross, and the gap is worked out from the stroke width.
+  - NtdTruck: the filled variants are all primary. The box and the cab are one shape, level at
+    the bottom. Duotone and vivid now use the theme's colours (vivid had fixed blue and amber
+    wheels).
+  - NtdBitcoin: the ₿ alone, without the disc, 1.5× the stroke width.
+  - NtdBluetooth: 1.5× the stroke width except in `outline` (vivid had a fixed 2.2).
+  - NtdCopy: the back sheet is smaller; NtdApartment: the building and the door are narrower.
+
+## 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