@kirana-ui/solid 0.1.0 → 0.2.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.
Files changed (213) hide show
  1. package/dom/accordion.js +9 -6
  2. package/dom/agent.js +3 -0
  3. package/dom/autocomplete.js +2 -0
  4. package/dom/autosize.js +19 -0
  5. package/dom/avatar.js +3 -3
  6. package/dom/button.js +1 -1
  7. package/dom/calendar.js +145 -0
  8. package/dom/carousel.js +83 -0
  9. package/dom/checkbox.js +5 -4
  10. package/dom/collapsible.js +3 -3
  11. package/dom/combobox.js +289 -0
  12. package/dom/command.js +129 -0
  13. package/dom/context-menu.js +2 -0
  14. package/dom/date-field.js +90 -0
  15. package/dom/date-picker.js +103 -0
  16. package/dom/dialog.js +32 -1
  17. package/dom/drawer.js +2 -0
  18. package/dom/field.js +3 -3
  19. package/dom/fieldset.js +2 -2
  20. package/dom/form.js +1 -1
  21. package/dom/hover-popup.js +19 -4
  22. package/dom/index.js +26 -1
  23. package/dom/input.js +26 -0
  24. package/dom/label.js +18 -0
  25. package/dom/listbox.js +114 -0
  26. package/dom/menu.js +261 -0
  27. package/dom/menubar-context.js +3 -0
  28. package/dom/menubar.js +33 -0
  29. package/dom/message-scroller.js +56 -0
  30. package/dom/navigation-menu.js +147 -0
  31. package/dom/number-field.js +82 -0
  32. package/dom/otp.js +95 -0
  33. package/dom/pagination.js +74 -0
  34. package/dom/popover.js +22 -7
  35. package/dom/qr-code.js +48 -0
  36. package/dom/radio-group.js +6 -5
  37. package/dom/resizable.js +65 -0
  38. package/dom/runtime.js +59 -9
  39. package/dom/scroll-area.js +99 -0
  40. package/dom/select.js +91 -15
  41. package/dom/separator.js +1 -1
  42. package/dom/slider.js +11 -8
  43. package/dom/switch.js +5 -4
  44. package/dom/tabs.js +5 -5
  45. package/dom/testing.js +3 -0
  46. package/dom/toast.js +150 -0
  47. package/dom/toggle-group.js +37 -0
  48. package/dom/toggle.js +12 -4
  49. package/dom/toolbar-context.js +5 -0
  50. package/dom/toolbar.js +71 -0
  51. package/dom/value-bar.js +3 -3
  52. package/llms.txt +3202 -0
  53. package/package.json +236 -2
  54. package/server/accordion.js +9 -6
  55. package/server/agent.js +3 -0
  56. package/server/autocomplete.js +2 -0
  57. package/server/autosize.js +19 -0
  58. package/server/avatar.js +3 -3
  59. package/server/button.js +1 -1
  60. package/server/calendar.js +144 -0
  61. package/server/carousel.js +83 -0
  62. package/server/checkbox.js +5 -4
  63. package/server/collapsible.js +3 -3
  64. package/server/combobox.js +289 -0
  65. package/server/command.js +129 -0
  66. package/server/context-menu.js +2 -0
  67. package/server/date-field.js +90 -0
  68. package/server/date-picker.js +103 -0
  69. package/server/dialog.js +32 -1
  70. package/server/drawer.js +2 -0
  71. package/server/field.js +3 -3
  72. package/server/fieldset.js +2 -2
  73. package/server/form.js +1 -1
  74. package/server/hover-popup.js +19 -4
  75. package/server/index.js +26 -1
  76. package/server/input.js +26 -0
  77. package/server/label.js +18 -0
  78. package/server/listbox.js +114 -0
  79. package/server/menu.js +261 -0
  80. package/server/menubar-context.js +3 -0
  81. package/server/menubar.js +33 -0
  82. package/server/message-scroller.js +56 -0
  83. package/server/navigation-menu.js +147 -0
  84. package/server/number-field.js +81 -0
  85. package/server/otp.js +94 -0
  86. package/server/pagination.js +74 -0
  87. package/server/popover.js +22 -7
  88. package/server/qr-code.js +48 -0
  89. package/server/radio-group.js +6 -5
  90. package/server/resizable.js +65 -0
  91. package/server/runtime.js +58 -8
  92. package/server/scroll-area.js +99 -0
  93. package/server/select.js +91 -15
  94. package/server/separator.js +1 -1
  95. package/server/slider.js +11 -8
  96. package/server/switch.js +5 -4
  97. package/server/tabs.js +5 -5
  98. package/server/testing.js +3 -0
  99. package/server/toast.js +150 -0
  100. package/server/toggle-group.js +37 -0
  101. package/server/toggle.js +12 -4
  102. package/server/toolbar-context.js +5 -0
  103. package/server/toolbar.js +71 -0
  104. package/server/value-bar.js +3 -3
  105. package/skills/kirana-ui-primitives/SKILL.md +142 -0
  106. package/src/accordion.jsx +10 -7
  107. package/src/agent.js +3 -0
  108. package/src/autocomplete.jsx +2 -0
  109. package/src/autosize.jsx +8 -0
  110. package/src/avatar.jsx +3 -3
  111. package/src/button.jsx +1 -1
  112. package/src/calendar.jsx +108 -0
  113. package/src/carousel.jsx +51 -0
  114. package/src/checkbox.jsx +5 -3
  115. package/src/collapsible.jsx +3 -3
  116. package/src/combobox.jsx +187 -0
  117. package/src/command.jsx +81 -0
  118. package/src/context-menu.js +2 -0
  119. package/src/date-field.jsx +71 -0
  120. package/src/date-picker.jsx +72 -0
  121. package/src/dialog.jsx +27 -1
  122. package/src/drawer.js +2 -0
  123. package/src/field.jsx +3 -3
  124. package/src/fieldset.jsx +2 -2
  125. package/src/form.jsx +1 -1
  126. package/src/hover-popup.jsx +12 -4
  127. package/src/index.js +26 -1
  128. package/src/input.jsx +17 -0
  129. package/src/label.jsx +9 -0
  130. package/src/listbox.jsx +81 -0
  131. package/src/menu.jsx +164 -0
  132. package/src/menubar-context.js +3 -0
  133. package/src/menubar.jsx +21 -0
  134. package/src/message-scroller.jsx +27 -0
  135. package/src/navigation-menu.jsx +96 -0
  136. package/src/number-field.jsx +75 -0
  137. package/src/otp.jsx +73 -0
  138. package/src/pagination.jsx +60 -0
  139. package/src/popover.jsx +22 -4
  140. package/src/qr-code.jsx +25 -0
  141. package/src/radio-group.jsx +7 -5
  142. package/src/resizable.jsx +46 -0
  143. package/src/runtime.jsx +54 -9
  144. package/src/scroll-area.jsx +53 -0
  145. package/src/select.jsx +72 -14
  146. package/src/separator.jsx +1 -1
  147. package/src/slider.jsx +13 -8
  148. package/src/switch.jsx +5 -3
  149. package/src/tabs.jsx +6 -6
  150. package/src/testing.js +3 -0
  151. package/src/toast.jsx +86 -0
  152. package/src/toggle-group.jsx +32 -0
  153. package/src/toggle.jsx +9 -3
  154. package/src/toolbar-context.js +5 -0
  155. package/src/toolbar.jsx +43 -0
  156. package/src/value-bar.jsx +3 -3
  157. package/types/accordion.d.ts +21 -19
  158. package/types/agent.d.ts +1 -0
  159. package/types/alert-dialog.d.ts +1 -0
  160. package/types/autocomplete.d.ts +2 -0
  161. package/types/autosize.d.ts +11 -0
  162. package/types/avatar.d.ts +12 -5
  163. package/types/button.d.ts +4 -2
  164. package/types/calendar.d.ts +57 -0
  165. package/types/carousel.d.ts +34 -0
  166. package/types/checkbox.d.ts +10 -6
  167. package/types/collapsible.d.ts +11 -7
  168. package/types/combobox.d.ts +105 -0
  169. package/types/command.d.ts +55 -0
  170. package/types/context-menu.d.ts +2 -0
  171. package/types/date-field.d.ts +34 -0
  172. package/types/date-picker.d.ts +40 -0
  173. package/types/dialog.d.ts +52 -20
  174. package/types/direction.d.ts +1 -0
  175. package/types/drawer.d.ts +2 -0
  176. package/types/field.d.ts +19 -11
  177. package/types/fieldset.d.ts +8 -3
  178. package/types/form.d.ts +5 -2
  179. package/types/hover-card.d.ts +16 -7
  180. package/types/hover-popup.d.ts +23 -10
  181. package/types/index.d.ts +39 -2
  182. package/types/input.d.ts +13 -0
  183. package/types/label.d.ts +7 -0
  184. package/types/listbox.d.ts +36 -0
  185. package/types/menu.d.ts +105 -0
  186. package/types/menubar-context.d.ts +3 -0
  187. package/types/menubar.d.ts +12 -0
  188. package/types/message-scroller.d.ts +22 -0
  189. package/types/meter.d.ts +16 -7
  190. package/types/navigation-menu.d.ts +50 -0
  191. package/types/number-field.d.ts +22 -0
  192. package/types/otp.d.ts +39 -0
  193. package/types/pagination.d.ts +31 -0
  194. package/types/popover.d.ts +41 -13
  195. package/types/progress.d.ts +16 -7
  196. package/types/qr-code.d.ts +20 -0
  197. package/types/radio-group.d.ts +15 -16
  198. package/types/resizable.d.ts +29 -0
  199. package/types/runtime.d.ts +53 -11
  200. package/types/scroll-area.d.ts +28 -0
  201. package/types/select.d.ts +66 -33
  202. package/types/separator.d.ts +5 -3
  203. package/types/slider.d.ts +25 -13
  204. package/types/switch.d.ts +8 -4
  205. package/types/tabs.d.ts +20 -16
  206. package/types/testing.d.ts +1 -0
  207. package/types/toast.d.ts +57 -0
  208. package/types/toggle-group.d.ts +9 -0
  209. package/types/toggle.d.ts +6 -3
  210. package/types/toolbar-context.d.ts +6 -0
  211. package/types/toolbar.d.ts +28 -0
  212. package/types/tooltip.d.ts +16 -7
  213. package/types/value-bar.d.ts +21 -10
