@sakaniui/mcp 0.0.0-stage → 0.8.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,536 @@
1
+ # Changelog
2
+
3
+ All notable changes to `@sakaniui/react` are documented here.
4
+
5
+ ## 0.8.10
6
+
7
+ Readiness release: everything below was found by testing the package the way a new user, an editor
8
+ and an AI agent would, and every fix is now covered by a check that fails the build.
9
+
10
+ **Installing the library**
11
+ - **Fixed: installing `@sakaniui/react` installed Next.js.** The `geist` and `@fontsource-variable/geist`
12
+ font packages were runtime dependencies, though the library never loads them, and `geist` requires
13
+ Next.js as a peer, so every app (Vite included) got Next.js 16. Both are now dev-only; the only runtime
14
+ dependency is `recharts`. Load Geist yourself if you want it (`@fontsource-variable/geist`); otherwise
15
+ the system font is used, as before.
16
+ - **Fixed: missing type definitions.** `dist/lib/` was left out of the generated `.d.ts` files, so
17
+ `LiquidGlass`, `LiquidBackdrop`, `HoverGroup`, `useHoverHighlight`, `useLiquidGlass`, `getContrastColor`
18
+ and `iconStrokeWidth` had no types: `<LiquidBackdrop />` compiled without its required `src`. The build
19
+ now fails if any relative import in a shipped `.d.ts` does not resolve.
20
+ - **Fixed docs: `style.css` is required.** The README and the website's Installation page only imported
21
+ `tokens.css`, which leaves components unstyled. Both now import both stylesheets.
22
+
23
+ **The MCP server**
24
+ - **New package `@sakaniui/mcp`** (about 190 kB, no dependencies): `npx -y @sakaniui/mcp` starts in
25
+ about 2 s on a first run. Through `@sakaniui/react` it took ~30 s and ~675 MB, long enough for an editor
26
+ to give up. The copy in `@sakaniui/react` still works.
27
+ - **`check_code`: no false positives** on 685 real elements across three apps (it reported 77). Aliased
28
+ and default imports, code inside template strings, native attributes and the non-icon exports of
29
+ `@sakaniui/react/icons` are handled; it still catches every deliberate mistake in the test set.
30
+ - **Versions per prop and per value.** Each prop added after its component has its own `since` (for
31
+ example `Switch.variant`, 0.8.4), and values added later are listed in `valuesSince`. `since` now means
32
+ "first release you could import it", taken from the package's public exports at every release (the
33
+ social icons are 0.8.6, not 0.3.0). `check_code`, `check_usage` and `get_component` flag props and
34
+ values the project's installed version does not have.
35
+ - **Invented props are errors.** A prop that is neither the component's own nor an HTML attribute (React's
36
+ own attribute list now ships in `manifest.json` as `nativeAttributes`) fails `check_code` and
37
+ `check_usage`, with the real prop list and a suggestion (`leftIcon` -> "did you mean leadingIcon?").
38
+ Real HTML attributes (`placeholder`, `href`, `name`...) pass silently; `color` gets a note that it does
39
+ not style the component.
40
+ - **Protocol:** negotiates a supported protocol version, answers `resources/list`, `prompts/list` and
41
+ batches, exits when the editor disconnects (flushing replies first), and survives a closed pipe.
42
+ `get_guide` accepts `query`. Tested on Node 18, 20, 22 and 26, with the official MCP SDK client and the
43
+ MCP Inspector, and documented for Windows (`cmd /c npx ...`).
44
+ - Removed an unresolvable `$schema` link from `manifest.json`.
45
+
46
+ ## 0.8.9
47
+
48
+ Stops assistants from inventing code. Found by testing the MCP server in Claude Code: it validated a
49
+ snippet correctly, then wrote its own example as `icon={<TrashIcon />}` -- an icon that does not exist,
50
+ passed as an element instead of a component.
51
+
52
+ - **Examples.** Every component and block in `manifest.json` has `example`: the import lines and the
53
+ element with each required prop filled in with a value of the right shape (an array of `BreadcrumbItem`
54
+ gets one real item). Prop types are read from the shipped `.d.ts`, and every example is type-checked
55
+ against the built package; the build fails if one does not compile.
56
+ - **Icon index.** `@sakaniui/react/icon-index.json` lists all 5,184 icons (and their 1,054 filled
57
+ variants) with Tabler's category and search tags. The build fails if it differs from the exports.
58
+ - **MCP: `search_icons`.** Finds real icon names by meaning ("delete" -> `IconTrash`); common UI intents
59
+ rank the conventional icon first.
60
+ - **MCP: `check_code`.** Checks a whole snippet as text (it is never run): imports must exist and come
61
+ from the right entry point, every SakaniUI element needs its required props, values must be allowed,
62
+ and icon props must be real icon components passed as `icon={IconTrash}`. Errors carry line numbers
63
+ and suggestions ("TrashIcon is not exported... Did you mean: IconTrash?").
64
+ - **MCP: `check_usage`** now validates icon props too, and `get_component` points at the example and
65
+ at `search_icons`.
66
+ - Fixed a type error in `KanbanBoardBlock` (drag attributes when dragging is disabled) that was printed
67
+ during every build.
68
+
69
+ ## 0.8.8
70
+
71
+ Audit of the agent contract and MCP server (accuracy, security, versioning).
72
+
73
+ - **Manifest accuracy.** `FaqBlock.columns` is now `1 | 2` (numbers), not `"1" | "2"`; prop `values`
74
+ keep their real type. All 231 design tokens are listed (the 49 `glass-*`, `surface-*` and `liquid-*`
75
+ tokens were missing). `LiquidGlass`, `LiquidBackdrop` and `HoverGroup` are described, and hooks and
76
+ helpers are listed under `utilities`. Defaults that are code (`createIcon(...)`, arrow functions) are
77
+ no longer shown. The build now fails if a public component is exported but not described, so the
78
+ manifest cannot silently fall behind.
79
+ - **Manifest content.** Design-tool (Figma) notes, source paths and a sample e-mail address are no longer
80
+ shipped in the manifest.
81
+ - **Versioning.** Every component has `since`, the first release that contained it. `CHANGELOG.md` now
82
+ ships in the package. The MCP server finds the project's own installed `@sakaniui/react` (working
83
+ directory, or `--project <dir>`) and answers from that copy; when the project is older it flags
84
+ components it does not have yet. New tools `check_compatibility` and `get_changelog`.
85
+ - **Summaries.** Component summaries were rewritten where the source notes were maintainer-only text
86
+ (garbled or empty summaries, design-tool node ids); blocks get a name-and-group summary.
87
+ - **Verified on every build.** `npm run build:lib` now also runs `scripts/manifest/verify.mjs`, which fails
88
+ the build (and so `npm publish`) if an entry is not a real export, a prop is not in the type
89
+ definitions, a token disagrees with `tokens.css`, `since` is newer than the package, or anything that
90
+ looks like a private reference (design-file link or node id, e-mail address, local path, key) or any
91
+ write / network / exec code in the server appears.
92
+ - **Server hardening.** Every tool argument is type- and length-checked, tools are marked read-only, and
93
+ the server reads only four fixed files from an install (package.json, manifest, AGENTS.md, CHANGELOG.md).
94
+
95
+ ## 0.8.7
96
+
97
+ - **Machine-readable contract for AI agents and tooling.** The package now ships
98
+ `@sakaniui/react/manifest.json`: every exported component and block (123 + 42) with its import
99
+ path, summary, props, types, enum values, defaults, required props and a
100
+ `requiresAccessibleName` flag, plus all 182 design tokens. It is generated from the TypeScript
101
+ source on every `build:lib` (react-docgen-typescript), so it cannot drift from the code, and it only
102
+ lists names that are really exported. AGENTS.md now points agents at it first.
103
+ - **MCP server.** `npx -y -p @sakaniui/react sakaniui-mcp` starts a local, dependency-free Model
104
+ Context Protocol server over stdio that answers from the shipped manifest and AGENTS.md. Tools:
105
+ `search_components`, `get_component`, `list_components`, `get_tokens`, `check_usage` (reports
106
+ missing required props, values outside an enum and props that do not exist) and `get_guide`.
107
+ - `IconButton`'s `icon` prop description no longer says "Lucide icon component" (it takes Tabler or Lucide).
108
+
109
+ ## 0.8.6
110
+
111
+ - **Social icons are now exported.** The glyphs the Figma ProfileCard and TeamCard use --
112
+ `XIcon`, `GithubIcon` (ProfileCard) and `InstagramIcon`, `FacebookIcon`, `LinkedinIcon`
113
+ (TeamCard) -- can be imported from `@sakaniui/react`, so an app's `socialLinks` can use the exact
114
+ same icons as the design system instead of copying them. They draw in `currentColor`.
115
+
116
+ ## 0.8.5
117
+
118
+ - **Sidebar: 8px corners.** To match the Figma file (where the sidebar components now use
119
+ `radius/md`), `SidebarItem`, `SidebarSubItem`, `SidebarSearch` (field, command and collapsed),
120
+ `SidebarHeader` (workspace card and brand button) and the `SidebarFooter` action button go from
121
+ 6px to 8px. Small icon buttons (the header toggle and footer menu) and the keyboard-shortcut
122
+ badge keep their size, as in Figma.
123
+
124
+ ## 0.8.4
125
+
126
+ - **Switch: new `stretch` variant.** `<Switch variant="stretch" />` adds a liquid motion: on every
127
+ toggle the thumb stretches (16 -> about 22px) as it travels -- the edge it is heading toward moves
128
+ first, the tail follows a beat later -- then relaxes into a circle. One smooth motion with no
129
+ overshoot, it stays inside the track, a click mid-travel reverses from where the thumb visibly is,
130
+ and it is off with reduced motion. `variant="default"` (the default) is the plain switch,
131
+ unchanged. Figma: Switch gains a *Type* axis (Default | Stretch).
132
+
133
+ ## 0.8.3
134
+
135
+ - **SakaniUI.** The design system is now called SakaniUI, and the GitHub repository moved to
136
+ github.com/samzydd/Sakaniui (the old URL redirects). The package name, `@sakaniui/react`, is
137
+ unchanged; this release updates the repository, homepage and issues links shown on npm.
138
+
139
+ ## 0.8.2
140
+
141
+ - **Kanban Board: calmer motion.** The dragged card's tilt and its settle on drop are now
142
+ near-critically damped (overshoot down from about 30% to 2%), and the cards that slide out of the
143
+ way ease in without overshooting.
144
+
145
+ ## 0.8.1
146
+
147
+ - **Kanban Board: smooth drag and drop.** The block's native HTML5 drag is replaced by pointer-based
148
+ dragging (mouse, pen and touch). While you drag, the card lifts and swings from the grab point
149
+ with its movement; a drop slot -- the card itself at 20% with a 12/4 dashed outline -- opens
150
+ exactly where it will land and the other cards slide out of the way; on release the card glides
151
+ into place. Drops land at the slot's position instead of the end of the column. Touch drags start
152
+ with a press-and-hold, the board auto-scrolls at its edges, a card dropped outside every column
153
+ springs back, and reduced motion turns off the swing and glide.
154
+ - The sample board has photo avatars and five or six cards per column. Figma: Board Column gains a
155
+ *Drop target* variant, and the Kanban *Dragging* state shows the new slot.
156
+
157
+ ## 0.8.0
158
+
159
+ - **Removed:** Glass Icons (`@sakaniui/react/glass-icons`). The glass versions couldn't stay faithful
160
+ to every Tabler icon, so the set is gone from the package, the docs and the Figma file (with its
161
+ `glass-icon/*` variables and `--glass-icon-*` tokens). Use the regular icons from
162
+ `@sakaniui/react/icons` instead (`GlassHeart` -> `IconHeart`). Glass and liquid glass *surfaces*
163
+ are unchanged.
164
+ - `lucide-react` is gone entirely, and so is its licence notice: every icon is Tabler (MIT).
165
+
166
+ ## 0.7.0
167
+
168
+ - **Tabler Icons is now the icon set.** New entry point `@sakaniui/react/icons` with all 5,184 Tabler
169
+ outline icons (`IconHome`, `IconCalendar` ...) and 1,054 filled ones (`IconHomeFilled` ...),
170
+ generated from `@tabler/icons` and matching the Figma *↳ Icons (Tabler)* page. One component per
171
+ icon, tree-shaken individually (one icon is about 1 kB). Props follow lucide-react (`size`,
172
+ `color`, `strokeWidth`, `absoluteStrokeWidth`) plus `title`; default stroke 1.5, the Figma stroke.
173
+ - **Every component now renders Tabler icons.** The 125 Lucide icons used inside components and
174
+ blocks were swapped for their Tabler equivalents, with the same mapping as the Figma file (house
175
+ -> home, triangle-alert -> alert-triangle, panel-left -> layout-sidebar ...). `lucide-react` is no
176
+ longer a dependency of the package.
177
+ - Icon props are typed `IconComponent` (exported from the main entry) instead of Lucide's
178
+ `LucideIcon`; Lucide and Tabler React icons still fit, so existing apps keep working.
179
+ - **Removed:** `@sakaniui/react/sicons` (the rounded Lucide set from 0.6.x), replaced by
180
+ `@sakaniui/react/icons`. Swap `SiconHeart` for `IconHeart`; names follow Tabler.
181
+ - `THIRD_PARTY_NOTICES.md` now carries Tabler's MIT licence (icons) as well as Lucide's ISC licence
182
+ (Glass Icons, still Lucide-based).
183
+
184
+ ## 0.6.1
185
+
186
+ - **Sicons: crisp chevrons and checks.** Icons with short, sharp corners (chevrons, checks, small
187
+ arrows, list ticks) now use a 1px corner radius instead of 3.7 or 4; a 4px radius blunted their
188
+ points into curves. The rule: if a 4px radius would use more than 30% of the shorter edge at the
189
+ icon's tightest corner, the whole icon gets 1px (274 icons); every other icon keeps 4px. The
190
+ Figma Sicons set uses the same rule (307 icons there, where Figma joins some lines differently).
191
+
192
+ ## 0.6.0
193
+
194
+ - **Sicons: Sakani's own icon set, `@sakaniui/react/sicons`.** The same 1,626 icons as the Figma
195
+ *Icons* component set: Lucide's shapes at a 1.5 stroke with softened corners (a 4px radius, 3.7px
196
+ on icons whose short corners can't take 4). One component per icon (`SiconHeart`,
197
+ `SiconCalendar`, ...), each tree-shaken on its own (one icon is under 1 kB).
198
+ - Props follow lucide-react (`size`, `color`, `strokeWidth`, `absoluteStrokeWidth`), plus `title`,
199
+ so swapping a Lucide icon is a find-and-replace. Colour is `currentColor`.
200
+ - Figma first: the *Icons* set itself has the same rounded corners, so every icon instance in the
201
+ file matches.
202
+ - Corner rounding is baked into the path data at build time (`scripts/sicons/`), with the same
203
+ rule the Figma set was built with. A few percent of icons can get the 3.7 radius in one and the
204
+ 4 in the other where Figma joins lines differently. Where two lines meet at a shared point (an
205
+ arrow head on its shaft) the corner is left as is, as in Figma.
206
+ - Naming: the icon set is now called Sicons everywhere (Figma page *↳ Sicons*, component set
207
+ *Sicons*), credited as based on Lucide. The package now ships `THIRD_PARTY_NOTICES.md` with
208
+ Lucide's ISC licence, which covers Sicons and Glass Icons.
209
+ - Storybook: *Foundations -> Sicons* (overview, close-up, props, searchable gallery).
210
+ - Not changed: the built-in components still render lucide-react icons; moving them onto Sicons is
211
+ a separate step.
212
+
213
+ ## 0.5.0
214
+
215
+ - **Glass icons: all 1,626 icons in the Sakani icon set, as monochrome frosted glass.** New entry
216
+ point `@sakaniui/react/glass-icons`, one component per icon (`GlassHeart`, `GlassCalendar`, ...),
217
+ each tree-shaken on its own. Each icon's main shape is one charcoal glass solid (top-to-bottom
218
+ gradient, bright rim, soft shadow), a disc tucked behind its corner glows through the glass
219
+ blurred, and inner lines sit on the glass in white (lines off the glass stay solid). Line-only
220
+ icons (arrows, a checkmark) become a single thick glass stroke. Props: `size` (default 24, any CSS
221
+ length), `surface`, `title`.
222
+ - Charcoal on purpose: brand-neutral, so any team can use them. Colours are the new
223
+ `--glass-icon-*` tokens on `:root` and `.dark` (accent, glass-top, glass-bottom, rim, detail,
224
+ detail-off), so light and dark follow the nearest theme scope.
225
+ - Figma first: the file has the matching *Glass Icons* component set (page *↳ Glass Icons*, 1,626
226
+ 24x24 `type=` variants mirroring *Icons*, layers scale with the instance), coloured by the
227
+ `glass-icon/*` variables in the Semantic collection (Light/Dark).
228
+ - Which parts are glass and which are lines is decided at build time
229
+ (`scripts/glass-icons/decompose.mjs`), with the same rules the Figma set was built with.
230
+ - The set: 1,603 icons from lucide-react's shape data, 23 from the Figma file (brand logos Lucide
231
+ removed, plus icons Lucide merged into a sibling).
232
+ - Pure SVG on a 24x24 grid (masks, gradients, blur), no backdrop-filter: sharp at any size and the
233
+ same in every browser.
234
+ - `<GlassIcon icon={AnyLucideIcon} />` covers Lucide icons added later (drawn as one glass stroke).
235
+ - Storybook: *Foundations -> Glass Icons* (overview light/dark, sizes, searchable gallery).
236
+
237
+ ## 0.4.11
238
+
239
+ - **ProductCard matches Figma to the pixel.** Measured against the Figma set (320 x 536), the code
240
+ card was 546px tall and its text column 294px instead of 296px. Fixed: the title-to-description
241
+ gap is 8px (it was the body's 12px), the swatches are the 28px Figma uses (circle 21, check 10)
242
+ instead of 32px, the five stars are 91px wide (2.68px apart, not 4px), and the 1px border is taken
243
+ out of the padding and the image height so the stroke sits "inside" the frame as in Figma. The
244
+ standalone `ColorSwatch` is unchanged: it now sizes from `--swatch-size` (default 32px), which
245
+ the card sets to 28px.
246
+
247
+ ## 0.4.10
248
+
249
+ - **CRMDashboardBlock is responsive.** It was hard-wired to the viewport (`100vw` x `100vh`) with
250
+ media queries, so inside a frame, a split view or a phone it overflowed and clipped. It now fills
251
+ its container (`--crm-block-height` sets the height; default `100vh`) and its breakpoints are
252
+ container queries. Tablet (<= 880px): the filter panel steps aside and the toolbar wraps. Phone
253
+ (<= 640px): the icon rail becomes a slide-in navigation drawer opened from the top bar's menu
254
+ button (Escape or the scrim closes it), the toolbar stacks, tabs scroll, and padding tightens. The
255
+ table now stacks into cards based on its own width (<= 720px) instead of the window's, so it never
256
+ crams eight columns into a narrow frame. No prop changes.
257
+ - **TeamCard matches Figma's text width.** The card's 1px border was added on top of Figma's 12px
258
+ padding (Figma's stroke sits inside the frame), leaving a 378px text column instead of 380px. That
259
+ was enough to wrap the *Card details* bio onto a third line, making the card 20px taller than
260
+ Figma's. The border is now taken out of the padding, so the column is 380px and the bio wraps
261
+ exactly as in Figma.
262
+ - **KanbanBoardBlock works on phones.** The toolbar was one non-wrapping row, so the search field,
263
+ filter chips and buttons overlapped below ~700px. The block is now a size container: below 760px
264
+ the toolbar stacks (search, filters, then the actions sharing the row), and the board scrolls edge to
265
+ edge with columns snapping into place as you swipe. Wider layouts are unchanged.
266
+
267
+ ## 0.4.9
268
+
269
+ - **ProgressItem titles line up with their numbers.** In the vertical layout a title with no
270
+ description sat at the top of the 32px circle, 6px above its centre; it is now centred on the circle.
271
+ A title with a description stays top-aligned so the pair reads as one block. The horizontal layout
272
+ is left-aligned on purpose (the label starts at the circle's left edge) and that is now explicit in
273
+ the CSS.
274
+
275
+ ## 0.4.8
276
+
277
+ - **AI-readable design system.** The package now ships `AGENTS.md`: the *why* behind the system for
278
+ AI agents and new teammates — setup that must be right, eight principles, what to do when nothing
279
+ fits, when to use (and not use) each component and why it behaves as it does, glass/liquid usage rules,
280
+ the behaviour you must supply yourself, and recipes for AI-product moments (uncertain answers, sources,
281
+ declined requests, partial responses). The docs site serves an index at `/llms.txt` and the full
282
+ text at `/llms-full.txt`.
283
+
284
+ ## 0.4.7
285
+
286
+ - **SidebarPromo uses the real Button.** Its CTA was a hand-styled `<button>` too. It now renders
287
+ `<Button variant="primary" size="sm">` stretched full width, so it gets the updated hover,
288
+ press and focus effects. Liquid surfaces keep the outlined, see-through look. No prop changes.
289
+
290
+ ## 0.4.6
291
+
292
+ - **EmptyState uses the real Button.** The action was a hand-styled `<button>` that missed the
293
+ updated Button's hover, press and focus effects. It now renders `<Button variant="outline"
294
+ size="sm">`, so it stays in step with every Button change. No prop changes.
295
+
296
+ ## 0.4.5
297
+
298
+ - **BlogListingFeaturedCard is responsive.** The horizontal card (a fixed 400px image plus
299
+ text) squeezed its text column to a sliver whenever its container was narrower than ~640px.
300
+ It now measures its own container: side by side when there's room, stacked (image on top,
301
+ full width) below 640px, with the footer wrapping below 360px. Nothing changes at the
302
+ card's designed width (874px), and `BlogListingBlock` is unchanged. New story:
303
+ *Marketing → Blog Listing Featured Card → Responsive*.
304
+
305
+ ## 0.4.4
306
+
307
+ - **Stepper: the bar animates between steps.** Going forward, the connector fills from the
308
+ step you leave toward the next one and that circle activates when the bar arrives (its ring
309
+ ripples once and the previous circle's check draws in). Going back plays it in reverse,
310
+ draining the bar. Jumping several steps hands the fill from bar to bar. Horizontal and
311
+ vertical. No animation on first render; `prefers-reduced-motion` makes every change
312
+ instant. New stories: *Composite / Stepper → Animated* and *Animated vertical*.
313
+
314
+ ## 0.4.3
315
+
316
+ - **Faster sidebar toggle in the dashboard.** Collapsing or expanding the sidebar used
317
+ to drop frames (a 367ms frame and 200ms+ tasks on expand): the main glass panel
318
+ rebuilt its megapixel displacement map on every animation frame and the charts
319
+ re-rendered with it. Lens maps are now built only along the edges, big lenses settle
320
+ before re-measuring, and the dashboard content is memoized. Worst frame: 33ms, no
321
+ long tasks. Output is pixel-identical.
322
+ - **Collapsed rail:** hovering anywhere on the rail turns the logo into the "open
323
+ sidebar" button (it cross-fades), not only hovering the logo itself.
324
+
325
+ ## 0.4.2
326
+
327
+ **Liquid glass speaks Figma: the same Glass properties, the same values, the same result.**
328
+
329
+ - **`LiquidGlass` now takes Figma's Glass effect properties directly**, in
330
+ Figma's units: refraction, depth, dispersion, frost, light intensity and
331
+ light angle. The tokens are the liquid/regular and liquid/clear effect
332
+ styles as they are in Figma:
333
+ `--liquid-refraction-regular|clear` (0.55 | 0.8), `--liquid-depth-*`
334
+ (16 | 20), `--liquid-dispersion-*` (0.3 | 0.4), `--liquid-frost-*` (4 | 1),
335
+ `--liquid-light-intensity-*` (0.7 | 0.8) and `--liquid-light-angle` (-45).
336
+ Per element: `<LiquidGlass effect={{ refraction: 0.8, depth: 20, dispersion: 0.4, frost: 1 }}>`.
337
+ - **Measured, property by property.** Each Figma property was swept on its
338
+ own over gradient, step and flat-grey backdrops, and the code reproduces
339
+ every probe: the bend within 0.3px on average (all refraction, depth and
340
+ dispersion values), the frost blur within 0.3px, the light within half a
341
+ brightness level. How each property behaves:
342
+ - Refraction × depth sets the bend; depth also sets how far in it reaches
343
+ (0.8 × depth px). The steep fall near the rim folds the content just
344
+ inside into the magnified band along the edges and round the corners.
345
+ - Dispersion splits the color: red bends more, blue less.
346
+ - Frost blurs the backdrop before it is bent.
347
+ - Light is added on top: a 1px rim, strongest on edges that face the
348
+ light (none on edges side-on to it), plus a shade inside the lit edges
349
+ and a glow inside the far ones. It is drawn in the filter now, so it adds
350
+ light like Figma instead of laying white over the backdrop.
351
+ - **Correction to 0.4.1:** Figma's lens never samples outside the element, and
352
+ every edge bends the same way (with the light off). The 0.4.1 note about an
353
+ approximate clear rim no longer applies.
354
+ - **Breaking (tokens published in 0.4.1):** `--liquid-bezel-*`,
355
+ `--liquid-shift-*`, `--liquid-profile-*` and `--liquid-saturate-*` are gone
356
+ (Figma has no such properties); `--liquid-depth` is now Figma's Depth, and the
357
+ old inset-shadow token is `--liquid-edge-shade` (Safari/Firefox fallback
358
+ only). `--liquid-light-angle` is Figma's angle in degrees (-45), not a CSS
359
+ gradient angle.
360
+ - **New: `LiquidBackdrop`.** Wrap a liquid-glass UI in
361
+ `<LiquidBackdrop src={photo}>` and every lens inside refracts the photo itself
362
+ (an aligned copy, kept aligned while lenses glide, scroll or squish) instead of
363
+ whatever the browser painted below it. Like Figma, glass stacked on glass now
364
+ bends the sharp original: real refraction and color fringing on nested lenses,
365
+ not a blur of the lens below. `veil` lays a color over the image for every lens
366
+ (Figma's 5% overlay fill; a scrim in dark mode). `source={false}` on a lens
367
+ bends the UI below instead (slider knobs, selection droplets).
368
+ - **Fast at full-screen sizes.** A live SVG filter over a full-screen lens is
369
+ re-evaluated whenever anything near it repaints (the dashboard ran at ~15fps
370
+ while hovering the sidebar). Inside a `LiquidBackdrop`, lenses bigger than
371
+ 300×300 now run the same filter once into a canvas and re-bake only when their
372
+ size, position, theme or properties change: 60fps, pixel-identical. Small
373
+ lenses that move stay live; `bake={false}` keeps a big moving lens live.
374
+ - **`LiquidDashboardBlock`** sits on a `LiquidBackdrop`: the promo card and the
375
+ sidebar lenses refract the sharp photo like the Figma frame; the active lens
376
+ springs and stretches as it glides; item labels are fg/default as in Figma.
377
+ - **`LiquidDashboardBlock` is responsive.** It reflows to the width of its panel
378
+ (container queries): four stat cards become 2×2, then a column; the charts go
379
+ from three across to two, then one; Recent orders and Recent activity stack.
380
+ Below 900px the sidebar collapses to its rail by itself (until you toggle it).
381
+ The collapsed rail is fixed: lenses hug the 32px buttons, items are centered,
382
+ groups are separated by a hairline, and the lens lands exactly where the
383
+ rail's width animation ends. Search closes on Esc and shows a focus ring.
384
+ Collapsed tooltips are portaled to the page (the rail clipped them and the main
385
+ panel covered them), and hovering a nav item changes nothing but the glass: the
386
+ library's own icon darkening, which fired before the lens faded in, is off.
387
+ The opened search field is a glass pill: its icon and text were white on a white
388
+ box (the top bar is in on-photo mode), so they vanished.
389
+ - **Storybook:** *Foundations / Liquid Glass* is now a showcase (sidebar, tab bar
390
+ with a sliding droplet, Now Playing card whose slider knobs turn into lenses,
391
+ a lens you can drag over the photo), a dark version, and a Playground with
392
+ Figma's six Glass properties as controls. The calibration and measurement
393
+ tools moved to *Foundations / Liquid Glass / Lab*.
394
+
395
+ ## 0.4.1
396
+
397
+ **Liquid glass matches the Figma file.**
398
+
399
+ - **`tint` prop on `LiquidGlass`** — `"regular" | "clear" | "subtle" | "none"`.
400
+ `subtle` is Figma's `glass/bg-subtle` (5% ink; 8% white in dark), the fill of
401
+ a full-bleed overlay over a photo. Defaults to the variant's own tint.
402
+ - **One lens per variant.** `--liquid-refraction`, `-shift`, `-bezel`, `-profile`,
403
+ `-dispersion`, `-frost` and `-saturate` now have `-regular` and `-clear`
404
+ versions (Figma's two `liquid/*` effect styles), fitted against Figma's own
405
+ render. Set the unprefixed name on one element to override just that one.
406
+ - **Directional lens, rim and depth.** The bend, the rim light and the inner
407
+ shading follow `--liquid-light-angle` (Figma's light, -45 degrees), so the lit
408
+ edges differ from the far edges as in Figma. New `--liquid-shift-*`
409
+ and `--liquid-profile-*` tokens.
410
+ - **Figma's shadows** for both variants (`--liquid-shadow-regular|clear`) and
411
+ Figma's glass tint values (`.64 / .76 / .52`).
412
+ - **New `--surface-fg-muted` token** (solid, glass and liquid), and
413
+ `data-on-photo`: light text for any subtree that sits straight on a photo.
414
+ - Liquid scope defaults: the `Menu` is frosted, the active `SidebarItem` is flat
415
+ and `SidebarPromo` is transparent with an outlined button, so the dashboard
416
+ block no longer needs overrides for them.
417
+ - Known difference: Figma's clear lens samples *outside* the element at its lit
418
+ edges. CSS `backdrop-filter` cannot read outside its own box, so the clear
419
+ variant's rim is an approximation.
420
+
421
+ ## 0.4.0
422
+
423
+ **Glass and liquid glass.**
424
+
425
+ - **New theme axis: Surface (Solid · Glass · Liquid).** Components read
426
+ `--surface-*` tokens; `data-surface="glass" | "liquid" | "solid"` on any
427
+ ancestor re-themes everything inside it. Solid is pixel-identical to
428
+ before (checked story by story). Menus, modals and selects carry the
429
+ setting through their portals. `prefers-reduced-transparency` falls back
430
+ to opaque surfaces.
431
+ - **New: `LiquidGlass` and `useLiquidGlass`.** Apple-style liquid glass: an
432
+ SVG displacement filter bends the backdrop at the element's edge (with a
433
+ per-channel color fringe), plus tint, rim light, depth and a pointer-
434
+ following glare. Chromium renders the refraction; Safari and Firefox get
435
+ a frosted fallback with the same rim. Tunable through `--liquid-*` tokens
436
+ (tint, refraction, bezel, dispersion, frost, saturate, overlay and panel tints).
437
+ - **New block: `LiquidDashboardBlock`** (`@sakaniui/react/blocks`, Storybook
438
+ *Blocks / Application / Liquid Glass Dashboard*). A full dashboard on a
439
+ photo: one glass overlay, transparent chrome, solid data cards, an active
440
+ sidebar lens that only moves on click and a softer hover lens.
441
+ - Interaction polish: Switch spring, Slider fling bounce, chip/tag fade-out,
442
+ ListItem hover glide, ghost Button without shadow, Menu radius 8px,
443
+ `Switch` `description` prop, `bg/canvas` hover fill on surface components.
444
+ - Fix: the swatch checkmark could render invisible on light swatches in
445
+ server-rendered pages.
446
+
447
+ ## 0.3.5
448
+
449
+ - Replaces the Sakani mark (`PlaceholderLogo`'s default fill) with the new
450
+ logo, brand-orange background.
451
+ - Fix: `vite.lib.config.ts` has no `publicDir` override, so Vite's default
452
+ behaviour was copying this repo's `public/` folder into the published
453
+ package as a side effect — `dist/favicon.svg` shipped inside every install
454
+ of `@sakaniui/react` for no reason connected to the library itself. Still
455
+ ships (removing it isn't this release's job), but now carries the current
456
+ brand mark rather than a leftover unrelated asset.
457
+
458
+ ## 0.3.4
459
+
460
+ 0.3.3 was never actually published — a publish got stuck mid-flight on the
461
+ registry (staged but never finalized) and had to be abandoned rather than
462
+ retried, so this carries everything that would have shipped as 0.3.3:
463
+
464
+ - **Fix: `Popover` and `Modal` had no entrance/exit animation at all.** They
465
+ appeared and vanished on a single frame, unlike `Select` and `Combobox`,
466
+ which already ease their panels in and out. Both now animate over 180ms on
467
+ the same curve, kept mounted past `open` so the exit has something to play
468
+ on, and fall back to a timeout if `animationend` never fires (a
469
+ backgrounded tab, or anything suppressing animations) — without it, a
470
+ dismissed popover, or worse a full-screen modal backdrop, could be left
471
+ mounted and invisible over the page while still able to take focus.
472
+ - **Fix: charts read colour tokens from `document.documentElement`, ignoring
473
+ any `.dark`/`.force-light` scope between it and the chart.** A chart
474
+ rendered inside a themed container painted the *outer* theme's colours on
475
+ the *inner* theme's background. Tokens now resolve from the chart's own
476
+ element, and the reader re-renders when any ancestor's class changes, not
477
+ just `<html>`'s.
478
+ - **Fix: server-rendered charts never picked up real tokens at all.**
479
+ `useThemeTick` only bumped on theme *changes*; under SSR there is no
480
+ `getComputedStyle`, so a server-rendered chart kept its hardcoded fallback
481
+ colours forever once hydrated (React won't patch a hydration mismatch). It
482
+ now also bumps once on mount. Several of those fallbacks were themselves
483
+ stale values from an older palette and are corrected.
484
+ - **Fix: `Select`'s floating listbox and `Modal`'s backdrop ignored the
485
+ `.dark`/`.force-light` scope of whatever they were opened from.** Both
486
+ portal to `<body>` to position with `fixed`, which moves them out from
487
+ under any themed container; they now carry that container's theme class
488
+ onto the portaled element.
489
+ - `Table` gained a drag handle: a grip icon at the left edge of a
490
+ `reorderable` row, hidden until hover, and the sole drag origin (dragging
491
+ no longer starts from clicking anywhere in the row).
492
+ - `CRMDashboardBlock`, `KanbanBoardBlock` and `DataTableBlock` gained
493
+ `fillPlaceholders`, which extends the table to fill a taller container with
494
+ placeholder rows instead of leaving blank canvas below it.
495
+ - `Calendar` now exports its `DateRange` type.
496
+
497
+ ## 0.3.2
498
+
499
+ - **Fix: `@sakaniui/react/tokens.css` was never actually published.** The `exports` map pointed it at `./src/styles/tokens.css`, but `files: ["dist"]` only ever publishes the `dist` folder — so that path never existed in the installed package, and `import '@sakaniui/react/tokens.css'` (exactly as documented in the README) failed to resolve for every consumer. Without it, every component would have rendered completely unstyled: the CSS ships only the `var(--color-fg-default)` *references*, not the `:root { --color-fg-default: ... }` *definitions*. Fixed by copying `tokens.css` into `dist/` as part of the build and pointing the export there instead.
500
+
501
+ ## 0.3.1
502
+
503
+ - Fix: `Combobox`'s `loading` prop (the panel's loading state) was declared on `ComboboxOption` instead of `ComboboxProps`, so passing it to `<Combobox loading />` as documented was a type error and the prop was unreachable in a type-checked consumer. Moved to `ComboboxProps`, where the component was already reading it from at runtime.
504
+
505
+ ## 0.3.0
506
+
507
+ The library has grown substantially since the last published release —
508
+ five new categories of primitives and dozens of new blocks, all matching
509
+ their Figma source 1:1 and shipping with full light/dark support.
510
+
511
+ **New component categories:**
512
+ - **E-commerce** — Cart Item, Checkout Steps, Color Swatch, Price Display, Product Card, Product Gallery, Quantity Selector, Size Selector, Star Rating, Stock Status, Wishlist Button
513
+ - **Marketing** — Blog Blockquote, Blog Feature Text, Blog Image, Blog Listing Card, Blog Listing Featured Card, Featured Icon, First Page Heading, Job Listing, List, Location Dot, Marquee, Metric, Mobile Navigation Menu, Placeholder Logo, Profile Card, Rich Text Heading, Rich Text Paragraph, Section Heading, Sub Feature, Team Card
514
+
515
+ **New blocks:**
516
+ - **Authentication** — Email Verification, Forgot Password, Login, Reset Password, Sign Up, Two-Factor Authentication
517
+ - **Billing** — Add Card Form, Billing Address, Billing History, Current Plan, Payment Method
518
+ - **E-commerce** — Checkout Flow, Order Confirmation, Product Detail, Product Grid, Shopping Cart
519
+ - **Marketing** — Blog Listing, Careers, CTA Banner, FAQ, Feature Grid, Hero, Logo Cloud, Pricing Table, Team Section, Testimonial
520
+ - **Application** — Account Overview, Activity Log, App Header, Data Table + Toolbar, File Upload Panel, Form Modal, Inline CTA, Multistep Modal, Notification Panel, Onboarding Progress, Profile Settings, Section Footer
521
+
522
+ **Other:**
523
+ - `StarRating` gained a full `orientation` axis (horizontal / horizontal-reverse / vertical), shared between the E-commerce Product Detail block and Marketing's own Star Rating usage.
524
+ - Every component and block's Storybook Docs page now renders a real, written explanation (previously blank) — what it does, what it maps to in Figma, and key implementation notes, sourced from each component's own doc comments.
525
+ - The Storybook landing page now introduces the Sakani Design System itself instead of Storybook's generic default onboarding content.
526
+ - README's component/block inventory brought up to date with the actual library (114+ components, 41 blocks).
527
+
528
+ ## 0.2.0
529
+
530
+ - Blocks are now published from a separate subpath, `@sakaniui/react/blocks`, kept out of the main `@sakaniui/react` entry point so importing them is a deliberate choice.
531
+ - Added Funnel and Heatmap charts.
532
+ - The library now auto-builds (`prepare` script) on install.
533
+
534
+ ## 0.1.0
535
+
536
+ - First published release of `@sakaniui/react`.