@xihan-ui/vue 1.0.0 → 2.0.0

package/dist/components/resizable/resizable.js

@@ -0,0 +1,69 @@
+import { withXhConfig } from "../../config/config.js";
+import { provideResizable, useResizableContext } from "./context.js";
+import { useResizable } from "./use-resizable.js";
+import { defineComponent, h } from "vue";
+//#region src/components/resizable/resizable.ts
+const XhResizableRoot = defineComponent({
+	name: "XhResizableRoot",
+	props: {
+		dimensions: { type: Object },
+		defaultDimensions: { type: Object },
+		minWidth: { type: Number },
+		minHeight: { type: Number },
+		maxWidth: { type: Number },
+		maxHeight: { type: Number },
+		aspectRatio: { type: Number },
+		step: { type: Number },
+		keyboardStep: { type: Number },
+		keyboardLargeStep: { type: Number },
+		edges: { type: Array },
+		disabled: Boolean,
+		dir: { type: String },
+		translations: { type: Object }
+	},
+	emits: {
+		"dimensions-change": (_details) => true,
+		"update:dimensions": (_dimensions) => true,
+		"dimensions-change-end": (_details) => true
+	},
+	slots: Object,
+	setup(props, { slots, emit }) {
+		const notify = (details) => {
+			emit("dimensions-change", details);
+			emit("update:dimensions", details.dimensions);
+		};
+		const ctx = useResizable(withXhConfig("resizable", props), notify, (details) => emit("dimensions-change-end", details));
+		provideResizable(ctx);
+		return () => h("div", {
+			...ctx.api.value.getRootProps(),
+			ref: ctx.rootRef
+		}, slots.default?.({
+			dimensions: ctx.api.value.dimensions,
+			offset: ctx.api.value.offset,
+			resizing: ctx.api.value.resizing,
+			activeEdge: ctx.api.value.activeEdge
+		}));
+	}
+});
+/**
+* 一条边上的把手。
+*
+* 推动西边与北边时容器的起点会移动，该段位移写为 root 的 left / top：皮肤已提供
+* `position: relative`，默认即正确。把 root 改为 static 会使这两个方向只改变尺寸不移动位置。
+*/
+const XhResizableHandle = defineComponent({
+	name: "XhResizableHandle",
+	props: { edge: {
+		type: String,
+		required: true
+	} },
+	slots: Object,
+	setup(props, { slots }) {
+		const ctx = useResizableContext();
+		return () => h("span", ctx.api.value.getHandleProps({ edge: props.edge }), slots.default?.());
+	}
+});
+//#endregion
+export { XhResizableHandle, XhResizableRoot };
+
+//# sourceMappingURL=resizable.js.map

