@scalepad/ui 0.1.0

package/.ai/rules/figma-lm-design-system-keys.md

@@ -0,0 +1,680 @@
+<!-- Auto-generated from .cursor/rules/ at publish time. Do not edit here; edit the canonical source. -->
+
+> **Path-context note:** Paths in this rule that begin with `src/frontend/ClientApps/packages/ui/src/...` refer to the ScalePad UI source tree as authored. In your consumer project, that source lives at `node_modules/@scalepad/ui/src/...`. Treat the two paths as interchangeable when you're reading examples.
+
+
+# LM Design System — Cached Key Reference
+
+This file is a **persistent cache of LM Design System keys** harvested by walking the canonical LM Design System file (`fileKey VCLfybgU3OaUUPrQdBaVmP`, ~60 component pages + foundations). It is the *authoritative* key map for the published library — every key in this file was verified live against the LM Design System file on the harvest date below.
+
+Pair this with [`figma-design-system.mdc`](mdc:.cursor/rules/figma-design-system.mdc). That file owns the *rules* (when to use which component, forbidden patterns, role-based color mapping). This file owns the *keys* you'd otherwise have to search for.
+
+**Last harvested:** 2026-05-14 (full walk of LM Design System file `VCLfybgU3OaUUPrQdBaVmP` — every component page, every local variable in `Tokens`/`spacing`/`border radii`/`typography`/`shadows`/`Primitives` collections, all 19 text styles, all 10 effect styles, and the curated subset of the 1,604 `Icon /` glyphs that recurs in real mockups).
+
+## How to use this file
+
+1. Pick the component / variable / style by **role** using the existing `figma-design-system.mdc` mapping (e.g., "primary CTA → Button + `Background/Primary/filled`").
+2. Look up its **key** in the tables below.
+3. Pass it directly to `figma.importComponentSetByKeyAsync(KEY)` (component set) / `figma.importComponentByKeyAsync(KEY)` (single component, including icons) / `figma.variables.importVariableByKeyAsync(KEY)` (variable) / `figma.importStyleByKeyAsync(KEY)` (text or effect style).
+4. **Always still read `componentPropertyDefinitions` at runtime** for `INSTANCE_SWAP`, `BOOLEAN`, and `TEXT` property keys — those `#nnn:m` suffixes are unstable per `figma-design-system.mdc` §9. The cache only short-circuits the *component-key* lookup.
+
+If the cache is missing a component you need, run `search_design_system` once for that name, **add the key to this file**, then proceed.
+
+## When the cache is wrong
+
+Keys here are LM Design System keys that were live as of the timestamp above. They can rot if upstream rebuilds a component from scratch (rare but possible). If `importComponentSetByKeyAsync(...)` throws or returns null:
+
+1. **STOP.** Don't fall back to `Basic Design System` or a primitive recreation.
+2. Re-resolve via `search_design_system` filtered to the LM library:
+   ```js
+   search_design_system({
+     fileKey: "VCLfybgU3OaUUPrQdBaVmP",
+     query: "<component name>",
+     includeComponents: true,
+     includeLibraryKeys: ["lk-5ca1dcd26f40f0d14e872ac95ebdb56292e1c16c64d9157f837dc2ae6441e3d4a025a1dbcaadcb677883d963c16f12bdaefe8caf762f8b9f9c10f6dbf68d2c8e"]
+   })
+   ```
+3. Update the relevant row in this file with the new key and commit.
+
+You can spot-check a row at any time with this script via `use_figma` against the LM Design System file:
+
+```js
+const c = await figma.importComponentSetByKeyAsync("KEY_TO_CHECK")
+  .catch(() => figma.importComponentByKeyAsync("KEY_TO_CHECK"));
+return c ? { name: c.name, key: c.key, type: c.type } : { missing: true };
+```
+
+For a full refresh, run the harvest script in the appendix at the bottom of this file.
+
+---
+
+## Components (LM Design System)
+
+All keys below resolve as either `ComponentSetNode` (most multi-variant components) or `ComponentNode` (single-variant components, including every `Icon /` glyph). Use `importComponentSetByKeyAsync` for the `set` rows and `importComponentByKeyAsync` for the `comp` rows.
+
+### Containers / surfaces
+
+| Name | Type | Key | Page |
+|---|---|---|---|
+| `Card` | set | `0f29334183eb5fffd7ce6beebb62d758327a5236` | Card |
+| `Hover Card` | comp | `f3964bccdd934e468248e7d866e720b319f92456` | Hover Card |
+| `Carousel` | set | `c1d5409491cba1627cc4d0918c93ba7a207918f7` | Carousel |
+| `Carousel with Image` | set | `967c8e34d448e42ff2a702bcafb5a8825219b83c` | Carousel |
+| `Callout` (banner-style inline notice — `Type=Info/Danger/Success/Warning`, `Position=Right/Left`) | set | `6509231a30cc8caa9b1040847f2bb30f270db52b` | Misc |
+| `Alert` (multi-variant alert / banner) | set | `38dc127d1f81583311d1e37a103223acf84ef0a5` | Alert |
+| `Empty state` | set | `d5fba3c0ddf2b9f347658e446504010747512764` | Empty |
+| `Status Circle` | set | `663ae7beaa9491fc91135051e48cb9ffb3c319c8` | Misc |
+| `Change Badge` | set | `31280f2292e8b43cdc4f637d55516b9ce75165c3` | Misc |
+| `Skeleton` | comp | `6b46011edd627f2485618e8e379b8aaa7167de22` | Skeleton |
+| `Spinner` | set | `c3898df54cec8c8c3692bf4d07517977a513698c` | Spinner |
+| `Scrollbar` | set | `b1d005e1e9fb2149d61f7088014e0af64be1c085` | Scroll Area |
+| `Resizable` | set | `7be5bebf7f512f3fd623d3047c34dc08e4b94c4c` | Resizable |
+| `Separator` | set | `6920afed7202c1e7244009c1213b71f4d584cb7b` | Separator |
+| `Progress` | set | `4005fbc918c35e9e41ae48438c772fe2c2e04d53` | Progress |
+
+### Modals / overlays / drawers
+
+| Name | Type | Key | Page |
+|---|---|---|---|
+| `Alert Dialog` (preferred for confirmation / destructive prompts) | set | `9b2fb3dcc9a991615d1119cb0638f5a01682700f` | Alert Dialog |
+| `Dialog` (content-rich modal — compose with `Dialog Header` + `Dialog Footer`) | set | `7355510e158a6763456b32c5343a21a027a8f6cc` | Dialog |
+| `Dialog Header` | set | `e3c57b705bf84a29859ea446edb757328c227885` | Dialog |
+| `Dialog Footer` | set | `56b420ff4f55552f3b6cfa17a6b90fdf4549d3d3` | Dialog |
+| `Sheet` (side-anchored panel — the design-system equivalent of a right-side drawer) | set | `95fd92d0079824fe9bfd6c9cd49822e4a35cf858` | Drawer |
+| `Drawer` (bottom-anchored panel for mobile / action sheets) | comp | `7d880c6632c54e5a8a8d4c7307c85ac2ff185635` | Action Sheet |
+| `Sonner` (toast container) | set | `e947ca4364abc409cc36cdc35c29703ebe47ba11` | Sonner |
+| `Sonner Content` (single toast row) | set | `38a3d2001929316b93c165073ccfb90b9e285ab8` | Sonner |
+| `Tooltip` | set | `b4fa55d58176d8fc5d6fd827249816903951be4b` | Tooltip |
+
+> **Right-side drawer convention:** for the Deliverables Send drawer / UC15 pattern, use `Sheet` (key above). The cache previously claimed Sheet didn't exist — that was wrong. Always import `Sheet` for side panels; only fall back to hand-built frames if Sheet's variant axes don't fit the spec.
+
+### Buttons / actions
+
+| Name | Type | Key | Notes |
+|---|---|---|---|
+| `Button` | set | `83ac5b19c84a63a4fb5888f1cf5de00d9f465abc` | Variant axes: `Roundness`, `Variant` (Primary/Secondary/Outline/Outline Inverse/Tertiary/Ghost/Ghost Muted/Destructive), `Size` (sm/md/lg), `State`. Conditional left/right icons gated by `Show left icon#…` / `Show right icon#…` booleans paired with `⮑ Left Content#…` / `⮑ Right Content#…` swaps. |
+| `Icon Button` (Primary-default) | set | `4275032237ea7d094b375f5334924fec5df83b84` | First of two distinct icon-button sets. Defaults to Primary fill. |
+| `Icon Button` (Outline / Ghost) | set | `6619ae7ba231cafb15cfb32a9d52d6f64fb58a09` | The Icon Button shipped on the **Icon Button** page. Use for tertiary / table-row / drawer-header icon buttons. The whole component is the icon — set `⮑ Left icon`. |
+| `Button Group` | set | `fbefd8f01379701a469aeaf8ee685210212c3872` | Segmented button row. |
+| `Button Group Icon Button` | set | `127b50c74c4d843b0a7b789a40149227bac27d27` | Segmented icon-only row. |
+| `Toggle Button` (text + state toggle) | set | `73bb2298383961cafc859ee3b949fd60171d8777` | Toggle & Toggle Group page. |
+| `Toggle Icon Button` (icon-only toggle) | set | `6f75dc4ecf14bc91ff6f8fd427585b09fbcaca03` | Toggle & Toggle Group page. |
+| `Anchor` (text-style link, aka "Link Button") | set | `bbf68c07ff7866fba0cac46dab317b2fc6212953` | Anchor page. Use this for inline links / `text-link` styled CTAs — do **not** approximate with `Button Variant=Ghost`. |
+| `Pagination Button` | set | `fc13a98aec84e7e20d741074649d853fec830391` | |
+| `Pagination` (full pagination row) | set | `a388a13d09a3f0741e26e80a98db08d4260f0e85` | |
+| `Pagination Ellipsis` | comp | `600eb5db1ec37869979cf853ee7fd481881f11ed` | |
+
+### Form controls
+
+| Name | Type | Key | Notes |
+|---|---|---|---|
+| `Vertical Field` | set | `ed788a01ea520f16c64f194b6b9fb12593804b02` | Default labeled control wrapper. Pick `Type` = `Text Value` / `Select` / `Radio` / `Textarea` / `Checkbox` / `Slider`. |
+| `Horizontal Field` | set | `912e0649909171875af3923fbed470ba1eff40aa` | Same as Vertical Field but settings-style (label on the side). |
+| `Label` | set | `a7a218d47139c95c64fdd277a40e2eb7cdca0ddc` | Standalone label used when a field's chrome isn't appropriate (e.g., inline with a Switch). |
+| `Input` | set | `347a94c8eade0109b1a1fcf0271f7c5cae110762` | Bare text input. Decorations gated by `Show decoration left` / `Show decoration right` boolean — the decoration content is a nested instance you reach via `instance.children`. |
+| `Input File` | set | `b4fe0d98fcfaca7ad3ac74dcad1d9ce22a0817df` | |
+| `Input OTP` | set | `67a64a2350ff055c376bfe8662576a7724dc31c7` | One-time-password input. |
+| `Textarea` | set | `45fd176668402614db675597438216697947eb0a` | Standalone multi-line input. |
+| `Date Picker Input` | set | `32bfe5930fdf247890ba8f699d3eea925e0de61b` | |
+| `Date Picker` (the calendar popover) | set | `d71e31e6a90dda96ce502b6a039f9ef5234e42c1` | |
+| `Select & Combobox` | set | `29a0349a94c98ae411d4e1eff889594519a637e4` | Variant axes: `Size`, `State`, `Lines`. |
+| `.Select Left Decoration` | set | `3996faef6f26d2378a2f5065dfb3a5727bcfd6d4` | Nested decoration component inside `Select & Combobox`. |
+| `.Select & Combobox Right Decoration` | set | `f22f3c322b1be72b242740ea7170df71350e4560` | Nested decoration component inside `Select & Combobox`. |
+| `Checkbox` | set | `831dd7f93a72d578b1c09e9deb567a76f05f3a6b` | Bare primitive. Use inside `Vertical Field` (`Type=Checkbox`) when a label is wanted. |
+| `Checkbox Group` | set | `9ec19c7328172e3f9f8a59c12cb4fea8d9bf4c42` | Group of labeled checkboxes. |
+| `Rich Checkbox Group` | set | `b1b98992bbebb2c02e65b349c1e5858c3b9ba2e7` | Card-styled checkbox group (description + icon per option). |
+| `Radio` | set | `47984dd2aeea00635d14f1827626efe05ec702a9` | Bare primitive. Use inside `Vertical Field` (`Type=Radio`) when a label is wanted. |
+| `Radio Group` | set | `d898dc14e851ca9f123dc40e636e9fda01e1cedd` | Group of labeled radios. |
+| `Rich Radio Group` | set | `9f834aefd37f4f186dd83bd59856fb9ead65893f` | Card-styled radio group. |
+| `Switch` | set | `467ceb6c29450fbeb8f26c66098e2588981d5404` | Bare primitive. |
+| `Switch Group` | set | `8e6ecde9df41a0113b5cfdfefb266eb33a8dc686` | Group of labeled switches. |
+| `Rich Switch Group` | set | `77c58246c3ba9fa81ea9aba6a731950d9019fe1c` | Card-styled switch group. |
+| `Slider Horizontal` | set | `ec5b4949881cf6a8bc7d117294a0e1fc0383b362` | Bare primitive. |
+| `Slider Vertical` | set | `f7416397e0c5e048d29bd5d838327cb1b1d936c3` | Bare primitive. |
+
+### Menus / context / command palette
+
+| Name | Type | Key |
+|---|---|---|
+| `Menu` | set | `061bf1cd01957609661f25892ade298af5ef3d79` |
+| `Menu Item` | set | `91f50c9daf4bd1ae1f3a862681cd31b6cad74bb6` |
+| `Select Menu Group Label` | set | `6b0fc1a26e517e7f7fbd9988483e6f3645ad7b1f` |
+| `Select Menu Overflow` | set | `d1f899145e8e2dc5051c709ee9a3b8376a1fa0b5` |
+| `Filter Menu` | comp | `367e276ec7a33a3ed4d496a29236533c0ebd6ea4` |
+| `Command` (Cmd-K palette container) | comp | `4f05ac1f176fbf2b9a7fc2b9d85eddec22e697e4` |
+| `Command Item` | set | `2ab32dd50d528376676c5bee5cbb67a4a3d0da4d` |
+
+### Tabs / navigation / sidebar
+
+| Name | Type | Key |
+|---|---|---|
+| `Tabs` (container) | set | `f06ad194542ddc5502822a71c0c1df40603657dd` |
+| `Tab` (single tab) | set | `d1fe192462c90aac4b17d9c0e5ad0e4178c0c359` |
+| `.Tabs Counter` | comp | `86f35577ae7a02351839c0680d3f78f3227e3dea` |
+| `Accordion Trigger` | set | `d7ad877fa8f7146a240935e32c58c4923d7f5a9f` |
+| `Accordion Content` | comp | `98a814093f0ae983c3490a1236edbe7d458bfb90` |
+| `Breadcrumb` | comp | `23246290df930b56c71f92d1fbf9634714ba5a21` |
+| `Navigation Menu` (top-bar pattern) | comp | `8f317d3955948412642f475292d5b2f93de3f4ec` |
+| `.Navigation Menu Content` | comp | `fa0c7bb1ea1ad04dbfc59425a14acfea1c74809d` |
+| `Sidebar Item / Collapsed` | set | `591ee5547d39353eeb0970ae2fb1dd96642c1243` |
+| `Sidebar Item / Expanded / 1st Level` | set | `0038e7436094f39eff00d1897336f69b1d608faf` |
+| `Sidebar Item / Expanded / 2nd Level` | set | `f686052899ef72071a9108bd26f350c0b833d08c` |
+| `Sidebar Group Label` | set | `3b14566bd1e5f3c3e7706d66ed27004c5c56465f` |
+| `Sidebar Badge` | comp | `adba54dbc4337f0754e59de3b34f1345a1cf559f` |
+| `.Sidebar Mini Button` | set | `802813ca59ca41c0c02bbdd7ba67d232856c9c96` |
+
+### Identity / status
+
+| Name | Type | Key |
+|---|---|---|
+| `Avatar` | set | `9ae2b0550502919c74a7571ded5239b407097a3e` |
+| `Avatar Stack` | set | `e9bb0ddfc269b71bc55b7df17a68a1f78d863699` |
+| `Badge` | set | `c128ae273e04b00c40c91dcf0cc9d3e95cf5f1bd` | Conditional left icon gated by `Show icon left` (note: word order differs from Button's `Show left icon`). |
+| `Tag` | set | `b51cb156d50181556e46dad90493991e060a6d80` |
+| `Kbd` (single key glyph) | comp | `4f9822d7743ad1a440b0d376ad016193cde37d0b` |
+| `Kbd combo` (multi-key combo) | comp | `c52af997727421497d0ced1828dd1fb800b45588` |
+
+### Tables / data display
+
+| Name | Type | Key |
+|---|---|---|
+| `Table Header` (Data Table) | set | `216e05c5dfadfcbf3d4da29844a841be9e30adad` |
+| `Table Cell` (Data Table) | set | `192fc1ae7eb123f42f33e29d655f35a01a48b895` |
+| `Basic Table Header` | set | `ad92cacb1db0538cc66609953f147a23bfbeac52` |
+| `Basic Table Cell` | set | `0486d228774b49327f86f0bcbb44de3ece13c7cc` |
+
+### Charts (single-variant, frequently overridden — treat as templates)
+
+| Name | Type | Key |
+|---|---|---|
+| `.Line Chart` | comp | `a49fd6cafff4ff8b89cc12e41908b5cb0df74724` |
+| `.Vertical Bar Chart` | comp | `7101d9e2f079d91fe41beb59ae000acef0185eac` |
+| `.Horizontal Bar Chart` | comp | `e8e82de897e7e1f01528963ec5a49e5347aed177` |
+| `.Pie Chart` | comp | `31cf3019048e3e5a7ed97698f49922eeb2b0ef09` |
+| `.Donut Chart` (A) | comp | `e8341848145fc5b1564458d29b2bd429a81be0bd` |
+| `.Donut Chart` (B) | comp | `34e8512068ae70f8a468227148e11f7d87613a28` |
+| `.Area Chart` | comp | `6f34337187dca54ca9ff19e11aed228a2637931b` |
+| `.Radar Chart` | comp | `1a41eba006232f8b8df9039cf5c9dd643790924c` |
+| `.Chart Tooltip 1` / `2` / `3` | comp | `dfa10c542950c6aa0b2cafbb2a8078a626a81914` / `19b4e5211f38f64a00f27608aa5b0b78a6f1c65c` / `2f082bd49a25fcea22afed8e64e0bbe48d5f4cbe` |
+
+### Icons (LM `Icon / *` lucide-aligned)
+
+The LM Design System publishes **1,604** `Icon / *` glyphs. Caching all of them is wasteful; instead, this table holds the **commonly-used + gating/feedback** subset. For any other lucide name, run `search_design_system` once and append a row.
+
+All icons are single `ComponentNode` instances (`type=comp`, no variants). Import with `figma.importComponentByKeyAsync(KEY)` and pass `.id` to `INSTANCE_SWAP` properties.
+
+| Name | Key |
+|---|---|
+| `Icon / app-window-mac` | `48dedfa87c3de6768f8ddd3d7ba94f48b80a0a6e` |
+| `Icon / arrow-down` | `83ba83ffd72acc11d8c5ec5d52e1a88f6d3035a0` |
+| `Icon / arrow-down-right` | `06852a75502835b10f80032f1e782e3113248ed1` |
+| `Icon / arrow-up` | `6062fe00e32815fc0695d36d6af037460af357e4` |
+| `Icon / arrow-up-right` | `9768b1c497c73d540946bd1ffe81e0cbc7ad6e7a` |
+| `Icon / badge` | `38f27e2c543a370dde289ebf1646de25952cedb9` |
+| `Icon / bell` | `15b50b504aab3e064a481483a7f4ae3ee6eb0a3a` |
+| `Icon / bell-off` | `7844466b29d39ce82e1f7527ffa86ce1bdf02d96` |
+| `Icon / bell-ring` | `ce47086993f12659826fd16267a93036e8934bdc` |
+| `Icon / book-lock` | `c2b9fa9ad869d181e45f3c5636fc995dc6ccbc83` |
+| `Icon / bookmark` | `0a00513d41d19220c3b3ab3a8b6ab5c256d60e3e` |
+| `Icon / building` | `487ad1d708e25b17bfd05e5305071446e79c1999` |
+| `Icon / calendar` | `71fc8fe0f69a691440ca9eacd699b441c5656bac` |
+| `Icon / calendar-check-2` | `725db216e3e98cf8d622337d9a95b926725a6b52` |
+| `Icon / calendar-clock` | `3f11f6cfa445e5cd69c804236ce9460c7d5e99a1` |
+| `Icon / check` (A) | `d14535899a911272aefb7325d17dc617817add2b` |
+| `Icon / check` (B) | `02ff711acb59e3e7a6857a7115e6acc0f95befbf` |
+| `Icon / chevron-down` (A) | `0c37c5f5e249a7590da0f2f8c5955289c11cabd9` |
+| `Icon / chevron-down` (B) | `ebceaa30e9feaa91bbd0fb4b91c86b18fd3b65e8` |
+| `Icon / chevron-first` | `18694f7f9972f91d6514c8def27b894299b0d248` |
+| `Icon / chevron-last` | `2c19853e3042c918ca637ac988ced1af6d935703` |
+| `Icon / chevron-left` | `72d936b121594f662e1b790b979c185f642f1038` |
+| `Icon / chevron-right` | `a700ede13635584fbece55818efedd593dfc187e` |
+| `Icon / chevrons-left-right` | `2d3541624e932cbb330d73dfd2c2e16de0630dff` |
+| `Icon / chevrons-right-left` | `209b74f891be90b3e988d47bcd0bc3af7802fe7a` |
+| `Icon / chevrons-up-down` | `c64fd83f6e1c12895d9721846a13028875d88dc3` |
+| `Icon / circle` | `3302ebb70de30d2f353322933c8b931ea8503fec` |
+| `Icon / circle-alert` | `dc7f84234c1e8a997e157079c5f3f61299a629f4` |
+| `Icon / circle-check` | `103c73dedfdf6908777893fca795241382a2b9be` |
+| `Icon / circle-check-big` | `3a81359a1248da153c0561882bf365f0d96d5fba` |
+| `Icon / circle-dashed` | `089c62947f51875986cfa71188585886df7a215b` |
+| `Icon / circle-dot` | `81bdf3fab326baa4c0f0f44b7154716f3c97c139` |
+| `Icon / circle-help` | `f61e0e5d2cae220b15f7c95f6fc5bfe834aa17d6` |
+| `Icon / circle-x` | `6537c90aa5f6b23d6a9a69f539029de04ea904c8` |
+| `Icon / clipboard` | `959ac0c4b467a169a0ee5e77caa8a8de15c7c8ac` |
+| `Icon / clipboard-check` | `f7ef86ae84bf62ceb859de3d3083fb479e6dd3f9` |
+| `Icon / clipboard-list` | `d3fcc890b823d55c7051303876de32efe9b362e4` |
+| `Icon / clock` | `ede22d08254ca531d91790fd40dd00d4dcfb389c` |
+| `Icon / clock-alert` | `58836c40ffd586684281cb28bd556b794799df04` |
+| `Icon / copy-plus` | `f3450dd631f85119a121e35a51c869095a477a33` |
+| `Icon / credit-card` | `9c8adbffe6cb5c21757650f6d3bbbc5f82e6f736` |
+| `Icon / dock` | `538cf8a87ae363b05ef0f7feaa0c1f3b8b98181f` |
+| `Icon / dollar-sign` | `87bcf884816f6ab87ec3050a13a6092ab6b5e709` |
+| `Icon / door-closed-locked` | `e7b3b57019250709d1d1c8918702a19c4fbbd262` |
+| `Icon / dot` | `d118c0b3c1aec6c496c0344689a3ee31d31dda0b` |
+| `Icon / earth` | `b642e6b4d52f660b1818009f82e469fd7affc634` |
+| `Icon / earth-lock` | `0085377d536a16038f05d43b292713ec1aaf8f94` |
+| `Icon / ellipsis` | `1901fb3e67d0e47f7afd9bb458633cc492f50e57` |
+| `Icon / ellipsis-vertical` | `2af23624d40e3d99f876c71ad2ad596c3ec25b7e` |
+| `Icon / external-link` (A) | `751466611bd2e46b25ca8059e609b8ddbe8791c8` |
+| `Icon / external-link` (B) | `15119b55ba55d68a2ba0e58dfdf9fe36223a26b7` |
+| `Icon / eye` | `92d2f21ce8e1661e712822684dc98f5d8ebd0d91` |
+| `Icon / eye-closed` | `d6e0909b7732e3b250816c6378d83f18657c5b01` |
+| `Icon / eye-off` | `5ffbaeb0692a86fcf71f86ffcf850538aa58d5e3` |
+| `Icon / file` | `10088869da1c12d6dfbbafaa29070dab3c84a0b4` |
+| `Icon / file-image` | `457c6e4349714854cb3b30f596d1eb7b57bef93d` |
+| `Icon / file-lock` | `d86ad2f193c480dda24f2355361dabd1856deb8a` |
+| `Icon / file-lock-2` | `df9d91325e557ab198e41413954801e001809a8a` |
+| `Icon / file-plus` | `edc17f223c0196f7514370e37977567119b48cdf` |
+| `Icon / file-text` | `b3f90098bf666854ea023f54c941d1296a9dad95` |
+| `Icon / file-x` | `90b1ca3b377871ff32aa5b33c01812033504913c` |
+| `Icon / files` | `cb4a44cc8f3cbfc229205e8cdaf899bc10e1623d` |
+| `Icon / folder-lock` | `50be7d96ea44f883fd5123b4fddb22a920eef1ac` |
+| `Icon / funnel` | `7e15d5497d041b94886e2c9f92a86eff5acc7d6a` |
+| `Icon / funnel-plus` | `959a0e5bc35d44e849781b8c5aad448da88f18e9` |
+| `Icon / funnel-x` | `9f3c14692d09bbe7f67a4d51ff75cf1f5a493512` |
+| `Icon / globe-lock` | `b5baa7556c8c507d1d02a8b4df295d281b5eee7a` |
+| `Icon / graduation-cap` | `3112a81dd7558dcf071c3998f86a6bd8173142ef` |
+| `Icon / grip-horizontal` | `54c9b86f377cb73ddea5d317d3ecd56cd9bc09f8` |
+| `Icon / hard-drive` | `fbab451abbd7306e5d941044773d79b8e6a85d5e` |
+| `Icon / heading-1` | `b0f548c52d6490ea8b8d8a13ddefd778dbc7f38d` |
+| `Icon / heading-2` | `0698a68f015046045343e5892c539a2b2df29892` |
+| `Icon / heading-3` | `c8f0559baae0f88a34cf8995b08d44aa6bd06941` |
+| `Icon / heading-4` | `b8f080650cf3df4d44530ba0c15ce83d4921975d` |
+| `Icon / heading-5` | `c03624d07f62170a8dd6d1870fd0730f3ccae406` |
+| `Icon / heading-6` | `bd2ebfed8fc61e21d54788a10777681ae51ec070` |
+| `Icon / house` | `e4a907b8d78448aa8611c9b10995c99917651d72` |
+| `Icon / id-card` | `08dfe1ffe95432a42f9e727745db4c6ff66da5b0` |
+| `Icon / id-card-lanyard` | `16c9c27778a657bfdbe22322ce527d979e40e6d4` |
+| `Icon / inbox` | `c42a04fe530257c9bddaf89f40b8173e792540d0` |
+| `Icon / info` (A) | `9bb8dbbd966ce700dc5cf69fa91c00f656f63ccd` |
+| `Icon / info` (B) | `9f692ed1274c27c31d75c5fac824e74a1809b0e7` |
+| `Icon / layout-panel-top` | `8d857750df85086bfe65957c1eb250956b345161` |
+| `Icon / library` | `82aca630108847760416ef37e8358984dd8c0640` |
+| `Icon / library-big` | `cd335ffbb0c88063c0d9e42f928431f3605d4ece` |
+| `Icon / link` | `e65f72553d5cf13707d982169f8722123aa59435` |
+| `Icon / link-2` | `accfc57c25cc455be0d9f7b5204f1e3f87a3f82d` |
+| `Icon / list-check` | `a7990549bd1dbe2f835819f515ca72288d594eb5` |
+| `Icon / list-checks` | `affdce0eaebca5be28e734b6e993439343c15f6c` |
+| `Icon / loader` | `76c0e27ca41803353547e743fa8aa5c20013c2af` |
+| `Icon / loader-circle` | `96c71c4ce33c33e29f3bd5c84912fdd5e8e2b337` |
+| `Icon / lock` (A) | `cd04904d18b1fb789dc07cb09713dfb1313f8d94` |
+| `Icon / lock` (B) | `173fee46cb57e14f03c5da346ca7388153413ba4` |
+| `Icon / lock-keyhole` | `dda555d2e45a5c3750b6ef38deb8795c128084f9` |
+| `Icon / lock-keyhole-open` | `aaf99b7a16b2711af996f67edf7b07799ef323fd` |
+| `Icon / lock-open` | `ac2ec9cc0c07ebbe2c90948d00a519ef33254d9a` |
+| `Icon / mail` | `767170a5b43b0821f8accbfe46152cb6dc2dc5a8` |
+| `Icon / mail-open` | `1c439cacf43a81a89bd7d55623d85cc4e99d9662` |
+| `Icon / megaphone` | `aef7b9166671db4b8fb2c9a50752f8fe98d1c7c4` |
+| `Icon / megaphone-off` | `92c398dce26b492444be0f564017e3232263e845` |
+| `Icon / menu` | `66d85f73f04f3be4afd898307dff3fd41dd20309` |
+| `Icon / message-circle` | `44cba4df514935f533826694738206e109c71043` |
+| `Icon / message-circle-warning` | `8c1aaaa040b4e4b9fbb968e08816fadaa746e6c2` |
+| `Icon / message-circle-x` | `1e46cdfc80ca7a54b0ac9419597746060a34bb44` |
+| `Icon / message-square` | `14096253afb98635cc5634ff1a0dadb4a20ec49a` |
+| `Icon / message-square-warning` | `07b458d52f3a49d774da321f07c443769df35460` |
+| `Icon / message-square-x` | `7624cc8a1b3a05716d2c4e7df3867441a8272bc8` |
+| `Icon / panel-right-open` | `521cf04f52693d89ba12c447310a9d74bbd6c979` |
+| `Icon / pause` | `8c4ca9af197576e50bdc9e881a2613404f4d0f00` |
+| `Icon / pencil` | `7cb87449cf95a1b4ce0fdbbc18143345482bb746` |
+| `Icon / pencil-line` | `f10983d5e1f426ccfcbed00db38768fc5340fcd9` |
+| `Icon / pencil-off` | `a7b6c6c2b90c062fd30298a986edbb18802f8ace` |
+| `Icon / play` | `6627b7774fbbcc9db8182e97d9a0919a8d6ebf6f` |
+| `Icon / plus` | `3e7fb085172dec0df62b8c77fc697e7fbd17ca1c` |
+| `Icon / presentation` | `c982e74277f64f9799015d5c1d4d5f08ac5b923a` |
+| `Icon / redo` | `d6be5e089a18f68f9939dd68fd647f148e5a846d` |
+| `Icon / redo-2` | `178f78596fea2e79d4373e7ddbcb6c7be31d94ad` |
+| `Icon / refresh-ccw` | `1ebf7f006909fc27a9c22862872be3c4f15f6ef7` |
+| `Icon / refresh-cw` | `caee60932b9fe4523df5e27d2929e73983928218` |
+| `Icon / rocket` | `0408c2f42ab180536f84e496bf217d03cac43e84` |
+| `Icon / rotate-ccw` | `a845dfb108216270c0d5072d1a4237b881c7fa2f` |
+| `Icon / rotate-cw` | `0d3c3104338d529e1387dcc16d929419f341a281` |
+| `Icon / save` | `d2bf6f3da29449d87b334e91e6645de38c88cfe2` |
+| `Icon / search` (A) | `7d1f43bf13a668ce07ddd137a606d467b78bc477` |
+| `Icon / search` (B) | `3e4880f47595080124c42e4c6285cdb2db8e6122` |
+| `Icon / send` | `0bfde168b58608619de5251621ad815cb99ee705` |
+| `Icon / send-horizontal` | `b7c7fd708766e11987f937896d1e60c6ee2afb86` |
+| `Icon / settings` | `40edd1462c34db3b77822952aa2c08aa3cf880ab` |
+| `Icon / settings-2` | `ea728650f9a252fbc561cdc0d7fd5104f221c67f` |
+| `Icon / share` | `b286bbfb91ceda5c3436c502ab9498dd54559947` |
+| `Icon / share-2` | `9a03ca2aea3f85af208ea7295644769baeea7095` |
+| `Icon / shield` | `1f733768457804ce6830e145dab4fe638eccd8fd` |
+| `Icon / shield-alert` | `10507d1aebae6daf72c45f7216fdac99ce7d4f27` |
+| `Icon / shield-ban` | `8befa856dc0c7f7778569725c976c2a6e478d33a` |
+| `Icon / shield-check` | `eb83680be39826d1141f2ee939926bb0f37933dc` |
+| `Icon / shield-off` | `bd3075e2b948d90b2bef4628ad2f699e59016b63` |
+| `Icon / shield-x` | `5e50b59391f3201db81f61e5d53fd3d818857201` |
+| `Icon / sliders-horizontal` | `922d35ecc5e53f16a09f9f10123cc89347189340` |
+| `Icon / sliders-vertical` | `23861423e6a9b5ac7d340a92d5e736a97bae72d5` |
+| `Icon / sparkles` (A) | `8e0f51866455fcbdbadb4de2d96834fe616c73db` |
+| `Icon / sparkles` (B) | `8d3d1af2b52b08bee1c6a2af44bc2b90fa4914dc` |
+| `Icon / square-chart-gantt` | `6d6bb52ce7079c5f4ef9b3d7398fbfdb7dc7b738` |
+| `Icon / square-check-big` | `384262e5e0a21a7b634750af3fe277b669f259ff` |
+| `Icon / square-dashed` | `83c199f78ce1b4e960d90b378c65fa3f73125638` |
+| `Icon / square-pen` | `5a54027746c3b92fc045090d68bc2c62f8ff0cbc` |
+| `Icon / square-plus` | `e32bb03c2797695b43175aef1009d2b551b32962` |
+| `Icon / target` | `14d8efcd5209591502b3570ec6aabe6e41c13930` |
+| `Icon / terminal` | `638d5f1213e80d818e026eaaf65b566b89892e28` |
+| `Icon / trash` | `41d3a43afd232f7fac18ba8360b80352c11130e5` |
+| `Icon / trash-2` | `43fa792c0b099e7d1a767989940f21e23447ae76` |
+| `Icon / triangle-alert` | `e895cca7d73e78b424b63d2c017447344aba0486` |
+| `Icon / undo` | `c9031fcd6b9a2446c258ca9e3720df46cdaf656e` |
+| `Icon / undo-2` | `2d0031d3d3f14e12487b93a521e284ffc2bed565` |
+| `Icon / unlink-2` | `7b9c77a191da3f3fe1c6cb50f928d5b001719ff5` |
+| `Icon / user-check` | `e31c5f779c823b1f306d2fcc0cd1b9975818a6cd` |
+| `Icon / user-plus` | `52b3d2eb884e5b16be0ca029ce2c7aa135cbf5e5` |
+| `Icon / user-round` | `b27a2f7a75732f79ac0e4ab5bd6f42d148f7500c` |
+| `Icon / users` | `9321d887ad9936cdfba0152ba617e2862c7dcc66` |
+| `Icon / users-round` | `57990d1628d2480213c592c7d4003056805061a9` |
+| `Icon / wallet-cards` | `c0d1c8fe1a01e6c77cb00a9921d206bde1ce9ce7` |
+| `Icon / wand-sparkles` | `2afc3e3f8b3a523e2e2495f61e178a384bcb587b` |
+| `Icon / x` | `b550df349a72e0591f5e8684ced1ad6a31193bfb` |
+
+**About duplicate icon keys (rows marked A / B above):** the LM Design System exports the same lucide glyph under two different componentKey values (likely because the library was rebuilt at some point and old + new components both ship). Both resolve, both render identically. Use whichever you see first in the file you're editing — *don't switch keys mid-mockup* (different keys mean different "instances of the same icon" in the file's history, which complicates diffs).
+
+**Missing icon?** The rule (`figma-design-system.mdc` §9) says: *if the icon doesn't exist in `Icon / *`, STOP and ask before creating a new vector.* Don't fall back to inline Lucide SVG. The full library has ~1,600 glyphs — almost any lucide name is there.
+
+---
+
+## Variables (LM Design System)
+
+All variables below are published by `LM Design System` (`fileKey VCLfybgU3OaUUPrQdBaVmP`). Use `figma.variables.importVariableByKeyAsync(KEY)`, then bind via `setBoundVariable(prop, v)` for spacing / radius / opacity or `figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: { r:0, g:0, b:0 } }, 'color', v)` for fills.
+
+The canonical mockup-facing variables live in the **`Tokens`** collection (modes: `Light`, `Dark`). The `Primitives`, `spacing`, `border radii`, `typography`, `shadows` collections are *primitives* that `Tokens` aliases to — bind tokens, not primitives, unless you're matching an existing instance.
+
+### Tokens — Spacing (collection `Tokens`, scope `GAP` / padding)
+
+| Name | Key |
+|---|---|
+| `Spacing/spacing-none` | `06387b4e45be87744542da700640d6bcebc78a8a` |
+| `Spacing/spacing-xxs` | `4992c269f103f898da9fc26eb5710d57bfd3f5b8` |
+| `Spacing/spacing-xs` | `8a89a1dec7d3697d4ff8d7e4333b6fcd8680cd31` |
+| `Spacing/spacing-sm` | `cbd5c8cefd173b4b9f2967d01a1bfa099eaa6c25` |
+| `Spacing/spacing-md` | `b277a46267e286cb020830f7552df5b93ab9f71e` |
+| `Spacing/spacing-lg` | `9ba99264d46ba18949ba045af27cfb56f30b99ab` |
+| `Spacing/spacing-xl` | `ae49029d2d4ee74048322b8c7ed1c1bb647716a9` |
+| `Spacing/spacing-xxl` | `fdc1a74f0585a84e55aa9321283bbf4f59aa504e` |
+
+### Tokens — Padding (collection `Tokens`, scope `PADDING`)
+
+| Name | Key |
+|---|---|
+| `Padding/padding-3xs` | `c8f061cf7b2ac5076c270c53f3ac8a876d0452c3` |
+| `Padding/padding-xxs` | `c51abb895af33fa54406b4c81787c24ae9202245` |
+| `Padding/padding-xs` | `4b6fc53af01e5919e0d7fa0d7973dd48bdce2136` |
+| `Padding/padding-sm` | `8b8c6c7435a0ec9275ab70417b70af81ce45c9fb` |
+| `Padding/padding-md` | `7ef2d2e5dd3c9b5d3fbe67e58f1c7c77b7281b38` |
+| `Padding/padding-lg` | `8baacc2b469bbcb7ea23a7eb8070c595aa00241f` |
+| `Padding/padding-xl` | `19033825f3ced422aa1c8968865088305d0aebdf` |
+
+### Tokens — Radius (collection `Tokens`, scope `CORNER_RADIUS`)
+
+| Name | Key |
+|---|---|
+| `Radius/radius-none` | `b2bda96d4b43b0b5bfd10acda71d15849021d750` |
+| `Radius/radius-xs` | `391dc99f0bc288b9a82f6428c6aa78024292e083` |
+| `Radius/radius-sm` | `395f6a7f2fb06d86bcc5a76ff0ed6ba562998557` |
+| `Radius/radius-md` | `6b97571775223cdd100b0dc73e189bfb061749fb` |
+| `Radius/radius-lg` | `36f686ed1d63670870a7f2856bedd1647ab2c88a` |
+| `Radius/radius-xl` | `baec715ce5231b5123fad63e27d48e399dd4d52b` |
+| `Radius/radius-xxl` | `5bbe218d7f9ae3cf62ac623d180b6ac8a8c66102` |
+
+### Tokens — Background colors (scopes `FRAME_FILL`, `SHAPE_FILL`)
+
+| Name | Key | Use |
+|---|---|---|
+| `Background/body` | `52513bc11e5c0580abd3cd0a03d360de12cd8a7a` | Page background |
+| `Background/default` | `10dec4782710dc311907727685079bff06b7613d` | Card / sheet / modal background |
+| `Background/default-hover` | `09b1a99abdd6f4bac8a2751654b28948077092dc` | Hover state of the default card / row surface |
+| `Background/input` | `bd7267990f0010a4efecad15fe793484da314e99` | Input field background |
+| `Background/transparent` (A) | `e0dcf0d6c855782adc2f0f56c874de2ec084a406` | Transparent surface |
+| `Background/transparent` (B) | `608d056f8e39041f1d2e8cb9e8045d45653fecc9` | Transparent surface (alt — both resolve) |
+| `Background/backdrop` | `4710c68999c063787fb17de262b7655378320ab3` | Modal / dialog backdrop |
+| `Background/Disabled/default` | `f20528c3a6b546bc2ef96b9a496da5b8e2e5cd1f` | Disabled control surface |
+| `Background/Primary/filled` | `e65fd87ad03448f2dbbb64c4f6036e7e8164cb43` | Primary CTA fill |
+| `Background/Primary/filled-hover` | `1685ebd80ae53261c714b678731899d5ba028190` | Primary CTA hover |
+| `Background/Primary/light` | `00a464c6d3ce2322e6e10b70e55d6c9715e46a58` | Soft brand surface (selected pill, info card) |
+| `Background/Primary/light-hover` | `a4e387c0edfb905522c09505e5602d7315014a18` | Hover state of the soft brand surface |
+| `Background/Inverse/filled` | `9093377117d56ba81616f32813c98c13e6a2902c` | Dark / inverse filled (tooltip body) |
+| `Background/Inverse/filled-hover` | `414b4fd9fb1febe40b9dafdb906699bb671afa60` | Inverse filled hover |
+| `Background/Subdued/light` | `5d739dea0ccc4129709e6b8296381d6f06caf6fa` | Subtle stripe / subdued chip |
+| `Background/Subdued/light-hover` | `ff6cde23bcb84501a3741fb46a3d38aea8de5e93` | Hover state of subdued/light |
+| `Background/Subdued/ultra-light` | `9d79dbbe5d7b938263c690c18faa7ba0b3a3156a` | Even lighter than `light` (use sparingly) |
+| `Background/Subdued/filled` | `56ab97d799aa890f0f2dd248f47f0d4531a69250` | Filled neutral chip |
+| `Background/Subdued/filled-hover` | `baa93962a667fd24f4a4fd8f99793afb2db43542` | Hover state of filled neutral chip |
+| `Background/Success/filled` | `aacbc9b0b9e77cc760b23bb1d272de668feac2ae` | Filled success badge/pill |
+| `Background/Success/filled-hover` | `caa2ec7744e6a79959a7f17664505b1bdf5e5aaf` | Success filled hover |
+| `Background/Success/light` | `2347c1d6a29b324835c30343e2fadb1ab0f1ce12` | Soft success surface |
+| `Background/Success/light-hover` | `93c28999cd0a59db846ddf4f2fb85e5056422130` | Soft success hover |
+| `Background/Warning/filled` | `6734feb384b290204172575f24df75f84b79fe80` | Filled warning badge/pill |
+| `Background/Warning/filled-hover` | `c9c5cf833dfa19bb66f392baab65d3dde9c1cc70` | Warning filled hover |
+| `Background/Warning/light` | `609abf91cba99e5bc3c274e6a5855efd96dae72c` | Soft warning surface (banner) |
+| `Background/Warning/light-hover` | `f7a99c0406ed5298ebe22c990c764a3198b6ae35` | Soft warning hover |
+| `Background/Danger/filled` | `e9be878bae050092551b66ca9573105c098b24fc` | Filled danger badge/pill |
+| `Background/Danger/filled-hover` | `23721533010ba96033b803378d39747f43ebd24a` | Danger filled hover |
+| `Background/Danger/light` | `694048683bf1f76ccdfa3915e36269ef4e57bae8` | Soft danger surface |
+| `Background/Danger/light-hover` | `54f47afcfd11736827a40393d1664ac7e6b7f09c` | Soft danger hover |
+| `Background/Information/filled` | `7b6b7d14c196c332b55f4e95cec18f369dc627f2` | Filled info badge/pill |
+| `Background/Information/filled-hover` | `296e88549f1adf7130c4f5bbe5ba5bb4dccc8f85` | Info filled hover |
+| `Background/Information/light` | `b7eced23850a9a9209487c9096bd34eb5019627d` | Soft information surface |
+| `Background/Information/light-hover` | `b78b70167a4d6cae7610a231cad8974476ab76ce` | Soft information hover |
+
+### Tokens — Text colors (scope `TEXT_FILL`)
+
+| Name | Key | Use |
+|---|---|---|
+| `Text/default` | `bc94937d215bc657bb26cde7288359cd5dd65985` | Default body copy |
+| `Text/title` | `012ef79215c139cfe600fa7221aad0a2646ff5ed` | Title / heading text |
+| `Text/inverse` | `416f0e24026eb7dcfb72982f87f73b678f88af9f` | Text on filled-primary buttons / dark surfaces |
+| `Text/link` | `d92682fbcfc18fb71b2be9adbe00fee556679b88` | Anchor / link text |
+| `Text/Disabled/default` | `b3e9a269e1323f7d65995bc936472d21deeb7227` | Disabled text |
+| `Text/Subdued/light` | `6e815520975899b2e26aa7f19fcf9d1bae46fecb` | Lightest helper / placeholder |
+| `Text/Subdued/default` | `d65d1cae407989945e710ad12516e1c36cea48cf` | Slightly less prominent subdued |
+| `Text/Subdued/strong` | `60a95e30b46826a011018b5a183c5f3326e74838` | Subdued body copy / helper text (default subdued) |
+| `Text/Primary/default` | `fef372abe964123d2966485aee970066a814e00b` | Brand-tinted text on soft surface |
+| `Text/Primary/light` | `a17344c4b8279d1d3648ccec7a895403b89c373d` | Lighter brand text |
+| `Text/Danger/default` | `317fdbd8aad7710b34f0990cd409ecf8718ca942` | Danger label (default) |
+| `Text/Danger/strong` | `28809203dc49db510dbbe8e6d77a286f5adc3140` | Danger label (strong emphasis) |
+| `Text/Danger/disabled` | `75f8c3facd3aa67f9aba6d40348bb5403b681262` | Disabled-state danger text |
+| `Text/Warning/default` | `77a9549ffb50845bced5e0eaaf4211f1091f0091` | Warning label (default) |
+| `Text/Warning/strong` | `1e37a593af7adea77c69dde1132bd61fd89415c8` | Warning label (strong emphasis) |
+| `Text/Success/default` | `44319f8e722bf528c4d3d64e85803e5909a1ed24` | Success label (default) |
+| `Text/Success/strong` | `b67b9bfad949ab233528946c188db62c94704d5b` | Success label (strong emphasis) |
+| `Text/Information/default` | `f39715f7718f13abb37ffe01f6422c6919e97664` | Information label (default) |
+| `Text/Information/strong` | `65082668d80e212e83cbc0d900ef75a93820c1b6` | Information label (strong emphasis) |
+
+### Tokens — Stroke colors (borders / dividers)
+
+| Name | Key | Use |
+|---|---|---|
+| `Stroke/default` (A) | `307a6b41b64b70e2b6eff918aa7507df5a3264a7` | Default border (canonical) |
+| `Stroke/default` (B) | `d617fd8d4cf71f07592dd057ef20ae1d3278e0f6` | Default border (alt — both resolve) |
+| `Stroke/light` | `bffb5c87c0ecd0c5e75e01bc293fe599feb70f3b` | Even softer than Subdued/default |
+| `Stroke/strong` | `2f89c5517c5f216761f4580b07fb34c3bf48313e` | Stronger border |
+| `Stroke/icon` | `05800ba55fc6ac06077cd02511a4ff8efe4af23e` | Inside icon component strokes |
+| `Stroke/inverse` | `e650900a58ee6989ebdc643a15ac9730c000386d` | Border on dark surfaces |
+| `Stroke/Subdued/default` | `c0014bd70506929db79e1e128343ac06073f4cb2` | Hairline border |
+| `Stroke/Subdued/strong` (A) | `4a8c88824c55626f4fcfa95d5d27d0a5fb14e840` | Strong hairline (canonical) |
+| `Stroke/Subdued/strong` (B) | `6c770ed214889c4112781b497f9aa8d5959267a8` | Strong hairline (alt — both resolve) |
+| `Stroke/Primary/default` | `04a5170d1fc1b8e34555b94da8f2200642f20e52` | Brand border (focus accents) |
+| `Stroke/Focus/default` | `3f1502930609b4d357b86537a22c6b6c6ae676d8` | Focus ring outline |
+| `Stroke/Focus/strong` | `13cb74b2d9d1be284405402d25240a1b373bd0e6` | Stronger focus ring |
+| `Stroke/Success/default` | `7a3157e3a3f4348b87eb86a2f03cf80a7adfcaf8` | Success border |
+| `Stroke/Danger/default` | `2e691fe4b862d281235dd45530c6cdb008f0fa49` | Danger border |
+| `Stroke/Warning/default` | `68a7727b7c058695724b98ac2138c73d49bd7aaf` | Warning border |
+| `Stroke/Information/default` | `df5a5e0174fdc916be6bd0b3559a91c189bd97c4` | Information border |
+
+### Tokens — Icon colors
+
+| Name | Key | Use |
+|---|---|---|
+| `Icon/light` | `d3597696b4d4397bfe00526f26980503d2acdf36` | Lightest icon fill |
+| `Icon/medium` | `12919a5fcfc769f033afa52092f44d8f1463497a` | Mid-weight icon fill |
+| `Icon/default` (A) | `730d09a845693bf9055d123ab2a34ca5420c97eb` | Default icon fill (canonical) |
+| `Icon/default` (B) | `7380baab8c502f2723f47bc9306f3c0c56a1d7da` | Default icon fill (alt — both resolve) |
+| `Icon/inverse` (A) | `480cbba5254ab4fbd364a09fde471a05f2968eeb` | Icon on dark surfaces (canonical) |
+| `Icon/inverse` (B) | `bd103aefdd0d048e2b9dd5c41ea40d5caee21558` | Icon on dark surfaces (alt — both resolve) |
+| `Icon/Primary/default` | `0fbff50fe16394f1221b4faa9d7c29249f299fec` | Brand icon fill on soft surfaces |
+| `Icon/Primary/strong` | `0a09d5cb80dcffe3022fb96d9c88bc716009d321` | Brand icon (stronger emphasis) |
+| `Icon/Danger/default` | `00e809157fabb2437c6d9b0e675c812221dafd44` | Danger-colored icon |
+| `Icon/Danger/strong` | `54d54302f7147e363520e774a5066ae551893a6d` | Danger icon (strong) |
+| `Icon/Danger/disabled` | `5411f78f51b3c0515317297d5a86e499206690f3` | Disabled danger icon |
+| `Icon/Warning/default` | `481e8de9fd902ebe7bb5e9a2e8c727dfdccda1c9` | Warning-colored icon |
+| `Icon/Warning/strong` | `1ada6a2845ab70e0e3c00fef4dc29bf174667a84` | Warning icon (strong) |
+| `Icon/Success/default` | `cdad1c2a11cc9046c83a7e3153e33291a43766e8` | Success-colored icon |
+| `Icon/Success/strong` | `bffd0c9a20ed277844840a209e7b6deea0ee6778` | Success icon (strong) |
+| `Icon/Information/default` | `7b26b788f0bcd40ff429aab8a69788840c139175` | Information-colored icon |
+| `Icon/Information/strong` | `6f94921017a8dec3193615a9e3b9dac24f686df6` | Information icon (strong) |
+
+### Primitives — DO NOT bind directly in new mockups
+
+The `Primitives`, `spacing`, `border radii`, `typography`, `shadows` collections (~325 variables total) feed into the `Tokens` collection via aliasing. **Never bind primitives directly in new work** — always pick the semantic `Tokens` entry above. Listed only as historic reference; the harvest script in the appendix can dump them on demand.
+
+---
+
+## Text Styles (LM Design System)
+
+Apply via `node.textStyleId = (await figma.importStyleByKeyAsync(KEY)).id`. Do not set `fontSize` / `fontName` / `lineHeight` / `letterSpacing` directly when a style exists.
+
+| Style name | Key | Use |
+|---|---|---|
+| `heading 1` | `320e1fc9c6b2b0811c8d7ca29d14951f3d6f5107` | Page title (rare — marketing / empty states), 48 / Inter Bold |
+| `heading 2` | `a46340ac0d32457b9ba2315ab3265a9224d33e4c` | Major section title, 28 / Inter Bold |
+| `heading 3` | `0f23e20b331940e4ec67efeadbf405c1aaff7bc8` | Card title, drawer title, 24 / Inter Bold |
+| `heading 4` | `3df703bd6aed5db248837666080bf27e3df419c2` | Subsection title, 20 / Inter Bold |
+| `heading 5` | `2fd31f8aab4a94d2923c1a82cb1a6dd96d53524f` | Inline group title, 18 / Inter Bold |
+| `Body/Body 1` | `4935c3fe1dee3b636babfc29a23f4b1d367be1b7` | Body copy (default, 14 / Inter Regular) |
+| `Body/Body 1 Strong` | `090cc58fa693c88242496d1dbc1ce36c931c09ac` | Body copy with medium 500 emphasis (14 / Inter Medium) |
+| `Body/Body 1 Stronger` | `5c2852798b45b4739de8726e1acd41aca06bbcf0` | Body copy with semibold 600 emphasis (14 / Inter Semi Bold) |
+| `Caption 1/Caption 1` | `da18e6b7867950b09192f851ef777192357c4074` | Caption (default, 13 / Inter Regular) |
+| `Caption 1/Caption 1 Strong` | `acbe1fc78493bb664c8c8d8f6600682ccb78b1a5` | Caption (medium, 13 / Inter Medium) |
+| `Caption 1/Caption 1 Stronger` | `bf47c4f814e5a6697fa469a2759056f98dd73c33` | Caption (semibold, 13 / Inter Semi Bold) |
+| `Caption 2/Caption 2` | `7ef3860935ba2fd6662d56df175cdc4c432ff5b8` | Small caption (12 / Inter Regular) |
+| `Caption 2/Caption 2 Strong` | `5b07351948994efd612d8f03f2471e43c2afed89` | Small caption (medium, 12 / Inter Medium) |
+| `Caption 2/Caption 2 Stronger` | `6059aceac5f1a045664856a62abc76c840c1cec7` | Small caption (semibold, 12 / Inter Semi Bold) |
+| `Caption 3/Caption 3` | `5253102bdf07e1d097d0256eebd0accb8ac4f8c4` | Smallest caption (11 / Inter Regular) |
+| `Caption 3/Caption 3 Strong` | `78ed1d8198293c4d5e3f68f90f46f57a8fd60e66` | Smallest caption (medium, 11 / Inter Medium) |
+| `Caption 3/Caption 3 Stronger` | `38ebe9788e5a6884296a6910044d5191dd766f59` | Smallest caption (semibold, 11 / Inter Semi Bold) |
+| `Small Caps` | `b2e75efed92eae8ef2290b0357e94cebd7e30f8e` | All-caps section label (12 / Inter Semi Bold) |
+| `monospaced` | `f2da26c94c428a2d113df9d5e05eee666b4b9a5e` | Code / kbd (16 / Menlo Regular) |
+
+> Total: 19 published text styles in the LM Design System (all listed above). No others exist.
+
+---
+
+## Effect Styles (LM Design System)
+
+Apply via `node.effectStyleId = (await figma.importStyleByKeyAsync(KEY)).id`. Never construct a manual `DROP_SHADOW` effect when one of these covers the role.
+
+| Style name | Key | Use |
+|---|---|---|
+| `shadow-2xs` | `caae14087a765e2f30174f2d516f4141c45465c3` | Hairline shadow under chips |
+| `shadow-xs` | `5754b14fde60b47aab8314daa3266b9e2f947884` | Subtle separator |
+| `shadow-sm` (A) | `9f174f17971aea71cb22829b293d116618594c23` | Inline cards, popover tip (canonical) |
+| `shadow-sm` (B) | `2a7ce2770d882ee56d652d3610e6c081541f2880` | Inline cards (alt — both resolve) |
+| `shadow-md` | `4d3453fef1076b543c1a4f49417487c8bb34006d` | Default elevated card |
+| `shadow-lg` | `77dfe131d8eb7f2152ed31f6e5126927d1e2d52c` | Drawer, popover floating layer |
+| `shadow-xl` | `10587aea6203933ca62e0719808cc4082f1b881f` | High elevation (modal halo) |
+| `shadow-2xl` | `560ff64c1104f519e88384f88f1b225f350cce7e` | Highest elevation |
+| `focus ring` | `1f1a63f2f9c07491b75572225dfeac434549cdeb` | Default focus outline (use for keyboard-focus states) |
+| `focus ring sidebar` | `26cf504a8a9a25de554e8e3e16a12a3c21f3e8d3` | Focus outline tuned for sidebar items |
+| `focus ring error` | `cb571d4c0cd0ad5703ff10720e8872eebf047f82` | Focus outline for danger / invalid states |
+
+> Total: 10 published effect styles in the LM Design System. No others exist.
+
+---
+
+## Confirmed absent from LM Design System
+
+Components that the library does **not** publish under their shadcn-canonical names (verified on the harvest date):
+
+| Wanted | Substitute |
+|---|---|
+| `Popover` | Use `Hover Card` (hover-trigger) or `Dialog` / `Sheet` (click-trigger). No standalone `Popover` set ships. |
+| `Banner` (named that) | Use `Alert` or `Callout` — both are banner-style inline notices. |
+| `Toast` (named that) | Use `Sonner` / `Sonner Content` — same role, different name. |
+
+(If you find one of these later published under its canonical name, add a row to the relevant table above and remove it here.)
+
+---
+
+## Reference Mockup Anchors (LM Vision file `AE4ZLZoEgdJList3S4eJ7q`)
+
+Use these as visual / structural references when starting new mockups. They are *built correctly* per the rules in `figma-design-system.mdc`.
+
+| Purpose | Node ID | Notes |
+|---|---|---|
+| **List page shell** (Deliverables tab — sidebar + main content) | `5787:30996` | Foundation — list-page reusable shell. Branch every list-page mockup from here. |
+| **Pass-2 UC wrapper section** | `5501:1549` | Parent of every Pass-2 UC mockup; child sections live at `5555:14` (UC11), `5680:13` (UC15), `5582:13` (UC19), `5588:13` (UC20), `5592:13` (UC30), `5601:13` (UC31), `5604:13` (UC32), `5613:13` (UC34), `5633:13` (UC33), `5644:13` (UC18), `5701:13` (UC16), `5710:13` (UC16 Ad Hoc editor), `5722:13` (UC22). |
+| **Foundation list-page parent section** | `5501:1550` | Section that contains the canonical list-page frame referenced above. |
+| **Alert Dialog assembled sample** | `4141:5746` | Pre-assembled Alert Dialog instance — copy this, override the body text and footer buttons. Do NOT recompose `Dialog + Dialog Header + Dialog Footer` for confirmation prompts. |
+| **UC11 wrapper** (4 share-modal states) | `5555:14` | Modal chrome reference. |
+| **UC15 wrapper** (3 send-drawer states) | `5680:13` | Sheet / drawer chrome reference. |
+| **UC22 wrapper** (3 public recipient states) | `5722:13` | Branded chrome reference. |
+| **UC3 default editor** | reference via parent page `5269:6651` → "Foundation — Editor" section | Walk the page when you start an editor-chrome mockup. |
+
+The Pass-2 UC mockups are on Figma page **`🍿 Deliverables`** (pageId `5269:6651`). Always `await figma.setCurrentPageAsync(page)` to switch to that page before targeting any of the IDs above.
+
+---
+
+## Pre-Flight, with the cache
+
+The `figma-design-system.mdc` §3 pre-flight expects `search_design_system` calls before the first `use_figma` mutation. **With this cache present, replace them with:**
+
+1. **Read this file** — pick the keys you need by role.
+2. **Open the LM Vision reference frame** (`5787:30996` for list pages, `5555:14` / `5680:13` / `5722:13` for modal / drawer / public chrome) via `get_design_context` to confirm visual conventions.
+3. **Only run `search_design_system`** for any component you need that is missing from this cache. When you run a search, update this file with the new key in the same change.
+
+If any cached key fails at runtime, follow "When the cache is wrong" above.
+
+Always pass `skillNames: "figma-use,figma-generate-design"` (and any other applicable skill names) to `use_figma` for logging.
+
+---
+
+## Appendix — Full re-harvest script
+
+If the cache feels stale (e.g., upstream did a major library rebuild), run this against `VCLfybgU3OaUUPrQdBaVmP` via `use_figma`. It returns the full component map, all variables in `Tokens`, all text styles, and all effect styles. Paste the result into the tables above (skip variants inside component sets — only the set key and standalone components are useful).
+
+```js
+// 1. Components: only sets + standalone components on every component page.
+const skip = new Set(['Cover & Changes','---','Typography','Icons','Shadows','Colors','All Components','Screen examples']);
+const components = [];
+for (const page of figma.root.children) {
+  if (skip.has(page.name)) continue;
+  await figma.setCurrentPageAsync(page);
+  for (const child of page.children) {
+    if (child.type === 'COMPONENT_SET') components.push({ page: page.name, t: 'set', name: child.name, key: child.key });
+    else if (child.type === 'COMPONENT') components.push({ page: page.name, t: 'comp', name: child.name, key: child.key });
+    else if (child.type === 'FRAME' || child.type === 'SECTION') {
+      const inner = child.findAll(n => n.type === 'COMPONENT_SET' || (n.type === 'COMPONENT' && n.parent && n.parent.type !== 'COMPONENT_SET'));
+      for (const n of inner) components.push({ page: page.name, t: n.type === 'COMPONENT_SET' ? 'set' : 'comp', name: n.name, key: n.key });
+    }
+  }
+}
+
+// 2. Tokens variables.
+const collections = await figma.variables.getLocalVariableCollectionsAsync();
+const tokens = collections.find(c => c.name === 'Tokens');
+const tokenVars = [];
+for (const id of tokens.variableIds) {
+  const v = await figma.variables.getVariableByIdAsync(id);
+  if (v) tokenVars.push({ name: v.name, key: v.key, type: v.resolvedType });
+}
+
+// 3. Text + effect styles.
+const textStyles = (await figma.getLocalTextStylesAsync()).map(s => ({ name: s.name, key: s.key, fontSize: s.fontSize, fontName: s.fontName }));
+const effectStyles = (await figma.getLocalEffectStylesAsync()).map(s => ({ name: s.name, key: s.key }));
+
+return { components, tokenVars, textStyles, effectStyles };
+```
+
+For icons, run a separate call (the Icons page has ~1,600 single components):
+
+```js
+const icons = [];
+const iconsPage = figma.root.children.find(p => p.name === 'Icons');
+await figma.setCurrentPageAsync(iconsPage);
+iconsPage.findAll(n => {
+  if (n.type === 'COMPONENT' && n.parent.type !== 'COMPONENT_SET') icons.push({ name: n.name, key: n.key });
+  return false;
+});
+return icons;
+```