@wirecore/wirelayer-react 0.11.0 → 0.12.1

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.
Files changed (110) hide show
  1. package/dist/CopyButton-C_LAuCkR.js +47 -0
  2. package/dist/Tree-DLHbcH3-.js +602 -0
  3. package/dist/chart/Chart.d.ts +3 -3
  4. package/dist/chart/Chart.d.ts.map +1 -1
  5. package/dist/chart/PieChart.d.ts +3 -3
  6. package/dist/chart/PieChart.d.ts.map +1 -1
  7. package/dist/chart/SeriesChartView.d.ts +1 -1
  8. package/dist/chart/SeriesChartView.d.ts.map +1 -1
  9. package/dist/chart/Sparkline.d.ts +3 -3
  10. package/dist/chart/Sparkline.d.ts.map +1 -1
  11. package/dist/chart/WaterfallChart.d.ts +3 -3
  12. package/dist/chart/WaterfallChart.d.ts.map +1 -1
  13. package/dist/chart/types.d.ts +2 -2
  14. package/dist/chart/types.d.ts.map +1 -1
  15. package/dist/chart.js +148 -143
  16. package/dist/code.js +1 -1
  17. package/dist/components/AngleSlider/AngleSlider.d.ts +3 -3
  18. package/dist/components/AngleSlider/AngleSlider.d.ts.map +1 -1
  19. package/dist/components/BlockUi/BlockUi.d.ts +3 -3
  20. package/dist/components/BlockUi/BlockUi.d.ts.map +1 -1
  21. package/dist/components/Calendar/Calendar.d.ts +3 -3
  22. package/dist/components/Calendar/Calendar.d.ts.map +1 -1
  23. package/dist/components/Carousel/Carousel.d.ts +3 -3
  24. package/dist/components/Carousel/Carousel.d.ts.map +1 -1
  25. package/dist/components/CascadeSelect/CascadeSelect.d.ts +4 -3
  26. package/dist/components/CascadeSelect/CascadeSelect.d.ts.map +1 -1
  27. package/dist/components/ColorPicker/ColorPicker.d.ts +4 -4
  28. package/dist/components/ColorPicker/ColorPicker.d.ts.map +1 -1
  29. package/dist/components/CopyButton/CopyButton.d.ts +3 -3
  30. package/dist/components/CopyButton/CopyButton.d.ts.map +1 -1
  31. package/dist/components/DataView/DataView.d.ts +3 -3
  32. package/dist/components/DataView/DataView.d.ts.map +1 -1
  33. package/dist/components/Fieldset/Fieldset.d.ts +5 -3
  34. package/dist/components/Fieldset/Fieldset.d.ts.map +1 -1
  35. package/dist/components/Gallery/Gallery.d.ts +3 -3
  36. package/dist/components/Gallery/Gallery.d.ts.map +1 -1
  37. package/dist/components/JsonViewer/JsonViewer.d.ts +4 -3
  38. package/dist/components/JsonViewer/JsonViewer.d.ts.map +1 -1
  39. package/dist/components/Knob/Knob.d.ts +4 -3
  40. package/dist/components/Knob/Knob.d.ts.map +1 -1
  41. package/dist/components/Listbox/Listbox.d.ts +4 -4
  42. package/dist/components/Listbox/Listbox.d.ts.map +1 -1
  43. package/dist/components/LogViewer/LogViewer.d.ts +3 -3
  44. package/dist/components/LogViewer/LogViewer.d.ts.map +1 -1
  45. package/dist/components/MeterGroup/MeterGroup.d.ts +3 -3
  46. package/dist/components/MeterGroup/MeterGroup.d.ts.map +1 -1
  47. package/dist/components/NavigationMenu/NavigationMenu.d.ts +3 -3
  48. package/dist/components/NavigationMenu/NavigationMenu.d.ts.map +1 -1
  49. package/dist/components/OrderList/OrderList.d.ts +3 -3
  50. package/dist/components/OrderList/OrderList.d.ts.map +1 -1
  51. package/dist/components/OrgChart/OrgChart.d.ts +3 -3
  52. package/dist/components/OrgChart/OrgChart.d.ts.map +1 -1
  53. package/dist/components/Panel/Panel.d.ts +3 -3
  54. package/dist/components/Panel/Panel.d.ts.map +1 -1
  55. package/dist/components/PickList/PickList.d.ts +3 -3
  56. package/dist/components/PickList/PickList.d.ts.map +1 -1
  57. package/dist/components/PinInput/PinInput.d.ts +4 -4
  58. package/dist/components/PinInput/PinInput.d.ts.map +1 -1
  59. package/dist/components/ProgressCircle/ProgressCircle.d.ts +3 -3
  60. package/dist/components/ProgressCircle/ProgressCircle.d.ts.map +1 -1
  61. package/dist/components/Rating/Rating.d.ts +3 -3
  62. package/dist/components/Rating/Rating.d.ts.map +1 -1
  63. package/dist/components/ScrollPanel/ScrollPanel.d.ts +3 -3
  64. package/dist/components/ScrollPanel/ScrollPanel.d.ts.map +1 -1
  65. package/dist/components/ScrollTop/ScrollTop.d.ts +3 -2
  66. package/dist/components/ScrollTop/ScrollTop.d.ts.map +1 -1
  67. package/dist/components/SidebarNav/SidebarNav.d.ts +3 -3
  68. package/dist/components/SidebarNav/SidebarNav.d.ts.map +1 -1
  69. package/dist/components/SignaturePad/SignaturePad.d.ts +3 -3
  70. package/dist/components/SignaturePad/SignaturePad.d.ts.map +1 -1
  71. package/dist/components/Sortable/Sortable.d.ts +9 -3
  72. package/dist/components/Sortable/Sortable.d.ts.map +1 -1
  73. package/dist/components/SpeedDial/SpeedDial.d.ts +3 -3
  74. package/dist/components/SpeedDial/SpeedDial.d.ts.map +1 -1
  75. package/dist/components/SplitButton/SplitButton.d.ts +3 -3
  76. package/dist/components/SplitButton/SplitButton.d.ts.map +1 -1
  77. package/dist/components/Splitter/Splitter.d.ts +3 -3
  78. package/dist/components/Splitter/Splitter.d.ts.map +1 -1
  79. package/dist/components/Spoiler/Spoiler.d.ts +3 -3
  80. package/dist/components/Spoiler/Spoiler.d.ts.map +1 -1
  81. package/dist/components/Stepper/Stepper.d.ts +3 -3
  82. package/dist/components/Stepper/Stepper.d.ts.map +1 -1
  83. package/dist/components/TableOfContents/TableOfContents.d.ts +3 -3
  84. package/dist/components/TableOfContents/TableOfContents.d.ts.map +1 -1
  85. package/dist/components/Timeline/Timeline.d.ts +3 -3
  86. package/dist/components/Timeline/Timeline.d.ts.map +1 -1
  87. package/dist/components/Toolbar/Toolbar.d.ts +3 -3
  88. package/dist/components/Toolbar/Toolbar.d.ts.map +1 -1
  89. package/dist/components/Tour/Tour.d.ts +10 -1
  90. package/dist/components/Tour/Tour.d.ts.map +1 -1
  91. package/dist/components/Tree/Tree.d.ts +3 -3
  92. package/dist/components/Tree/Tree.d.ts.map +1 -1
  93. package/dist/components/Tree/useTree.d.ts +2 -0
  94. package/dist/components/Tree/useTree.d.ts.map +1 -1
  95. package/dist/components/TreeSelect/TreeSelect.d.ts +4 -4
  96. package/dist/components/TreeSelect/TreeSelect.d.ts.map +1 -1
  97. package/dist/data-table.js +1 -1
  98. package/dist/editor/Editor.d.ts +4 -4
  99. package/dist/editor/Editor.d.ts.map +1 -1
  100. package/dist/editor.js +184 -183
  101. package/dist/index.js +2903 -2779
  102. package/dist/pdf.js +1 -1
  103. package/dist/virtual/VirtualList.d.ts +3 -3
  104. package/dist/virtual/VirtualList.d.ts.map +1 -1
  105. package/dist/virtual/VirtualTree.d.ts.map +1 -1
  106. package/dist/virtual.js +224 -219
  107. package/llms-full.txt +70 -10
  108. package/package.json +2 -2
  109. package/dist/CopyButton-0e1pHR3f.js +0 -45
  110. package/dist/Tree-DVjwp6FG.js +0 -568
