@neut/ui 0.0.16 → 0.0.17

package/dist/components/message-scroller/MessageScrollerButton/MessageScrollerButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageScrollerButton.js","names":["Show","createEffect","mergeProps","splitProps","ValidComponent","Dynamic","ArrowDown","clsx","useMessageScrollerContext","MessageScrollerButtonProps","MessageScrollerButton","props","ctx","merged","direction","const","behavior","ScrollBehavior","variant","size","component","type","local","rest","active","scrollableEnd","scrollableStart","handleClick","event","MouseEvent","currentTarget","Element","handler","onClick","data","Array","isArray","defaultPrevented","HTMLElement","blur","scrollToStart","scrollToEnd","_$createComponent","_$mergeProps","ref","el","inert","data-direction","data-variant","data-size","data-active","tabIndex","_$memo","aria-label","class","classList","children","when","fallback","_el$","_tmpl$","_$insert","mergeProps","_$createComponent","_$mergeProps","_$memo","mergeProps$1","_tmpl$","MessageScrollerButton","ctx","useMessageScrollerContext","merged","props","local","rest","splitProps","active","createComponent","Dynamic","mergeProps","memo","handler","event","\"class\"","clsx","Show","ArrowDown","_el$","insert","children"],"sources":["../../../../src/components/message-scroller/MessageScrollerButton/MessageScrollerButton.tsx"],"sourcesContent":["import {\n  Show,\n  createEffect,\n  mergeProps,\n  splitProps,\n  type ValidComponent,\n} from \"solid-js\";\nimport { Dynamic } from \"solid-js/web\";\nimport { ArrowDown } from \"lucide-solid\";\nimport { clsx } from \"~/utils\";\nimport { useMessageScrollerContext } from \"../message-scroller.context\";\nimport type { MessageScrollerButtonProps } from \"../message-scroller.types\";\n\n/**\n * 滚动控件：滚到会话的开始/结束；该方向没有内容时置为 inert 并移出 tab 序列。\n * 默认渲染箭头图标 + sr-only 文案，传入 children 可自定义内容（如 \"Jump to latest\"）。\n */\nexport function MessageScrollerButton(props: MessageScrollerButtonProps) {\n  const ctx = useMessageScrollerContext(\"MessageScrollerButton\");\n  const merged = mergeProps(\n    {\n      direction: \"end\" as const,\n      behavior: \"smooth\" as ScrollBehavior,\n      variant: \"secondary\",\n      size: \"icon-sm\",\n      component: \"button\" as const,\n      type: \"button\" as const,\n    },\n    props,\n  );\n  const [local, rest] = splitProps(merged, [\n    \"class\",\n    \"classList\",\n    \"direction\",\n    \"behavior\",\n    \"variant\",\n    \"size\",\n    \"children\",\n    \"component\",\n    \"onClick\",\n    \"type\",\n    \"tabIndex\",\n  ]);\n\n  const active = () =>\n    local.direction === \"end\" ? ctx.scrollableEnd() : ctx.scrollableStart();\n\n  const handleClick = (event: MouseEvent & { currentTarget: Element }) => {\n    if (!active()) return;\n    // Solid 的 EventHandlerUnion 可能是 [handler, data] 形式，需手动分发\n    const handler = local.onClick as\n      | ((event: MouseEvent) => void)\n      | [(data: unknown, event: MouseEvent) => void, unknown]\n      | undefined;\n    if (Array.isArray(handler)) handler[0](handler[1], event);\n    else handler?.(event);\n    if (event.defaultPrevented) return;\n    (event.currentTarget as HTMLElement).blur();\n    if (local.direction === \"start\") {\n      ctx.scrollToStart({ behavior: local.behavior });\n    } else {\n      ctx.scrollToEnd({ behavior: local.behavior });\n    }\n  };\n\n  return (\n    <Dynamic\n      {...rest}\n      component={local.component as ValidComponent}\n      ref={(el: HTMLElement) => {\n        createEffect(() => {\n          el.inert = !active();\n        });\n      }}\n      type={local.type}\n      data-slot=\"message-scroller-button\"\n      data-direction={local.direction}\n      data-variant={local.variant}\n      data-size={local.size}\n      data-active={active() ? \"true\" : \"false\"}\n      tabIndex={active() ? (local.tabIndex ?? 0) : -1}\n      aria-label={\n        local.direction === \"end\" ? \"Scroll to end\" : \"Scroll to start\"\n      }\n      onClick={handleClick}\n      class={clsx(\n        \"absolute left-1/2 z-10 inline-flex size-8 -translate-x-1/2 items-center justify-center rounded-full border border-border bg-background text-foreground shadow-md transition-[translate,scale,opacity] duration-200 hover:bg-muted hover:text-foreground\",\n        \"data-[active=false]:pointer-events-none data-[active=false]:scale-95 data-[active=false]:opacity-0 data-[active=false]:duration-400 data-[active=false]:ease-[cubic-bezier(0.7,0,0.84,0)]\",\n        \"data-[active=true]:translate-y-0 data-[active=true]:scale-100 data-[active=true]:opacity-100 data-[active=true]:ease-[cubic-bezier(0.23,1,0.32,1)]\",\n        \"data-[direction=end]:bottom-4 data-[direction=end]:data-[active=false]:translate-y-full\",\n        \"data-[direction=start]:top-4 data-[direction=start]:data-[active=false]:-translate-y-full\",\n        \"rtl:translate-x-1/2 data-[direction=start]:[&_svg]:rotate-180\",\n        local.class,\n      )}\n      classList={local.classList}\n    >\n      <Show\n        when={local.children}\n        fallback={\n          <>\n            <ArrowDown class=\"size-4\" />\n            <span class=\"sr-only\">\n              {local.direction === \"end\" ? \"Scroll to end\" : \"Scroll to start\"}\n            </span>\n          </>\n        }\n      >\n        {(children) => children()}\n      </Show>\n    </Dynamic>\n  );\n}\n"],"mappings":";;;;;;;AAiBA,SAAgBU,EAAsBC,GAAmC;CACvE,IAAMC,IAAMJ,EAA0B,uBAAuB,GACvDK,IAASX,EACb;EACEY,WAAW;EACXE,UAAU;EACVE,SAAS;EACTC,MAAM;EACNC,WAAW;EACXC,MAAM;CACR,GACAV,CACF,GACM,CAACW,GAAOC,KAAQpB,EAAWU,GAAQ;EACvC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CAAU,CACX,GAEKW,UACJF,EAAMR,cAAc,QAAQF,EAAIa,cAAc,IAAIb,EAAIc,gBAAgB;CAoBxE,OAAAgB,EACGrC,GAAOsC,EACFpB,GAAI;EAAA,IACRH,YAAS;GAAA,OAAEE,EAAMF;EAA2B;EAAAwB,MACtCC,MAAoB;GACxB5C,QAAmB;IACjB4C,EAAGC,QAAQ,CAACtB,EAAO;GACrB,CAAC;EACH;EAAC,IACDH,OAAI;GAAA,OAAEC,EAAMD;EAAI;EAAA,aAAA;EAAA,IAAA,mBAAA;GAAA,OAEAC,EAAMR;EAAS;EAAA,IAAA,iBAAA;GAAA,OACjBQ,EAAMJ;EAAO;EAAA,IAAA,cAAA;GAAA,OAChBI,EAAMH;EAAI;EAAA,IAAA,gBAAA;GAAA,OACRK,EAAO,IAAI,SAAS;EAAO;EAAA,IACxC2B,WAAQ;GAAA,OAAEC,QAAA,CAAA,CAAA5B,EAAO,CAAC,CAAA,CAAA,IAAIF,EAAM6B,YAAY,IAAK;EAAE;EAAA,IAAA,eAAA;GAAA,OAE7C7B,EAAMR,cAAc,QAAQ,kBAAkB;EAAiB;EAEjEmB,UArCiBL,MAAmD;GACtE,IAAI,CAACJ,EAAO,GAAG;GAEf,IAAMQ,IAAUV,EAAMW;GAMtB,AAFIE,MAAMC,QAAQJ,CAAO,IAAGA,EAAQ,EAAE,CAACA,EAAQ,IAAIJ,CAAK,IACnDI,IAAUJ,CAAK,GAChBA,GAAMS,qBACV6C,EAAOpD,cAA8BS,KAAK,GACtCjB,EAAMR,cAAc,UACtBF,EAAI4B,cAAc,EAAExB,UAAUM,EAAMN,SAAS,CAAC,IAE9CJ,EAAI6B,YAAY,EAAEzB,UAAUM,EAAMN,SAAS,CAAC;EAEhD;EAqBwB,IAAAmE,QAAA;GAAA,OACb5E,EACL,2PACA,6LACA,sJACA,2FACA,6FACA,iEACAe,EAAMgC,KACR;EAAC;EAAA,IACDC,YAAS;GAAA,OAAEjC,EAAMiC;EAAS;EAAA,IAAAC,WAAA;GAAA,OAAAd,EAEzB1C,GAAI;IAAA,IACHyD,OAAI;KAAA,OAAEnC,EAAMkC;IAAQ;IAAA,IACpBE,WAAQ;KAAA,OAAA,CAAAhB,EAEHpC,GAAS,EAAA6E,OAAA,SAAA,CAAA,UAAA;MAAA,IAAAxB,IAAAC,EAAA;MAEwD,OAFxDC,EAAAF,SAEPrC,EAAMR,cAAc,QAAQ,kBAAkB,iBAAiB,GAAA6C;KAAA,EAAA,CAAA,CAAA;IAAA;IAAAH,WAKpEA,MAAaA,EAAS;GAAC,CAAA;EAAA;CAAA,CAAA,CAAA;AAIjC"}

