wimui 0.31.0 → 0.32.0

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.
@@ -4,7 +4,7 @@
4
4
 
5
5
  ## What this is
6
6
 
7
- **wimui** v0.31.0 — a React 19 component library: 225 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).
7
+ **wimui** v0.32.0 — a React 19 component library: 225 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).
8
8
 
9
9
  ## Install & required setup
10
10
 
@@ -635,6 +635,11 @@ export function RenameWorkspace() {
635
635
  - `children: React.ReactNode` (required) — Child content
636
636
  - **BentoGrid** — Modern card grid (aka Waffle Menu, Bento Menu, Grid Menu, Candy Bar Menu, Chocolate Bar Menu, ベントーメニュー, ワッフルメニュー)
637
637
  - `children: React.ReactNode` — Grid items (typically BentoGrid.Item elements)
638
+ - `columns: 2 | 3 | 4` = 3 — How many columns the grid uses from container width `md` up; below that it is
639
+ always a single column. Pick it from what the tiles hold — three columns is a
640
+ layout decision, not a default to accept, and three equal tiles is the shape
641
+ readers have learnt to skip.
642
+ @default 3
638
643
  - `rowHeight: string` — Fixed height of each grid row (`grid-auto-rows`). Any CSS length; defaults to `18rem`. Lower it when tiles hold compact content so they don't read as mostly-empty panels.
639
644
  - **Box** — Polymorphic box
640
645
  - `as: C` — The component used for the root node. Either a string to use a HTML element or a component.
@@ -757,7 +762,9 @@ The container-query wrapper div is preserved to maintain responsive column behav
757
762
  - `asChild: boolean` — If true, the group will be rendered as its child, merging its props onto that child.
758
763
  - `align: "start" | "center" | "end" | "stretch" | "baseline"` = "center" — Vertical alignment
759
764
  - `justify: "start" | "center" | "end" | "between" | "around" | "evenly"` = "start" — Horizontal alignment
760
- - `gap: number | string` = 16 — Gap between elements
765
+ - `gap: number | string` = "2xl" — Gap between elements: a spacing token name (`"md"`, `"2xl"`, …) or a raw
766
+ number of pixels. Prefer the token so the gap follows the theme.
767
+ @default "2xl"
761
768
  - `wrap: "nowrap" | "wrap" | "wrap-reverse"` = "wrap" — Whether to wrap children
762
769
  - `grow: boolean` = false — Whether items should grow to fill available space
763
770
  - **Header** — Upper navigation
@@ -775,13 +782,22 @@ The container-query wrapper div is preserved to maintain responsive column behav
775
782
  - `variant: "dashed" | "solid" | "none"` = "dashed" — Border variant
776
783
  - `bgVariant: "default" | "transparent" | "muted"` = "default" — Background variant
777
784
  - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size variation
785
+ - `align: "start" | "center"` = "center" — Horizontal alignment of the icon, text and actions. Centred content only reads
786
+ as deliberate when the area is the one thing in its region — a drop target or a
787
+ whole result page. Inside a card, a table or a column of prose, use `"start"`
788
+ so the block lines up with the text around it.
789
+ @default "center"
778
790
  - `isDragging: boolean` = false — Whether the area is currently in a dragging state (for dropzone)
779
791
  - `isClickable: boolean` = false — Whether the area is clickable
780
792
  - `disabled: boolean` = false — Whether the area is disabled
781
793
  - `styles: { inner?: string; icon?: string; title?: string; description?: string; content?: string; actions?: string; }` — Custom styles for internal parts
782
794
  - **Masonry** — Waterfall grid
783
- - `columns: number` = 3 — Number of columns
784
- - `spacing: number | string` = 16 — Spacing between items
795
+ - `columns: number` = 3 — Number of columns. Pick it from how many items there are — three columns
796
+ holding four cards leaves a ragged row that reads as a template, not a choice.
797
+ @default 3
798
+ - `spacing: number | string` = "2xl" — Gap between items: a spacing token name (`"md"`, `"2xl"`, …) or a raw number
799
+ of pixels. Prefer the token so the gap follows the theme.
800
+ @default "2xl"
785
801
  - **Navbar** — Primary navigation
786
802
  - `fixed: boolean` — Whether the navbar is fixed to the viewport
787
803
  - `sticky: boolean` — Whether the navbar sticks to the top while scrolling
@@ -831,7 +847,9 @@ Set `responsive={false}` to keep the sidebar in flow at every width.
831
847
  - `onOverlayClick: () => void` — Callback when overlay is clicked
832
848
  - **SimpleGrid** — Responsive fixed grid
833
849
  - `cols: T | { base?: T; sm?: T; md?: T; lg?: T; xl?: T; }` = 1 — Number of columns (or a responsive object per breakpoint)
834
- - `spacing: number | string` = 16 — Spacing between cells
850
+ - `spacing: number | string` = "2xl" — Spacing between cells: a spacing token name (`"md"`, `"2xl"`, …) or a raw
851
+ number of pixels. Prefer the token so the gap follows the theme.
852
+ @default "2xl"
835
853
  - `verticalSpacing: number | string` — Vertical spacing between rows (defaults to `spacing`)
836
854
  - `minChildWidth: number | string` — Minimum width of each child; columns wrap automatically to fit
837
855
  - **Splitter** — Split and resize panels
package/dist/llms.txt CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  ## What this is
6
6
 
7
- **wimui** v0.31.0 — a React 19 component library: 225 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).
7
+ **wimui** v0.32.0 — a React 19 component library: 225 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).
8
8
 
9
9
  ## Install & required setup
10
10