@codefast/ui 0.5.0-canary.2 → 0.5.0-canary.4

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 (80) hide show
  1. package/CHANGELOG.md +51 -0
  2. package/dist/components/attachment.d.mts +136 -0
  3. package/dist/components/attachment.mjs +112 -0
  4. package/dist/components/avatar.mjs +1 -1
  5. package/dist/components/breadcrumb.d.mts +2 -4
  6. package/dist/components/bubble.d.mts +67 -0
  7. package/dist/components/bubble.mjs +58 -0
  8. package/dist/components/card.mjs +2 -2
  9. package/dist/components/carousel.mjs +12 -3
  10. package/dist/components/empty.mjs +1 -1
  11. package/dist/components/marker.d.mts +49 -0
  12. package/dist/components/marker.mjs +42 -0
  13. package/dist/components/message-scroller.d.mts +89 -0
  14. package/dist/components/message-scroller.mjs +77 -0
  15. package/dist/components/message.d.mts +86 -0
  16. package/dist/components/message.mjs +66 -0
  17. package/dist/components/progress-circle.d.mts +4 -4
  18. package/dist/components/progress-circle.mjs +7 -7
  19. package/dist/components/sidebar.mjs +6 -3
  20. package/dist/hooks/use-animated-value.d.mts +2 -2
  21. package/dist/hooks/use-animated-value.mjs +4 -4
  22. package/dist/hooks/use-message-scroller-commands.d.mts +39 -0
  23. package/dist/hooks/use-message-scroller-commands.mjs +165 -0
  24. package/dist/hooks/use-message-scroller-controller.d.mts +19 -0
  25. package/dist/hooks/use-message-scroller-controller.mjs +382 -0
  26. package/dist/hooks/use-message-scroller-refs.d.mts +60 -0
  27. package/dist/hooks/use-message-scroller-refs.mjs +77 -0
  28. package/dist/hooks/use-pagination.d.mts +4 -4
  29. package/dist/hooks/use-pagination.mjs +1 -1
  30. package/dist/index.d.mts +12 -2
  31. package/dist/index.mjs +11 -2
  32. package/dist/lib/message-scroller/geometry.d.mts +136 -0
  33. package/dist/lib/message-scroller/geometry.mjs +199 -0
  34. package/dist/lib/message-scroller/stores.d.mts +21 -0
  35. package/dist/lib/message-scroller/stores.mjs +52 -0
  36. package/dist/lib/message-scroller/types.d.mts +171 -0
  37. package/dist/lib/message-scroller/types.mjs +53 -0
  38. package/dist/lib/message-scroller/utils.d.mts +7 -0
  39. package/dist/lib/message-scroller/utils.mjs +12 -0
  40. package/dist/lib/use-render.d.mts +43 -0
  41. package/dist/lib/use-render.mjs +84 -0
  42. package/dist/primitives/message-scroller.d.mts +88 -0
  43. package/dist/primitives/message-scroller.mjs +240 -0
  44. package/dist/variants/attachment.d.mts +42 -0
  45. package/dist/variants/attachment.mjs +42 -0
  46. package/dist/variants/bubble.d.mts +45 -0
  47. package/dist/variants/bubble.mjs +45 -0
  48. package/dist/variants/marker.d.mts +21 -0
  49. package/dist/variants/marker.mjs +18 -0
  50. package/package.json +93 -7
  51. package/src/components/attachment.tsx +284 -0
  52. package/src/components/avatar.tsx +1 -1
  53. package/src/components/breadcrumb.tsx +2 -4
  54. package/src/components/bubble.tsx +116 -0
  55. package/src/components/card.tsx +2 -2
  56. package/src/components/carousel.tsx +12 -3
  57. package/src/components/empty.tsx +1 -1
  58. package/src/components/marker.tsx +94 -0
  59. package/src/components/message-scroller.tsx +213 -0
  60. package/src/components/message.tsx +173 -0
  61. package/src/components/progress-circle.tsx +11 -11
  62. package/src/components/sidebar.tsx +11 -4
  63. package/src/css/foundation/tokens.css +6 -18
  64. package/src/css/foundation/utilities.css +451 -0
  65. package/src/css/preset.css +2 -1
  66. package/src/hooks/use-animated-value.ts +4 -4
  67. package/src/hooks/use-message-scroller-commands.ts +311 -0
  68. package/src/hooks/use-message-scroller-controller.ts +650 -0
  69. package/src/hooks/use-message-scroller-refs.ts +167 -0
  70. package/src/hooks/use-pagination.ts +3 -3
  71. package/src/index.ts +73 -1
  72. package/src/lib/message-scroller/geometry.ts +397 -0
  73. package/src/lib/message-scroller/stores.ts +88 -0
  74. package/src/lib/message-scroller/types.ts +309 -0
  75. package/src/lib/message-scroller/utils.ts +14 -0
  76. package/src/lib/use-render.ts +201 -0
  77. package/src/primitives/message-scroller.tsx +403 -0
  78. package/src/variants/attachment.ts +73 -0
  79. package/src/variants/bubble.ts +81 -0
  80. package/src/variants/marker.ts +38 -0