package/dist/components/resizable/resizable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resizable.js","names":[],"sources":["../../../src/components/resizable/resizable.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 resizable 相关实现。\n\nimport type { Direction } from '@xihan-ui/core'\nimport type { ResizableDimensions, ResizableOffset, ResizableSchema, ResizableTranslations } from '@xihan-ui/headless'\nimport type { ResizeEdge } from '@xihan-ui/pointer'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideResizable, useResizableContext } from './context'\nimport { useResizable } from './use-resizable'\n\ntype ResizableProps = ResizableSchema['props']\n\n/** 默认插槽的载荷：当前尺寸、位移与调整态。 */\nexport interface ResizableRootSlotProps {\n  dimensions: ResizableDimensions\n  offset: ResizableOffset\n  resizing: boolean\n  activeEdge: ResizeEdge | null\n}\n\nexport const XhResizableRoot = defineComponent({\n  name: 'XhResizableRoot',\n  props: {\n    dimensions: { type: Object as PropType<ResizableDimensions> },\n    defaultDimensions: { type: Object as PropType<ResizableDimensions> },\n    minWidth: { type: Number },\n    minHeight: { type: Number },\n    maxWidth: { type: Number },\n    maxHeight: { type: Number },\n    aspectRatio: { type: Number },\n    step: { type: Number },\n    keyboardStep: { type: Number },\n    keyboardLargeStep: { type: Number },\n    edges: { type: Array as PropType<ResizeEdge[]> },\n    disabled: Boolean,\n    dir: { type: String as PropType<Direction> },\n    translations: { type: Object as PropType<Partial<ResizableTranslations>> },\n  },\n  // dimensions-change 携带 { dimensions }，update:dimensions 携带裸尺寸（v-model:dimensions）；\n  // dimensions-change-end 只在一次调整收尾时发一次，存尺寸用它\n  emits: {\n    'dimensions-change': (_details: PayloadOf<ResizableProps, 'onDimensionsChange'>) => true,\n    'update:dimensions': (_dimensions: PayloadOf<ResizableProps, 'onDimensionsChange'>['dimensions']) => true,\n    'dimensions-change-end': (_details: PayloadOf<ResizableProps, 'onDimensionsChangeEnd'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ResizableRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: ResizableProps['onDimensionsChange'] = (details) => {\n      emit('dimensions-change', details)\n      emit('update:dimensions', details.dimensions)\n    }\n    const ctx = useResizable(withXhConfig('resizable', props) as ResizableProps, notify, details => emit('dimensions-change-end', details))\n    provideResizable(ctx)\n\n    return () => h('div', {\n      ...ctx.api.value.getRootProps() as Record<string, unknown>,\n      ref: ctx.rootRef,\n    }, slots.default?.({\n      dimensions: ctx.api.value.dimensions,\n      offset: ctx.api.value.offset,\n      resizing: ctx.api.value.resizing,\n      activeEdge: ctx.api.value.activeEdge,\n    }))\n  },\n})\n\n/**\n * 一条边上的把手。\n *\n * 推动西边与北边时容器的起点会移动，该段位移写为 root 的 left / top：皮肤已提供\n * `position: relative`，默认即正确。把 root 改为 static 会使这两个方向只改变尺寸不移动位置。\n */\nexport const XhResizableHandle = defineComponent({\n  name: 'XhResizableHandle',\n  props: {\n    edge: { type: String as PropType<ResizeEdge>, required: true },\n  },\n  slots: Object as SlotsType<{\n    default?: () => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const ctx = useResizableContext()\n    return () => h(\n      'span',\n      ctx.api.value.getHandleProps({ edge: props.edge }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":";;;;;AA2BA,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,OAAO;EACL,YAAY,EAAE,MAAM,OAAwC;EAC5D,mBAAmB,EAAE,MAAM,OAAwC;EACnE,UAAU,EAAE,MAAM,OAAO;EACzB,WAAW,EAAE,MAAM,OAAO;EAC1B,UAAU,EAAE,MAAM,OAAO;EACzB,WAAW,EAAE,MAAM,OAAO;EAC1B,aAAa,EAAE,MAAM,OAAO;EAC5B,MAAM,EAAE,MAAM,OAAO;EACrB,cAAc,EAAE,MAAM,OAAO;EAC7B,mBAAmB,EAAE,MAAM,OAAO;EAClC,OAAO,EAAE,MAAM,MAAgC;EAC/C,UAAU;EACV,KAAK,EAAE,MAAM,OAA8B;EAC3C,cAAc,EAAE,MAAM,OAAmD;CAC3E;CAGA,OAAO;EACL,sBAAsB,aAA8D;EACpF,sBAAsB,gBAA+E;EACrG,0BAA0B,aAAiE;CAC7F;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAAgD,YAAY;GAChE,KAAK,qBAAqB,OAAO;GACjC,KAAK,qBAAqB,QAAQ,UAAU;EAC9C;EACA,MAAM,MAAM,aAAa,aAAa,aAAa,KAAK,GAAqB,SAAQ,YAAW,KAAK,yBAAyB,OAAO,CAAC;EACtI,iBAAiB,GAAG;EAEpB,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,aAAa;GAC9B,KAAK,IAAI;EACX,GAAG,MAAM,UAAU;GACjB,YAAY,IAAI,IAAI,MAAM;GAC1B,QAAQ,IAAI,IAAI,MAAM;GACtB,UAAU,IAAI,IAAI,MAAM;GACxB,YAAY,IAAI,IAAI,MAAM;EAC5B,CAAC,CAAC;CACJ;AACF,CAAC;;;;;;;AAQD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,OAAO,EACL,MAAM;EAAE,MAAM;EAAgC,UAAU;CAAK,EAC/D;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,oBAAoB;EAChC,aAAa,EACX,QACA,IAAI,IAAI,MAAM,eAAe,EAAE,MAAM,MAAM,KAAK,CAAC,GACjD,MAAM,UAAU,CAClB;CACF;AACF,CAAC"}

package/dist/components/resizable/use-resizable.d.ts

@@ -0,0 +1,14 @@
+import { ComputedRef, Ref } from "vue";
+import { Service } from "@xihan-ui/core";
+import { ResizableApi, ResizableSchema } from "@xihan-ui/headless";
+//#region src/components/resizable/use-resizable.d.ts
+interface ResizableContext {
+  api: ComputedRef<ResizableApi>;
+  service: Service<ResizableSchema>;
+  /** 容器节点，状态机在按下时读取它的矩形。 */
+  rootRef: Ref<HTMLElement | null>;
+}
+declare function useResizable(props: ResizableSchema['props'], onDimensionsChange?: ResizableSchema['props']['onDimensionsChange'], onDimensionsChangeEnd?: ResizableSchema['props']['onDimensionsChangeEnd']): ResizableContext;
+//#endregion
+export { ResizableContext, useResizable };
+//# sourceMappingURL=use-resizable.d.ts.map

package/dist/components/resizable/use-resizable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-resizable.d.ts","names":[],"sources":["../../../src/components/resizable/use-resizable.ts"],"mappings":";;;;UAiBiB;EACf,KAAK,YAAY;EACjB,SAAS,QAAQ;;EAEjB,SAAS,IAAI;;iBAGC,aACd,OAAO,0BACP,qBAAqB,gDACrB,wBAAwB,oDACvB"}

package/dist/components/resizable/use-resizable.js

@@ -0,0 +1,25 @@
+import { vueNormalize } from "../../runtime/normalize-props.js";
+import { useMachine } from "../../runtime/use-machine.js";
+import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { computed, ref } from "vue";
+import { createScope } from "@xihan-ui/core";
+import { connectResizable, resizableMachine } from "@xihan-ui/headless";
+//#region src/components/resizable/use-resizable.ts
+function useResizable(props, onDimensionsChange, onDimensionsChangeEnd) {
+	const rootRef = ref(null);
+	const service = useMachine(resizableMachine, () => ({
+		...props,
+		onDimensionsChange,
+		onDimensionsChangeEnd
+	}), createScope(null, createVueIdGenerator()));
+	service.refs.set("getRootEl", () => rootRef.value);
+	return {
+		api: computed(() => connectResizable(service, vueNormalize)),
+		service,
+		rootRef
+	};
+}
+//#endregion
+export { useResizable };
+
+//# sourceMappingURL=use-resizable.js.map

package/dist/components/resizable/use-resizable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-resizable.js","names":[],"sources":["../../../src/components/resizable/use-resizable.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use resizable 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { ResizableApi, ResizableSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectResizable, resizableMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface ResizableContext {\n  api: ComputedRef<ResizableApi>\n  service: Service<ResizableSchema>\n  /** 容器节点，状态机在按下时读取它的矩形。 */\n  rootRef: Ref<HTMLElement | null>\n}\n\nexport function useResizable(\n  props: ResizableSchema['props'],\n  onDimensionsChange?: ResizableSchema['props']['onDimensionsChange'],\n  onDimensionsChangeEnd?: ResizableSchema['props']['onDimensionsChangeEnd'],\n): ResizableContext {\n  const rootRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(resizableMachine, () => ({ ...props, onDimensionsChange, onDimensionsChangeEnd }), scope)\n\n  // 传 getter 而非节点，ref 在挂载后才有值\n  service.refs.set('getRootEl', () => rootRef.value)\n\n  const api = computed(() => connectResizable(service, vueNormalize))\n  return { api, service, rootRef }\n}\n"],"mappings":";;;;;;;AAwBA,SAAgB,aACd,OACA,oBACA,uBACkB;CAClB,MAAM,UAAU,IAAwB,IAAI;CAI5C,MAAM,UAAU,WAAW,yBAAyB;EAAE,GAAG;EAAO;EAAoB;CAAsB,IAD5F,YAAY,MADZ,qBACsB,CAC8E,CAAC;CAGnH,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CAGjD,OAAO;EAAE,KADG,eAAe,iBAAiB,SAAS,YAAY,CACtD;EAAG;EAAS;CAAQ;AACjC"}

package/dist/components/scroll-area/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/scroll-area/context.ts"],"sourcesContent":["import type { ScrollAreaScrollbarProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { ScrollAreaContext } from './use-scroll-area'\nimport { inject, provide } from 'vue'\n\n/** 滚动条自报的轴向，供它内部的滑块复用同一份声明。 */\nexport interface ScrollAreaScrollbarContext {\n  scrollbar: ComputedRef<ScrollAreaScrollbarProps>\n}\n\nconst KEY: InjectionKey<ScrollAreaContext> = Symbol.for('xh-scroll-area')\nconst SCROLLBAR_KEY: InjectionKey<ScrollAreaScrollbarContext> = Symbol.for('xh-scroll-area-scrollbar')\n\nexport function provideScrollArea(ctx: ScrollAreaContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useScrollAreaContext(): ScrollAreaContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] ScrollArea 部件必须用在 XhScrollAreaRoot 内')\n  return ctx\n}\n\nexport function provideScrollAreaScrollbar(ctx: ScrollAreaScrollbarContext): void {\n  provide(SCROLLBAR_KEY, ctx)\n}\n\nexport function useScrollAreaScrollbarContext(): ScrollAreaScrollbarContext {\n  const ctx = inject(SCROLLBAR_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] ScrollArea 滑块必须用在 XhScrollAreaScrollbar 内')\n  return ctx\n}\n"],"mappings":";;AAUA,MAAM,MAAuC,OAAO,IAAI,gBAAgB;AACxE,MAAM,gBAA0D,OAAO,IAAI,0BAA0B;AAErG,SAAgB,kBAAkB,KAA8B;CAC9D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,uBAA0C;CACxD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,2CAA2C;CAC7D,OAAO;AACT;AAEA,SAAgB,2BAA2B,KAAuC;CAChF,QAAQ,eAAe,GAAG;AAC5B;AAEA,SAAgB,gCAA4D;CAC1E,MAAM,MAAM,OAAO,eAAe,IAAI;CACtC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,gDAAgD;CAClE,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/scroll-area/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { ScrollAreaScrollbarProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { ScrollAreaContext } from './use-scroll-area'\nimport { inject, provide } from 'vue'\n\n/** 滚动条声明的轴向，供它内部的滑块复用同一份声明。 */\nexport interface ScrollAreaScrollbarContext {\n  scrollbar: ComputedRef<ScrollAreaScrollbarProps>\n}\n\nconst KEY: InjectionKey<ScrollAreaContext> = Symbol.for('xh-scroll-area')\nconst SCROLLBAR_KEY: InjectionKey<ScrollAreaScrollbarContext> = Symbol.for('xh-scroll-area-scrollbar')\n\nexport function provideScrollArea(ctx: ScrollAreaContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useScrollAreaContext(): ScrollAreaContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] ScrollArea 部件必须用在 XhScrollAreaRoot 内')\n  return ctx\n}\n\nexport function provideScrollAreaScrollbar(ctx: ScrollAreaScrollbarContext): void {\n  provide(SCROLLBAR_KEY, ctx)\n}\n\nexport function useScrollAreaScrollbarContext(): ScrollAreaScrollbarContext {\n  const ctx = inject(SCROLLBAR_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] ScrollArea 滑块必须用在 XhScrollAreaScrollbar 内')\n  return ctx\n}\n"],"mappings":";;AAiBA,MAAM,MAAuC,OAAO,IAAI,gBAAgB;AACxE,MAAM,gBAA0D,OAAO,IAAI,0BAA0B;AAErG,SAAgB,kBAAkB,KAA8B;CAC9D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,uBAA0C;CACxD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,2CAA2C;CAC7D,OAAO;AACT;AAEA,SAAgB,2BAA2B,KAAuC;CAChF,QAAQ,eAAe,GAAG;AAC5B;AAEA,SAAgB,gCAA4D;CAC1E,MAAM,MAAM,OAAO,eAAe,IAAI;CACtC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,gDAAgD;CAClE,OAAO;AACT"}

package/dist/components/scroll-area/scroll-area.d.ts

@@ -1,64 +1,55 @@
 import { PropType, SlotsType, VNode } from "vue";
-import { ScrollAreaApi, ScrollAreaOrientation, ScrollbarType } from "@xihan-ui/headless";
-import { Direction, Orientation, Size } from "@xihan-ui/kernel";
+import { Direction, Orientation, Size } from "@xihan-ui/core";
+import { ScrollAreaApi, ScrollAreaOrientation, ScrollAreaVariant, ScrollbarType } from "@xihan-ui/headless";
 //#region src/components/scroll-area/scroll-area.d.ts
-/** 默认插槽的载荷：两条轴的滚动条状态、正被拖动的那条轴，以及右下角补丁该不该显形。 */
+/** 默认插槽的载荷：两条轴的滚动条状态、正被拖动的轴，以及右下角补丁是否应当显示。 */
 type ScrollAreaRootSlotProps = Pick<ScrollAreaApi, 'vertical' | 'horizontal' | 'draggingAxis' | 'cornerVisible'>;
 declare const XhScrollAreaRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   type: {
     type: PropType<ScrollbarType>;
-    default: undefined;
   };
   hideDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
   orientation: {
     type: PropType<ScrollAreaOrientation>;
-    default: undefined;
+  };
+  variant: {
+    type: PropType<ScrollAreaVariant>;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
-  /** 触屏（粗指针）上也画自绘滚动条；缺省交给原生滚动。 */
+  /** 触屏（粗指针）上也绘制自绘滚动条；默认交给原生滚动。 */
   forceVisible: BooleanConstructor;
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   type: {
     type: PropType<ScrollbarType>;
-    default: undefined;
   };
   hideDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
   orientation: {
     type: PropType<ScrollAreaOrientation>;
-    default: undefined;
+  };
+  variant: {
+    type: PropType<ScrollAreaVariant>;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
-  /** 触屏（粗指针）上也画自绘滚动条；缺省交给原生滚动。 */
+  /** 触屏（粗指针）上也绘制自绘滚动条；默认交给原生滚动。 */
   forceVisible: BooleanConstructor;
 }>> & Readonly<{}>, {
-  type: ScrollbarType;
-  orientation: ScrollAreaOrientation;
-  dir: Direction;
-  size: Size;
   forceVisible: boolean;
-  hideDelay: number;
 }, SlotsType<{
   default?: (props: ScrollAreaRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -68,9 +59,9 @@ declare const XhScrollAreaViewport: import("vue").DefineComponent<{}, () => VNod
 declare const XhScrollAreaContent: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-/** 某条轴的滚动条挂载点，同时是那条 scrollbar 的根；里面照 scrollbar 的写法摆轨道、滑块与交叉口。 */
+/** 某条轴的滚动条挂载点，同时是该 scrollbar 的根；其中按 scrollbar 的写法放置轨道、滑块与交叉口。 */
 declare const XhScrollAreaScrollbar: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-  /** 这条滚动条管哪条轴。 */
+  /** 该滚动条管理哪条轴。 */
   orientation: {
     type: PropType<Orientation>;
     default: string;
@@ -78,7 +69,7 @@ declare const XhScrollAreaScrollbar: import("vue").DefineComponent<import("vue")
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-  /** 这条滚动条管哪条轴。 */
+  /** 该滚动条管理哪条轴。 */
   orientation: {
     type: PropType<Orientation>;
     default: string;
@@ -92,7 +83,7 @@ declare const XhScrollAreaTrack: import("vue").DefineComponent<{}, () => VNode<i
 declare const XhScrollAreaThumb: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-/** 交叉口补丁，写在竖条的挂载点里；两条都在场时才显形。 */
+/** 交叉口补丁，写在竖条的挂载点中；两条都在场时才显示。 */
 declare const XhScrollAreaCorner: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/components/scroll-area/scroll-area.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scroll-area.d.ts","names":[],"sources":["../../../src/components/scroll-area/scroll-area.ts"],"mappings":";;;;;KAcY,0BAA0B,KAAK;cAE9B,gCAAgB,8BAAA;;IAID,MAAA,SAAS;;;;;;;;IAEF,MAAA,SAAS;;;;IAChB,MAAA,SAAS;;;;IACV,MAAA,SAAS;;;;;;;;;IAJR,MAAA,SAAS;;;;;;;;IAEF,MAAA,SAAS;;;;IAChB,MAAA,SAAS;;;;IACV,MAAA,SAAS;;;;;;;;;;;;;EAKtB,WAAC,OAAO,4BAA4B;kCAahD;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAU/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAS9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,qCAAqB,8BAAA;;;IAIC,MAAA,SAAS;;;;;;;;IAAT,MAAA,SAAS;;;;;qCAY1C;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAW5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"scroll-area.d.ts","names":[],"sources":["../../../src/components/scroll-area/scroll-area.ts"],"mappings":";;;;;KAqBY,0BAA0B,KAAK;cAE9B,gCAAgB,8BAAA;;IAID,MAAA,SAAS;;;;;;IAEF,MAAA,SAAS;;;IACb,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;;;IALR,MAAA,SAAS;;;;;;IAEF,MAAA,SAAS;;;IACb,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;;EAKtB,WAAC,OAAO,4BAA4B;kCAahD;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAU/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAS9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,qCAAqB,8BAAA;;;IAIC,MAAA,SAAS;;;;;;;;IAAT,MAAA,SAAS;;;;;qCAY1C;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAW5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/scroll-area/scroll-area.js

@@ -6,27 +6,13 @@ import { computed, defineComponent, h } from "vue";
 const XhScrollAreaRoot = defineComponent({
 	name: "XhScrollAreaRoot",
 	props: {
-		type: {
-			type: String,
-			default: void 0
-		},
-		hideDelay: {
-			type: Number,
-			default: void 0
-		},
-		orientation: {
-			type: String,
-			default: void 0
-		},
-		size: {
-			type: String,
-			default: void 0
-		},
-		dir: {
-			type: String,
-			default: void 0
-		},
-		/** 触屏（粗指针）上也画自绘滚动条；缺省交给原生滚动。 */
+		type: { type: String },
+		hideDelay: { type: Number },
+		orientation: { type: String },
+		variant: { type: String },
+		size: { type: String },
+		dir: { type: String },
+		/** 触屏（粗指针）上也绘制自绘滚动条；默认交给原生滚动。 */
 		forceVisible: Boolean
 	},
 	slots: Object,
@@ -61,11 +47,11 @@ const XhScrollAreaContent = defineComponent({
 		}, slots.default?.());
 	}
 });
-/** 某条轴的滚动条挂载点，同时是那条 scrollbar 的根；里面照 scrollbar 的写法摆轨道、滑块与交叉口。 */
+/** 某条轴的滚动条挂载点，同时是该 scrollbar 的根；其中按 scrollbar 的写法放置轨道、滑块与交叉口。 */
 const XhScrollAreaScrollbar = defineComponent({
 	name: "XhScrollAreaScrollbar",
 	props: { 
-	/** 这条滚动条管哪条轴。 */
+	/** 该滚动条管理哪条轴。 */
 orientation: {
 		type: String,
 		default: "vertical"
@@ -99,7 +85,7 @@ const XhScrollAreaThumb = defineComponent({
 		return () => h("div", ctx.api.value.getThumbProps(scrollbar.value), slots.default?.());
 	}
 });
-/** 交叉口补丁，写在竖条的挂载点里；两条都在场时才显形。 */
+/** 交叉口补丁，写在竖条的挂载点中；两条都在场时才显示。 */
 const XhScrollAreaCorner = defineComponent({
 	name: "XhScrollAreaCorner",
 	setup(_, { slots }) {

package/dist/components/scroll-area/scroll-area.js.map

@@ -1 +1 @@
-{"version":3,"file":"scroll-area.js","names":[],"sources":["../../../src/components/scroll-area/scroll-area.ts"],"sourcesContent":["import type { ScrollAreaApi, ScrollAreaOrientation, ScrollAreaProps, ScrollAreaScrollbarProps, ScrollbarType } from '@xihan-ui/headless'\nimport type { Direction, Orientation, Size } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport {\n  provideScrollArea,\n  provideScrollAreaScrollbar,\n  useScrollAreaContext,\n  useScrollAreaScrollbarContext,\n} from './context'\nimport { useScrollArea } from './use-scroll-area'\n\n/** 默认插槽的载荷：两条轴的滚动条状态、正被拖动的那条轴，以及右下角补丁该不该显形。 */\nexport type ScrollAreaRootSlotProps = Pick<ScrollAreaApi, 'vertical' | 'horizontal' | 'draggingAxis' | 'cornerVisible'>\n\nexport const XhScrollAreaRoot = defineComponent({\n  name: 'XhScrollAreaRoot',\n  // 缺省值由 scrollbar 的机器与 connect 给出，这里一律 default: undefined\n  props: {\n    type: { type: String as PropType<ScrollbarType>, default: undefined },\n    hideDelay: { type: Number, default: undefined },\n    orientation: { type: String as PropType<ScrollAreaOrientation>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n    dir: { type: String as PropType<Direction>, default: undefined },\n    /** 触屏（粗指针）上也画自绘滚动条；缺省交给原生滚动。 */\n    forceVisible: Boolean,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ScrollAreaRootSlotProps) => VNode[]\n  }>,\n  // 组件不对外报事件，滚动是原生的，宿主直接在视口上监听\n  setup(props, { slots }) {\n    const ctx = useScrollArea(withXhConfig('scroll-area', props) as ScrollAreaProps)\n    provideScrollArea(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      vertical: ctx.api.value.vertical,\n      horizontal: ctx.api.value.horizontal,\n      draggingAxis: ctx.api.value.draggingAxis,\n      cornerVisible: ctx.api.value.cornerVisible,\n    }))\n  },\n})\n\nexport const XhScrollAreaViewport = defineComponent({\n  name: 'XhScrollAreaViewport',\n  setup(_, { slots }) {\n    const ctx = useScrollAreaContext()\n    // 视口节点交给两台机器，尺寸与滚动量在效应与事件里现量\n    return () => h('div', {\n      ...ctx.api.value.getViewportProps() as Record<string, unknown>,\n      ref: ctx.viewportRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhScrollAreaContent = defineComponent({\n  name: 'XhScrollAreaContent',\n  setup(_, { slots }) {\n    const ctx = useScrollAreaContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      ref: ctx.contentRef,\n    }, slots.default?.())\n  },\n})\n\n/** 某条轴的滚动条挂载点，同时是那条 scrollbar 的根；里面照 scrollbar 的写法摆轨道、滑块与交叉口。 */\nexport const XhScrollAreaScrollbar = defineComponent({\n  name: 'XhScrollAreaScrollbar',\n  props: {\n    /** 这条滚动条管哪条轴。 */\n    orientation: { type: String as PropType<Orientation>, default: 'vertical' },\n  },\n  setup(props, { slots }) {\n    const ctx = useScrollAreaContext()\n    const scrollbar = computed<ScrollAreaScrollbarProps>(() => ({ orientation: props.orientation }))\n    provideScrollAreaScrollbar({ scrollbar })\n    return () => h('div', {\n      ...ctx.api.value.getScrollbarProps(scrollbar.value) as Record<string, unknown>,\n      // 根节点交给机器：指针进出它也算「手还在这儿」\n      ref: ctx.scrollbarRefs[props.orientation],\n    }, slots.default?.())\n  },\n})\n\nexport const XhScrollAreaTrack = defineComponent({\n  name: 'XhScrollAreaTrack',\n  setup(_, { slots }) {\n    const ctx = useScrollAreaContext()\n    const { scrollbar } = useScrollAreaScrollbarContext()\n    // 轨道节点交给机器，长度在按下滑块时现量\n    return () => h('div', {\n      ...ctx.api.value.getTrackProps(scrollbar.value) as Record<string, unknown>,\n      ref: ctx.trackRefs[scrollbar.value.orientation],\n    }, slots.default?.())\n  },\n})\n\nexport const XhScrollAreaThumb = defineComponent({\n  name: 'XhScrollAreaThumb',\n  setup(_, { slots }) {\n    const ctx = useScrollAreaContext()\n    const { scrollbar } = useScrollAreaScrollbarContext()\n    return () => h('div', ctx.api.value.getThumbProps(scrollbar.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 交叉口补丁，写在竖条的挂载点里；两条都在场时才显形。 */\nexport const XhScrollAreaCorner = defineComponent({\n  name: 'XhScrollAreaCorner',\n  setup(_, { slots }) {\n    const ctx = useScrollAreaContext()\n    return () => h('div', ctx.api.value.getCornerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;AAgBA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CAEN,OAAO;EACL,MAAM;GAAE,MAAM;GAAmC,SAAS,KAAA;EAAU;EACpE,WAAW;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC9C,aAAa;GAAE,MAAM;GAA2C,SAAS,KAAA;EAAU;EACnF,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;EAC3D,KAAK;GAAE,MAAM;GAA+B,SAAS,KAAA;EAAU;;EAE/D,cAAc;CAChB;CACA,OAAO;CAIP,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,cAAc,aAAa,eAAe,KAAK,CAAoB;EAC/E,kBAAkB,GAAG;EACrB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,UAAU,IAAI,IAAI,MAAM;GACxB,YAAY,IAAI,IAAI,MAAM;GAC1B,cAAc,IAAI,IAAI,MAAM;GAC5B,eAAe,IAAI,IAAI,MAAM;EAC/B,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EAEjC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,iBAAiB;GAClC,KAAK,IAAI;EACX,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,gBAAgB;GACjC,KAAK,IAAI;EACX,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;;AAGD,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,OAAO;;AAEL,aAAa;EAAE,MAAM;EAAiC,SAAS;CAAW,EAC5E;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,qBAAqB;EACjC,MAAM,YAAY,gBAA0C,EAAE,aAAa,MAAM,YAAY,EAAE;EAC/F,2BAA2B,EAAE,UAAU,CAAC;EACxC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,kBAAkB,UAAU,KAAK;GAElD,KAAK,IAAI,cAAc,MAAM;EAC/B,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,MAAM,EAAE,cAAc,8BAA8B;EAEpD,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,cAAc,UAAU,KAAK;GAC9C,KAAK,IAAI,UAAU,UAAU,MAAM;EACrC,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,MAAM,EAAE,cAAc,8BAA8B;EACpD,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,UAAU,KAAK,GAA8B,MAAM,UAAU,CAAC;CAClH;AACF,CAAC;;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC"}
+{"version":3,"file":"scroll-area.js","names":[],"sources":["../../../src/components/scroll-area/scroll-area.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 scroll area 相关实现。\n\nimport type { Direction, Orientation, Size } from '@xihan-ui/core'\nimport type { ScrollAreaApi, ScrollAreaOrientation, ScrollAreaProps, ScrollAreaScrollbarProps, ScrollAreaVariant, ScrollbarType } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport {\n  provideScrollArea,\n  provideScrollAreaScrollbar,\n  useScrollAreaContext,\n  useScrollAreaScrollbarContext,\n} from './context'\nimport { useScrollArea } from './use-scroll-area'\n\n/** 默认插槽的载荷：两条轴的滚动条状态、正被拖动的轴，以及右下角补丁是否应当显示。 */\nexport type ScrollAreaRootSlotProps = Pick<ScrollAreaApi, 'vertical' | 'horizontal' | 'draggingAxis' | 'cornerVisible'>\n\nexport const XhScrollAreaRoot = defineComponent({\n  name: 'XhScrollAreaRoot',\n  // 缺省值由 scrollbar 的机器与 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    type: { type: String as PropType<ScrollbarType> },\n    hideDelay: { type: Number },\n    orientation: { type: String as PropType<ScrollAreaOrientation> },\n    variant: { type: String as PropType<ScrollAreaVariant> },\n    size: { type: String as PropType<Size> },\n    dir: { type: String as PropType<Direction> },\n    /** 触屏（粗指针）上也绘制自绘滚动条；默认交给原生滚动。 */\n    forceVisible: Boolean,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ScrollAreaRootSlotProps) => VNode[]\n  }>,\n  // 组件不对外报事件，滚动是原生的，宿主直接在视口上监听\n  setup(props, { slots }) {\n    const ctx = useScrollArea(withXhConfig('scroll-area', props) as ScrollAreaProps)\n    provideScrollArea(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      vertical: ctx.api.value.vertical,\n      horizontal: ctx.api.value.horizontal,\n      draggingAxis: ctx.api.value.draggingAxis,\n      cornerVisible: ctx.api.value.cornerVisible,\n    }))\n  },\n})\n\nexport const XhScrollAreaViewport = defineComponent({\n  name: 'XhScrollAreaViewport',\n  setup(_, { slots }) {\n    const ctx = useScrollAreaContext()\n    // 视口节点交给两台机器，尺寸与滚动量在效应与事件里现量\n    return () => h('div', {\n      ...ctx.api.value.getViewportProps() as Record<string, unknown>,\n      ref: ctx.viewportRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhScrollAreaContent = defineComponent({\n  name: 'XhScrollAreaContent',\n  setup(_, { slots }) {\n    const ctx = useScrollAreaContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      ref: ctx.contentRef,\n    }, slots.default?.())\n  },\n})\n\n/** 某条轴的滚动条挂载点，同时是该 scrollbar 的根；其中按 scrollbar 的写法放置轨道、滑块与交叉口。 */\nexport const XhScrollAreaScrollbar = defineComponent({\n  name: 'XhScrollAreaScrollbar',\n  props: {\n    /** 该滚动条管理哪条轴。 */\n    orientation: { type: String as PropType<Orientation>, default: 'vertical' },\n  },\n  setup(props, { slots }) {\n    const ctx = useScrollAreaContext()\n    const scrollbar = computed<ScrollAreaScrollbarProps>(() => ({ orientation: props.orientation }))\n    provideScrollAreaScrollbar({ scrollbar })\n    return () => h('div', {\n      ...ctx.api.value.getScrollbarProps(scrollbar.value) as Record<string, unknown>,\n      // 根节点交给机器：指针进出它也算「手还在这儿」\n      ref: ctx.scrollbarRefs[props.orientation],\n    }, slots.default?.())\n  },\n})\n\nexport const XhScrollAreaTrack = defineComponent({\n  name: 'XhScrollAreaTrack',\n  setup(_, { slots }) {\n    const ctx = useScrollAreaContext()\n    const { scrollbar } = useScrollAreaScrollbarContext()\n    // 轨道节点交给机器，长度在按下滑块时现量\n    return () => h('div', {\n      ...ctx.api.value.getTrackProps(scrollbar.value) as Record<string, unknown>,\n      ref: ctx.trackRefs[scrollbar.value.orientation],\n    }, slots.default?.())\n  },\n})\n\nexport const XhScrollAreaThumb = defineComponent({\n  name: 'XhScrollAreaThumb',\n  setup(_, { slots }) {\n    const ctx = useScrollAreaContext()\n    const { scrollbar } = useScrollAreaScrollbarContext()\n    return () => h('div', ctx.api.value.getThumbProps(scrollbar.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 交叉口补丁，写在竖条的挂载点中；两条都在场时才显示。 */\nexport const XhScrollAreaCorner = defineComponent({\n  name: 'XhScrollAreaCorner',\n  setup(_, { slots }) {\n    const ctx = useScrollAreaContext()\n    return () => h('div', ctx.api.value.getCornerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;AAuBA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CAEN,OAAO;EACL,MAAM,EAAE,MAAM,OAAkC;EAChD,WAAW,EAAE,MAAM,OAAO;EAC1B,aAAa,EAAE,MAAM,OAA0C;EAC/D,SAAS,EAAE,MAAM,OAAsC;EACvD,MAAM,EAAE,MAAM,OAAyB;EACvC,KAAK,EAAE,MAAM,OAA8B;;EAE3C,cAAc;CAChB;CACA,OAAO;CAIP,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,cAAc,aAAa,eAAe,KAAK,CAAoB;EAC/E,kBAAkB,GAAG;EACrB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,UAAU,IAAI,IAAI,MAAM;GACxB,YAAY,IAAI,IAAI,MAAM;GAC1B,cAAc,IAAI,IAAI,MAAM;GAC5B,eAAe,IAAI,IAAI,MAAM;EAC/B,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EAEjC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,iBAAiB;GAClC,KAAK,IAAI;EACX,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,gBAAgB;GACjC,KAAK,IAAI;EACX,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;;AAGD,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,OAAO;;AAEL,aAAa;EAAE,MAAM;EAAiC,SAAS;CAAW,EAC5E;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,qBAAqB;EACjC,MAAM,YAAY,gBAA0C,EAAE,aAAa,MAAM,YAAY,EAAE;EAC/F,2BAA2B,EAAE,UAAU,CAAC;EACxC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,kBAAkB,UAAU,KAAK;GAElD,KAAK,IAAI,cAAc,MAAM;EAC/B,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,MAAM,EAAE,cAAc,8BAA8B;EAEpD,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,cAAc,UAAU,KAAK;GAC9C,KAAK,IAAI,UAAU,UAAU,MAAM;EACrC,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,MAAM,EAAE,cAAc,8BAA8B;EACpD,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,UAAU,KAAK,GAA8B,MAAM,UAAU,CAAC;CAClH;AACF,CAAC;;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC"}

package/dist/components/scroll-area/use-scroll-area.d.ts

@@ -1,20 +1,20 @@
 import { ComputedRef, MaybeRefOrGetter, Ref } from "vue";
+import { Orientation } from "@xihan-ui/core";
 import { ScrollAreaApi, ScrollAreaProps, ScrollAreaServices } from "@xihan-ui/headless";
-import { Orientation } from "@xihan-ui/kernel";
 //#region src/components/scroll-area/use-scroll-area.d.ts
 interface ScrollAreaContext {
-  /** 两条轴各一台 scrollbar 机器。 */
+  /** 两条轴各一台 scrollbar 状态机。 */
   services: ScrollAreaServices;
   api: ComputedRef<ScrollAreaApi>;
-  /** overflow:auto 的那层，两台机器都挂在它身上。 */
+  /** overflow:auto 的层，两台状态机都挂在它上面。 */
   viewportRef: Ref<HTMLElement | null>;
   /** 内容包裹层。 */
   contentRef: Ref<HTMLElement | null>;
-  /** 两条轴各自的挂载点（即那条 scrollbar 的根）与轨道，按轴现量。 */
+  /** 两条轴各自的挂载点（即该 scrollbar 的根）与轨道，按轴现测。 */
   scrollbarRefs: Record<Orientation, Ref<HTMLElement | null>>;
   trackRefs: Record<Orientation, Ref<HTMLElement | null>>;
 }
-/** 滚动区没有自己的机器：按轴各建一台 scrollbar，视口就是它们共同的滚动容器。 */
+/** 滚动区没有自己的状态机：按轴各建一台 scrollbar，视口就是它们共同的滚动容器。 */
 declare function useScrollArea(source: MaybeRefOrGetter<ScrollAreaProps>): ScrollAreaContext;
 //#endregion
 export { ScrollAreaContext, useScrollArea };

package/dist/components/scroll-area/use-scroll-area.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-scroll-area.d.ts","names":[],"sources":["../../../src/components/scroll-area/use-scroll-area.ts"],"mappings":";;;;UAUiB;;EAEf,UAAU;EACV,KAAK,YAAY;;EAEjB,aAAa,IAAI;;EAEjB,YAAY,IAAI;;EAEhB,eAAe,OAAO,aAAa,IAAI;EACvC,WAAW,OAAO,aAAa,IAAI;;;iBAIrB,cAAc,QAAQ,iBAAiB,mBAAmB"}
+{"version":3,"file":"use-scroll-area.d.ts","names":[],"sources":["../../../src/components/scroll-area/use-scroll-area.ts"],"mappings":";;;;UAiBiB;;EAEf,UAAU;EACV,KAAK,YAAY;;EAEjB,aAAa,IAAI;;EAEjB,YAAY,IAAI;;EAEhB,eAAe,OAAO,aAAa,IAAI;EACvC,WAAW,OAAO,aAAa,IAAI;;;iBAIrB,cAAc,QAAQ,iBAAiB,mBAAmB"}

package/dist/components/scroll-area/use-scroll-area.js

@@ -2,10 +2,10 @@ import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
 import { computed, ref, toValue } from "vue";
+import { createScope } from "@xihan-ui/core";
 import { connectScrollArea, scrollAreaScrollbarProps, scrollbarMachine } from "@xihan-ui/headless";
-import { createScope } from "@xihan-ui/kernel";
 //#region src/components/scroll-area/use-scroll-area.ts
-/** 滚动区没有自己的机器：按轴各建一台 scrollbar，视口就是它们共同的滚动容器。 */
+/** 滚动区没有自己的状态机：按轴各建一台 scrollbar，视口就是它们共同的滚动容器。 */
 function useScrollArea(source) {
 	const viewportRef = ref(null);
 	const contentRef = ref(null);

package/dist/components/scroll-area/use-scroll-area.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-scroll-area.js","names":[],"sources":["../../../src/components/scroll-area/use-scroll-area.ts"],"sourcesContent":["import type { ScrollAreaApi, ScrollAreaProps, ScrollAreaServices } from '@xihan-ui/headless'\nimport type { Orientation } from '@xihan-ui/kernel'\nimport type { ComputedRef, MaybeRefOrGetter, Ref } from 'vue'\nimport { connectScrollArea, scrollAreaScrollbarProps, scrollbarMachine } from '@xihan-ui/headless'\nimport { createScope } from '@xihan-ui/kernel'\nimport { computed, ref, toValue } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface ScrollAreaContext {\n  /** 两条轴各一台 scrollbar 机器。 */\n  services: ScrollAreaServices\n  api: ComputedRef<ScrollAreaApi>\n  /** overflow:auto 的那层，两台机器都挂在它身上。 */\n  viewportRef: Ref<HTMLElement | null>\n  /** 内容包裹层。 */\n  contentRef: Ref<HTMLElement | null>\n  /** 两条轴各自的挂载点（即那条 scrollbar 的根）与轨道，按轴现量。 */\n  scrollbarRefs: Record<Orientation, Ref<HTMLElement | null>>\n  trackRefs: Record<Orientation, Ref<HTMLElement | null>>\n}\n\n/** 滚动区没有自己的机器：按轴各建一台 scrollbar，视口就是它们共同的滚动容器。 */\nexport function useScrollArea(source: MaybeRefOrGetter<ScrollAreaProps>): ScrollAreaContext {\n  const viewportRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n  const scrollbarRefs: Record<Orientation, Ref<HTMLElement | null>> = {\n    vertical: ref<HTMLElement | null>(null),\n    horizontal: ref<HTMLElement | null>(null),\n  }\n  const trackRefs: Record<Orientation, Ref<HTMLElement | null>> = {\n    vertical: ref<HTMLElement | null>(null),\n    horizontal: ref<HTMLElement | null>(null),\n  }\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const bar = (axis: Orientation): ScrollAreaServices[Orientation] => {\n    // 每次取值现读 props：挂载后改 type / orientation 机器要跟着变\n    const service = useMachine(scrollbarMachine, () => scrollAreaScrollbarProps(toValue(source), axis), scope)\n    // 传 getter 而非节点，ref 在挂载后才有值；量尺寸与挂监听都在机器的效应里进行\n    service.refs.set('getScrollableEl', () => viewportRef.value)\n    service.refs.set('getTrackEl', () => trackRefs[axis].value)\n    service.refs.set('getRootEl', () => scrollbarRefs[axis].value)\n    return service\n  }\n  const services: ScrollAreaServices = { vertical: bar('vertical'), horizontal: bar('horizontal') }\n\n  const api = computed(() => connectScrollArea(services, toValue(source), vueNormalize))\n  return { services, api, viewportRef, contentRef, scrollbarRefs, trackRefs }\n}\n"],"mappings":";;;;;;;;AAwBA,SAAgB,cAAc,QAA8D;CAC1F,MAAM,cAAc,IAAwB,IAAI;CAChD,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAA8D;EAClE,UAAU,IAAwB,IAAI;EACtC,YAAY,IAAwB,IAAI;CAC1C;CACA,MAAM,YAA0D;EAC9D,UAAU,IAAwB,IAAI;EACtC,YAAY,IAAwB,IAAI;CAC1C;CAGA,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CACrC,MAAM,OAAO,SAAuD;EAElE,MAAM,UAAU,WAAW,wBAAwB,yBAAyB,QAAQ,MAAM,GAAG,IAAI,GAAG,KAAK;EAEzG,QAAQ,KAAK,IAAI,yBAAyB,YAAY,KAAK;EAC3D,QAAQ,KAAK,IAAI,oBAAoB,UAAU,KAAK,CAAC,KAAK;EAC1D,QAAQ,KAAK,IAAI,mBAAmB,cAAc,KAAK,CAAC,KAAK;EAC7D,OAAO;CACT;CACA,MAAM,WAA+B;EAAE,UAAU,IAAI,UAAU;EAAG,YAAY,IAAI,YAAY;CAAE;CAGhG,OAAO;EAAE;EAAU,KADP,eAAe,kBAAkB,UAAU,QAAQ,MAAM,GAAG,YAAY,CAC/D;EAAG;EAAa;EAAY;EAAe;CAAU;AAC5E"}
+{"version":3,"file":"use-scroll-area.js","names":[],"sources":["../../../src/components/scroll-area/use-scroll-area.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use scroll area 相关实现。\n\nimport type { Orientation } from '@xihan-ui/core'\nimport type { ScrollAreaApi, ScrollAreaProps, ScrollAreaServices } from '@xihan-ui/headless'\nimport type { ComputedRef, MaybeRefOrGetter, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectScrollArea, scrollAreaScrollbarProps, scrollbarMachine } from '@xihan-ui/headless'\nimport { computed, ref, toValue } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface ScrollAreaContext {\n  /** 两条轴各一台 scrollbar 状态机。 */\n  services: ScrollAreaServices\n  api: ComputedRef<ScrollAreaApi>\n  /** overflow:auto 的层，两台状态机都挂在它上面。 */\n  viewportRef: Ref<HTMLElement | null>\n  /** 内容包裹层。 */\n  contentRef: Ref<HTMLElement | null>\n  /** 两条轴各自的挂载点（即该 scrollbar 的根）与轨道，按轴现测。 */\n  scrollbarRefs: Record<Orientation, Ref<HTMLElement | null>>\n  trackRefs: Record<Orientation, Ref<HTMLElement | null>>\n}\n\n/** 滚动区没有自己的状态机：按轴各建一台 scrollbar，视口就是它们共同的滚动容器。 */\nexport function useScrollArea(source: MaybeRefOrGetter<ScrollAreaProps>): ScrollAreaContext {\n  const viewportRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n  const scrollbarRefs: Record<Orientation, Ref<HTMLElement | null>> = {\n    vertical: ref<HTMLElement | null>(null),\n    horizontal: ref<HTMLElement | null>(null),\n  }\n  const trackRefs: Record<Orientation, Ref<HTMLElement | null>> = {\n    vertical: ref<HTMLElement | null>(null),\n    horizontal: ref<HTMLElement | null>(null),\n  }\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const bar = (axis: Orientation): ScrollAreaServices[Orientation] => {\n    // 每次取值现读 props：挂载后改 type / orientation 机器要跟着变\n    const service = useMachine(scrollbarMachine, () => scrollAreaScrollbarProps(toValue(source), axis), scope)\n    // 传 getter 而非节点，ref 在挂载后才有值；量尺寸与挂监听都在机器的效应里进行\n    service.refs.set('getScrollableEl', () => viewportRef.value)\n    service.refs.set('getTrackEl', () => trackRefs[axis].value)\n    service.refs.set('getRootEl', () => scrollbarRefs[axis].value)\n    return service\n  }\n  const services: ScrollAreaServices = { vertical: bar('vertical'), horizontal: bar('horizontal') }\n\n  const api = computed(() => connectScrollArea(services, toValue(source), vueNormalize))\n  return { services, api, viewportRef, contentRef, scrollbarRefs, trackRefs }\n}\n"],"mappings":";;;;;;;;AA+BA,SAAgB,cAAc,QAA8D;CAC1F,MAAM,cAAc,IAAwB,IAAI;CAChD,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAA8D;EAClE,UAAU,IAAwB,IAAI;EACtC,YAAY,IAAwB,IAAI;CAC1C;CACA,MAAM,YAA0D;EAC9D,UAAU,IAAwB,IAAI;EACtC,YAAY,IAAwB,IAAI;CAC1C;CAGA,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CACrC,MAAM,OAAO,SAAuD;EAElE,MAAM,UAAU,WAAW,wBAAwB,yBAAyB,QAAQ,MAAM,GAAG,IAAI,GAAG,KAAK;EAEzG,QAAQ,KAAK,IAAI,yBAAyB,YAAY,KAAK;EAC3D,QAAQ,KAAK,IAAI,oBAAoB,UAAU,KAAK,CAAC,KAAK;EAC1D,QAAQ,KAAK,IAAI,mBAAmB,cAAc,KAAK,CAAC,KAAK;EAC7D,OAAO;CACT;CACA,MAAM,WAA+B;EAAE,UAAU,IAAI,UAAU;EAAG,YAAY,IAAI,YAAY;CAAE;CAGhG,OAAO;EAAE;EAAU,KADP,eAAe,kBAAkB,UAAU,QAAQ,MAAM,GAAG,YAAY,CAC/D;EAAG;EAAa;EAAY;EAAe;CAAU;AAC5E"}

package/dist/components/scrollbar/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/scrollbar/context.ts"],"mappings":";;iBAMgB,iBAAiB,KAAK;iBAItB,uBAAuB"}
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/scrollbar/context.ts"],"mappings":";;iBAagB,iBAAiB,KAAK;iBAItB,uBAAuB"}

package/dist/components/scrollbar/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/scrollbar/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { ScrollbarContext } from './use-scrollbar'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<ScrollbarContext> = Symbol.for('xh-scrollbar')\n\nexport function provideScrollbar(ctx: ScrollbarContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useScrollbarContext(): ScrollbarContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Scrollbar 部件必须用在 XhScrollbarRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAsC,OAAO,IAAI,cAAc;AAErE,SAAgB,iBAAiB,KAA6B;CAC5D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,sBAAwC;CACtD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,yCAAyC;CAC3D,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/scrollbar/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { InjectionKey } from 'vue'\nimport type { ScrollbarContext } from './use-scrollbar'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<ScrollbarContext> = Symbol.for('xh-scrollbar')\n\nexport function provideScrollbar(ctx: ScrollbarContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useScrollbarContext(): ScrollbarContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Scrollbar 部件必须用在 XhScrollbarRoot 内')\n  return ctx\n}\n"],"mappings":";;AAWA,MAAM,MAAsC,OAAO,IAAI,cAAc;AAErE,SAAgB,iBAAiB,KAA6B;CAC5D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,sBAAwC;CACtD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,yCAAyC;CAC3D,OAAO;AACT"}

package/dist/components/scrollbar/scrollbar.d.ts

@@ -1,66 +1,60 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { ScrollbarTarget } from "./use-scrollbar.js";
 import { PropType, SlotsType, VNode } from "vue";
-import { ScrollbarApi, ScrollbarSchema, ScrollbarType } from "@xihan-ui/headless";
-import { Direction, Orientation, Size } from "@xihan-ui/kernel";
+import { Direction, Orientation, Size } from "@xihan-ui/core";
+import { ScrollbarAnchor, ScrollbarApi, ScrollbarSchema, ScrollbarType } from "@xihan-ui/headless";
 //#region src/components/scrollbar/scrollbar.d.ts
 type ScrollbarProps = ScrollbarSchema['props'];
-/** 默认插槽的载荷：这一条此刻的显隐、几何与位置，以及两个命令式动作。 */
+/** 默认插槽的载荷：该滚动条当前的显隐、几何与位置，以及两个命令式动作。 */
 type ScrollbarRootSlotProps = Pick<ScrollbarApi, 'visible' | 'native' | 'overflow' | 'dragging' | 'scrolling' | 'thumbSize' | 'thumbOffset' | 'scroll' | 'max' | 'scrollTo' | 'scrollBy'>;
 declare const XhScrollbarRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   /**
-   * 真正在滚的那个元素，或者取它的函数。它不必是本组件的后代——
-   * 表格的滚动盒、虚拟滚动的视口、随手一个 overflow:auto 的 div 都行。
+   * 真正在滚动的元素，或者取它的函数。它不必是本组件的后代：
+   * 表格的滚动盒、虚拟滚动的视口、任意 overflow:auto 的 div 均可。
    */
   scrollable: {
     type: PropType<ScrollbarTarget>;
-    default: undefined;
   };
   /**
-   * 滚动容器的 id。没给 scrollable 时按它去查节点；focusable 时它同时落到滑块的 aria-controls 上。
+   * 滚动容器的 id。未提供 scrollable 时按它查询节点；focusable 时它同时写到滑块的 aria-controls 上。
    */
   controls: {
     type: StringConstructor;
-    default: undefined;
   };
   orientation: {
     type: PropType<Orientation>;
-    default: undefined;
   };
   type: {
     type: PropType<ScrollbarType>;
-    default: undefined;
   };
   hideDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
   minThumbSize: {
     type: NumberConstructor;
-    default: undefined;
   };
   step: {
     type: NumberConstructor;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
+  };
+  /** 根节点贴在壳边（shell，默认）还是贴在滚动层自己的盒子上（layer）；layer 要求壳是滚动层的定位祖先。 */
+  anchor: {
+    type: PropType<ScrollbarAnchor>;
   };
   disabled: BooleanConstructor;
-  /** 滑块进 Tab 序并报 role=scrollbar；缺省不进，滚动仍归滚动容器自己。 */
+  /** 滑块进入 Tab 序列并报告 role=scrollbar；默认不进入，滚动仍归滚动容器自身。 */
   focusable: BooleanConstructor;
-  /** 横竖两条同时摆着时在末端让出交叉口那一格，交叉口由 XhScrollbarCorner 补。 */
+  /** 横竖两条同时存在时在末端让出交叉口一格，交叉口由 XhScrollbarCorner 补齐。 */
   gutter: BooleanConstructor;
-  /** 触屏（粗指针）上也显形；缺省交给原生滚动，整条不画。 */
+  /** 触屏（粗指针）上也显示；默认交给原生滚动，整条不绘制。 */
   forceVisible: BooleanConstructor;
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   translations: {
     type: PropType<ScrollbarProps["translations"]>;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -71,58 +65,52 @@ declare const XhScrollbarRoot: import("vue").DefineComponent<import("vue").Extra
   'drag-end': (_details: PayloadOf<ScrollbarProps, "onDragEnd">) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   /**
-   * 真正在滚的那个元素，或者取它的函数。它不必是本组件的后代——
-   * 表格的滚动盒、虚拟滚动的视口、随手一个 overflow:auto 的 div 都行。
+   * 真正在滚动的元素，或者取它的函数。它不必是本组件的后代：
+   * 表格的滚动盒、虚拟滚动的视口、任意 overflow:auto 的 div 均可。
    */
   scrollable: {
     type: PropType<ScrollbarTarget>;
-    default: undefined;
   };
   /**
-   * 滚动容器的 id。没给 scrollable 时按它去查节点；focusable 时它同时落到滑块的 aria-controls 上。
+   * 滚动容器的 id。未提供 scrollable 时按它查询节点；focusable 时它同时写到滑块的 aria-controls 上。
    */
   controls: {
     type: StringConstructor;
-    default: undefined;
   };
   orientation: {
     type: PropType<Orientation>;
-    default: undefined;
   };
   type: {
     type: PropType<ScrollbarType>;
-    default: undefined;
   };
   hideDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
   minThumbSize: {
     type: NumberConstructor;
-    default: undefined;
   };
   step: {
     type: NumberConstructor;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
+  };
+  /** 根节点贴在壳边（shell，默认）还是贴在滚动层自己的盒子上（layer）；layer 要求壳是滚动层的定位祖先。 */
+  anchor: {
+    type: PropType<ScrollbarAnchor>;
   };
   disabled: BooleanConstructor;
-  /** 滑块进 Tab 序并报 role=scrollbar；缺省不进，滚动仍归滚动容器自己。 */
+  /** 滑块进入 Tab 序列并报告 role=scrollbar；默认不进入，滚动仍归滚动容器自身。 */
   focusable: BooleanConstructor;
-  /** 横竖两条同时摆着时在末端让出交叉口那一格，交叉口由 XhScrollbarCorner 补。 */
+  /** 横竖两条同时存在时在末端让出交叉口一格，交叉口由 XhScrollbarCorner 补齐。 */
   gutter: BooleanConstructor;
-  /** 触屏（粗指针）上也显形；缺省交给原生滚动，整条不画。 */
+  /** 触屏（粗指针）上也显示；默认交给原生滚动，整条不绘制。 */
   forceVisible: BooleanConstructor;
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   translations: {
     type: PropType<ScrollbarProps["translations"]>;
-    default: undefined;
   };
 }>> & Readonly<{
   "onScroll-start"?: ((_details: import("@xihan-ui/headless").ScrollbarScrollDetails) => any) | undefined;
@@ -130,20 +118,10 @@ declare const XhScrollbarRoot: import("vue").DefineComponent<import("vue").Extra
   "onDrag-start"?: ((_details: import("@xihan-ui/headless").ScrollbarScrollDetails) => any) | undefined;
   "onDrag-end"?: ((_details: import("@xihan-ui/headless").ScrollbarScrollDetails) => any) | undefined;
 }>, {
-  type: ScrollbarType;
-  orientation: Orientation;
-  dir: Direction;
-  size: Size;
   disabled: boolean;
-  translations: Partial<import("@xihan-ui/headless").ScrollbarTranslations> | undefined;
-  step: number;
   forceVisible: boolean;
-  hideDelay: number;
   focusable: boolean;
   gutter: boolean;
-  scrollable: ScrollbarTarget;
-  controls: string;
-  minThumbSize: number;
 }, SlotsType<{
   default?: (props: ScrollbarRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -153,7 +131,7 @@ declare const XhScrollbarTrack: import("vue").DefineComponent<{}, () => VNode<im
 declare const XhScrollbarThumb: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-/** 交叉口补丁：写在其中一条的根里，贴在它末端之外那一格，跟着这一条显隐。 */
+/** 交叉口补丁：写在其中一条的根中，贴在它末端之外的一格，跟随该条显隐。 */
 declare const XhScrollbarCorner: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/components/scrollbar/scrollbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scrollbar.d.ts","names":[],"sources":["../../../src/components/scrollbar/scrollbar.ts"],"mappings":";;;;;;KAUK,iBAAiB;;KAGV,yBAAyB,KACnC;cAIW,+BAAe,8BAAA;;;;;;IAQkB,MAAA,SAAS;;;;;;;;;;;IAKpB,MAAA,SAAS;;;;IAChB,MAAA,SAAS;;;;;;;;;;;;;;;;IAIT,MAAA,SAAS;;;;;;;;;;;IAQV,MAAA,SAAS;;;;IACA,MAAA,SAAS;;;;;;EAId,iBAAA,UAAA,UAAU;EACZ,eAAA,UAAA,UAAU;EACV,eAAA,UAAA,UAAU;EACZ,aAAA,UAAA,UAAU;;;;;;;IA1BS,MAAA,SAAS;;;;;;;;;;;IAKpB,MAAA,SAAS;;;;IAChB,MAAA,SAAS;;;;;;;;;;;;;;;;IAIT,MAAA,SAAS;;;;;;;;;;;IAQV,MAAA,SAAS;;;;IACA,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;EAU/B,WAAC,OAAO,2BAA2B;kCA4B/C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAU3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"scrollbar.d.ts","names":[],"sources":["../../../src/components/scrollbar/scrollbar.ts"],"mappings":";;;;;;KAiBK,iBAAiB;;KAGV,yBAAyB,KACnC;cAIW,+BAAe,8BAAA;;;;;;IAQkB,MAAA,SAAS;;;;;;;;;IAKpB,MAAA,SAAS;;;IAChB,MAAA,SAAS;;;;;;;;;;;;IAIT,MAAA,SAAS;;;;IAEP,MAAA,SAAS;;;;;;;;;;IAQZ,MAAA,SAAS;;;IACA,MAAA,SAAS;;;;;EAId,iBAAA,UAAA,UAAU;EACZ,eAAA,UAAA,UAAU;EACV,eAAA,UAAA,UAAU;EACZ,aAAA,UAAA,UAAU;;;;;;;IA5BS,MAAA,SAAS;;;;;;;;;IAKpB,MAAA,SAAS;;;IAChB,MAAA,SAAS;;;;;;;;;;;;IAIT,MAAA,SAAS;;;;IAEP,MAAA,SAAS;;;;;;;;;;IAQZ,MAAA,SAAS;;;IACA,MAAA,SAAS;;;;;;;;;;;;;EAU/B,WAAC,OAAO,2BAA2B;kCA4B/C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAU3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}