package/dom/toast.js ADDED
@@ -0,0 +1,150 @@
1
+ import { memo as _$memo } from "solid-js/web";
2
+ import { createComponent as _$createComponent } from "solid-js/web";
3
+ import { mergeProps as _$mergeProps } from "solid-js/web";
4
+ import { createToast, createToaster as createCoreToaster } from "@kirana-ui/core/toast";
5
+ import { For, Show, createContext, createMemo, createUniqueId, splitProps, useContext } from "solid-js";
6
+ import { Part, controller, fromSignal } from "./runtime.js";
7
+ /**
8
+ * The toasts of a page, made once, in a module: `toaster.add({ title })` from anywhere. A
9
+ * title, a description and an action's label are anything Solid draws, unless `Content` says
10
+ * otherwise.
11
+ */
12
+ export const createToaster = createCoreToaster;
13
+ const Context = createContext();
14
+ const ToastContext = createContext();
15
+ function useToast() {
16
+ const made = useContext(Context);
17
+ if (!made) throw new Error("A Toast part must be inside <Toast.Viewport>");
18
+ return made;
19
+ }
20
+ function useParts() {
21
+ const parts = useContext(ToastContext);
22
+ if (!parts) throw new Error("A toast's part must be inside <Toast.Root>");
23
+ return parts;
24
+ }
25
+ /** Where a toaster's toasts are drawn. Always in the page: put it once, near the root. */
26
+ function Viewport(props) {
27
+ const [local, rest] = splitProps(props, ["toaster", "label", "hotkey", "swipeDirection", "id"]);
28
+ const generated = createUniqueId();
29
+ const made = controller(createToast, () => ({
30
+ id: local.id ?? generated,
31
+ toaster: local.toaster,
32
+ label: local.label,
33
+ hotkey: local.hotkey,
34
+ swipeDirection: local.swipeDirection
35
+ }));
36
+ return _$createComponent(Context.Provider, {
37
+ value: made,
38
+ get children() {
39
+ return _$createComponent(Part, _$mergeProps({
40
+ get of() {
41
+ return made.viewport;
42
+ },
43
+ tag: "div"
44
+ }, rest));
45
+ }
46
+ });
47
+ }
48
+ /**
49
+ * Draws its child once for each toast, the newest first. The child is given the toast as an
50
+ * accessor: one that changes is the same toast, drawn again where it stands.
51
+ */
52
+ function List(props) {
53
+ const toasts = fromSignal(useToast().toasts);
54
+ const ids = createMemo(() => toasts().map(each => each.id), undefined, {
55
+ equals: (a, b) => a.length === b.length && a.every((each, at) => each === b[at])
56
+ });
57
+ return _$createComponent(For, {
58
+ get each() {
59
+ return ids();
60
+ },
61
+ children: id => props.children(() => toasts().find(each => each.id === id))
62
+ });
63
+ }
64
+ function Root(props) {
65
+ const [local, rest] = splitProps(props, ["toast"]);
66
+ // A root is its toast for as long as it is in the page.
67
+ const parts = useToast().toast(local.toast.id);
68
+ return _$createComponent(ToastContext.Provider, {
69
+ value: parts,
70
+ get children() {
71
+ return _$createComponent(Part, _$mergeProps({
72
+ get of() {
73
+ return parts.root;
74
+ },
75
+ tag: "div"
76
+ }, rest));
77
+ }
78
+ });
79
+ }
80
+ const Content = props => _$createComponent(Part, _$mergeProps({
81
+ get of() {
82
+ return useParts().content;
83
+ },
84
+ tag: "div"
85
+ }, props));
86
+ /**
87
+ * A part that says something of the toast's: the caller's children when it has any, what the
88
+ * toast was added with otherwise, and nothing in the page when there is neither.
89
+ */
90
+ function Said(props) {
91
+ const [local, rest] = splitProps(props, ["said", "tag", "children"]);
92
+ const parts = useParts();
93
+ const toast = fromSignal(parts.record);
94
+ const children = createMemo(() => local.children ?? (local.said === "action" ? toast()?.action?.label : toast()?.[local.said]));
95
+ return (// A `render` draws what it likes; without one, an element with nothing to say is not drawn.
96
+ _$createComponent(Show, {
97
+ get when() {
98
+ return children() != null || rest.render;
99
+ },
100
+ get children() {
101
+ return _$createComponent(Part, _$mergeProps({
102
+ get of() {
103
+ return parts[local.said];
104
+ },
105
+ get tag() {
106
+ return local.tag;
107
+ }
108
+ }, rest, {
109
+ get children() {
110
+ return children();
111
+ }
112
+ }));
113
+ }
114
+ })
115
+ );
116
+ }
117
+ /** The toast's title, unless it is given children of its own. */
118
+ const Title = props => _$createComponent(Said, _$mergeProps({
119
+ said: "title",
120
+ tag: "div"
121
+ }, props));
122
+ /** The toast's description, unless it is given children of its own. */
123
+ const Description = props => _$createComponent(Said, _$mergeProps({
124
+ said: "description",
125
+ tag: "div"
126
+ }, props));
127
+ const Close = props => _$createComponent(Part, _$mergeProps({
128
+ get of() {
129
+ return useParts().close;
130
+ },
131
+ tag: "button"
132
+ }, props));
133
+ /**
134
+ * The toast's action, its label unless it is given children of its own. A press tells the
135
+ * action (`onAction`), then closes the toast unless the action called `details.cancel()`.
136
+ */
137
+ const Action = props => _$createComponent(Said, _$mergeProps({
138
+ said: "action",
139
+ tag: "button"
140
+ }, props));
141
+ export const Toast = {
142
+ Viewport,
143
+ List,
144
+ Root,
145
+ Content,
146
+ Title,
147
+ Description,
148
+ Close,
149
+ Action
150
+ };
@@ -0,0 +1,37 @@
1
+ import { createComponent as _$createComponent } from "solid-js/web";
2
+ import { mergeProps as _$mergeProps } from "solid-js/web";
3
+ import { within } from "@kirana-ui/core";
4
+ import { createToggleGroup } from "@kirana-ui/core/toggle-group";
5
+ import { splitProps, useContext } from "solid-js";
6
+ import { DirectionContext } from "./direction-context.js";
7
+ import { Part, controller } from "./runtime.js";
8
+ import { ToggleGroupContext, ToolbarContext } from "./toolbar-context.js";
9
+ /** Toggles that are one control. Each `<Toggle value>` inside it is one of its toggles. */
10
+ export function ToggleGroup(props) {
11
+ const [local, rest] = splitProps(props, ["value", "defaultValue", "onValueChange", "multiple", "disabled", "orientation", "loop"]);
12
+ const direction = useContext(DirectionContext);
13
+ const toolbar = useContext(ToolbarContext) ?? undefined;
14
+ const made = controller(within(createToggleGroup, {
15
+ direction,
16
+ toolbar
17
+ }), () => ({
18
+ value: local.value,
19
+ defaultValue: local.defaultValue,
20
+ multiple: local.multiple,
21
+ disabled: local.disabled,
22
+ orientation: local.orientation,
23
+ loop: local.loop,
24
+ onValueChange: (value, details) => local.onValueChange?.(value, details)
25
+ }));
26
+ return _$createComponent(ToggleGroupContext.Provider, {
27
+ value: made,
28
+ get children() {
29
+ return _$createComponent(Part, _$mergeProps({
30
+ get of() {
31
+ return made.root;
32
+ },
33
+ tag: "div"
34
+ }, rest));
35
+ }
36
+ });
37
+ }
package/dom/toggle.js CHANGED
@@ -1,18 +1,26 @@
1
1
  import { createComponent as _$createComponent } from "solid-js/web";
