Kiwe launch

BRICKS-ICON-LIBRARY.md

docs/BRICKS-ICON-LIBRARY.md

Reference library / runtime

The current command manifest owns command grammar. Reference files are data; older command phrases in portable guidance do not authorize unsupported commands. Canonical runtime, current schemas and target evidence take precedence.

Complete source file · SHA-256 9a868355a970b35d8f8a0b9acad3104d2355064a0c36799240cd8974ba040deb

# Kiwe icons in Bricks

The native Bricks **Icon** control’s **Dynamic Data** chooser includes **Kiwe icons**. Select the icon there, then use Bricks’ normal size, colour and layout controls. No Kiwe enable switch, uploaded SVG, icon font or external request is needed. Existing Bricks editor access remains authoritative.

| Purpose | Dynamic tag |
| --- | --- |
| Cart, matching the Dock | `{kiwe_icon_cart}` |
| Notifications bell | `{kiwe_icon_notifications}` |
| Product wishlist | `{kiwe_icon_wishlist}` |
| Post bookmark | `{kiwe_icon_bookmark}` |
| Dock menu / profile / links / saved | `{kiwe_icon_menu}`, `{kiwe_icon_profile}`, `{kiwe_icon_links}`, `{kiwe_icon_saved}` |
| Theme / security | `{kiwe_icon_theme}`, `{kiwe_icon_secure}` |

Every packaged Lucide symbol is also exposed under its original name, using underscores: `arrow_right`, `bell`, `bookmark`, `circle_alert`, `download`, `grip`, `heart`, `key_round`, `log_out`, `map_pin`, `package`, `search`, `share_2`, `shield_check`, `shopping_bag`, `sparkles`, `sun_moon`, and `user_round`. Prefix each with `kiwe_icon_` and wrap it in braces.

An icon supplies artwork only. To open Notifications, add **name** `data-dsa-open-module`, **value** `notifications` to its real button or link. Cart uses value `cart`. The shared launcher owns badges and interactions. Wishlist/bookmark buttons use the existing [save attributes](FRONTEND-ATTRIBUTES.md). Give every icon-only interactive control a meaningful accessible label; its decorative SVG is hidden from assistive technology.

The registry is fixed and has no database or provider reads. SVG paths resolve lazily from the same small packaged sprite used by the Dock and are memoized for the request. They inherit `currentColor` and contain no external sprite reference. Unknown names and image, link, media or attribute contexts return empty; no caller can choose a file path or submit SVG. This vocabulary is separate from Design Context business fields.

The affected local proof is `tools/release/test-bricks-icon-library.php`. It exercises all symbols, aliases, registration, context/selector denials and malformed-artwork rejection. Optional `BRICKS_SOURCE` additionally runs the actual supplied native `Bricks\Element::render_icon()` and `render_svg()` methods with narrow WordPress adapters stubbed. Actual builder chooser, sanitation/save, role access and imported responsive rendering require separate native lab/browser acceptance; local compatibility does not establish deployment.

Machine contract · Markdown start · GitHub mirror · All commands