package/dist/components/message-scroller/MessageScrollerButton/index.d.ts

@@ -0,0 +1 @@
+export { MessageScrollerButton } from './MessageScrollerButton';

package/dist/components/message-scroller/MessageScrollerContent/MessageScrollerContent.d.ts

@@ -0,0 +1,6 @@
+import { MessageScrollerContentProps } from '../message-scroller.types';
+/**
+ * 会话容器：承载各行，并作为新消息的 live region。
+ * 末尾的内部 spacer 由引擎按需设置高度，让靠近结尾的锚定行也能滚到顶部。
+ */
+export declare function MessageScrollerContent(props: MessageScrollerContentProps): import('solid-js').JSX.Element;

package/dist/components/message-scroller/MessageScrollerContent/MessageScrollerContent.js

@@ -0,0 +1,46 @@
+import { clsx as e } from "../../../utils/clsx.js";
+import { useMessageScrollerContext as t } from "../message-scroller.context.js";
+import { className as n, effect as r, insert as i, mergeProps as a, spread as o, template as s, use as c } from "solid-js/web";
+import { onCleanup as l, splitProps as u } from "solid-js";
+//#region src/components/message-scroller/MessageScrollerContent/MessageScrollerContent.tsx
+var d = /*#__PURE__*/ s("<div><div aria-hidden=true data-message-scroller-spacer hidden>");
+function f(s) {
+	let f = t("MessageScrollerContent"), [p, m] = u(s, [
+		"class",
+		"classList",
+		"aria-busy",
+		"spacerClassName",
+		"role",
+		"aria-relevant",
+		"children"
+	]);
+	return (() => {
+		var t = d(), s = t.firstChild;
+		return c((e) => {
+			f.setContent(e), l(() => f.setContent(void 0));
+		}, t), o(t, a(m, {
+			"data-slot": "message-scroller-content",
+			get role() {
+				return p.role ?? "log";
+			},
+			get "aria-relevant"() {
+				return p["aria-relevant"] ?? "additions";
+			},
+			get "aria-busy"() {
+				return p["aria-busy"];
+			},
+			get class() {
+				return e("flex h-max min-h-full flex-col gap-6", p.class);
+			},
+			get classList() {
+				return p.classList;
+			}
+		}), !1, !0), i(t, () => p.children, s), c((e) => {
+			f.setSpacer(e), l(() => f.setSpacer(void 0));
+		}, s), r(() => n(s, p.spacerClassName)), t;
+	})();
+}
+//#endregion
+export { f as MessageScrollerContent };
+
+//# sourceMappingURL=MessageScrollerContent.js.map

