@xihan-ui/vue 1.1.0 → 2.0.0

package/dist/components/timeline/timeline.js

@@ -4,22 +4,13 @@ import { provideTimeline, provideTimelineItem, useTimelineContext, useTimelineIt
 import { computed, defineComponent, h } from "vue";
 import { connectTimeline } from "@xihan-ui/headless";
 //#region src/components/timeline/timeline.ts
-/** 根渲染为 ol：事件本来就有先后，列表标记由皮肤抹掉、列表语义由 role 兜住。 */
+/** 根渲染为 ol：事件本身有先后，列表标记由皮肤去除、列表语义由 role 保留。 */
 const XhTimelineRoot = defineComponent({
 	name: "XhTimelineRoot",
 	props: {
-		orientation: {
-			type: String,
-			default: void 0
-		},
-		placement: {
-			type: String,
-			default: void 0
-		},
-		size: {
-			type: String,
-			default: void 0
-		}
+		orientation: { type: String },
+		placement: { type: String },
+		size: { type: String }
 	},
 	setup(props, { slots }) {
 		const api = computed(() => connectTimeline(withXhConfig("timeline", props), vueNormalize));
@@ -27,19 +18,23 @@ const XhTimelineRoot = defineComponent({
 		return () => h("ol", api.value.getRootProps(), slots.default?.());
 	}
 });
-/** 一条事件。tone 只在这一条内生效，下传给它自己的圆点。 */
+/** 一条事件。tone 只在该条内生效，下传给它自己的圆点。 */
 const XhTimelineItem = defineComponent({
 	name: "XhTimelineItem",
-	props: { tone: {
-		type: String,
-		default: void 0
-	} },
+	props: { tone: { type: String } },
 	setup(props, { slots }) {
 		const ctx = useTimelineContext();
 		provideTimelineItem(() => ({ tone: props.tone }));
 		return () => h("li", ctx.api.value.getItemProps(), slots.default?.());
 	}
 });
+const XhTimelineLabel = defineComponent({
+	name: "XhTimelineLabel",
+	setup(_, { slots }) {
+		const ctx = useTimelineContext();
+		return () => h("div", ctx.api.value.getLabelProps(), slots.default?.());
+	}
+});
 const XhTimelineIndicator = defineComponent({
 	name: "XhTimelineIndicator",
 	setup(_, { slots }) {
@@ -76,7 +71,7 @@ const XhTimelineDescription = defineComponent({
 		return () => h("div", ctx.api.value.getDescriptionProps(), slots.default?.());
 	}
 });
-/** 渲染为 time：机读时间由作者写 datetime，属性原样透传到这个节点上。 */
+/** 渲染为 time：机读时间由作者写 datetime，属性原样透传到该节点上。 */
 const XhTimelineTime = defineComponent({
 	name: "XhTimelineTime",
 	setup(_, { slots }) {
@@ -85,6 +80,6 @@ const XhTimelineTime = defineComponent({
 	}
 });
 //#endregion
-export { XhTimelineConnector, XhTimelineContent, XhTimelineDescription, XhTimelineIndicator, XhTimelineItem, XhTimelineRoot, XhTimelineTime, XhTimelineTitle };
+export { XhTimelineConnector, XhTimelineContent, XhTimelineDescription, XhTimelineIndicator, XhTimelineItem, XhTimelineLabel, XhTimelineRoot, XhTimelineTime, XhTimelineTitle };
 
 //# sourceMappingURL=timeline.js.map

package/dist/components/timeline/timeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeline.js","names":[],"sources":["../../../src/components/timeline/timeline.ts"],"sourcesContent":["import type { TimelinePlacement, TimelineProps } from '@xihan-ui/headless'\nimport type { Orientation, Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType } from 'vue'\nimport { connectTimeline } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideTimeline, provideTimelineItem, useTimelineContext, useTimelineItem } from './context'\n\n/** 根渲染为 ol：事件本来就有先后，列表标记由皮肤抹掉、列表语义由 role 兜住。 */\nexport const XhTimelineRoot = defineComponent({\n  name: 'XhTimelineRoot',\n  // 有 connect 兜底的 prop 一律 default: undefined\n  props: {\n    orientation: { type: String as PropType<Orientation>, default: undefined },\n    placement: { type: String as PropType<TimelinePlacement>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n  },\n  setup(props, { slots }) {\n    const api = computed(() => connectTimeline(withXhConfig('timeline', props) as TimelineProps, vueNormalize))\n    provideTimeline({ api })\n    return () => h('ol', api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 一条事件。tone 只在这一条内生效，下传给它自己的圆点。 */\nexport const XhTimelineItem = defineComponent({\n  name: 'XhTimelineItem',\n  props: {\n    tone: { type: String as PropType<Tone>, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useTimelineContext()\n    provideTimelineItem(() => ({ tone: props.tone }))\n    return () => h('li', ctx.api.value.getItemProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimelineIndicator = defineComponent({\n  name: 'XhTimelineIndicator',\n  setup(_, { slots }) {\n    const ctx = useTimelineContext()\n    const item = useTimelineItem()\n    return () => h('span', ctx.api.value.getIndicatorProps(item()) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimelineConnector = defineComponent({\n  name: 'XhTimelineConnector',\n  setup(_, { slots }) {\n    const ctx = useTimelineContext()\n    return () => h('span', ctx.api.value.getConnectorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimelineContent = defineComponent({\n  name: 'XhTimelineContent',\n  setup(_, { slots }) {\n    const ctx = useTimelineContext()\n    return () => h('div', ctx.api.value.getContentProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimelineTitle = defineComponent({\n  name: 'XhTimelineTitle',\n  setup(_, { slots }) {\n    const ctx = useTimelineContext()\n    return () => h('div', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimelineDescription = defineComponent({\n  name: 'XhTimelineDescription',\n  setup(_, { slots }) {\n    const ctx = useTimelineContext()\n    return () => h('div', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 渲染为 time：机读时间由作者写 datetime，属性原样透传到这个节点上。 */\nexport const XhTimelineTime = defineComponent({\n  name: 'XhTimelineTime',\n  setup(_, { slots }) {\n    const ctx = useTimelineContext()\n    return () => h('time', ctx.api.value.getTimeProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;;AAUA,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CAEN,OAAO;EACL,aAAa;GAAE,MAAM;GAAiC,SAAS,KAAA;EAAU;EACzE,WAAW;GAAE,MAAM;GAAuC,SAAS,KAAA;EAAU;EAC7E,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;CAC7D;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe,gBAAgB,aAAa,YAAY,KAAK,GAAoB,YAAY,CAAC;EAC1G,gBAAgB,EAAE,IAAI,CAAC;EACvB,aAAa,EAAE,MAAM,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAC7F;AACF,CAAC;;AAGD,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,OAAO,EACL,MAAM;EAAE,MAAM;EAA0B,SAAS,KAAA;CAAU,EAC7D;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,mBAAmB;EAC/B,2BAA2B,EAAE,MAAM,MAAM,KAAK,EAAE;EAChD,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,MAAM,OAAO,gBAAgB;EAC7B,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,kBAAkB,KAAK,CAAC,GAA8B,MAAM,UAAU,CAAC;CAC9G;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;AAED,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACzG;AACF,CAAC;;AAGD,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC"}
+{"version":3,"file":"timeline.js","names":[],"sources":["../../../src/components/timeline/timeline.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// 提供 timeline 相关实现。\n\nimport type { Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { TimelinePlacement, TimelineProps } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectTimeline } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideTimeline, provideTimelineItem, useTimelineContext, useTimelineItem } from './context'\n\n/** 根渲染为 ol：事件本身有先后，列表标记由皮肤去除、列表语义由 role 保留。 */\nexport const XhTimelineRoot = defineComponent({\n  name: 'XhTimelineRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    orientation: { type: String as PropType<Orientation> },\n    placement: { type: String as PropType<TimelinePlacement> },\n    size: { type: String as PropType<Size> },\n  },\n  setup(props, { slots }) {\n    const api = computed(() => connectTimeline(withXhConfig('timeline', props) as TimelineProps, vueNormalize))\n    provideTimeline({ api })\n    return () => h('ol', api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 一条事件。tone 只在该条内生效，下传给它自己的圆点。 */\nexport const XhTimelineItem = defineComponent({\n  name: 'XhTimelineItem',\n  props: {\n    tone: { type: String as PropType<Tone> },\n  },\n  setup(props, { slots }) {\n    const ctx = useTimelineContext()\n    provideTimelineItem(() => ({ tone: props.tone }))\n    return () => h('li', ctx.api.value.getItemProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 这一条的坐标（日期、版本号），与内容对置的那一列\nexport const XhTimelineLabel = defineComponent({\n  name: 'XhTimelineLabel',\n  setup(_, { slots }) {\n    const ctx = useTimelineContext()\n    return () => h('div', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimelineIndicator = defineComponent({\n  name: 'XhTimelineIndicator',\n  setup(_, { slots }) {\n    const ctx = useTimelineContext()\n    const item = useTimelineItem()\n    return () => h('span', ctx.api.value.getIndicatorProps(item()) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimelineConnector = defineComponent({\n  name: 'XhTimelineConnector',\n  setup(_, { slots }) {\n    const ctx = useTimelineContext()\n    return () => h('span', ctx.api.value.getConnectorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimelineContent = defineComponent({\n  name: 'XhTimelineContent',\n  setup(_, { slots }) {\n    const ctx = useTimelineContext()\n    return () => h('div', ctx.api.value.getContentProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimelineTitle = defineComponent({\n  name: 'XhTimelineTitle',\n  setup(_, { slots }) {\n    const ctx = useTimelineContext()\n    return () => h('div', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimelineDescription = defineComponent({\n  name: 'XhTimelineDescription',\n  setup(_, { slots }) {\n    const ctx = useTimelineContext()\n    return () => h('div', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 渲染为 time：机读时间由作者写 datetime，属性原样透传到该节点上。 */\nexport const XhTimelineTime = defineComponent({\n  name: 'XhTimelineTime',\n  setup(_, { slots }) {\n    const ctx = useTimelineContext()\n    return () => h('time', ctx.api.value.getTimeProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;;AAiBA,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CAEN,OAAO;EACL,aAAa,EAAE,MAAM,OAAgC;EACrD,WAAW,EAAE,MAAM,OAAsC;EACzD,MAAM,EAAE,MAAM,OAAyB;CACzC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe,gBAAgB,aAAa,YAAY,KAAK,GAAoB,YAAY,CAAC;EAC1G,gBAAgB,EAAE,IAAI,CAAC;EACvB,aAAa,EAAE,MAAM,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAC7F;AACF,CAAC;;AAGD,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,OAAO,EACL,MAAM,EAAE,MAAM,OAAyB,EACzC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,mBAAmB;EAC/B,2BAA2B,EAAE,MAAM,MAAM,KAAK,EAAE;EAChD,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;AAGD,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,MAAM,OAAO,gBAAgB;EAC7B,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,kBAAkB,KAAK,CAAC,GAA8B,MAAM,UAAU,CAAC;CAC9G;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;AAED,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACzG;AACF,CAAC;;AAGD,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/timer/context.ts"],"mappings":";;iBAUgB,mBAAmB"}
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/timer/context.ts"],"mappings":";;iBAiBgB,mBAAmB"}

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/timer/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { TimerContext } from './use-timer'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<TimerContext> = Symbol.for('xh-timer')\n\nexport function provideTimer(ctx: TimerContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useTimerContext(): TimerContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Timer 部件必须用在 XhTimerRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAkC,OAAO,IAAI,UAAU;AAE7D,SAAgB,aAAa,KAAyB;CACpD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,kBAAgC;CAC9C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,iCAAiC;CACnD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/timer/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { InjectionKey } from 'vue'\nimport type { TimerContext } from './use-timer'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<TimerContext> = Symbol.for('xh-timer')\n\nexport function provideTimer(ctx: TimerContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useTimerContext(): TimerContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Timer 部件必须用在 XhTimerRoot 内')\n  return ctx\n}\n"],"mappings":";;AAWA,MAAM,MAAkC,OAAO,IAAI,UAAU;AAE7D,SAAgB,aAAa,KAAyB;CACpD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,kBAAgC;CAC9C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,iCAAiC;CACnD,OAAO;AACT"}

package/dist/components/timer/timer.d.ts

@@ -1,39 +1,50 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
-import { TimerApi, TimerSchema, TimerTranslations, TimerUnit } from "@xihan-ui/headless";
-import { Size } from "@xihan-ui/kernel";
+import { Size } from "@xihan-ui/core";
+import { TimerApi, TimerLive, TimerSchema, TimerTranslations, TimerUnit } from "@xihan-ui/headless";
 //#region src/components/timer/timer.d.ts
 type TimerProps = TimerSchema['props'];
 /** 默认插槽的载荷：当前状态与显示值、拆开的每一段，以及起停归零四个动作。 */
-type TimerRootSlotProps = Pick<TimerApi, 'phase' | 'value' | 'elapsed' | 'running' | 'paused' | 'completed' | 'countdown' | 'segments' | 'segmentText' | 'controlAction' | 'controlLabel' | 'start' | 'pause' | 'resume' | 'reset'>;
+type TimerRootSlotProps = Pick<TimerApi, 'phase' | 'value' | 'text' | 'elapsed' | 'running' | 'paused' | 'completed' | 'countdown' | 'controlled' | 'segments' | 'segmentText' | 'controlAction' | 'controlLabel' | 'start' | 'pause' | 'resume' | 'reset'>;
 declare const XhTimerRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   startMs: {
     type: NumberConstructor;
-    default: undefined;
   };
   targetMs: {
     type: NumberConstructor;
-    default: undefined;
   };
   countdown: {
     type: BooleanConstructor;
     default: undefined;
   };
+  value: {
+    type: NumberConstructor;
+  };
+  active: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   autoStart: {
     type: BooleanConstructor;
     default: undefined;
   };
   interval: {
     type: NumberConstructor;
-    default: undefined;
+  };
+  format: {
+    type: StringConstructor;
+  };
+  precision: {
+    type: NumberConstructor;
+  };
+  live: {
+    type: PropType<TimerLive>;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
   translations: {
     type: PropType<Partial<TimerTranslations>>;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -43,47 +54,54 @@ declare const XhTimerRoot: import("vue").DefineComponent<import("vue").ExtractPr
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   startMs: {
     type: NumberConstructor;
-    default: undefined;
   };
   targetMs: {
     type: NumberConstructor;
-    default: undefined;
   };
   countdown: {
     type: BooleanConstructor;
     default: undefined;
   };
+  value: {
+    type: NumberConstructor;
+  };
+  active: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   autoStart: {
     type: BooleanConstructor;
     default: undefined;
   };
   interval: {
     type: NumberConstructor;
-    default: undefined;
+  };
+  format: {
+    type: StringConstructor;
+  };
+  precision: {
+    type: NumberConstructor;
+  };
+  live: {
+    type: PropType<TimerLive>;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
   translations: {
     type: PropType<Partial<TimerTranslations>>;
-    default: undefined;
   };
 }>> & Readonly<{
   onComplete?: ((_details: import("@xihan-ui/headless").TimerCompleteDetails) => any) | undefined;
   onTick?: ((_details: import("@xihan-ui/headless").TimerTickDetails) => any) | undefined;
 }>, {
-  size: Size;
-  translations: Partial<TimerTranslations>;
+  active: boolean;
   countdown: boolean;
-  startMs: number;
-  targetMs: number;
   autoStart: boolean;
-  interval: number;
 }, SlotsType<{
   default?: (props: TimerRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhTimerArea: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhTimerDisplay: 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 XhTimerItem: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
@@ -106,5 +124,5 @@ declare const XhTimerControl: import("vue").DefineComponent<{}, () => VNode<impo
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { TimerRootSlotProps, XhTimerArea, XhTimerControl, XhTimerItem, XhTimerRoot, XhTimerSeparator };
+export { TimerRootSlotProps, XhTimerControl, XhTimerDisplay, XhTimerItem, XhTimerRoot, XhTimerSeparator };
 //# sourceMappingURL=timer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"timer.d.ts","names":[],"sources":["../../../src/components/timer/timer.ts"],"mappings":";;;;;KAUK,aAAa;;KAGN,qBAAqB,KAC/B;cASW,2BAAW,8BAAA;;;;;;;;;;;;;;;;;;;;;;IASI,MAAA,SAAS;;;;IACD,MAAA,SAAS,QAAQ;;;;;;EAIhC,OAAA,UAAA,UAAU;EACN,WAAA,UAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;IANP,MAAA,SAAS;;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;EAQvC,WAAC,OAAO,uBAAuB;kCAoC3C;cAEW,2BAAW,0BAAA,oBAAA,4BAAA;;8BAMtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,8BAAA;;IAGI,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;;MAenC,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAc3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAezB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"timer.d.ts","names":[],"sources":["../../../src/components/timer/timer.ts"],"mappings":";;;;;KAiBK,aAAa;;KAGN,qBAAqB,KAC/B;cASW,2BAAW,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAaI,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAIhC,OAAA,UAAA,UAAU;EACN,WAAA,UAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAPP,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;EAQvC,WAAC,OAAO,uBAAuB;kCAsC3C;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,8BAAA;;IAGI,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;;MAenC,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAc3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAezB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/timer/timer.js

@@ -4,7 +4,7 @@ import { provideTimer, useTimerContext } from "./context.js";
 import { useTimer } from "./use-timer.js";
 import { defineComponent, h } from "vue";
 //#region src/components/timer/timer.ts
-/** 没写默认插槽时铺开的那几段：时、分、秒。要天或毫秒就自己写部件。 */
+/** 未写默认插槽时铺设的段：时、分、秒。需要天或毫秒时自行写部件。 */
 const DEFAULT_UNITS = [
 	"hours",
 	"minutes",
@@ -13,34 +13,27 @@ const DEFAULT_UNITS = [
 const XhTimerRoot = defineComponent({
 	name: "XhTimerRoot",
 	props: {
-		startMs: {
-			type: Number,
-			default: void 0
-		},
-		targetMs: {
-			type: Number,
-			default: void 0
-		},
+		startMs: { type: Number },
+		targetMs: { type: Number },
 		countdown: {
 			type: Boolean,
 			default: void 0
 		},
-		autoStart: {
+		value: { type: Number },
+		active: {
 			type: Boolean,
 			default: void 0
 		},
-		interval: {
-			type: Number,
-			default: void 0
-		},
-		size: {
-			type: String,
+		autoStart: {
+			type: Boolean,
 			default: void 0
 		},
-		translations: {
-			type: Object,
-			default: void 0
-		}
+		interval: { type: Number },
+		format: { type: String },
+		precision: { type: Number },
+		live: { type: String },
+		size: { type: String },
+		translations: { type: Object }
 	},
 	emits: {
 		tick: (_details) => true,
@@ -58,6 +51,8 @@ const XhTimerRoot = defineComponent({
 			const content = slots.default?.({
 				phase: api.phase,
 				value: api.value,
+				text: api.text,
+				controlled: api.controlled,
 				elapsed: api.elapsed,
 				running: api.running,
 				paused: api.paused,
@@ -76,11 +71,11 @@ const XhTimerRoot = defineComponent({
 		};
 	}
 });
-const XhTimerArea = defineComponent({
-	name: "XhTimerArea",
+const XhTimerDisplay = defineComponent({
+	name: "XhTimerDisplay",
 	setup(_, { slots }) {
 		const ctx = useTimerContext();
-		return () => h("div", ctx.api.value.getAreaProps(), slots.default?.());
+		return () => h("div", ctx.api.value.getDisplayProps(), slots.default?.());
 	}
 });
 const XhTimerItem = defineComponent({
@@ -119,8 +114,8 @@ const XhTimerControl = defineComponent({
 	}
 });
 /**
-* 没写默认插槽时铺开的整套结构：一个时间区，里面是时、分、秒三段与两个冒号。
-* 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。
+* 未写默认插槽时铺设的整套结构：一个时间区，其中是时、分、秒三段与两个冒号。
+* 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。
 */
 function renderDefaultTree() {
 	const children = [];
@@ -131,9 +126,9 @@ function renderDefaultTree() {
 			unit
 		}));
 	}
-	return h(XhTimerArea, null, () => children);
+	return h(XhTimerDisplay, null, () => children);
 }
 //#endregion
-export { XhTimerArea, XhTimerControl, XhTimerItem, XhTimerRoot, XhTimerSeparator };
+export { XhTimerControl, XhTimerDisplay, XhTimerItem, XhTimerRoot, XhTimerSeparator };
 
 //# sourceMappingURL=timer.js.map

package/dist/components/timer/timer.js.map

@@ -1 +1 @@
-{"version":3,"file":"timer.js","names":[],"sources":["../../../src/components/timer/timer.ts"],"sourcesContent":["import type { TimerApi, TimerSchema, TimerTranslations, TimerUnit } from '@xihan-ui/headless'\nimport type { Size } 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 { slotPaints } from '../../runtime/slot-content'\nimport { provideTimer, useTimerContext } from './context'\nimport { useTimer } from './use-timer'\n\ntype TimerProps = TimerSchema['props']\n\n/** 默认插槽的载荷：当前状态与显示值、拆开的每一段，以及起停归零四个动作。 */\nexport type TimerRootSlotProps = Pick<\n  TimerApi,\n  'phase' | 'value' | 'elapsed' | 'running' | 'paused' | 'completed' | 'countdown'\n  | 'segments' | 'segmentText' | 'controlAction' | 'controlLabel'\n  | 'start' | 'pause' | 'resume' | 'reset'\n>\n\n/** 没写默认插槽时铺开的那几段：时、分、秒。要天或毫秒就自己写部件。 */\nconst DEFAULT_UNITS: readonly TimerUnit[] = ['hours', 'minutes', 'seconds']\n\nexport const XhTimerRoot = defineComponent({\n  name: 'XhTimerRoot',\n  // 全部 default: undefined，缺省值由机器与 connect 决定\n  props: {\n    startMs: { type: Number, default: undefined },\n    targetMs: { type: Number, default: undefined },\n    countdown: { type: Boolean, default: undefined },\n    autoStart: { type: Boolean, default: undefined },\n    interval: { type: Number, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n    translations: { type: Object as PropType<Partial<TimerTranslations>>, default: undefined },\n  },\n  // tick 携带 { value, elapsed }；complete 同形，只在到点那一刻发一次\n  emits: {\n    tick: (_details: PayloadOf<TimerProps, 'onTick'>) => true,\n    complete: (_details: PayloadOf<TimerProps, 'onComplete'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TimerRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useTimer(withXhConfig('timer', props) as TimerProps, {\n      onTick: details => emit('tick', details),\n      onComplete: details => emit('complete', details),\n    })\n    provideTimer(ctx)\n\n    return () => {\n      const api = ctx.api.value\n      const content = slots.default?.({\n        phase: api.phase,\n        value: api.value,\n        elapsed: api.elapsed,\n        running: api.running,\n        paused: api.paused,\n        completed: api.completed,\n        countdown: api.countdown,\n        segments: api.segments,\n        segmentText: api.segmentText,\n        controlAction: api.controlAction,\n        controlLabel: api.controlLabel,\n        start: api.start,\n        pause: api.pause,\n        resume: api.resume,\n        reset: api.reset,\n      })\n      return h(\n        'div',\n        api.getRootProps() as Record<string, unknown>,\n        // 插槽为空（含 v-if 落空只剩注释节点）时退回组件自己铺的时分秒\n        slotPaints(content) ? content : [renderDefaultTree()],\n      )\n    }\n  },\n})\n\nexport const XhTimerArea = defineComponent({\n  name: 'XhTimerArea',\n  setup(_, { slots }) {\n    const ctx = useTimerContext()\n    return () => h('div', ctx.api.value.getAreaProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimerItem = defineComponent({\n  name: 'XhTimerItem',\n  props: {\n    unit: { type: String as PropType<TimerUnit>, required: true },\n  },\n  setup(props) {\n    const ctx = useTimerContext()\n    return () => {\n      const api = ctx.api.value\n      // 这一段的数字恒由组件写，作者只声明它是哪一段：写在条目里的内容留不住，\n      // 下一拍就会被新的数字盖掉，Web Components 侧也是元素接管这段文本\n      return h(\n        'span',\n        api.getItemProps({ unit: props.unit }) as Record<string, unknown>,\n        api.segmentText(props.unit),\n      )\n    }\n  },\n})\n\nexport const XhTimerSeparator = defineComponent({\n  name: 'XhTimerSeparator',\n  setup(_, { slots }) {\n    const ctx = useTimerContext()\n    return () => {\n      const content = slots.default?.()\n      // 缺省是冒号，换成别的记号写进插槽即可\n      return h(\n        'span',\n        ctx.api.value.getSeparatorProps() as Record<string, unknown>,\n        slotPaints(content) ? content : ':',\n      )\n    }\n  },\n})\n\nexport const XhTimerControl = defineComponent({\n  name: 'XhTimerControl',\n  setup(_, { slots }) {\n    const ctx = useTimerContext()\n    return () => {\n      const api = ctx.api.value\n      const content = slots.default?.()\n      // 用原生 button，激活交给平台；没写内容时把当前动作的名字写上去\n      return h(\n        'button',\n        api.getControlProps() as Record<string, unknown>,\n        slotPaints(content) ? content : api.controlLabel,\n      )\n    }\n  },\n})\n\n/**\n * 没写默认插槽时铺开的整套结构：一个时间区，里面是时、分、秒三段与两个冒号。\n * 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。\n */\nfunction renderDefaultTree(): VNode {\n  const children: VNode[] = []\n  for (const [index, unit] of DEFAULT_UNITS.entries()) {\n    if (index > 0)\n      children.push(h(XhTimerSeparator, { key: `separator-${unit}` }))\n    children.push(h(XhTimerItem, { key: unit, unit }))\n  }\n  return h(XhTimerArea, null, () => children)\n}\n"],"mappings":"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"}
+{"version":3,"file":"timer.js","names":[],"sources":["../../../src/components/timer/timer.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// 提供 timer 相关实现。\n\nimport type { Size } from '@xihan-ui/core'\nimport type { TimerApi, TimerLive, TimerSchema, TimerTranslations, TimerUnit } 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 { slotPaints } from '../../runtime/slot-content'\nimport { provideTimer, useTimerContext } from './context'\nimport { useTimer } from './use-timer'\n\ntype TimerProps = TimerSchema['props']\n\n/** 默认插槽的载荷：当前状态与显示值、拆开的每一段，以及起停归零四个动作。 */\nexport type TimerRootSlotProps = Pick<\n  TimerApi,\n  'phase' | 'value' | 'text' | 'elapsed' | 'running' | 'paused' | 'completed' | 'countdown' | 'controlled'\n  | 'segments' | 'segmentText' | 'controlAction' | 'controlLabel'\n  | 'start' | 'pause' | 'resume' | 'reset'\n>\n\n/** 未写默认插槽时铺设的段：时、分、秒。需要天或毫秒时自行写部件。 */\nconst DEFAULT_UNITS: readonly TimerUnit[] = ['hours', 'minutes', 'seconds']\n\nexport const XhTimerRoot = defineComponent({\n  name: 'XhTimerRoot',\n  // 缺省值由机器与 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    startMs: { type: Number },\n    targetMs: { type: Number },\n    countdown: { type: Boolean, default: undefined },\n    value: { type: Number },\n    active: { type: Boolean, default: undefined },\n    autoStart: { type: Boolean, default: undefined },\n    interval: { type: Number },\n    format: { type: String },\n    precision: { type: Number },\n    live: { type: String as PropType<TimerLive> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<TimerTranslations>> },\n  },\n  // tick 携带 { value, elapsed }；complete 同形，只在到点那一刻发一次\n  emits: {\n    tick: (_details: PayloadOf<TimerProps, 'onTick'>) => true,\n    complete: (_details: PayloadOf<TimerProps, 'onComplete'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TimerRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useTimer(withXhConfig('timer', props) as TimerProps, {\n      onTick: details => emit('tick', details),\n      onComplete: details => emit('complete', details),\n    })\n    provideTimer(ctx)\n\n    return () => {\n      const api = ctx.api.value\n      const content = slots.default?.({\n        phase: api.phase,\n        value: api.value,\n        text: api.text,\n        controlled: api.controlled,\n        elapsed: api.elapsed,\n        running: api.running,\n        paused: api.paused,\n        completed: api.completed,\n        countdown: api.countdown,\n        segments: api.segments,\n        segmentText: api.segmentText,\n        controlAction: api.controlAction,\n        controlLabel: api.controlLabel,\n        start: api.start,\n        pause: api.pause,\n        resume: api.resume,\n        reset: api.reset,\n      })\n      return h(\n        'div',\n        api.getRootProps() as Record<string, unknown>,\n        // 插槽为空（含 v-if 落空只剩注释节点）时退回组件自己铺的时分秒\n        slotPaints(content) ? content : [renderDefaultTree()],\n      )\n    }\n  },\n})\n\nexport const XhTimerDisplay = defineComponent({\n  name: 'XhTimerDisplay',\n  setup(_, { slots }) {\n    const ctx = useTimerContext()\n    return () => h('div', ctx.api.value.getDisplayProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTimerItem = defineComponent({\n  name: 'XhTimerItem',\n  props: {\n    unit: { type: String as PropType<TimerUnit>, required: true },\n  },\n  setup(props) {\n    const ctx = useTimerContext()\n    return () => {\n      const api = ctx.api.value\n      // 这一段的数字恒由组件写，作者只声明它是哪一段：写在条目里的内容留不住，\n      // 下一拍就会被新的数字盖掉，Web Components 侧也是元素接管这段文本\n      return h(\n        'span',\n        api.getItemProps({ unit: props.unit }) as Record<string, unknown>,\n        api.segmentText(props.unit),\n      )\n    }\n  },\n})\n\nexport const XhTimerSeparator = defineComponent({\n  name: 'XhTimerSeparator',\n  setup(_, { slots }) {\n    const ctx = useTimerContext()\n    return () => {\n      const content = slots.default?.()\n      // 缺省是冒号，换成别的记号写进插槽即可\n      return h(\n        'span',\n        ctx.api.value.getSeparatorProps() as Record<string, unknown>,\n        slotPaints(content) ? content : ':',\n      )\n    }\n  },\n})\n\nexport const XhTimerControl = defineComponent({\n  name: 'XhTimerControl',\n  setup(_, { slots }) {\n    const ctx = useTimerContext()\n    return () => {\n      const api = ctx.api.value\n      const content = slots.default?.()\n      // 用原生 button，激活交给平台；没写内容时把当前动作的名字写上去\n      return h(\n        'button',\n        api.getControlProps() as Record<string, unknown>,\n        slotPaints(content) ? content : api.controlLabel,\n      )\n    }\n  },\n})\n\n/**\n * 未写默认插槽时铺设的整套结构：一个时间区，其中是时、分、秒三段与两个冒号。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n */\nfunction renderDefaultTree(): VNode {\n  const children: VNode[] = []\n  for (const [index, unit] of DEFAULT_UNITS.entries()) {\n    if (index > 0)\n      children.push(h(XhTimerSeparator, { key: `separator-${unit}` }))\n    children.push(h(XhTimerItem, { key: unit, unit }))\n  }\n  return h(XhTimerDisplay, null, () => children)\n}\n"],"mappings":"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"}

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

@@ -1,10 +1,10 @@
 import { ComputedRef } from "vue";
+import { Service } from "@xihan-ui/core";
 import { TimerApi, TimerSchema } from "@xihan-ui/headless";
-import { Service } from "@xihan-ui/machine";
 //#region src/components/timer/use-timer.d.ts
 interface TimerContext {
   api: ComputedRef<TimerApi>;
-  /** 机器实例，供组合式调用方直接送事件。 */
+  /** 状态机实例，供组合式调用方直接发送事件。 */
   service: Service<TimerSchema>;
 }
 declare function useTimer(props: TimerSchema['props'], handlers?: Pick<TimerSchema['props'], 'onComplete' | 'onTick'>): TimerContext;

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

@@ -1 +1 @@
-{"version":3,"file":"use-timer.d.ts","names":[],"sources":["../../../src/components/timer/use-timer.ts"],"mappings":";;;;UAQiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;iBAIH,SACd,OAAO,sBACP,WAAU,KAAK,iDACd"}
+{"version":3,"file":"use-timer.d.ts","names":[],"sources":["../../../src/components/timer/use-timer.ts"],"mappings":";;;;UAeiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;iBAIH,SACd,OAAO,sBACP,WAAU,KAAK,iDACd"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-timer.js","names":[],"sources":["../../../src/components/timer/use-timer.ts"],"sourcesContent":["import type { TimerApi, TimerSchema } from '@xihan-ui/headless'\nimport type { Service } from '@xihan-ui/machine'\nimport type { ComputedRef } from 'vue'\nimport { connectTimer, timerMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface TimerContext {\n  api: ComputedRef<TimerApi>\n  /** 机器实例，供组合式调用方直接送事件。 */\n  service: Service<TimerSchema>\n}\n\n// 不建 scope：connect 不派生任何 id\nexport function useTimer(\n  props: TimerSchema['props'],\n  handlers: Pick<TimerSchema['props'], 'onComplete' | 'onTick'> = {},\n): TimerContext {\n  const service = useMachine(timerMachine, () => ({ ...props, ...handlers }))\n  const api = computed(() => connectTimer(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;AAeA,SAAgB,SACd,OACA,WAAgE,CAAC,GACnD;CACd,MAAM,UAAU,WAAW,qBAAqB;EAAE,GAAG;EAAO,GAAG;CAAS,EAAE;CAE1E,OAAO;EAAE,KADG,eAAe,aAAa,SAAS,YAAY,CAClD;EAAG;CAAQ;AACxB"}
+{"version":3,"file":"use-timer.js","names":[],"sources":["../../../src/components/timer/use-timer.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 timer 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { TimerApi, TimerSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectTimer, timerMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface TimerContext {\n  api: ComputedRef<TimerApi>\n  /** 状态机实例，供组合式调用方直接发送事件。 */\n  service: Service<TimerSchema>\n}\n\n// 不建 scope：connect 不派生任何 id\nexport function useTimer(\n  props: TimerSchema['props'],\n  handlers: Pick<TimerSchema['props'], 'onComplete' | 'onTick'> = {},\n): TimerContext {\n  const service = useMachine(timerMachine, () => ({ ...props, ...handlers }))\n  const api = computed(() => connectTimer(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;AAsBA,SAAgB,SACd,OACA,WAAgE,CAAC,GACnD;CACd,MAAM,UAAU,WAAW,qBAAqB;EAAE,GAAG;EAAO,GAAG;CAAS,EAAE;CAE1E,OAAO;EAAE,KADG,eAAe,aAAa,SAAS,YAAY,CAClD;EAAG;CAAQ;AACxB"}

package/dist/components/timestamp/timestamp.d.ts

@@ -0,0 +1,47 @@
+import { PropType } from "vue";
+import { TimestampType, TimestampValue } from "@xihan-ui/headless";
+//#region src/components/timestamp/timestamp.d.ts
+/**
+ * 渲染为 `<time datetime>`：文本供人阅读，datetime 供机器读取，两者取自同一个墙钟。
+ *
+ * 默认插槽中写了内容时使用作者的文本，datetime 仍由组件计算：这正是用它包裹一段
+ * 自行排版的时间表述的用法。插槽为空时铺设组件格式化后的文本。
+ */
+declare const XhTimestamp: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  value: {
+    type: PropType<TimestampValue>;
+  };
+  type: {
+    type: PropType<TimestampType>;
+  };
+  format: {
+    type: StringConstructor;
+  };
+  locale: {
+    type: StringConstructor;
+  };
+  now: {
+    type: PropType<TimestampValue>;
+  };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  value: {
+    type: PropType<TimestampValue>;
+  };
+  type: {
+    type: PropType<TimestampType>;
+  };
+  format: {
+    type: StringConstructor;
+  };
+  locale: {
+    type: StringConstructor;
+  };
+  now: {
+    type: PropType<TimestampValue>;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+export { XhTimestamp };
+//# sourceMappingURL=timestamp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp.d.ts","names":[],"sources":["../../../src/components/timestamp/timestamp.ts"],"mappings":";;;;;;;;;cAqBa,2BAAW,8BAAA;;IAIqB,MAAA,SAAS;;;IAC1B,MAAA,SAAS;;;;;;;;;IAGM,MAAA,SAAS;;;;;;IAJP,MAAA,SAAS;;;IAC1B,MAAA,SAAS;;;;;;;;;IAGM,MAAA,SAAS;;MAsBlD,oDAAA"}

package/dist/components/timestamp/timestamp.js

@@ -0,0 +1,48 @@
+import { vueNormalize } from "../../runtime/normalize-props.js";
+import { withXhConfig } from "../../config/config.js";
+import { slotPaints } from "../../runtime/slot-content.js";
+import { computed, defineComponent, h } from "vue";
+import { connectTimestamp } from "@xihan-ui/headless";
+//#region src/components/timestamp/timestamp.ts
+/**
+* 渲染为 `<time datetime>`：文本供人阅读，datetime 供机器读取，两者取自同一个墙钟。
+*
+* 默认插槽中写了内容时使用作者的文本，datetime 仍由组件计算：这正是用它包裹一段
+* 自行排版的时间表述的用法。插槽为空时铺设组件格式化后的文本。
+*/
+const XhTimestamp = defineComponent({
+	name: "XhTimestamp",
+	props: {
+		value: { type: [
+			String,
+			Number,
+			Date
+		] },
+		type: { type: String },
+		format: { type: String },
+		locale: { type: String },
+		now: { type: [
+			String,
+			Number,
+			Date
+		] }
+	},
+	setup(props, { slots }) {
+		const merged = withXhConfig("timestamp", props);
+		const api = computed(() => connectTimestamp({
+			value: merged.value,
+			type: merged.type,
+			format: merged.format,
+			locale: merged.locale,
+			now: merged.now
+		}, vueNormalize));
+		return () => {
+			const content = slots.default?.();
+			return h("time", api.value.getRootProps(), slotPaints(content) ? content : api.value.text);
+		};
+	}
+});
+//#endregion
+export { XhTimestamp };
+
+//# sourceMappingURL=timestamp.js.map

package/dist/components/timestamp/timestamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp.js","names":[],"sources":["../../../src/components/timestamp/timestamp.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// 提供 timestamp 相关实现。\n\nimport type { TimestampProps, TimestampType, TimestampValue } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectTimestamp } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { slotPaints } from '../../runtime/slot-content'\n\n/**\n * 渲染为 `<time datetime>`：文本供人阅读，datetime 供机器读取，两者取自同一个墙钟。\n *\n * 默认插槽中写了内容时使用作者的文本，datetime 仍由组件计算：这正是用它包裹一段\n * 自行排版的时间表述的用法。插槽为空时铺设组件格式化后的文本。\n */\nexport const XhTimestamp = defineComponent({\n  name: 'XhTimestamp',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    value: { type: [String, Number, Date] as PropType<TimestampValue> },\n    type: { type: String as PropType<TimestampType> },\n    format: { type: String },\n    locale: { type: String },\n    now: { type: [String, Number, Date] as PropType<TimestampValue> },\n  },\n  setup(props, { slots }) {\n    const merged = withXhConfig('timestamp', props)\n    const api = computed(() => connectTimestamp({\n      value: merged.value,\n      type: merged.type,\n      format: merged.format,\n      locale: merged.locale,\n      now: merged.now,\n    } satisfies TimestampProps, vueNormalize))\n\n    return () => {\n      const content = slots.default?.()\n      return h(\n        'time',\n        api.value.getRootProps() as Record<string, unknown>,\n        // 插槽里只剩注释或空白时不算写过东西，那种情况仍铺组件的文本\n        slotPaints(content) ? content : api.value.text,\n      )\n    }\n  },\n})\n"],"mappings":";;;;;;;;;;;;AAqBA,MAAa,cAAc,gBAAgB;CACzC,MAAM;CAEN,OAAO;EACL,OAAO,EAAE,MAAM;GAAC;GAAQ;GAAQ;EAAI,EAA8B;EAClE,MAAM,EAAE,MAAM,OAAkC;EAChD,QAAQ,EAAE,MAAM,OAAO;EACvB,QAAQ,EAAE,MAAM,OAAO;EACvB,KAAK,EAAE,MAAM;GAAC;GAAQ;GAAQ;EAAI,EAA8B;CAClE;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,SAAS,aAAa,aAAa,KAAK;EAC9C,MAAM,MAAM,eAAe,iBAAiB;GAC1C,OAAO,OAAO;GACd,MAAM,OAAO;GACb,QAAQ,OAAO;GACf,QAAQ,OAAO;GACf,KAAK,OAAO;EACd,GAA4B,YAAY,CAAC;EAEzC,aAAa;GACX,MAAM,UAAU,MAAM,UAAU;GAChC,OAAO,EACL,QACA,IAAI,MAAM,aAAa,GAEvB,WAAW,OAAO,IAAI,UAAU,IAAI,MAAM,IAC5C;EACF;CACF;AACF,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/toast/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { ToastContext } from './use-toast'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<ToastContext> = Symbol.for('xh-toast')\n\nexport function provideToast(ctx: ToastContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useToastContext(): ToastContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Toast 部件必须用在 XhToastRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAkC,OAAO,IAAI,UAAU;AAE7D,SAAgB,aAAa,KAAyB;CACpD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,kBAAgC;CAC9C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,iCAAiC;CACnD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/toast/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { InjectionKey } from 'vue'\nimport type { ToastContext } from './use-toast'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<ToastContext> = Symbol.for('xh-toast')\n\nexport function provideToast(ctx: ToastContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useToastContext(): ToastContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Toast 部件必须用在 XhToastRoot 内')\n  return ctx\n}\n"],"mappings":";;AAWA,MAAM,MAAkC,OAAO,IAAI,UAAU;AAE7D,SAAgB,aAAa,KAAyB;CACpD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,kBAAgC;CAC9C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,iCAAiC;CACnD,OAAO;AACT"}