2
2
  import { mergeProps as _$mergeProps } from "solid-js/web";
3
+ import { within } from "@kirana-ui/core";
3
4
  import { createToggle } from "@kirana-ui/core/toggle";
4
- import { splitProps } from "solid-js";
5
+ import { splitProps, useContext } from "solid-js";
5
6
  import { Part, controller } from "./runtime.js";
7
+ import { ToggleGroupContext, ToolbarContext } from "./toolbar-context.js";
6
8
  export function Toggle(props) {
7
- const [local, rest] = splitProps(props, ["pressed", "defaultPressed", "onPressedChange", "disabled"]);
8
- const made = controller(createToggle, () => ({
9
+ const [local, rest] = splitProps(props, ["pressed", "defaultPressed", "onPressedChange", "disabled", "value"]);
10
+ const group = useContext(ToggleGroupContext) ?? undefined;
11
+ const toolbar = useContext(ToolbarContext) ?? undefined;
12
+ const made = controller(within(createToggle, {
13
+ group,
14
+ toolbar
15
+ }), () => ({
9
16
  pressed: local.pressed,
10
17
  defaultPressed: local.defaultPressed,
11
18
  disabled: local.disabled,
19
+ value: local.value,
12
20
  onPressedChange: (pressed, details) => local.onPressedChange?.(pressed, details)
13
21
  }));
14
22
  return _$createComponent(Part, _$mergeProps({
15
- get part() {
23
+ get of() {
16
24
  return made.root;
17
25
  },
18
26
  tag: "button"
@@ -0,0 +1,5 @@
1
+ import { createContext } from "solid-js";
2
+ /** The toolbar a control is an item of, if it is in one. */
3
+ export const ToolbarContext = createContext(null);
4
+ /** The group a toggle is one of the toggles of, if it is in one. */
5
+ export const ToggleGroupContext = createContext(null);
package/dom/toolbar.js ADDED
@@ -0,0 +1,71 @@
1
+ import { createComponent as _$createComponent } from "solid-js/web";
2
+ import { mergeProps as _$mergeProps } from "solid-js/web";
3
+ import { defined, within } from "@kirana-ui/core";
4
+ import { createToolbar } from "@kirana-ui/core/toolbar";
5
+ import { splitProps, useContext } from "solid-js";
6
+ import { DirectionContext } from "./direction-context.js";
7
+ import { Part, controller, toSignal } from "./runtime.js";
8
+ import { ToggleGroupContext, ToolbarContext } from "./toolbar-context.js";
9
+ function useToolbar() {
10
+ const made = useContext(ToolbarContext);
11
+ if (!made) throw new Error("A Toolbar part must be inside <Toolbar.Root>");
12
+ return made;
13
+ }
14
+ function Root(props) {
15
+ const [local, rest] = splitProps(props, ["orientation", "loop", "disabled"]);
16
+ const direction = useContext(DirectionContext);
17
+ const made = controller(within(createToolbar, {
18
+ direction
19
+ }), () => ({
20
+ orientation: local.orientation,
21
+ loop: local.loop,
22
+ disabled: local.disabled
23
+ }));
24
+ return _$createComponent(ToolbarContext.Provider, {
25
+ value: made,
26
+ get children() {
27
+ return _$createComponent(ToggleGroupContext.Provider, {
28
+ value: null,
29
+ get children() {
30
+ return _$createComponent(Part, _$mergeProps({
31
+ get of() {
32
+ return made.root;
33
+ },
34
+ tag: "div"
35
+ }, rest));
36
+ }
37
+ });
38
+ }
39
+ });
40
+ }
41
+ const item = (name, tag) => props => {
42
+ const [local, rest] = splitProps(props, ["disabled"]);
43
+ const options = toSignal(() => ({
44
+ disabled: local.disabled
45
+ }));
46
+ const part = useToolbar()[name](() => defined(options.get()));
47
+ return _$createComponent(Part, _$mergeProps({
48
+ of: part,
49
+ tag: tag
50
+ }, rest));
51
+ };
52
+ const Link = props => _$createComponent(Part, _$mergeProps({
53
+ get of() {
54
+ return useToolbar().link();
55
+ },
56
+ tag: "a"
57
+ }, props));
58
+ const Separator = props => _$createComponent(Part, _$mergeProps({
59
+ get of() {
60
+ return useToolbar().separator;
61
+ },
62
+ tag: "div"
63
+ }, props));
64
+ export const Toolbar = {
65
+ Root,
66
+ Button: item("button", "button"),
67
+ Link,
68
+ Input: item("input", "input"),
69
+ Group: item("group", "div"),
70
+ Separator
71
+ };
package/dom/value-bar.js CHANGED
@@ -22,7 +22,7 @@ export function valueBar(name, create) {
22
22
  value: made,
23
23
  get children() {
24
24
  return _$createComponent(Part, _$mergeProps({
25
- get part() {
25
+ get of() {
26
26
  return made.root;
27
27
  },
28
28
  tag: "div"
@@ -36,7 +36,7 @@ export function valueBar(name, create) {
36
36
  const made = use();
37
37
  const text = fromSignal(made.text);
38
38
  return _$createComponent(Part, _$mergeProps({
39
- get part() {
39
+ get of() {
40
40
  return made.value;
41
41
  },
42
42
  tag: "span"
@@ -47,7 +47,7 @@ export function valueBar(name, create) {
47
47
  }));
48
48
  }
49
49
  const part = (key, tag) => props => _$createComponent(Part, _$mergeProps({
50
- get part() {
50
+ get of() {
51
51
  return use()[key];
52
52
  },
53
53
  tag: tag