package/dist/components/message-scroller/MessageScrollerContent/MessageScrollerContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageScrollerContent.js","names":["onCleanup","splitProps","clsx","useMessageScrollerContext","MessageScrollerContentProps","MessageScrollerContent","props","ctx","local","rest","_el$","_tmpl$","_el$2","firstChild","_$use","el","setContent","undefined","_$spread","_$mergeProps","role","aria-relevant","aria-busy","class","classList","_$insert","children","setSpacer","_$effect","_$className","spacerClassName","_$mergeProps","_$className","_tmpl$","MessageScrollerContent","ctx","useMessageScrollerContext","local","rest","splitProps","props","_el$","_el$2","use","el","onCleanup","spread","mergeProps","\"class\"","clsx","insert","effect","className"],"sources":["../../../../src/components/message-scroller/MessageScrollerContent/MessageScrollerContent.tsx"],"sourcesContent":["import { onCleanup, splitProps } from \"solid-js\";\nimport { clsx } from \"~/utils\";\nimport { useMessageScrollerContext } from \"../message-scroller.context\";\nimport type { MessageScrollerContentProps } from \"../message-scroller.types\";\n\n/**\n * 会话容器：承载各行，并作为新消息的 live region。\n * 末尾的内部 spacer 由引擎按需设置高度，让靠近结尾的锚定行也能滚到顶部。\n */\nexport function MessageScrollerContent(props: MessageScrollerContentProps) {\n  const ctx = useMessageScrollerContext(\"MessageScrollerContent\");\n  const [local, rest] = splitProps(props, [\n    \"class\",\n    \"classList\",\n    \"aria-busy\",\n    \"spacerClassName\",\n    \"role\",\n    \"aria-relevant\",\n    \"children\",\n  ]);\n\n  return (\n    <div\n      {...rest}\n      ref={(el) => {\n        ctx.setContent(el);\n        onCleanup(() => ctx.setContent(undefined));\n      }}\n      data-slot=\"message-scroller-content\"\n      role={local.role ?? \"log\"}\n      aria-relevant={local[\"aria-relevant\"] ?? \"additions\"}\n      aria-busy={local[\"aria-busy\"]}\n      class={clsx(\"flex h-max min-h-full flex-col gap-6\", local.class)}\n      classList={local.classList}\n    >\n      {local.children}\n      <div\n        ref={(el) => {\n          ctx.setSpacer(el);\n          onCleanup(() => ctx.setSpacer(undefined));\n        }}\n        aria-hidden=\"true\"\n        data-message-scroller-spacer=\"\"\n        hidden\n        class={local.spacerClassName}\n      />\n    </div>\n  );\n}\n"],"mappings":";;;;;;AASA,SAAgBK,EAAuBC,GAAoC;CACzE,IAAMC,IAAMJ,EAA0B,wBAAwB,GACxD,CAACK,GAAOC,KAAQR,EAAWK,GAAO;EACtC;EACA;EACA;EACA;EACA;EACA;EACA;CAAU,CACX;CAED,cAAA;EAAA,IAAAI,IAAAC,EAAA,GAAAC,IAAAF,EAAAG;EAuBkC,OAvBlCC,GAGUC,MAAO;GAEXf,AADAO,EAAIS,WAAWD,CAAE,GACjBf,QAAgBO,EAAIS,WAAWC,KAAAA,CAAS,CAAC;EAC3C,GAACP,CAAA,GAAAQ,EAAAR,GAAAS,EAJGV,GAAI;GAAA,aAKE;GAA0B,IACpCW,OAAI;IAAA,OAAEZ,EAAMY,QAAQ;GAAK;GAAA,IAAA,kBAAA;IAAA,OACVZ,EAAM,oBAAoB;GAAW;GAAA,IAAA,cAAA;IAAA,OACzCA,EAAM;GAAY;GAAA,IAAAwC,QAAA;IAAA,OACtB9C,EAAK,wCAAwCM,EAAMe,KAAK;GAAC;GAAA,IAChEC,YAAS;IAAA,OAAEhB,EAAMgB;GAAS;EAAA,CAAA,GAAA,IAAA,EAAA,GAAAC,EAAAf,SAEzBF,EAAMkB,UAAQd,CAAA,GAAAE,GAEPC,MAAO;GAEXf,AADAO,EAAIoB,UAAUZ,CAAE,GAChBf,QAAgBO,EAAIoB,UAAUV,KAAAA,CAAS,CAAC;EAC1C,GAACL,CAAA,GAAAgB,QAAAC,EAAAjB,GAIMJ,EAAMsB,eAAe,CAAA,GAAApB;CAAA,EAAA,CAAA;AAIpC"}

package/dist/components/message-scroller/MessageScrollerContent/index.d.ts

@@ -0,0 +1 @@
+export { MessageScrollerContent } from './MessageScrollerContent';

package/dist/components/message-scroller/MessageScrollerItem/MessageScrollerItem.d.ts

@@ -0,0 +1,6 @@
+import { MessageScrollerItemProps } from '../message-scroller.types';
+/**
+ * 一行（消息 / marker / 分隔等）。必须包裹 content 的每个直接子节点，
+ * 引擎据此测量、锚定、保位与跳转。
+ */
+export declare function MessageScrollerItem(props: MessageScrollerItemProps): import('solid-js').JSX.Element;

package/dist/components/message-scroller/MessageScrollerItem/MessageScrollerItem.js

@@ -0,0 +1,42 @@
+import { clsx as e } from "../../../utils/clsx.js";
+import { useMessageScrollerContext as t } from "../message-scroller.context.js";
+import { mergeProps as n, spread as r, template as i, use as a } from "solid-js/web";
+import { onCleanup as o, splitProps as s } from "solid-js";
+//#region src/components/message-scroller/MessageScrollerItem/MessageScrollerItem.tsx
+var c = /*#__PURE__*/ i("<div>");
+function l(i) {
+	let l = t("MessageScrollerItem"), [u, d] = s(i, [
+		"class",
+		"classList",
+		"messageId",
+		"scrollAnchor"
+	]);
+	return (() => {
+		var t = c();
+		return a((e) => {
+			let t = l.registerItem({
+				id: u.messageId,
+				element: e
+			});
+			o(t);
+		}, t), r(t, n(d, {
+			"data-slot": "message-scroller-item",
+			get "data-message-id"() {
+				return u.messageId;
+			},
+			get "data-scroll-anchor"() {
+				return u.scrollAnchor === !0 ? "true" : "false";
+			},
+			get class() {
+				return e("min-w-0 shrink-0 [contain-intrinsic-size:auto_10rem] [content-visibility:auto]", u.class);
+			},
+			get classList() {
+				return u.classList;
+			}
+		}), !1, !1), t;
+	})();
+}
+//#endregion
+export { l as MessageScrollerItem };
+
+//# sourceMappingURL=MessageScrollerItem.js.map

