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

package/CHANGELOG.md

@@ -1,5 +1,96 @@
 # @xihan-ui/vue
 
+## 1.0.0-alpha.2
+
+### Minor Changes
+
+- 466f143: 新增两个包：`@xihan-ui/motion` 收动效原语，`@xihan-ui/animations` 收现成的动效。
+
+  动效的东西原先散在三处：缓动表与减弱动效探测在 `behavior`，补间与帧循环在 `headless/src/shared`，两套缓动的档名和值还对不上。`@xihan-ui/motion` 把它们收成一处，并补上真正缺的两样——解析解弹簧与 Web Animations 的薄封装。缓动从此只有一份来源：CSS 侧的 cubic-bezier 串与 JS 侧的采样函数同名同源。弹簧按阻尼比分三支算沉降时长，与 dt=0.1ms 的四阶龙格-库塔积分逐点对拍。减弱动效在系统偏好之上叠了一层应用级 override，接得上产品自己的"减弱动效"设置项。
+
+  `behavior` 与 `headless` 原样重新导出搬走的名字，公开面一个没少。
+
+  `@xihan-ui/animations` 是建在上面的效果层：11 个进场预设、6 个注意预设、错开起播与文字拆分。一段动画是一份可 JSON 序列化的配方，能存进数据库、由界面下拉切换。减弱动效的降级由 `motion` 统一兜住，这一层不另开通道——降级只影响中间帧存不存在，不影响控制流。
+
+### Patch Changes
+
+- 09b5ad8: 「collection 铺开的结构凑齐必备部件」这条判据改成机检，并把三档语义写进文档。
+
+  `collection` 收了数据不等于会替你渲染结构，而这件事此前既没有对外判据、也没有任何东西守着：
+  14 个组件里 13 个在根上代铺、popselect 只在 content 里铺，使用者只能一个个试。
+  官网落地时那棵树就是把数据写了一遍、DOM 又手码了一遍，两份得自己保持同步。
+
+  新增 `tests/collection-required-parts.spec.ts`：逐个组件只交 `collection`、不写任何部件，
+  断言铺出来的 DOM 含该组件 `meta.requiredParts` 里的每一个部件。少一个就是渲染出一个
+  看着正常、其实不工作的组件——浮层打不开、方向键找不到条目、同一份结构写到自定义元素那侧
+  会报 `wc.missing-part`。给新组件加代铺时先往这份测试加一行，铺漏了当场红。
+
+  顺带查出并钉住两处此前没人测的差别：`popselect` 的铺开落在 content 部件里而不是根上
+  （`<XhPopselectRoot :collection>` 单独用什么都不出），`mention` 的候选浮层没有 `defaultOpen`、
+  敲下前缀字符才铺开。
+
+  `guide/anatomy.md` 补「collection 管不管铺开结构」一节，三档逐个列出组件名，
+  并写明判据是结构的自由度：扁平集合的 DOM 形状是确定的，代铺挡不住任何写法；
+  层级与多区（`tree` / `cascader` / `transfer`）的结构有太多合理变体，代铺只会逼作者推翻重写。
+
+- ae21590: 75 个组件的插槽写上真类型，`vue-tsc` 从此接得住插槽名与载荷键名的拼写错误。
+
+  组件是渲染函数写的，`.d.ts` 里插槽泛型一直是空的（`DefineComponent` 的 `S` 位是 `{}`），
+  于是 `#panel="node"`、`v-slot="{ pages, page }"` 这些载荷在消费端全是 `any`：
+  键名写错不报、插槽名写错不报，只在运行期渲染出 `undefined`。props 与 emits 早就有完整类型，
+  唯独插槽这一层没有对外描述——而无头库恰恰是靠插槽把控制权交回作者的。
+
+  现在每个带载荷的插槽都有具名载荷类型（`TabsPanelSlotProps`、`StepsRootSlotProps` 这样命名，
+  均从主入口导出），组件上声明 `slots: Object as SlotsType<…>`：
+
+  ```vue
+  <template #panel="node">{{ node.lable }}</template>
+  <!-- TS2551: Property 'lable' does not exist on type 'TabsNodeMeta'. Did you mean 'label'? -->
+  ```
+
+  两条形状上的取舍值得写下来：
+
+  - **键一律可选**。非可选时 `slots.default ? 作者内容 : 按 collection 铺开` 这类判断在类型上恒为真，
+    而它承载的正是「没写默认插槽就铺开整套结构」的核心行为——类型不能对着它撒谎。
+  - **值一律写成函数类型**而不是裸载荷类型。Vue 的 `UnwrapSlotsType` 对函数类型原样保留、
+    对裸类型套一层 `Slot<T>`，而 `Slot<T>` 的实参元组在 `T` 不 extends `undefined` 时是 `[T]`
+    ——零参调用会变成非法，而库里到处是 `slots.default?.()`。
+
+  新增 `check-slot-types` 门禁盯住这两条与「带载荷就必须声明」，`pnpm gate` 由十七项变十八项。
+
+- ba3b3aa: 自定义元素补上全局文案层：`setXhConfig`。
+
+  `provideXhConfig` 一直只有 Vue 适配器有。自定义元素拿不到 provide/inject，文案又是对象、
+  只能走 property 不能走 attribute，于是 31 个元素只能在 JS 里逐实例各设一次 `.translations`——
+  一个中文应用要为此写几十行。而 `guide/i18n.md` 通篇把 `provideXhConfig` 当作「这套机制」讲，
+  一次都没提 Web Components，读的人会以为两端通用。
+
+  现在两端各有一处全局出口，取值优先级一致：**实例 → 全局 → 组件内建默认（英文）**，
+  `translations` 逐键合并。切语言再调一次 `setXhConfig` 即可，已挂载的元素跟着重渲。
+
+  接线落在 `MachineController` 一处——31 个元素的机器 props 都从那里过，不必逐个改。
+
+  `XhTranslationOverrides` 那张 31 条的映射表下沉到 `@xihan-ui/headless`，两个适配器共用一份。
+  在 WC 侧另抄一份是唯一的替代方案，而两份 31 条的表迟早会漂。Vue 侧原样再导出，导出名不变。
+
+  与 Vue 侧的两处差别写进文档了：`setXhConfig` 是整份替换而非深合并；它是模块级的，
+  没有「只在某棵子树里换语言」的能力。
+
+- Updated dependencies [3469066]
+- Updated dependencies [466f143]
+- Updated dependencies [7a5d898]
+- Updated dependencies [52729a1]
+- Updated dependencies [ba3b3aa]
+  - @xihan-ui/backgrounds@1.0.0-alpha.2
+  - @xihan-ui/headless@1.0.0-alpha.2
+  - @xihan-ui/motion@1.0.0-alpha.2
+  - @xihan-ui/behavior@1.0.0-alpha.2
+  - @xihan-ui/kernel@1.0.0-alpha.2
+  - @xihan-ui/machine@1.0.0-alpha.2
+  - @xihan-ui/code-highlight@1.0.0-alpha.2
+  - @xihan-ui/position@1.0.0-alpha.2
+  - @xihan-ui/sound@1.0.0-alpha.2
+
 ## 1.0.0-alpha.1
 
 ### Major Changes

package/dist/components/affix/affix.d.ts

@@ -1,8 +1,10 @@
 import { PayloadOf } from "../../runtime/payload.js";
-import { PropType } from "vue";
-import { AffixSchema } from "@xihan-ui/headless";
+import { PropType, SlotsType, VNode } from "vue";
+import { AffixApi, AffixSchema } from "@xihan-ui/headless";
 //#region src/components/affix/affix.d.ts
 type AffixProps = AffixSchema['props'];