@@ -0,0 +1,88 @@
1
+ import { EMPTY_MESSAGE_SCROLLER_VISIBILITY_STATE } from "./types";
2
+ import type {
3
+ MessageScrollerScrollable,
4
+ MessageScrollerStore,
5
+ MessageScrollerVisibilityState,
6
+ MessageScrollerVisibilityStore,
7
+ } from "./types";
8
+
9
+ // Generic useSyncExternalStore backing: a stable snapshot (referentially equal
10
+ // while isEqual holds, so subscribers only re-render on real transitions) plus
11
+ // optional reference-counting via the subscribe-time lifecycle callbacks.
12
+ function createExternalStore<T>(initialSnapshot: T, isEqual: (a: T, b: T) => boolean) {
13
+ let snapshot = initialSnapshot;
14
+ const listeners = new Set<() => void>();
15
+
16
+ return {
17
+ getSnapshot: () => snapshot,
18
+ hasListeners: () => listeners.size > 0,
19
+ setSnapshot: (nextSnapshot: T) => {
20
+ if (isEqual(snapshot, nextSnapshot)) {
21
+ return;
22
+ }
23
+
24
+ snapshot = nextSnapshot;
25
+ listeners.forEach((listener) => listener());
26
+ },
27
+ subscribe: (listener: () => void, onFirstSubscribe?: () => void, onLastUnsubscribe?: () => void) => {
28
+ const wasEmpty = listeners.size === 0;
29
+
30
+ listeners.add(listener);
31
+
32
+ if (wasEmpty) {
33
+ onFirstSubscribe?.();
34
+ }
35
+
36
+ return () => {
37
+ listeners.delete(listener);
38
+
39
+ if (listeners.size === 0) {
40
+ onLastUnsubscribe?.();
41
+ }
42
+ };
43
+ },
44
+ };
45
+ }
46
+
47
+ /**
48
+ * @since 0.5.0-canary.3
49
+ */
50
+ function createMessageScrollerStore<T>(initialSnapshot: T, isEqual: (a: T, b: T) => boolean): MessageScrollerStore<T> {
51
+ return createExternalStore(initialSnapshot, isEqual);
52
+ }
53
+
54
+ /**
55
+ * @since 0.5.0-canary.3
56
+ */
57
+ function createMessageScrollerVisibilityStore(): MessageScrollerVisibilityStore {
58
+ return createExternalStore(EMPTY_MESSAGE_SCROLLER_VISIBILITY_STATE, areVisibilityStatesEqual);
59
+ }
60
+
61
+ /**
62
+ * @since 0.5.0-canary.3
63
+ */
64
+ function areScrollStatesEqual(current: MessageScrollerScrollable, next: MessageScrollerScrollable) {
65
+ return current.start === next.start && current.end === next.end;
66
+ }
67
+
68
+ /**
69
+ * @since 0.5.0-canary.3
70
+ */
71
+ function areVisibilityStatesEqual(current: MessageScrollerVisibilityState, next: MessageScrollerVisibilityState) {
72
+ if (current.currentAnchorId !== next.currentAnchorId) {
73
+ return false;
74
+ }
75
+
76
+ if (current.visibleMessageIds.length !== next.visibleMessageIds.length) {
77
+ return false;
78
+ }
79
+
80
+ return current.visibleMessageIds.every((messageId, index) => messageId === next.visibleMessageIds[index]);
81
+ }
82
+
83
+ export {
84
+ areScrollStatesEqual,
85
+ areVisibilityStatesEqual,
86
+ createMessageScrollerStore,
87
+ createMessageScrollerVisibilityStore,
88
+ };
@@ -0,0 +1,309 @@
1
+ import type { ComponentProps, ReactNode, RefObject } from "react";
2
+
3
+ import type { UseRenderComponentProps } from "#/lib/use-render";
4
+
5
+ // Default scrollEdgeThreshold. Sub-pixel tolerance so edge detection does not
6
+ // flicker across engines that round scrollTop differently.
7
+ /**
8
+ * @since 0.5.0-canary.3
9
+ */
10
+ const DEFAULT_SCROLL_EDGE_THRESHOLD = 8;
11
+
12
+ // Default scrollPreviousItemPeek. Pixels of the previous item kept visible above
13
+ // a newly anchored row.
14
+ /**
15
+ * @since 0.5.0-canary.3
16
+ */
17
+ const DEFAULT_SCROLL_PREVIOUS_ITEM_PEEK = 64;
18
+
19
+ // Default scrollMargin for scrollToMessage and programmatic targets.
20
+ /**
21
+ * @since 0.5.0-canary.3
22
+ */
23
+ const DEFAULT_SCROLL_MARGIN = 0;
24
+
25
+ // Two fractional scrollTop values within this range are treated as equal, to
26
+ // absorb zoom and HiDPI rounding drift.
27
+ /**
28
+ * @since 0.5.0-canary.3
29
+ */
30
+ const SCROLL_POSITION_EPSILON = 0.5;
31
+
32
+ // How long (ms) data-autoscrolling stays set during a programmatic smooth scroll
33
+ // before clearing.
34
+ /**
35
+ * @since 0.5.0-canary.3
36
+ */
37
+ const AUTOSCROLLING_CLEAR_DELAY = 180;
38
+
39
+ // Viewport keys that count as deliberate scroll intent and release follow-bottom.
40
+ /**
41
+ * @since 0.5.0-canary.3
42
+ */
43
+ const USER_SCROLL_KEYS = new Set([
44
+ "ArrowDown",
45
+ "ArrowUp",
46
+ "End",
47
+ "Home",
48
+ "PageDown",
49
+ "PageUp",
50
+ " ", // Space key.
51
+ ]);
52
+
53
+ // Internal scroll mode. Derived from intent and commands; decides how the
54
+ // viewport reacts to content and resize.
55
+ /**
56
+ * @since 0.5.0-canary.3
57
+ */
58
+ type MessageScrollerMode =
59
+ | "following-bottom" // autoScroll on, pinned to the latest message.
60
+ | "free-scrolling" // reader scrolled away; position left alone (prepends still preserved).
61
+ | "anchored-to-message" // holding a turn at the reading line while it streams.
62
+ | "settling-jump"; // a programmatic jump is animating; intent detection suppressed until it settles.
63
+
64
+ // Where a saved transcript opens on the first non-empty render.
65
+ /**
66
+ * @since 0.5.0-canary.3
67
+ */
68
+ type MessageScrollerDefaultScrollPosition = "start" | "end" | "last-anchor";
69
+
70
+ // Which transcript edge MessageScrollerButton scrolls toward.
71
+ /**
72
+ * @since 0.5.0-canary.3
73
+ */
74
+ type MessageScrollerButtonDirection = "start" | "end";
75
+
76
+ // Viewport alignment for scrollToMessage and programmatic jumps.
77
+ /**
78
+ * @since 0.5.0-canary.3
79
+ */
80
+ type MessageScrollerScrollAlign = "start" | "center" | "end" | "nearest";
81
+
82
+ // Options for scrollToMessage, scrollToEnd, and scrollToStart.
83
+ /**
84
+ * @since 0.5.0-canary.3
85
+ */
86
+ type MessageScrollerScrollOptions = {
87
+ // Viewport edge or center to align the target to.
88
+ align?: MessageScrollerScrollAlign;
89
+ // Native scroll behavior.
90
+ behavior?: ScrollBehavior;
91
+ // Margin on the aligned edge, in pixels. Defaults to the provider scrollMargin.
92
+ scrollMargin?: number;
93
+ };
94
+
95
+ // Scroll snapshot from useMessageScrollerScrollable: which edges the viewport can
96
+ // still scroll toward.
97
+ /**
98
+ * @since 0.5.0-canary.3
99
+ */
100
+ type MessageScrollerScrollable = {
101
+ // The viewport can scroll toward the start (content is hidden above).
102
+ start: boolean;
103
+ // The viewport can scroll toward the end (content is hidden below).
104
+ end: boolean;
105
+ };
106
+
107
+ // Visibility snapshot from useMessageScrollerVisibility.
108
+ /**
109
+ * @since 0.5.0-canary.3
110
+ */
111
+ type MessageScrollerVisibilityState = {
112
+ // The anchored turn the reader is in, or null. Stays set after the anchor
113
+ // scrolls above the viewport.
114
+ currentAnchorId: string | null;
115
+ // messageId values intersecting the viewport, in document order.
116
+ visibleMessageIds: Array<string>;
117
+ };
118
+
119
+ // Headless provider for a chat transcript scroller. Owns scroll behavior and
120
+ // state; renders no DOM.
121
+ /**
122
+ * @since 0.5.0-canary.3
123
+ */
124
+ type MessageScrollerProviderProps = {
125
+ children?: ReactNode;
126
+ // Follow new content at the bottom while the viewport is already at the end.
127
+ autoScroll?: boolean;
128
+ // Opening position on the first non-empty render, applied once.
129
+ defaultScrollPosition?: MessageScrollerDefaultScrollPosition;
130
+ // Distance from an edge that still counts as at-top/at-bottom. Defaults to 8.
131
+ scrollEdgeThreshold?: number;
132
+ // Extra top margin for a newly anchored row, added to scrollMargin. Defaults to 64.
133
+ scrollPreviousItemPeek?: number;
134
+ // Default margin on the aligned edge for commands and visibility. Defaults to 0.
135
+ scrollMargin?: number;
136
+ };
137
+
138
+ // Frame container for a chat transcript scroller. Must render inside a
139
+ // MessageScrollerProvider.
140
+ /**
141
+ * @since 0.5.0-canary.3
142
+ */
143
+ type MessageScrollerProps = ComponentProps<"div">;
144
+
145
+ // Scrollable viewport. Owns native scroll events and prepend preservation.
146
+ /**
147
+ * @since 0.5.0-canary.3
148
+ */
149
+ type MessageScrollerViewportProps = ComponentProps<"div"> & {
150
+ // Keep the first visible messageId row stable on prepend. Defaults to true.
151
+ preserveScrollOnPrepend?: boolean;
152
+ };
153
+
154
+ // Transcript row container. Every direct child should be a MessageScrollerItem.
155
+ /**
156
+ * @since 0.5.0-canary.3
157
+ */
158
+ type MessageScrollerContentProps = ComponentProps<"div"> & {
159
+ // Class name for the internal tail spacer used when anchoring turns near the top.
160
+ spacerClassName?: string;
161
+ };
162
+
163
+ // One transcript row: a message, marker, typing row, separator, or load-more row.
164
+ /**
165
+ * @since 0.5.0-canary.3
166
+ */
167
+ type MessageScrollerItemProps = ComponentProps<"div"> & {
168
+ // Stable row id for scrollToMessage, visibility, and prepend preservation.
169
+ messageId?: string;
170
+ // Marks a turn boundary that newly appended anchors and last-anchor restore use.
171
+ isScrollAnchor?: boolean;
172
+ };
173
+
174
+ // State passed to MessageScrollerButton's render prop.
175
+ /**
176
+ * @since 0.5.0-canary.3
177
+ */
178
+ type MessageScrollerButtonRenderState = {
179
+ // Whether overflow exists toward this button's direction.
180
+ active: boolean;
181
+ direction: MessageScrollerButtonDirection;
182
+ };
183
+
184
+ // Scroll control for the start or end of the transcript.
185
+ /**
186
+ * @since 0.5.0-canary.3
187
+ */
188
+ type MessageScrollerButtonProps = UseRenderComponentProps<"button", MessageScrollerButtonRenderState> & {
189
+ // Native scroll behavior when clicked. Defaults to "smooth".
190
+ behavior?: ScrollBehavior;
191
+ // Transcript edge to scroll toward. Defaults to "end".
192
+ direction?: MessageScrollerButtonDirection;
193
+ };
194
+
195
+ // Minimal external store backing useMessageScrollerScrollable, consumed via
196
+ // useSyncExternalStore.
197
+ /**
198
+ * @since 0.5.0-canary.3
199
+ */
200
+ type MessageScrollerStore<T> = {
201
+ getSnapshot: () => T;
202
+ setSnapshot: (nextSnapshot: T) => void;
203
+ subscribe: (listener: () => void) => () => void;
204
+ };
205
+
206
+ // External store backing useMessageScrollerVisibility. Adds reference-counting so
207
+ // tracking stays lazy.
208
+ /**
209
+ * @since 0.5.0-canary.3
210
+ */
211
+ type MessageScrollerVisibilityStore = {
212
+ getSnapshot: () => MessageScrollerVisibilityState;
213
+ hasListeners: () => boolean;
214
+ setSnapshot: (nextSnapshot: MessageScrollerVisibilityState) => void;
215
+ subscribe: (listener: () => void, onFirstSubscribe: () => void, onLastUnsubscribe: () => void) => () => void;
216
+ };
217
+
218
+ // Registers (or, with removedElement, unregisters) a MessageScrollerItem node by
219
+ // messageId.
220
+ /**
221
+ * @since 0.5.0-canary.3
222
+ */
223
+ type MessageScrollerRegisterMessage = (
224
+ messageId: string,
225
+ element: HTMLElement | null,
226
+ removedElement?: HTMLElement | null,
227
+ ) => void;
228
+
229
+ // Internal context wiring the parts together. Not part of the public API.
230
+ /**
231
+ * @since 0.5.0-canary.3
232
+ */
233
+ type MessageScrollerContextValue = {
234
+ handleContentChange: () => void;
235
+ handleResize: () => void;
236
+ observeVisibility: () => void;
237
+ preserveScrollOnPrependRef: RefObject<boolean>;
238
+ scrollToEnd: (options?: MessageScrollerScrollOptions) => boolean;
239
+ scrollToMessage: (messageId: string, options?: MessageScrollerScrollOptions) => boolean;
240
+ scrollToStart: (options?: MessageScrollerScrollOptions) => boolean;
241
+ setContentElement: (element: HTMLDivElement | null) => void;
242
+ setRootElement: (element: HTMLDivElement | null) => void;
243
+ setSpacerElement: (element: HTMLDivElement | null) => void;
244
+ setViewportElement: (element: HTMLDivElement | null) => void;
245
+ stateStore: MessageScrollerStore<MessageScrollerScrollable>;
246
+ syncAfterScroll: () => void;
247
+ unobserveVisibility: () => void;
248
+ userScrollIntent: () => void;
249
+ viewportRef: RefObject<HTMLDivElement | null>;
250
+ visibilityStore: MessageScrollerVisibilityStore;
251
+ };
252
+
253
+ // Initial MessageScrollerScrollable before measurement. Stable reference for the
254
+ // server and first-render snapshot.
255
+ /**
256
+ * @since 0.5.0-canary.3
257
+ */
258
+ const EMPTY_MESSAGE_SCROLLER_SCROLLABLE: MessageScrollerScrollable = {
259
+ start: false,
260
+ end: false,
261
+ };
262
+
263
+ // Shared empty array so empty visibility snapshots stay referentially stable.
264
+ /**
265
+ * @since 0.5.0-canary.3
266
+ */
267
+ const EMPTY_VISIBLE_MESSAGE_IDS: Array<string> = [];
268
+
269
+ // Initial MessageScrollerVisibilityState. Nothing tracked, no current anchor.
270
+ /**
271
+ * @since 0.5.0-canary.3
272
+ */
273
+ const EMPTY_MESSAGE_SCROLLER_VISIBILITY_STATE: MessageScrollerVisibilityState = {
274
+ currentAnchorId: null,
275
+ visibleMessageIds: EMPTY_VISIBLE_MESSAGE_IDS,
276
+ };
277
+
278
+ export {
279
+ AUTOSCROLLING_CLEAR_DELAY,
280
+ DEFAULT_SCROLL_EDGE_THRESHOLD,
281
+ DEFAULT_SCROLL_MARGIN,
282
+ DEFAULT_SCROLL_PREVIOUS_ITEM_PEEK,
283
+ EMPTY_MESSAGE_SCROLLER_SCROLLABLE,
284
+ EMPTY_MESSAGE_SCROLLER_VISIBILITY_STATE,
285
+ EMPTY_VISIBLE_MESSAGE_IDS,
286
+ SCROLL_POSITION_EPSILON,
287
+ USER_SCROLL_KEYS,
288
+ };
289
+
290
+ export type {
291
+ MessageScrollerButtonDirection,
292
+ MessageScrollerButtonProps,
293
+ MessageScrollerButtonRenderState,
294
+ MessageScrollerContentProps,
295
+ MessageScrollerContextValue,
296
+ MessageScrollerDefaultScrollPosition,
297
+ MessageScrollerItemProps,
298
+ MessageScrollerMode,
299
+ MessageScrollerProps,
300
+ MessageScrollerProviderProps,
301
+ MessageScrollerRegisterMessage,
302
+ MessageScrollerScrollAlign,
303
+ MessageScrollerScrollOptions,
304
+ MessageScrollerScrollable,
305
+ MessageScrollerStore,
306
+ MessageScrollerViewportProps,
307
+ MessageScrollerVisibilityState,
308
+ MessageScrollerVisibilityStore,
309
+ };
@@ -0,0 +1,14 @@
1
+ import { useRef } from "react";
2
+
3
+ /**
4
+ * @since 0.5.0-canary.3
5
+ */
6
+ function useLatest<T>(value: T) {
7
+ const ref = useRef(value);
8
+
9
+ ref.current = value;
10
+
11
+ return ref;
12
+ }
13
+
14
+ export { useLatest };
@@ -0,0 +1,201 @@
1
+ // A poor man's version of Base UI's useRender (https://base-ui.com/react/utils/use-render):
2
+ // renders a default tag, a render function, or a cloned render element, merging
3
+ // props/refs/handlers. Backs the message-scroller primitives' `render` prop.
4
+ import type {
5
+ Attributes,
6
+ ComponentPropsWithRef,
7
+ CSSProperties,
8
+ ElementType,
9
+ ReactElement,
10
+ Ref,
11
+ RefCallback,
12
+ SyntheticEvent,
13
+ } from "react";
14
+ import { cloneElement, createElement, isValidElement } from "react";
15
+
16
+ type RenderState = Record<string, unknown>;
17
+
18
+ type RenderFunction<TState extends RenderState> = (
19
+ props: Record<string, unknown>,
20
+ state: TState,
21
+ ) => ReactElement | null;
22
+
23
+ type RenderProp<TState extends RenderState> = ReactElement | RenderFunction<TState>;
24
+
25
+ type StateAttributesMapping<TState extends RenderState> = Partial<{
26
+ [K in keyof TState]: (value: TState[K]) => Record<string, string | undefined> | null | undefined;
27
+ }>;
28
+
29
+ /**
30
+ * @since 0.5.0-canary.3
31
+ */
32
+ type UseRenderComponentProps<
33
+ TElement extends ElementType,
34
+ TState extends RenderState = RenderState,
35
+ > = ComponentPropsWithRef<TElement> & {
36
+ render?: RenderProp<TState>;
37
+ };
38
+
39
+ interface UseRenderOptions<TElement extends ElementType, TState extends RenderState> {
40
+ defaultTagName: TElement;
41
+ props?: ComponentPropsWithRef<TElement>;
42
+ render?: RenderProp<TState>;
43
+ state?: TState;
44
+ stateAttributesMapping?: StateAttributesMapping<TState>;
45
+ }
46
+
47
+ type EventHandler = (event: SyntheticEvent) => void;
48
+
49
+ function isEventHandler(key: string): boolean {
50
+ return /^on[A-Z]/.test(key);
51
+ }
52
+
53
+ function composeEventHandlers(theirs: EventHandler, ours: EventHandler) {
54
+ return function handleEvent(event: SyntheticEvent) {
55
+ theirs(event);
56
+
57
+ if (!event.defaultPrevented) {
58
+ ours(event);
59
+ }
60
+ };
61
+ }
62
+
63
+ /**
64
+ * @since 0.5.0-canary.3
65
+ */
66
+ function composeRefs<T>(...refs: Array<Ref<T> | undefined>): RefCallback<T> | undefined {
67
+ const validRefs = refs.filter(Boolean);
68
+
69
+ if (validRefs.length === 0) {
70
+ return undefined;
71
+ }
72
+
73
+ return (value) => {
74
+ for (const ref of validRefs) {
75
+ if (typeof ref === "function") {
76
+ ref(value);
77
+ } else if (ref) {
78
+ ref.current = value;
79
+ }
80
+ }
81
+ };
82
+ }
83
+
84
+ /**
85
+ * @since 0.5.0-canary.3
86
+ */
87
+ function mergeProps<TElement extends ElementType>(
88
+ ...sources: Array<ComponentPropsWithRef<TElement> | Record<string, unknown> | undefined>
89
+ ): ComponentPropsWithRef<TElement> {
90
+ const result: Record<string, unknown> = {};
91
+
92
+ for (const source of sources) {
93
+ if (!source) {
94
+ continue;
95
+ }
96
+
97
+ const sourceProps = source as Record<string, unknown>;
98
+
99
+ for (const key of Object.keys(sourceProps)) {
100
+ const value = sourceProps[key];
101
+
102
+ if (value === undefined) {
103
+ continue;
104
+ }
105
+
106
+ const current = result[key];
107
+
108
+ if (key === "className") {
109
+ result[key] = [current, value].filter(Boolean).join(" ");
110
+ } else if (key === "style") {
111
+ result[key] = {
112
+ ...(current as CSSProperties | undefined),
113
+ ...(value as CSSProperties | undefined),
114
+ };
115
+ } else if (key === "ref") {
116
+ result[key] = composeRefs(current as Ref<unknown> | undefined, value as Ref<unknown> | undefined);
117
+ } else if (isEventHandler(key) && typeof current === "function" && typeof value === "function") {
118
+ result[key] = composeEventHandlers(value as EventHandler, current as EventHandler);
119
+ } else {
120
+ result[key] = value;
121
+ }
122
+ }
123
+ }
124
+
125
+ return result as ComponentPropsWithRef<TElement>;
126
+ }
127
+
128
+ function getStateAttributes<TState extends RenderState>(
129
+ state: TState,
130
+ mapping?: StateAttributesMapping<TState>,
131
+ ): Record<string, unknown> {
132
+ const props: Record<string, unknown> = {};
133
+
134
+ for (const key of Object.keys(state) as Array<keyof TState>) {
135
+ const value = state[key];
136
+ const attributes = mapping?.[key]?.(value);
137
+
138
+ if (attributes) {
139
+ Object.assign(props, attributes);
140
+ continue;
141
+ }
142
+
143
+ if (key === "slot") {
144
+ props["data-slot"] = value;
145
+ continue;
146
+ }
147
+
148
+ const attribute = `data-${String(key).replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}`;
149
+
150
+ if (typeof value === "boolean") {
151
+ props[attribute] = value ? "" : undefined;
152
+ } else if (value !== null && value !== undefined) {
153
+ props[attribute] = String(value);
154
+ }
155
+ }
156
+
157
+ return props;
158
+ }
159
+
160
+ /**
161
+ * Resolve a component's `render` prop: a default element, a render function, or
162
+ * a cloned element, merging computed state attributes and props/refs/handlers.
163
+ *
164
+ * @since 0.5.0-canary.3
165
+ */
166
+ function useRender<TElement extends ElementType, TState extends RenderState = RenderState>({
167
+ defaultTagName,
168
+ props,
169
+ render,
170
+ state = {} as TState,
171
+ stateAttributesMapping,
172
+ }: UseRenderOptions<TElement, TState>): ReactElement | null {
173
+ const elementProps = mergeProps<TElement>(getStateAttributes(state, stateAttributesMapping), props);
174
+
175
+ if (!render) {
176
+ return createElement(defaultTagName, elementProps);
177
+ }
178
+
179
+ if (typeof render === "function") {
180
+ return render(elementProps, state);
181
+ }
182
+
183
+ if (!isValidElement(render)) {
184
+ return null;
185
+ }
186
+
187
+ const renderProps = render.props as Record<string, unknown>;
188
+ const propsWithRenderProps = mergeProps<TElement>(elementProps, renderProps);
189
+ const propsWithRef = {
190
+ ...propsWithRenderProps,
191
+ ref: composeRefs(
192
+ (elementProps as Record<string, unknown>).ref as Ref<unknown> | undefined,
193
+ renderProps.ref as Ref<unknown> | undefined,
194
+ ),
195
+ };
196
+
197
+ return cloneElement(render, propsWithRef as Attributes & Record<string, unknown>);
198
+ }
199
+
200
+ export { composeRefs, mergeProps, useRender };
201
+ export type { UseRenderComponentProps };