package/dist/components/message-scroller/MessageScrollerItem/MessageScrollerItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageScrollerItem.js","names":["onCleanup","splitProps","clsx","useMessageScrollerContext","MessageScrollerItemProps","MessageScrollerItem","props","ctx","local","rest","_el$","_tmpl$","_$use","el","unregister","registerItem","id","messageId","element","_$spread","_$mergeProps","data-message-id","data-scroll-anchor","scrollAnchor","class","classList","_$mergeProps","_tmpl$","MessageScrollerItem","ctx","useMessageScrollerContext","local","rest","splitProps","props","_el$","use","unregister","el","spread","mergeProps","\"class\"","clsx"],"sources":["../../../../src/components/message-scroller/MessageScrollerItem/MessageScrollerItem.tsx"],"sourcesContent":["import { onCleanup, splitProps } from \"solid-js\";\nimport { clsx } from \"~/utils\";\nimport { useMessageScrollerContext } from \"../message-scroller.context\";\nimport type { MessageScrollerItemProps } from \"../message-scroller.types\";\n\n/**\n * 一行（消息 / marker / 分隔等）。必须包裹 content 的每个直接子节点，\n * 引擎据此测量、锚定、保位与跳转。\n */\nexport function MessageScrollerItem(props: MessageScrollerItemProps) {\n  const ctx = useMessageScrollerContext(\"MessageScrollerItem\");\n  const [local, rest] = splitProps(props, [\n    \"class\",\n    \"classList\",\n    \"messageId\",\n    \"scrollAnchor\",\n  ]);\n\n  return (\n    <div\n      {...rest}\n      ref={(el) => {\n        const unregister = ctx.registerItem({\n          id: local.messageId,\n          element: el,\n        });\n        onCleanup(unregister);\n      }}\n      data-slot=\"message-scroller-item\"\n      data-message-id={local.messageId}\n      data-scroll-anchor={local.scrollAnchor === true ? \"true\" : \"false\"}\n      class={clsx(\n        \"min-w-0 shrink-0 [contain-intrinsic-size:auto_10rem] [content-visibility:auto]\",\n        local.class,\n      )}\n      classList={local.classList}\n    />\n  );\n}\n"],"mappings":";;;;;;AASA,SAAgBK,EAAoBC,GAAiC;CACnE,IAAMC,IAAMJ,EAA0B,qBAAqB,GACrD,CAACK,GAAOC,KAAQR,EAAWK,GAAO;EACtC;EACA;EACA;EACA;CAAc,CACf;CAED,cAAA;EAAA,IAAAI,IAAAC,EAAA;EAiB8B,OAjB9BC,GAGUC,MAAO;GACX,IAAMC,IAAaP,EAAIQ,aAAa;IAClCC,IAAIR,EAAMS;IACVC,SAASL;GACX,CAAC;GACDb,EAAUc,CAAU;EACtB,GAACJ,CAAA,GAAAS,EAAAT,GAAAU,EAPGX,GAAI;GAAA,aAQE;GAAuB,IAAA,oBAAA;IAAA,OAChBD,EAAMS;GAAS;GAAA,IAAA,uBAAA;IAAA,OACZT,EAAMe,iBAAiB,KAAO,SAAS;GAAO;GAAA,IAAAkB,QAAA;IAAA,OAC3DvC,EACL,kFACAM,EAAMgB,KACR;GAAC;GAAA,IACDC,YAAS;IAAA,OAAEjB,EAAMiB;GAAS;EAAA,CAAA,GAAA,IAAA,EAAA,GAAAf;CAAA,EAAA,CAAA;AAGhC"}

package/dist/components/message-scroller/MessageScrollerItem/index.d.ts

@@ -0,0 +1 @@
+export { MessageScrollerItem } from './MessageScrollerItem';

package/dist/components/message-scroller/MessageScrollerProvider/MessageScrollerProvider.d.ts

@@ -0,0 +1,4 @@
+import { JSX } from 'solid-js';
+import { MessageScrollerProviderProps } from '../message-scroller.types';
+/** 滚动状态机根：不渲染 DOM，提供 context 与滚动行为 */
+export declare function MessageScrollerProvider(props: MessageScrollerProviderProps): JSX.Element;

package/dist/components/message-scroller/MessageScrollerProvider/MessageScrollerProvider.js

@@ -0,0 +1,37 @@
+import { MessageScrollerContext as e } from "../message-scroller.context.js";
+import { useMessageScrollerEngine as t } from "../useMessageScrollerEngine.js";
+import { createComponent as n } from "solid-js/web";
+import { mergeProps as r, splitProps as i } from "solid-js";
+//#region src/components/message-scroller/MessageScrollerProvider/MessageScrollerProvider.tsx
+function a(a) {
+	let o = r({
+		autoScroll: !1,
+		defaultScrollPosition: "end",
+		scrollEdgeThreshold: 8,
+		scrollMargin: 0,
+		scrollPreviousItemPeek: 64
+	}, a), [s] = i(o, [
+		"autoScroll",
+		"defaultScrollPosition",
+		"scrollEdgeThreshold",
+		"scrollMargin",
+		"scrollPreviousItemPeek",
+		"children"
+	]), c = t(() => ({
+		autoScroll: s.autoScroll,
+		defaultScrollPosition: s.defaultScrollPosition,
+		scrollEdgeThreshold: s.scrollEdgeThreshold,
+		scrollMargin: s.scrollMargin,
+		scrollPreviousItemPeek: s.scrollPreviousItemPeek
+	}));
+	return n(e.Provider, {
+		value: c,
+		get children() {
+			return s.children;
+		}
+	});
+}
+//#endregion
+export { a as MessageScrollerProvider };
+
+//# sourceMappingURL=MessageScrollerProvider.js.map

package/dist/components/message-scroller/MessageScrollerProvider/MessageScrollerProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageScrollerProvider.js","names":["mergeProps","splitProps","JSX","MessageScrollerContext","useMessageScrollerEngine","MessageScrollerProviderProps","MessageScrollerProvider","props","Element","merged","autoScroll","defaultScrollPosition","const","scrollEdgeThreshold","scrollMargin","scrollPreviousItemPeek","local","ctx","_$createComponent","Provider","value","children","mergeProps","_$createComponent","mergeProps$1","MessageScrollerProvider","merged","props","local","splitProps","ctx","useMessageScrollerEngine","createComponent","MessageScrollerContext"],"sources":["../../../../src/components/message-scroller/MessageScrollerProvider/MessageScrollerProvider.tsx"],"sourcesContent":["import { mergeProps, splitProps, type JSX } from \"solid-js\";\nimport { MessageScrollerContext } from \"../message-scroller.context\";\nimport { useMessageScrollerEngine } from \"../useMessageScrollerEngine\";\nimport type { MessageScrollerProviderProps } from \"../message-scroller.types\";\n\n/** 滚动状态机根：不渲染 DOM，提供 context 与滚动行为 */\nexport function MessageScrollerProvider(\n  props: MessageScrollerProviderProps,\n): JSX.Element {\n  const merged = mergeProps(\n    {\n      autoScroll: false,\n      defaultScrollPosition: \"end\" as const,\n      scrollEdgeThreshold: 8,\n      scrollMargin: 0,\n      scrollPreviousItemPeek: 64,\n    },\n    props,\n  );\n  const [local] = splitProps(merged, [\n    \"autoScroll\",\n    \"defaultScrollPosition\",\n    \"scrollEdgeThreshold\",\n    \"scrollMargin\",\n    \"scrollPreviousItemPeek\",\n    \"children\",\n  ]);\n\n  const ctx = useMessageScrollerEngine(() => ({\n    autoScroll: local.autoScroll,\n    defaultScrollPosition: local.defaultScrollPosition,\n    scrollEdgeThreshold: local.scrollEdgeThreshold,\n    scrollMargin: local.scrollMargin,\n    scrollPreviousItemPeek: local.scrollPreviousItemPeek,\n  }));\n\n  return (\n    <MessageScrollerContext.Provider value={ctx}>\n      {local.children}\n    </MessageScrollerContext.Provider>\n  );\n}\n"],"mappings":";;;;;AAMA,SAAgBM,EACdC,GACa;CACb,IAAME,IAAST,EACb;EACEU,YAAY;EACZC,uBAAuB;EACvBE,qBAAqB;EACrBC,cAAc;EACdC,wBAAwB;CAC1B,GACAR,CACF,GACM,CAACS,KAASf,EAAWQ,GAAQ;EACjC;EACA;EACA;EACA;EACA;EACA;CAAU,CACX,GAEKQ,IAAMb,SAAgC;EAC1CM,YAAYM,EAAMN;EAClBC,uBAAuBK,EAAML;EAC7BE,qBAAqBG,EAAMH;EAC3BC,cAAcE,EAAMF;EACpBC,wBAAwBC,EAAMD;CAChC,EAAE;CAEF,OAAAG,EACGf,EAAuBgB,UAAQ;EAACC,OAAOH;EAAG,IAAAI,WAAA;GAAA,OACxCL,EAAMK;EAAQ;CAAA,CAAA;AAGrB"}

