@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.
- package/CHANGELOG.md +51 -0
- package/dist/components/attachment.d.mts +136 -0
- package/dist/components/attachment.mjs +112 -0
- package/dist/components/avatar.mjs +1 -1
- package/dist/components/breadcrumb.d.mts +2 -4
- package/dist/components/bubble.d.mts +67 -0
- package/dist/components/bubble.mjs +58 -0
- package/dist/components/card.mjs +2 -2
- package/dist/components/carousel.mjs +12 -3
- package/dist/components/empty.mjs +1 -1
- package/dist/components/marker.d.mts +49 -0
- package/dist/components/marker.mjs +42 -0
- package/dist/components/message-scroller.d.mts +89 -0
- package/dist/components/message-scroller.mjs +77 -0
- package/dist/components/message.d.mts +86 -0
- package/dist/components/message.mjs +66 -0
- package/dist/components/progress-circle.d.mts +4 -4
- package/dist/components/progress-circle.mjs +7 -7
- package/dist/components/sidebar.mjs +6 -3
- package/dist/hooks/use-animated-value.d.mts +2 -2
- package/dist/hooks/use-animated-value.mjs +4 -4
- package/dist/hooks/use-message-scroller-commands.d.mts +39 -0
- package/dist/hooks/use-message-scroller-commands.mjs +165 -0
- package/dist/hooks/use-message-scroller-controller.d.mts +19 -0
- package/dist/hooks/use-message-scroller-controller.mjs +382 -0
- package/dist/hooks/use-message-scroller-refs.d.mts +60 -0
- package/dist/hooks/use-message-scroller-refs.mjs +77 -0
- package/dist/hooks/use-pagination.d.mts +4 -4
- package/dist/hooks/use-pagination.mjs +1 -1
- package/dist/index.d.mts +12 -2
- package/dist/index.mjs +11 -2
- package/dist/lib/message-scroller/geometry.d.mts +136 -0
- package/dist/lib/message-scroller/geometry.mjs +199 -0
- package/dist/lib/message-scroller/stores.d.mts +21 -0
- package/dist/lib/message-scroller/stores.mjs +52 -0
- package/dist/lib/message-scroller/types.d.mts +171 -0
- package/dist/lib/message-scroller/types.mjs +53 -0
- package/dist/lib/message-scroller/utils.d.mts +7 -0
- package/dist/lib/message-scroller/utils.mjs +12 -0
- package/dist/lib/use-render.d.mts +43 -0
- package/dist/lib/use-render.mjs +84 -0
- package/dist/primitives/message-scroller.d.mts +88 -0
- package/dist/primitives/message-scroller.mjs +240 -0
- package/dist/variants/attachment.d.mts +42 -0
- package/dist/variants/attachment.mjs +42 -0
- package/dist/variants/bubble.d.mts +45 -0
- package/dist/variants/bubble.mjs +45 -0
- package/dist/variants/marker.d.mts +21 -0
- package/dist/variants/marker.mjs +18 -0
- package/package.json +93 -7
- package/src/components/attachment.tsx +284 -0
- package/src/components/avatar.tsx +1 -1
- package/src/components/breadcrumb.tsx +2 -4
- package/src/components/bubble.tsx +116 -0
- package/src/components/card.tsx +2 -2
- package/src/components/carousel.tsx +12 -3
- package/src/components/empty.tsx +1 -1
- package/src/components/marker.tsx +94 -0
- package/src/components/message-scroller.tsx +213 -0
- package/src/components/message.tsx +173 -0
- package/src/components/progress-circle.tsx +11 -11
- package/src/components/sidebar.tsx +11 -4
- package/src/css/foundation/tokens.css +6 -18
- package/src/css/foundation/utilities.css +451 -0
- package/src/css/preset.css +2 -1
- package/src/hooks/use-animated-value.ts +4 -4
- package/src/hooks/use-message-scroller-commands.ts +311 -0
- package/src/hooks/use-message-scroller-controller.ts +650 -0
- package/src/hooks/use-message-scroller-refs.ts +167 -0
- package/src/hooks/use-pagination.ts +3 -3
- package/src/index.ts +73 -1
- package/src/lib/message-scroller/geometry.ts +397 -0
- package/src/lib/message-scroller/stores.ts +88 -0
- package/src/lib/message-scroller/types.ts +309 -0
- package/src/lib/message-scroller/utils.ts +14 -0
- package/src/lib/use-render.ts +201 -0
- package/src/primitives/message-scroller.tsx +403 -0
- package/src/variants/attachment.ts +73 -0
- package/src/variants/bubble.ts +81 -0
- package/src/variants/marker.ts +38 -0
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
import { UseRenderComponentProps } from "../use-render.mjs";
|
|
2
|
+
import { ComponentProps, ReactNode, RefObject } from "react";
|
|
3
|
+
|
|
4
|
+
//#region src/lib/message-scroller/types.d.ts
|
|
5
|
+
/**
|
|
6
|
+
* @since 0.5.0-canary.3
|
|
7
|
+
*/
|
|
8
|
+
declare const DEFAULT_SCROLL_EDGE_THRESHOLD = 8;
|
|
9
|
+
/**
|
|
10
|
+
* @since 0.5.0-canary.3
|
|
11
|
+
*/
|
|
12
|
+
declare const DEFAULT_SCROLL_PREVIOUS_ITEM_PEEK = 64;
|
|
13
|
+
/**
|
|
14
|
+
* @since 0.5.0-canary.3
|
|
15
|
+
*/
|
|
16
|
+
declare const DEFAULT_SCROLL_MARGIN = 0;
|
|
17
|
+
/**
|
|
18
|
+
* @since 0.5.0-canary.3
|
|
19
|
+
*/
|
|
20
|
+
declare const SCROLL_POSITION_EPSILON = 0.5;
|
|
21
|
+
/**
|
|
22
|
+
* @since 0.5.0-canary.3
|
|
23
|
+
*/
|
|
24
|
+
declare const AUTOSCROLLING_CLEAR_DELAY = 180;
|
|
25
|
+
/**
|
|
26
|
+
* @since 0.5.0-canary.3
|
|
27
|
+
*/
|
|
28
|
+
declare const USER_SCROLL_KEYS: Set<string>;
|
|
29
|
+
/**
|
|
30
|
+
* @since 0.5.0-canary.3
|
|
31
|
+
*/
|
|
32
|
+
type MessageScrollerMode = "following-bottom" | "free-scrolling" | "anchored-to-message" | "settling-jump";
|
|
33
|
+
/**
|
|
34
|
+
* @since 0.5.0-canary.3
|
|
35
|
+
*/
|
|
36
|
+
type MessageScrollerDefaultScrollPosition = "start" | "end" | "last-anchor";
|
|
37
|
+
/**
|
|
38
|
+
* @since 0.5.0-canary.3
|
|
39
|
+
*/
|
|
40
|
+
type MessageScrollerButtonDirection = "start" | "end";
|
|
41
|
+
/**
|
|
42
|
+
* @since 0.5.0-canary.3
|
|
43
|
+
*/
|
|
44
|
+
type MessageScrollerScrollAlign = "start" | "center" | "end" | "nearest";
|
|
45
|
+
/**
|
|
46
|
+
* @since 0.5.0-canary.3
|
|
47
|
+
*/
|
|
48
|
+
type MessageScrollerScrollOptions = {
|
|
49
|
+
align?: MessageScrollerScrollAlign;
|
|
50
|
+
behavior?: ScrollBehavior;
|
|
51
|
+
scrollMargin?: number;
|
|
52
|
+
};
|
|
53
|
+
/**
|
|
54
|
+
* @since 0.5.0-canary.3
|
|
55
|
+
*/
|
|
56
|
+
type MessageScrollerScrollable = {
|
|
57
|
+
start: boolean;
|
|
58
|
+
end: boolean;
|
|
59
|
+
};
|
|
60
|
+
/**
|
|
61
|
+
* @since 0.5.0-canary.3
|
|
62
|
+
*/
|
|
63
|
+
type MessageScrollerVisibilityState = {
|
|
64
|
+
currentAnchorId: string | null;
|
|
65
|
+
visibleMessageIds: Array<string>;
|
|
66
|
+
};
|
|
67
|
+
/**
|
|
68
|
+
* @since 0.5.0-canary.3
|
|
69
|
+
*/
|
|
70
|
+
type MessageScrollerProviderProps = {
|
|
71
|
+
children?: ReactNode;
|
|
72
|
+
autoScroll?: boolean;
|
|
73
|
+
defaultScrollPosition?: MessageScrollerDefaultScrollPosition;
|
|
74
|
+
scrollEdgeThreshold?: number;
|
|
75
|
+
scrollPreviousItemPeek?: number;
|
|
76
|
+
scrollMargin?: number;
|
|
77
|
+
};
|
|
78
|
+
/**
|
|
79
|
+
* @since 0.5.0-canary.3
|
|
80
|
+
*/
|
|
81
|
+
type MessageScrollerProps = ComponentProps<"div">;
|
|
82
|
+
/**
|
|
83
|
+
* @since 0.5.0-canary.3
|
|
84
|
+
*/
|
|
85
|
+
type MessageScrollerViewportProps = ComponentProps<"div"> & {
|
|
86
|
+
preserveScrollOnPrepend?: boolean;
|
|
87
|
+
};
|
|
88
|
+
/**
|
|
89
|
+
* @since 0.5.0-canary.3
|
|
90
|
+
*/
|
|
91
|
+
type MessageScrollerContentProps = ComponentProps<"div"> & {
|
|
92
|
+
spacerClassName?: string;
|
|
93
|
+
};
|
|
94
|
+
/**
|
|
95
|
+
* @since 0.5.0-canary.3
|
|
96
|
+
*/
|
|
97
|
+
type MessageScrollerItemProps = ComponentProps<"div"> & {
|
|
98
|
+
messageId?: string;
|
|
99
|
+
isScrollAnchor?: boolean;
|
|
100
|
+
};
|
|
101
|
+
/**
|
|
102
|
+
* @since 0.5.0-canary.3
|
|
103
|
+
*/
|
|
104
|
+
type MessageScrollerButtonRenderState = {
|
|
105
|
+
active: boolean;
|
|
106
|
+
direction: MessageScrollerButtonDirection;
|
|
107
|
+
};
|
|
108
|
+
/**
|
|
109
|
+
* @since 0.5.0-canary.3
|
|
110
|
+
*/
|
|
111
|
+
type MessageScrollerButtonProps = UseRenderComponentProps<"button", MessageScrollerButtonRenderState> & {
|
|
112
|
+
behavior?: ScrollBehavior;
|
|
113
|
+
direction?: MessageScrollerButtonDirection;
|
|
114
|
+
};
|
|
115
|
+
/**
|
|
116
|
+
* @since 0.5.0-canary.3
|
|
117
|
+
*/
|
|
118
|
+
type MessageScrollerStore<T> = {
|
|
119
|
+
getSnapshot: () => T;
|
|
120
|
+
setSnapshot: (nextSnapshot: T) => void;
|
|
121
|
+
subscribe: (listener: () => void) => () => void;
|
|
122
|
+
};
|
|
123
|
+
/**
|
|
124
|
+
* @since 0.5.0-canary.3
|
|
125
|
+
*/
|
|
126
|
+
type MessageScrollerVisibilityStore = {
|
|
127
|
+
getSnapshot: () => MessageScrollerVisibilityState;
|
|
128
|
+
hasListeners: () => boolean;
|
|
129
|
+
setSnapshot: (nextSnapshot: MessageScrollerVisibilityState) => void;
|
|
130
|
+
subscribe: (listener: () => void, onFirstSubscribe: () => void, onLastUnsubscribe: () => void) => () => void;
|
|
131
|
+
};
|
|
132
|
+
/**
|
|
133
|
+
* @since 0.5.0-canary.3
|
|
134
|
+
*/
|
|
135
|
+
type MessageScrollerRegisterMessage = (messageId: string, element: HTMLElement | null, removedElement?: HTMLElement | null) => void;
|
|
136
|
+
/**
|
|
137
|
+
* @since 0.5.0-canary.3
|
|
138
|
+
*/
|
|
139
|
+
type MessageScrollerContextValue = {
|
|
140
|
+
handleContentChange: () => void;
|
|
141
|
+
handleResize: () => void;
|
|
142
|
+
observeVisibility: () => void;
|
|
143
|
+
preserveScrollOnPrependRef: RefObject<boolean>;
|
|
144
|
+
scrollToEnd: (options?: MessageScrollerScrollOptions) => boolean;
|
|
145
|
+
scrollToMessage: (messageId: string, options?: MessageScrollerScrollOptions) => boolean;
|
|
146
|
+
scrollToStart: (options?: MessageScrollerScrollOptions) => boolean;
|
|
147
|
+
setContentElement: (element: HTMLDivElement | null) => void;
|
|
148
|
+
setRootElement: (element: HTMLDivElement | null) => void;
|
|
149
|
+
setSpacerElement: (element: HTMLDivElement | null) => void;
|
|
150
|
+
setViewportElement: (element: HTMLDivElement | null) => void;
|
|
151
|
+
stateStore: MessageScrollerStore<MessageScrollerScrollable>;
|
|
152
|
+
syncAfterScroll: () => void;
|
|
153
|
+
unobserveVisibility: () => void;
|
|
154
|
+
userScrollIntent: () => void;
|
|
155
|
+
viewportRef: RefObject<HTMLDivElement | null>;
|
|
156
|
+
visibilityStore: MessageScrollerVisibilityStore;
|
|
157
|
+
};
|
|
158
|
+
/**
|
|
159
|
+
* @since 0.5.0-canary.3
|
|
160
|
+
*/
|
|
161
|
+
declare const EMPTY_MESSAGE_SCROLLER_SCROLLABLE: MessageScrollerScrollable;
|
|
162
|
+
/**
|
|
163
|
+
* @since 0.5.0-canary.3
|
|
164
|
+
*/
|
|
165
|
+
declare const EMPTY_VISIBLE_MESSAGE_IDS: Array<string>;
|
|
166
|
+
/**
|
|
167
|
+
* @since 0.5.0-canary.3
|
|
168
|
+
*/
|
|
169
|
+
declare const EMPTY_MESSAGE_SCROLLER_VISIBILITY_STATE: MessageScrollerVisibilityState;
|
|
170
|
+
//#endregion
|
|
171
|
+
export { AUTOSCROLLING_CLEAR_DELAY, DEFAULT_SCROLL_EDGE_THRESHOLD, DEFAULT_SCROLL_MARGIN, DEFAULT_SCROLL_PREVIOUS_ITEM_PEEK, EMPTY_MESSAGE_SCROLLER_SCROLLABLE, EMPTY_MESSAGE_SCROLLER_VISIBILITY_STATE, EMPTY_VISIBLE_MESSAGE_IDS, type MessageScrollerButtonDirection, type MessageScrollerButtonProps, type MessageScrollerButtonRenderState, type MessageScrollerContentProps, type MessageScrollerContextValue, type MessageScrollerDefaultScrollPosition, type MessageScrollerItemProps, type MessageScrollerMode, type MessageScrollerProps, type MessageScrollerProviderProps, type MessageScrollerRegisterMessage, type MessageScrollerScrollAlign, type MessageScrollerScrollOptions, type MessageScrollerScrollable, type MessageScrollerStore, type MessageScrollerViewportProps, type MessageScrollerVisibilityState, type MessageScrollerVisibilityStore, SCROLL_POSITION_EPSILON, USER_SCROLL_KEYS };
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
//#region src/lib/message-scroller/types.ts
|
|
2
|
+
/**
|
|
3
|
+
* @since 0.5.0-canary.3
|
|
4
|
+
*/
|
|
5
|
+
const DEFAULT_SCROLL_EDGE_THRESHOLD = 8;
|
|
6
|
+
/**
|
|
7
|
+
* @since 0.5.0-canary.3
|
|
8
|
+
*/
|
|
9
|
+
const DEFAULT_SCROLL_PREVIOUS_ITEM_PEEK = 64;
|
|
10
|
+
/**
|
|
11
|
+
* @since 0.5.0-canary.3
|
|
12
|
+
*/
|
|
13
|
+
const DEFAULT_SCROLL_MARGIN = 0;
|
|
14
|
+
/**
|
|
15
|
+
* @since 0.5.0-canary.3
|
|
16
|
+
*/
|
|
17
|
+
const SCROLL_POSITION_EPSILON = .5;
|
|
18
|
+
/**
|
|
19
|
+
* @since 0.5.0-canary.3
|
|
20
|
+
*/
|
|
21
|
+
const AUTOSCROLLING_CLEAR_DELAY = 180;
|
|
22
|
+
/**
|
|
23
|
+
* @since 0.5.0-canary.3
|
|
24
|
+
*/
|
|
25
|
+
const USER_SCROLL_KEYS = /* @__PURE__ */ new Set([
|
|
26
|
+
"ArrowDown",
|
|
27
|
+
"ArrowUp",
|
|
28
|
+
"End",
|
|
29
|
+
"Home",
|
|
30
|
+
"PageDown",
|
|
31
|
+
"PageUp",
|
|
32
|
+
" "
|
|
33
|
+
]);
|
|
34
|
+
/**
|
|
35
|
+
* @since 0.5.0-canary.3
|
|
36
|
+
*/
|
|
37
|
+
const EMPTY_MESSAGE_SCROLLER_SCROLLABLE = {
|
|
38
|
+
start: false,
|
|
39
|
+
end: false
|
|
40
|
+
};
|
|
41
|
+
/**
|
|
42
|
+
* @since 0.5.0-canary.3
|
|
43
|
+
*/
|
|
44
|
+
const EMPTY_VISIBLE_MESSAGE_IDS = [];
|
|
45
|
+
/**
|
|
46
|
+
* @since 0.5.0-canary.3
|
|
47
|
+
*/
|
|
48
|
+
const EMPTY_MESSAGE_SCROLLER_VISIBILITY_STATE = {
|
|
49
|
+
currentAnchorId: null,
|
|
50
|
+
visibleMessageIds: EMPTY_VISIBLE_MESSAGE_IDS
|
|
51
|
+
};
|
|
52
|
+
//#endregion
|
|
53
|
+
export { AUTOSCROLLING_CLEAR_DELAY, DEFAULT_SCROLL_EDGE_THRESHOLD, DEFAULT_SCROLL_MARGIN, DEFAULT_SCROLL_PREVIOUS_ITEM_PEEK, EMPTY_MESSAGE_SCROLLER_SCROLLABLE, EMPTY_MESSAGE_SCROLLER_VISIBILITY_STATE, EMPTY_VISIBLE_MESSAGE_IDS, SCROLL_POSITION_EPSILON, USER_SCROLL_KEYS };
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import { ComponentPropsWithRef, ElementType, ReactElement, Ref, RefCallback } from "react";
|
|
2
|
+
|
|
3
|
+
//#region src/lib/use-render.d.ts
|
|
4
|
+
type RenderState = Record<string, unknown>;
|
|
5
|
+
type RenderFunction<TState extends RenderState> = (props: Record<string, unknown>, state: TState) => ReactElement | null;
|
|
6
|
+
type RenderProp<TState extends RenderState> = ReactElement | RenderFunction<TState>;
|
|
7
|
+
type StateAttributesMapping<TState extends RenderState> = Partial<{ [K in keyof TState]: (value: TState[K]) => Record<string, string | undefined> | null | undefined }>;
|
|
8
|
+
/**
|
|
9
|
+
* @since 0.5.0-canary.3
|
|
10
|
+
*/
|
|
11
|
+
type UseRenderComponentProps<TElement extends ElementType, TState extends RenderState = RenderState> = ComponentPropsWithRef<TElement> & {
|
|
12
|
+
render?: RenderProp<TState>;
|
|
13
|
+
};
|
|
14
|
+
interface UseRenderOptions<TElement extends ElementType, TState extends RenderState> {
|
|
15
|
+
defaultTagName: TElement;
|
|
16
|
+
props?: ComponentPropsWithRef<TElement>;
|
|
17
|
+
render?: RenderProp<TState>;
|
|
18
|
+
state?: TState;
|
|
19
|
+
stateAttributesMapping?: StateAttributesMapping<TState>;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* @since 0.5.0-canary.3
|
|
23
|
+
*/
|
|
24
|
+
declare function composeRefs<T>(...refs: Array<Ref<T> | undefined>): RefCallback<T> | undefined;
|
|
25
|
+
/**
|
|
26
|
+
* @since 0.5.0-canary.3
|
|
27
|
+
*/
|
|
28
|
+
declare function mergeProps<TElement extends ElementType>(...sources: Array<ComponentPropsWithRef<TElement> | Record<string, unknown> | undefined>): ComponentPropsWithRef<TElement>;
|
|
29
|
+
/**
|
|
30
|
+
* Resolve a component's `render` prop: a default element, a render function, or
|
|
31
|
+
* a cloned element, merging computed state attributes and props/refs/handlers.
|
|
32
|
+
*
|
|
33
|
+
* @since 0.5.0-canary.3
|
|
34
|
+
*/
|
|
35
|
+
declare function useRender<TElement extends ElementType, TState extends RenderState = RenderState>({
|
|
36
|
+
defaultTagName,
|
|
37
|
+
props,
|
|
38
|
+
render,
|
|
39
|
+
state,
|
|
40
|
+
stateAttributesMapping
|
|
41
|
+
}: UseRenderOptions<TElement, TState>): ReactElement | null;
|
|
42
|
+
//#endregion
|
|
43
|
+
export { type UseRenderComponentProps, composeRefs, mergeProps, useRender };
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
import { cloneElement, createElement, isValidElement } from "react";
|
|
2
|
+
//#region src/lib/use-render.ts
|
|
3
|
+
function isEventHandler(key) {
|
|
4
|
+
return /^on[A-Z]/.test(key);
|
|
5
|
+
}
|
|
6
|
+
function composeEventHandlers(theirs, ours) {
|
|
7
|
+
return function handleEvent(event) {
|
|
8
|
+
theirs(event);
|
|
9
|
+
if (!event.defaultPrevented) ours(event);
|
|
10
|
+
};
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* @since 0.5.0-canary.3
|
|
14
|
+
*/
|
|
15
|
+
function composeRefs(...refs) {
|
|
16
|
+
const validRefs = refs.filter(Boolean);
|
|
17
|
+
if (validRefs.length === 0) return;
|
|
18
|
+
return (value) => {
|
|
19
|
+
for (const ref of validRefs) if (typeof ref === "function") ref(value);
|
|
20
|
+
else if (ref) ref.current = value;
|
|
21
|
+
};
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* @since 0.5.0-canary.3
|
|
25
|
+
*/
|
|
26
|
+
function mergeProps(...sources) {
|
|
27
|
+
const result = {};
|
|
28
|
+
for (const source of sources) {
|
|
29
|
+
if (!source) continue;
|
|
30
|
+
const sourceProps = source;
|
|
31
|
+
for (const key of Object.keys(sourceProps)) {
|
|
32
|
+
const value = sourceProps[key];
|
|
33
|
+
if (value === void 0) continue;
|
|
34
|
+
const current = result[key];
|
|
35
|
+
if (key === "className") result[key] = [current, value].filter(Boolean).join(" ");
|
|
36
|
+
else if (key === "style") result[key] = {
|
|
37
|
+
...current,
|
|
38
|
+
...value
|
|
39
|
+
};
|
|
40
|
+
else if (key === "ref") result[key] = composeRefs(current, value);
|
|
41
|
+
else if (isEventHandler(key) && typeof current === "function" && typeof value === "function") result[key] = composeEventHandlers(value, current);
|
|
42
|
+
else result[key] = value;
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
return result;
|
|
46
|
+
}
|
|
47
|
+
function getStateAttributes(state, mapping) {
|
|
48
|
+
const props = {};
|
|
49
|
+
for (const key of Object.keys(state)) {
|
|
50
|
+
const value = state[key];
|
|
51
|
+
const attributes = mapping?.[key]?.(value);
|
|
52
|
+
if (attributes) {
|
|
53
|
+
Object.assign(props, attributes);
|
|
54
|
+
continue;
|
|
55
|
+
}
|
|
56
|
+
if (key === "slot") {
|
|
57
|
+
props["data-slot"] = value;
|
|
58
|
+
continue;
|
|
59
|
+
}
|
|
60
|
+
const attribute = `data-${String(key).replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}`;
|
|
61
|
+
if (typeof value === "boolean") props[attribute] = value ? "" : void 0;
|
|
62
|
+
else if (value !== null && value !== void 0) props[attribute] = String(value);
|
|
63
|
+
}
|
|
64
|
+
return props;
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Resolve a component's `render` prop: a default element, a render function, or
|
|
68
|
+
* a cloned element, merging computed state attributes and props/refs/handlers.
|
|
69
|
+
*
|
|
70
|
+
* @since 0.5.0-canary.3
|
|
71
|
+
*/
|
|
72
|
+
function useRender({ defaultTagName, props, render, state = {}, stateAttributesMapping }) {
|
|
73
|
+
const elementProps = mergeProps(getStateAttributes(state, stateAttributesMapping), props);
|
|
74
|
+
if (!render) return createElement(defaultTagName, elementProps);
|
|
75
|
+
if (typeof render === "function") return render(elementProps, state);
|
|
76
|
+
if (!isValidElement(render)) return null;
|
|
77
|
+
const renderProps = render.props;
|
|
78
|
+
return cloneElement(render, {
|
|
79
|
+
...mergeProps(elementProps, renderProps),
|
|
80
|
+
ref: composeRefs(elementProps.ref, renderProps.ref)
|
|
81
|
+
});
|
|
82
|
+
}
|
|
83
|
+
//#endregion
|
|
84
|
+
export { composeRefs, mergeProps, useRender };
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import { MessageScrollerButtonProps, MessageScrollerContentProps, MessageScrollerItemProps, MessageScrollerProps, MessageScrollerProviderProps, MessageScrollerScrollOptions, MessageScrollerScrollable, MessageScrollerViewportProps, MessageScrollerVisibilityState } from "../lib/message-scroller/types.mjs";
|
|
2
|
+
|
|
3
|
+
//#region src/primitives/message-scroller.d.ts
|
|
4
|
+
/**
|
|
5
|
+
* @since 0.5.0-canary.3
|
|
6
|
+
*/
|
|
7
|
+
declare function useMessageScroller(): {
|
|
8
|
+
scrollToEnd: (options?: MessageScrollerScrollOptions) => boolean;
|
|
9
|
+
scrollToMessage: (messageId: string, options?: MessageScrollerScrollOptions) => boolean;
|
|
10
|
+
scrollToStart: (options?: MessageScrollerScrollOptions) => boolean;
|
|
11
|
+
};
|
|
12
|
+
/**
|
|
13
|
+
* @since 0.5.0-canary.3
|
|
14
|
+
*/
|
|
15
|
+
declare function useMessageScrollerScrollable(): MessageScrollerScrollable;
|
|
16
|
+
/**
|
|
17
|
+
* @since 0.5.0-canary.3
|
|
18
|
+
*/
|
|
19
|
+
declare function useMessageScrollerVisibility(): MessageScrollerVisibilityState;
|
|
20
|
+
/**
|
|
21
|
+
* @since 0.5.0-canary.3
|
|
22
|
+
*/
|
|
23
|
+
declare function MessageScrollerProvider({
|
|
24
|
+
autoScroll,
|
|
25
|
+
children,
|
|
26
|
+
defaultScrollPosition,
|
|
27
|
+
scrollEdgeThreshold,
|
|
28
|
+
scrollPreviousItemPeek,
|
|
29
|
+
scrollMargin
|
|
30
|
+
}: MessageScrollerProviderProps): import("react").JSX.Element;
|
|
31
|
+
/**
|
|
32
|
+
* @since 0.5.0-canary.3
|
|
33
|
+
*/
|
|
34
|
+
declare function MessageScroller({
|
|
35
|
+
children,
|
|
36
|
+
...props
|
|
37
|
+
}: MessageScrollerProps): import("react").JSX.Element;
|
|
38
|
+
/**
|
|
39
|
+
* @since 0.5.0-canary.3
|
|
40
|
+
*/
|
|
41
|
+
declare function MessageScrollerViewport({
|
|
42
|
+
"aria-label": ariaLabel,
|
|
43
|
+
children,
|
|
44
|
+
onKeyDown,
|
|
45
|
+
onScroll,
|
|
46
|
+
onTouchMove,
|
|
47
|
+
onWheel,
|
|
48
|
+
preserveScrollOnPrepend,
|
|
49
|
+
ref,
|
|
50
|
+
role,
|
|
51
|
+
tabIndex,
|
|
52
|
+
...props
|
|
53
|
+
}: MessageScrollerViewportProps): import("react").JSX.Element;
|
|
54
|
+
/**
|
|
55
|
+
* @since 0.5.0-canary.3
|
|
56
|
+
*/
|
|
57
|
+
declare function MessageScrollerContent({
|
|
58
|
+
"aria-relevant": ariaRelevant,
|
|
59
|
+
children,
|
|
60
|
+
ref,
|
|
61
|
+
role,
|
|
62
|
+
spacerClassName,
|
|
63
|
+
...props
|
|
64
|
+
}: MessageScrollerContentProps): import("react").JSX.Element;
|
|
65
|
+
/**
|
|
66
|
+
* @since 0.5.0-canary.3
|
|
67
|
+
*/
|
|
68
|
+
declare function MessageScrollerItem({
|
|
69
|
+
messageId,
|
|
70
|
+
ref,
|
|
71
|
+
isScrollAnchor,
|
|
72
|
+
...props
|
|
73
|
+
}: MessageScrollerItemProps): import("react").JSX.Element;
|
|
74
|
+
/**
|
|
75
|
+
* @since 0.5.0-canary.3
|
|
76
|
+
*/
|
|
77
|
+
declare function MessageScrollerButton({
|
|
78
|
+
behavior,
|
|
79
|
+
children,
|
|
80
|
+
direction,
|
|
81
|
+
onClick,
|
|
82
|
+
render,
|
|
83
|
+
tabIndex,
|
|
84
|
+
type,
|
|
85
|
+
...props
|
|
86
|
+
}: MessageScrollerButtonProps): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | null;
|
|
87
|
+
//#endregion
|
|
88
|
+
export { MessageScroller, MessageScrollerButton, MessageScrollerContent, MessageScrollerItem, MessageScrollerProvider, MessageScrollerViewport, useMessageScroller, useMessageScrollerScrollable, useMessageScrollerVisibility };
|
|
@@ -0,0 +1,240 @@
|
|
|
1
|
+
import { USER_SCROLL_KEYS } from "../lib/message-scroller/types.mjs";
|
|
2
|
+
import { useMessageScrollerController } from "../hooks/use-message-scroller-controller.mjs";
|
|
3
|
+
import { useLatest } from "../lib/message-scroller/utils.mjs";
|
|
4
|
+
import { composeRefs, mergeProps, useRender } from "../lib/use-render.mjs";
|
|
5
|
+
import { jsx, jsxs } from "react/jsx-runtime";
|
|
6
|
+
import { createContext, useCallback, useContext, useEffect, useLayoutEffect, useMemo, useRef, useSyncExternalStore } from "react";
|
|
7
|
+
//#region src/primitives/message-scroller.tsx
|
|
8
|
+
const MessageScrollerContext = createContext(null);
|
|
9
|
+
const MessageScrollerItemContext = createContext(null);
|
|
10
|
+
function useMessageScrollerContext() {
|
|
11
|
+
const context = useContext(MessageScrollerContext);
|
|
12
|
+
if (!context) throw new Error("useMessageScroller must be used within a MessageScroller.");
|
|
13
|
+
return context;
|
|
14
|
+
}
|
|
15
|
+
function useMessageScrollerItemContext() {
|
|
16
|
+
const context = useContext(MessageScrollerItemContext);
|
|
17
|
+
if (!context) throw new Error("MessageScrollerItem must be used within a MessageScroller.");
|
|
18
|
+
return context;
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* @since 0.5.0-canary.3
|
|
22
|
+
*/
|
|
23
|
+
function useMessageScroller() {
|
|
24
|
+
const { scrollToEnd, scrollToMessage, scrollToStart } = useMessageScrollerContext();
|
|
25
|
+
return useMemo(() => ({
|
|
26
|
+
scrollToEnd,
|
|
27
|
+
scrollToMessage,
|
|
28
|
+
scrollToStart
|
|
29
|
+
}), [
|
|
30
|
+
scrollToEnd,
|
|
31
|
+
scrollToMessage,
|
|
32
|
+
scrollToStart
|
|
33
|
+
]);
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* @since 0.5.0-canary.3
|
|
37
|
+
*/
|
|
38
|
+
function useMessageScrollerScrollable() {
|
|
39
|
+
const { stateStore } = useMessageScrollerContext();
|
|
40
|
+
return useSyncExternalStore(stateStore.subscribe, stateStore.getSnapshot, stateStore.getSnapshot);
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* @since 0.5.0-canary.3
|
|
44
|
+
*/
|
|
45
|
+
function useMessageScrollerVisibility() {
|
|
46
|
+
const { observeVisibility, unobserveVisibility, visibilityStore } = useMessageScrollerContext();
|
|
47
|
+
return useSyncExternalStore(useCallback((listener) => visibilityStore.subscribe(listener, observeVisibility, unobserveVisibility), [
|
|
48
|
+
observeVisibility,
|
|
49
|
+
unobserveVisibility,
|
|
50
|
+
visibilityStore
|
|
51
|
+
]), visibilityStore.getSnapshot, visibilityStore.getSnapshot);
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
* @since 0.5.0-canary.3
|
|
55
|
+
*/
|
|
56
|
+
function MessageScrollerProvider({ autoScroll = false, children, defaultScrollPosition = "end", scrollEdgeThreshold, scrollPreviousItemPeek, scrollMargin }) {
|
|
57
|
+
const { context, registerMessage } = useMessageScrollerController({
|
|
58
|
+
autoScroll,
|
|
59
|
+
defaultScrollPosition,
|
|
60
|
+
scrollEdgeThreshold,
|
|
61
|
+
scrollPreviousItemPeek,
|
|
62
|
+
scrollMargin
|
|
63
|
+
});
|
|
64
|
+
return /* @__PURE__ */ jsx(MessageScrollerContext.Provider, {
|
|
65
|
+
value: context,
|
|
66
|
+
children: /* @__PURE__ */ jsx(MessageScrollerItemContext.Provider, {
|
|
67
|
+
value: registerMessage,
|
|
68
|
+
children
|
|
69
|
+
})
|
|
70
|
+
});
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* @since 0.5.0-canary.3
|
|
74
|
+
*/
|
|
75
|
+
function MessageScroller({ children, ...props }) {
|
|
76
|
+
const { setRootElement } = useMessageScrollerContext();
|
|
77
|
+
return /* @__PURE__ */ jsx("div", {
|
|
78
|
+
ref: setRootElement,
|
|
79
|
+
...props,
|
|
80
|
+
children
|
|
81
|
+
});
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* @since 0.5.0-canary.3
|
|
85
|
+
*/
|
|
86
|
+
function MessageScrollerViewport({ "aria-label": ariaLabel, children, onKeyDown, onScroll, onTouchMove, onWheel, preserveScrollOnPrepend = true, ref, role, tabIndex, ...props }) {
|
|
87
|
+
const { handleResize, preserveScrollOnPrependRef, setViewportElement, syncAfterScroll, userScrollIntent, viewportRef } = useMessageScrollerContext();
|
|
88
|
+
preserveScrollOnPrependRef.current = preserveScrollOnPrepend;
|
|
89
|
+
const setViewportRef = useCallback((element) => {
|
|
90
|
+
setViewportElement(element);
|
|
91
|
+
composeRefs(ref)?.(element);
|
|
92
|
+
}, [ref, setViewportElement]);
|
|
93
|
+
function handleScroll(event) {
|
|
94
|
+
syncAfterScroll();
|
|
95
|
+
onScroll?.(event);
|
|
96
|
+
}
|
|
97
|
+
function handleWheel(event) {
|
|
98
|
+
userScrollIntent();
|
|
99
|
+
onWheel?.(event);
|
|
100
|
+
}
|
|
101
|
+
function handleTouchMove(event) {
|
|
102
|
+
userScrollIntent();
|
|
103
|
+
onTouchMove?.(event);
|
|
104
|
+
}
|
|
105
|
+
function handleKeyDown(event) {
|
|
106
|
+
if (USER_SCROLL_KEYS.has(event.key)) userScrollIntent();
|
|
107
|
+
onKeyDown?.(event);
|
|
108
|
+
}
|
|
109
|
+
useEffect(() => {
|
|
110
|
+
const viewport = viewportRef.current;
|
|
111
|
+
if (!viewport || typeof ResizeObserver === "undefined") return;
|
|
112
|
+
const observer = new ResizeObserver(handleResize);
|
|
113
|
+
observer.observe(viewport);
|
|
114
|
+
return () => observer.disconnect();
|
|
115
|
+
}, [handleResize, viewportRef]);
|
|
116
|
+
return /* @__PURE__ */ jsx("div", {
|
|
117
|
+
ref: setViewportRef,
|
|
118
|
+
role: role ?? "region",
|
|
119
|
+
"aria-label": ariaLabel ?? "Messages",
|
|
120
|
+
tabIndex: tabIndex ?? 0,
|
|
121
|
+
onKeyDown: handleKeyDown,
|
|
122
|
+
onScroll: handleScroll,
|
|
123
|
+
onTouchMove: handleTouchMove,
|
|
124
|
+
onWheel: handleWheel,
|
|
125
|
+
...props,
|
|
126
|
+
children
|
|
127
|
+
});
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* @since 0.5.0-canary.3
|
|
131
|
+
*/
|
|
132
|
+
function MessageScrollerContent({ "aria-relevant": ariaRelevant, children, ref, role, spacerClassName, ...props }) {
|
|
133
|
+
const { handleContentChange, handleResize, setContentElement, setSpacerElement } = useMessageScrollerContext();
|
|
134
|
+
const contentRef = useRef(null);
|
|
135
|
+
const setContentRef = useCallback((element) => {
|
|
136
|
+
contentRef.current = element;
|
|
137
|
+
setContentElement(element);
|
|
138
|
+
composeRefs(ref)?.(element);
|
|
139
|
+
}, [ref, setContentElement]);
|
|
140
|
+
useLayoutEffect(() => {
|
|
141
|
+
const content = contentRef.current;
|
|
142
|
+
if (!content) return;
|
|
143
|
+
handleContentChange();
|
|
144
|
+
if (typeof MutationObserver === "undefined") return;
|
|
145
|
+
const observer = new MutationObserver(() => {
|
|
146
|
+
handleContentChange();
|
|
147
|
+
});
|
|
148
|
+
observer.observe(content, { childList: true });
|
|
149
|
+
return () => observer.disconnect();
|
|
150
|
+
}, [handleContentChange]);
|
|
151
|
+
useEffect(() => {
|
|
152
|
+
const content = contentRef.current;
|
|
153
|
+
if (!content || typeof ResizeObserver === "undefined") return;
|
|
154
|
+
const observer = new ResizeObserver(handleResize);
|
|
155
|
+
observer.observe(content);
|
|
156
|
+
return () => observer.disconnect();
|
|
157
|
+
}, [handleResize]);
|
|
158
|
+
return /* @__PURE__ */ jsxs("div", {
|
|
159
|
+
ref: setContentRef,
|
|
160
|
+
role: role ?? "log",
|
|
161
|
+
"aria-relevant": ariaRelevant ?? "additions",
|
|
162
|
+
...props,
|
|
163
|
+
children: [children, /* @__PURE__ */ jsx("div", {
|
|
164
|
+
ref: setSpacerElement,
|
|
165
|
+
"aria-hidden": "true",
|
|
166
|
+
"data-message-scroller-spacer": "",
|
|
167
|
+
hidden: true,
|
|
168
|
+
className: spacerClassName
|
|
169
|
+
})]
|
|
170
|
+
});
|
|
171
|
+
}
|
|
172
|
+
/**
|
|
173
|
+
* @since 0.5.0-canary.3
|
|
174
|
+
*/
|
|
175
|
+
function MessageScrollerItem({ messageId, ref, isScrollAnchor = false, ...props }) {
|
|
176
|
+
const registerMessage = useMessageScrollerItemContext();
|
|
177
|
+
const elementRef = useRef(null);
|
|
178
|
+
return /* @__PURE__ */ jsx("div", {
|
|
179
|
+
ref: useCallback((element) => {
|
|
180
|
+
const previousElement = elementRef.current;
|
|
181
|
+
elementRef.current = element;
|
|
182
|
+
if (messageId) registerMessage(messageId, element, previousElement);
|
|
183
|
+
composeRefs(ref)?.(element);
|
|
184
|
+
}, [
|
|
185
|
+
messageId,
|
|
186
|
+
ref,
|
|
187
|
+
registerMessage
|
|
188
|
+
]),
|
|
189
|
+
"data-message-id": messageId,
|
|
190
|
+
"data-scroll-anchor": isScrollAnchor ? "true" : "false",
|
|
191
|
+
...props
|
|
192
|
+
});
|
|
193
|
+
}
|
|
194
|
+
/**
|
|
195
|
+
* @since 0.5.0-canary.3
|
|
196
|
+
*/
|
|
197
|
+
function MessageScrollerButton({ behavior = "smooth", children, direction = "end", onClick, render, tabIndex, type = "button", ...props }) {
|
|
198
|
+
const { scrollToEnd, scrollToStart, stateStore } = useMessageScrollerContext();
|
|
199
|
+
const onClickRef = useLatest(onClick);
|
|
200
|
+
const subscribe = useCallback((listener) => stateStore.subscribe(listener), [stateStore]);
|
|
201
|
+
const getSnapshot = useCallback(() => {
|
|
202
|
+
const state = stateStore.getSnapshot();
|
|
203
|
+
return direction === "start" ? state.start : state.end;
|
|
204
|
+
}, [direction, stateStore]);
|
|
205
|
+
const isActive = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
|
|
206
|
+
const handleClick = useCallback((event) => {
|
|
207
|
+
if (!isActive) return;
|
|
208
|
+
onClickRef.current?.(event);
|
|
209
|
+
if (!event.defaultPrevented) {
|
|
210
|
+
event.currentTarget.blur();
|
|
211
|
+
if (direction === "start") scrollToStart({ behavior });
|
|
212
|
+
else scrollToEnd({ behavior });
|
|
213
|
+
}
|
|
214
|
+
}, [
|
|
215
|
+
behavior,
|
|
216
|
+
direction,
|
|
217
|
+
isActive,
|
|
218
|
+
onClickRef,
|
|
219
|
+
scrollToEnd,
|
|
220
|
+
scrollToStart
|
|
221
|
+
]);
|
|
222
|
+
return useRender({
|
|
223
|
+
defaultTagName: "button",
|
|
224
|
+
props: mergeProps({
|
|
225
|
+
type,
|
|
226
|
+
inert: !isActive,
|
|
227
|
+
tabIndex: isActive ? tabIndex : -1,
|
|
228
|
+
children: children ?? /* @__PURE__ */ jsxs("span", { children: ["Scroll to ", direction] }),
|
|
229
|
+
onClick: handleClick
|
|
230
|
+
}, props),
|
|
231
|
+
render,
|
|
232
|
+
state: {
|
|
233
|
+
active: isActive,
|
|
234
|
+
direction
|
|
235
|
+
},
|
|
236
|
+
stateAttributesMapping: { active: (value) => ({ "data-active": value ? "true" : "false" }) }
|
|
237
|
+
});
|
|
238
|
+
}
|
|
239
|
+
//#endregion
|
|
240
|
+
export { MessageScroller, MessageScrollerButton, MessageScrollerContent, MessageScrollerItem, MessageScrollerProvider, MessageScrollerViewport, useMessageScroller, useMessageScrollerScrollable, useMessageScrollerVisibility };
|