wimui 0.12.0 → 0.14.0

package/dist/llms-full.txt

@@ -4,7 +4,7 @@
 
 ## What this is
 
-**wimui** v0.12.0 — a React 19 component library: 218 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
+**wimui** v0.14.0 — a React 19 component library: 218 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
 
 ## Install & required setup
 
@@ -786,8 +786,32 @@ The container-query wrapper div is preserved to maintain responsive column behav
     - `collapsed: boolean` — Collapsed state
     - `width: number | string` = 260 — Width when expanded
     - `bordered: boolean` = true — Border at the right
-    - `responsive: boolean` = true — Enable responsive behavior (mobile drawer)
-    - `mobileOpen: boolean` — Mobile drawer open state
+    - `responsive: boolean` = true — Below the `md` breakpoint, move the sidebar off-canvas so it stops taking
+width from the content. Defaults to `true`.
+
+**It does not bring a way back on screen.** Off-canvas means
+`left: -{width}` until `mobileOpen` is true, and nothing in this component
+flips that — so on a phone the sidebar and everything in it become
+unreachable unless you wire a trigger yourself. Measured at 390px: the rail
+sits at `x = -260` with no control anywhere on the page (T60).
+
+Pair it with `mobileOpen` and a `HamburgerMenu`, the way the AppShell story
+does:
+
+```tsx
+const [open, setOpen] = useState(false);
+
+<HamburgerMenu visibleBelow="md" open={open} onClick={() => setOpen((o) => !o)} />
+<Sidebar mobileOpen={open} onOverlayClick={() => setOpen(false)}>…</Sidebar>
+```
+
+`visibleBelow="md"` keeps the control out of the way at widths where the
+rail is already on screen. The trigger lives outside this component on
+purpose: it usually belongs in the header, and a built-in one would sit in
+the wrong place or duplicate the one you already have.
+
+Set `responsive={false}` to keep the sidebar in flow at every width.
+    - `mobileOpen: boolean` — Mobile drawer open state. Required for the rail to be reachable below `md` — see `responsive`.
     - `onOverlayClick: () => void` — Callback when overlay is clicked
 - **SimpleGrid** — Responsive fixed grid
     - `cols: T | { base?: T; sm?: T; md?: T; lg?: T; xl?: T; }` = 1 — Number of columns (or a responsive object per breakpoint)
@@ -835,7 +859,13 @@ The container-query wrapper div is preserved to maintain responsive column behav
 - **Transition** — Utilities for managing smooth enter and leave animations with CSS classes
     - `show: boolean` (required) — Whether the content is shown (drives the enter/leave transitions)
     - `children: React.ReactNode` (required) — Content to transition
-    - `preset: "fade" | "scale" | "slide-right" | "slide-left" | "slide-top" | "slide-bottom"` — Preset transition (fade, scale, slide-*)
+    - `preset: "none" | "fade" | "scale" | "slide-right" | "slide-left" | "slide-top" | "slide-bottom"` — Preset transition (fade, scale, slide-*) — 入りと出の両方に効く
+    - `enterPreset: "none" | "fade" | "scale" | "slide-right" | "slide-left" | "slide-top" | "slide-bottom"` — 入りだけ別扱いにしたいときのプリセット。`"none"` で入りのアニメーションを止める。
+省略時は `preset` に従う。
+
+`Drawer` の `slideIn` / `slideOut` のように**片方だけ切りたい** API があるのに、
+`preset` は両相を一括で決めるため表現できなかった（T58）。
+    - `leavePreset: "none" | "fade" | "scale" | "slide-right" | "slide-left" | "slide-top" | "slide-bottom"` — 出だけ別扱いにしたいときのプリセット。`"none"` で出のアニメーションを止める。
     - `enter: string` = "" — Class applied during the enter transition
     - `enterFrom: string` = "" — Class applied at the start of the enter transition
     - `enterTo: string` = "" — Class applied at the end of the enter transition
@@ -2099,8 +2129,17 @@ Useful for URL-based pagination (e.g. wrap with a Link via PaginationPage asChil
     - `asChild: boolean` = false — If true, the card will be rendered as its child, merging its props onto that child.
     - `variant: "elevated" | "outline" | "flat" | "glass"` = "elevated" — Visual style variant of the card
     - `interactive: boolean` = false — Whether to enable hover animation and click effects
-    - `padding: ComponentSize | "none"` = "md" — Padding size
-    - `radius: ComponentSize | "none"` = "lg" — Corner radius size
+    - `padding: (typeof CARD_STYLED_PADDING)[number]` = "md" — Padding size.
+
+Derived from the values `card.module.scss` implements, not from
+`ComponentSize`. Declaring the whole scale meant `padding="5xl"`
+type-checked and then did nothing (T38); deriving it means the type cannot
+drift from the stylesheet again, because `Card.unstyled-values.test.tsx`
+fails if the list stops matching the SCSS.
+    - `radius: (typeof CARD_STYLED_RADIUS)[number]` = "lg" — Corner radius size.
+
+Same derivation as `padding`. There is no `--wim-radius-xs` / `-3xl` /
+`-4xl` / `-5xl` token, so those values had nothing they could have meant.
 - **Carousel** — Content slideshow
     - `children: React.ReactNode` — Content of the carousel
     - `autoPlay: boolean` = false — Whether to auto-play
@@ -2342,8 +2381,17 @@ drops secondary text below the AA contrast floor.
     - `variant: React.ComponentProps<typeof Card>["variant"]` = "elevated" — Visual style variant of the card
     - `asChild: boolean` = false — If true, the card will be rendered as its child, merging its props onto that child.
     - `interactive: boolean` = false — Whether to enable hover animation and click effects
-    - `padding: ComponentSize | "none"` = "md" — Padding size
-    - `radius: ComponentSize | "none"` = "lg" — Corner radius size
+    - `padding: (typeof CARD_STYLED_PADDING)[number]` = "md" — Padding size.
+
+Derived from the values `card.module.scss` implements, not from
+`ComponentSize`. Declaring the whole scale meant `padding="5xl"`
+type-checked and then did nothing (T38); deriving it means the type cannot
+drift from the stylesheet again, because `Card.unstyled-values.test.tsx`
+fails if the list stops matching the SCSS.
+    - `radius: (typeof CARD_STYLED_RADIUS)[number]` = "lg" — Corner radius size.
+
+Same derivation as `padding`. There is no `--wim-radius-xs` / `-3xl` /
+`-4xl` / `-5xl` token, so those values had nothing they could have meant.
 - **SwipeAction** — Mobile-friendly swipe actions (delete, archive) for list items.
     - `as: React.ElementType` = "div" — The element to render as the root container. Default is 'div'.
     - `leftActions: SwipeActionItem[]` = [] — Actions revealed when swiping from left to right

package/dist/llms.txt

@@ -4,7 +4,7 @@
 
 ## What this is
 
-**wimui** v0.12.0 — a React 19 component library: 218 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
+**wimui** v0.14.0 — a React 19 component library: 218 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
 
 ## Install & required setup