@xihan-ui/vue 1.0.0-alpha.2 → 1.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"use-popselect.js","names":[],"sources":["../../../src/components/popselect/use-popselect.ts"],"sourcesContent":["import type {\n  ListboxSchema,\n  PopoverSchema,\n  PopselectApi,\n  PopselectNode,\n} from '@xihan-ui/headless'\nimport type { Cleanup, ControlVariant, Direction, Layer, Placement, RuntimeConfig, Size, Tone } from '@xihan-ui/kernel'\nimport type { Service } from '@xihan-ui/machine'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectPopselect, listboxMachine, popoverMachine, popselectInitialFocus } from '@xihan-ui/headless'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/kernel'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\n/** 根部件对外的全部输入：浮层一半归 popover 机器，列表一半归 listbox 机器，三个视觉轴直给 connect。 */\nexport interface PopselectRootProps {\n  collection?: PopselectNode[]\n  value?: string | string[]\n  defaultValue?: string | string[]\n  multiple?: boolean\n  disabled?: boolean\n  loop?: boolean\n  typeahead?: boolean\n  dir?: Direction\n  open?: boolean\n  defaultOpen?: boolean\n  placement?: Placement\n  offset?: number\n  closeOnEscape?: boolean\n  closeOnInteractOutside?: boolean\n  variant?: ControlVariant\n  tone?: Tone\n  size?: Size\n}\n\nexport interface PopselectContext {\n  /** 浮层机器，供部件读开合状态。 */\n  popover: Service<PopoverSchema>\n  /** 列表机器，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */\n  listbox: Service<ListboxSchema>\n  api: ComputedRef<PopselectApi>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n}\n\nexport interface PopselectNotifiers {\n  onValueChange?: ListboxSchema['props']['onValueChange']\n  onOpenChange?: PopoverSchema['props']['onOpenChange']\n}\n\nexport function usePopselect(props: PopselectRootProps, notify: PopselectNotifiers = {}): PopselectContext {\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  // 两台机器共用一个 scope：trigger 与 content 的 id 由它派生，aria-controls 才指得准\n  const scope = createScope(null, idGen)\n\n  const popover = useMachine(popoverMachine, () => ({\n    open: props.open,\n    defaultOpen: props.defaultOpen,\n    placement: props.placement,\n    offset: props.offset,\n    closeOnEscape: props.closeOnEscape,\n    closeOnInteractOutside: props.closeOnInteractOutside,\n    // 弹出选择不陷焦点：Tab 走得出去，走出去即由消解层判定收起\n    modal: false,\n    onOpenChange: notify.onOpenChange,\n  }), scope)\n\n  // 连打检索缓冲存在 listbox 机器的 refs 里，适配器不必注入\n  const listbox = useMachine(listboxMachine, () => ({\n    collection: props.collection,\n    value: props.value,\n    defaultValue: props.defaultValue,\n    multiple: props.multiple,\n    disabled: props.disabled,\n    loop: props.loop,\n    typeahead: props.typeahead,\n    dir: props.dir,\n    onValueChange: notify.onValueChange,\n  }), scope)\n\n  if (typeof document !== 'undefined') {\n    const config: RuntimeConfig = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由 popover 机器的 trackLayer 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // trigger 记为本层分支，点它算层内交互\n      branches: () => [triggerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      setModal: () => {},\n      // 列表不带遮罩，没有「点它就该关本层」的表面\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动\n    popover.refs.set('config', config)\n    popover.refs.set('registerLayer', registerLayer)\n    popover.refs.set('position', createPositionEngine())\n    popover.refs.set('getAnchorEl', () => triggerRef.value)\n    popover.refs.set('getFloatingEl', () => positionerRef.value)\n    popover.refs.set('getContentEl', () => contentRef.value)\n    // 落焦点由 popselect 这一侧收口：有锚点条目就落它，没有就落列表容器\n    popover.refs.set('getInitialFocusEl', () => popselectInitialFocus(listbox, contentRef.value))\n  }\n\n  const api = computed(() => connectPopselect({\n    popover,\n    listbox,\n    props: { variant: props.variant, tone: props.tone, size: props.size },\n  }, vueNormalize))\n\n  return { popover, listbox, api, triggerRef, positionerRef, contentRef }\n}\n"],"mappings":";;;;;;;;AAsDA,SAAgB,aAAa,OAA2B,SAA6B,CAAC,GAAqB;CACzG,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CAEnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CAErC,MAAM,UAAU,WAAW,uBAAuB;EAChD,MAAM,MAAM;EACZ,aAAa,MAAM;EACnB,WAAW,MAAM;EACjB,QAAQ,MAAM;EACd,eAAe,MAAM;EACrB,wBAAwB,MAAM;EAE9B,OAAO;EACP,cAAc,OAAO;CACvB,IAAI,KAAK;CAGT,MAAM,UAAU,WAAW,uBAAuB;EAChD,YAAY,MAAM;EAClB,OAAO,MAAM;EACb,cAAc,MAAM;EACpB,UAAU,MAAM;EAChB,UAAU,MAAM;EAChB,MAAM,MAAM;EACZ,WAAW,MAAM;EACjB,KAAK,MAAM;EACX,eAAe,OAAO;CACxB,IAAI,KAAK;CAET,IAAI,OAAO,aAAa,aAAa;EACnC,MAAM,SAAwB,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG/E,MAAM,sBAA0D,OAAO,cAAc,SAAS;GAC5F,MAAM;GACN,YAAY,WAAW;GAEvB,gBAAgB,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,OAAO;GACjD,eAAe;GACf,gBAAgB,CAAC;GAEjB,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAM;EACjC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EACnD,QAAQ,KAAK,IAAI,qBAAqB,WAAW,KAAK;EACtD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EAEvD,QAAQ,KAAK,IAAI,2BAA2B,sBAAsB,SAAS,WAAW,KAAK,CAAC;CAC9F;CAQA,OAAO;EAAE;EAAS;EAAS,KANf,eAAe,iBAAiB;GAC1C;GACA;GACA,OAAO;IAAE,SAAS,MAAM;IAAS,MAAM,MAAM;IAAM,MAAM,MAAM;GAAK;EACtE,GAAG,YAAY,CAEc;EAAG;EAAY;EAAe;CAAW;AACxE"}
+{"version":3,"file":"use-popselect.js","names":[],"sources":["../../../src/components/popselect/use-popselect.ts"],"sourcesContent":["import type {\n  ListboxSchema,\n  PopoverSchema,\n  PopselectApi,\n  PopselectNode,\n  PopselectTranslations,\n} from '@xihan-ui/headless'\nimport type { Cleanup, ControlVariant, Direction, Layer, Placement, RuntimeConfig, Size, Tone } from '@xihan-ui/kernel'\nimport type { Service } from '@xihan-ui/machine'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectPopselect, listboxMachine, popoverMachine, popselectInitialFocus } from '@xihan-ui/headless'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/kernel'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\n/** 根部件对外的全部输入：浮层一半归 popover 机器，列表一半归 listbox 机器，三个视觉轴直给 connect。 */\nexport interface PopselectRootProps {\n  collection?: PopselectNode[]\n  value?: string | string[]\n  defaultValue?: string | string[]\n  multiple?: boolean\n  disabled?: boolean\n  loop?: boolean\n  typeahead?: boolean\n  dir?: Direction\n  open?: boolean\n  defaultOpen?: boolean\n  placement?: Placement\n  offset?: number\n  closeOnEscape?: boolean\n  closeOnInteractOutside?: boolean\n  variant?: ControlVariant\n  tone?: Tone\n  size?: Size\n  translations?: Partial<PopselectTranslations>\n}\n\nexport interface PopselectContext {\n  /** 浮层机器，供部件读开合状态。 */\n  popover: Service<PopoverSchema>\n  /** 列表机器，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */\n  listbox: Service<ListboxSchema>\n  api: ComputedRef<PopselectApi>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 此刻该不该渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层搬到哪儿：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport interface PopselectNotifiers {\n  onValueChange?: ListboxSchema['props']['onValueChange']\n  onOpenChange?: PopoverSchema['props']['onOpenChange']\n}\n\nexport function usePopselect(props: PopselectRootProps, notify: PopselectNotifiers = {}): PopselectContext {\n  const xhConfig = useXhConfig()\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  // 两台机器共用一个 scope：trigger 与 content 的 id 由它派生，aria-controls 才指得准\n  const scope = createScope(null, idGen)\n\n  const popover = useMachine(popoverMachine, () => ({\n    open: props.open,\n    defaultOpen: props.defaultOpen,\n    placement: props.placement,\n    offset: props.offset,\n    closeOnEscape: props.closeOnEscape,\n    closeOnInteractOutside: props.closeOnInteractOutside,\n    // 弹出选择不陷焦点：Tab 走得出去，走出去即由消解层判定收起\n    modal: false,\n    onOpenChange: notify.onOpenChange,\n  }), scope)\n\n  // 连打检索缓冲存在 listbox 机器的 refs 里，适配器不必注入\n  const listbox = useMachine(listboxMachine, () => ({\n    collection: props.collection,\n    value: props.value,\n    defaultValue: props.defaultValue,\n    multiple: props.multiple,\n    disabled: props.disabled,\n    loop: props.loop,\n    typeahead: props.typeahead,\n    dir: props.dir,\n    onValueChange: notify.onValueChange,\n  }), scope)\n\n  // 服务端没有 DOM、也就没有退场：config 传 null 时闸门退化成「跟着展开态」\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由 popover 机器的 trackLayer 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // trigger 记为本层分支，点它算层内交互；\n      // 浮层壳一并记上：候选列表之外还浮着自绘滚动条，按住它拖动不该把列表消解掉\n      branches: () => [triggerRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      setModal: () => {},\n      // 列表不带遮罩，没有「点它就该关本层」的表面\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动\n    popover.refs.set('config', config!)\n    popover.refs.set('registerLayer', registerLayer)\n    popover.refs.set('position', createPositionEngine())\n    popover.refs.set('getAnchorEl', () => triggerRef.value)\n    popover.refs.set('getFloatingEl', () => positionerRef.value)\n    popover.refs.set('getContentEl', () => contentRef.value)\n    // 落焦点由 popselect 这一侧收口：有锚点条目就落它，没有就落列表容器\n    popover.refs.set('getInitialFocusEl', () => popselectInitialFocus(listbox, contentRef.value))\n  }\n\n  const api = computed(() => connectPopselect({\n    popover,\n    listbox,\n    props: { variant: props.variant, tone: props.tone, size: props.size, translations: props.translations },\n  }, vueNormalize))\n\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({ config, isOpen: () => api.value.open, contentRef })\n  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, popover, listbox, api, triggerRef, positionerRef, contentRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AA8DA,SAAgB,aAAa,OAA2B,SAA6B,CAAC,GAAqB;CACzG,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CAEnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CAErC,MAAM,UAAU,WAAW,uBAAuB;EAChD,MAAM,MAAM;EACZ,aAAa,MAAM;EACnB,WAAW,MAAM;EACjB,QAAQ,MAAM;EACd,eAAe,MAAM;EACrB,wBAAwB,MAAM;EAE9B,OAAO;EACP,cAAc,OAAO;CACvB,IAAI,KAAK;CAGT,MAAM,UAAU,WAAW,uBAAuB;EAChD,YAAY,MAAM;EAClB,OAAO,MAAM;EACb,cAAc,MAAM;EACpB,UAAU,MAAM;EAChB,UAAU,MAAM;EAChB,MAAM,MAAM;EACZ,WAAW,MAAM;EACjB,KAAK,MAAM;EACX,eAAe,OAAO;CACxB,IAAI,KAAK;CAGT,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAGvB,gBAAgB,CAAC,WAAW,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACtE,eAAe;GACf,gBAAgB,CAAC;GAEjB,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EACnD,QAAQ,KAAK,IAAI,qBAAqB,WAAW,KAAK;EACtD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EAEvD,QAAQ,KAAK,IAAI,2BAA2B,sBAAsB,SAAS,WAAW,KAAK,CAAC;CAC9F;CAEA,MAAM,MAAM,eAAe,iBAAiB;EAC1C;EACA;EACA,OAAO;GAAE,SAAS,MAAM;GAAS,MAAM,MAAM;GAAM,MAAM,MAAM;GAAM,cAAc,MAAM;EAAa;CACxG,GAAG,YAAY,CAAC;CAOhB,OAAO;EAAE,SAJO,eAAe;GAAE;GAAQ,cAAc,IAAI,MAAM;GAAM;EAAW,CAInE;EAAG;EAAS;EAAS;EAAK;EAAY;EAAe;EAAY,cAF3D,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAE9B;CAAE;AAC/F"}

package/dist/components/progress/progress.d.ts

@@ -7,6 +7,7 @@ declare const XhProgress: import("vue").DefineComponent<import("vue").ExtractPro
     type: NumberConstructor;
     default: number;
   };