+/** 默认插槽的载荷：此刻是不是吸住了。 */
+type AffixRootSlotProps = Pick<AffixApi, 'affixed'>;
 /** 根节点是占位盒：content 吸住时脱流，它留在原位撑住那块空间。 */
 declare const XhAffixRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   offsetTop: {
@@ -18,7 +20,7 @@ declare const XhAffixRoot: import("vue").DefineComponent<import("vue").ExtractPr
     type: PropType<HTMLElement | null>;
     default: undefined;
   };
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   'affix-change': (_details: PayloadOf<AffixProps, "onAffixChange">) => true;
@@ -42,11 +44,13 @@ declare const XhAffixRoot: import("vue").DefineComponent<import("vue").ExtractPr
   offsetTop: number;
   offsetBottom: number;
   target: HTMLElement | null;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+  default?: (props: AffixRootSlotProps) => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /** 吸住时脱离常规流钉在可视区边上，落位由机器量好写进内联样式。 */
-declare const XhAffixContent: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhAffixContent: 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 { XhAffixContent, XhAffixRoot };
+export { AffixRootSlotProps, XhAffixContent, XhAffixRoot };
 //# sourceMappingURL=affix.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"affix.d.ts","names":[],"sources":["../../../src/components/affix/affix.ts"],"mappings":";;;;KAOK,aAAa;;cAGL,2BAAW,8BAAA;;;;;;;;;;;IAOM,MAAA,SAAS;;;;;;EAGR,iBAAA,UAAA,UAAU;;;;;;;;;;;;IAHX,MAAA,SAAS;;;;;;;;;qCAerC;;cAGW,8BAAc,wCAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"affix.d.ts","names":[],"sources":["../../../src/components/affix/affix.ts"],"mappings":";;;;KAOK,aAAa;;KAGN,qBAAqB,KAAK;;cAGzB,2BAAW,8BAAA;;;;;;;;;;;IAOM,MAAA,SAAS;;;;;;EAGR,iBAAA,UAAA,UAAU;;;;;;;;;;;;IAHX,MAAA,SAAS;;;;;;;;;;EAMzB,WAAC,OAAO,uBAAuB;kCAY3C;;cAGW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/affix/affix.js

@@ -21,6 +21,7 @@ const XhAffixRoot = defineComponent({
 		}
 	},
 	emits: { "affix-change": (_details) => true },