package/dist/components/message-scroller/MessageScrollerProvider/index.d.ts

@@ -0,0 +1 @@
+export { MessageScrollerProvider } from './MessageScrollerProvider';

package/dist/components/message-scroller/MessageScrollerViewport/MessageScrollerViewport.d.ts

@@ -0,0 +1,6 @@
+import { MessageScrollerViewportProps } from '../message-scroller.types';
+/**
+ * 可滚动元素：接收原生 scroll，维护可滚动状态；上方插入历史时保持可见行。
+ * 默认是键盘可达的、有标签的滚动区域。转发 `ref` 便于外部（如虚拟化）拿到滚动元素。
+ */
+export declare function MessageScrollerViewport(props: MessageScrollerViewportProps): import('solid-js').JSX.Element;

package/dist/components/message-scroller/MessageScrollerViewport/MessageScrollerViewport.js

@@ -0,0 +1,55 @@
+import { clsx as e } from "../../../utils/clsx.js";
+import { mergeRefs as t } from "../../../utils/ref.js";
+import { useMessageScrollerContext as n } from "../message-scroller.context.js";
+import { scrollableData as r } from "../message-scroller.utils.js";
+import { mergeProps as i, spread as a, template as o, use as s } from "solid-js/web";
+import { createEffect as c, onCleanup as l, splitProps as u } from "solid-js";
+//#region src/components/message-scroller/MessageScrollerViewport/MessageScrollerViewport.tsx
+var d = /*#__PURE__*/ o("<div>");
+function f(o) {
+	let f = n("MessageScrollerViewport"), [p, m] = u(o, [
+		"class",
+		"classList",
+		"aria-label",
+		"preserveScrollOnPrepend",
+		"ref",
+		"role",
+		"tabIndex"
+	]);
+	return c(() => f.setPreserveScrollOnPrepend(p.preserveScrollOnPrepend ?? !0)), (() => {
+		var n = d(), o = t((e) => {
+			f.setViewport(e), l(() => f.setViewport(void 0));
+		}, p.ref);
+		return typeof o == "function" && s(o, n), a(n, i(m, {
+			"data-slot": "message-scroller-viewport",
+			get role() {
+				return p.role ?? "region";
+			},
+			get "aria-label"() {
+				return p["aria-label"] ?? "Messages";
+			},
+			get tabindex() {
+				return p.tabIndex ?? 0;
+			},
+			get "data-scrollable"() {
+				return r(f.scrollableStart, f.scrollableEnd);
+			},
+			get "data-pending-scroll"() {
+				return f.pendingScroll() ? "" : void 0;
+			},
+			get "data-autoscrolling"() {
+				return f.autoscrolling() ? "" : void 0;
+			},
+			get class() {
+				return e("size-full min-h-0 min-w-0 scroll-fade-b scrollbar-thin scrollbar-gutter-stable overflow-y-auto overscroll-contain contain-content outline-none focus-visible:ring-2 focus-visible:ring-ring/50", "data-autoscrolling:scrollbar-thumb-transparent data-autoscrolling:scrollbar-track-transparent", "data-pending-scroll:invisible", p.class);
+			},
+			get classList() {
+				return p.classList;
+			}
+		}), !1, !1), n;
+	})();
+}
+//#endregion
+export { f as MessageScrollerViewport };
+
+//# sourceMappingURL=MessageScrollerViewport.js.map

