@xihan-ui/vue 2.1.0 → 3.1.0

package/dist/components/context-menu/use-context-menu.js

@@ -8,7 +8,7 @@ import { createRuntimeConfig, createScope } from "@xihan-ui/core";
 import { connectContextMenu, contextMenuMachine, createMenuTreeNode } from "@xihan-ui/headless";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/context-menu/use-context-menu.ts
-function useContextMenu(props, onOpenChange, onSelect) {
+function useContextMenu(props, onOpenChange, onSelect, onCheckboxValueChange, onRadioValueChange) {
 	const xhConfig = useXhConfig();
 	const triggerRef = ref(null);
 	const positionerRef = ref(null);
@@ -26,7 +26,9 @@ function useContextMenu(props, onOpenChange, onSelect) {
 	service = useMachine(contextMenuMachine, () => ({
 		...props,
 		onOpenChange,
-		onSelect
+		onSelect,
+		onCheckboxValueChange,
+		onRadioValueChange
 	}), scope);
 	let config = null;
 	if (typeof document !== "undefined") {

package/dist/components/context-menu/use-context-menu.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-context-menu.js","names":[],"sources":["../../../src/components/context-menu/use-context-menu.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use context menu 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { ContextMenuApi, ContextMenuSchema, MenuTreeNode } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectContextMenu, contextMenuMachine, createMenuTreeNode } from '@xihan-ui/headless'\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\nexport interface ContextMenuContext {\n  service: Service<ContextMenuSchema>\n  api: ComputedRef<ContextMenuApi>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 子菜单经 Portal 分离后的逻辑父节点。 */\n  tree: MenuTreeNode\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useContextMenu(\n  props: ContextMenuSchema['props'],\n  onOpenChange?: ContextMenuSchema['props']['onOpenChange'],\n  onSelect?: ContextMenuSchema['props']['onSelect'],\n): ContextMenuContext {\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  const scope = createScope(null, idGen)\n  let service: Service<ContextMenuSchema> | null = null\n  const tree = createMenuTreeNode({\n    getPositioner: () => positionerRef.value,\n    isOpen: () => service?.state.get() === 'open',\n    close: () => service?.send({ type: 'CLOSE' }),\n    isRoot: () => true,\n    onRootSelect: details => onSelect?.(details),\n  })\n  service = useMachine(contextMenuMachine, () => ({ ...props, onOpenChange, onSelect }), 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    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // 触发区记为本层分支，展开着再右键可就地换坐标；左键关闭由 connect 在 pointerdown 上收口。\n      // 浮层壳一并记上：条目列表之外还浮着自绘滚动条，按住它拖动不该把菜单消解掉\n      branches: () => [triggerRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动；锚点是光标坐标，故无 getAnchorEl\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    // 触发区兼作两用：收起时焦点归还它，没有光标坐标时它的起始角就是锚点\n    service.refs.set('getTriggerEl', () => triggerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectContextMenu(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 先问全局配置的落点，没有才落 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, service, api, triggerRef, positionerRef, contentRef, tree, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAkCA,SAAgB,eACd,OACA,cACA,UACoB;CACpB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,IAAI,UAA6C;CACjD,MAAM,OAAO,mBAAmB;EAC9B,qBAAqB,cAAc;EACnC,cAAc,SAAS,MAAM,IAAI,MAAM;EACvC,aAAa,SAAS,KAAK,EAAE,MAAM,QAAQ,CAAC;EAC5C,cAAc;EACd,eAAc,YAAW,WAAW,OAAO;CAC7C,CAAC;CACD,UAAU,WAAW,2BAA2B;EAAE,GAAG;EAAO;EAAc;CAAS,IAAI,KAAK;CAG5F,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;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,uBAAuB,cAAc,KAAK;EAE3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAEA,MAAM,MAAM,eAAe,mBAAmB,SAAS,YAAY,CAAC;CAEpE,MAAM,UAAU,eAAe;EAC7B;EACA,cAAc,IAAI,MAAM;EACxB;EACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;CAC/D,CAAC;CAED,MAAM,eAAe,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAAM;CAE/H,OAAO;EAAE;EAAS;EAAS;EAAK;EAAY;EAAe;EAAY;EAAM;CAAa;AAC5F"}
+{"version":3,"file":"use-context-menu.js","names":[],"sources":["../../../src/components/context-menu/use-context-menu.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use context menu 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { ContextMenuApi, ContextMenuSchema, MenuTreeNode } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectContextMenu, contextMenuMachine, createMenuTreeNode } from '@xihan-ui/headless'\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\nexport interface ContextMenuContext {\n  service: Service<ContextMenuSchema>\n  api: ComputedRef<ContextMenuApi>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 子菜单经 Portal 分离后的逻辑父节点。 */\n  tree: MenuTreeNode\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useContextMenu(\n  props: ContextMenuSchema['props'],\n  onOpenChange?: ContextMenuSchema['props']['onOpenChange'],\n  onSelect?: ContextMenuSchema['props']['onSelect'],\n  onCheckboxValueChange?: ContextMenuSchema['props']['onCheckboxValueChange'],\n  onRadioValueChange?: ContextMenuSchema['props']['onRadioValueChange'],\n): ContextMenuContext {\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  const scope = createScope(null, idGen)\n  let service: Service<ContextMenuSchema> | null = null\n  const tree = createMenuTreeNode({\n    getPositioner: () => positionerRef.value,\n    isOpen: () => service?.state.get() === 'open',\n    close: () => service?.send({ type: 'CLOSE' }),\n    isRoot: () => true,\n    onRootSelect: details => onSelect?.(details),\n  })\n  service = useMachine(contextMenuMachine, () => ({ ...props, onOpenChange, onSelect, onCheckboxValueChange, onRadioValueChange }), 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    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // 触发区记为本层分支，展开着再右键可就地换坐标；左键关闭由 connect 在 pointerdown 上收口。\n      // 浮层壳一并记上：条目列表之外还浮着自绘滚动条，按住它拖动不该把菜单消解掉\n      branches: () => [triggerRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动；锚点是光标坐标，故无 getAnchorEl\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    // 触发区兼作两用：收起时焦点归还它，没有光标坐标时它的起始角就是锚点\n    service.refs.set('getTriggerEl', () => triggerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectContextMenu(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 先问全局配置的落点，没有才落 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, service, api, triggerRef, positionerRef, contentRef, tree, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAkCA,SAAgB,eACd,OACA,cACA,UACA,uBACA,oBACoB;CACpB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,IAAI,UAA6C;CACjD,MAAM,OAAO,mBAAmB;EAC9B,qBAAqB,cAAc;EACnC,cAAc,SAAS,MAAM,IAAI,MAAM;EACvC,aAAa,SAAS,KAAK,EAAE,MAAM,QAAQ,CAAC;EAC5C,cAAc;EACd,eAAc,YAAW,WAAW,OAAO;CAC7C,CAAC;CACD,UAAU,WAAW,2BAA2B;EAAE,GAAG;EAAO;EAAc;EAAU;EAAuB;CAAmB,IAAI,KAAK;CAGvI,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;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,uBAAuB,cAAc,KAAK;EAE3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAEA,MAAM,MAAM,eAAe,mBAAmB,SAAS,YAAY,CAAC;CAEpE,MAAM,UAAU,eAAe;EAC7B;EACA,cAAc,IAAI,MAAM;EACxB;EACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;CAC/D,CAAC;CAED,MAAM,eAAe,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAAM;CAE/H,OAAO;EAAE;EAAS;EAAS;EAAK;EAAY;EAAe;EAAY;EAAM;CAAa;AAC5F"}

package/dist/components/date-field/date-field.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Size, Tone } from "@xihan-ui/core";
-import { DateFieldApi, DateFieldSchema, DateFieldSegmentState, DateFieldTranslations, DateGranularity, DateSegmentSet, DateSegmentType } from "@xihan-ui/headless";
+import { DateFieldApi, DateFieldSchema, DateFieldSegmentState, DateFieldTranslations, DateGranularity, DateHourCycle, DateSegmentSet, DateSegmentType } from "@xihan-ui/headless";
 //#region src/components/date-field/date-field.d.ts
 type DateFieldProps = DateFieldSchema['props'];
 type SegmentTexts = { readonly [K in DateSegmentType]?: string; };
@@ -33,6 +33,10 @@ declare const XhDateFieldRoot: import("vue").DefineComponent<import("vue").Extra
   granularity: {
     type: PropType<DateGranularity>;
   };
+  /** 时刻段的小时制，默认 24；12 时小时段收 1-12 并多出上下午段。 */
+  hourCycle: {
+    type: PropType<DateHourCycle>;
+  };
   segments: {
     type: PropType<DateSegmentSet>;
   };
@@ -55,8 +59,9 @@ declare const XhDateFieldRoot: import("vue").DefineComponent<import("vue").Extra
   name: {
     type: StringConstructor;
   };
+  /** 占位。字符串是整条占位：一段都没填、焦点也不在段上时输入行显示这句文字，焦点进到段上即换回段位；对象是逐段的占位串，覆盖内置的 yyyy / mm / dd。 */
   placeholder: {
-    type: PropType<SegmentTexts>;
+    type: PropType<string | SegmentTexts>;
   };
   translations: {
     type: PropType<DateFieldTranslations>;
@@ -73,6 +78,7 @@ declare const XhDateFieldRoot: import("vue").DefineComponent<import("vue").Extra
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  clear: () => true;
   'value-change': (_details: PayloadOf<DateFieldProps, "onValueChange">) => true;
   'update:value': (_value: PayloadOf<DateFieldProps, "onValueChange">["value"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -97,6 +103,10 @@ declare const XhDateFieldRoot: import("vue").DefineComponent<import("vue").Extra
   granularity: {
     type: PropType<DateGranularity>;
   };
+  /** 时刻段的小时制，默认 24；12 时小时段收 1-12 并多出上下午段。 */
+  hourCycle: {
+    type: PropType<DateHourCycle>;
+  };
   segments: {
     type: PropType<DateSegmentSet>;
   };
@@ -119,8 +129,9 @@ declare const XhDateFieldRoot: import("vue").DefineComponent<import("vue").Extra
   name: {
     type: StringConstructor;
   };
+  /** 占位。字符串是整条占位：一段都没填、焦点也不在段上时输入行显示这句文字，焦点进到段上即换回段位；对象是逐段的占位串，覆盖内置的 yyyy / mm / dd。 */
   placeholder: {
-    type: PropType<SegmentTexts>;
+    type: PropType<string | SegmentTexts>;
   };
   translations: {
     type: PropType<DateFieldTranslations>;
@@ -137,6 +148,7 @@ declare const XhDateFieldRoot: import("vue").DefineComponent<import("vue").Extra
 }>> & Readonly<{
   "onValue-change"?: ((_details: import("@xihan-ui/headless").DateFieldValueChangeDetails) => any) | undefined;
   "onUpdate:value"?: ((_value: string | null) => any) | undefined;
+  onClear?: (() => any) | undefined;
 }>, {
   required: boolean;
   invalid: boolean;

package/dist/components/date-field/date-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date-field.d.ts","names":[],"sources":["../../../src/components/date-field/date-field.ts"],"mappings":";;;;;KAiBK,iBAAiB;KACjB,2BAA2B,KAAK;;KAGzB,yBAAyB,KACnC;;UAce;EACf,SAAS;;cAGE,+BAAe,8BAAA;;IAIC,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;IAKD,MAAA,SAAS;;;IAEb,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;IAML,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAIN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IAvBV,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;IAKD,MAAA,SAAS;;;IAEb,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;IAML,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;EAQvB,WAAC,OAAO,2BAA2B;kCAsB/C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;IAIQ,MAAA;;;;IAER,MAAA,SAAS;;;;;;IAFD,MAAA;;;;IAER,MAAA,SAAS;;;EAG1B,WAAC,OAAO,8BAA8B;kCAmBlD;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"date-field.d.ts","names":[],"sources":["../../../src/components/date-field/date-field.ts"],"mappings":";;;;;KAkBK,iBAAiB;KACjB,2BAA2B,KAAK;;KAGzB,yBAAyB,KACnC;;UAce;EACf,SAAS;;cAGE,+BAAe,8BAAA;;IAIC,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;IAKD,MAAA,SAAS;;;;IAEX,MAAA,SAAS;;;IAEX,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;IAOK,MAAA,kBAAkB;;;IAC3B,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;EAKN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IA3BV,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;IAKD,MAAA,SAAS;;;;IAEX,MAAA,SAAS;;;IAEX,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;IAOK,MAAA,kBAAkB;;;IAC3B,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;EASvB,WAAC,OAAO,2BAA2B;kCAsB/C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;IAIQ,MAAA;;;;IAER,MAAA,SAAS;;;;;;IAFD,MAAA;;;;IAER,MAAA,SAAS;;;EAG1B,WAAC,OAAO,8BAA8B;kCAmBlD;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/date-field/date-field.js

@@ -1,4 +1,5 @@
 import { withXhConfig } from "../../config/config.js";
+import { withHandlers } from "../../runtime/with-handlers.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { provideDateField, useDateFieldContext } from "./context.js";
 import { useDateField } from "./use-date-field.js";
@@ -14,6 +15,8 @@ const XhDateFieldRoot = defineComponent({
 		locale: { type: String },
 		timeZone: { type: String },
 		granularity: { type: String },
+		/** 时刻段的小时制，默认 24；12 时小时段收 1-12 并多出上下午段。 */
+		hourCycle: { type: Number },
 		segments: { type: Array },
 		disabled: {
 			type: Boolean,
@@ -32,13 +35,15 @@ const XhDateFieldRoot = defineComponent({
 			default: void 0
 		},
 		name: { type: String },
-		placeholder: { type: Object },
+		/** 占位。字符串是整条占位：一段都没填、焦点也不在段上时输入行显示这句文字，焦点进到段上即换回段位；对象是逐段的占位串，覆盖内置的 yyyy / mm / dd。 */
+		placeholder: { type: [String, Object] },
 		translations: { type: Object },
 		variant: { type: String },
 		tone: { type: String },
 		size: { type: String }
 	},
 	emits: {
+		"clear": () => true,
 		"value-change": (_details) => true,
 		"update:value": (_value) => true
 	},
@@ -48,7 +53,7 @@ const XhDateFieldRoot = defineComponent({
 			emit("value-change", details);
 			emit("update:value", details.value);
 		};
-		const ctx = useDateField(withXhConfig("date-field", useFormControlProps(props)), { onValueChange });
+		const ctx = useDateField(withHandlers(withXhConfig("date-field", useFormControlProps(props)), { onClear: () => emit("clear") }), { onValueChange });
 		provideDateField(ctx);
 		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
 			value: ctx.api.value.value,

package/dist/components/date-field/date-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"date-field.js","names":[],"sources":["../../../src/components/date-field/date-field.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 date field 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { DateFieldApi, DateFieldSchema, DateFieldSegmentState, DateFieldTranslations, DateGranularity, DateSegmentSet, DateSegmentType } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideDateField, useDateFieldContext } from './context'\nimport { useDateField } from './use-date-field'\n\ntype DateFieldProps = DateFieldSchema['props']\ntype SegmentTexts = { readonly [K in DateSegmentType]?: string }\n\n/** 默认插槽的载荷：整份值、逐段投影、填写状态，以及改写与清空的句柄。 */\nexport type DateFieldRootSlotProps = Pick<\n  DateFieldApi,\n  | 'value'\n  | 'valueAsDate'\n  | 'segments'\n  | 'complete'\n  | 'empty'\n  | 'outOfRange'\n  | 'focusedSegment'\n  | 'setValue'\n  | 'clear'\n  | 'canClear'\n>\n\n/** 段位默认插槽的载荷：本段的投影；下标越界时缺席。 */\nexport interface DateFieldSegmentSlotProps {\n  segment: DateFieldSegmentState | undefined\n}\n\nexport const XhDateFieldRoot = defineComponent({\n  name: 'XhDateFieldRoot',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    value: { type: String as PropType<string | null> },\n    defaultValue: { type: String as PropType<string | null> },\n    min: { type: String },\n    max: { type: String },\n    locale: { type: String },\n    timeZone: { type: String },\n    granularity: { type: String as PropType<DateGranularity> },\n    // 段集：给了就以它为准，granularity 让路。段位节点仍按下标认段，段集是有序的\n    segments: { type: Array as PropType<DateSegmentSet> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    name: { type: String },\n    placeholder: { type: Object as PropType<SegmentTexts> },\n    translations: { type: Object as PropType<DateFieldTranslations> },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // value-change 携带 { value }，update:value 携带裸串\n  emits: {\n    'value-change': (_details: PayloadOf<DateFieldProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<DateFieldProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DateFieldRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onValueChange: DateFieldProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useDateField(withXhConfig('date-field', useFormControlProps(props)) as DateFieldProps, { onValueChange })\n    provideDateField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      valueAsDate: ctx.api.value.valueAsDate,\n      segments: ctx.api.value.segments,\n      complete: ctx.api.value.complete,\n      empty: ctx.api.value.empty,\n      outOfRange: ctx.api.value.outOfRange,\n      focusedSegment: ctx.api.value.focusedSegment,\n      setValue: ctx.api.value.setValue,\n      clear: ctx.api.value.clear,\n      canClear: ctx.api.value.canClear,\n    }))\n  },\n})\n\nexport const XhDateFieldLabel = defineComponent({\n  name: 'XhDateFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useDateFieldContext()\n    // 渲染为 span 而非 label，段位不是可被 for 标注的控件；点标题聚焦由连接层接管\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDateFieldControl = defineComponent({\n  name: 'XhDateFieldControl',\n  setup(_, { slots }) {\n    const ctx = useDateFieldContext()\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDateFieldSegmentGroup = defineComponent({\n  name: 'XhDateFieldSegmentGroup',\n  setup(_, { slots }) {\n    const ctx = useDateFieldContext()\n    return () => h('div', ctx.api.value.getSegmentGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDateFieldSegment = defineComponent({\n  name: 'XhDateFieldSegment',\n  props: {\n    // 下标由作者声明，是哪一段由 locale 与段集算出；兼收字符串\n    index: { type: [Number, String] as PropType<number | string> },\n    /** 按段名声明该格。段集中没有该段时它收起；与 index 二选一，两个都写时按段名计算。 */\n    segment: { type: String as PropType<DateSegmentType> },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DateFieldSegmentSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const ctx = useDateFieldContext()\n    return () => {\n      const api = ctx.api.value\n      // 落点由连接层算：按下标还是按段名是同一条路，适配器这边不重写一份\n      const declared = props.segment != null\n        ? { segment: props.segment }\n        : { index: Math.trunc(Number(props.index)) }\n      const state = api.segmentOf(declared)\n      // 有插槽用插槽，否则渲染连接层算好的段位文本\n      return h(\n        'div',\n        api.getSegmentProps(declared) as Record<string, unknown>,\n        slots.default ? slots.default({ segment: state }) : state?.text,\n      )\n    }\n  },\n})\n\nexport const XhDateFieldClearTrigger = defineComponent({\n  name: 'XhDateFieldClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useDateFieldContext()\n    // 没有默认插槽时由皮肤画兜底字形\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDateFieldHiddenInput = defineComponent({\n  name: 'XhDateFieldHiddenInput',\n  setup() {\n    const ctx = useDateFieldContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"date-field.js","names":[],"sources":["../../../src/components/date-field/date-field.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 date field 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { DateFieldApi, DateFieldSchema, DateFieldSegmentState, DateFieldTranslations, DateGranularity, DateHourCycle, DateSegmentSet, DateSegmentType } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideDateField, useDateFieldContext } from './context'\nimport { useDateField } from './use-date-field'\n\ntype DateFieldProps = DateFieldSchema['props']\ntype SegmentTexts = { readonly [K in DateSegmentType]?: string }\n\n/** 默认插槽的载荷：整份值、逐段投影、填写状态，以及改写与清空的句柄。 */\nexport type DateFieldRootSlotProps = Pick<\n  DateFieldApi,\n  | 'value'\n  | 'valueAsDate'\n  | 'segments'\n  | 'complete'\n  | 'empty'\n  | 'outOfRange'\n  | 'focusedSegment'\n  | 'setValue'\n  | 'clear'\n  | 'canClear'\n>\n\n/** 段位默认插槽的载荷：本段的投影；下标越界时缺席。 */\nexport interface DateFieldSegmentSlotProps {\n  segment: DateFieldSegmentState | undefined\n}\n\nexport const XhDateFieldRoot = defineComponent({\n  name: 'XhDateFieldRoot',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    value: { type: String as PropType<string | null> },\n    defaultValue: { type: String as PropType<string | null> },\n    min: { type: String },\n    max: { type: String },\n    locale: { type: String },\n    timeZone: { type: String },\n    granularity: { type: String as PropType<DateGranularity> },\n    /** 时刻段的小时制，默认 24；12 时小时段收 1-12 并多出上下午段。 */\n    hourCycle: { type: Number as PropType<DateHourCycle> },\n    // 段集：给了就以它为准，granularity 让路。段位节点仍按下标认段，段集是有序的\n    segments: { type: Array as PropType<DateSegmentSet> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    name: { type: String },\n    /** 占位。字符串是整条占位：一段都没填、焦点也不在段上时输入行显示这句文字，焦点进到段上即换回段位；对象是逐段的占位串，覆盖内置的 yyyy / mm / dd。 */\n    placeholder: { type: [String, Object] as PropType<string | SegmentTexts> },\n    translations: { type: Object as PropType<DateFieldTranslations> },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // value-change 携带 { value }，update:value 携带裸串\n  emits: {\n    'clear': () => true,\n    'value-change': (_details: PayloadOf<DateFieldProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<DateFieldProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DateFieldRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onValueChange: DateFieldProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useDateField(withHandlers(withXhConfig('date-field', useFormControlProps(props)), { onClear: () => emit('clear') }) as DateFieldProps, { onValueChange })\n    provideDateField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      valueAsDate: ctx.api.value.valueAsDate,\n      segments: ctx.api.value.segments,\n      complete: ctx.api.value.complete,\n      empty: ctx.api.value.empty,\n      outOfRange: ctx.api.value.outOfRange,\n      focusedSegment: ctx.api.value.focusedSegment,\n      setValue: ctx.api.value.setValue,\n      clear: ctx.api.value.clear,\n      canClear: ctx.api.value.canClear,\n    }))\n  },\n})\n\nexport const XhDateFieldLabel = defineComponent({\n  name: 'XhDateFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useDateFieldContext()\n    // 渲染为 span 而非 label，段位不是可被 for 标注的控件；点标题聚焦由连接层接管\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDateFieldControl = defineComponent({\n  name: 'XhDateFieldControl',\n  setup(_, { slots }) {\n    const ctx = useDateFieldContext()\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDateFieldSegmentGroup = defineComponent({\n  name: 'XhDateFieldSegmentGroup',\n  setup(_, { slots }) {\n    const ctx = useDateFieldContext()\n    return () => h('div', ctx.api.value.getSegmentGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDateFieldSegment = defineComponent({\n  name: 'XhDateFieldSegment',\n  props: {\n    // 下标由作者声明，是哪一段由 locale 与段集算出；兼收字符串\n    index: { type: [Number, String] as PropType<number | string> },\n    /** 按段名声明该格。段集中没有该段时它收起；与 index 二选一，两个都写时按段名计算。 */\n    segment: { type: String as PropType<DateSegmentType> },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DateFieldSegmentSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const ctx = useDateFieldContext()\n    return () => {\n      const api = ctx.api.value\n      // 落点由连接层算：按下标还是按段名是同一条路，适配器这边不重写一份\n      const declared = props.segment != null\n        ? { segment: props.segment }\n        : { index: Math.trunc(Number(props.index)) }\n      const state = api.segmentOf(declared)\n      // 有插槽用插槽，否则渲染连接层算好的段位文本\n      return h(\n        'div',\n        api.getSegmentProps(declared) as Record<string, unknown>,\n        slots.default ? slots.default({ segment: state }) : state?.text,\n      )\n    }\n  },\n})\n\nexport const XhDateFieldClearTrigger = defineComponent({\n  name: 'XhDateFieldClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useDateFieldContext()\n    // 没有默认插槽时由皮肤画兜底字形\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDateFieldHiddenInput = defineComponent({\n  name: 'XhDateFieldHiddenInput',\n  setup() {\n    const ctx = useDateFieldContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}

package/dist/components/date-picker/context.js

@@ -21,6 +21,15 @@ function useDatePickerCellContext() {
 	if (!ctx) throw new Error("[xh] DatePicker 日期触发器必须用在 XhDatePickerCell 内");
 	return ctx;
 }
+const TAG_KEY = Symbol.for("xh-date-picker-tag");
+function provideDatePickerTag(ctx) {
+	provide(TAG_KEY, ctx);
+}
+function useDatePickerTagContext() {
+	const ctx = inject(TAG_KEY, null);
+	if (!ctx) throw new Error("[xh] DatePicker 标签子部件必须用在 XhDatePickerTag 内");
+	return ctx;
+}
 function provideDatePickerPanel(ctx) {
 	provide(PANEL_KEY, ctx);
 }
@@ -28,6 +37,6 @@ function useDatePickerPanelContext() {
 	return inject(PANEL_KEY, FIRST_PANEL);
 }
 //#endregion
-export { provideDatePicker, provideDatePickerCell, provideDatePickerPanel, useDatePickerCellContext, useDatePickerContext, useDatePickerPanelContext };
+export { provideDatePicker, provideDatePickerCell, provideDatePickerPanel, provideDatePickerTag, useDatePickerCellContext, useDatePickerContext, useDatePickerPanelContext, useDatePickerTagContext };
 
 //# sourceMappingURL=context.js.map

package/dist/components/date-picker/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/date-picker/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { CalendarCellProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { DatePickerContext } from './use-date-picker'\nimport { computed, inject, provide } from 'vue'\n\n/** 格子声明的那一天，供 cell-trigger 复用同一份声明（作者只写一次 value）。 */\nexport interface DatePickerCellContext {\n  cell: ComputedRef<CalendarCellProps>\n}\n\n/** 日历声明的面板号，供面板内的标题、网格与格子认领自己属于并排的第几张。 */\nexport interface DatePickerPanelContext {\n  index: ComputedRef<number>\n}\n\nconst KEY: InjectionKey<DatePickerContext> = Symbol.for('xh-date-picker')\nconst CELL_KEY: InjectionKey<DatePickerCellContext> = Symbol.for('xh-date-picker-cell')\nconst PANEL_KEY: InjectionKey<DatePickerPanelContext> = Symbol.for('xh-date-picker-panel')\n\n/** 日历未声明面板号时的落点，与单面板时一致。 */\nconst FIRST_PANEL: DatePickerPanelContext = { index: computed(() => 0) }\n\nexport function provideDatePicker(ctx: DatePickerContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useDatePickerContext(): DatePickerContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] DatePicker 部件必须用在 XhDatePickerRoot 内')\n  return ctx\n}\n\nexport function provideDatePickerCell(ctx: DatePickerCellContext): void {\n  provide(CELL_KEY, ctx)\n}\n\nexport function useDatePickerCellContext(): DatePickerCellContext {\n  const ctx = inject(CELL_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] DatePicker 日期触发器必须用在 XhDatePickerCell 内')\n  return ctx\n}\n\nexport function provideDatePickerPanel(ctx: DatePickerPanelContext): void {\n  provide(PANEL_KEY, ctx)\n}\n\nexport function useDatePickerPanelContext(): DatePickerPanelContext {\n  return inject(PANEL_KEY, FIRST_PANEL)\n}\n"],"mappings":";;AAsBA,MAAM,MAAuC,OAAO,IAAI,gBAAgB;AACxE,MAAM,WAAgD,OAAO,IAAI,qBAAqB;AACtF,MAAM,YAAkD,OAAO,IAAI,sBAAsB;;AAGzF,MAAM,cAAsC,EAAE,OAAO,eAAe,CAAC,EAAE;AAEvE,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;AAEA,SAAgB,uBAAuB,KAAmC;CACxE,QAAQ,WAAW,GAAG;AACxB;AAEA,SAAgB,4BAAoD;CAClE,OAAO,OAAO,WAAW,WAAW;AACtC"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/date-picker/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { CalendarCellProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { DatePickerContext } from './use-date-picker'\nimport { computed, inject, provide } from 'vue'\n\n/** 格子声明的那一天，供 cell-trigger 复用同一份声明（作者只写一次 value）。 */\nexport interface DatePickerCellContext {\n  cell: ComputedRef<CalendarCellProps>\n}\n\n/** 日历声明的面板号，供面板内的标题、网格与格子认领自己属于并排的第几张。 */\nexport interface DatePickerPanelContext {\n  index: ComputedRef<number>\n}\n\nconst KEY: InjectionKey<DatePickerContext> = Symbol.for('xh-date-picker')\nconst CELL_KEY: InjectionKey<DatePickerCellContext> = Symbol.for('xh-date-picker-cell')\nconst PANEL_KEY: InjectionKey<DatePickerPanelContext> = Symbol.for('xh-date-picker-panel')\n\n/** 日历未声明面板号时的落点，与单面板时一致。 */\nconst FIRST_PANEL: DatePickerPanelContext = { index: computed(() => 0) }\n\nexport function provideDatePicker(ctx: DatePickerContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useDatePickerContext(): DatePickerContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] DatePicker 部件必须用在 XhDatePickerRoot 内')\n  return ctx\n}\n\nexport function provideDatePickerCell(ctx: DatePickerCellContext): void {\n  provide(CELL_KEY, ctx)\n}\n\nexport function useDatePickerCellContext(): DatePickerCellContext {\n  const ctx = inject(CELL_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] DatePicker 日期触发器必须用在 XhDatePickerCell 内')\n  return ctx\n}\n\n/** 标签声明的值，供标签中的删除按钮复用同一份声明。 */\nexport interface DatePickerTagContext {\n  value: () => string\n}\n\nconst TAG_KEY: InjectionKey<DatePickerTagContext> = Symbol.for('xh-date-picker-tag')\n\nexport function provideDatePickerTag(ctx: DatePickerTagContext): void {\n  provide(TAG_KEY, ctx)\n}\n\nexport function useDatePickerTagContext(): DatePickerTagContext {\n  const ctx = inject(TAG_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] DatePicker 标签子部件必须用在 XhDatePickerTag 内')\n  return ctx\n}\n\nexport function provideDatePickerPanel(ctx: DatePickerPanelContext): void {\n  provide(PANEL_KEY, ctx)\n}\n\nexport function useDatePickerPanelContext(): DatePickerPanelContext {\n  return inject(PANEL_KEY, FIRST_PANEL)\n}\n"],"mappings":";;AAsBA,MAAM,MAAuC,OAAO,IAAI,gBAAgB;AACxE,MAAM,WAAgD,OAAO,IAAI,qBAAqB;AACtF,MAAM,YAAkD,OAAO,IAAI,sBAAsB;;AAGzF,MAAM,cAAsC,EAAE,OAAO,eAAe,CAAC,EAAE;AAEvE,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;AAOA,MAAM,UAA8C,OAAO,IAAI,oBAAoB;AAEnF,SAAgB,qBAAqB,KAAiC;CACpE,QAAQ,SAAS,GAAG;AACtB;AAEA,SAAgB,0BAAgD;CAC9D,MAAM,MAAM,OAAO,SAAS,IAAI;CAChC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,6CAA6C;CAC/D,OAAO;AACT;AAEA,SAAgB,uBAAuB,KAAmC;CACxE,QAAQ,WAAW,GAAG;AACxB;AAEA,SAAgB,4BAAoD;CAClE,OAAO,OAAO,WAAW,WAAW;AACtC"}

package/dist/components/date-picker/date-picker.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Direction, Placement, Size, Tone } from "@xihan-ui/core";
-import { CalendarGranularity, CalendarPickerApi, CalendarPickerSelectionMode, CalendarView, DateFieldSegmentState, DatePickerApi, DatePickerPreset, DatePickerPresetState, DatePickerSchema, DateSegmentSet, DateSegmentType } from "@xihan-ui/headless";
+import { CalendarGranularity, CalendarPickerApi, CalendarPickerSelectionMode, CalendarView, DateFieldSegmentState, DatePickerApi, DatePickerPreset, DatePickerPresetState, DatePickerSchema, DateSegmentPlaceholders, DateSegmentSet, DateSegmentType, TimeHourCycle, TimeStep, TimeUnavailablePredicate } from "@xihan-ui/headless";
 //#region src/components/date-picker/date-picker.d.ts
 type DatePickerProps = DatePickerSchema['props'];
 /** 默认插槽的载荷：选择器的开合与选中值、内嵌日历的展示数据、段位，以及改写值的句柄。 */
@@ -37,12 +37,24 @@ declare const XhDatePickerRoot: import("vue").DefineComponent<import("vue").Extr
   locale: {
     type: StringConstructor;
   };
+  /** 周首日，0 = 星期日 … 6 = 星期六；不给按 locale。只改日历的表头、行首与 Home / End，月份名与星期名仍按 locale。 */
+  firstDayOfWeek: {
+    type: NumberConstructor;
+  };
   timeZone: {
     type: StringConstructor;
   };
   selectionMode: {
     type: PropType<CalendarPickerSelectionMode>;
   };
+  /** multiple 下最多选几个周期；选满后日历里没选中的格子不可再加选，已选的仍可点掉。 */
+  maxSelected: {
+    type: NumberConstructor;
+  };
+  /** 多选时输入行最多摆几枚标签，其余折进 +N 那一枚；默认 3。 */
+  maxTagCount: {
+    type: NumberConstructor;
+  };
   /** 选择粒度；与 selectionMode 正交，输入行铺设哪几段也跟随它。 */
   granularity: {
     type: PropType<CalendarGranularity>;
@@ -55,6 +67,10 @@ declare const XhDatePickerRoot: import("vue").DefineComponent<import("vue").Extr
   segments: {
     type: PropType<DateSegmentSet>;
   };
+  /** 占位。字符串是整条占位：一段都没填、焦点也不在段上时输入行显示这句文字，焦点进到段上即换回段位；对象是逐段的占位串，覆盖内置的 yyyy / mm / dd。 */
+  placeholder: {
+    type: PropType<string | DateSegmentPlaceholders>;
+  };
   /** 并排展示几页；默认 1。 */
   visibleCount: {
     type: NumberConstructor;
@@ -127,9 +143,22 @@ declare const XhDatePickerRoot: import("vue").DefineComponent<import("vue").Extr
   timeGranularity: {
     type: PropType<DatePickerSchema["props"]["timeGranularity"]>;
   };
+  /** showTime 的小时制，默认 24；12 时多出上下午列与上下午段。 */
+  hourCycle: {
+    type: PropType<TimeHourCycle>;
+  };
+  /** showTime 时间列按单位的步进：`{ hour?, minute?, second? }`。 */
+  timeStep: {
+    type: PropType<TimeStep>;
+  };
+  /** showTime 时间列的逐格可选性：时列按 24 小时制给值，第三个参数带已选的时分与所属日期。 */
+  isTimeUnavailable: {
+    type: PropType<TimeUnavailablePredicate>;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  clear: () => true;
   'value-change': (_details: PayloadOf<DatePickerProps, "onValueChange">) => true;
   'open-change': (_details: PayloadOf<DatePickerProps, "onOpenChange">) => true;
   'focused-value-change': (_details: PayloadOf<DatePickerProps, "onFocusedValueChange">) => true;
@@ -158,12 +187,24 @@ declare const XhDatePickerRoot: import("vue").DefineComponent<import("vue").Extr
   locale: {
     type: StringConstructor;
   };
+  /** 周首日，0 = 星期日 … 6 = 星期六；不给按 locale。只改日历的表头、行首与 Home / End，月份名与星期名仍按 locale。 */
+  firstDayOfWeek: {
+    type: NumberConstructor;
+  };
   timeZone: {
     type: StringConstructor;
   };
   selectionMode: {
     type: PropType<CalendarPickerSelectionMode>;
   };
+  /** multiple 下最多选几个周期；选满后日历里没选中的格子不可再加选，已选的仍可点掉。 */
+  maxSelected: {
+    type: NumberConstructor;
+  };
+  /** 多选时输入行最多摆几枚标签，其余折进 +N 那一枚；默认 3。 */
+  maxTagCount: {
+    type: NumberConstructor;
+  };
   /** 选择粒度；与 selectionMode 正交，输入行铺设哪几段也跟随它。 */
   granularity: {
     type: PropType<CalendarGranularity>;
@@ -176,6 +217,10 @@ declare const XhDatePickerRoot: import("vue").DefineComponent<import("vue").Extr
   segments: {
     type: PropType<DateSegmentSet>;
   };
+  /** 占位。字符串是整条占位：一段都没填、焦点也不在段上时输入行显示这句文字，焦点进到段上即换回段位；对象是逐段的占位串，覆盖内置的 yyyy / mm / dd。 */
+  placeholder: {
+    type: PropType<string | DateSegmentPlaceholders>;
+  };
   /** 并排展示几页；默认 1。 */
   visibleCount: {
     type: NumberConstructor;
@@ -248,9 +293,22 @@ declare const XhDatePickerRoot: import("vue").DefineComponent<import("vue").Extr
   timeGranularity: {
     type: PropType<DatePickerSchema["props"]["timeGranularity"]>;
   };
+  /** showTime 的小时制，默认 24；12 时多出上下午列与上下午段。 */
+  hourCycle: {
+    type: PropType<TimeHourCycle>;
+  };
+  /** showTime 时间列按单位的步进：`{ hour?, minute?, second? }`。 */
+  timeStep: {
+    type: PropType<TimeStep>;
+  };
+  /** showTime 时间列的逐格可选性：时列按 24 小时制给值，第三个参数带已选的时分与所属日期。 */
+  isTimeUnavailable: {
+    type: PropType<TimeUnavailablePredicate>;
+  };
 }>> & Readonly<{
   "onValue-change"?: ((_details: import("@xihan-ui/headless").DatePickerValueChangeDetails) => any) | undefined;
   "onUpdate:value"?: ((_value: string[]) => any) | undefined;
+  onClear?: (() => any) | undefined;
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").DatePickerOpenChangeDetails) => any) | undefined;
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
   "onFocused-value-change"?: ((_details: import("@xihan-ui/headless").DatePickerFocusChangeDetails) => any) | undefined;
@@ -275,6 +333,41 @@ declare const XhDatePickerLabel: import("vue").DefineComponent<{}, () => VNode<i
 declare const XhDatePickerControl: 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>;
+/** 标签文字所在的块（tag 的 label）：截断规则挂在这一层。 */
+declare const XhDatePickerTagLabel: 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>;
+/** 标签中的删除按钮：即所在标签那份 tag 的 close-trigger，可及名使用 translations.deleteItem；点按摘掉所在标签的选中值，焦点不动。 */
+declare const XhDatePickerItemDeleteTrigger: 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>;
+/** 多选时一个选中值一个标签，即库内 tag 的 root（data-scope="tag"）：语气、尺寸与禁用从日期选择器传下，形态按盒的面派生。 */
+declare const XhDatePickerTag: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 它代表哪个选中值。 */
+  value: {
+    type: StringConstructor;
+    required: true;
+  };
+}>, () => 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: {
+    type: StringConstructor;
+    required: true;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 折叠的标签合成的一个标签：同样是 tag 的 root；有插槽时使用插槽，否则显示 +N。没有折叠的标签时连接层写 hidden。 */
+declare const XhDatePickerOverflowTag: 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>;
+/**
+ * 标签行：多选时放在盒里、触发钮之前；没有选中时承载整条占位，单选时连接层给 hidden。
+ * 不写插槽即按 tags 铺出带删除钮的标签与 +N 那一枚，写了插槽由作者自己铺。
+ */
+declare const XhDatePickerTagList: 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 XhDatePickerSegmentGroup: 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>;
@@ -506,7 +599,9 @@ declare const XhDatePickerCellTrigger: import("vue").DefineComponent<{}, () => V
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhDatePickerHiddenInput: 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>;
+}> | 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 { DatePickerPresetsSlotProps, DatePickerRootSlotProps, DatePickerSegmentSlotProps, XhDatePickerCalendar, XhDatePickerCell, XhDatePickerCellTrigger, XhDatePickerClearTrigger, XhDatePickerConfirmTrigger, XhDatePickerContent, XhDatePickerControl, XhDatePickerGrid, XhDatePickerGridBody, XhDatePickerGridHead, XhDatePickerHeader, XhDatePickerHeading, XhDatePickerHeadingMonthTrigger, XhDatePickerHeadingYearTrigger, XhDatePickerHiddenInput, XhDatePickerLabel, XhDatePickerNextTrigger, XhDatePickerNextYearTrigger, XhDatePickerPositioner, XhDatePickerPreset, XhDatePickerPresetGroup, XhDatePickerPrevTrigger, XhDatePickerPrevYearTrigger, XhDatePickerRoot, XhDatePickerSegment, XhDatePickerSegmentGroup, XhDatePickerTimePanel, XhDatePickerTrigger, XhDatePickerWeekDay, XhDatePickerWeekNumber, XhDatePickerWeekRow };
+export { DatePickerPresetsSlotProps, DatePickerRootSlotProps, DatePickerSegmentSlotProps, XhDatePickerCalendar, XhDatePickerCell, XhDatePickerCellTrigger, XhDatePickerClearTrigger, XhDatePickerConfirmTrigger, XhDatePickerContent, XhDatePickerControl, XhDatePickerGrid, XhDatePickerGridBody, XhDatePickerGridHead, XhDatePickerHeader, XhDatePickerHeading, XhDatePickerHeadingMonthTrigger, XhDatePickerHeadingYearTrigger, XhDatePickerHiddenInput, XhDatePickerItemDeleteTrigger, XhDatePickerLabel, XhDatePickerNextTrigger, XhDatePickerNextYearTrigger, XhDatePickerOverflowTag, XhDatePickerPositioner, XhDatePickerPreset, XhDatePickerPresetGroup, XhDatePickerPrevTrigger, XhDatePickerPrevYearTrigger, XhDatePickerRoot, XhDatePickerSegment, XhDatePickerSegmentGroup, XhDatePickerTag, XhDatePickerTagLabel, XhDatePickerTagList, XhDatePickerTimePanel, XhDatePickerTrigger, XhDatePickerWeekDay, XhDatePickerWeekNumber, XhDatePickerWeekRow };
 //# sourceMappingURL=date-picker.d.ts.map

package/dist/components/date-picker/date-picker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date-picker.d.ts","names":[],"sources":["../../../src/components/date-picker/date-picker.ts"],"mappings":"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"}
+{"version":3,"file":"date-picker.d.ts","names":[],"sources":["../../../src/components/date-picker/date-picker.ts"],"mappings":"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"}

package/dist/components/date-picker/date-picker.js

@@ -1,10 +1,11 @@
 import { withXhConfig } from "../../config/config.js";
 import { XhPortal } from "../../runtime/portal.js";
+import { slotIsPlainText, slotPaints } from "../../runtime/slot-content.js";
 import { useScrollbars } from "../../runtime/use-scrollbars.js";
+import { withHandlers } from "../../runtime/with-handlers.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
-import { slotPaints } from "../../runtime/slot-content.js";
-import { provideDatePicker, provideDatePickerCell, provideDatePickerPanel, useDatePickerCellContext, useDatePickerContext, useDatePickerPanelContext } from "./context.js";
+import { provideDatePicker, provideDatePickerCell, provideDatePickerPanel, provideDatePickerTag, useDatePickerCellContext, useDatePickerContext, useDatePickerPanelContext, useDatePickerTagContext } from "./context.js";
 import { useDatePickerWithRoot } from "./use-date-picker.js";
 import { computed, defineComponent, h, mergeProps, onUpdated, ref } from "vue";
 import { resolveDatePickerPanelIndex } from "@xihan-ui/headless";
@@ -30,14 +31,22 @@ const XhDatePickerRoot = defineComponent({
 		min: { type: String },
 		max: { type: String },
 		locale: { type: String },
+		/** 周首日，0 = 星期日 … 6 = 星期六；不给按 locale。只改日历的表头、行首与 Home / End，月份名与星期名仍按 locale。 */
+		firstDayOfWeek: { type: Number },
 		timeZone: { type: String },
 		selectionMode: { type: String },
+		/** multiple 下最多选几个周期；选满后日历里没选中的格子不可再加选，已选的仍可点掉。 */
+		maxSelected: { type: Number },
+		/** 多选时输入行最多摆几枚标签，其余折进 +N 那一枚；默认 3。 */
+		maxTagCount: { type: Number },
 		/** 选择粒度；与 selectionMode 正交，输入行铺设哪几段也跟随它。 */
 		granularity: { type: String },
 		/** 面板当前所处的层级；给定即受控，默认跟随 granularity。 */
 		activeView: { type: String },
 		/** 输入行铺设哪几段；未提供时按 granularity 推导。 */
 		segments: { type: Array },
+		/** 占位。字符串是整条占位：一段都没填、焦点也不在段上时输入行显示这句文字，焦点进到段上即换回段位；对象是逐段的占位串，覆盖内置的 yyyy / mm / dd。 */
+		placeholder: { type: [String, Object] },
 		/** 并排展示几页；默认 1。 */
 		visibleCount: { type: Number },
 		/** 日历恒渲染六行，默认开启。关闭后翻页时浮层高度会随月份变化。 */
@@ -83,9 +92,16 @@ const XhDatePickerRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
-		timeGranularity: { type: String }
+		timeGranularity: { type: String },
+		/** showTime 的小时制，默认 24；12 时多出上下午列与上下午段。 */
+		hourCycle: { type: Number },
+		/** showTime 时间列按单位的步进：`{ hour?, minute?, second? }`。 */
+		timeStep: { type: Object },
+		/** showTime 时间列的逐格可选性：时列按 24 小时制给值，第三个参数带已选的时分与所属日期。 */
+		isTimeUnavailable: { type: Function }
 	},
 	emits: {
+		"clear": () => true,
 		"value-change": (_details) => true,
 		"open-change": (_details) => true,
 		"focused-value-change": (_details) => true,
@@ -110,7 +126,7 @@ const XhDatePickerRoot = defineComponent({
 			emit("active-view-change", details);
 			emit("update:activeView", details.activeView);
 		};
-		const ctx = useDatePickerWithRoot(withXhConfig("date-picker", useFormControlProps(props)), {
+		const ctx = useDatePickerWithRoot(withHandlers(withXhConfig("date-picker", useFormControlProps(props)), { onClear: () => emit("clear") }), {
 			onValueChange: notifyValue,
 			onOpenChange: notifyOpen,
 			onFocusedValueChange: notifyFocus,
@@ -161,6 +177,68 @@ const XhDatePickerControl = defineComponent({
 		}, slots.default?.());
 	}
 });
+/** 标签文字所在的块（tag 的 label）：截断规则挂在这一层。 */
+const XhDatePickerTagLabel = defineComponent({
+	name: "XhDatePickerTagLabel",
+	setup(_, { slots }) {
+		const ctx = useDatePickerContext();
+		return () => h("span", ctx.api.value.getTagLabelProps(), slots.default?.());
+	}
+});
+/**
+* 标签内容：只有文字时替它包一层 label：截断规则挂在 label 上，直接展开在 root 上的文字过长会把
+* 删除按钮挤出；作者自己写了节点则原样放行。库自身填入的文字（+N）恒包 label，三个适配器渲染出同一棵树。
+*/
+function tagChildren(content) {
+	if (typeof content === "string") return [h(XhDatePickerTagLabel, null, () => content)];
+	return slotIsPlainText(content) ? [h(XhDatePickerTagLabel, null, () => content)] : content;
+}
+/** 标签中的删除按钮：即所在标签那份 tag 的 close-trigger，可及名使用 translations.deleteItem；点按摘掉所在标签的选中值，焦点不动。 */
+const XhDatePickerItemDeleteTrigger = defineComponent({
+	name: "XhDatePickerItemDeleteTrigger",
+	setup(_, { slots }) {
+		const ctx = useDatePickerContext();
+		const tag = useDatePickerTagContext();
+		return () => h("button", ctx.api.value.getItemDeleteTriggerProps({ value: tag.value() }), slots.default?.());
+	}
+});
+/** 多选时一个选中值一个标签，即库内 tag 的 root（data-scope="tag"）：语气、尺寸与禁用从日期选择器传下，形态按盒的面派生。 */
+const XhDatePickerTag = defineComponent({
+	name: "XhDatePickerTag",
+	props: { 
+	/** 它代表哪个选中值。 */
+value: {
+		type: String,
+		required: true
+	} },
+	setup(props, { slots }) {
+		const ctx = useDatePickerContext();
+		provideDatePickerTag({ value: () => props.value });
+		return () => h("span", ctx.api.value.getTagProps({ value: props.value }), tagChildren(slots.default?.()));
+	}
+});
+/** 折叠的标签合成的一个标签：同样是 tag 的 root；有插槽时使用插槽，否则显示 +N。没有折叠的标签时连接层写 hidden。 */
+const XhDatePickerOverflowTag = defineComponent({
+	name: "XhDatePickerOverflowTag",
+	setup(_, { slots }) {
+		const ctx = useDatePickerContext();
+		return () => h("span", ctx.api.value.getOverflowTagProps(), tagChildren(slots.default?.() ?? ctx.api.value.overflowText));
+	}
+});
+/**
+* 标签行：多选时放在盒里、触发钮之前；没有选中时承载整条占位，单选时连接层给 hidden。
+* 不写插槽即按 tags 铺出带删除钮的标签与 +N 那一枚，写了插槽由作者自己铺。
+*/
+const XhDatePickerTagList = defineComponent({
+	name: "XhDatePickerTagList",
+	setup(_, { slots }) {
+		const ctx = useDatePickerContext();
+		return () => h("span", ctx.api.value.getTagListProps(), slots.default ? slots.default() : [...ctx.api.value.tags.map((tag) => h(XhDatePickerTag, {
+			key: tag.value,
+			value: tag.value
+		}, () => [h(XhDatePickerTagLabel, null, () => tag.label), h(XhDatePickerItemDeleteTrigger)])), h(XhDatePickerOverflowTag)]);
+	}
+});
 const XhDatePickerSegmentGroup = defineComponent({
 	name: "XhDatePickerSegmentGroup",
 	setup(_, { slots }) {
@@ -348,7 +426,10 @@ const XhDatePickerTimeColumnHost = defineComponent({
 					value: option
 				}),
 				key: option
-			}, option))), ...bars.render()];
+			}, api.getTimeItemText({
+				unit: column.unit,
+				value: option
+			})))), ...bars.render()];
 		};
 	}
 });
@@ -534,10 +615,13 @@ const XhDatePickerHiddenInput = defineComponent({
 	name: "XhDatePickerHiddenInput",
 	setup() {
 		const ctx = useDatePickerContext();
-		return () => h("input", ctx.api.value.field.getHiddenInputProps());
+		return () => ctx.api.value.selectionMode === "multiple" ? ctx.api.value.value.map((value) => h("input", {
+			key: value,
+			...ctx.api.value.field.getHiddenInputProps({ value })
+		})) : h("input", ctx.api.value.field.getHiddenInputProps());
 	}
 });
 //#endregion
-export { XhDatePickerCalendar, XhDatePickerCell, XhDatePickerCellTrigger, XhDatePickerClearTrigger, XhDatePickerConfirmTrigger, XhDatePickerContent, XhDatePickerControl, XhDatePickerGrid, XhDatePickerGridBody, XhDatePickerGridHead, XhDatePickerHeader, XhDatePickerHeading, XhDatePickerHeadingMonthTrigger, XhDatePickerHeadingYearTrigger, XhDatePickerHiddenInput, XhDatePickerLabel, XhDatePickerNextTrigger, XhDatePickerNextYearTrigger, XhDatePickerPositioner, XhDatePickerPreset, XhDatePickerPresetGroup, XhDatePickerPrevTrigger, XhDatePickerPrevYearTrigger, XhDatePickerRoot, XhDatePickerSegment, XhDatePickerSegmentGroup, XhDatePickerTimePanel, XhDatePickerTrigger, XhDatePickerWeekDay, XhDatePickerWeekNumber, XhDatePickerWeekRow };
+export { XhDatePickerCalendar, XhDatePickerCell, XhDatePickerCellTrigger, XhDatePickerClearTrigger, XhDatePickerConfirmTrigger, XhDatePickerContent, XhDatePickerControl, XhDatePickerGrid, XhDatePickerGridBody, XhDatePickerGridHead, XhDatePickerHeader, XhDatePickerHeading, XhDatePickerHeadingMonthTrigger, XhDatePickerHeadingYearTrigger, XhDatePickerHiddenInput, XhDatePickerItemDeleteTrigger, XhDatePickerLabel, XhDatePickerNextTrigger, XhDatePickerNextYearTrigger, XhDatePickerOverflowTag, XhDatePickerPositioner, XhDatePickerPreset, XhDatePickerPresetGroup, XhDatePickerPrevTrigger, XhDatePickerPrevYearTrigger, XhDatePickerRoot, XhDatePickerSegment, XhDatePickerSegmentGroup, XhDatePickerTag, XhDatePickerTagLabel, XhDatePickerTagList, XhDatePickerTimePanel, XhDatePickerTrigger, XhDatePickerWeekDay, XhDatePickerWeekNumber, XhDatePickerWeekRow };
 
 //# sourceMappingURL=date-picker.js.map