+	slots: Object,
 	setup(props, { slots, emit }) {
 		const notify = (details) => emit("affix-change", details);
 		const ctx = useAffix(props, notify, () => props.target ?? null);

package/dist/components/affix/affix.js.map

@@ -1 +1 @@
-{"version":3,"file":"affix.js","names":[],"sources":["../../../src/components/affix/affix.ts"],"sourcesContent":["import type { AffixSchema } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { provideAffix, useAffixContext } from './context'\nimport { useAffix } from './use-affix'\n\ntype AffixProps = AffixSchema['props']\n\n/** 根节点是占位盒：content 吸住时脱流，它留在原位撑住那块空间。 */\nexport const XhAffixRoot = defineComponent({\n  name: 'XhAffixRoot',\n  // 缺省值由机器与 connect 决定，这里一律 default: undefined\n  props: {\n    offsetTop: { type: Number, default: undefined },\n    offsetBottom: { type: Number, default: undefined },\n    /** 滚动容器，缺省即整页滚动；经 refs 交给观察器。 */\n    target: { type: Object as PropType<HTMLElement | null>, default: undefined },\n  },\n  emits: {\n    'affix-change': (_details: PayloadOf<AffixProps, 'onAffixChange'>) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: AffixProps['onAffixChange'] = details => emit('affix-change', details)\n    // 传响应式 props 对象本身而非快照，供机器每次读时重新展开\n    const ctx = useAffix(props as AffixProps, notify, () => props.target ?? null)\n    provideAffix(ctx)\n    return () => h('div', {\n      ...ctx.api.value.getRootProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.rootRef.value = el as HTMLElement },\n    }, slots.default?.({ affixed: ctx.api.value.affixed }))\n  },\n})\n\n/** 吸住时脱离常规流钉在可视区边上，落位由机器量好写进内联样式。 */\nexport const XhAffixContent = defineComponent({\n  name: 'XhAffixContent',\n  setup(_, { slots }) {\n    const ctx = useAffixContext()\n    return () => h('div', ctx.api.value.getContentProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;AAUA,MAAa,cAAc,gBAAgB;CACzC,MAAM;CAEN,OAAO;EACL,WAAW;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC9C,cAAc;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;;EAEjD,QAAQ;GAAE,MAAM;GAAwC,SAAS,KAAA;EAAU;CAC7E;CACA,OAAO,EACL,iBAAiB,aAAqD,KACxE;CACA,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAAsC,YAAW,KAAK,gBAAgB,OAAO;EAEnF,MAAM,MAAM,SAAS,OAAqB,cAAc,MAAM,UAAU,IAAI;EAC5E,aAAa,GAAG;EAChB,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,aAAa;GAC9B,MAAM,OAAgB;IAAE,IAAI,QAAQ,QAAQ;GAAkB;EAChE,GAAG,MAAM,UAAU,EAAE,SAAS,IAAI,IAAI,MAAM,QAAQ,CAAC,CAAC;CACxD;AACF,CAAC;;AAGD,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,gBAAgB;EAC5B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC"}
+{"version":3,"file":"affix.js","names":[],"sources":["../../../src/components/affix/affix.ts"],"sourcesContent":["import type { AffixApi, AffixSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { provideAffix, useAffixContext } from './context'\nimport { useAffix } from './use-affix'\n\ntype AffixProps = AffixSchema['props']\n\n/** 默认插槽的载荷：此刻是不是吸住了。 */\nexport type AffixRootSlotProps = Pick<AffixApi, 'affixed'>\n\n/** 根节点是占位盒：content 吸住时脱流，它留在原位撑住那块空间。 */\nexport const XhAffixRoot = defineComponent({\n  name: 'XhAffixRoot',\n  // 缺省值由机器与 connect 决定，这里一律 default: undefined\n  props: {\n    offsetTop: { type: Number, default: undefined },\n    offsetBottom: { type: Number, default: undefined },\n    /** 滚动容器，缺省即整页滚动；经 refs 交给观察器。 */\n    target: { type: Object as PropType<HTMLElement | null>, default: undefined },\n  },\n  emits: {\n    'affix-change': (_details: PayloadOf<AffixProps, 'onAffixChange'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: AffixRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: AffixProps['onAffixChange'] = details => emit('affix-change', details)\n    // 传响应式 props 对象本身而非快照，供机器每次读时重新展开\n    const ctx = useAffix(props as AffixProps, notify, () => props.target ?? null)\n    provideAffix(ctx)\n    return () => h('div', {\n      ...ctx.api.value.getRootProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.rootRef.value = el as HTMLElement },\n    }, slots.default?.({ affixed: ctx.api.value.affixed }))\n  },\n})\n\n/** 吸住时脱离常规流钉在可视区边上，落位由机器量好写进内联样式。 */\nexport const XhAffixContent = defineComponent({\n  name: 'XhAffixContent',\n  setup(_, { slots }) {\n    const ctx = useAffixContext()\n    return () => h('div', ctx.api.value.getContentProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;AAaA,MAAa,cAAc,gBAAgB;CACzC,MAAM;CAEN,OAAO;EACL,WAAW;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC9C,cAAc;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;;EAEjD,QAAQ;GAAE,MAAM;GAAwC,SAAS,KAAA;EAAU;CAC7E;CACA,OAAO,EACL,iBAAiB,aAAqD,KACxE;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAAsC,YAAW,KAAK,gBAAgB,OAAO;EAEnF,MAAM,MAAM,SAAS,OAAqB,cAAc,MAAM,UAAU,IAAI;EAC5E,aAAa,GAAG;EAChB,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,aAAa;GAC9B,MAAM,OAAgB;IAAE,IAAI,QAAQ,QAAQ;GAAkB;EAChE,GAAG,MAAM,UAAU,EAAE,SAAS,IAAI,IAAI,MAAM,QAAQ,CAAC,CAAC;CACxD;AACF,CAAC;;AAGD,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,gBAAgB;EAC5B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC"}

package/dist/components/anchor/anchor.d.ts

@@ -112,10 +112,10 @@ declare const XhAnchorRoot: import("vue").DefineComponent<import("vue").ExtractP
   dir: Direction;
   tone: Tone;
   size: Size;
-  smooth: boolean;
   translations: Partial<AnchorTranslations>;
   targets: readonly string[];
   offset: number;
+  smooth: boolean;
   scrollElement: HTMLElement | null;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhAnchorList: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {

package/dist/components/back-top/back-top.d.ts

@@ -1,9 +1,11 @@
 import { PayloadOf } from "../../runtime/payload.js";
-import { PropType } from "vue";
-import { BackTopBehavior, BackTopSchema, BackTopTranslations } from "@xihan-ui/headless";
+import { PropType, SlotsType, VNode } from "vue";
+import { BackTopApi, BackTopBehavior, BackTopSchema, BackTopTranslations } from "@xihan-ui/headless";
 import { Size, Tone } from "@xihan-ui/kernel";
 //#region src/components/back-top/back-top.d.ts
 type BackTopProps = BackTopSchema['props'];
+/** 默认插槽的载荷：按钮此刻露不露面。 */
+type BackTopRootSlotProps = Pick<BackTopApi, 'visible'>;
 /** 根节点是定位壳：把按钮钉在视口一角，收起时整块让位。 */
 declare const XhBackTopRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   visibilityHeight: {
@@ -31,7 +33,7 @@ declare const XhBackTopRoot: import("vue").DefineComponent<import("vue").Extract
     type: PropType<HTMLElement | null>;
     default: undefined;
   };
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   'visible-change': (_details: PayloadOf<BackTopProps, "onVisibleChange">) => true;
@@ -67,14 +69,16 @@ declare const XhBackTopRoot: import("vue").DefineComponent<import("vue").Extract
   tone: Tone;
   size: Size;
   target: HTMLElement | null;
+  translations: Partial<BackTopTranslations>;
   visibilityHeight: number;
   behavior: BackTopBehavior;
-  translations: Partial<BackTopTranslations>;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+  default?: (props: BackTopRootSlotProps) => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /** 原生 button：Enter / Space 的激活与 Tab 停靠都由平台提供。 */
-declare const XhBackTopTrigger: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhBackTopTrigger: 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 { XhBackTopRoot, XhBackTopTrigger };
+export { BackTopRootSlotProps, XhBackTopRoot, XhBackTopTrigger };
 //# sourceMappingURL=back-top.d.ts.map

package/dist/components/back-top/back-top.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"back-top.d.ts","names":[],"sources":["../../../src/components/back-top/back-top.ts"],"mappings":";;;;;KASK,eAAe;;cAGP,6BAAa,8BAAA;;;;;;IAKM,MAAA,SAAS;;;;IACL,MAAA,SAAS,QAAQ;;;;IACzB,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;IAEP,MAAA,SAAS;;;;;;EAGN,mBAAA,UAAA,UAAU;;;;;;;IARX,MAAA,SAAS;;;;IACL,MAAA,SAAS,QAAQ;;;;IACzB,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;IAEP,MAAA,SAAS;;;;;;;;;;;;qCAcrC;;cAGW,gCAAgB,wCAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"back-top.d.ts","names":[],"sources":["../../../src/components/back-top/back-top.ts"],"mappings":";;;;;KASK,eAAe;;KAGR,uBAAuB,KAAK;;cAG3B,6BAAa,8BAAA;;;;;;IAKM,MAAA,SAAS;;;;IACL,MAAA,SAAS,QAAQ;;;;IACzB,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;IAEP,MAAA,SAAS;;;;;;EAGN,mBAAA,UAAA,UAAU;;;;;;;IARX,MAAA,SAAS;;;;IACL,MAAA,SAAS,QAAQ;;;;IACzB,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;IAEP,MAAA,SAAS;;;;;;;;;;;;;EAMzB,WAAC,OAAO,yBAAyB;kCAW7C;;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/back-top/back-top.js

@@ -34,6 +34,7 @@ const XhBackTopRoot = defineComponent({
 		}
 	},
 	emits: { "visible-change": (_details) => true },
+	slots: Object,
 	setup(props, { slots, emit }) {
 		const notify = (details) => emit("visible-change", details);
 		const ctx = useBackTop(withXhConfig("back-top", props), notify, () => props.target ?? null);

package/dist/components/back-top/back-top.js.map

@@ -1 +1 @@
-{"version":3,"file":"back-top.js","names":[],"sources":["../../../src/components/back-top/back-top.ts"],"sourcesContent":["import type { BackTopBehavior, BackTopSchema, BackTopTranslations } from '@xihan-ui/headless'\nimport type { Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideBackTop, useBackTopContext } from './context'\nimport { useBackTop } from './use-back-top'\n\ntype BackTopProps = BackTopSchema['props']\n\n/** 根节点是定位壳：把按钮钉在视口一角，收起时整块让位。 */\nexport const XhBackTopRoot = defineComponent({\n  name: 'XhBackTopRoot',\n  // 缺省值由机器与 connect 决定，这里一律 default: undefined\n  props: {\n    visibilityHeight: { type: Number, default: undefined },\n    behavior: { type: String as PropType<BackTopBehavior>, default: undefined },\n    translations: { type: Object as PropType<Partial<BackTopTranslations>>, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n    /** 滚动容器，缺省即整页滚动；经 refs 交给观察器。 */\n    target: { type: Object as PropType<HTMLElement | null>, default: undefined },\n  },\n  emits: {\n    'visible-change': (_details: PayloadOf<BackTopProps, 'onVisibleChange'>) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: BackTopProps['onVisibleChange'] = details => emit('visible-change', details)\n    // 传响应式 props 对象本身而非快照，供机器每次读时重新展开\n    const ctx = useBackTop(withXhConfig('back-top', props) as BackTopProps, notify, () => props.target ?? null)\n    provideBackTop(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      visible: ctx.api.value.visible,\n    }))\n  },\n})\n\n/** 原生 button：Enter / Space 的激活与 Tab 停靠都由平台提供。 */\nexport const XhBackTopTrigger = defineComponent({\n  name: 'XhBackTopTrigger',\n  setup(_, { slots }) {\n    const ctx = useBackTopContext()\n    return () => h('button', ctx.api.value.getTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AAYA,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CAEN,OAAO;EACL,kBAAkB;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACrD,UAAU;GAAE,MAAM;GAAqC,SAAS,KAAA;EAAU;EAC1E,cAAc;GAAE,MAAM;GAAkD,SAAS,KAAA;EAAU;EAC3F,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;EAC3D,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;;EAE3D,QAAQ;GAAE,MAAM;GAAwC,SAAS,KAAA;EAAU;CAC7E;CACA,OAAO,EACL,mBAAmB,aAAyD,KAC9E;CACA,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA0C,YAAW,KAAK,kBAAkB,OAAO;EAEzF,MAAM,MAAM,WAAW,aAAa,YAAY,KAAK,GAAmB,cAAc,MAAM,UAAU,IAAI;EAC1G,eAAe,GAAG;EAClB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,EAC7F,SAAS,IAAI,IAAI,MAAM,QACzB,CAAC,CAAC;CACJ;AACF,CAAC;;AAGD,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC"}
+{"version":3,"file":"back-top.js","names":[],"sources":["../../../src/components/back-top/back-top.ts"],"sourcesContent":["import type { BackTopApi, BackTopBehavior, BackTopSchema, BackTopTranslations } from '@xihan-ui/headless'\nimport type { Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideBackTop, useBackTopContext } from './context'\nimport { useBackTop } from './use-back-top'\n\ntype BackTopProps = BackTopSchema['props']\n\n/** 默认插槽的载荷：按钮此刻露不露面。 */\nexport type BackTopRootSlotProps = Pick<BackTopApi, 'visible'>\n\n/** 根节点是定位壳：把按钮钉在视口一角，收起时整块让位。 */\nexport const XhBackTopRoot = defineComponent({\n  name: 'XhBackTopRoot',\n  // 缺省值由机器与 connect 决定，这里一律 default: undefined\n  props: {\n    visibilityHeight: { type: Number, default: undefined },\n    behavior: { type: String as PropType<BackTopBehavior>, default: undefined },\n    translations: { type: Object as PropType<Partial<BackTopTranslations>>, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n    /** 滚动容器，缺省即整页滚动；经 refs 交给观察器。 */\n    target: { type: Object as PropType<HTMLElement | null>, default: undefined },\n  },\n  emits: {\n    'visible-change': (_details: PayloadOf<BackTopProps, 'onVisibleChange'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: BackTopRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: BackTopProps['onVisibleChange'] = details => emit('visible-change', details)\n    // 传响应式 props 对象本身而非快照，供机器每次读时重新展开\n    const ctx = useBackTop(withXhConfig('back-top', props) as BackTopProps, notify, () => props.target ?? null)\n    provideBackTop(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      visible: ctx.api.value.visible,\n    }))\n  },\n})\n\n/** 原生 button：Enter / Space 的激活与 Tab 停靠都由平台提供。 */\nexport const XhBackTopTrigger = defineComponent({\n  name: 'XhBackTopTrigger',\n  setup(_, { slots }) {\n    const ctx = useBackTopContext()\n    return () => h('button', ctx.api.value.getTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AAeA,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CAEN,OAAO;EACL,kBAAkB;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACrD,UAAU;GAAE,MAAM;GAAqC,SAAS,KAAA;EAAU;EAC1E,cAAc;GAAE,MAAM;GAAkD,SAAS,KAAA;EAAU;EAC3F,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;EAC3D,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;;EAE3D,QAAQ;GAAE,MAAM;GAAwC,SAAS,KAAA;EAAU;CAC7E;CACA,OAAO,EACL,mBAAmB,aAAyD,KAC9E;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA0C,YAAW,KAAK,kBAAkB,OAAO;EAEzF,MAAM,MAAM,WAAW,aAAa,YAAY,KAAK,GAAmB,cAAc,MAAM,UAAU,IAAI;EAC1G,eAAe,GAAG;EAClB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,EAC7F,SAAS,IAAI,IAAI,MAAM,QACzB,CAAC,CAAC;CACJ;AACF,CAAC;;AAGD,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC"}

package/dist/components/calendar/calendar.d.ts

@@ -1,8 +1,10 @@
 import { PayloadOf } from "../../runtime/payload.js";
-import { PropType } from "vue";
-import { CalendarSchema, CalendarSelectionMode, CalendarWeekdayFormat } from "@xihan-ui/headless";
+import { PropType, SlotsType, VNode } from "vue";
+import { CalendarApi, CalendarSchema, CalendarSelectionMode, CalendarWeekdayFormat } from "@xihan-ui/headless";
 //#region src/components/calendar/calendar.d.ts
 type CalendarProps = CalendarSchema['props'];
+/** 默认插槽的载荷：选中值与聚焦日、展示月的日期矩阵与表头，以及选中、聚焦、翻月的动作。 */
+type CalendarRootSlotProps = Pick<CalendarApi, 'value' | 'focusedValue' | 'visibleMonth' | 'weeks' | 'weekDays' | 'headingLabel' | 'canGoPrev' | 'canGoNext' | 'isSelected' | 'isUnavailable' | 'setValue' | 'select' | 'focus' | 'goToPrevMonth' | 'goToNextMonth'>;
 declare const XhCalendarRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: PropType<string | string[]>;
@@ -51,7 +53,7 @@ declare const XhCalendarRoot: import("vue").DefineComponent<import("vue").Extrac
     default: undefined;
   };
   fixedWeeks: BooleanConstructor;
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   'value-change': (_details: PayloadOf<CalendarProps, "onValueChange">) => true;
@@ -116,8 +118,8 @@ declare const XhCalendarRoot: import("vue").DefineComponent<import("vue").Extrac
   defaultValue: string | string[];
   disabled: boolean;
   max: string;
-  readOnly: boolean;
   focusedValue: string;
+  readOnly: boolean;
   fixedWeeks: boolean;
   selectionMode: CalendarSelectionMode;
   defaultFocusedValue: string;
@@ -126,29 +128,31 @@ declare const XhCalendarRoot: import("vue").DefineComponent<import("vue").Extrac
   locale: string;
   timeZone: string;
   weekdayFormat: CalendarWeekdayFormat;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhCalendarHeader: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}, SlotsType<{
+  default?: (props: CalendarRootSlotProps) => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCalendarHeader: 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 XhCalendarPrevTrigger: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCalendarPrevTrigger: 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 XhCalendarNextTrigger: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCalendarNextTrigger: 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 XhCalendarHeading: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCalendarHeading: 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 XhCalendarGrid: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCalendarGrid: 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 XhCalendarGridHead: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCalendarGridHead: 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 XhCalendarGridBody: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCalendarGridBody: 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 XhCalendarWeekRow: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCalendarWeekRow: 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 XhCalendarWeekDay: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
@@ -156,7 +160,7 @@ declare const XhCalendarWeekDay: import("vue").DefineComponent<import("vue").Ext
     type: PropType<number | string>;
     required: true;
   };
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   value: {
@@ -170,7 +174,7 @@ declare const XhCalendarCell: import("vue").DefineComponent<import("vue").Extrac
     type: StringConstructor;
     required: true;
   };
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   /** ISO 日期串。 */
@@ -179,9 +183,9 @@ declare const XhCalendarCell: import("vue").DefineComponent<import("vue").Extrac
     required: true;
   };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhCalendarCellTrigger: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCalendarCellTrigger: 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 { XhCalendarCell, XhCalendarCellTrigger, XhCalendarGrid, XhCalendarGridBody, XhCalendarGridHead, XhCalendarHeader, XhCalendarHeading, XhCalendarNextTrigger, XhCalendarPrevTrigger, XhCalendarRoot, XhCalendarWeekDay, XhCalendarWeekRow };
+export { CalendarRootSlotProps, XhCalendarCell, XhCalendarCellTrigger, XhCalendarGrid, XhCalendarGridBody, XhCalendarGridHead, XhCalendarHeader, XhCalendarHeading, XhCalendarNextTrigger, XhCalendarPrevTrigger, XhCalendarRoot, XhCalendarWeekDay, XhCalendarWeekRow };
 //# sourceMappingURL=calendar.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"calendar.d.ts","names":[],"sources":["../../../src/components/calendar/calendar.ts"],"mappings":";;;;KAQK,gBAAgB;cAER,8BAAc,8BAAA;;IAIW,MAAA;;;;IACO,MAAA;;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAKH,MAAA,UAAU;;;;;;;;;;;;;;IAKhB,MAAA,SAAS;;;;;;;EAKf,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACA,yBAAA,UAAA,UAAU;EACN,wBAAA,eAAA,UAAU;;;IApBf,MAAA;;;;IACO,MAAA;;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAKH,MAAA,UAAU;;;;;;;;;;;;;;IAKhB,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;EALc,oBAAA;;;;qCA6C1D;cAEW,gCAAgB,wCAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,wCAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,wCAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,wCAAA,oBAAA,4BAAA;;8BAW5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,wCAAA,oBAAA,4BAAA;;8BAUzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,wCAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,wCAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,iCAAiB,wCAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,8BAAA;;IAIS,MAAA;;;;;;;IAAA,MAAA;;;MAWrC,oDAAA;cAEW,8BAAc,8BAAA;;;;;;;;;;;;;;MAazB,oDAAA;cAEW,qCAAqB,wCAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"calendar.d.ts","names":[],"sources":["../../../src/components/calendar/calendar.ts"],"mappings":";;;;KAQK,gBAAgB;;KAGT,wBAAwB,KAClC;cAkBW,8BAAc,8BAAA;;IAIW,MAAA;;;;IACO,MAAA;;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAKH,MAAA,UAAU;;;;;;;;;;;;;;IAKhB,MAAA,SAAS;;;;;;;EAKf,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACA,yBAAA,UAAA,UAAU;EACN,wBAAA,eAAA,UAAU;;;IApBf,MAAA;;;;IACO,MAAA;;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAKH,MAAA,UAAU;;;;;;;;;;;;;;IAKhB,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;EALc,oBAAA;;;;;EAgB9C,WAAC,OAAO,0BAA0B;kCAgC9C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAW5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAUzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,8BAAA;;IAIS,MAAA;;;;;;;IAAA,MAAA;;;MAWrC,oDAAA;cAEW,8BAAc,8BAAA;;;;;;;;;;;;;;MAazB,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/calendar/calendar.js

@@ -60,6 +60,7 @@ const XhCalendarRoot = defineComponent({
 		"focused-value-change": (_details) => true,
 		"update:focusedValue": (_focusedValue) => true
 	},
+	slots: Object,
 	setup(props, { slots, emit }) {
 		const notifyValue = (details) => {
 			emit("value-change", details);

package/dist/components/calendar/calendar.js.map

@@ -1 +1 @@
-{"version":3,"file":"calendar.js","names":[],"sources":["../../../src/components/calendar/calendar.ts"],"sourcesContent":["import type { CalendarCellProps, CalendarSchema, CalendarSelectionMode, CalendarWeekdayFormat } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideCalendar, provideCalendarCell, useCalendarCellContext, useCalendarContext } from './context'\nimport { useCalendar } from './use-calendar'\n\ntype CalendarProps = CalendarSchema['props']\n\nexport const XhCalendarRoot = defineComponent({\n  name: 'XhCalendarRoot',\n  // 缺省值由 connect 与机器给出，这里一律 default: undefined\n  props: {\n    value: { type: [String, Array] as PropType<string | string[]>, default: undefined },\n    defaultValue: { type: [String, Array] as PropType<string | string[]>, default: undefined },\n    selectionMode: { type: String as PropType<CalendarSelectionMode>, default: undefined },\n    focusedValue: { type: String, default: undefined },\n    defaultFocusedValue: { type: String, default: undefined },\n    min: { type: String, default: undefined },\n    max: { type: String, default: undefined },\n    isDateUnavailable: { type: Function as PropType<(value: string) => boolean>, default: undefined },\n    locale: { type: String, default: undefined },\n    timeZone: { type: String, default: undefined },\n    disabled: Boolean,\n    readOnly: Boolean,\n    weekdayFormat: { type: String as PropType<CalendarWeekdayFormat>, default: undefined },\n    fixedWeeks: Boolean,\n  },\n  // *-change 携带 details 对象，update:* 携带裸值；选中值恒为数组，单选时长度 ≤ 1\n  emits: {\n    'value-change': (_details: PayloadOf<CalendarProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<CalendarProps, 'onValueChange'>['value']) => true,\n    'focused-value-change': (_details: PayloadOf<CalendarProps, 'onFocusedValueChange'>) => true,\n    'update:focusedValue': (_focusedValue: PayloadOf<CalendarProps, 'onFocusedValueChange'>['focusedValue']) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notifyValue: CalendarProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyFocus: CalendarProps['onFocusedValueChange'] = (details) => {\n      emit('focused-value-change', details)\n      emit('update:focusedValue', details.focusedValue)\n    }\n    const ctx = useCalendar(withXhConfig('calendar', props) as CalendarProps, notifyValue, notifyFocus)\n    provideCalendar(ctx)\n    // 网格与表头由作者照插槽里的 weeks / weekDays 自行渲染\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      focusedValue: ctx.api.value.focusedValue,\n      visibleMonth: ctx.api.value.visibleMonth,\n      weeks: ctx.api.value.weeks,\n      weekDays: ctx.api.value.weekDays,\n      headingLabel: ctx.api.value.headingLabel,\n      canGoPrev: ctx.api.value.canGoPrev,\n      canGoNext: ctx.api.value.canGoNext,\n      isSelected: ctx.api.value.isSelected,\n      isUnavailable: ctx.api.value.isUnavailable,\n      setValue: ctx.api.value.setValue,\n      select: ctx.api.value.select,\n      focus: ctx.api.value.focus,\n      goToPrevMonth: ctx.api.value.goToPrevMonth,\n      goToNextMonth: ctx.api.value.goToNextMonth,\n    }))\n  },\n})\n\nexport const XhCalendarHeader = defineComponent({\n  name: 'XhCalendarHeader',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    return () => h('div', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCalendarPrevTrigger = defineComponent({\n  name: 'XhCalendarPrevTrigger',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    return () => h('button', ctx.api.value.getPrevTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCalendarNextTrigger = defineComponent({\n  name: 'XhCalendarNextTrigger',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    return () => h('button', ctx.api.value.getNextTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCalendarHeading = defineComponent({\n  name: 'XhCalendarHeading',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    // 有插槽用插槽，否则渲染 headingLabel\n    return () => h(\n      'div',\n      ctx.api.value.getHeadingProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.headingLabel,\n    )\n  },\n})\n\nexport const XhCalendarGrid = defineComponent({\n  name: 'XhCalendarGrid',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    return () => h(\n      'div',\n      { ...ctx.api.value.getGridProps() as Record<string, unknown>, ref: ctx.gridRef },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhCalendarGridHead = defineComponent({\n  name: 'XhCalendarGridHead',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    return () => h('div', ctx.api.value.getGridHeadProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCalendarGridBody = defineComponent({\n  name: 'XhCalendarGridBody',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    return () => h('div', ctx.api.value.getGridBodyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 表头行与日期行共用同一个 role=row\nexport const XhCalendarWeekRow = defineComponent({\n  name: 'XhCalendarWeekRow',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    return () => h('div', ctx.api.value.getWeekRowProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCalendarWeekDay = defineComponent({\n  name: 'XhCalendarWeekDay',\n  props: {\n    // 列序 0-6，兼收字符串\n    value: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useCalendarContext()\n    const index = computed(() => Number(props.value))\n    return () => h(\n      'span',\n      ctx.api.value.getWeekDayProps({ value: index.value }) as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.weekDays[index.value]?.label,\n    )\n  },\n})\n\nexport const XhCalendarCell = defineComponent({\n  name: 'XhCalendarCell',\n  props: {\n    /** ISO 日期串。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useCalendarContext()\n    const cell = computed<CalendarCellProps>(() => ({ value: props.value }))\n    provideCalendarCell({ cell })\n    // 不上报格子卸载，翻月后由机器按聚焦日重新落点\n    return () => h('div', ctx.api.value.getCellProps(cell.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCalendarCellTrigger = defineComponent({\n  name: 'XhCalendarCellTrigger',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    const { cell } = useCalendarCellContext()\n    return () => h('div', ctx.api.value.getCellTriggerProps(cell.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"calendar.js","names":[],"sources":["../../../src/components/calendar/calendar.ts"],"sourcesContent":["import type { CalendarApi, CalendarCellProps, CalendarSchema, CalendarSelectionMode, CalendarWeekdayFormat } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideCalendar, provideCalendarCell, useCalendarCellContext, useCalendarContext } from './context'\nimport { useCalendar } from './use-calendar'\n\ntype CalendarProps = CalendarSchema['props']\n\n/** 默认插槽的载荷：选中值与聚焦日、展示月的日期矩阵与表头，以及选中、聚焦、翻月的动作。 */\nexport type CalendarRootSlotProps = Pick<\n  CalendarApi,\n  | 'value'\n  | 'focusedValue'\n  | 'visibleMonth'\n  | 'weeks'\n  | 'weekDays'\n  | 'headingLabel'\n  | 'canGoPrev'\n  | 'canGoNext'\n  | 'isSelected'\n  | 'isUnavailable'\n  | 'setValue'\n  | 'select'\n  | 'focus'\n  | 'goToPrevMonth'\n  | 'goToNextMonth'\n>\n\nexport const XhCalendarRoot = defineComponent({\n  name: 'XhCalendarRoot',\n  // 缺省值由 connect 与机器给出，这里一律 default: undefined\n  props: {\n    value: { type: [String, Array] as PropType<string | string[]>, default: undefined },\n    defaultValue: { type: [String, Array] as PropType<string | string[]>, default: undefined },\n    selectionMode: { type: String as PropType<CalendarSelectionMode>, default: undefined },\n    focusedValue: { type: String, default: undefined },\n    defaultFocusedValue: { type: String, default: undefined },\n    min: { type: String, default: undefined },\n    max: { type: String, default: undefined },\n    isDateUnavailable: { type: Function as PropType<(value: string) => boolean>, default: undefined },\n    locale: { type: String, default: undefined },\n    timeZone: { type: String, default: undefined },\n    disabled: Boolean,\n    readOnly: Boolean,\n    weekdayFormat: { type: String as PropType<CalendarWeekdayFormat>, default: undefined },\n    fixedWeeks: Boolean,\n  },\n  // *-change 携带 details 对象，update:* 携带裸值；选中值恒为数组，单选时长度 ≤ 1\n  emits: {\n    'value-change': (_details: PayloadOf<CalendarProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<CalendarProps, 'onValueChange'>['value']) => true,\n    'focused-value-change': (_details: PayloadOf<CalendarProps, 'onFocusedValueChange'>) => true,\n    'update:focusedValue': (_focusedValue: PayloadOf<CalendarProps, 'onFocusedValueChange'>['focusedValue']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: CalendarRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyValue: CalendarProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyFocus: CalendarProps['onFocusedValueChange'] = (details) => {\n      emit('focused-value-change', details)\n      emit('update:focusedValue', details.focusedValue)\n    }\n    const ctx = useCalendar(withXhConfig('calendar', props) as CalendarProps, notifyValue, notifyFocus)\n    provideCalendar(ctx)\n    // 网格与表头由作者照插槽里的 weeks / weekDays 自行渲染\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      focusedValue: ctx.api.value.focusedValue,\n      visibleMonth: ctx.api.value.visibleMonth,\n      weeks: ctx.api.value.weeks,\n      weekDays: ctx.api.value.weekDays,\n      headingLabel: ctx.api.value.headingLabel,\n      canGoPrev: ctx.api.value.canGoPrev,\n      canGoNext: ctx.api.value.canGoNext,\n      isSelected: ctx.api.value.isSelected,\n      isUnavailable: ctx.api.value.isUnavailable,\n      setValue: ctx.api.value.setValue,\n      select: ctx.api.value.select,\n      focus: ctx.api.value.focus,\n      goToPrevMonth: ctx.api.value.goToPrevMonth,\n      goToNextMonth: ctx.api.value.goToNextMonth,\n    }))\n  },\n})\n\nexport const XhCalendarHeader = defineComponent({\n  name: 'XhCalendarHeader',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    return () => h('div', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCalendarPrevTrigger = defineComponent({\n  name: 'XhCalendarPrevTrigger',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    return () => h('button', ctx.api.value.getPrevTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCalendarNextTrigger = defineComponent({\n  name: 'XhCalendarNextTrigger',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    return () => h('button', ctx.api.value.getNextTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCalendarHeading = defineComponent({\n  name: 'XhCalendarHeading',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    // 有插槽用插槽，否则渲染 headingLabel\n    return () => h(\n      'div',\n      ctx.api.value.getHeadingProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.headingLabel,\n    )\n  },\n})\n\nexport const XhCalendarGrid = defineComponent({\n  name: 'XhCalendarGrid',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    return () => h(\n      'div',\n      { ...ctx.api.value.getGridProps() as Record<string, unknown>, ref: ctx.gridRef },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhCalendarGridHead = defineComponent({\n  name: 'XhCalendarGridHead',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    return () => h('div', ctx.api.value.getGridHeadProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCalendarGridBody = defineComponent({\n  name: 'XhCalendarGridBody',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    return () => h('div', ctx.api.value.getGridBodyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 表头行与日期行共用同一个 role=row\nexport const XhCalendarWeekRow = defineComponent({\n  name: 'XhCalendarWeekRow',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    return () => h('div', ctx.api.value.getWeekRowProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCalendarWeekDay = defineComponent({\n  name: 'XhCalendarWeekDay',\n  props: {\n    // 列序 0-6，兼收字符串\n    value: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useCalendarContext()\n    const index = computed(() => Number(props.value))\n    return () => h(\n      'span',\n      ctx.api.value.getWeekDayProps({ value: index.value }) as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.weekDays[index.value]?.label,\n    )\n  },\n})\n\nexport const XhCalendarCell = defineComponent({\n  name: 'XhCalendarCell',\n  props: {\n    /** ISO 日期串。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useCalendarContext()\n    const cell = computed<CalendarCellProps>(() => ({ value: props.value }))\n    provideCalendarCell({ cell })\n    // 不上报格子卸载，翻月后由机器按聚焦日重新落点\n    return () => h('div', ctx.api.value.getCellProps(cell.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCalendarCellTrigger = defineComponent({\n  name: 'XhCalendarCellTrigger',\n  setup(_, { slots }) {\n    const ctx = useCalendarContext()\n    const { cell } = useCalendarCellContext()\n    return () => h('div', ctx.api.value.getCellTriggerProps(cell.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}

package/dist/components/carousel/carousel.d.ts

@@ -1,9 +1,11 @@
 import { PayloadOf } from "../../runtime/payload.js";
-import { PropType } from "vue";
-import { CarouselSchema, CarouselTranslations } from "@xihan-ui/headless";
+import { PropType, SlotsType, VNode } from "vue";
+import { CarouselApi, CarouselSchema, CarouselTranslations } from "@xihan-ui/headless";
 import { Direction, Orientation } from "@xihan-ui/kernel";
 //#region src/components/carousel/carousel.d.ts
 type CarouselProps = CarouselSchema['props'];
+/** 默认插槽的载荷：当前页与翻页区间、自动播放与拖拽状态，以及翻页、播放的命令。 */
+type CarouselRootSlotProps = Pick<CarouselApi, 'page' | 'totalPages' | 'slideCount' | 'slideRange' | 'pageSnapPoints' | 'canScrollPrev' | 'canScrollNext' | 'autoplaying' | 'paused' | 'dragging' | 'isInView' | 'setPage' | 'goToPrev' | 'goToNext' | 'play' | 'pause' | 'resume'>;
 declare const XhCarouselRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   page: {
     type: NumberConstructor;
@@ -53,7 +55,7 @@ declare const XhCarouselRoot: import("vue").DefineComponent<import("vue").Extrac
     type: PropType<Partial<CarouselTranslations>>;
     default: undefined;
   };
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   'page-change': (_details: PayloadOf<CarouselProps, "onPageChange">) => true;
@@ -116,18 +118,20 @@ declare const XhCarouselRoot: import("vue").DefineComponent<import("vue").Extrac
   dir: Direction;
   translations: Partial<CarouselTranslations>;
   page: number;
-  defaultPage: number;
   slideCount: number;
+  defaultPage: number;
   slidesPerPage: number;
   slidesPerMove: number;
   loop: boolean;
   allowPointerDrag: boolean;
   spacing: string;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhCarouselViewport: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}, SlotsType<{
+  default?: (props: CarouselRootSlotProps) => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCarouselViewport: 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 XhCarouselItemGroup: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCarouselItemGroup: 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 XhCarouselItem: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
@@ -135,7 +139,7 @@ declare const XhCarouselItem: import("vue").DefineComponent<import("vue").Extrac
     type: PropType<number | string>;
     required: true;
   };
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   index: {
@@ -143,13 +147,13 @@ declare const XhCarouselItem: import("vue").DefineComponent<import("vue").Extrac
     required: true;
   };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhCarouselPrevTrigger: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCarouselPrevTrigger: 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 XhCarouselNextTrigger: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCarouselNextTrigger: 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 XhCarouselIndicatorGroup: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCarouselIndicatorGroup: 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 XhCarouselIndicator: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
@@ -157,7 +161,7 @@ declare const XhCarouselIndicator: import("vue").DefineComponent<import("vue").E
     type: PropType<number | string>;
     required: true;
   };
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   index: {
@@ -166,5 +170,5 @@ declare const XhCarouselIndicator: import("vue").DefineComponent<import("vue").E
   };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { XhCarouselIndicator, XhCarouselIndicatorGroup, XhCarouselItem, XhCarouselItemGroup, XhCarouselNextTrigger, XhCarouselPrevTrigger, XhCarouselRoot, XhCarouselViewport };
+export { CarouselRootSlotProps, XhCarouselIndicator, XhCarouselIndicatorGroup, XhCarouselItem, XhCarouselItemGroup, XhCarouselNextTrigger, XhCarouselPrevTrigger, XhCarouselRoot, XhCarouselViewport };
 //# sourceMappingURL=carousel.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"carousel.d.ts","names":[],"sources":["../../../src/components/carousel/carousel.ts"],"mappings":";;;;;KASK,gBAAgB;cAER,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;;IASQ,MAAA,SAAS;;;;IACjB,MAAA,SAAS;;;;;;;;IAGO,MAAA;;;;;;;;;;;;IAGP,MAAA,SAAS,QAAQ;;;;;;EAIvB,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;IAZF,MAAA,SAAS;;;;IACjB,MAAA,SAAS;;;;;;;;IAGO,MAAA;;;;;;;;;;;;IAGP,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;;qCAkCnD;cAEW,kCAAkB,wCAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,wCAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,8BAAA;;IAIY,MAAA;;;;;;;IAAA,MAAA;;;MAUrC,oDAAA;cAEW,qCAAqB,wCAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,wCAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,wCAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,8BAAA;;IAIO,MAAA;;;;;;;IAAA,MAAA;;;MAUrC,oDAAA"}
+{"version":3,"file":"carousel.d.ts","names":[],"sources":["../../../src/components/carousel/carousel.ts"],"mappings":";;;;;KASK,gBAAgB;;KAGT,wBAAwB,KAClC;cAoBW,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;;IASQ,MAAA,SAAS;;;;IACjB,MAAA,SAAS;;;;;;;;IAGO,MAAA;;;;;;;;;;;;IAGP,MAAA,SAAS,QAAQ;;;;;;EAIvB,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;IAZF,MAAA,SAAS;;;;IACjB,MAAA,SAAS;;;;;;;;IAGO,MAAA;;;;;;;;;;;;IAGP,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;;;EAQvC,WAAC,OAAO,0BAA0B;kCA6B9C;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,8BAAA;;IAIY,MAAA;;;;;;;IAAA,MAAA;;;MAUrC,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,8BAAA;;IAIO,MAAA;;;;;;;IAAA,MAAA;;;MAUrC,oDAAA"}

package/dist/components/carousel/carousel.js

@@ -59,6 +59,7 @@ const XhCarouselRoot = defineComponent({
 		"page-change": (_details) => true,
 		"update:page": (_page) => true
 	},
+	slots: Object,
 	setup(props, { slots, emit }) {
 		const notify = (details) => {
 			emit("page-change", details);

package/dist/components/carousel/carousel.js.map

@@ -1 +1 @@
-{"version":3,"file":"carousel.js","names":[],"sources":["../../../src/components/carousel/carousel.ts"],"sourcesContent":["import type { CarouselSchema, CarouselTranslations } from '@xihan-ui/headless'\nimport type { Direction, Orientation } from '@xihan-ui/kernel'\nimport type { PropType } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideCarousel, useCarouselContext } from './context'\nimport { useCarousel } from './use-carousel'\n\ntype CarouselProps = CarouselSchema['props']\n\nexport const XhCarouselRoot = defineComponent({\n  name: 'XhCarouselRoot',\n  // 缺省值由 connect 给出，这里一律 default: undefined\n  props: {\n    page: { type: Number, default: undefined },\n    defaultPage: { type: Number, default: undefined },\n    slideCount: { type: Number, default: undefined },\n    slidesPerPage: { type: Number, default: undefined },\n    slidesPerMove: { type: Number, default: undefined },\n    orientation: { type: String as PropType<Orientation>, default: undefined },\n    dir: { type: String as PropType<Direction>, default: undefined },\n    loop: { type: Boolean, default: undefined },\n    // 布尔或毫秒：true 用默认间隔，数值即间隔\n    autoplay: { type: [Boolean, Number] as PropType<boolean | number>, default: undefined },\n    allowPointerDrag: { type: Boolean, default: undefined },\n    spacing: { type: String, default: undefined },\n    translations: { type: Object as PropType<Partial<CarouselTranslations>>, default: undefined },\n  },\n  // page-change 携带 { page }，update:page 携带裸页码\n  emits: {\n    'page-change': (_details: PayloadOf<CarouselProps, 'onPageChange'>) => true,\n    'update:page': (_page: PayloadOf<CarouselProps, 'onPageChange'>['page']) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: CarouselProps['onPageChange'] = (details) => {\n      emit('page-change', details)\n      emit('update:page', details.page)\n    }\n    const ctx = useCarousel(withXhConfig('carousel', props) as CarouselProps, notify)\n    provideCarousel(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      page: ctx.api.value.page,\n      totalPages: ctx.api.value.totalPages,\n      slideCount: ctx.api.value.slideCount,\n      slideRange: ctx.api.value.slideRange,\n      pageSnapPoints: ctx.api.value.pageSnapPoints,\n      canScrollPrev: ctx.api.value.canScrollPrev,\n      canScrollNext: ctx.api.value.canScrollNext,\n      autoplaying: ctx.api.value.autoplaying,\n      paused: ctx.api.value.paused,\n      dragging: ctx.api.value.dragging,\n      isInView: ctx.api.value.isInView,\n      setPage: ctx.api.value.setPage,\n      goToPrev: ctx.api.value.goToPrev,\n      goToNext: ctx.api.value.goToNext,\n      play: ctx.api.value.play,\n      pause: ctx.api.value.pause,\n      resume: ctx.api.value.resume,\n    }))\n  },\n})\n\nexport const XhCarouselViewport = defineComponent({\n  name: 'XhCarouselViewport',\n  setup(_, { slots }) {\n    const ctx = useCarouselContext()\n    return () => h('div', ctx.api.value.getViewportProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCarouselItemGroup = defineComponent({\n  name: 'XhCarouselItemGroup',\n  setup(_, { slots }) {\n    const ctx = useCarouselContext()\n    return () => h('div', ctx.api.value.getItemGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCarouselItem = defineComponent({\n  name: 'XhCarouselItem',\n  props: {\n    // 下标由作者声明，兼收字符串以支持模板里写 index=\"0\"\n    index: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useCarouselContext()\n    return () => h(\n      'div',\n      ctx.api.value.getItemProps({ index: Number(props.index) }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhCarouselPrevTrigger = defineComponent({\n  name: 'XhCarouselPrevTrigger',\n  setup(_, { slots }) {\n    const ctx = useCarouselContext()\n    return () => h('button', ctx.api.value.getPrevTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCarouselNextTrigger = defineComponent({\n  name: 'XhCarouselNextTrigger',\n  setup(_, { slots }) {\n    const ctx = useCarouselContext()\n    return () => h('button', ctx.api.value.getNextTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCarouselIndicatorGroup = defineComponent({\n  name: 'XhCarouselIndicatorGroup',\n  setup(_, { slots }) {\n    const ctx = useCarouselContext()\n    return () => h('div', ctx.api.value.getIndicatorGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCarouselIndicator = defineComponent({\n  name: 'XhCarouselIndicator',\n  props: {\n    // 指示点对应的页码，0 基；兼收字符串\n    index: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useCarouselContext()\n    return () => h(\n      'button',\n      ctx.api.value.getIndicatorProps({ index: Number(props.index) }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"carousel.js","names":[],"sources":["../../../src/components/carousel/carousel.ts"],"sourcesContent":["import type { CarouselApi, CarouselSchema, CarouselTranslations } from '@xihan-ui/headless'\nimport type { Direction, Orientation } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideCarousel, useCarouselContext } from './context'\nimport { useCarousel } from './use-carousel'\n\ntype CarouselProps = CarouselSchema['props']\n\n/** 默认插槽的载荷：当前页与翻页区间、自动播放与拖拽状态，以及翻页、播放的命令。 */\nexport type CarouselRootSlotProps = Pick<\n  CarouselApi,\n  | 'page'\n  | 'totalPages'\n  | 'slideCount'\n  | 'slideRange'\n  | 'pageSnapPoints'\n  | 'canScrollPrev'\n  | 'canScrollNext'\n  | 'autoplaying'\n  | 'paused'\n  | 'dragging'\n  | 'isInView'\n  | 'setPage'\n  | 'goToPrev'\n  | 'goToNext'\n  | 'play'\n  | 'pause'\n  | 'resume'\n>\n\nexport const XhCarouselRoot = defineComponent({\n  name: 'XhCarouselRoot',\n  // 缺省值由 connect 给出，这里一律 default: undefined\n  props: {\n    page: { type: Number, default: undefined },\n    defaultPage: { type: Number, default: undefined },\n    slideCount: { type: Number, default: undefined },\n    slidesPerPage: { type: Number, default: undefined },\n    slidesPerMove: { type: Number, default: undefined },\n    orientation: { type: String as PropType<Orientation>, default: undefined },\n    dir: { type: String as PropType<Direction>, default: undefined },\n    loop: { type: Boolean, default: undefined },\n    // 布尔或毫秒：true 用默认间隔，数值即间隔\n    autoplay: { type: [Boolean, Number] as PropType<boolean | number>, default: undefined },\n    allowPointerDrag: { type: Boolean, default: undefined },\n    spacing: { type: String, default: undefined },\n    translations: { type: Object as PropType<Partial<CarouselTranslations>>, default: undefined },\n  },\n  // page-change 携带 { page }，update:page 携带裸页码\n  emits: {\n    'page-change': (_details: PayloadOf<CarouselProps, 'onPageChange'>) => true,\n    'update:page': (_page: PayloadOf<CarouselProps, 'onPageChange'>['page']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: CarouselRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: CarouselProps['onPageChange'] = (details) => {\n      emit('page-change', details)\n      emit('update:page', details.page)\n    }\n    const ctx = useCarousel(withXhConfig('carousel', props) as CarouselProps, notify)\n    provideCarousel(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      page: ctx.api.value.page,\n      totalPages: ctx.api.value.totalPages,\n      slideCount: ctx.api.value.slideCount,\n      slideRange: ctx.api.value.slideRange,\n      pageSnapPoints: ctx.api.value.pageSnapPoints,\n      canScrollPrev: ctx.api.value.canScrollPrev,\n      canScrollNext: ctx.api.value.canScrollNext,\n      autoplaying: ctx.api.value.autoplaying,\n      paused: ctx.api.value.paused,\n      dragging: ctx.api.value.dragging,\n      isInView: ctx.api.value.isInView,\n      setPage: ctx.api.value.setPage,\n      goToPrev: ctx.api.value.goToPrev,\n      goToNext: ctx.api.value.goToNext,\n      play: ctx.api.value.play,\n      pause: ctx.api.value.pause,\n      resume: ctx.api.value.resume,\n    }))\n  },\n})\n\nexport const XhCarouselViewport = defineComponent({\n  name: 'XhCarouselViewport',\n  setup(_, { slots }) {\n    const ctx = useCarouselContext()\n    return () => h('div', ctx.api.value.getViewportProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCarouselItemGroup = defineComponent({\n  name: 'XhCarouselItemGroup',\n  setup(_, { slots }) {\n    const ctx = useCarouselContext()\n    return () => h('div', ctx.api.value.getItemGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCarouselItem = defineComponent({\n  name: 'XhCarouselItem',\n  props: {\n    // 下标由作者声明，兼收字符串以支持模板里写 index=\"0\"\n    index: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useCarouselContext()\n    return () => h(\n      'div',\n      ctx.api.value.getItemProps({ index: Number(props.index) }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhCarouselPrevTrigger = defineComponent({\n  name: 'XhCarouselPrevTrigger',\n  setup(_, { slots }) {\n    const ctx = useCarouselContext()\n    return () => h('button', ctx.api.value.getPrevTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCarouselNextTrigger = defineComponent({\n  name: 'XhCarouselNextTrigger',\n  setup(_, { slots }) {\n    const ctx = useCarouselContext()\n    return () => h('button', ctx.api.value.getNextTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCarouselIndicatorGroup = defineComponent({\n  name: 'XhCarouselIndicatorGroup',\n  setup(_, { slots }) {\n    const ctx = useCarouselContext()\n    return () => h('div', ctx.api.value.getIndicatorGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCarouselIndicator = defineComponent({\n  name: 'XhCarouselIndicator',\n  props: {\n    // 指示点对应的页码，0 基；兼收字符串\n    index: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useCarouselContext()\n    return () => h(\n      'button',\n      ctx.api.value.getIndicatorProps({ index: Number(props.index) }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":"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"}