package/dist/components/message-scroller/MessageScrollerViewport/MessageScrollerViewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageScrollerViewport.js","names":["createEffect","onCleanup","splitProps","clsx","mergeRefs","useMessageScrollerContext","scrollableData","MessageScrollerViewportProps","MessageScrollerViewport","props","ctx","local","rest","setPreserveScrollOnPrepend","preserveScrollOnPrepend","_el$","_tmpl$","_ref$","el","setViewport","HTMLElement","undefined","ref","Element","_$use","_$spread","_$mergeProps","role","aria-label","tabindex","tabIndex","data-scrollable","scrollableStart","scrollableEnd","data-pending-scroll","pendingScroll","data-autoscrolling","autoscrolling","class","classList","_$use","_$mergeProps","_tmpl$","MessageScrollerViewport","ctx","useMessageScrollerContext","local","rest","splitProps","props","createEffect","_el$","_ref$","mergeRefs","el","onCleanup","use","spread","mergeProps","scrollableData","\"class\"","clsx"],"sources":["../../../../src/components/message-scroller/MessageScrollerViewport/MessageScrollerViewport.tsx"],"sourcesContent":["import { createEffect, onCleanup, splitProps } from \"solid-js\";\nimport { clsx, mergeRefs } from \"~/utils\";\nimport { useMessageScrollerContext } from \"../message-scroller.context\";\nimport { scrollableData } from \"../message-scroller.utils\";\nimport type { MessageScrollerViewportProps } from \"../message-scroller.types\";\n\n/**\n * 可滚动元素：接收原生 scroll，维护可滚动状态；上方插入历史时保持可见行。\n * 默认是键盘可达的、有标签的滚动区域。转发 `ref` 便于外部（如虚拟化）拿到滚动元素。\n */\nexport function MessageScrollerViewport(props: MessageScrollerViewportProps) {\n  const ctx = useMessageScrollerContext(\"MessageScrollerViewport\");\n  const [local, rest] = splitProps(props, [\n    \"class\",\n    \"classList\",\n    \"aria-label\",\n    \"preserveScrollOnPrepend\",\n    \"ref\",\n    \"role\",\n    \"tabIndex\",\n  ]);\n\n  createEffect(() =>\n    ctx.setPreserveScrollOnPrepend(local.preserveScrollOnPrepend ?? true),\n  );\n\n  return (\n    // biome-ignore lint/a11y/useAriaPropsSupportedByRole: role 允许被调用方覆盖(对齐上游),静态分析无法确定\n    <div\n      {...rest}\n      ref={mergeRefs(\n        (el) => {\n          ctx.setViewport(el as HTMLElement);\n          onCleanup(() => ctx.setViewport(undefined));\n        },\n        local.ref as ((el: Element) => void) | undefined,\n      )}\n      data-slot=\"message-scroller-viewport\"\n      role={local.role ?? \"region\"}\n      aria-label={local[\"aria-label\"] ?? \"Messages\"}\n      tabindex={local.tabIndex ?? 0}\n      data-scrollable={scrollableData(ctx.scrollableStart, ctx.scrollableEnd)}\n      data-pending-scroll={ctx.pendingScroll() ? \"\" : undefined}\n      data-autoscrolling={ctx.autoscrolling() ? \"\" : undefined}\n      class={clsx(\n        \"size-full min-h-0 min-w-0 scroll-fade-b scrollbar-thin scrollbar-gutter-stable overflow-y-auto overscroll-contain contain-content outline-none focus-visible:ring-2 focus-visible:ring-ring/50\",\n        \"data-autoscrolling:scrollbar-thumb-transparent data-autoscrolling:scrollbar-track-transparent\",\n        \"data-pending-scroll:invisible\",\n        local.class,\n      )}\n      classList={local.classList}\n    />\n  );\n}\n"],"mappings":";;;;;;;;AAUA,SAAgBQ,EAAwBC,GAAqC;CAC3E,IAAMC,IAAML,EAA0B,yBAAyB,GACzD,CAACM,GAAOC,KAAQV,EAAWO,GAAO;EACtC;EACA;EACA;EACA;EACA;EACA;EACA;CAAU,CACX;CAMD,OAJAT,QACEU,EAAIG,2BAA2BF,EAAMG,2BAA2B,EAAI,CACtE,UAGE;EAAA,IAAAC,IAAAC,EAAA,GAAAC,IAGOb,GACFc,MAAO;GAENjB,AADAS,EAAIS,YAAYD,CAAiB,GACjCjB,QAAgBS,EAAIS,YAAYE,KAAAA,CAAS,CAAC;EAC5C,GACAV,EAAMW,GACR;EAc0B,OAdzB,OAAAL,KAAA,cAAAO,EAAAP,GAAAF,CAAA,GAAAU,EAAAV,GAAAW,EAPGd,GAAI;GAAA,aAQE;GAA2B,IACrCe,OAAI;IAAA,OAAEhB,EAAMgB,QAAQ;GAAQ;GAAA,IAAA,eAAA;IAAA,OAChBhB,EAAM,iBAAiB;GAAU;GAAA,IAC7CkB,WAAQ;IAAA,OAAElB,EAAMmB,YAAY;GAAC;GAAA,IAAA,oBAAA;IAAA,OACZxB,EAAeI,EAAIsB,iBAAiBtB,EAAIuB,aAAa;GAAC;GAAA,IAAA,wBAAA;IAAA,OAClDvB,EAAIyB,cAAc,IAAI,KAAKd,KAAAA;GAAS;GAAA,IAAA,uBAAA;IAAA,OACrCX,EAAI2B,cAAc,IAAI,KAAKhB,KAAAA;GAAS;GAAA,IAAAuC,QAAA;IAAA,OACjDzD,EACL,kMACA,iGACA,iCACAQ,EAAM2B,KACR;GAAC;GAAA,IACDC,YAAS;IAAA,OAAE5B,EAAM4B;GAAS;EAAA,CAAA,GAAA,IAAA,EAAA,GAAAxB;CAAA,EAAA,CAAA;AAGhC"}

package/dist/components/message-scroller/MessageScrollerViewport/index.d.ts

@@ -0,0 +1 @@
+export { MessageScrollerViewport } from './MessageScrollerViewport';

package/dist/components/message-scroller/index.d.ts

@@ -0,0 +1,10 @@
+export { MessageScrollerProvider } from './MessageScrollerProvider';
+export { MessageScroller } from './MessageScroller';
+export { MessageScrollerViewport } from './MessageScrollerViewport';
+export { MessageScrollerContent } from './MessageScrollerContent';
+export { MessageScrollerItem } from './MessageScrollerItem';
+export { MessageScrollerButton } from './MessageScrollerButton';
+export { useMessageScroller } from './useMessageScroller';
+export { useMessageScrollerScrollable } from './useMessageScrollerScrollable';
+export { useMessageScrollerVisibility } from './useMessageScrollerVisibility';
+export type { MessageScrollerProviderProps, MessageScrollerDefaultScrollPosition, MessageScrollerButtonDirection, MessageScrollerScrollAlign, MessageScrollerScrollOptions, MessageScrollerScrollable, MessageScrollerVisibilityState, MessageScrollerItemEntry, MessageScrollerContextValue, MessageScrollerVisibilityValue, MessageScrollerProps, MessageScrollerViewportProps, MessageScrollerContentProps, MessageScrollerItemProps, MessageScrollerButtonProps, } from './message-scroller.types';

package/dist/components/message-scroller/index.js

@@ -0,0 +1,10 @@
+import { MessageScrollerProvider as e } from "./MessageScrollerProvider/MessageScrollerProvider.js";
+import { MessageScroller as t } from "./MessageScroller/MessageScroller.js";
+import { MessageScrollerViewport as n } from "./MessageScrollerViewport/MessageScrollerViewport.js";
+import { MessageScrollerContent as r } from "./MessageScrollerContent/MessageScrollerContent.js";
+import { MessageScrollerItem as i } from "./MessageScrollerItem/MessageScrollerItem.js";
+import { MessageScrollerButton as a } from "./MessageScrollerButton/MessageScrollerButton.js";
+import { useMessageScroller as o } from "./useMessageScroller.js";
+import { useMessageScrollerScrollable as s } from "./useMessageScrollerScrollable.js";
+import { useMessageScrollerVisibility as c } from "./useMessageScrollerVisibility.js";
+export { t as MessageScroller, a as MessageScrollerButton, r as MessageScrollerContent, i as MessageScrollerItem, e as MessageScrollerProvider, n as MessageScrollerViewport, o as useMessageScroller, s as useMessageScrollerScrollable, c as useMessageScrollerVisibility };

package/dist/components/message-scroller/message-scroller.context.d.ts