package/llms-full.txt CHANGED
@@ -131,6 +131,7 @@ Dial for an angle: the needle is the slider (arrow keys, Home/End), drag anywher
131
131
  - Import: `import { AngleSlider } from '@wirecore/wirelayer-react'`
132
132
  - Category: Forms
133
133
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_forms-angleslider--playground
134
+ - Also takes: Omit<ComponentProps<'div'>, 'defaultValue' | 'value'>
134
135
 
135
136
  | Prop | Type | Description |
136
137
  | --- | --- | --- |
@@ -419,6 +420,7 @@ While blocked: the content is inert (no focus, no clicks) and busy; the overlay
419
420
  - Import: `import { BlockUi } from '@wirecore/wirelayer-react'`
420
421
  - Category: Layout
421
422
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_layout-blockui--playground
423
+ - Also takes: ComponentProps<'div'>
422
424
 
423
425
  | Prop | Type | Description |
424
426
  | --- | --- | --- |
@@ -557,6 +559,7 @@ Calendar on the page (no field, no popup): a grid with arrow keys, Page Up/Down,
557
559
  - Import: `import { Calendar } from '@wirecore/wirelayer-react'`
558
560
  - Category: Forms
559
561
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_forms-calendar--playground
562
+ - Also takes: Omit< ComponentProps<'div'>, 'defaultValue' | 'value' >
560
563
 
561
564
  | Prop | Type | Description |
562
565
  | --- | --- | --- |
@@ -616,6 +619,7 @@ Region "carousel" with slides labelled "Image n of m". Previous/next buttons, on
616
619
  - Import: `import { Carousel } from '@wirecore/wirelayer-react'`
617
620
  - Category: Media
618
621
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_media-carousel--playground
622
+ - Also takes: Omit<ComponentProps<'div'>, 'children'>
619
623
 
620
624
  | Prop | Type | Description |
621
625
  | --- | --- | --- |
