twico-ui 1.29.0 → 1.31.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.
- package/CHANGELOG.md +19 -0
- package/dist/index.cjs +181 -66
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +32 -0
- package/dist/index.d.ts +32 -0
- package/dist/index.mjs +181 -66
- package/dist/index.mjs.map +1 -1
- package/llms.txt +8 -0
- package/package.json +1 -1
package/llms.txt
CHANGED
|
@@ -602,6 +602,7 @@ Props:
|
|
|
602
602
|
- `virtualized` — `boolean` · default `false` — Virtualize the option list — render only the visible slice (plus overscan) so long lists open fast.
|
|
603
603
|
- `overscan` — `number` · default `8` — Extra option rows rendered above/below the viewport when virtualized, smoothing fast scrolling.
|
|
604
604
|
- `wrapOptions` — `boolean` · default `false` — Wrap long option labels/descriptions onto multiple lines instead of truncating; takes precedence over virtualized.
|
|
605
|
+
- `renderOption` — `(option, state) => React.ReactNode` — Render a custom body per option; twico keeps the row chrome, keyboard nav, and ARIA. Disables virtualized.
|
|
605
606
|
- `required` — `boolean` · default `false` — Adds a required asterisk next to the label, signaling that the user must select a value before submitting.
|
|
606
607
|
- `size` — `"sm" | "md" | "lg"` · default `"md"` — Sets the control height across sm, md, or lg to match the density of the surrounding form.
|
|
607
608
|
- `tone` — `"primary" | "success" | "warning" | "danger" | "info" | "neutral"` · default `"primary"` — Recolors the focus/open accent (border + ring) using one of six semantic intents; defaults to primary.
|
|
@@ -980,6 +981,7 @@ Props:
|
|
|
980
981
|
- `leftAddon` — `React.ReactNode` — Bordered text addon flush against the leading edge (e.g. https://, @), distinct from the inline leftIcon.
|
|
981
982
|
- `rightAddon` — `React.ReactNode` — Bordered text addon flush against the trailing edge (e.g. .00, kg, %).
|
|
982
983
|
- `showCount` — `boolean` · default `false` — With maxLength, renders a live current / max character counter on the hint/error line, danger-toned near the limit.
|
|
984
|
+
- `clearable` — `boolean` · default `false` — Shows a trailing clear ✕ when non-empty; clicking it empties the field and fires onChange with an empty value.
|
|
983
985
|
- `onChange` — `(e: React.ChangeEvent) => void` — Native change handler on the underlying form control.
|
|
984
986
|
- `name` — `string` — Form field name submitted with the value.
|
|
985
987
|
- `placeholder` — `string` — Placeholder text shown while the field is empty.
|
|
@@ -1013,6 +1015,7 @@ Props:
|
|
|
1013
1015
|
- `error` — `React.ReactNode` — Displays a validation error below the control and styles it as invalid to flag a selection problem.
|
|
1014
1016
|
- `virtualized` — `boolean` · default `false` — Virtualize the option list — render only the visible slice (plus overscan) so long lists open fast.
|
|
1015
1017
|
- `overscan` — `number` · default `8` — Extra option rows rendered above/below the viewport when virtualized, smoothing fast scrolling.
|
|
1018
|
+
- `renderOption` — `(option, state) => React.ReactNode` — Render a custom body per option; twico keeps the checkbox, keyboard nav, and ARIA. Disables virtualized.
|
|
1016
1019
|
- `required` — `boolean` · default `false` — Marks the field as required and adds an asterisk to the label to signal a mandatory selection; defaults to false.
|
|
1017
1020
|
- `placeholder` — `string` · default `"Select…"` — Sets the prompt text shown when no chips are selected, defaulting to "Select…" to invite a choice.
|
|
1018
1021
|
- `value` — `string[]` — Controls the selected values as a string array, making the component fully controlled when paired with onChange.
|
|
@@ -1134,6 +1137,7 @@ Props:
|
|
|
1134
1137
|
- `error` — `React.ReactNode` — Displays an error message and marks the field invalid, replacing the hint to flag failed validation.
|
|
1135
1138
|
- `virtualized` — `boolean` · default `false` — Virtualize the option list — render only the visible slice (plus overscan) so long lists open fast.
|
|
1136
1139
|
- `overscan` — `number` · default `8` — Extra option rows rendered above/below the viewport when virtualized, smoothing fast scrolling.
|
|
1140
|
+
- `renderOption` — `(option, state) => React.ReactNode` — Render a custom body per option; twico keeps the row chrome, checkmark, and ARIA. Disables virtualized.
|
|
1137
1141
|
- `required` — `boolean` · default `false` — Appends a required asterisk to the label, signaling that a selection must be made before submitting.
|
|
1138
1142
|
- `size` — `"sm" | "md" | "lg"` · default `"md"` — Controls the trigger height (sm, md, or lg) to match the density of nearby form controls, defaulting to md.
|
|
1139
1143
|
- `tone` — `"primary" | "success" | "warning" | "danger" | "info" | "neutral"` · default `"primary"` — Recolors the focus/open accent (border + ring) using one of six semantic intents; defaults to primary.
|
|
@@ -1272,6 +1276,7 @@ Props:
|
|
|
1272
1276
|
- `minRows` — `number` — Minimum rows when autosize is on (falls back to rows).
|
|
1273
1277
|
- `maxRows` — `number` — Maximum rows when autosize is on; taller content scrolls internally.
|
|
1274
1278
|
- `showCount` — `boolean` · default `false` — With maxLength, renders a live current / max character counter, danger-toned near the limit.
|
|
1279
|
+
- `clearable` — `boolean` · default `false` — Shows a top-inline-end clear ✕ when non-empty; clicking it empties the field and fires onChange with an empty value.
|
|
1275
1280
|
- `onChange` — `(e: React.ChangeEvent) => void` — Native change handler on the underlying form control.
|
|
1276
1281
|
- `name` — `string` — Form field name submitted with the value.
|
|
1277
1282
|
- `placeholder` — `string` — Placeholder text shown while the field is empty.
|
|
@@ -1617,6 +1622,9 @@ Props:
|
|
|
1617
1622
|
- `searchable` — `boolean` · default `true` — Render the built-in toolbar quick-search box; set false to externalize search with your own input wired to quickFilter (CardGrid parity).
|
|
1618
1623
|
- `quickFilter` — `string` — Controlled quick-search string; pair with onQuickFilterChange to drive search from outside (the value flows into client filtering and the onServerChange query).
|
|
1619
1624
|
- `onQuickFilterChange` — `(value: string) => void` — Fires with the new quick-search string as the user types in the built-in box (and when a host sets it).
|
|
1625
|
+
- `filterLogic` — `"and" | "or"` — Controlled And/Or connective between filter conditions — a single set-wide operator (MUI DataGrid-style); pair with onFilterLogicChange. Omit for uncontrolled (see defaultFilterLogic).
|
|
1626
|
+
- `defaultFilterLogic` — `"and" | "or"` · default `"and"` — Initial And/Or connective for the filter conditions when filterLogic is left uncontrolled.
|
|
1627
|
+
- `onFilterLogicChange` — `(logic: "and" | "or") => void` — Fires with the new connective when the user changes the per-row And/Or connector in the Filters panel.
|
|
1620
1628
|
- `toolbarActions` — `React.ReactNode` — Custom node rendered in a leading toolbar slot, before the built-in Columns/Filters cluster — for host controls like an "Add row" button or bulk actions. Mirrors CardGrid's toolbar prop, so no internal-class or absolute-position hacks are needed.
|
|
1621
1629
|
- `resizableFilters` — `boolean` · default `true` — Let the user drag-resize the Filters popover and its column/operator/value fields, layered over the auto-fit (a dragged width overrides the measured one; reset returns to it). Widths + panel size persist via stateKey and are keyboard-accessible. Set false to hide the handles/grip (fields still auto-fit).
|
|
1622
1630
|
- `filterFieldMaxWidth` — `number` — Raise the drag cap for the filter panel's column/operator fields, in px (defaults: column 360, operator 260). Only applies when resizableFilters is on.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "twico-ui",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.31.0",
|
|
4
4
|
"description": "Twico UI — a free, modern, themeable React + Tailwind-friendly component library. 61 components with dark mode, motion, and accessibility built in.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Twico UI",
|