@@ -0,0 +1,3 @@
+import { MessageScrollerContextValue } from './message-scroller.types';
+export declare const MessageScrollerContext: import('solid-js').Context<MessageScrollerContextValue | undefined>;
+export declare function useMessageScrollerContext(component: string): MessageScrollerContextValue;

package/dist/components/message-scroller/message-scroller.context.js

@@ -0,0 +1,12 @@
+import { createContext as e, useContext as t } from "solid-js";
+//#region src/components/message-scroller/message-scroller.context.ts
+var n = e();
+function r(e) {
+	let r = t(n);
+	if (!r) throw Error(`<${e}> 必须渲染在 <MessageScrollerProvider> 内部`);
+	return r;
+}
+//#endregion
+export { n as MessageScrollerContext, r as useMessageScrollerContext };
+
+//# sourceMappingURL=message-scroller.context.js.map

package/dist/components/message-scroller/message-scroller.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-scroller.context.js","names":["MessageScrollerContext","createContext","useMessageScrollerContext","ctx","useContext","component"],"sources":["../../../src/components/message-scroller/message-scroller.context.ts"],"sourcesContent":["import { createContext, useContext } from \"solid-js\";\nimport type { MessageScrollerContextValue } from \"./message-scroller.types\";\n\nexport const MessageScrollerContext =\n  createContext<MessageScrollerContextValue>();\n\nexport function useMessageScrollerContext(\n  component: string,\n): MessageScrollerContextValue {\n  const ctx = useContext(MessageScrollerContext);\n  if (!ctx) {\n    throw new Error(`<${component}> 必须渲染在 <MessageScrollerProvider> 内部`);\n  }\n  return ctx;\n}\n"],"mappings":";;AAGA,IAAaA,IACXC,EAA2C;AAE7C,SAAgBC,EACd,GAC6B;CAC7B,IAAMC,IAAMC,EAAWJ,CAAsB;CAC7C,IAAI,CAACG,GACH,MAAU,MAAM,IAAIE,EAAU,qCAAqC;CAErE,OAAOF;AACT"}

package/dist/components/message-scroller/message-scroller.types.d.ts

@@ -0,0 +1,92 @@
+import { Accessor, ParentProps } from 'solid-js';
+import { BaseProps, PolymorphicProps } from '../../types';
+export type MessageScrollerDefaultScrollPosition = "start" | "end" | "last-anchor";
+export type MessageScrollerButtonDirection = "start" | "end";
+export type MessageScrollerScrollAlign = "start" | "center" | "end" | "nearest";
+/** 命令选项：对齐方式、原生滚动行为、本次命令覆盖的 scrollMargin */
+export interface MessageScrollerScrollOptions {
+    align?: MessageScrollerScrollAlign;
+    behavior?: ScrollBehavior;
+    scrollMargin?: number;
+}
+/** useMessageScrollerScrollable 的取值形态 */
+export interface MessageScrollerScrollable {
+    start: boolean;
+    end: boolean;
+}
+/** useMessageScrollerVisibility 的取值形态 */
+export interface MessageScrollerVisibilityState {
+    currentAnchorId: string | null;
+    visibleMessageIds: string[];
+}
+export interface MessageScrollerProviderProps extends ParentProps {
+    /** 读者位于实时边缘时，内容增长自动跟随（滚动离开后自动让位），默认 false */
+    autoScroll?: boolean;
+    /** 打开时停在何处，默认 "end"；"last-anchor" 无锚点或该回合放得下时回退到 "end" */
+    defaultScrollPosition?: MessageScrollerDefaultScrollPosition;
+    /** 距任一边缘多少像素仍算「在起点/终点」，默认 8 */
+    scrollEdgeThreshold?: number;
+    /** 新回合锚定时在 scrollMargin 之外额外保留的上一项高度（像素），默认 64 */
+    scrollPreviousItemPeek?: number;
+    /** scrollToMessage / 可见性 / 程序化目标的对齐边距（像素），默认 0 */
+    scrollMargin?: number;
+}
+export interface MessageScrollerItemEntry {
+    id?: string;
+    element: HTMLElement;
+}
+export interface MessageScrollerContextValue {
+    viewport: Accessor<HTMLElement | undefined>;
+    setViewport: (el: HTMLElement | undefined) => void;
+    content: Accessor<HTMLElement | undefined>;
+    setContent: (el: HTMLElement | undefined) => void;
+    setSpacer: (el: HTMLElement | undefined) => void;
+    registerItem: (entry: MessageScrollerItemEntry) => () => void;
+    /** 上方插入历史时是否保持可见行（Viewport 的 prop） */
+    preserveScrollOnPrepend: Accessor<boolean>;
+    setPreserveScrollOnPrepend: (value: boolean) => void;
+    /** 是否还能向上/向下滚动（供滚动控件与自定义 UI） */
+    scrollableStart: Accessor<boolean>;
+    scrollableEnd: Accessor<boolean>;
+    /** 正在执行「滚动到最新消息」的程序化滚动（对应 data-autoscrolling） */
+    autoscrolling: Accessor<boolean>;
+    /** 初始定位尚未应用（对应 data-pending-scroll） */
+    pendingScroll: Accessor<boolean>;
+    scrollToStart: (options?: MessageScrollerScrollOptions) => boolean;
+    scrollToEnd: (options?: MessageScrollerScrollOptions) => boolean;
+    /** 目标未挂载且可排队（会话为空）时返回 true，其余失败返回 false */
+    scrollToMessage: (messageId: string, options?: MessageScrollerScrollOptions) => boolean;
+    /** 当前锚定的回合 id（阅读行之上最后一个 scrollAnchor），无则 null */
+    currentAnchorId: Accessor<string | null>;
+    /** 当前可见的消息 id（文档顺序） */
+    visibleMessageIds: Accessor<string[]>;
+    /** 订阅可见性；首个订阅者开启 IntersectionObserver，最后一个移除时断开 */
+    subscribeVisibility: () => () => void;
+    options: Accessor<Required<Omit<MessageScrollerProviderProps, "children">>>;
+}
+export interface MessageScrollerVisibilityValue {
+    currentAnchorId: Accessor<string | null>;
+    visibleMessageIds: Accessor<string[]>;
+}
+export type MessageScrollerProps = PolymorphicProps<"div", BaseProps, false>;
+export type MessageScrollerViewportProps = PolymorphicProps<"div", BaseProps & {
+    "aria-label"?: string;
+    /** 上方插入历史时保持可见行，默认 true */
+    preserveScrollOnPrepend?: boolean;
+}, false>;
+export type MessageScrollerContentProps = PolymorphicProps<"div", BaseProps & {
+    "aria-busy"?: boolean;
+    /** 内部 spacer 的类名（仅为锚定行腾出可视空间，aria-hidden） */
+    spacerClassName?: string;
+}, false>;
+export type MessageScrollerItemProps = PolymorphicProps<"div", BaseProps & {
+    messageId?: string;
+    scrollAnchor?: boolean;
+}, false>;
+export type MessageScrollerButtonProps = PolymorphicProps<"button", BaseProps & {
+    direction?: MessageScrollerButtonDirection;
+    /** 原生滚动行为，默认 "smooth" */
+    behavior?: ScrollBehavior;
+    variant?: string;
+    size?: string;
+}>;