@@ -647,6 +651,7 @@ Select with cascading levels: a menu whose groups open to the side (arrow right/
647
651
  - Import: `import { CascadeSelect } from '@wirecore/wirelayer-react'`
648
652
  - Category: Forms
649
653
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_forms-cascadeselect--playground
654
+ - Also takes: Omit< ComponentProps<'div'>, 'defaultValue' | 'value' | 'onSelect' >
650
655
 
651
656
  | Prop | Type | Description |
652
657
  | --- | --- | --- |
@@ -668,7 +673,7 @@ Select with cascading levels: a menu whose groups open to the side (arrow right/
668
673
  | loadChildren? | `(option: CascadeOption<V>, request: { signal: AbortSignal }) => Promise<CascadeOption<V>[]>` | Loads the options of a level (`hasChildren: true`) when it opens; the signal aborts it |
669
674
  | onLoadChildren? | `(option: CascadeOption<V>) => void` | A lazy level opened and there is no loadChildren/dataSource: add its options to the items |
670
675
  | dataSource? | `DataSource<CascadeOption<V>>` | Source of the options of lazy levels (`getChildren`) |
671
- | aria-label? | `string` | |
676
+ | aria-label? | `string` | Accessible name of the field without a surrounding Field (not of the outer element) |
672
677
  | id? | `string` | Id of the field (the trigger, with `filter` the search field), e.g. for a `<label for>` |
673
678
  | className? | `string` | |
674
679
  | style? | `CSSProperties` | |
@@ -695,6 +700,7 @@ Canvas with role="img" named by the title; the data table is its text alternativ
695
700
  - Import: `import { Chart } from '@wirecore/wirelayer-react/chart'`
696
701
  - Category: Data
697
702
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_data-chart--playground
703
+ - Also takes: Omit<ComponentProps<'figure'>, 'title' | 'type'>
698
704
 
699
705
  | Prop | Type | Description |
700
706
  | --- | --- | --- |
@@ -1055,6 +1061,7 @@ Colour field: the button opens a panel with area, hue (and opacity) slider, hex
1055
1061
  - Import: `import { ColorPicker } from '@wirecore/wirelayer-react'`
1056
1062
  - Category: Forms
1057
1063
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_forms-colorpicker--playground
1064
+ - Also takes: Omit<ComponentProps<'div'>, 'defaultValue' | 'value'>
1058
1065
 
1059
1066
  | Prop | Type | Description |
1060
1067
  | --- | --- | --- |
@@ -1072,7 +1079,7 @@ Colour field: the button opens a panel with area, hue (and opacity) slider, hex
1072
1079
  | readOnly? | `boolean` | |
1073
1080
  | invalid? | `boolean` | |
1074
1081
  | name? | `string` | |
1075
- | aria-label? | `string` | Accessible name without a surrounding Field |
1082
+ | aria-label? | `string` | Accessible name of the button without a surrounding Field (not of the outer element) |
1076
1083
  | id? | `string` | Id of the field (the button), e.g. for a `<label for>` |
1077
1084
  | className? | `string` | |
1078
1085
  | style? | `CSSProperties` | |
@@ -1331,6 +1338,7 @@ Copies the value; the icon turns into a check and "Copied to clipboard" is annou
1331
1338
  - Import: `import { CopyButton } from '@wirecore/wirelayer-react'`
1332
1339
  - Category: Buttons
1333
1340
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_buttons-copybutton--playground
1341
+ - Also takes: Omit<ComponentProps<'div'>, 'defaultValue' | 'value'>
1334
1342
 
1335
1343
  | Prop | Type | Description |
1336
1344
  | --- | --- | --- |
@@ -1557,6 +1565,7 @@ Items as a list or grid (a list either way); the switch is a radio group "View"
1557
1565
  - Import: `import { DataView } from '@wirecore/wirelayer-react'`
1558
1566
  - Category: Data
1559
1567
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_data-dataview--playground
1568
+ - Also takes: Omit<ComponentProps<'div'>, 'children'>
1560
1569
 
1561
1570
  | Prop | Type | Description |
1562
1571
  | --- | --- | --- |
@@ -1935,6 +1944,7 @@ Rich-text editor (Tiptap): a toolbar (role="toolbar", one tab stop, arrow keys i
1935
1944
  - Import: `import { Editor } from '@wirecore/wirelayer-react/editor'`
1936
1945
  - Category: Forms
1937
1946
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_forms-editor--playground
1947
+ - Also takes: Omit<ComponentProps<'div'>, 'defaultValue' | 'value'>
1938
1948
 
1939
1949
  | Prop | Type | Description |
1940
1950
  | --- | --- | --- |
@@ -1954,7 +1964,7 @@ Rich-text editor (Tiptap): a toolbar (role="toolbar", one tab stop, arrow keys i
1954
1964
  | floatingMenu? | `boolean \| EditorTool[]` | Menu in an empty line – true for the default tools or a list of tools; Alt+F10 moves into it |
1955
1965
  | tableOfContents? | `boolean` | The headings as links above the text |
1956
1966
  | mentions? | `(query: string) => EditorMention[] \| Promise<EditorMention[]>` | Suggestions after "@" (people, documents …) – inserted as a mention |
1957
- | aria-label? | `string` | Accessible name without a Field |
1967
+ | aria-label? | `string` | Accessible name of the text box without a Field (not of the outer element) |
1958
1968
  | className? | `string` | |
1959
1969
  | style? | `CSSProperties` | |
1960
1970
  | classes? | `RecipeClasses<typeof editorRecipe>` | Extra classes per part of the component, e.g. { base: "…" } (see the recipe) |
@@ -2042,10 +2052,12 @@ Label, helper text and error for one input – connects them by ids (aria-descri
2042
2052
  - Import: `import { Fieldset } from '@wirecore/wirelayer-react'`
2043
2053
  - Category: Forms
2044
2054
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_forms-fieldset--playground
2055
+ - Also takes: ComponentProps<'fieldset'>
2045
2056
 
2046
2057
  | Prop | Type | Description |
2047
2058
  | --- | --- | --- |
2048
2059
  | legend | `string` | |
2060
+ | id? | `string` | Base of the ids of the legend and the texts (Ark) – unlike other attributes, not the fieldset's own id |
2049
2061
  | helperText? | `string` | |
2050
2062
  | errorText? | `string` | Error of the whole group (e.g. "Please choose an option") |
2051
2063
  | invalid? | `boolean` | |
@@ -2341,6 +2353,7 @@ Carousel of pictures with thumbnails (aria-current marks the shown one) and an o
2341
2353
  - Import: `import { Gallery } from '@wirecore/wirelayer-react'`
2342
2354
  - Category: Media
2343
2355
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_media-gallery--playground
2356
+ - Also takes: ComponentProps<'div'>
2344
2357
 
2345
2358
  | Prop | Type | Description |
2346
2359
  | --- | --- | --- |
@@ -2719,6 +2732,7 @@ JSON as a tree (role="tree"): arrow keys open and close, typing jumps to a key;
2719
2732
  - Import: `import { JsonViewer } from '@wirecore/wirelayer-react'`
2720
2733
  - Category: Data
2721
2734
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_data-jsonviewer--playground
2735
+ - Also takes: Omit<ComponentProps<'div'>, 'onCopy'>
2722
2736
 
2723
2737
  | Prop | Type | Description |
2724
2738
  | --- | --- | --- |
@@ -2729,7 +2743,7 @@ JSON as a tree (role="tree"): arrow keys open and close, typing jumps to a key;
2729
2743
  | copyable? | `boolean` | Copy button per node (and Ctrl+C on the focused node, default true) |
2730
2744
  | showTypes? | `boolean` | Shows the type of every value as text (otherwise only for screen readers) |
2731
2745
  | onCopy? | `(path: string, text: string) => void` | A value was copied: its path and the copied text |
2732
- | aria-label? | `string` | |
2746
+ | aria-label? | `string` | Accessible name of the tree, like `label` (not of the outer element) |
2733
2747
  | className? | `string` | |
2734
2748
  | style? | `CSSProperties` | |
2735
2749
  | classes? | `RecipeClasses<typeof jsonViewerRecipe>` | Extra classes per part of the component, e.g. { base: "…" } (see the recipe) |
@@ -2802,6 +2816,7 @@ Dial (270°): a slider – arrow keys, Page Up/Down, Home/End, or drag around th
2802
2816
  - Import: `import { Knob } from '@wirecore/wirelayer-react'`
2803
2817
  - Category: Forms
2804
2818
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_forms-knob--playground
2819
+ - Also takes: Omit<ComponentProps<'div'>, 'color' | 'defaultValue' | 'value'>
2805
2820
 
2806
2821
  | Prop | Type | Description |
2807
2822
  | --- | --- | --- |
@@ -2812,7 +2827,7 @@ Dial (270°): a slider – arrow keys, Page Up/Down, Home/End, or drag around th
2812
2827
  | max? | `number` | |
2813
2828
  | step? | `number` | |
2814
2829
  | label? | `string` | Visible label, also the accessible name |
2815
- | aria-label? | `string` | |
2830
+ | aria-label? | `string` | Accessible name of the dial without `label` (not of the outer element) |
2816
2831
  | id? | `string` | Id of the dial (the slider); a `<label for>` cannot name it, use `label`, a Field or aria-label |
2817
2832
  | formatValue? | `(value: number) => string` | Formats the shown and announced value, e.g. (v) => `${v} %` |
2818
2833
  | valueTemplate? | `string` | Text with the value in it, e.g. "{value} %" (when there is no formatValue) |
@@ -2862,12 +2877,13 @@ Always visible list (role="listbox"): arrow keys move, Enter/Space choose, typin
2862
2877
  - Import: `import { Listbox } from '@wirecore/wirelayer-react'`
2863
2878
  - Category: Forms
2864
2879
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_forms-listbox--playground
2880
+ - Also takes: Omit< ComponentProps<'div'>, 'defaultValue' | 'value' | 'onSelect' >
2865
2881
 
2866
2882
  | Prop | Type | Description |
2867
2883
  | --- | --- | --- |
2868
2884
  | items | `readonly T[]` | Options: ListboxItem objects – or any objects or values, read with itemValue/itemLabel/itemDisabled/itemGroup |
2869
2885
  | label? | `string` | Visible label, also the list's accessible name |
2870
- | aria-label? | `string` | Accessible name without a visible label |
2886
+ | aria-label? | `string` | Accessible name of the list without a visible label (not of the outer element) |
2871
2887
  | id? | `string` | Id of the root element; a `<label for>` cannot name the list box, use a Field or aria-label |
2872
2888
  | multiple? | `boolean` | Several options can be chosen (Space toggles) |
2873
2889
  | value? | `V[]` | Chosen values; any type (string, number, boolean, object) |
@@ -2930,6 +2946,7 @@ Log: a scrollable, focusable area (arrow keys scroll) with numbered lines; level
2930
2946
  - Import: `import { LogViewer } from '@wirecore/wirelayer-react'`
2931
2947
  - Category: Data
2932
2948
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_data-logviewer--playground
2949
+ - Also takes: ComponentProps<'div'>
2933
2950
 
2934
2951
  | Prop | Type | Description |
2935
2952
  | --- | --- | --- |
@@ -3142,6 +3159,7 @@ One bar for the parts (visual), the legend lists every part with its value as te
3142
3159
  - Import: `import { MeterGroup } from '@wirecore/wirelayer-react'`
3143
3160
  - Category: Data
3144
3161
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_data-metergroup--playground
3162
+ - Also takes: ComponentProps<'div'>
3145
3163
 
3146
3164
  | Prop | Type | Description |
3147
3165
  | --- | --- | --- |
@@ -3305,6 +3323,7 @@ Website navigation (nav landmark): entries with children are buttons (aria-expan
3305
3323
  - Import: `import { NavigationMenu } from '@wirecore/wirelayer-react'`
3306
3324
  - Category: Navigation
3307
3325
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_navigation-navigationmenu--playground
3326
+ - Also takes: Omit<ComponentProps<'nav'>, 'defaultValue'>
3308
3327
 
3309
3328
  | Prop | Type | Description |
3310
3329
  | --- | --- | --- |
@@ -3421,6 +3440,7 @@ Choose an item, then move it with the buttons (or Alt + arrow keys); the new pos
3421
3440
  - Import: `import { OrderList } from '@wirecore/wirelayer-react'`
3422
3441
  - Category: Data
3423
3442
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_data-orderlist--playground
3443
+ - Also takes: Omit< ComponentProps<'div'>, 'defaultValue' | 'draggable' | 'value' >
3424
3444
 
3425
3445
  | Prop | Type | Description |
3426
3446
  | --- | --- | --- |
@@ -3446,6 +3466,7 @@ Hierarchy as nested lists – screen readers read the structure, the lines are d
3446
3466
  - Import: `import { OrgChart } from '@wirecore/wirelayer-react'`
3447
3467
  - Category: Data
3448
3468
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_data-orgchart--playground
3469
+ - Also takes: ComponentProps<'div'>
3449
3470
 
3450
3471
  | Prop | Type | Description |
3451
3472
  | --- | --- | --- |
@@ -3568,6 +3589,7 @@ Card with a heading (and actions); toggleable: the heading holds a button with a
3568
3589
  - Import: `import { Panel } from '@wirecore/wirelayer-react'`
3569
3590
  - Category: Layout
3570
3591
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_layout-panel--playground
3592
+ - Also takes: ComponentProps<'div'>
3571
3593
 
3572
3594
  | Prop | Type | Description |
3573
3595
  | --- | --- | --- |
@@ -3697,6 +3719,7 @@ Two lists with several choices each; the buttons move the chosen items across, t
3697
3719
  - Import: `import { PickList } from '@wirecore/wirelayer-react'`
3698
3720
  - Category: Data
3699
3721
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_data-picklist--playground
3722
+ - Also takes: Omit< ComponentProps<'div'>, 'defaultValue' | 'draggable' | 'value' >
3700
3723
 
3701
3724
  | Prop | Type | Description |
3702
3725
  | --- | --- | --- |
@@ -3730,6 +3753,7 @@ Pie or doughnut on a canvas named by the title; the legend lists value and share
3730
3753
  - Import: `import { PieChart } from '@wirecore/wirelayer-react/chart'`
3731
3754
  - Category: Data
3732
3755
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_data-piechart--playground
3756
+ - Also takes: ComponentProps<'figure'>
3733
3757
 
3734
3758
  | Prop | Type | Description |
3735
3759
  | --- | --- | --- |
@@ -3753,6 +3777,7 @@ Code input (OTP, PIN): one box per character, typing moves on, pasting fills all
3753
3777
  - Import: `import { PinInput } from '@wirecore/wirelayer-react'`
3754
3778
  - Category: Forms
3755
3779
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_forms-pininput--playground
3780
+ - Also takes: Omit<ComponentProps<'div'>, 'defaultValue' | 'type' | 'value'>
3756
3781
 
3757
3782
  | Prop | Type | Description |
3758
3783
  | --- | --- | --- |
@@ -3768,7 +3793,7 @@ Code input (OTP, PIN): one box per character, typing moves on, pasting fills all
3768
3793
  | invalid? | `boolean` | |
3769
3794
  | disabled? | `boolean` | |
3770
3795
  | name? | `string` | |
3771
- | aria-label? | `string` | Accessible name of the group without a surrounding Field |
3796
+ | aria-label? | `string` | Accessible name of the group of boxes without a surrounding Field (not of the outer element) |
3772
3797
  | id? | `string` | Id of the root element; a `<label for>` cannot name the PIN input, use a Field or aria-label |
3773
3798
  | className? | `string` | |
3774
3799
  | style? | `CSSProperties` | |
@@ -3869,6 +3894,7 @@ Ring with the value in the middle; a progressbar named by its label, the value a
3869
3894
  - Import: `import { ProgressCircle } from '@wirecore/wirelayer-react'`
3870
3895
  - Category: Feedback
3871
3896
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_feedback-progresscircle--playground
3897
+ - Also takes: Omit<ComponentProps<'div'>, 'defaultValue' | 'value'>
3872
3898
 
3873
3899
  | Prop | Type | Description |
3874
3900
  | --- | --- | --- |
@@ -4012,6 +4038,7 @@ Star rating: a radio group – arrow keys change the value, each star reads "3 s
4012
4038
  - Import: `import { Rating } from '@wirecore/wirelayer-react'`
4013
4039
  - Category: Forms
4014
4040
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_forms-rating--playground
4041
+ - Also takes: Omit<ComponentProps<'div'>, 'defaultValue' | 'value'>
4015
4042
 
4016
4043
  | Prop | Type | Description |
4017
4044
  | --- | --- | --- |
@@ -4212,6 +4239,7 @@ Native scrolling with slim scrollbars; the viewport is a named, focusable region
4212
4239
  - Import: `import { ScrollPanel } from '@wirecore/wirelayer-react'`
4213
4240
  - Category: Layout
4214
4241
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_layout-scrollpanel--playground
4242
+ - Also takes: ComponentProps<'div'>
4215
4243
 
4216
4244
  | Prop | Type | Description |
4217
4245
  | --- | --- | --- |
@@ -4233,6 +4261,7 @@ Hidden (and out of the tab order) until the page is scrolled down
4233
4261
  - Import: `import { ScrollTop } from '@wirecore/wirelayer-react'`
4234
4262
  - Category: Navigation
4235
4263
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_navigation-scrolltop--playground
4264
+ - Also takes: Omit<ComponentProps<'button'>, 'children' | 'color'>
4236
4265
 
4237
4266
  | Prop | Type | Description |
4238
4267
  | --- | --- | --- |
@@ -4381,6 +4410,7 @@ Navigation landmark with links and expandable groups (buttons with aria-expanded
4381
4410
  - Import: `import { SidebarNav } from '@wirecore/wirelayer-react'`
4382
4411
  - Category: Navigation
4383
4412
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_navigation-sidebarnav--playground
4413
+ - Also takes: ComponentProps<'nav'>
4384
4414
 
4385
4415
  | Prop | Type | Description |
4386
4416
  | --- | --- | --- |
@@ -4405,6 +4435,7 @@ Signature field (role="application"): draw with mouse, pen or finger; "Undo" rem
4405
4435
  - Import: `import { SignaturePad } from '@wirecore/wirelayer-react'`
4406
4436
  - Category: Forms
4407
4437
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_forms-signaturepad--playground
4438
+ - Also takes: Omit<ComponentProps<'div'>, 'color' | 'value'>
4408
4439
 
4409
4440
  | Prop | Type | Description |
4410
4441
  | --- | --- | --- |
@@ -4535,6 +4566,7 @@ Sortable list: every item has a handle – drag it, or press Space/Enter, move w
4535
4566
  - Import: `import { Sortable } from '@wirecore/wirelayer-react'`
4536
4567
  - Category: Data
4537
4568
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_data-sortable--playground
4569
+ - Also takes: Omit<ComponentProps<'div'>, 'defaultValue' | 'value'>
4538
4570
 
4539
4571
  | Prop | Type | Description |
4540
4572
  | --- | --- | --- |
@@ -4550,11 +4582,12 @@ Sortable list: every item has a handle – drag it, or press Space/Enter, move w
4550
4582
  | orientation? | `SortableOrientation` | vertical (default), horizontal or grid (with `columns`) |
4551
4583
  | columns? | `number` | Columns of the grid |
4552
4584
  | accepts? | `(item: T, from: string) => boolean` | Whether an item from another list of the group may come in |
4585
+ | clone? | `(item: T) => unknown` | Makes the list a source (e.g. a palette): dragging an item out copies it – this function makes the copy, e.g. with a new id. The list keeps its items, takes none in and is not sorted. |
4553
4586
  | animate? | `boolean` | Items glide to their new place when they move (default: yes; not with reduced motion) |
4554
4587
  | disabled? | `boolean` | |
4555
4588
  | emptyText? | `string` | Text of an empty list (it stays a drop target) |
4556
4589
  | renderItem? | `(item: T, state: { index: number; grabbed: boolean }) => ReactNode` | Content of an item (default: its text) |
4557
- | aria-label? | `string` | |
4590
+ | aria-label? | `string` | Name of the list without `label` – on the list, not the outer element like other attributes |
4558
4591
  | className? | `string` | |
4559
4592
  | style? | `CSSProperties` | |
4560
4593
  | classes? | `RecipeClasses<typeof sortableRecipe>` | Extra classes per part of the component, e.g. { base: "…" } (see the recipe) |
@@ -4566,6 +4599,7 @@ Small line without axes; the canvas is an image named by the trend and the extre
4566
4599
  - Import: `import { Sparkline } from '@wirecore/wirelayer-react/chart'`
4567
4600
  - Category: Data
4568
4601
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_data-sparkline--playground
4602
+ - Also takes: ComponentProps<'span'>
4569
4603
 
4570
4604
  | Prop | Type | Description |
4571
4605
  | --- | --- | --- |
@@ -4586,6 +4620,7 @@ A menu button: the actions open above it (or in a circle around it) as menu item
4586
4620
  - Import: `import { SpeedDial } from '@wirecore/wirelayer-react'`
4587
4621
  - Category: Buttons
4588
4622
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_buttons-speeddial--playground
4623
+ - Also takes: Omit<ComponentProps<'button'>, 'onSelect' | 'value'>
4589
4624
 
4590
4625
  | Prop | Type | Description |
4591
4626
  | --- | --- | --- |
@@ -4622,6 +4657,7 @@ Main action plus a menu with the other actions; both are separate buttons
4622
4657
  - Import: `import { SplitButton } from '@wirecore/wirelayer-react'`
4623
4658
  - Category: Buttons
4624
4659
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_buttons-splitbutton--playground
4660
+ - Also takes: Omit<ComponentProps<'div'>, 'color' | 'onClick' | 'onSelect'>
4625
4661
 
4626
4662
  | Prop | Type | Description |
4627
4663
  | --- | --- | --- |
@@ -4647,6 +4683,7 @@ Panels with handles between them (role="separator"): drag, or arrow keys (Shift
4647
4683
  - Import: `import { Splitter } from '@wirecore/wirelayer-react'`
4648
4684
  - Category: Layout
4649
4685
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_layout-splitter--playground
4686
+ - Also takes: Omit<ComponentProps<'div'>, 'children'>
4650
4687
 
4651
4688
  | Prop | Type | Description |
4652
4689
  | --- | --- | --- |
@@ -4671,6 +4708,7 @@ Content cut to maxHeight; the button (aria-expanded) shows the rest. Hidden text
4671
4708
  - Import: `import { Spoiler } from '@wirecore/wirelayer-react'`
4672
4709
  - Category: Layout
4673
4710
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_layout-spoiler--playground
4711
+ - Also takes: ComponentProps<'div'>
4674
4712
 
4675
4713
  | Prop | Type | Description |
4676
4714
  | --- | --- | --- |
@@ -4755,6 +4793,7 @@ Steps list (tabs) with one panel per step and back/next buttons; the last "Next"
4755
4793
  - Import: `import { Stepper } from '@wirecore/wirelayer-react'`
4756
4794
  - Category: Navigation
4757
4795
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_navigation-stepper--playground
4796
+ - Also takes: Omit<ComponentProps<'div'>, 'children'>
4758
4797
 
4759
4798
  | Prop | Type | Description |
4760
4799
  | --- | --- | --- |
@@ -4864,6 +4903,7 @@ Navigation to the headings of the page; the section in view is marked (aria-curr
4864
4903
  - Import: `import { TableOfContents } from '@wirecore/wirelayer-react'`
4865
4904
  - Category: Navigation
4866
4905
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_navigation-tableofcontents--playground
4906
+ - Also takes: ComponentProps<'div'>
4867
4907
 
4868
4908
  | Prop | Type | Description |
4869
4909
  | --- | --- | --- |
@@ -5037,6 +5077,7 @@ Events in order (ordered list); the markers are decoration, the status colour is
5037
5077
  - Import: `import { Timeline } from '@wirecore/wirelayer-react'`
5038
5078
  - Category: Data
5039
5079
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_data-timeline--playground
5080
+ - Also takes: HTMLAttributes<HTMLElement>
5040
5081
 
5041
5082
  | Prop | Type | Description |
5042
5083
  | --- | --- | --- |
@@ -5193,6 +5234,7 @@ Groups controls (role="toolbar"): one tab stop, arrow keys move between the cont
5193
5234
  - Import: `import { Toolbar } from '@wirecore/wirelayer-react'`
5194
5235
  - Category: Layout
5195
5236
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_layout-toolbar--playground
5237
+ - Also takes: ComponentProps<'div'>
5196
5238
 
5197
5239
  | Prop | Type | Description |
5198
5240
  | --- | --- | --- |
@@ -5270,6 +5312,9 @@ Step-by-step introduction: each step is a dialog next to its element (focus move
5270
5312
  | steps | `readonly TourStep[]` | |
5271
5313
  | open? | `boolean` | Running – starting it sets it, the tour ends itself |
5272
5314
  | onOpenChange? | `(open: boolean) => void` | |
5315
+ | step? | `string \| null` | Id of the step shown, null while the tour does not run; setting it moves there |
5316
+ | onStepChange? | `(step: string \| null) => void` | |
5317
+ | missingTarget? | `'skip' \| 'dialog'` | A step whose target is not there (after `waitFor`): skip it (default) or show it as a centred dialog |
5273
5318
  | onComplete? | `() => void` | |
5274
5319
  | classes? | `RecipeClasses<typeof tourRecipe>` | Extra classes per part of the component, e.g. { base: "…" } (see the recipe) |
5275
5320
 
@@ -5280,12 +5325,13 @@ Tree (role="tree"): arrow keys move and open/close, Enter/Space select, typing j
5280
5325
  - Import: `import { Tree } from '@wirecore/wirelayer-react'`
5281
5326
  - Category: Data
5282
5327
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_data-tree--playground
5328
+ - Also takes: Omit<ComponentProps<'div'>, 'ref'>
5283
5329
 
5284
5330
  | Prop | Type | Description |
5285
5331
  | --- | --- | --- |
5286
5332
  | items | `readonly TreeNode[]` | |
5287
5333
  | label? | `string` | Visible label, also the tree's accessible name |
5288
- | aria-label? | `string` | Accessible name without a visible label |
5334
+ | aria-label? | `string` | Accessible name of the tree without a visible label (not of the outer element) |
5289
5335
  | selectionMode? | `'single' \| 'multiple'` | |
5290
5336
  | selectedValue? | `string[]` | |
5291
5337
  | defaultSelectedValue? | `string[]` | |
@@ -5349,6 +5395,7 @@ Select whose options are a tree: the button opens the tree in a panel, choosing
5349
5395
  - Import: `import { TreeSelect } from '@wirecore/wirelayer-react'`
5350
5396
  - Category: Forms
5351
5397
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_forms-treeselect--playground
5398
+ - Also takes: Omit< ComponentProps<'div'>, 'defaultValue' | 'value' >
5352
5399
 
5353
5400
  | Prop | Type | Description |
5354
5401
  | --- | --- | --- |
@@ -5372,7 +5419,7 @@ Select whose options are a tree: the button opens the tree in a panel, choosing
5372
5419
  | loadChildren? | `(node: TreeNode, request: { signal: AbortSignal }) => Promise<TreeNode[]>` | Loads the children of lazy nodes (`hasChildren: true`) when they open; they are kept while the field lives |
5373
5420
  | onLoadChildren? | `(node: TreeNode) => void` | A lazy node opened and there is no loadChildren/dataSource: add its children to the items |
5374
5421
  | dataSource? | `DataSource<TreeNode>` | Source of the children of lazy nodes (`getChildren`) |
5375
- | aria-label? | `string` | Accessible name without a surrounding Field |
5422
+ | aria-label? | `string` | Accessible name of the field without a surrounding Field (not of the outer element) |
5376
5423
  | id? | `string` | Id of the field (the trigger), e.g. for a `<label for>` |
5377
5424
  | className? | `string` | |
5378
5425
  | style? | `CSSProperties` | |
@@ -5408,6 +5455,7 @@ Only the visible rows are in the DOM; each row says its position (aria-posinset/
5408
5455
  - Import: `import { VirtualList } from '@wirecore/wirelayer-react/virtual'`
5409
5456
  - Category: Data
5410
5457
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_data-virtuallist--playground
5458
+ - Also takes: Omit<ComponentProps<'div'>, 'children' | 'ref'>
5411
5459
 
5412
5460
  | Prop | Type | Description |
5413
5461
  | --- | --- | --- |
@@ -5504,6 +5552,7 @@ Floating bars: each change starts where the previous one ended, totals from zero
5504
5552
  - Import: `import { WaterfallChart } from '@wirecore/wirelayer-react/chart'`
5505
5553
  - Category: Data
5506
5554
  - Example: https://wirecore.github.io/WireLayer/?path=/story/react_data-waterfallchart--playground
5555
+ - Also takes: ComponentProps<'figure'>
5507
5556
 
5508
5557
  | Prop | Type | Description |
5509
5558
  | --- | --- | --- |
@@ -6397,6 +6446,17 @@ as `pdfjs-dist` (Apache-2.0), Chart.js, Tiptap and Shiki are installed by the ap
6397
6446
  rounded buttons, the padding of cards and the backdrop of dialogs are CSS variables (`--wc-control-h-md` …).
6398
6447
  - **Labels:** wrap a control in `Field` (it links label, description and error). A native `<label for>` works with the
6399
6448
  control's own `id`; date fields, sliders and groups need `Field` or `aria-label`.
6449
+ - **Extra attributes go to the outermost element.** `data-*`, `id`, `title`, `aria-describedby` and listeners without a
6450
+ prop of their own land on the component's outermost element (React: the rest props, Vue: the attrs) – e.g.
6451
+ `data-tour` as the target of a `Tour` step or a test selector, no wrapper `<div>` needed. Exceptions: `aria-label`
6452
+ names what it labels (the list of `Sortable` and `Listbox`, the tree of `Tree`, `VirtualTree` and `JsonViewer`, the
6453
+ dial of `Knob`, the field of `CascadeSelect`, `TreeSelect`, `ColorPicker`, `PinInput` and `Editor`); a control's own
6454
+ `id` prop goes to that control (see _Labels_); `Fieldset` takes `id` as the base of its legend's and texts' ids.
6455
+ Text fields and pickers built around a native input (`Input`, `Select`, `DatePicker`, `Checkbox`, `Switch` …) give
6456
+ `class` and `style` to their wrapper and every other attribute to the input. `Inplace` takes none – its element
6457
+ switches between the text and the editor. In React Native the view props (`testID`, `nativeID`, accessibility props)
6458
+ go to the outermost view; pickers that open a sheet (`Select`, `CascadeSelect`, `TreeSelect`, `ColorPicker`,
6459
+ `NavigationMenu`, `NotificationCenter`) take none – they render a trigger and a sheet, no outer view.
6400
6460
  - **Brand colours:** `checkTheme` lists the pairs below WCAG AA, `suggestThemeFixes` the nearest colours (and `on-*`
6401
6461
  colours) that meet them – an orange `primary` with white text, common in PrimeVue themes, does not.
6402
6462
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wirecore/wirelayer-react",
3
- "version": "0.11.0",
3
+ "version": "0.12.1",
4
4
  "description": "WireLayer components for React",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -166,7 +166,7 @@
166
166
  "dependencies": {
167
167
  "@ark-ui/react": "^5.39.3",
168
168
  "@internationalized/date": "^3.12.4",
169
- "@wirecore/wirelayer-recipes": "^0.9.0",
169
+ "@wirecore/wirelayer-recipes": "^0.10.0",
170
170
  "@wirecore/wirelayer-tokens": "^0.6.0",
171
171
  "lucide-react": "^1.59.0"
172
172
  },
@@ -1,45 +0,0 @@
1
- "use client";
2
- import { a as e, n as t } from "./RecipesProvider-0idafuGm.js";
3
- import { copyButton as n, iconButton as r } from "@wirecore/wirelayer-recipes";
4
- import { Check as i, Copy as a } from "lucide-react";
5
- import { jsx as o, jsxs as s } from "react/jsx-runtime";
6
- import { Clipboard as c } from "@ark-ui/react/clipboard";
7
- //#region src/components/CopyButton/CopyButton.tsx
8
- function l({ classes: l, value: u, showValue: d = !1, label: f, size: p = "sm", className: m, style: h }) {
9
- let g = t("copyButton", n, l), _ = t("iconButton", r), v = g(), y = e(), b = f ?? y.copyButton.label, x = _({
10
- variant: "text",
11
- size: p
12
- });
13
- return /* @__PURE__ */ s(c.Root, {
14
- value: u,
15
- className: v.base({ class: m }),
16
- style: h,
17
- children: [
18
- d && /* @__PURE__ */ o("span", {
19
- className: v.value(),
20
- children: u
21
- }),
22
- /* @__PURE__ */ o(c.Trigger, {
23
- className: x.base(),
24
- "aria-label": b,
25
- children: /* @__PURE__ */ o(c.Indicator, {
26
- copied: /* @__PURE__ */ o(i, {
27
- className: x.icon(),
28
- "aria-hidden": "true"
29
- }),
30
- children: /* @__PURE__ */ o(a, {
31
- className: x.icon(),
32
- "aria-hidden": "true"
33
- })
34
- })
35
- }),
36
- /* @__PURE__ */ o(c.Context, { children: (e) => /* @__PURE__ */ o("span", {
37
- role: "status",
38
- className: v.status(),
39
- children: e.copied ? y.copyButton.copied : ""
40
- }) })
41
- ]
42
- });
43
- }
44
- //#endregion
45
- export { l as t };