+  indeterminate: BooleanConstructor;
   max: {
     type: NumberConstructor;
     default: number;
@@ -40,6 +41,7 @@ declare const XhProgress: import("vue").DefineComponent<import("vue").ExtractPro
     type: NumberConstructor;
     default: number;
   };
+  indeterminate: BooleanConstructor;
   max: {
     type: NumberConstructor;
     default: number;
@@ -68,12 +70,13 @@ declare const XhProgress: import("vue").DefineComponent<import("vue").ExtractPro
   size: PropType<Size>;
 }>> & Readonly<{}>, {
   value: number;
-  max: number;
   variant: ProgressVariant;
+  max: number;
+  indeterminate: boolean;
+  valueText: string;
   strokeWidth: number;
   gapDegree: number;
   gapPosition: ProgressGapPosition;
-  valueText: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
 export { XhProgress };

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

@@ -1 +1 @@
-{"version":3,"file":"progress.d.ts","names":[],"sources":["../../../src/components/progress/progress.ts"],"mappings":";;;;cAQa,0BAAU,8BAAA;;;;;;;;;;IAMQ,MAAA,SAAS;;;;;;;;;;;;IAGL,MAAA,SAAS;;;;;;;EAExB,MAAA,SAAS;EACT,MAAA,SAAS;;;;;;;;;;;;;IANE,MAAA,SAAS;;;;;;;;;;;;IAGL,MAAA,SAAS;;;;;;;EAExB,MAAA,SAAS;EACT,MAAA,SAAS;;;;;;;;;qCA0B3B"}
+{"version":3,"file":"progress.d.ts","names":[],"sources":["../../../src/components/progress/progress.ts"],"mappings":";;;;cASa,0BAAU,8BAAA;;;;;;;;;;;IAOQ,MAAA,SAAS;;;;;;;;;;;;IAGL,MAAA,SAAS;;;;;;;EAExB,MAAA,SAAS;EACT,MAAA,SAAS;;;;;;;;;;;;;;IANE,MAAA,SAAS;;;;;;;;;;;;IAGL,MAAA,SAAS;;;;;;;EAExB,MAAA,SAAS;EACT,MAAA,SAAS;;;;;;;;;;qCA4B3B"}

package/dist/components/progress/progress.js

@@ -1,4 +1,5 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
+import { withXhConfig } from "../../config/config.js";
 import { slotPaints } from "../../runtime/slot-content.js";
 import { defineComponent, h } from "vue";
 import { connectProgress } from "@xihan-ui/headless";
@@ -10,6 +11,7 @@ const XhProgress = defineComponent({
 			type: Number,
 			default: 0
 		},
+		indeterminate: Boolean,
 		max: {
 			type: Number,
 			default: 100
@@ -38,8 +40,9 @@ const XhProgress = defineComponent({
 		size: String
 	},
 	setup(props, { slots }) {
+		const configured = withXhConfig("progress", props);
 		return () => {
-			const a = connectProgress(props, vueNormalize);
+			const a = connectProgress(configured, vueNormalize);
 			const rootProps = a.getRootProps();
 			if (a.variant === "line") return h("div", rootProps, [h("div", a.getTrackProps(), [h("div", a.getRangeProps())])]);
 			const label = slots.default?.();

package/dist/components/progress/progress.js.map

@@ -1 +1 @@
-{"version":3,"file":"progress.js","names":[],"sources":["../../../src/components/progress/progress.ts"],"sourcesContent":["import type { ProgressGapPosition, ProgressProps, ProgressVariant } from '@xihan-ui/headless'\nimport type { Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType } from 'vue'\nimport { connectProgress } from '@xihan-ui/headless'\nimport { defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { slotPaints } from '../../runtime/slot-content'\n\nexport const XhProgress = defineComponent({\n  name: 'XhProgress',\n  props: {\n    value: { type: Number, default: 0 },\n    max: { type: Number, default: 100 },\n    // 缺省值都在 connect 里收口，这边一律不预设\n    variant: { type: String as PropType<ProgressVariant>, default: undefined },\n    strokeWidth: { type: Number, default: undefined },\n    gapDegree: { type: Number, default: undefined },\n    gapPosition: { type: String as PropType<ProgressGapPosition>, default: undefined },\n    valueText: { type: String, default: undefined },\n    tone: String as PropType<Tone>,\n    size: String as PropType<Size>,\n  },\n  setup(props, { slots }) {\n    return () => {\n      const a = connectProgress(props as ProgressProps, vueNormalize)\n      const rootProps = a.getRootProps() as Record<string, unknown>\n      if (a.variant === 'line') {\n        return h('div', rootProps, [\n          h('div', a.getTrackProps() as Record<string, unknown>, [\n            h('div', a.getRangeProps() as Record<string, unknown>),\n          ]),\n        ])\n      }\n      // 环心的内容归作者：没写就不渲染那一层，免得一个空盒子压在环上挡住指针\n      const label = slots.default?.()\n      const children: unknown[] = [\n        h('svg', a.getCanvasProps() as Record<string, unknown>, [\n          h('circle', a.getTrackProps() as Record<string, unknown>),\n          h('circle', a.getRangeProps() as Record<string, unknown>),\n        ]),\n      ]\n      if (slotPaints(label))\n        children.push(h('div', a.getLabelProps() as Record<string, unknown>, label))\n      return h('div', rootProps, children as never)\n    }\n  },\n})\n"],"mappings":";;;;;AAQA,MAAa,aAAa,gBAAgB;CACxC,MAAM;CACN,OAAO;EACL,OAAO;GAAE,MAAM;GAAQ,SAAS;EAAE;EAClC,KAAK;GAAE,MAAM;GAAQ,SAAS;EAAI;EAElC,SAAS;GAAE,MAAM;GAAqC,SAAS,KAAA;EAAU;EACzE,aAAa;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAChD,WAAW;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC9C,aAAa;GAAE,MAAM;GAAyC,SAAS,KAAA;EAAU;EACjF,WAAW;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC9C,MAAM;EACN,MAAM;CACR;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,aAAa;GACX,MAAM,IAAI,gBAAgB,OAAwB,YAAY;GAC9D,MAAM,YAAY,EAAE,aAAa;GACjC,IAAI,EAAE,YAAY,QAChB,OAAO,EAAE,OAAO,WAAW,CACzB,EAAE,OAAO,EAAE,cAAc,GAA8B,CACrD,EAAE,OAAO,EAAE,cAAc,CAA4B,CACvD,CAAC,CACH,CAAC;GAGH,MAAM,QAAQ,MAAM,UAAU;GAC9B,MAAM,WAAsB,CAC1B,EAAE,OAAO,EAAE,eAAe,GAA8B,CACtD,EAAE,UAAU,EAAE,cAAc,CAA4B,GACxD,EAAE,UAAU,EAAE,cAAc,CAA4B,CAC1D,CAAC,CACH;GACA,IAAI,WAAW,KAAK,GAClB,SAAS,KAAK,EAAE,OAAO,EAAE,cAAc,GAA8B,KAAK,CAAC;GAC7E,OAAO,EAAE,OAAO,WAAW,QAAiB;EAC9C;CACF;AACF,CAAC"}
+{"version":3,"file":"progress.js","names":[],"sources":["../../../src/components/progress/progress.ts"],"sourcesContent":["import type { ProgressGapPosition, ProgressProps, ProgressVariant } from '@xihan-ui/headless'\nimport type { Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType } from 'vue'\nimport { connectProgress } from '@xihan-ui/headless'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { slotPaints } from '../../runtime/slot-content'\n\nexport const XhProgress = defineComponent({\n  name: 'XhProgress',\n  props: {\n    value: { type: Number, default: 0 },\n    indeterminate: Boolean,\n    max: { type: Number, default: 100 },\n    // 缺省值都在 connect 里收口，这边一律不预设\n    variant: { type: String as PropType<ProgressVariant>, default: undefined },\n    strokeWidth: { type: Number, default: undefined },\n    gapDegree: { type: Number, default: undefined },\n    gapPosition: { type: String as PropType<ProgressGapPosition>, default: undefined },\n    valueText: { type: String, default: undefined },\n    tone: String as PropType<Tone>,\n    size: String as PropType<Size>,\n  },\n  setup(props, { slots }) {\n    // withXhConfig 只能在 setup 期调，连接层在渲染期读这份代理\n    const configured = withXhConfig('progress', props)\n    return () => {\n      const a = connectProgress(configured as ProgressProps, vueNormalize)\n      const rootProps = a.getRootProps() as Record<string, unknown>\n      if (a.variant === 'line') {\n        return h('div', rootProps, [\n          h('div', a.getTrackProps() as Record<string, unknown>, [\n            h('div', a.getRangeProps() as Record<string, unknown>),\n          ]),\n        ])\n      }\n      // 环心的内容归作者：没写就不渲染那一层，免得一个空盒子压在环上挡住指针\n      const label = slots.default?.()\n      const children: unknown[] = [\n        h('svg', a.getCanvasProps() as Record<string, unknown>, [\n          h('circle', a.getTrackProps() as Record<string, unknown>),\n          h('circle', a.getRangeProps() as Record<string, unknown>),\n        ]),\n      ]\n      if (slotPaints(label))\n        children.push(h('div', a.getLabelProps() as Record<string, unknown>, label))\n      return h('div', rootProps, children as never)\n    }\n  },\n})\n"],"mappings":";;;;;;AASA,MAAa,aAAa,gBAAgB;CACxC,MAAM;CACN,OAAO;EACL,OAAO;GAAE,MAAM;GAAQ,SAAS;EAAE;EAClC,eAAe;EACf,KAAK;GAAE,MAAM;GAAQ,SAAS;EAAI;EAElC,SAAS;GAAE,MAAM;GAAqC,SAAS,KAAA;EAAU;EACzE,aAAa;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAChD,WAAW;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC9C,aAAa;GAAE,MAAM;GAAyC,SAAS,KAAA;EAAU;EACjF,WAAW;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC9C,MAAM;EACN,MAAM;CACR;CACA,MAAM,OAAO,EAAE,SAAS;EAEtB,MAAM,aAAa,aAAa,YAAY,KAAK;EACjD,aAAa;GACX,MAAM,IAAI,gBAAgB,YAA6B,YAAY;GACnE,MAAM,YAAY,EAAE,aAAa;GACjC,IAAI,EAAE,YAAY,QAChB,OAAO,EAAE,OAAO,WAAW,CACzB,EAAE,OAAO,EAAE,cAAc,GAA8B,CACrD,EAAE,OAAO,EAAE,cAAc,CAA4B,CACvD,CAAC,CACH,CAAC;GAGH,MAAM,QAAQ,MAAM,UAAU;GAC9B,MAAM,WAAsB,CAC1B,EAAE,OAAO,EAAE,eAAe,GAA8B,CACtD,EAAE,UAAU,EAAE,cAAc,CAA4B,GACxD,EAAE,UAAU,EAAE,cAAc,CAA4B,CAC1D,CAAC,CACH;GACA,IAAI,WAAW,KAAK,GAClB,SAAS,KAAK,EAAE,OAAO,EAAE,cAAc,GAA8B,KAAK,CAAC;GAC7E,OAAO,EAAE,OAAO,WAAW,QAAiB;EAC9C;CACF;AACF,CAAC"}

package/dist/components/qr-code/context.js

@@ -1,6 +1,6 @@
 import { inject, provide } from "vue";
 //#region src/components/qr-code/context.ts
-const KEY = Symbol("xh-qr-code");
+const KEY = Symbol.for("xh-qr-code");
 function provideQrCode(ctx) {
 	provide(KEY, ctx);
 }

package/dist/components/qr-code/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/qr-code/context.ts"],"sourcesContent":["import type { QrCodeApi } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport { inject, provide } from 'vue'\n\nexport interface QrCodeContext {\n  api: ComputedRef<QrCodeApi>\n}\n\nconst KEY: InjectionKey<QrCodeContext> = Symbol('xh-qr-code')\n\nexport function provideQrCode(ctx: QrCodeContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useQrCodeContext(): QrCodeContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] QrCode 部件必须用在 XhQrCode 内')\n  return ctx\n}\n"],"mappings":";;AAQA,MAAM,MAAmC,OAAO,YAAY;AAE5D,SAAgB,cAAc,KAA0B;CACtD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,mBAAkC;CAChD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+BAA+B;CACjD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/qr-code/context.ts"],"sourcesContent":["import type { QrCodeApi } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport { inject, provide } from 'vue'\n\nexport interface QrCodeContext {\n  api: ComputedRef<QrCodeApi>\n}\n\nconst KEY: InjectionKey<QrCodeContext> = Symbol.for('xh-qr-code')\n\nexport function provideQrCode(ctx: QrCodeContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useQrCodeContext(): QrCodeContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] QrCode 部件必须用在 XhQrCode 内')\n  return ctx\n}\n"],"mappings":";;AAQA,MAAM,MAAmC,OAAO,IAAI,YAAY;AAEhE,SAAgB,cAAc,KAA0B;CACtD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,mBAAkC;CAChD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+BAA+B;CACjD,OAAO;AACT"}

package/dist/components/radio-group/context.js

@@ -1,7 +1,7 @@
 import { inject, provide } from "vue";
 //#region src/components/radio-group/context.ts
-const KEY = Symbol("xh-radio-group");
-const ITEM_KEY = Symbol("xh-radio-group-item");
+const KEY = Symbol.for("xh-radio-group");
+const ITEM_KEY = Symbol.for("xh-radio-group-item");
 function provideRadioGroup(ctx) {
 	provide(KEY, ctx);
 }

package/dist/components/radio-group/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/radio-group/context.ts"],"sourcesContent":["import type { RadioGroupItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { RadioGroupContext } from './use-radio-group'\nimport { inject, provide } from 'vue'\n\n/** 条目自报的值与禁用，供 item-text / indicator 这类子部件复用同一份声明。 */\nexport interface RadioGroupItemContext {\n  item: ComputedRef<RadioGroupItemProps>\n}\n\nconst KEY: InjectionKey<RadioGroupContext> = Symbol('xh-radio-group')\nconst ITEM_KEY: InjectionKey<RadioGroupItemContext> = Symbol('xh-radio-group-item')\n\nexport function provideRadioGroup(ctx: RadioGroupContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useRadioGroupContext(): RadioGroupContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] RadioGroup 部件必须用在 XhRadioGroupRoot 内')\n  return ctx\n}\n\nexport function provideRadioGroupItem(ctx: RadioGroupItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useRadioGroupItemContext(): RadioGroupItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] RadioGroup 条目子部件必须用在 XhRadioGroupItem 内')\n  return ctx\n}\n"],"mappings":";;AAUA,MAAM,MAAuC,OAAO,gBAAgB;AACpE,MAAM,WAAgD,OAAO,qBAAqB;AAElF,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,sBAAsB,KAAkC;CACtE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,2BAAkD;CAChE,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,8CAA8C;CAChE,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/radio-group/context.ts"],"sourcesContent":["import type { RadioGroupItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { RadioGroupContext } from './use-radio-group'\nimport { inject, provide } from 'vue'\n\n/** 条目自报的值与禁用，供 item-text / indicator 这类子部件复用同一份声明。 */\nexport interface RadioGroupItemContext {\n  item: ComputedRef<RadioGroupItemProps>\n}\n\nconst KEY: InjectionKey<RadioGroupContext> = Symbol.for('xh-radio-group')\nconst ITEM_KEY: InjectionKey<RadioGroupItemContext> = Symbol.for('xh-radio-group-item')\n\nexport function provideRadioGroup(ctx: RadioGroupContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useRadioGroupContext(): RadioGroupContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] RadioGroup 部件必须用在 XhRadioGroupRoot 内')\n  return ctx\n}\n\nexport function provideRadioGroupItem(ctx: RadioGroupItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useRadioGroupItemContext(): RadioGroupItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] RadioGroup 条目子部件必须用在 XhRadioGroupItem 内')\n  return ctx\n}\n"],"mappings":";;AAUA,MAAM,MAAuC,OAAO,IAAI,gBAAgB;AACxE,MAAM,WAAgD,OAAO,IAAI,qBAAqB;AAEtF,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,sBAAsB,KAAkC;CACtE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,2BAAkD;CAChE,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,8CAA8C;CAChE,OAAO;AACT"}

package/dist/components/radio-group/radio-group.d.ts

@@ -23,6 +23,9 @@ declare const XhRadioGroupRoot: import("vue").DefineComponent<import("vue").Extr
     default: undefined;
   };
   disabled: BooleanConstructor;
+  readOnly: BooleanConstructor;
+  invalid: BooleanConstructor;
+  required: BooleanConstructor;
   orientation: {
     type: PropType<Orientation>;
     default: undefined;
@@ -67,6 +70,9 @@ declare const XhRadioGroupRoot: import("vue").DefineComponent<import("vue").Extr
     default: undefined;
   };
   disabled: BooleanConstructor;
+  readOnly: BooleanConstructor;
+  invalid: BooleanConstructor;
+  required: BooleanConstructor;
   orientation: {
     type: PropType<Orientation>;
     default: undefined;
@@ -91,7 +97,9 @@ declare const XhRadioGroupRoot: import("vue").DefineComponent<import("vue").Extr
   "onValue-change"?: ((_details: import("@xihan-ui/headless").RadioGroupValueChangeDetails) => any) | undefined;
   "onUpdate:value"?: ((_value: string | null) => any) | undefined;
 }>, {
+  required: boolean;
   name: string;
+  invalid: boolean;
   label: string;
   value: string | null;
   collection: RadioGroupNode[];
@@ -101,6 +109,7 @@ declare const XhRadioGroupRoot: import("vue").DefineComponent<import("vue").Extr
   tone: Tone;
   size: Size;
   disabled: boolean;
+  readOnly: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhRadioGroupLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;

package/dist/components/radio-group/radio-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"radio-group.d.ts","names":[],"sources":["../../../src/components/radio-group/radio-group.ts"],"mappings":";;;;;KAQK,kBAAkB;cAEV,gCAAgB,8BAAA;;IAGI,MAAA,SAAS;;;;;;;;;IAGb,MAAA;;;;IACO,MAAA;;;;;IAED,MAAA,SAAS;;;;IACjB,MAAA,SAAS;;;;;;;;IAER,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;EAIN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IAfN,MAAA,SAAS;;;;;;;;;IAGb,MAAA;;;;IACO,MAAA;;;;;IAED,MAAA,SAAS;;;;IACjB,MAAA,SAAS;;;;;;;;IAER,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;qCA4BnC;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAqC3B;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"radio-group.d.ts","names":[],"sources":["../../../src/components/radio-group/radio-group.ts"],"mappings":";;;;;KAQK,kBAAkB;cAEV,gCAAgB,8BAAA;;IAGI,MAAA,SAAS;;;;;;;;;IAGb,MAAA;;;;IACO,MAAA;;;;;;;;IAKD,MAAA,SAAS;;;;IACjB,MAAA,SAAS;;;;;;;;IAER,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;EAIN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IAlBN,MAAA,SAAS;;;;;;;;;IAGb,MAAA;;;;IACO,MAAA;;;;;;;;IAKD,MAAA,SAAS;;;;IACjB,MAAA,SAAS;;;;;;;;IAER,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;qCA4BnC;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAqC3B;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/radio-group/radio-group.js

@@ -23,6 +23,9 @@ const XhRadioGroupRoot = defineComponent({
 			default: void 0
 		},
 		disabled: Boolean,
+		readOnly: Boolean,
+		invalid: Boolean,
+		required: Boolean,
 		orientation: {
 			type: String,
 			default: void 0

package/dist/components/radio-group/radio-group.js.map

@@ -1 +1 @@
-{"version":3,"file":"radio-group.js","names":[],"sources":["../../../src/components/radio-group/radio-group.ts"],"sourcesContent":["import type { RadioGroupItemProps, RadioGroupNode, RadioGroupNodeMeta, RadioGroupSchema } from '@xihan-ui/headless'\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { provideRadioGroup, provideRadioGroupItem, useRadioGroupContext, useRadioGroupItemContext } from './context'\nimport { useRadioGroup } from './use-radio-group'\n\ntype RadioGroupProps = RadioGroupSchema['props']\n\nexport const XhRadioGroupRoot = defineComponent({\n  name: 'XhRadioGroupRoot',\n  props: {\n    collection: { type: Array as PropType<RadioGroupNode[]>, default: undefined },\n    /** 标题文字。给了它就不必再写 label 部件；要放别的内容改用 label 插槽。 */\n    label: { type: String, default: undefined },\n    value: { type: String as PropType<string | null>, default: undefined },\n    defaultValue: { type: String as PropType<string | null>, default: undefined },\n    disabled: Boolean,\n    orientation: { type: String as PropType<Orientation>, default: undefined },\n    dir: { type: String as PropType<Direction>, default: undefined },\n    name: { type: String, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n  },\n  // value-change 携带 { value }，update:value 携带裸值\n  emits: {\n    'value-change': (_details: PayloadOf<RadioGroupProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<RadioGroupProps, 'onValueChange'>['value']) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: RadioGroupProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useRadioGroup(props as RadioGroupProps, notify)\n    provideRadioGroup(ctx)\n    return () => h(\n      'div',\n      ctx.api.value.getRootProps() as Record<string, unknown>,\n      slots.default\n        ? slots.default()\n        : props.collection\n          ? renderDefaultTree(\n              ctx.api.value.collection,\n              slots.label?.() ?? (props.label != null ? [props.label] : null),\n              slots.item,\n            )\n          : [],\n    )\n  },\n})\n\nexport const XhRadioGroupLabel = defineComponent({\n  name: 'XhRadioGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useRadioGroupContext()\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhRadioGroupItem = defineComponent({\n  name: 'XhRadioGroupItem',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的禁用\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useRadioGroupContext()\n    const item = computed<RadioGroupItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideRadioGroupItem({ item })\n    // 本条目持有焦点时，value 变更重报焦点条目，卸载时上报整组失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const svc = ctx.service\n      if (svc.getStatus() !== 'Started')\n        return\n      if (itemEl.value && svc.scope.getActiveElement() === itemEl.value)\n        svc.send({ type: 'ITEM.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'GROUP.BLUR' })\n    })\n    // 隐藏输入与 indicator 由条目自行装配，不暴露成独立组件\n    return () => h('div', { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl }, [\n      h('input', ctx.api.value.getHiddenInputProps(item.value) as Record<string, unknown>),\n      h('span', ctx.api.value.getIndicatorProps(item.value) as Record<string, unknown>),\n      ...(slots.default?.() ?? []),\n    ])\n  },\n})\n\nexport const XhRadioGroupItemText = defineComponent({\n  name: 'XhRadioGroupItemText',\n  setup(_, { slots }) {\n    const ctx = useRadioGroupContext()\n    const { item } = useRadioGroupItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 没写默认插槽时按 collection 铺开的整套结构，作者只交数据。\n * 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。\n */\nfunction renderDefaultTree(\n  collection: readonly RadioGroupNodeMeta[],\n  label: (VNode | string)[] | null,\n  itemSlot?: (node: RadioGroupNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    ...(label ? [h(XhRadioGroupLabel, null, () => label)] : []),\n    // 条目内的 hidden-input 与 indicator 由 XhRadioGroupItem 自行装配\n    ...collection.map(node => h(XhRadioGroupItem, { key: node.value, value: node.value }, () => [\n      h(XhRadioGroupItemText, null, () => itemSlot?.(node) ?? node.label),\n    ])),\n  ]\n}\n"],"mappings":"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"}
+{"version":3,"file":"radio-group.js","names":[],"sources":["../../../src/components/radio-group/radio-group.ts"],"sourcesContent":["import type { RadioGroupItemProps, RadioGroupNode, RadioGroupNodeMeta, RadioGroupSchema } from '@xihan-ui/headless'\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { provideRadioGroup, provideRadioGroupItem, useRadioGroupContext, useRadioGroupItemContext } from './context'\nimport { useRadioGroup } from './use-radio-group'\n\ntype RadioGroupProps = RadioGroupSchema['props']\n\nexport const XhRadioGroupRoot = defineComponent({\n  name: 'XhRadioGroupRoot',\n  props: {\n    collection: { type: Array as PropType<RadioGroupNode[]>, default: undefined },\n    /** 标题文字。给了它就不必再写 label 部件；要放别的内容改用 label 插槽。 */\n    label: { type: String, default: undefined },\n    value: { type: String as PropType<string | null>, default: undefined },\n    defaultValue: { type: String as PropType<string | null>, default: undefined },\n    disabled: Boolean,\n    readOnly: Boolean,\n    invalid: Boolean,\n    required: Boolean,\n    orientation: { type: String as PropType<Orientation>, default: undefined },\n    dir: { type: String as PropType<Direction>, default: undefined },\n    name: { type: String, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n  },\n  // value-change 携带 { value }，update:value 携带裸值\n  emits: {\n    'value-change': (_details: PayloadOf<RadioGroupProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<RadioGroupProps, 'onValueChange'>['value']) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: RadioGroupProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useRadioGroup(props as RadioGroupProps, notify)\n    provideRadioGroup(ctx)\n    return () => h(\n      'div',\n      ctx.api.value.getRootProps() as Record<string, unknown>,\n      slots.default\n        ? slots.default()\n        : props.collection\n          ? renderDefaultTree(\n              ctx.api.value.collection,\n              slots.label?.() ?? (props.label != null ? [props.label] : null),\n              slots.item,\n            )\n          : [],\n    )\n  },\n})\n\nexport const XhRadioGroupLabel = defineComponent({\n  name: 'XhRadioGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useRadioGroupContext()\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhRadioGroupItem = defineComponent({\n  name: 'XhRadioGroupItem',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的禁用\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useRadioGroupContext()\n    const item = computed<RadioGroupItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideRadioGroupItem({ item })\n    // 本条目持有焦点时，value 变更重报焦点条目，卸载时上报整组失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const svc = ctx.service\n      if (svc.getStatus() !== 'Started')\n        return\n      if (itemEl.value && svc.scope.getActiveElement() === itemEl.value)\n        svc.send({ type: 'ITEM.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'GROUP.BLUR' })\n    })\n    // 隐藏输入与 indicator 由条目自行装配，不暴露成独立组件\n    return () => h('div', { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl }, [\n      h('input', ctx.api.value.getHiddenInputProps(item.value) as Record<string, unknown>),\n      h('span', ctx.api.value.getIndicatorProps(item.value) as Record<string, unknown>),\n      ...(slots.default?.() ?? []),\n    ])\n  },\n})\n\nexport const XhRadioGroupItemText = defineComponent({\n  name: 'XhRadioGroupItemText',\n  setup(_, { slots }) {\n    const ctx = useRadioGroupContext()\n    const { item } = useRadioGroupItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 没写默认插槽时按 collection 铺开的整套结构，作者只交数据。\n * 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。\n */\nfunction renderDefaultTree(\n  collection: readonly RadioGroupNodeMeta[],\n  label: (VNode | string)[] | null,\n  itemSlot?: (node: RadioGroupNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    ...(label ? [h(XhRadioGroupLabel, null, () => label)] : []),\n    // 条目内的 hidden-input 与 indicator 由 XhRadioGroupItem 自行装配\n    ...collection.map(node => h(XhRadioGroupItem, { key: node.value, value: node.value }, () => [\n      h(XhRadioGroupItemText, null, () => itemSlot?.(node) ?? node.label),\n    ])),\n  ]\n}\n"],"mappings":"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"}

package/dist/components/rating/context.js

@@ -1,6 +1,6 @@
 import { inject, provide } from "vue";
 //#region src/components/rating/context.ts
-const KEY = Symbol("xh-rating");
+const KEY = Symbol.for("xh-rating");
 function provideRating(ctx) {
 	provide(KEY, ctx);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/rating/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { RatingContext } from './use-rating'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<RatingContext> = Symbol('xh-rating')\n\nexport function provideRating(ctx: RatingContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useRatingContext(): RatingContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Rating 部件必须用在 XhRatingRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAmC,OAAO,WAAW;AAE3D,SAAgB,cAAc,KAA0B;CACtD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,mBAAkC;CAChD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,mCAAmC;CACrD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/rating/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { RatingContext } from './use-rating'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<RatingContext> = Symbol.for('xh-rating')\n\nexport function provideRating(ctx: RatingContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useRatingContext(): RatingContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Rating 部件必须用在 XhRatingRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAmC,OAAO,IAAI,WAAW;AAE/D,SAAgB,cAAc,KAA0B;CACtD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,mBAAkC;CAChD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,mCAAmC;CACrD,OAAO;AACT"}

package/dist/components/result/context.js

@@ -1,6 +1,6 @@
 import { inject, provide } from "vue";
 //#region src/components/result/context.ts
-const KEY = Symbol("xh-result");
+const KEY = Symbol.for("xh-result");
 function provideResult(ctx) {
 	provide(KEY, ctx);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/result/context.ts"],"sourcesContent":["import type { ResultApi } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport { inject, provide } from 'vue'\n\nexport interface ResultContext {\n  api: ComputedRef<ResultApi>\n}\n\nconst KEY: InjectionKey<ResultContext> = Symbol('xh-result')\n\nexport function provideResult(ctx: ResultContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useResultContext(): ResultContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Result 部件必须用在 XhResultRoot 内')\n  return ctx\n}\n"],"mappings":";;AAQA,MAAM,MAAmC,OAAO,WAAW;AAE3D,SAAgB,cAAc,KAA0B;CACtD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,mBAAkC;CAChD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,mCAAmC;CACrD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/result/context.ts"],"sourcesContent":["import type { ResultApi } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport { inject, provide } from 'vue'\n\nexport interface ResultContext {\n  api: ComputedRef<ResultApi>\n}\n\nconst KEY: InjectionKey<ResultContext> = Symbol.for('xh-result')\n\nexport function provideResult(ctx: ResultContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useResultContext(): ResultContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Result 部件必须用在 XhResultRoot 内')\n  return ctx\n}\n"],"mappings":";;AAQA,MAAM,MAAmC,OAAO,IAAI,WAAW;AAE/D,SAAgB,cAAc,KAA0B;CACtD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,mBAAkC;CAChD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,mCAAmC;CACrD,OAAO;AACT"}

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

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","names":[],"sources":["../../../src/components/result/result.ts"],"mappings":";;;;cAQa,4BAAY,8BAAA;;IAGK,MAAA,SAAS;;;;IACX,MAAA;;;;;;;IADE,MAAA,SAAS;;;;IACX,MAAA;;;;;;qCAO1B;cAGW,4BAAY,wCAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,6BAAa,wCAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,wCAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,8BAAc,wCAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"result.d.ts","names":[],"sources":["../../../src/components/result/result.ts"],"mappings":";;;;cASa,4BAAY,8BAAA;;IAGK,MAAA,SAAS;;;;IACX,MAAA;;;;;;;IADE,MAAA,SAAS;;;;IACX,MAAA;;;;;;qCAQ1B;cAGW,4BAAY,wCAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,6BAAa,wCAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,wCAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,8BAAc,wCAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/result/result.js

@@ -1,4 +1,5 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
+import { withXhConfig } from "../../config/config.js";
 import { provideResult, useResultContext } from "./context.js";
 import { computed, defineComponent, h } from "vue";
 import { connectResult } from "@xihan-ui/headless";
@@ -17,7 +18,8 @@ const XhResultRoot = defineComponent({
 		}
 	},
 	setup(props, { slots }) {
-		const api = computed(() => connectResult(props, vueNormalize));
+		const configured = withXhConfig("result", props);
+		const api = computed(() => connectResult(configured, vueNormalize));
 		provideResult({ api });
 		return () => h("div", api.value.getRootProps(), slots.default?.());
 	}

package/dist/components/result/result.js.map

@@ -1 +1 @@
-{"version":3,"file":"result.js","names":[],"sources":["../../../src/components/result/result.ts"],"sourcesContent":["import type { ResultProps, ResultStatus } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectResult } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideResult, useResultContext } from './context'\n\n/** 根节点渲染为 div，缺省值由 connect 给出，这里一律 default: undefined */\nexport const XhResultRoot = defineComponent({\n  name: 'XhResultRoot',\n  props: {\n    status: { type: String as PropType<ResultStatus>, default: undefined },\n    size: { type: String as PropType<'sm' | 'md' | 'lg'>, default: undefined },\n  },\n  setup(props, { slots }) {\n    const api = computed(() => connectResult(props as ResultProps, vueNormalize))\n    provideResult({ api })\n    return () => h('div', api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 装饰性图标容器，内容由作者塞（字形、内联 svg、XhIcon 都行）\nexport const XhResultIcon = defineComponent({\n  name: 'XhResultIcon',\n  setup(_, { slots }) {\n    const ctx = useResultContext()\n    return () => h('span', ctx.api.value.getIconProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 标题渲染为 p 而不是 hN：它只做视觉主次，不往文档大纲里插一级标题\nexport const XhResultTitle = defineComponent({\n  name: 'XhResultTitle',\n  setup(_, { slots }) {\n    const ctx = useResultContext()\n    return () => h('p', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhResultDescription = defineComponent({\n  name: 'XhResultDescription',\n  setup(_, { slots }) {\n    const ctx = useResultContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 操作槽只排版，按钮由作者放进插槽\nexport const XhResultAction = defineComponent({\n  name: 'XhResultAction',\n  setup(_, { slots }) {\n    const ctx = useResultContext()\n    return () => h('div', ctx.api.value.getActionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AAQA,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,OAAO;EACL,QAAQ;GAAE,MAAM;GAAkC,SAAS,KAAA;EAAU;EACrE,MAAM;GAAE,MAAM;GAAwC,SAAS,KAAA;EAAU;CAC3E;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe,cAAc,OAAsB,YAAY,CAAC;EAC5E,cAAc,EAAE,IAAI,CAAC;EACrB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAC9F;AACF,CAAC;AAGD,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;AAGD,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAGD,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC"}
+{"version":3,"file":"result.js","names":[],"sources":["../../../src/components/result/result.ts"],"sourcesContent":["import type { ResultProps, ResultStatus } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectResult } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideResult, useResultContext } from './context'\n\n/** 根节点渲染为 div，缺省值由 connect 给出，这里一律 default: undefined */\nexport const XhResultRoot = defineComponent({\n  name: 'XhResultRoot',\n  props: {\n    status: { type: String as PropType<ResultStatus>, default: undefined },\n    size: { type: String as PropType<'sm' | 'md' | 'lg'>, default: undefined },\n  },\n  setup(props, { slots }) {\n    const configured = withXhConfig('result', props as ResultProps)\n    const api = computed(() => connectResult(configured, vueNormalize))\n    provideResult({ api })\n    return () => h('div', api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 装饰性图标容器，内容由作者塞（字形、内联 svg、XhIcon 都行）\nexport const XhResultIcon = defineComponent({\n  name: 'XhResultIcon',\n  setup(_, { slots }) {\n    const ctx = useResultContext()\n    return () => h('span', ctx.api.value.getIconProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 标题渲染为 p 而不是 hN：它只做视觉主次，不往文档大纲里插一级标题\nexport const XhResultTitle = defineComponent({\n  name: 'XhResultTitle',\n  setup(_, { slots }) {\n    const ctx = useResultContext()\n    return () => h('p', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhResultDescription = defineComponent({\n  name: 'XhResultDescription',\n  setup(_, { slots }) {\n    const ctx = useResultContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 操作槽只排版，按钮由作者放进插槽\nexport const XhResultAction = defineComponent({\n  name: 'XhResultAction',\n  setup(_, { slots }) {\n    const ctx = useResultContext()\n    return () => h('div', ctx.api.value.getActionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;;AASA,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,OAAO;EACL,QAAQ;GAAE,MAAM;GAAkC,SAAS,KAAA;EAAU;EACrE,MAAM;GAAE,MAAM;GAAwC,SAAS,KAAA;EAAU;CAC3E;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,aAAa,aAAa,UAAU,KAAoB;EAC9D,MAAM,MAAM,eAAe,cAAc,YAAY,YAAY,CAAC;EAClE,cAAc,EAAE,IAAI,CAAC;EACrB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAC9F;AACF,CAAC;AAGD,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;AAGD,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAGD,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC"}

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

@@ -1,7 +1,7 @@
 import { inject, provide } from "vue";
 //#region src/components/scroll-area/context.ts
-const KEY = Symbol("xh-scroll-area");
-const SCROLLBAR_KEY = Symbol("xh-scroll-area-scrollbar");
+const KEY = Symbol.for("xh-scroll-area");
+const SCROLLBAR_KEY = Symbol.for("xh-scroll-area-scrollbar");
 function provideScrollArea(ctx) {
 	provide(KEY, ctx);
 }

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('xh-scroll-area')\nconst SCROLLBAR_KEY: InjectionKey<ScrollAreaScrollbarContext> = Symbol('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,gBAAgB;AACpE,MAAM,gBAA0D,OAAO,0BAA0B;AAEjG,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":["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"}

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

@@ -1,15 +1,15 @@
 import { PropType, SlotsType, VNode } from "vue";
-import { ScrollAreaApi, ScrollAreaOrientation, ScrollAreaType } from "@xihan-ui/headless";
-import { Direction, Orientation } from "@xihan-ui/kernel";
+import { ScrollAreaApi, ScrollAreaOrientation, ScrollbarType } from "@xihan-ui/headless";
+import { Direction, Orientation, Size } from "@xihan-ui/kernel";
 //#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<ScrollAreaType>;
+    type: PropType<ScrollbarType>;
     default: undefined;
   };
-  scrollHideDelay: {
+  hideDelay: {
     type: NumberConstructor;
     default: undefined;
   };
@@ -17,18 +17,24 @@ declare const XhScrollAreaRoot: import("vue").DefineComponent<import("vue").Extr
     type: PropType<ScrollAreaOrientation>;
     default: undefined;
   };
+  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<ScrollAreaType>;
+    type: PropType<ScrollbarType>;
     default: undefined;
   };
-  scrollHideDelay: {
+  hideDelay: {
     type: NumberConstructor;
     default: undefined;
   };
@@ -36,15 +42,23 @@ declare const XhScrollAreaRoot: import("vue").DefineComponent<import("vue").Extr
     type: PropType<ScrollAreaOrientation>;
     default: undefined;
   };
+  size: {
+    type: PropType<Size>;
+    default: undefined;
+  };
   dir: {
     type: PropType<Direction>;
     default: undefined;
   };
+  /** 触屏（粗指针）上也画自绘滚动条；缺省交给原生滚动。 */
+  forceVisible: BooleanConstructor;
 }>> & Readonly<{}>, {
-  type: ScrollAreaType;
+  type: ScrollbarType;
   orientation: ScrollAreaOrientation;
   dir: Direction;
-  scrollHideDelay: number;
+  size: Size;
+  forceVisible: boolean;
+  hideDelay: number;
 }, SlotsType<{
   default?: (props: ScrollAreaRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -54,6 +68,7 @@ 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 的写法摆轨道、滑块与交叉口。 */
 declare const XhScrollAreaScrollbar: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   /** 这条滚动条管哪条轴。 */
   orientation: {
@@ -71,12 +86,16 @@ declare const XhScrollAreaScrollbar: import("vue").DefineComponent<import("vue")
 }>> & Readonly<{}>, {
   orientation: Orientation;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhScrollAreaTrack: 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 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>;
 //#endregion
-export { ScrollAreaRootSlotProps, XhScrollAreaContent, XhScrollAreaCorner, XhScrollAreaRoot, XhScrollAreaScrollbar, XhScrollAreaThumb, XhScrollAreaViewport };
+export { ScrollAreaRootSlotProps, XhScrollAreaContent, XhScrollAreaCorner, XhScrollAreaRoot, XhScrollAreaScrollbar, XhScrollAreaThumb, XhScrollAreaTrack, XhScrollAreaViewport };
 //# sourceMappingURL=scroll-area.d.ts.map

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":";;;;;KAeY,0BAA0B,KAAK;cAE9B,gCAAgB,8BAAA;;IAID,MAAA,SAAS;;;;;;;;IAEF,MAAA,SAAS;;;;IACjB,MAAA,SAAS;;;;;;;IAHR,MAAA,SAAS;;;;;;;;IAEF,MAAA,SAAS;;;;IACjB,MAAA,SAAS;;;;;;;;;EAGtB,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;cAEW,qCAAqB,8BAAA;;;IAIC,MAAA,SAAS;;;;;;;;IAAT,MAAA,SAAS;;;;;qCAY1C;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,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":";;;;;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"}

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

@@ -1,3 +1,4 @@
+import { withXhConfig } from "../../config/config.js";
 import { provideScrollArea, provideScrollAreaScrollbar, useScrollAreaContext, useScrollAreaScrollbarContext } from "./context.js";
 import { useScrollArea } from "./use-scroll-area.js";
 import { computed, defineComponent, h } from "vue";
@@ -9,7 +10,7 @@ const XhScrollAreaRoot = defineComponent({
 			type: String,
 			default: void 0
 		},
-		scrollHideDelay: {
+		hideDelay: {
 			type: Number,
 			default: void 0
 		},
@@ -17,14 +18,20 @@ const XhScrollAreaRoot = defineComponent({
 			type: String,
 			default: void 0
 		},
+		size: {
+			type: String,
+			default: void 0
+		},
 		dir: {
 			type: String,
 			default: void 0
-		}
+		},
+		/** 触屏（粗指针）上也画自绘滚动条；缺省交给原生滚动。 */
+		forceVisible: Boolean
 	},
 	slots: Object,
 	setup(props, { slots }) {
-		const ctx = useScrollArea(props);
+		const ctx = useScrollArea(withXhConfig("scroll-area", props));
 		provideScrollArea(ctx);
 		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
 			vertical: ctx.api.value.vertical,
@@ -54,6 +61,7 @@ const XhScrollAreaContent = defineComponent({
 		}, slots.default?.());
 	}
 });
+/** 某条轴的滚动条挂载点，同时是那条 scrollbar 的根；里面照 scrollbar 的写法摆轨道、滑块与交叉口。 */
 const XhScrollAreaScrollbar = defineComponent({
 	name: "XhScrollAreaScrollbar",
 	props: { 
@@ -72,6 +80,17 @@ orientation: {
 		}, slots.default?.());
 	}
 });
+const XhScrollAreaTrack = defineComponent({
+	name: "XhScrollAreaTrack",
+	setup(_, { slots }) {
+		const ctx = useScrollAreaContext();
+		const { scrollbar } = useScrollAreaScrollbarContext();
+		return () => h("div", {
+			...ctx.api.value.getTrackProps(scrollbar.value),
+			ref: ctx.trackRefs[scrollbar.value.orientation]
+		}, slots.default?.());
+	}
+});
 const XhScrollAreaThumb = defineComponent({
 	name: "XhScrollAreaThumb",
 	setup(_, { slots }) {
@@ -80,6 +99,7 @@ const XhScrollAreaThumb = defineComponent({
 		return () => h("div", ctx.api.value.getThumbProps(scrollbar.value), slots.default?.());
 	}
 });
+/** 交叉口补丁，写在竖条的挂载点里；两条都在场时才显形。 */
 const XhScrollAreaCorner = defineComponent({
 	name: "XhScrollAreaCorner",
 	setup(_, { slots }) {
@@ -88,6 +108,6 @@ const XhScrollAreaCorner = defineComponent({
 	}
 });
 //#endregion
-export { XhScrollAreaContent, XhScrollAreaCorner, XhScrollAreaRoot, XhScrollAreaScrollbar, XhScrollAreaThumb, XhScrollAreaViewport };
+export { XhScrollAreaContent, XhScrollAreaCorner, XhScrollAreaRoot, XhScrollAreaScrollbar, XhScrollAreaThumb, XhScrollAreaTrack, XhScrollAreaViewport };
 
 //# sourceMappingURL=scroll-area.js.map

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, ScrollAreaSchema, ScrollAreaScrollbarProps, ScrollAreaType } from '@xihan-ui/headless'\nimport type { Direction, Orientation } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport { computed, defineComponent, h } from 'vue'\nimport {\n  provideScrollArea,\n  provideScrollAreaScrollbar,\n  useScrollAreaContext,\n  useScrollAreaScrollbarContext,\n} from './context'\nimport { useScrollArea } from './use-scroll-area'\n\ntype ScrollAreaProps = ScrollAreaSchema['props']\n\n/** 默认插槽的载荷：两条轴的滚动条状态、正被拖动的那条轴，以及右下角补丁该不该显形。 */\nexport type ScrollAreaRootSlotProps = Pick<ScrollAreaApi, 'vertical' | 'horizontal' | 'draggingAxis' | 'cornerVisible'>\n\nexport const XhScrollAreaRoot = defineComponent({\n  name: 'XhScrollAreaRoot',\n  // 缺省值由机器与 connect 给出，这里一律 default: undefined\n  props: {\n    type: { type: String as PropType<ScrollAreaType>, default: undefined },\n    scrollHideDelay: { type: Number, default: undefined },\n    orientation: { type: String as PropType<ScrollAreaOrientation>, default: undefined },\n    dir: { type: String as PropType<Direction>, default: undefined },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ScrollAreaRootSlotProps) => VNode[]\n  }>,\n  // 组件不对外报事件，滚动是原生的，宿主直接在视口上监听\n  setup(props, { slots }) {\n    const ctx = useScrollArea(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\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 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\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":";;;;AAiBA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CAEN,OAAO;EACL,MAAM;GAAE,MAAM;GAAoC,SAAS,KAAA;EAAU;EACrE,iBAAiB;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACpD,aAAa;GAAE,MAAM;GAA2C,SAAS,KAAA;EAAU;EACnF,KAAK;GAAE,MAAM;GAA+B,SAAS,KAAA;EAAU;CACjE;CACA,OAAO;CAIP,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,cAAc,KAAwB;EAClD,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;AAED,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;EACpD,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,UAAU,KAAK,GAA8B,MAAM,UAAU,CAAC;CAClH;AACF,CAAC;AAED,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":["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"}

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

@@ -1,19 +1,21 @@
-import { ComputedRef, Ref } from "vue";
-import { ScrollAreaApi, ScrollAreaSchema } from "@xihan-ui/headless";
+import { ComputedRef, MaybeRefOrGetter, Ref } from "vue";
+import { ScrollAreaApi, ScrollAreaProps, ScrollAreaServices } from "@xihan-ui/headless";
 import { Orientation } from "@xihan-ui/kernel";
-import { Service } from "@xihan-ui/machine";
 //#region src/components/scroll-area/use-scroll-area.d.ts
 interface ScrollAreaContext {
-  service: Service<ScrollAreaSchema>;
+  /** 两条轴各一台 scrollbar 机器。 */
+  services: ScrollAreaServices;
   api: ComputedRef<ScrollAreaApi>;
-  /** overflow:auto 的那层，尺寸、滚动量与 scroll 事件都取自它。 */
+  /** overflow:auto 的那层，两台机器都挂在它身上。 */
   viewportRef: Ref<HTMLElement | null>;
-  /** 内容包裹层，用于跟随尺寸变化。 */
+  /** 内容包裹层。 */
   contentRef: Ref<HTMLElement | null>;
-  /** 两条轴各自的滚动条节点，轨道长度按轴现量。 */
+  /** 两条轴各自的挂载点（即那条 scrollbar 的根）与轨道，按轴现量。 */
   scrollbarRefs: Record<Orientation, Ref<HTMLElement | null>>;
+  trackRefs: Record<Orientation, Ref<HTMLElement | null>>;
 }
-declare function useScrollArea(props: ScrollAreaSchema['props']): ScrollAreaContext;
+/** 滚动区没有自己的机器：按轴各建一台 scrollbar，视口就是它们共同的滚动容器。 */
+declare function useScrollArea(source: MaybeRefOrGetter<ScrollAreaProps>): ScrollAreaContext;
 //#endregion
 export { ScrollAreaContext, useScrollArea };
 //# sourceMappingURL=use-scroll-area.d.ts.map