package/dist/components/message-scroller/message-scroller.utils.d.ts

@@ -0,0 +1,7 @@
+import { Accessor } from 'solid-js';
+/**
+ * `data-scrollable` 的取值：可向哪个边缘滚动，空格分隔的 token 列表
+ * （`"start"` / `"end"` / `"start end"`），都不可滚时为 `undefined`
+ * （可用 `[data-scrollable~="end"]` 查询单个方向，缺失表示内容放得下）。
+ */
+export declare function scrollableData(start: Accessor<boolean>, end: Accessor<boolean>): string | undefined;

package/dist/components/message-scroller/message-scroller.utils.js

@@ -0,0 +1,9 @@
+//#region src/components/message-scroller/message-scroller.utils.ts
+function e(e, t) {
+	let n = [];
+	return e() && n.push("start"), t() && n.push("end"), n.length > 0 ? n.join(" ") : void 0;
+}
+//#endregion
+export { e as scrollableData };
+
+//# sourceMappingURL=message-scroller.utils.js.map

package/dist/components/message-scroller/message-scroller.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-scroller.utils.js","names":["scrollableData","tokens","start","end"],"sources":["../../../src/components/message-scroller/message-scroller.utils.ts"],"sourcesContent":["import type { Accessor } from \"solid-js\";\n\n/**\n * `data-scrollable` 的取值：可向哪个边缘滚动，空格分隔的 token 列表\n * （`\"start\"` / `\"end\"` / `\"start end\"`），都不可滚时为 `undefined`\n * （可用 `[data-scrollable~=\"end\"]` 查询单个方向，缺失表示内容放得下）。\n */\nexport function scrollableData(\n  start: Accessor<boolean>,\n  end: Accessor<boolean>,\n): string | undefined {\n  const tokens: string[] = [];\n  if (start()) tokens.push(\"start\");\n  if (end()) tokens.push(\"end\");\n  return tokens.length > 0 ? tokens.join(\" \") : undefined;\n}\n"],"mappings":";AAOA,SAAgBA,EACd,GACA,GACoB;CACpB,IAAMC,IAAmB,CAAC;CAG1B,OAFIC,EAAM,KAAGD,EAAO,KAAK,OAAO,GAC5BE,EAAI,KAAGF,EAAO,KAAK,KAAK,GACrBA,EAAO,SAAS,IAAIA,EAAO,KAAK,GAAG,IAAI,KAAA;AAChD"}

package/dist/components/message-scroller/useMessageScroller.d.ts

@@ -0,0 +1,6 @@
+/** 在 Provider 内部任意位置驱动滚动（含 MessageScroller 框架之外的自定义控件） */
+export declare function useMessageScroller(): {
+    scrollToStart: (options?: import('./message-scroller.types').MessageScrollerScrollOptions) => boolean;
+    scrollToEnd: (options?: import('./message-scroller.types').MessageScrollerScrollOptions) => boolean;
+    scrollToMessage: (messageId: string, options?: import('./message-scroller.types').MessageScrollerScrollOptions) => boolean;
+};

package/dist/components/message-scroller/useMessageScroller.js

@@ -0,0 +1,14 @@
+import { useMessageScrollerContext as e } from "./message-scroller.context.js";
+//#region src/components/message-scroller/useMessageScroller.ts
+function t() {
+	let t = e("useMessageScroller");
+	return {
+		scrollToStart: t.scrollToStart,
+		scrollToEnd: t.scrollToEnd,
+		scrollToMessage: t.scrollToMessage
+	};
+}
+//#endregion
+export { t as useMessageScroller };
+
+//# sourceMappingURL=useMessageScroller.js.map

package/dist/components/message-scroller/useMessageScroller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMessageScroller.js","names":["useMessageScroller","ctx","useMessageScrollerContext"],"sources":["../../../src/components/message-scroller/useMessageScroller.ts"],"sourcesContent":["import { useMessageScrollerContext } from \"./message-scroller.context\";\n\n/** 在 Provider 内部任意位置驱动滚动（含 MessageScroller 框架之外的自定义控件） */\nexport function useMessageScroller() {\n  const ctx = useMessageScrollerContext(\"useMessageScroller\");\n  return {\n    scrollToStart: ctx.scrollToStart,\n    scrollToEnd: ctx.scrollToEnd,\n    scrollToMessage: ctx.scrollToMessage,\n  };\n}\n"],"mappings":";;AAGA,SAAgBA,IAAqB;CACnC,IAAMC,IAAMC,EAA0B,oBAAoB;CAC1D,OAAO;EACL,eAAeD,EAAI;EACnB,aAAaA,EAAI;EACjB,iBAAiBA,EAAI;CACvB;AACF"}

package/dist/components/message-scroller/useMessageScrollerEngine.d.ts

@@ -0,0 +1,15 @@
+import { MessageScrollerContextValue, MessageScrollerProviderProps } from './message-scroller.types';
+/**
+ * MessageScroller 的滚动引擎（headless，行为对齐 `@shadcn/react`）：
+ * - 滚动状态（能否向上/下）由 content 的**非 spacer** 内容底部计算，spacer 不计入；
+ * - `autoScroll` 只在模式为 `following-bottom` 时跟随；滚轮/触摸/键盘滚动与显式跳转
+ *   都会立刻让位（`free-scrolling`）；
+ * - 新回合锚定：新增 scrollAnchor 行时用 `scrollToElement(keepPreviousPeek)` 将其放到
+ *   顶部并保留上一项；同时把该行记为 `streamingTurn`，回复生长时原地重锚定；
+ * - `scrollToElement` 会按需设置尾部 spacer，让目标行即使靠近会话末尾也能滚到顶部；
+ * - `defaultScrollPosition`：首次非空渲染定位一次；`last-anchor` 无锚点或放得下时回退 end；
+ * - `preserveScrollOnPrepend`：记录首个可见行及其视口位置，上方插入历史后按差值补偿；
+ * - 可见性：IntersectionObserver 按需订阅（rootMargin 用 scrollMargin + peek），无 IO 时退化为
+ *   逐帧测量；`currentAnchorId` 是阅读行之上最后一个锚点。
+ */
+export declare function useMessageScrollerEngine(options: () => Required<Omit<MessageScrollerProviderProps, "children">>): MessageScrollerContextValue;