@xihan-ui/vue 2.1.0 → 3.1.0

package/dist/components/typography/typography.js

@@ -45,8 +45,8 @@ const XhTypographyParagraph = defineComponent({
 	}
 });
 /**
-* 行内文字：variant 切换形态，tone 切换语气色，weight 切换字重。
-* as 决定渲染为哪个标签，默认 span；需要 code / strong 的原生语义时自行写明。
+* 行内文字：variant 切换形态，tone 切换语气色，weight 切换字重；删除线、下划线与标记各是一个开关。
+* as 决定渲染为哪个标签，默认 span；需要 code / strong / del / mark 的原生语义时自行写明。
 */
 const XhTypographyText = defineComponent({
 	name: "XhTypographyText",
@@ -54,6 +54,21 @@ const XhTypographyText = defineComponent({
 		tone: { type: String },
 		variant: { type: String },
 		weight: { type: String },
+		/** 删除线：只画线，表达"已删除"时 as 写 del 或 s。 */
+		strikethrough: {
+			type: Boolean,
+			default: void 0
+		},
+		/** 下划线：只画线，与链接同形。 */
+		underline: {
+			type: Boolean,
+			default: void 0
+		},
+		/** 标记：淡底加同族字色，有 tone 时换成该族；表达"被标出"时 as 写 mark。 */
+		mark: {
+			type: Boolean,
+			default: void 0
+		},
 		as: {
 			type: String,
 			default: "span"
@@ -64,7 +79,10 @@ const XhTypographyText = defineComponent({
 		return () => h(props.as, ctx.api.value.getTextProps({
 			tone: props.tone,
 			variant: props.variant,
-			weight: props.weight
+			weight: props.weight,
+			strikethrough: props.strikethrough,
+			underline: props.underline,
+			mark: props.mark
 		}), slots.default?.());
 	}
 });

package/dist/components/typography/typography.js.map

@@ -1 +1 @@
-{"version":3,"file":"typography.js","names":[],"sources":["../../../src/components/typography/typography.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// 提供 typography 相关实现。\n\nimport type { Size, Tone } from '@xihan-ui/core'\nimport type { TypographyAlign, TypographyLevel, TypographyProps, TypographyVariant, TypographyWeight } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectTypography } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideTypography, useTypographyContext } from './context'\n\n/** 正文块容器，管理段间距与最大行宽；默认值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined */\nexport const XhTypographyRoot = defineComponent({\n  name: 'XhTypographyRoot',\n  props: {\n    size: { type: String as PropType<Size> },\n    align: { type: String as PropType<TypographyAlign> },\n    weight: { type: String as PropType<TypographyWeight> },\n  },\n  setup(props, { slots }) {\n    // withXhConfig 只能在 setup 期调，连接层在渲染期读这份代理\n    const configured = withXhConfig('typography', props)\n    const api = computed(() => connectTypography(configured as TypographyProps, vueNormalize))\n    provideTypography({ api })\n    return () => h('div', api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 标题：level 只切换字号档位，不决定标签。\n * as 决定渲染为哪个标签，默认 p；需要进入文档大纲时写 as=\"h2\"。\n */\nexport const XhTypographyHeading = defineComponent({\n  name: 'XhTypographyHeading',\n  props: {\n    level: { type: [Number, String] as PropType<TypographyLevel | string> },\n    as: { type: String, default: 'p' },\n  },\n  setup(props, { slots }) {\n    const ctx = useTypographyContext()\n    return () => h(\n      props.as,\n      ctx.api.value.getHeadingProps({ level: props.level }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhTypographyParagraph = defineComponent({\n  name: 'XhTypographyParagraph',\n  setup(_, { slots }) {\n    const ctx = useTypographyContext()\n    return () => h('p', ctx.api.value.getParagraphProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 行内文字：variant 切换形态，tone 切换语气色，weight 切换字重。\n * as 决定渲染为哪个标签，默认 span；需要 code / strong 的原生语义时自行写明。\n */\nexport const XhTypographyText = defineComponent({\n  name: 'XhTypographyText',\n  props: {\n    tone: { type: String as PropType<Tone> },\n    variant: { type: String as PropType<TypographyVariant> },\n    weight: { type: String as PropType<TypographyWeight> },\n    as: { type: String, default: 'span' },\n  },\n  setup(props, { slots }) {\n    const ctx = useTypographyContext()\n    return () => h(\n      props.as,\n      ctx.api.value.getTextProps({ tone: props.tone, variant: props.variant, weight: props.weight }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\n/**\n * 富文本容器：外来的 HTML（Markdown 渲染结果）铺入其中，样式按标签给出。\n * as 决定渲染为哪个标签，默认 div。\n */\nexport const XhTypographyProse = defineComponent({\n  name: 'XhTypographyProse',\n  props: {\n    as: { type: String, default: 'div' },\n  },\n  setup(props, { slots }) {\n    const ctx = useTypographyContext()\n    return () => h(props.as, ctx.api.value.getProseProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// href、target、rel 由作者写，这里只给身份\nexport const XhTypographyLink = defineComponent({\n  name: 'XhTypographyLink',\n  setup(_, { slots }) {\n    const ctx = useTypographyContext()\n    return () => h('a', ctx.api.value.getLinkProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;;AAiBA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO;EACL,MAAM,EAAE,MAAM,OAAyB;EACvC,OAAO,EAAE,MAAM,OAAoC;EACnD,QAAQ,EAAE,MAAM,OAAqC;CACvD;CACA,MAAM,OAAO,EAAE,SAAS;EAEtB,MAAM,aAAa,aAAa,cAAc,KAAK;EACnD,MAAM,MAAM,eAAe,kBAAkB,YAA+B,YAAY,CAAC;EACzF,kBAAkB,EAAE,IAAI,CAAC;EACzB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAC9F;AACF,CAAC;;;;;AAMD,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,OAAO;EACL,OAAO,EAAE,MAAM,CAAC,QAAQ,MAAM,EAAwC;EACtE,IAAI;GAAE,MAAM;GAAQ,SAAS;EAAI;CACnC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EACX,MAAM,IACN,IAAI,IAAI,MAAM,gBAAgB,EAAE,OAAO,MAAM,MAAM,CAAC,GACpD,MAAM,UAAU,CAClB;CACF;AACF,CAAC;AAED,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;;;;;AAMD,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO;EACL,MAAM,EAAE,MAAM,OAAyB;EACvC,SAAS,EAAE,MAAM,OAAsC;EACvD,QAAQ,EAAE,MAAM,OAAqC;EACrD,IAAI;GAAE,MAAM;GAAQ,SAAS;EAAO;CACtC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EACX,MAAM,IACN,IAAI,IAAI,MAAM,aAAa;GAAE,MAAM,MAAM;GAAM,SAAS,MAAM;GAAS,QAAQ,MAAM;EAAO,CAAC,GAC7F,MAAM,UAAU,CAClB;CACF;AACF,CAAC;;;;;AAMD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,OAAO,EACL,IAAI;EAAE,MAAM;EAAQ,SAAS;CAAM,EACrC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,MAAM,IAAI,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACtG;AACF,CAAC;AAGD,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAChG;AACF,CAAC"}
+{"version":3,"file":"typography.js","names":[],"sources":["../../../src/components/typography/typography.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// 提供 typography 相关实现。\n\nimport type { Size, Tone } from '@xihan-ui/core'\nimport type { TypographyAlign, TypographyLevel, TypographyProps, TypographyVariant, TypographyWeight } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectTypography } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideTypography, useTypographyContext } from './context'\n\n/** 正文块容器，管理段间距与最大行宽；默认值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined */\nexport const XhTypographyRoot = defineComponent({\n  name: 'XhTypographyRoot',\n  props: {\n    size: { type: String as PropType<Size> },\n    align: { type: String as PropType<TypographyAlign> },\n    weight: { type: String as PropType<TypographyWeight> },\n  },\n  setup(props, { slots }) {\n    // withXhConfig 只能在 setup 期调，连接层在渲染期读这份代理\n    const configured = withXhConfig('typography', props)\n    const api = computed(() => connectTypography(configured as TypographyProps, vueNormalize))\n    provideTypography({ api })\n    return () => h('div', api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 标题：level 只切换字号档位，不决定标签。\n * as 决定渲染为哪个标签，默认 p；需要进入文档大纲时写 as=\"h2\"。\n */\nexport const XhTypographyHeading = defineComponent({\n  name: 'XhTypographyHeading',\n  props: {\n    level: { type: [Number, String] as PropType<TypographyLevel | string> },\n    as: { type: String, default: 'p' },\n  },\n  setup(props, { slots }) {\n    const ctx = useTypographyContext()\n    return () => h(\n      props.as,\n      ctx.api.value.getHeadingProps({ level: props.level }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhTypographyParagraph = defineComponent({\n  name: 'XhTypographyParagraph',\n  setup(_, { slots }) {\n    const ctx = useTypographyContext()\n    return () => h('p', ctx.api.value.getParagraphProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 行内文字：variant 切换形态，tone 切换语气色，weight 切换字重；删除线、下划线与标记各是一个开关。\n * as 决定渲染为哪个标签，默认 span；需要 code / strong / del / mark 的原生语义时自行写明。\n */\nexport const XhTypographyText = defineComponent({\n  name: 'XhTypographyText',\n  props: {\n    tone: { type: String as PropType<Tone> },\n    variant: { type: String as PropType<TypographyVariant> },\n    weight: { type: String as PropType<TypographyWeight> },\n    /** 删除线：只画线，表达\"已删除\"时 as 写 del 或 s。 */\n    strikethrough: { type: Boolean, default: undefined },\n    /** 下划线：只画线，与链接同形。 */\n    underline: { type: Boolean, default: undefined },\n    /** 标记：淡底加同族字色，有 tone 时换成该族；表达\"被标出\"时 as 写 mark。 */\n    mark: { type: Boolean, default: undefined },\n    as: { type: String, default: 'span' },\n  },\n  setup(props, { slots }) {\n    const ctx = useTypographyContext()\n    return () => h(\n      props.as,\n      ctx.api.value.getTextProps({\n        tone: props.tone,\n        variant: props.variant,\n        weight: props.weight,\n        strikethrough: props.strikethrough,\n        underline: props.underline,\n        mark: props.mark,\n      }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\n/**\n * 富文本容器：外来的 HTML（Markdown 渲染结果）铺入其中，样式按标签给出。\n * as 决定渲染为哪个标签，默认 div。\n */\nexport const XhTypographyProse = defineComponent({\n  name: 'XhTypographyProse',\n  props: {\n    as: { type: String, default: 'div' },\n  },\n  setup(props, { slots }) {\n    const ctx = useTypographyContext()\n    return () => h(props.as, ctx.api.value.getProseProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// href、target、rel 由作者写，这里只给身份\nexport const XhTypographyLink = defineComponent({\n  name: 'XhTypographyLink',\n  setup(_, { slots }) {\n    const ctx = useTypographyContext()\n    return () => h('a', ctx.api.value.getLinkProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;;AAiBA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO;EACL,MAAM,EAAE,MAAM,OAAyB;EACvC,OAAO,EAAE,MAAM,OAAoC;EACnD,QAAQ,EAAE,MAAM,OAAqC;CACvD;CACA,MAAM,OAAO,EAAE,SAAS;EAEtB,MAAM,aAAa,aAAa,cAAc,KAAK;EACnD,MAAM,MAAM,eAAe,kBAAkB,YAA+B,YAAY,CAAC;EACzF,kBAAkB,EAAE,IAAI,CAAC;EACzB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAC9F;AACF,CAAC;;;;;AAMD,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,OAAO;EACL,OAAO,EAAE,MAAM,CAAC,QAAQ,MAAM,EAAwC;EACtE,IAAI;GAAE,MAAM;GAAQ,SAAS;EAAI;CACnC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EACX,MAAM,IACN,IAAI,IAAI,MAAM,gBAAgB,EAAE,OAAO,MAAM,MAAM,CAAC,GACpD,MAAM,UAAU,CAClB;CACF;AACF,CAAC;AAED,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;;;;;AAMD,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO;EACL,MAAM,EAAE,MAAM,OAAyB;EACvC,SAAS,EAAE,MAAM,OAAsC;EACvD,QAAQ,EAAE,MAAM,OAAqC;;EAErD,eAAe;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;;EAEnD,WAAW;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;;EAE/C,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,IAAI;GAAE,MAAM;GAAQ,SAAS;EAAO;CACtC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EACX,MAAM,IACN,IAAI,IAAI,MAAM,aAAa;GACzB,MAAM,MAAM;GACZ,SAAS,MAAM;GACf,QAAQ,MAAM;GACd,eAAe,MAAM;GACrB,WAAW,MAAM;GACjB,MAAM,MAAM;EACd,CAAC,GACD,MAAM,UAAU,CAClB;CACF;AACF,CAAC;;;;;AAMD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,OAAO,EACL,IAAI;EAAE,MAAM;EAAQ,SAAS;CAAM,EACrC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,MAAM,IAAI,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACtG;AACF,CAAC;AAGD,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAChG;AACF,CAAC"}

package/dist/components/virtualizer/virtualizer.d.ts

@@ -1,10 +1,10 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
-import { VirtualizerApi, VirtualizerRangeChangeDetails, VirtualizerSchema } from "@xihan-ui/headless";
+import { VirtualizerAnchor, VirtualizerApi, VirtualizerRangeChangeDetails, VirtualizerSchema, VirtualizerScrollContainer } from "@xihan-ui/headless";
 //#region src/components/virtualizer/virtualizer.d.ts
 type VirtualizerProps = VirtualizerSchema['props'];
 /** 默认插槽的载荷：当前应渲染的条目与总长、可视区首末下标与滚动态，以及滚动与测量尺寸的动作。 */
-type VirtualizerRootSlotProps = Pick<VirtualizerApi, 'virtualItems' | 'totalSize' | 'startIndex' | 'endIndex' | 'scrolling' | 'lanes' | 'scrollToIndex' | 'measureElement' | 'measure'>;
+type VirtualizerRootSlotProps = Pick<VirtualizerApi, 'virtualItems' | 'totalSize' | 'startIndex' | 'endIndex' | 'scrolling' | 'lanes' | 'collectionVirtualizer' | 'scrollToIndex' | 'measureElement' | 'measure'>;
 declare const XhVirtualizerRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   count: {
     type: NumberConstructor;
@@ -37,6 +37,18 @@ declare const XhVirtualizerRoot: import("vue").DefineComponent<import("vue").Ext
   lanes: {
     type: NumberConstructor;
   };
+  viewportTabIndex: {
+    type: NumberConstructor;
+  };
+  scrollContainer: {
+    type: PropType<VirtualizerScrollContainer>;
+  };
+  anchor: {
+    type: PropType<VirtualizerAnchor>;
+  };
+  stickyIndices: {
+    type: PropType<number[]>;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
@@ -73,6 +85,18 @@ declare const XhVirtualizerRoot: import("vue").DefineComponent<import("vue").Ext
   lanes: {
     type: NumberConstructor;
   };
+  viewportTabIndex: {
+    type: NumberConstructor;
+  };
+  scrollContainer: {
+    type: PropType<VirtualizerScrollContainer>;
+  };
+  anchor: {
+    type: PropType<VirtualizerAnchor>;
+  };
+  stickyIndices: {
+    type: PropType<number[]>;
+  };
 }>> & Readonly<{
   "onRange-change"?: ((_details: VirtualizerRangeChangeDetails) => any) | undefined;
 }>, {

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

@@ -1 +1 @@
-{"version":3,"file":"virtualizer.d.ts","names":[],"sources":["../../../src/components/virtualizer/virtualizer.ts"],"mappings":";;;;KAcK,mBAAmB;;KAGZ,2BAA2B,KACrC;cAYW,iCAAiB,8BAAA;;;;;IAKkB,MAAA,oBAAoB;;;;;;;;;;;;;IAIhC,MAAA,UAAU;;;;;;;;;;;;;;;;;EAQf,iBAAA,UAAA,UAAU;;;;;;IAZO,MAAA,oBAAoB;;;;;;;;;;;;;IAIhC,MAAA,UAAU;;;;;;;;;;;;;;;;;;;EAWhC,WAAC,OAAO,6BAA6B;kCAkBjD;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAUhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAS/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,8BAAA;;;IAIS,MAAA;;;;;;;;;;;;;IAAA,MAAA;;;;;;;;;;qCAqBrC"}
+{"version":3,"file":"virtualizer.d.ts","names":[],"sources":["../../../src/components/virtualizer/virtualizer.ts"],"mappings":";;;;KAcK,mBAAmB;;KAGZ,2BAA2B,KACrC;cAaW,iCAAiB,8BAAA;;;;;IAKkB,MAAA,oBAAoB;;;;;;;;;;;;;IAIhC,MAAA,UAAU;;;;;;;;;;;;;;;;;;IAMP,MAAA,SAAS;;;IAClB,MAAA,SAAS;;;IACH,MAAA;;;;;EAIL,iBAAA,UAAA,UAAU;;;;;;IAhBO,MAAA,oBAAoB;;;;;;;;;;;;;IAIhC,MAAA,UAAU;;;;;;;;;;;;;;;;;;IAMP,MAAA,SAAS;;;IAClB,MAAA,SAAS;;;IACH,MAAA;;;;;;;EAOtB,WAAC,OAAO,6BAA6B;kCAmBjD;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAUhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAS/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,8BAAA;;;IAIS,MAAA;;;;;;;;;;;;;IAAA,MAAA;;;;;;;;;;qCAqCrC"}

package/dist/components/virtualizer/virtualizer.js

@@ -1,6 +1,6 @@
 import { useVirtualizer } from "./use-virtualizer.js";
 import { provideVirtualizer, useVirtualizerContext } from "./context.js";
-import { defineComponent, h, onMounted, onUpdated, ref } from "vue";
+import { defineComponent, h, onBeforeUnmount, onMounted, onUpdated, ref } from "vue";
 //#region src/components/virtualizer/virtualizer.ts
 const XhVirtualizerRoot = defineComponent({
 	name: "XhVirtualizerRoot",
@@ -17,7 +17,11 @@ const XhVirtualizerRoot = defineComponent({
 		scrollMargin: { type: Number },
 		paddingStart: { type: Number },
 		paddingEnd: { type: Number },
-		lanes: { type: Number }
+		lanes: { type: Number },
+		viewportTabIndex: { type: Number },
+		scrollContainer: { type: String },
+		anchor: { type: String },
+		stickyIndices: { type: Array }
 	},
 	emits: { "range-change": (_details) => true },
 	slots: Object,
@@ -32,6 +36,7 @@ const XhVirtualizerRoot = defineComponent({
 			endIndex: ctx.api.value.endIndex,
 			scrolling: ctx.api.value.scrolling,
 			lanes: ctx.api.value.lanes,
+			collectionVirtualizer: ctx.api.value.collectionVirtualizer,
 			scrollToIndex: ctx.api.value.scrollToIndex,
 			measureElement: ctx.api.value.measureElement,
 			measure: ctx.api.value.measure
@@ -75,14 +80,26 @@ const XhVirtualizerItem = defineComponent({
 	setup(props, { slots }) {
 		const ctx = useVirtualizerContext();
 		const el = ref(null);
+		let registeredIndex = null;
+		const bindItem = (value) => {
+			const node = value;
+			const next = Number(props.value);
+			if (registeredIndex != null && (node == null || registeredIndex !== next)) ctx.api.value.registerItemElement(registeredIndex, null);
+			registeredIndex = node == null ? null : next;
+			el.value = node;
+			if (node) ctx.api.value.registerItemElement(next, node);
+		};
 		const report = () => {
 			if (props.measure) ctx.api.value.measureElement(el.value);
 		};
 		onMounted(report);
 		onUpdated(report);
+		onBeforeUnmount(() => {
+			if (registeredIndex != null) ctx.api.value.registerItemElement(registeredIndex, null);
+		});
 		return () => h("div", {
 			...ctx.api.value.getItemProps({ index: Number(props.value) }),
-			ref: el
+			ref: bindItem
 		}, slots.default?.());
 	}
 });

package/dist/components/virtualizer/virtualizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"virtualizer.js","names":[],"sources":["../../../src/components/virtualizer/virtualizer.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// 提供 virtualizer 相关实现。\n\nimport type { VirtualizerApi, VirtualizerRangeChangeDetails, VirtualizerSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, onMounted, onUpdated, ref } from 'vue'\nimport { provideVirtualizer, useVirtualizerContext } from './context'\nimport { useVirtualizer } from './use-virtualizer'\n\ntype VirtualizerProps = VirtualizerSchema['props']\n\n/** 默认插槽的载荷：当前应渲染的条目与总长、可视区首末下标与滚动态，以及滚动与测量尺寸的动作。 */\nexport type VirtualizerRootSlotProps = Pick<\n  VirtualizerApi,\n  | 'virtualItems'\n  | 'totalSize'\n  | 'startIndex'\n  | 'endIndex'\n  | 'scrolling'\n  | 'lanes'\n  | 'scrollToIndex'\n  | 'measureElement'\n  | 'measure'\n>\n\nexport const XhVirtualizerRoot = defineComponent({\n  name: 'XhVirtualizerRoot',\n  // 有机器与 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    count: { type: Number },\n    estimateSize: { type: [Number, Function] as PropType<number | ((index: number) => number)> },\n    overscan: { type: Number },\n    horizontal: { type: Boolean, default: undefined },\n    gap: { type: Number },\n    getItemKey: { type: Function as PropType<(index: number) => string | number> },\n    scrollMargin: { type: Number },\n    paddingStart: { type: Number },\n    paddingEnd: { type: Number },\n    lanes: { type: Number },\n  },\n  // change 携带当前该渲染哪些条目的详情\n  emits: {\n    'range-change': (_details: PayloadOf<VirtualizerProps, 'onRangeChange'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: VirtualizerRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: VirtualizerProps['onRangeChange'] = (details: VirtualizerRangeChangeDetails) => emit('range-change', details)\n    const ctx = useVirtualizer(props as VirtualizerProps, notify)\n    provideVirtualizer(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      virtualItems: ctx.api.value.virtualItems,\n      totalSize: ctx.api.value.totalSize,\n      startIndex: ctx.api.value.startIndex,\n      endIndex: ctx.api.value.endIndex,\n      scrolling: ctx.api.value.scrolling,\n      lanes: ctx.api.value.lanes,\n      scrollToIndex: ctx.api.value.scrollToIndex,\n      measureElement: ctx.api.value.measureElement,\n      measure: ctx.api.value.measure,\n    }))\n  },\n})\n\nexport const XhVirtualizerViewport = defineComponent({\n  name: 'XhVirtualizerViewport',\n  setup(_, { slots }) {\n    const ctx = useVirtualizerContext()\n    // 视口节点经 ref 交给机器，由内核在效应里接上\n    return () => h('div', {\n      ...ctx.api.value.getViewportProps() as Record<string, unknown>,\n      ref: ctx.viewportRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhVirtualizerContent = defineComponent({\n  name: 'XhVirtualizerContent',\n  setup(_, { slots }) {\n    const ctx = useVirtualizerContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      ref: ctx.contentRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhVirtualizerItem = defineComponent({\n  name: 'XhVirtualizerItem',\n  props: {\n    /** 该节点的下标。 */\n    value: { type: [Number, String] as PropType<number | string>, required: true },\n    /** 是否把真实尺寸回传给内核；未开启时条目尺寸按 estimateSize 计算。 */\n    measure: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useVirtualizerContext()\n    const el = ref<HTMLElement | null>(null)\n\n    // 在挂载与更新后量尺寸，此时节点已落进 DOM\n    const report = (): void => {\n      if (props.measure)\n        ctx.api.value.measureElement(el.value)\n    }\n    onMounted(report)\n    onUpdated(report)\n\n    return () => h('div', {\n      ...ctx.api.value.getItemProps({ index: Number(props.value) }) as Record<string, unknown>,\n      ref: el,\n    }, slots.default?.())\n  },\n})\n"],"mappings":";;;;AA8BA,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CAEN,OAAO;EACL,OAAO,EAAE,MAAM,OAAO;EACtB,cAAc,EAAE,MAAM,CAAC,QAAQ,QAAQ,EAAoD;EAC3F,UAAU,EAAE,MAAM,OAAO;EACzB,YAAY;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAChD,KAAK,EAAE,MAAM,OAAO;EACpB,YAAY,EAAE,MAAM,SAAyD;EAC7E,cAAc,EAAE,MAAM,OAAO;EAC7B,cAAc,EAAE,MAAM,OAAO;EAC7B,YAAY,EAAE,MAAM,OAAO;EAC3B,OAAO,EAAE,MAAM,OAAO;CACxB;CAEA,OAAO,EACL,iBAAiB,aAA2D,KAC9E;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA6C,YAA2C,KAAK,gBAAgB,OAAO;EAC1H,MAAM,MAAM,eAAe,OAA2B,MAAM;EAC5D,mBAAmB,GAAG;EACtB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,cAAc,IAAI,IAAI,MAAM;GAC5B,WAAW,IAAI,IAAI,MAAM;GACzB,YAAY,IAAI,IAAI,MAAM;GAC1B,UAAU,IAAI,IAAI,MAAM;GACxB,WAAW,IAAI,IAAI,MAAM;GACzB,OAAO,IAAI,IAAI,MAAM;GACrB,eAAe,IAAI,IAAI,MAAM;GAC7B,gBAAgB,IAAI,IAAI,MAAM;GAC9B,SAAS,IAAI,IAAI,MAAM;EACzB,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAElC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,iBAAiB;GAClC,KAAK,IAAI;EACX,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,gBAAgB;GACjC,KAAK,IAAI;EACX,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,OAAO;;EAEL,OAAO;GAAE,MAAM,CAAC,QAAQ,MAAM;GAAgC,UAAU;EAAK;;EAE7E,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;CAC/C;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,sBAAsB;EAClC,MAAM,KAAK,IAAwB,IAAI;EAGvC,MAAM,eAAqB;GACzB,IAAI,MAAM,SACR,IAAI,IAAI,MAAM,eAAe,GAAG,KAAK;EACzC;EACA,UAAU,MAAM;EAChB,UAAU,MAAM;EAEhB,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,aAAa,EAAE,OAAO,OAAO,MAAM,KAAK,EAAE,CAAC;GAC5D,KAAK;EACP,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC"}
+{"version":3,"file":"virtualizer.js","names":[],"sources":["../../../src/components/virtualizer/virtualizer.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// 提供 virtualizer 相关实现。\n\nimport type { VirtualizerAnchor, VirtualizerApi, VirtualizerRangeChangeDetails, VirtualizerSchema, VirtualizerScrollContainer } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, onBeforeUnmount, onMounted, onUpdated, ref } from 'vue'\nimport { provideVirtualizer, useVirtualizerContext } from './context'\nimport { useVirtualizer } from './use-virtualizer'\n\ntype VirtualizerProps = VirtualizerSchema['props']\n\n/** 默认插槽的载荷：当前应渲染的条目与总长、可视区首末下标与滚动态，以及滚动与测量尺寸的动作。 */\nexport type VirtualizerRootSlotProps = Pick<\n  VirtualizerApi,\n  | 'virtualItems'\n  | 'totalSize'\n  | 'startIndex'\n  | 'endIndex'\n  | 'scrolling'\n  | 'lanes'\n  | 'collectionVirtualizer'\n  | 'scrollToIndex'\n  | 'measureElement'\n  | 'measure'\n>\n\nexport const XhVirtualizerRoot = defineComponent({\n  name: 'XhVirtualizerRoot',\n  // 有机器与 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    count: { type: Number },\n    estimateSize: { type: [Number, Function] as PropType<number | ((index: number) => number)> },\n    overscan: { type: Number },\n    horizontal: { type: Boolean, default: undefined },\n    gap: { type: Number },\n    getItemKey: { type: Function as PropType<(index: number) => string | number> },\n    scrollMargin: { type: Number },\n    paddingStart: { type: Number },\n    paddingEnd: { type: Number },\n    lanes: { type: Number },\n    viewportTabIndex: { type: Number },\n    scrollContainer: { type: String as PropType<VirtualizerScrollContainer> },\n    anchor: { type: String as PropType<VirtualizerAnchor> },\n    stickyIndices: { type: Array as PropType<number[]> },\n  },\n  // change 携带当前该渲染哪些条目的详情\n  emits: {\n    'range-change': (_details: PayloadOf<VirtualizerProps, 'onRangeChange'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: VirtualizerRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: VirtualizerProps['onRangeChange'] = (details: VirtualizerRangeChangeDetails) => emit('range-change', details)\n    const ctx = useVirtualizer(props as VirtualizerProps, notify)\n    provideVirtualizer(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      virtualItems: ctx.api.value.virtualItems,\n      totalSize: ctx.api.value.totalSize,\n      startIndex: ctx.api.value.startIndex,\n      endIndex: ctx.api.value.endIndex,\n      scrolling: ctx.api.value.scrolling,\n      lanes: ctx.api.value.lanes,\n      collectionVirtualizer: ctx.api.value.collectionVirtualizer,\n      scrollToIndex: ctx.api.value.scrollToIndex,\n      measureElement: ctx.api.value.measureElement,\n      measure: ctx.api.value.measure,\n    }))\n  },\n})\n\nexport const XhVirtualizerViewport = defineComponent({\n  name: 'XhVirtualizerViewport',\n  setup(_, { slots }) {\n    const ctx = useVirtualizerContext()\n    // 视口节点经 ref 交给机器，由内核在效应里接上\n    return () => h('div', {\n      ...ctx.api.value.getViewportProps() as Record<string, unknown>,\n      ref: ctx.viewportRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhVirtualizerContent = defineComponent({\n  name: 'XhVirtualizerContent',\n  setup(_, { slots }) {\n    const ctx = useVirtualizerContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      ref: ctx.contentRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhVirtualizerItem = defineComponent({\n  name: 'XhVirtualizerItem',\n  props: {\n    /** 该节点的下标。 */\n    value: { type: [Number, String] as PropType<number | string>, required: true },\n    /** 是否把真实尺寸回传给内核；未开启时条目尺寸按 estimateSize 计算。 */\n    measure: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useVirtualizerContext()\n    const el = ref<HTMLElement | null>(null)\n    let registeredIndex: number | null = null\n\n    const bindItem = (value: unknown): void => {\n      const node = value as HTMLElement | null\n      const next = Number(props.value)\n      if (registeredIndex != null && (node == null || registeredIndex !== next))\n        ctx.api.value.registerItemElement(registeredIndex, null)\n      registeredIndex = node == null ? null : next\n      el.value = node\n      if (node)\n        ctx.api.value.registerItemElement(next, node)\n    }\n\n    // 在挂载与更新后量尺寸，此时节点已落进 DOM\n    const report = (): void => {\n      if (props.measure)\n        ctx.api.value.measureElement(el.value)\n    }\n    onMounted(report)\n    onUpdated(report)\n    onBeforeUnmount(() => {\n      if (registeredIndex != null)\n        ctx.api.value.registerItemElement(registeredIndex, null)\n    })\n\n    return () => h('div', {\n      ...ctx.api.value.getItemProps({ index: Number(props.value) }) as Record<string, unknown>,\n      ref: bindItem,\n    }, slots.default?.())\n  },\n})\n"],"mappings":";;;;AA+BA,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CAEN,OAAO;EACL,OAAO,EAAE,MAAM,OAAO;EACtB,cAAc,EAAE,MAAM,CAAC,QAAQ,QAAQ,EAAoD;EAC3F,UAAU,EAAE,MAAM,OAAO;EACzB,YAAY;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAChD,KAAK,EAAE,MAAM,OAAO;EACpB,YAAY,EAAE,MAAM,SAAyD;EAC7E,cAAc,EAAE,MAAM,OAAO;EAC7B,cAAc,EAAE,MAAM,OAAO;EAC7B,YAAY,EAAE,MAAM,OAAO;EAC3B,OAAO,EAAE,MAAM,OAAO;EACtB,kBAAkB,EAAE,MAAM,OAAO;EACjC,iBAAiB,EAAE,MAAM,OAA+C;EACxE,QAAQ,EAAE,MAAM,OAAsC;EACtD,eAAe,EAAE,MAAM,MAA4B;CACrD;CAEA,OAAO,EACL,iBAAiB,aAA2D,KAC9E;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA6C,YAA2C,KAAK,gBAAgB,OAAO;EAC1H,MAAM,MAAM,eAAe,OAA2B,MAAM;EAC5D,mBAAmB,GAAG;EACtB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,cAAc,IAAI,IAAI,MAAM;GAC5B,WAAW,IAAI,IAAI,MAAM;GACzB,YAAY,IAAI,IAAI,MAAM;GAC1B,UAAU,IAAI,IAAI,MAAM;GACxB,WAAW,IAAI,IAAI,MAAM;GACzB,OAAO,IAAI,IAAI,MAAM;GACrB,uBAAuB,IAAI,IAAI,MAAM;GACrC,eAAe,IAAI,IAAI,MAAM;GAC7B,gBAAgB,IAAI,IAAI,MAAM;GAC9B,SAAS,IAAI,IAAI,MAAM;EACzB,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAElC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,iBAAiB;GAClC,KAAK,IAAI;EACX,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,gBAAgB;GACjC,KAAK,IAAI;EACX,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,OAAO;;EAEL,OAAO;GAAE,MAAM,CAAC,QAAQ,MAAM;GAAgC,UAAU;EAAK;;EAE7E,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;CAC/C;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,sBAAsB;EAClC,MAAM,KAAK,IAAwB,IAAI;EACvC,IAAI,kBAAiC;EAErC,MAAM,YAAY,UAAyB;GACzC,MAAM,OAAO;GACb,MAAM,OAAO,OAAO,MAAM,KAAK;GAC/B,IAAI,mBAAmB,SAAS,QAAQ,QAAQ,oBAAoB,OAClE,IAAI,IAAI,MAAM,oBAAoB,iBAAiB,IAAI;GACzD,kBAAkB,QAAQ,OAAO,OAAO;GACxC,GAAG,QAAQ;GACX,IAAI,MACF,IAAI,IAAI,MAAM,oBAAoB,MAAM,IAAI;EAChD;EAGA,MAAM,eAAqB;GACzB,IAAI,MAAM,SACR,IAAI,IAAI,MAAM,eAAe,GAAG,KAAK;EACzC;EACA,UAAU,MAAM;EAChB,UAAU,MAAM;EAChB,sBAAsB;GACpB,IAAI,mBAAmB,MACrB,IAAI,IAAI,MAAM,oBAAoB,iBAAiB,IAAI;EAC3D,CAAC;EAED,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,aAAa,EAAE,OAAO,OAAO,MAAM,KAAK,EAAE,CAAC;GAC5D,KAAK;EACP,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC"}

package/dist/components/watermark/watermark.d.ts

@@ -4,6 +4,7 @@ import { WatermarkImageSize } from "@xihan-ui/headless";
 /**
  * 水印覆盖的区域。图样由 connect 计算为一张 SVG，写为根上的内联 CSS 变量，
  * 由皮肤铺为一层覆盖在内容之上的伪元素：印记因此不进入无障碍树、不接收点击、也不可选中。
+ * 机器负责地址形式图片的取回与防篡改，根节点经 refs 交给它。
  */
 declare const XhWatermarkRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   text: {
@@ -30,6 +31,11 @@ declare const XhWatermarkRoot: import("vue").DefineComponent<import("vue").Extra
   imageSize: {
     type: PropType<WatermarkImageSize>;
   };
+  /** 全屏档：印子固定铺满整个视口。 */
+  fullscreen: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
 }>, () => 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<{
@@ -57,7 +63,14 @@ declare const XhWatermarkRoot: import("vue").DefineComponent<import("vue").Extra
   imageSize: {
     type: PropType<WatermarkImageSize>;
   };
-}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+  /** 全屏档：印子固定铺满整个视口。 */
+  fullscreen: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+}>> & Readonly<{}>, {
+  fullscreen: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /** 被覆盖的内容。 */
 declare const XhWatermarkContent: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;

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

@@ -1 +1 @@
-{"version":3,"file":"watermark.d.ts","names":[],"sources":["../../../src/components/watermark/watermark.ts"],"mappings":";;;;;;;cAkBa,+BAAe,8BAAA;;IAIS,MAAA;;;;;;;;;;;;;;;;;;;;;IAOJ,MAAA,SAAS;;;;;;IAPL,MAAA;;;;;;;;;;;;;;;;;;;;;IAOJ,MAAA,SAAS;;MAOxC,oDAAA;;cAGW,kCAAkB,wCAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"watermark.d.ts","names":[],"sources":["../../../src/components/watermark/watermark.ts"],"mappings":";;;;;;;;cAoBa,+BAAe,8BAAA;;IAIS,MAAA;;;;;;;;;;;;;;;;;;;;;IAOJ,MAAA,SAAS;;;;;;;;;;;IAPL,MAAA;;;;;;;;;;;;;;;;;;;;;IAOJ,MAAA,SAAS;;;;;;;;;qCAexC;;cAGW,kCAAkB,wCAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/watermark/watermark.js

@@ -1,11 +1,13 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
+import { useMachine } from "../../runtime/use-machine.js";
 import { provideWatermark, useWatermarkContext } from "./context.js";
-import { computed, defineComponent, h } from "vue";
-import { connectWatermark } from "@xihan-ui/headless";
+import { computed, defineComponent, h, ref } from "vue";
+import { connectWatermark, watermarkMachine } from "@xihan-ui/headless";
 //#region src/components/watermark/watermark.ts
 /**
 * 水印覆盖的区域。图样由 connect 计算为一张 SVG，写为根上的内联 CSS 变量，
 * 由皮肤铺为一层覆盖在内容之上的伪元素：印记因此不进入无障碍树、不接收点击、也不可选中。
+* 机器负责地址形式图片的取回与防篡改，根节点经 refs 交给它。
 */
 const XhWatermarkRoot = defineComponent({
 	name: "XhWatermarkRoot",
@@ -17,12 +19,25 @@ const XhWatermarkRoot = defineComponent({
 		opacity: { type: Number },
 		fontFamily: { type: String },
 		image: { type: String },
-		imageSize: { type: Object }
+		imageSize: { type: Object },
+		/** 全屏档：印子固定铺满整个视口。 */
+		fullscreen: {
+			type: Boolean,
+			default: void 0
+		}
 	},
 	setup(props, { slots }) {
-		const api = computed(() => connectWatermark(props, vueNormalize));
+		const rootRef = ref(null);
+		const service = useMachine(watermarkMachine, () => ({ ...props }));
+		service.refs.set("getRootEl", () => rootRef.value);
+		const api = computed(() => connectWatermark(service, vueNormalize));
 		provideWatermark({ api });
-		return () => h("div", api.value.getRootProps(), slots.default?.());
+		return () => h("div", {
+			...api.value.getRootProps(),
+			ref: (el) => {
+				rootRef.value = el;
+			}
+		}, slots.default?.());
 	}
 });
 /** 被覆盖的内容。 */

package/dist/components/watermark/watermark.js.map

@@ -1 +1 @@
-{"version":3,"file":"watermark.js","names":[],"sources":["../../../src/components/watermark/watermark.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// 提供 watermark 相关实现。\n\nimport type { WatermarkImageSize, WatermarkProps } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectWatermark } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideWatermark, useWatermarkContext } from './context'\n\n/**\n * 水印覆盖的区域。图样由 connect 计算为一张 SVG，写为根上的内联 CSS 变量，\n * 由皮肤铺为一层覆盖在内容之上的伪元素：印记因此不进入无障碍树、不接收点击、也不可选中。\n */\nexport const XhWatermarkRoot = defineComponent({\n  name: 'XhWatermarkRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    text: { type: [String, Array] as PropType<string | string[]> },\n    rotate: { type: Number },\n    gap: { type: Number },\n    fontSize: { type: Number },\n    opacity: { type: Number },\n    fontFamily: { type: String },\n    image: { type: String },\n    imageSize: { type: Object as PropType<WatermarkImageSize> },\n  },\n  setup(props, { slots }) {\n    const api = computed(() => connectWatermark(props as WatermarkProps, vueNormalize))\n    provideWatermark({ api })\n    return () => h('div', api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 被覆盖的内容。 */\nexport const XhWatermarkContent = defineComponent({\n  name: 'XhWatermarkContent',\n  setup(_, { slots }) {\n    const ctx = useWatermarkContext()\n    return () => h('div', ctx.api.value.getContentProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;;;;AAkBA,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CAEN,OAAO;EACL,MAAM,EAAE,MAAM,CAAC,QAAQ,KAAK,EAAiC;EAC7D,QAAQ,EAAE,MAAM,OAAO;EACvB,KAAK,EAAE,MAAM,OAAO;EACpB,UAAU,EAAE,MAAM,OAAO;EACzB,SAAS,EAAE,MAAM,OAAO;EACxB,YAAY,EAAE,MAAM,OAAO;EAC3B,OAAO,EAAE,MAAM,OAAO;EACtB,WAAW,EAAE,MAAM,OAAuC;CAC5D;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe,iBAAiB,OAAyB,YAAY,CAAC;EAClF,iBAAiB,EAAE,IAAI,CAAC;EACxB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAC9F;AACF,CAAC;;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,oBAAoB;EAChC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC"}
+{"version":3,"file":"watermark.js","names":[],"sources":["../../../src/components/watermark/watermark.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// 提供 watermark 相关实现。\n\nimport type { WatermarkImageSize, WatermarkProps } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectWatermark, watermarkMachine } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { provideWatermark, useWatermarkContext } from './context'\n\n/**\n * 水印覆盖的区域。图样由 connect 计算为一张 SVG，写为根上的内联 CSS 变量，\n * 由皮肤铺为一层覆盖在内容之上的伪元素：印记因此不进入无障碍树、不接收点击、也不可选中。\n * 机器负责地址形式图片的取回与防篡改，根节点经 refs 交给它。\n */\nexport const XhWatermarkRoot = defineComponent({\n  name: 'XhWatermarkRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    text: { type: [String, Array] as PropType<string | string[]> },\n    rotate: { type: Number },\n    gap: { type: Number },\n    fontSize: { type: Number },\n    opacity: { type: Number },\n    fontFamily: { type: String },\n    image: { type: String },\n    imageSize: { type: Object as PropType<WatermarkImageSize> },\n    /** 全屏档：印子固定铺满整个视口。 */\n    fullscreen: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const rootRef = ref<HTMLElement | null>(null)\n    const service = useMachine(watermarkMachine, () => ({ ...props }) as WatermarkProps)\n    service.refs.set('getRootEl', () => rootRef.value)\n    const api = computed(() => connectWatermark(service, vueNormalize))\n    provideWatermark({ api })\n    return () => h('div', {\n      ...api.value.getRootProps() as Record<string, unknown>,\n      ref: (el: unknown) => { rootRef.value = el as HTMLElement | null },\n    }, slots.default?.())\n  },\n})\n\n/** 被覆盖的内容。 */\nexport const XhWatermarkContent = defineComponent({\n  name: 'XhWatermarkContent',\n  setup(_, { slots }) {\n    const ctx = useWatermarkContext()\n    return () => h('div', ctx.api.value.getContentProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;;;;;;AAoBA,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CAEN,OAAO;EACL,MAAM,EAAE,MAAM,CAAC,QAAQ,KAAK,EAAiC;EAC7D,QAAQ,EAAE,MAAM,OAAO;EACvB,KAAK,EAAE,MAAM,OAAO;EACpB,UAAU,EAAE,MAAM,OAAO;EACzB,SAAS,EAAE,MAAM,OAAO;EACxB,YAAY,EAAE,MAAM,OAAO;EAC3B,OAAO,EAAE,MAAM,OAAO;EACtB,WAAW,EAAE,MAAM,OAAuC;;EAE1D,YAAY;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;CAClD;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,UAAU,IAAwB,IAAI;EAC5C,MAAM,UAAU,WAAW,yBAAyB,EAAE,GAAG,MAAM,EAAoB;EACnF,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;EACjD,MAAM,MAAM,eAAe,iBAAiB,SAAS,YAAY,CAAC;EAClE,iBAAiB,EAAE,IAAI,CAAC;EACxB,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,MAAM,aAAa;GAC1B,MAAM,OAAgB;IAAE,QAAQ,QAAQ;GAAyB;EACnE,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,oBAAoB;EAChC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC"}

package/dist/config/config.d.ts

@@ -12,7 +12,7 @@ interface XhConfig extends XhConfigBase {
    * 应用级默认，实例上写了容器时以实例为准。
    */
   portalContainer?: () => Element | null;
-  /** 本次 provide 的七轴视觉环境；root 必须显式给出，不推测组件 DOM。 */
+  /** 本次 provide 的八轴视觉环境；root 必须显式给出，不推测组件 DOM。 */
   visualEnvironment?: XhVisualEnvironmentConfig;
 }
 /**

package/dist/config/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","names":[],"sources":["../../src/config/config.ts"],"mappings":";;;;KAoBK,eAAe,KAAK,oBAAoB,KAAK;EAA0B,MAAM;;KACtE,4BAA4B,eAAe;UAEtC,iBAAiB;;;;;EAKhC,wBAAwB;;EAExB,oBAAoB;;;;;;;;iBAYN,gBAAc,MAAM,sBAAsB,MAAM,WAAW;;;;;;iBAS3D,gBAAgB,QAAQ,iBAAiB;;iBA0CzC,eAAe,YAAY;;;;;;;;;iBAa3B,aAAa,kBAAkB,iBAAiB,wBAAwB,OAAO,IAAI"}
+{"version":3,"file":"config.d.ts","names":[],"sources":["../../src/config/config.ts"],"mappings":";;;;KAoBK,eAAe,KAAK,oBAAoB,KAAK;EAA0B,MAAM;;KACtE,4BAA4B,eAAe;UAEtC,iBAAiB;;;;;EAKhC,wBAAwB;;EAExB,oBAAoB;;;;;;;;iBAYN,gBAAc,MAAM,sBAAsB,MAAM,WAAW;;;;;;iBAS3D,gBAAgB,QAAQ,iBAAiB;;iBA2CzC,eAAe,YAAY;;;;;;;;;iBAa3B,aAAa,kBAAkB,iBAAiB,wBAAwB,OAAO,IAAI"}

package/dist/config/config.js

@@ -39,9 +39,10 @@ function provideXhConfig(config) {
 			binding?.initial?.contrast,
 			binding?.initial?.motion,
 			binding?.initial?.transparency,
+			binding?.initial?.material,
 			parentVisual?.value
 		];
-	}, ([_root, _storageKey, _onStorageError, _motionSink, _mode, _brand, _density, _dir, _contrast, _motion, _transparency, inherited]) => {
+	}, ([_root, _storageKey, _onStorageError, _motionSink, _mode, _brand, _density, _dir, _contrast, _motion, _transparency, _material, inherited]) => {
 		const binding = toValue(config).visualEnvironment;
 		localVisual.value?.dispose();
 		localVisual.value = binding ? createVisualEnvironmentController({

package/dist/config/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":["mergeXhConfig","mergeBase"],"sources":["../../src/config/config.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// 全局配置注入：应用级默认值，实例上写了的以实例为准。\n// 取值优先级：实例 props > 最近一层注入 > 外层注入 > 组件内建默认（英文）。\n// 注入是可选的——不 provide 时组件走原路，零开销。\nimport type {\n  VisualEnvironmentController,\n  VisualEnvironmentControllerOptions,\n} from '@xihan-ui/core/visual-environment'\nimport type { XhConfigBase, XhTranslationOverrides } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey, MaybeRefOrGetter } from 'vue'\nimport { createVisualEnvironmentController } from '@xihan-ui/core/visual-environment'\nimport { componentTranslations, mergeXhConfig as mergeBase, SIZE_IS_NOT_AXIS } from '@xihan-ui/headless'\nimport { computed, inject, onScopeDispose, provide, shallowRef, toValue, watch } from 'vue'\n\nexport type { XhTranslationOverrides }\n\ntype BindVisualRoot<T> = T extends unknown ? Omit<T, 'parent' | 'root'> & { root: Element } : never\nexport type XhVisualEnvironmentConfig = BindVisualRoot<VisualEnvironmentControllerOptions>\n\nexport interface XhConfig extends XhConfigBase {\n  /**\n   * 浮层默认挂载的容器；返回 null 即挂载到 body。\n   * 应用级默认，实例上写了容器时以实例为准。\n   */\n  portalContainer?: () => Element | null\n  /** 本次 provide 的七轴视觉环境；root 必须显式给出，不推测组件 DOM。 */\n  visualEnvironment?: XhVisualEnvironmentConfig\n}\n\nconst KEY: InjectionKey<MaybeRefOrGetter<XhConfig>> = Symbol.for('xh-config')\nconst VISUAL_KEY: InjectionKey<ComputedRef<VisualEnvironmentController | undefined>> = Symbol.for('xh-visual-environment')\n\n/**\n * 本层与外层逐键合并。\n *\n * 键缺席与写为 undefined 都视为本层未声明，一律回落外层：子树注入只需要改文案时，\n * 不应把外层的 locale 与 portalContainer 一并清除。\n */\nexport function mergeXhConfig(base: XhConfig | undefined, over: XhConfig): XhConfig {\n  return mergeBase(base, over)\n}\n\n/**\n * 注入一份配置，作用于本组件子树。传 ref/getter 即可在运行时切换语言，组件随之重渲。\n *\n * 嵌套注入按键合并，不整份遮蔽：内层只写了 translations 时，外层的 locale 仍然生效。\n */\nexport function provideXhConfig(config: MaybeRefOrGetter<XhConfig>): void {\n  const parent = inject(KEY, undefined)\n  provide(KEY, parent ? () => mergeXhConfig(toValue(parent), toValue(config)) : config)\n\n  const parentVisual = inject(VISUAL_KEY, undefined)\n  const localVisual = shallowRef<VisualEnvironmentController>()\n  const visual = computed(() => localVisual.value ?? parentVisual?.value)\n  provide(VISUAL_KEY, visual)\n  const stop = watch(\n    () => {\n      const binding = toValue(config).visualEnvironment\n      return [\n        binding?.root,\n        binding?.storageKey,\n        binding?.onStorageError,\n        binding?.motionSink,\n        binding?.initial?.mode,\n        binding?.initial?.brand,\n        binding?.initial?.density,\n        binding?.initial?.dir,\n        binding?.initial?.contrast,\n        binding?.initial?.motion,\n        binding?.initial?.transparency,\n        parentVisual?.value,\n      ] as const\n    },\n    ([_root, _storageKey, _onStorageError, _motionSink, _mode, _brand, _density, _dir, _contrast, _motion, _transparency, inherited]) => {\n      const binding = toValue(config).visualEnvironment\n      localVisual.value?.dispose()\n      localVisual.value = binding\n        ? createVisualEnvironmentController({ ...binding, parent: inherited })\n        : undefined\n    },\n    { immediate: true },\n  )\n  onScopeDispose(() => {\n    stop()\n    localVisual.value?.dispose()\n  })\n}\n\n/** 读取当前作用域的全局配置（已与外层合并）；未注入时得到空对象。 */\nexport function useXhConfig(): ComputedRef<XhConfig> {\n  const injected = inject(KEY, undefined)\n  return computed(() => toValue(injected) ?? {})\n}\n\n/**\n * 把全局配置合入组件 props：translations 按键合并（实例键优先），\n * locale 与 size 在实例未提供时回落全局。未注入配置时原样返回，零开销。\n * 只能在 setup 期调用。\n *\n * 运行状态机的组件不必逐个调用它：useMachine 已经把 locale 与 size 合并进去；\n * 本函数负责两件那里无法覆盖的事：按组件名分桶的 translations，以及没有状态机的组件。\n */\nexport function withXhConfig<T extends object>(component: keyof XhTranslationOverrides, props: T): T {\n  const injected = inject(KEY, undefined)\n  if (!injected)\n    return props\n  return new Proxy(props, {\n    get(target, key, receiver) {\n      const value = Reflect.get(target, key, receiver)\n      if (key === 'translations')\n        return componentTranslations(component, value as object | undefined, toValue(injected) ?? {})\n      if (key === 'locale')\n        return value ?? toValue(injected)?.locale\n      if (key === 'size' && !SIZE_IS_NOT_AXIS.has(component))\n        return value ?? toValue(injected)?.size\n      return value\n    },\n  }) as T\n}\n"],"mappings":";;;;AAiCA,MAAM,MAAgD,OAAO,IAAI,WAAW;AAC5E,MAAM,aAAiF,OAAO,IAAI,uBAAuB;;;;;;;AAQzH,SAAgBA,gBAAc,MAA4B,MAA0B;CAClF,OAAOC,cAAU,MAAM,IAAI;AAC7B;;;;;;AAOA,SAAgB,gBAAgB,QAA0C;CACxE,MAAM,SAAS,OAAO,KAAK,KAAA,CAAS;CACpC,QAAQ,KAAK,eAAeD,gBAAc,QAAQ,MAAM,GAAG,QAAQ,MAAM,CAAC,IAAI,MAAM;CAEpF,MAAM,eAAe,OAAO,YAAY,KAAA,CAAS;CACjD,MAAM,cAAc,WAAwC;CAC5D,MAAM,SAAS,eAAe,YAAY,SAAS,cAAc,KAAK;CACtE,QAAQ,YAAY,MAAM;CAC1B,MAAM,OAAO,YACL;EACJ,MAAM,UAAU,QAAQ,MAAM,CAAC,CAAC;EAChC,OAAO;GACL,SAAS;GACT,SAAS;GACT,SAAS;GACT,SAAS;GACT,SAAS,SAAS;GAClB,SAAS,SAAS;GAClB,SAAS,SAAS;GAClB,SAAS,SAAS;GAClB,SAAS,SAAS;GAClB,SAAS,SAAS;GAClB,SAAS,SAAS;GAClB,cAAc;EAChB;CACF,IACC,CAAC,OAAO,aAAa,iBAAiB,aAAa,OAAO,QAAQ,UAAU,MAAM,WAAW,SAAS,eAAe,eAAe;EACnI,MAAM,UAAU,QAAQ,MAAM,CAAC,CAAC;EAChC,YAAY,OAAO,QAAQ;EAC3B,YAAY,QAAQ,UAChB,kCAAkC;GAAE,GAAG;GAAS,QAAQ;EAAU,CAAC,IACnE,KAAA;CACN,GACA,EAAE,WAAW,KAAK,CACpB;CACA,qBAAqB;EACnB,KAAK;EACL,YAAY,OAAO,QAAQ;CAC7B,CAAC;AACH;;AAGA,SAAgB,cAAqC;CACnD,MAAM,WAAW,OAAO,KAAK,KAAA,CAAS;CACtC,OAAO,eAAe,QAAQ,QAAQ,KAAK,CAAC,CAAC;AAC/C;;;;;;;;;AAUA,SAAgB,aAA+B,WAAyC,OAAa;CACnG,MAAM,WAAW,OAAO,KAAK,KAAA,CAAS;CACtC,IAAI,CAAC,UACH,OAAO;CACT,OAAO,IAAI,MAAM,OAAO,EACtB,IAAI,QAAQ,KAAK,UAAU;EACzB,MAAM,QAAQ,QAAQ,IAAI,QAAQ,KAAK,QAAQ;EAC/C,IAAI,QAAQ,gBACV,OAAO,sBAAsB,WAAW,OAA6B,QAAQ,QAAQ,KAAK,CAAC,CAAC;EAC9F,IAAI,QAAQ,UACV,OAAO,SAAS,QAAQ,QAAQ,CAAC,EAAE;EACrC,IAAI,QAAQ,UAAU,CAAC,iBAAiB,IAAI,SAAS,GACnD,OAAO,SAAS,QAAQ,QAAQ,CAAC,EAAE;EACrC,OAAO;CACT,EACF,CAAC;AACH"}
+{"version":3,"file":"config.js","names":["mergeXhConfig","mergeBase"],"sources":["../../src/config/config.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// 全局配置注入：应用级默认值，实例上写了的以实例为准。\n// 取值优先级：实例 props > 最近一层注入 > 外层注入 > 组件内建默认（英文）。\n// 注入是可选的——不 provide 时组件走原路，零开销。\nimport type {\n  VisualEnvironmentController,\n  VisualEnvironmentControllerOptions,\n} from '@xihan-ui/core/visual-environment'\nimport type { XhConfigBase, XhTranslationOverrides } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey, MaybeRefOrGetter } from 'vue'\nimport { createVisualEnvironmentController } from '@xihan-ui/core/visual-environment'\nimport { componentTranslations, mergeXhConfig as mergeBase, SIZE_IS_NOT_AXIS } from '@xihan-ui/headless'\nimport { computed, inject, onScopeDispose, provide, shallowRef, toValue, watch } from 'vue'\n\nexport type { XhTranslationOverrides }\n\ntype BindVisualRoot<T> = T extends unknown ? Omit<T, 'parent' | 'root'> & { root: Element } : never\nexport type XhVisualEnvironmentConfig = BindVisualRoot<VisualEnvironmentControllerOptions>\n\nexport interface XhConfig extends XhConfigBase {\n  /**\n   * 浮层默认挂载的容器；返回 null 即挂载到 body。\n   * 应用级默认，实例上写了容器时以实例为准。\n   */\n  portalContainer?: () => Element | null\n  /** 本次 provide 的八轴视觉环境；root 必须显式给出，不推测组件 DOM。 */\n  visualEnvironment?: XhVisualEnvironmentConfig\n}\n\nconst KEY: InjectionKey<MaybeRefOrGetter<XhConfig>> = Symbol.for('xh-config')\nconst VISUAL_KEY: InjectionKey<ComputedRef<VisualEnvironmentController | undefined>> = Symbol.for('xh-visual-environment')\n\n/**\n * 本层与外层逐键合并。\n *\n * 键缺席与写为 undefined 都视为本层未声明，一律回落外层：子树注入只需要改文案时，\n * 不应把外层的 locale 与 portalContainer 一并清除。\n */\nexport function mergeXhConfig(base: XhConfig | undefined, over: XhConfig): XhConfig {\n  return mergeBase(base, over)\n}\n\n/**\n * 注入一份配置，作用于本组件子树。传 ref/getter 即可在运行时切换语言，组件随之重渲。\n *\n * 嵌套注入按键合并，不整份遮蔽：内层只写了 translations 时，外层的 locale 仍然生效。\n */\nexport function provideXhConfig(config: MaybeRefOrGetter<XhConfig>): void {\n  const parent = inject(KEY, undefined)\n  provide(KEY, parent ? () => mergeXhConfig(toValue(parent), toValue(config)) : config)\n\n  const parentVisual = inject(VISUAL_KEY, undefined)\n  const localVisual = shallowRef<VisualEnvironmentController>()\n  const visual = computed(() => localVisual.value ?? parentVisual?.value)\n  provide(VISUAL_KEY, visual)\n  const stop = watch(\n    () => {\n      const binding = toValue(config).visualEnvironment\n      return [\n        binding?.root,\n        binding?.storageKey,\n        binding?.onStorageError,\n        binding?.motionSink,\n        binding?.initial?.mode,\n        binding?.initial?.brand,\n        binding?.initial?.density,\n        binding?.initial?.dir,\n        binding?.initial?.contrast,\n        binding?.initial?.motion,\n        binding?.initial?.transparency,\n        binding?.initial?.material,\n        parentVisual?.value,\n      ] as const\n    },\n    ([_root, _storageKey, _onStorageError, _motionSink, _mode, _brand, _density, _dir, _contrast, _motion, _transparency, _material, inherited]) => {\n      const binding = toValue(config).visualEnvironment\n      localVisual.value?.dispose()\n      localVisual.value = binding\n        ? createVisualEnvironmentController({ ...binding, parent: inherited })\n        : undefined\n    },\n    { immediate: true },\n  )\n  onScopeDispose(() => {\n    stop()\n    localVisual.value?.dispose()\n  })\n}\n\n/** 读取当前作用域的全局配置（已与外层合并）；未注入时得到空对象。 */\nexport function useXhConfig(): ComputedRef<XhConfig> {\n  const injected = inject(KEY, undefined)\n  return computed(() => toValue(injected) ?? {})\n}\n\n/**\n * 把全局配置合入组件 props：translations 按键合并（实例键优先），\n * locale 与 size 在实例未提供时回落全局。未注入配置时原样返回，零开销。\n * 只能在 setup 期调用。\n *\n * 运行状态机的组件不必逐个调用它：useMachine 已经把 locale 与 size 合并进去；\n * 本函数负责两件那里无法覆盖的事：按组件名分桶的 translations，以及没有状态机的组件。\n */\nexport function withXhConfig<T extends object>(component: keyof XhTranslationOverrides, props: T): T {\n  const injected = inject(KEY, undefined)\n  if (!injected)\n    return props\n  return new Proxy(props, {\n    get(target, key, receiver) {\n      const value = Reflect.get(target, key, receiver)\n      if (key === 'translations')\n        return componentTranslations(component, value as object | undefined, toValue(injected) ?? {})\n      if (key === 'locale')\n        return value ?? toValue(injected)?.locale\n      if (key === 'size' && !SIZE_IS_NOT_AXIS.has(component))\n        return value ?? toValue(injected)?.size\n      return value\n    },\n  }) as T\n}\n"],"mappings":";;;;AAiCA,MAAM,MAAgD,OAAO,IAAI,WAAW;AAC5E,MAAM,aAAiF,OAAO,IAAI,uBAAuB;;;;;;;AAQzH,SAAgBA,gBAAc,MAA4B,MAA0B;CAClF,OAAOC,cAAU,MAAM,IAAI;AAC7B;;;;;;AAOA,SAAgB,gBAAgB,QAA0C;CACxE,MAAM,SAAS,OAAO,KAAK,KAAA,CAAS;CACpC,QAAQ,KAAK,eAAeD,gBAAc,QAAQ,MAAM,GAAG,QAAQ,MAAM,CAAC,IAAI,MAAM;CAEpF,MAAM,eAAe,OAAO,YAAY,KAAA,CAAS;CACjD,MAAM,cAAc,WAAwC;CAC5D,MAAM,SAAS,eAAe,YAAY,SAAS,cAAc,KAAK;CACtE,QAAQ,YAAY,MAAM;CAC1B,MAAM,OAAO,YACL;EACJ,MAAM,UAAU,QAAQ,MAAM,CAAC,CAAC;EAChC,OAAO;GACL,SAAS;GACT,SAAS;GACT,SAAS;GACT,SAAS;GACT,SAAS,SAAS;GAClB,SAAS,SAAS;GAClB,SAAS,SAAS;GAClB,SAAS,SAAS;GAClB,SAAS,SAAS;GAClB,SAAS,SAAS;GAClB,SAAS,SAAS;GAClB,SAAS,SAAS;GAClB,cAAc;EAChB;CACF,IACC,CAAC,OAAO,aAAa,iBAAiB,aAAa,OAAO,QAAQ,UAAU,MAAM,WAAW,SAAS,eAAe,WAAW,eAAe;EAC9I,MAAM,UAAU,QAAQ,MAAM,CAAC,CAAC;EAChC,YAAY,OAAO,QAAQ;EAC3B,YAAY,QAAQ,UAChB,kCAAkC;GAAE,GAAG;GAAS,QAAQ;EAAU,CAAC,IACnE,KAAA;CACN,GACA,EAAE,WAAW,KAAK,CACpB;CACA,qBAAqB;EACnB,KAAK;EACL,YAAY,OAAO,QAAQ;CAC7B,CAAC;AACH;;AAGA,SAAgB,cAAqC;CACnD,MAAM,WAAW,OAAO,KAAK,KAAA,CAAS;CACtC,OAAO,eAAe,QAAQ,QAAQ,KAAK,CAAC,CAAC;AAC/C;;;;;;;;;AAUA,SAAgB,aAA+B,WAAyC,OAAa;CACnG,MAAM,WAAW,OAAO,KAAK,KAAA,CAAS;CACtC,IAAI,CAAC,UACH,OAAO;CACT,OAAO,IAAI,MAAM,OAAO,EACtB,IAAI,QAAQ,KAAK,UAAU;EACzB,MAAM,QAAQ,QAAQ,IAAI,QAAQ,KAAK,QAAQ;EAC/C,IAAI,QAAQ,gBACV,OAAO,sBAAsB,WAAW,OAA6B,QAAQ,QAAQ,KAAK,CAAC,CAAC;EAC9F,IAAI,QAAQ,UACV,OAAO,SAAS,QAAQ,QAAQ,CAAC,EAAE;EACrC,IAAI,QAAQ,UAAU,CAAC,iBAAiB,IAAI,SAAS,GACnD,OAAO,SAAS,QAAQ,QAAQ,CAAC,EAAE;EACrC,OAAO;CACT,EACF,CAAC;AACH"}