@xihan-ui/vue 2.1.0 → 3.1.0

package/dist/components/citation/citation.js

@@ -0,0 +1,222 @@
+import { withXhConfig } from "../../config/config.js";
+import { XhPortal } from "../../runtime/portal.js";
+import { slotPaints } from "../../runtime/slot-content.js";
+import { provideCitation, provideCitationSource, useCitationContext, useCitationSource } from "./context.js";
+import { useCitation } from "./use-citation.js";
+import { computed, defineComponent, h, mergeProps } from "vue";
+import { citationSourceMetaText, citationSourceTitle } from "@xihan-ui/headless";
+//#region src/components/citation/citation.ts
+const XhCitationRoot = defineComponent({
+	name: "XhCitationRoot",
+	props: {
+		sources: { type: Array },
+		activeSourceId: { type: String },
+		defaultActiveSourceId: { type: String },
+		open: {
+			type: Boolean,
+			default: void 0
+		},
+		defaultOpen: Boolean,
+		disabled: Boolean,
+		loop: {
+			type: Boolean,
+			default: void 0
+		},
+		dir: { type: String },
+		size: { type: String },
+		previewMode: { type: String },
+		openDelay: { type: Number },
+		closeDelay: { type: Number },
+		skipDelayDuration: { type: Number },
+		placement: { type: String },
+		offset: { type: Number },
+		translations: { type: Object }
+	},
+	emits: {
+		"active-source-change": (_details) => true,
+		"update:activeSourceId": (_sourceId) => true,
+		"open-change": (_details) => true,
+		"update:open": (_open) => true,
+		"source-open": (_details) => true
+	},
+	setup(props, { emit, slots }) {
+		const context = useCitation(withXhConfig("citation", props), {
+			onActiveSourceChange: (details) => {
+				emit("active-source-change", details);
+				emit("update:activeSourceId", details.sourceId);
+			},
+			onOpenChange: (details) => {
+				emit("open-change", details);
+				emit("update:open", details.open);
+			},
+			onSourceOpen: (details) => emit("source-open", details)
+		});
+		provideCitation(context);
+		return () => h("div", {
+			...context.api.value.getRootProps(),
+			ref: (el) => {
+				context.rootRef.value = el;
+			}
+		}, slots.default?.());
+	}
+});
+const XhCitationText = defineComponent({
+	name: "XhCitationText",
+	setup(_, { slots }) {
+		const { api } = useCitationContext();
+		return () => h("span", api.value.getTextProps(), slots.default?.());
+	}
+});
+const XhCitationTrigger = defineComponent({
+	name: "XhCitationTrigger",
+	props: {
+		/** 这一处引用的来源；一处引多个来源时改写 sourceIds，两者只写一个。 */
+		sourceId: String,
+		/** 一处引用多个来源，预览里可以在它们之间轮换。 */
+		sourceIds: { type: Array },
+		citationId: String,
+		anchorIndex: Number,
+		disabled: Boolean
+	},
+	setup(props, { slots }) {
+		const { api } = useCitationContext();
+		return () => h("button", api.value.getTriggerProps(props), slots.default?.());
+	}
+});
+/**
+* hover 档的浮层定位壳：预览放进它里面，锚定到当前那处引用旁并搬到 portal 落点。
+* inline 档不搬家，皮肤把它排成 display: contents，里面的预览照常在正文流里。
+*/
+const XhCitationPositioner = defineComponent({
+	name: "XhCitationPositioner",
+	props: { 
+	/** 本实例的 Portal 容器；优先于应用级配置。 */
+container: { type: Object } },
+	inheritAttrs: false,
+	setup(props, { slots, attrs }) {
+		const ctx = useCitationContext();
+		return () => {
+			const shell = h("div", {
+				...mergeProps(ctx.api.value.getPositionerProps(), attrs),
+				ref: (el) => {
+					ctx.positionerRef.value = el;
+				}
+			}, slots.default?.());
+			if (ctx.api.value.previewMode !== "hover") return shell;
+			return h(XhPortal, {
+				to: props.container ?? ctx.portalTarget.value,
+				source: ctx.rootRef
+			}, () => [shell]);
+		};
+	}
+});
+const XhCitationPreview = defineComponent({
+	name: "XhCitationPreview",
+	props: {
+		sourceId: {
+			type: String,
+			required: true
+		},
+		anchorIndex: Number
+	},
+	setup(props, { slots }) {
+		const { api } = useCitationContext();
+		return () => {
+			const authored = slots.default?.();
+			const item = props;
+			return h("section", api.value.getPreviewProps(item), slotPaints(authored) ? authored : renderPreview(api.value, item));
+		};
+	}
+});
+const XhCitationSourceLink = defineComponent({
+	name: "XhCitationSourceLink",
+	setup(_, { slots }) {
+		const { api } = useCitationContext();
+		const item = useCitationSource();
+		return () => h("button", api.value.getSourceLinkProps(item.value), slots.default?.());
+	}
+});
+const XhCitationSourceIndex = defineComponent({
+	name: "XhCitationSourceIndex",
+	setup(_, { slots }) {
+		const { api } = useCitationContext();
+		const item = useCitationSource();
+		return () => h("span", api.value.getSourceIndexProps(item.value), slots.default?.() ?? `${api.value.sources.findIndex((source) => source.sourceId === item.value.sourceId) + 1}`);
+	}
+});
+function sourcePart(name, slots) {
+	const { api } = useCitationContext();
+	const item = useCitationSource();
+	return () => {
+		const current = api.value.sources.find((source) => source.sourceId === item.value.sourceId);
+		const text = name === "getSourceTitleProps" ? citationSourceTitle(current) : citationSourceMetaText(current, "Document");
+		return h("span", api.value[name](item.value), slots.default?.() ?? text);
+	};
+}
+const XhCitationSourceTitle = defineComponent({
+	name: "XhCitationSourceTitle",
+	setup(_, { slots }) {
+		return sourcePart("getSourceTitleProps", slots);
+	}
+});
+const XhCitationSourceMeta = defineComponent({
+	name: "XhCitationSourceMeta",
+	setup(_, { slots }) {
+		return sourcePart("getSourceMetaProps", slots);
+	}
+});
+const XhCitationSource = defineComponent({
+	name: "XhCitationSource",
+	props: {
+		sourceId: {
+			type: String,
+			required: true
+		},
+		disabled: Boolean
+	},
+	setup(props, { slots }) {
+		const { api } = useCitationContext();
+		const item = computed(() => ({
+			sourceId: props.sourceId,
+			disabled: props.disabled
+		}));
+		provideCitationSource(item);
+		return () => h("li", api.value.getSourceProps(item.value), slots.default?.() ?? [h(XhCitationSourceLink, null, () => [h(XhCitationSourceIndex), h("span", null, [h(XhCitationSourceTitle), h(XhCitationSourceMeta)])])]);
+	}
+});
+const XhCitationList = defineComponent({
+	name: "XhCitationList",
+	setup(_, { slots }) {
+		const { api } = useCitationContext();
+		return () => {
+			const authored = slots.default?.();
+			return h("ol", api.value.getListProps(), slotPaints(authored) ? authored : api.value.sources.map((source) => h(XhCitationSource, {
+				key: source.sourceId,
+				sourceId: source.sourceId
+			})));
+		};
+	}
+});
+function renderPreview(api, item) {
+	const current = api.sources.find((source) => source.sourceId === item.sourceId);
+	if (!current) return [];
+	const anchorIndex = api.activeSourceId === item.sourceId ? api.activeAnchorIndex ?? item.anchorIndex ?? 0 : item.anchorIndex ?? 0;
+	const quote = current.anchors?.[anchorIndex]?.quote;
+	const linkTag = current.type === "source-url" ? "a" : "button";
+	const at = api.getPreviewPosition(item);
+	return [
+		h("header", api.getPreviewHeaderProps(item), [
+			h("span", null, [h("strong", api.getPreviewTitleProps(item), citationSourceTitle(current)), h("span", api.getPreviewMetaProps(item), citationSourceMetaText(current, "Document"))]),
+			h("button", api.getPrevTriggerProps(item)),
+			h("span", api.getPreviewIndexProps(item), at ? `${at.index} / ${at.total}` : ""),
+			h("button", api.getNextTriggerProps(item)),
+			h("button", api.getDismissTriggerProps(item))
+		]),
+		h("blockquote", api.getQuoteProps(item), quote),
+		h(linkTag, api.getPreviewLinkProps(item), current.type === "source-url" ? "Open source" : "Open document")
+	];
+}
+//#endregion
+export { XhCitationList, XhCitationPositioner, XhCitationPreview, XhCitationRoot, XhCitationSource, XhCitationSourceIndex, XhCitationSourceLink, XhCitationSourceMeta, XhCitationSourceTitle, XhCitationText, XhCitationTrigger };
+
+//# sourceMappingURL=citation.js.map

package/dist/components/citation/citation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation.js","names":[],"sources":["../../../src/components/citation/citation.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// 提供 citation 相关实现。\n\nimport type { Direction, Placement, Size } from '@xihan-ui/core'\nimport type { CitationPreviewMode, CitationPreviewProps, CitationSchema, CitationSource, CitationSourceItemProps } from '@xihan-ui/headless'\nimport type { PropType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { citationSourceMetaText, citationSourceTitle } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, mergeProps } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { XhPortal } from '../../runtime/portal'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { provideCitation, provideCitationSource, useCitationContext, useCitationSource } from './context'\nimport { useCitation } from './use-citation'\n\ntype CitationProps = CitationSchema['props']\n\nexport const XhCitationRoot = defineComponent({\n  name: 'XhCitationRoot',\n  props: {\n    sources: { type: Array as PropType<CitationSource[]> },\n    activeSourceId: { type: String as PropType<string | null> },\n    defaultActiveSourceId: { type: String as PropType<string | null> },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    disabled: Boolean,\n    loop: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    size: { type: String as PropType<Size> },\n    previewMode: { type: String as PropType<CitationPreviewMode> },\n    openDelay: { type: Number },\n    closeDelay: { type: Number },\n    skipDelayDuration: { type: Number },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    translations: { type: Object as PropType<CitationProps['translations']> },\n  },\n  emits: {\n    'active-source-change': (_details: PayloadOf<CitationProps, 'onActiveSourceChange'>) => true,\n    'update:activeSourceId': (_sourceId: string | null) => true,\n    'open-change': (_details: PayloadOf<CitationProps, 'onOpenChange'>) => true,\n    'update:open': (_open: boolean) => true,\n    'source-open': (_details: PayloadOf<CitationProps, 'onSourceOpen'>) => true,\n  },\n  setup(props, { emit, slots }) {\n    // props 原样交进去、在取值器里展开：在这里展开会把首帧的值冻住，受控写回与改档都传不进机器\n    const context = useCitation(withXhConfig('citation', props) as CitationProps, {\n      onActiveSourceChange: (details) => {\n        emit('active-source-change', details)\n        emit('update:activeSourceId', details.sourceId)\n      },\n      onOpenChange: (details) => {\n        emit('open-change', details)\n        emit('update:open', details.open)\n      },\n      onSourceOpen: details => emit('source-open', details),\n    })\n    provideCitation(context)\n    return () => h('div', {\n      ...context.api.value.getRootProps() as Record<string, unknown>,\n      ref: (el: unknown) => { context.rootRef.value = el as HTMLElement | null },\n    }, slots.default?.())\n  },\n})\n\nexport const XhCitationText = defineComponent({\n  name: 'XhCitationText',\n  setup(_, { slots }) {\n    const { api } = useCitationContext()\n    return () => h('span', api.value.getTextProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCitationTrigger = defineComponent({\n  name: 'XhCitationTrigger',\n  props: {\n    /** 这一处引用的来源；一处引多个来源时改写 sourceIds，两者只写一个。 */\n    sourceId: String,\n    /** 一处引用多个来源，预览里可以在它们之间轮换。 */\n    sourceIds: { type: Array as PropType<readonly string[]> },\n    citationId: String,\n    anchorIndex: Number,\n    disabled: Boolean,\n  },\n  setup(props, { slots }) {\n    const { api } = useCitationContext()\n    return () => h('button', api.value.getTriggerProps(props) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * hover 档的浮层定位壳：预览放进它里面，锚定到当前那处引用旁并搬到 portal 落点。\n * inline 档不搬家，皮肤把它排成 display: contents，里面的预览照常在正文流里。\n */\nexport const XhCitationPositioner = defineComponent({\n  name: 'XhCitationPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // hover 档的根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useCitationContext()\n    return () => {\n      const shell = h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement | null },\n      }, slots.default?.())\n      if (ctx.api.value.previewMode !== 'hover')\n        return shell\n      return h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.rootRef }, () => [shell])\n    }\n  },\n})\n\nexport const XhCitationPreview = defineComponent({\n  name: 'XhCitationPreview',\n  props: {\n    sourceId: { type: String, required: true },\n    anchorIndex: Number,\n  },\n  setup(props, { slots }) {\n    const { api } = useCitationContext()\n    return () => {\n      const authored = slots.default?.()\n      const item: CitationPreviewProps = props\n      return h('section', api.value.getPreviewProps(item) as Record<string, unknown>, slotPaints(authored)\n        ? authored\n        : renderPreview(api.value, item))\n    }\n  },\n})\n\nexport const XhCitationSourceLink = defineComponent({\n  name: 'XhCitationSourceLink',\n  setup(_, { slots }) {\n    const { api } = useCitationContext()\n    const item = useCitationSource()\n    return () => h('button', api.value.getSourceLinkProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCitationSourceIndex = defineComponent({\n  name: 'XhCitationSourceIndex',\n  setup(_, { slots }) {\n    const { api } = useCitationContext()\n    const item = useCitationSource()\n    return () => h('span', api.value.getSourceIndexProps(item.value) as Record<string, unknown>, slots.default?.() ?? `${api.value.sources.findIndex(source => source.sourceId === item.value.sourceId) + 1}`)\n  },\n})\n\nfunction sourcePart(\n  name: 'getSourceTitleProps' | 'getSourceMetaProps',\n  slots: { default?: () => VNode[] },\n): () => VNode {\n  const { api } = useCitationContext()\n  const item = useCitationSource()\n  return () => {\n    const current = api.value.sources.find(source => source.sourceId === item.value.sourceId)\n    const text = name === 'getSourceTitleProps' ? citationSourceTitle(current) : citationSourceMetaText(current, 'Document')\n    return h('span', api.value[name](item.value) as Record<string, unknown>, slots.default?.() ?? text)\n  }\n}\n\nexport const XhCitationSourceTitle = defineComponent({\n  name: 'XhCitationSourceTitle',\n  setup(_, { slots }) {\n    return sourcePart('getSourceTitleProps', slots)\n  },\n})\n\nexport const XhCitationSourceMeta = defineComponent({\n  name: 'XhCitationSourceMeta',\n  setup(_, { slots }) {\n    return sourcePart('getSourceMetaProps', slots)\n  },\n})\n\nexport const XhCitationSource = defineComponent({\n  name: 'XhCitationSource',\n  props: {\n    sourceId: { type: String, required: true },\n    disabled: Boolean,\n  },\n  setup(props, { slots }) {\n    const { api } = useCitationContext()\n    const item = computed<CitationSourceItemProps>(() => ({ sourceId: props.sourceId, disabled: props.disabled }))\n    provideCitationSource(item)\n    return () => h('li', api.value.getSourceProps(item.value) as Record<string, unknown>, slots.default?.() ?? [\n      h(XhCitationSourceLink, null, () => [h(XhCitationSourceIndex), h('span', null, [h(XhCitationSourceTitle), h(XhCitationSourceMeta)])]),\n    ])\n  },\n})\n\nexport const XhCitationList = defineComponent({\n  name: 'XhCitationList',\n  setup(_, { slots }) {\n    const { api } = useCitationContext()\n    return () => {\n      const authored = slots.default?.()\n      return h('ol', api.value.getListProps() as Record<string, unknown>, slotPaints(authored)\n        ? authored\n        : api.value.sources.map(source => h(XhCitationSource, { key: source.sourceId, sourceId: source.sourceId })))\n    }\n  },\n})\n\nfunction renderPreview(api: ReturnType<typeof useCitationContext>['api']['value'], item: CitationPreviewProps): VNode[] {\n  const current = api.sources.find(source => source.sourceId === item.sourceId)\n  if (!current)\n    return []\n  const anchorIndex = api.activeSourceId === item.sourceId ? api.activeAnchorIndex ?? item.anchorIndex ?? 0 : item.anchorIndex ?? 0\n  const quote = current.anchors?.[anchorIndex]?.quote\n  const linkTag = current.type === 'source-url' ? 'a' : 'button'\n  const at = api.getPreviewPosition(item)\n  return [\n    h('header', api.getPreviewHeaderProps(item) as Record<string, unknown>, [\n      h('span', null, [\n        h('strong', api.getPreviewTitleProps(item) as Record<string, unknown>, citationSourceTitle(current)),\n        h('span', api.getPreviewMetaProps(item) as Record<string, unknown>, citationSourceMetaText(current, 'Document')),\n      ]),\n      // 一处多源的轮换：只有一个来源时这三件带 hidden\n      h('button', api.getPrevTriggerProps(item) as Record<string, unknown>),\n      h('span', api.getPreviewIndexProps(item) as Record<string, unknown>, at ? `${at.index} / ${at.total}` : ''),\n      h('button', api.getNextTriggerProps(item) as Record<string, unknown>),\n      h('button', api.getDismissTriggerProps(item) as Record<string, unknown>),\n    ]),\n    h('blockquote', api.getQuoteProps(item) as Record<string, unknown>, quote),\n    h(linkTag, api.getPreviewLinkProps(item) as Record<string, unknown>, current.type === 'source-url' ? 'Open source' : 'Open document'),\n  ]\n}\n"],"mappings":"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"}

package/dist/components/citation/context.d.ts

@@ -0,0 +1,11 @@
+import { CitationContext } from "./use-citation.js";
+import { ComputedRef } from "vue";
+import { CitationSourceItemProps } from "@xihan-ui/headless";
+//#region src/components/citation/context.d.ts
+declare function provideCitation(context: CitationContext): void;
+declare function useCitationContext(): CitationContext;
+declare function provideCitationSource(source: ComputedRef<CitationSourceItemProps>): void;
+declare function useCitationSource(): ComputedRef<CitationSourceItemProps>;
+//#endregion
+export { provideCitation, provideCitationSource, useCitationContext, useCitationSource };
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/citation/context.ts"],"mappings":";;;;iBAegB,gBAAgB,SAAS;iBAIzB,sBAAsB;iBAOtB,sBAAsB,QAAQ,YAAY;iBAI1C,qBAAqB,YAAY"}

package/dist/components/citation/context.js

@@ -0,0 +1,24 @@
+import { inject, provide } from "vue";
+//#region src/components/citation/context.ts
+const KEY = Symbol.for("xh-citation");
+const SOURCE_KEY = Symbol.for("xh-citation-source");
+function provideCitation(context) {
+	provide(KEY, context);
+}
+function useCitationContext() {
+	const context = inject(KEY, null);
+	if (!context) throw new Error("[xh] Citation 部件必须用在 XhCitationRoot 内");
+	return context;
+}
+function provideCitationSource(source) {
+	provide(SOURCE_KEY, source);
+}
+function useCitationSource() {
+	const source = inject(SOURCE_KEY, null);
+	if (!source) throw new Error("[xh] Citation 来源子部件必须用在 XhCitationSource 内");
+	return source;
+}
+//#endregion
+export { provideCitation, provideCitationSource, useCitationContext, useCitationSource };
+
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/citation/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// 提供 citation 上下文。\n\nimport type { CitationSourceItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { CitationContext } from './use-citation'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<CitationContext> = Symbol.for('xh-citation')\nconst SOURCE_KEY: InjectionKey<ComputedRef<CitationSourceItemProps>> = Symbol.for('xh-citation-source')\n\nexport function provideCitation(context: CitationContext): void {\n  provide(KEY, context)\n}\n\nexport function useCitationContext(): CitationContext {\n  const context = inject(KEY, null)\n  if (!context)\n    throw new Error('[xh] Citation 部件必须用在 XhCitationRoot 内')\n  return context\n}\n\nexport function provideCitationSource(source: ComputedRef<CitationSourceItemProps>): void {\n  provide(SOURCE_KEY, source)\n}\n\nexport function useCitationSource(): ComputedRef<CitationSourceItemProps> {\n  const source = inject(SOURCE_KEY, null)\n  if (!source)\n    throw new Error('[xh] Citation 来源子部件必须用在 XhCitationSource 内')\n  return source\n}\n"],"mappings":";;AAYA,MAAM,MAAqC,OAAO,IAAI,aAAa;AACnE,MAAM,aAAiE,OAAO,IAAI,oBAAoB;AAEtG,SAAgB,gBAAgB,SAAgC;CAC9D,QAAQ,KAAK,OAAO;AACtB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,UAAU,OAAO,KAAK,IAAI;CAChC,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,uCAAuC;CACzD,OAAO;AACT;AAEA,SAAgB,sBAAsB,QAAoD;CACxF,QAAQ,YAAY,MAAM;AAC5B;AAEA,SAAgB,oBAA0D;CACxE,MAAM,SAAS,OAAO,YAAY,IAAI;CACtC,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,4CAA4C;CAC9D,OAAO;AACT"}

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

@@ -0,0 +1,19 @@
+import { ComputedRef, Ref } from "vue";
+import { Service } from "@xihan-ui/core";
+import { CitationApi, CitationSchema } from "@xihan-ui/headless";
+//#region src/components/citation/use-citation.d.ts
+interface CitationContext {
+  api: ComputedRef<CitationApi>;
+  service: Service<CitationSchema>;
+  /** 根节点：悬停卡片搬到 portal 落点时，视觉轴从这里桥过去。 */
+  rootRef: Ref<HTMLElement | null>;
+  /** hover 档的定位壳。 */
+  positionerRef: Ref<HTMLElement | null>;
+  /** 悬停卡片迁移到的位置：全局配置的 portalContainer > body。 */
+  portalTarget: ComputedRef<string | Element>;
+}
+type CitationCallbacks = Pick<CitationSchema['props'], 'onActiveSourceChange' | 'onOpenChange' | 'onSourceOpen'>;
+declare function useCitation(props: CitationSchema['props'], callbacks?: CitationCallbacks): CitationContext;
+//#endregion
+export { CitationContext, useCitation };
+//# sourceMappingURL=use-citation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-citation.d.ts","names":[],"sources":["../../../src/components/citation/use-citation.ts"],"mappings":";;;;UAqBiB;EACf,KAAK,YAAY;EACjB,SAAS,QAAQ;;EAEjB,SAAS,IAAI;;EAEb,eAAe,IAAI;;EAEnB,cAAc,qBAAqB;;KAGhC,oBAAoB,KAAK;iBAEd,YAAY,OAAO,yBAAyB,YAAW,oBAAyB"}

package/dist/components/citation/use-citation.js

@@ -0,0 +1,51 @@
+import { vueNormalize } from "../../runtime/normalize-props.js";
+import { useXhConfig } from "../../config/config.js";
+import { useMachine } from "../../runtime/use-machine.js";
+import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { computed, ref } from "vue";
+import { createRuntimeConfig, createScope } from "@xihan-ui/core";
+import { citationAnatomy, citationMachine, connectCitation } from "@xihan-ui/headless";
+import { createPositionEngine } from "@xihan-ui/position";
+//#region src/components/citation/use-citation.ts
+const triggerSelector = citationAnatomy.build().trigger.selector;
+function useCitation(props, callbacks = {}) {
+	const xhConfig = useXhConfig();
+	const rootRef = ref(null);
+	const positionerRef = ref(null);
+	const idGen = createVueIdGenerator();
+	const scope = createScope(null, idGen);
+	const service = useMachine(citationMachine, () => ({
+		...props,
+		...callbacks
+	}), scope);
+	let config = null;
+	if (typeof document !== "undefined") {
+		config = createRuntimeConfig({
+			scope,
+			idGenerator: idGen
+		});
+		const registerLayer = () => config.layerRegistry.register({
+			kind: "popover",
+			node: () => positionerRef.value,
+			branches: () => [...rootRef.value?.querySelectorAll(triggerSelector) ?? []],
+			isModal: () => false,
+			surfaces: () => []
+		});
+		service.refs.set("config", config);
+		service.refs.set("registerLayer", registerLayer);
+		service.refs.set("position", createPositionEngine());
+	}
+	service.refs.set("getFloatingEl", () => positionerRef.value);
+	const portalTarget = computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body");
+	return {
+		api: computed(() => connectCitation(service, vueNormalize)),
+		service,
+		rootRef,
+		positionerRef,
+		portalTarget
+	};
+}
+//#endregion
+export { useCitation };
+
+//# sourceMappingURL=use-citation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-citation.js","names":[],"sources":["../../../src/components/citation/use-citation.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 citation 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { CitationApi, CitationSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { citationAnatomy, citationMachine, connectCitation } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nconst triggerSelector = citationAnatomy.build().trigger.selector\n\nexport interface CitationContext {\n  api: ComputedRef<CitationApi>\n  service: Service<CitationSchema>\n  /** 根节点：悬停卡片搬到 portal 落点时，视觉轴从这里桥过去。 */\n  rootRef: Ref<HTMLElement | null>\n  /** hover 档的定位壳。 */\n  positionerRef: Ref<HTMLElement | null>\n  /** 悬停卡片迁移到的位置：全局配置的 portalContainer > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\ntype CitationCallbacks = Pick<CitationSchema['props'], 'onActiveSourceChange' | 'onOpenChange' | 'onSourceOpen'>\n\nexport function useCitation(props: CitationSchema['props'], callbacks: CitationCallbacks = {}): CitationContext {\n  const xhConfig = useXhConfig()\n  const rootRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(citationMachine, () => ({ ...props, ...callbacks }), scope)\n\n  // 无 DOM 环境（SSR）不建引擎与消解层：hover 档的卡片首屏本来就收着\n  let config: RuntimeConfig | null = null\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n    // 只提供注册函数，入栈出栈由机器按卡片开合驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => positionerRef.value,\n      // 行内引用记为本层分支：按在另一处引用上是切换，不是层外交互\n      branches: () => [...(rootRef.value?.querySelectorAll<HTMLElement>(triggerSelector) ?? [])],\n      isModal: () => false,\n      surfaces: () => [],\n    })\n    service.refs.set('config', config)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n  }\n  service.refs.set('getFloatingEl', () => positionerRef.value)\n\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n  return { api: computed(() => connectCitation(service, vueNormalize)), service, rootRef, positionerRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;AAmBA,MAAM,kBAAkB,gBAAgB,MAAM,CAAC,CAAC,QAAQ;AAexD,SAAgB,YAAY,OAAgC,YAA+B,CAAC,GAAoB;CAC9G,MAAM,WAAW,YAAY;CAC7B,MAAM,UAAU,IAAwB,IAAI;CAC5C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO,GAAG;CAAU,IAAI,KAAK;CAGrF,IAAI,SAA+B;CACnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAE1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,cAAc;GAE1B,gBAAgB,CAAC,GAAI,QAAQ,OAAO,iBAA8B,eAAe,KAAK,CAAC,CAAE;GACzF,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EACD,QAAQ,KAAK,IAAI,UAAU,MAAM;EACjC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;CACrD;CACA,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;CAE3D,MAAM,eAAe,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAAM;CAC/H,OAAO;EAAE,KAAK,eAAe,gBAAgB,SAAS,YAAY,CAAC;EAAG;EAAS;EAAS;EAAe;CAAa;AACtH"}

package/dist/components/code-view/code-view.d.ts

@@ -43,6 +43,14 @@ declare const XhCodeViewRoot: import("vue").DefineComponent<import("vue").Extrac
     type: BooleanConstructor;
     default: undefined;
   };
+  blockFolding: BooleanConstructor;
+  /** 折叠着的语法块，写块头的行号；受控，配 v-model:folded。 */
+  folded: {
+    type: PropType<readonly number[]>;
+  };
+  defaultFolded: {
+    type: PropType<readonly number[]>;
+  };
   /** 替换着色实现（典型是接入 Shiki）；显式传 null 则关闭着色。 */
   highlighter: {
     type: PropType<HighlighterPort | null>;
@@ -62,6 +70,8 @@ declare const XhCodeViewRoot: import("vue").DefineComponent<import("vue").Extrac
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   'clamp-toggle': (_details: PayloadOf<CodeViewProps, "onClampToggle">) => true;
   'update:clamped': (_clamped: boolean) => true;
+  'folded-change': (_details: PayloadOf<CodeViewProps, "onFoldedChange">) => true;
+  'update:folded': (_folded: number[]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   code: {
     type: StringConstructor;
@@ -92,6 +102,14 @@ declare const XhCodeViewRoot: import("vue").DefineComponent<import("vue").Extrac
     type: BooleanConstructor;
     default: undefined;
   };
+  blockFolding: BooleanConstructor;
+  /** 折叠着的语法块，写块头的行号；受控，配 v-model:folded。 */
+  folded: {
+    type: PropType<readonly number[]>;
+  };
+  defaultFolded: {
+    type: PropType<readonly number[]>;
+  };
   /** 替换着色实现（典型是接入 Shiki）；显式传 null 则关闭着色。 */
   highlighter: {
     type: PropType<HighlighterPort | null>;
@@ -109,11 +127,14 @@ declare const XhCodeViewRoot: import("vue").DefineComponent<import("vue").Extrac
 }>> & Readonly<{
   "onClamp-toggle"?: ((_details: import("@xihan-ui/headless").CodeViewClampToggleDetails) => any) | undefined;
   "onUpdate:clamped"?: ((_clamped: boolean) => any) | undefined;
+  "onFolded-change"?: ((_details: import("@xihan-ui/headless").CodeViewFoldedChangeDetails) => any) | undefined;
+  "onUpdate:folded"?: ((_folded: number[]) => any) | undefined;
 }>, {
   code: string;
   clamped: boolean;
   wrap: boolean;
   lineNumbers: boolean;
+  blockFolding: boolean;
   complete: boolean;
   highlightWhileStreaming: boolean;
 }, SlotsType<{

package/dist/components/code-view/code-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-view.d.ts","names":[],"sources":["../../../src/components/code-view/code-view.ts"],"mappings":";;;;;;KAoBY,wBAAwB,KAAK;;UAGxB;EACf,MAAM;;EAEN;;EAEA;;cAGW,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;IAYoB,MAAA;;;;;;;;;;;IAKZ,MAAA,SAAS;;;;;;;IAEhB,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAGtB,iBAAA,UAAA,UAAU;EACR,mBAAA;;;;;;;;;;;;;;;;;;;;;;IAZc,MAAA;;;;;;;;;;;IAKZ,MAAA,SAAS;;;;;;;IAEhB,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;EAOvC,WAAC,OAAO,0BAA0B;kCAyE9C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;;;;;;;;;;;MAqB7B,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAU9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAOxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;;EAGhB,QAAC,OAAO,0BAA0B;kCA8B3C;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"code-view.d.ts","names":[],"sources":["../../../src/components/code-view/code-view.ts"],"mappings":";;;;;;KAoBY,wBAAwB,KAAK;;UAGxB;EACf,MAAM;;EAEN;;EAEA;;cAGW,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;IAYoB,MAAA;;;;;;;;;;;;IAMlB,MAAA;;;IACO,MAAA;;;;IAED,MAAA,SAAS;;;;;;;IAEhB,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAGtB,iBAAA,UAAA,UAAU;EACR,mBAAA;EAED,kBAAA,UAAA,UAAU;EACX,kBAAA;;;;;;;;;;;;;;;;;;;;;;IAnBgB,MAAA;;;;;;;;;;;;IAMlB,MAAA;;;IACO,MAAA;;;;IAED,MAAA,SAAS;;;;;;;IAEhB,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;EAUvC,WAAC,OAAO,0BAA0B;kCAsF9C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;;;;;;;;;;;MAqB7B,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAU9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAOxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;;EAGhB,QAAC,OAAO,0BAA0B;kCAkC3C;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/code-view/code-view.js

@@ -27,6 +27,10 @@ const XhCodeViewRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		blockFolding: Boolean,
+		/** 折叠着的语法块，写块头的行号；受控，配 v-model:folded。 */
+		folded: { type: Array },
+		defaultFolded: { type: Array },
 		/** 替换着色实现（典型是接入 Shiki）；显式传 null 则关闭着色。 */
 		highlighter: { type: Object },
 		highlightWhileStreaming: {
@@ -38,7 +42,9 @@ const XhCodeViewRoot = defineComponent({
 	},
 	emits: {
 		"clamp-toggle": (_details) => true,
-		"update:clamped": (_clamped) => true
+		"update:clamped": (_clamped) => true,
+		"folded-change": (_details) => true,
+		"update:folded": (_folded) => true
 	},
 	slots: Object,
 	setup(props, { slots, emit }) {
@@ -76,6 +82,15 @@ const XhCodeViewRoot = defineComponent({
 			get clamped() {
 				return props.clamped;
 			},
+			get blockFolding() {
+				return props.blockFolding;
+			},
+			get folded() {
+				return props.folded;
+			},
+			get defaultFolded() {
+				return props.defaultFolded;
+			},
 			get highlighter() {
 				if (props.highlighter === null) return void 0;
 				if (props.highlighter !== void 0) return props.highlighter;
@@ -95,6 +110,10 @@ const XhCodeViewRoot = defineComponent({
 			onClampToggle: (details) => {
 				emit("clamp-toggle", details);
 				emit("update:clamped", details.clamped);
+			},
+			onFoldedChange: (details) => {
+				emit("folded-change", details);
+				emit("update:folded", details.folded);
 			}
 		});
 		provideCodeView(ctx);
@@ -128,7 +147,7 @@ filename: { type: String } },
 		onBeforeUnmount(() => {
 			ctx.filenameCount.value--;
 		});
-		return () => h("span", ctx.api.value.getFilenameProps(), slots.default?.() ?? props.filename);
+		return () => h("span", ctx.api.value.getFilenameProps(), slots.default?.() ?? props.filename ?? ctx.api.value.filename);
 	}
 });
 const XhCodeViewLangLabel = defineComponent({
@@ -155,14 +174,14 @@ const XhCodeViewCode = defineComponent({
 			return h("code", api.getCodeProps(), api.lines.map((line, index) => h("span", {
 				...api.getLineProps({ index }),
 				key: index
-			}, [api.lineNumbers ? h("span", api.getLineNumberProps({ index })) : null, h("span", api.getLineContentProps({ index }), slots.line?.({
+			}, [api.lineNumbers ? h("span", api.getLineNumberProps({ index })) : null, h("span", api.getLineContentProps({ index }), [api.isFoldStart(index) ? h("button", api.getLineFoldTriggerProps({ index })) : null, slots.line?.({
 				line,
 				index,
 				number: api.lineNumberAt(index)
 			}) ?? (line.tokens.length === 0 ? line.text : line.tokens.map((token, i) => h("span", {
 				...api.getTokenProps(token),
 				key: i
-			}, token.text))))])));
+			}, token.text)))])])));
 		};
 	}
 });

package/dist/components/code-view/code-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"code-view.js","names":[],"sources":["../../../src/components/code-view/code-view.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// 提供 code view 相关实现。\n\nimport type { HighlighterPort, Size } from '@xihan-ui/core'\nimport type { CodeLine, CodeViewApi, CodeViewProps, CodeViewTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { createCodeViewHighlighterResource } from '@xihan-ui/headless'\nimport { defineComponent, h, onBeforeUnmount, onMounted, shallowRef } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideCodeView, useCodeViewContext } from './context'\nimport { useCodeView } from './use-code-view'\n\nconst defaultHighlighter = createCodeViewHighlighterResource(() => import('@xihan-ui/code-highlight'))\n\n/** 默认插槽的载荷：语言、行数与折叠状态，以及切换折叠的句柄。 */\nexport type CodeViewRootSlotProps = Pick<CodeViewApi, 'lang' | 'lineCount' | 'lines' | 'foldable' | 'clamped' | 'setClamped'>\n\n/** 逐行插槽的载荷。 */\nexport interface CodeViewLineSlotProps {\n  line: CodeLine\n  /** 0 基行下标。 */\n  index: number\n  /** 该行显示的行号，等于 startLine + index。 */\n  number: number\n}\n\nexport const XhCodeViewRoot = defineComponent({\n  name: 'XhCodeViewRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    code: { type: String, default: '' },\n    lang: { type: String },\n    filename: { type: String },\n    // 三态，undefined 与 false 同样不落 data-complete\n    complete: { type: Boolean, default: undefined },\n    wrap: Boolean,\n    lineNumbers: Boolean,\n    startLine: { type: Number },\n    highlightLines: { type: [String, Array] as PropType<string | readonly number[]> },\n    clamp: { type: Number },\n    // 纯受控：没有 defaultClamped，要非受控就套 collapsible\n    clamped: { type: Boolean, default: undefined },\n    /** 替换着色实现（典型是接入 Shiki）；显式传 null 则关闭着色。 */\n    highlighter: { type: Object as PropType<HighlighterPort | null> },\n    highlightWhileStreaming: { type: Boolean, default: undefined },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<CodeViewTranslations>> },\n  },\n  emits: {\n    'clamp-toggle': (_details: PayloadOf<CodeViewProps, 'onClampToggle'>) => true,\n    'update:clamped': (_clamped: boolean) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: CodeViewRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const configured = withXhConfig('code-view', props)\n    const highlighterRevision = shallowRef(0)\n    const unsubscribe = defaultHighlighter.subscribe(() => highlighterRevision.value++)\n    onBeforeUnmount(unsubscribe)\n    // getter 透传保住响应性：props 变了带动 connect 重算\n    const forward: CodeViewProps = {\n      get code() {\n        return props.code\n      },\n      get lang() {\n        return props.lang\n      },\n      get filename() {\n        return props.filename\n      },\n      get complete() {\n        return props.complete\n      },\n      get wrap() {\n        return props.wrap\n      },\n      get lineNumbers() {\n        return props.lineNumbers\n      },\n      get startLine() {\n        return props.startLine\n      },\n      get highlightLines() {\n        return props.highlightLines\n      },\n      get clamp() {\n        return props.clamp\n      },\n      get clamped() {\n        return props.clamped\n      },\n      get highlighter() {\n        if (props.highlighter === null)\n          return undefined\n        if (props.highlighter !== undefined)\n          return props.highlighter\n        void highlighterRevision.value\n        defaultHighlighter.request()\n        return defaultHighlighter.read() ?? undefined\n      },\n      get highlightWhileStreaming() {\n        return props.highlightWhileStreaming\n      },\n      get size() {\n        return configured.size\n      },\n      get translations() {\n        return configured.translations\n      },\n      onClampToggle: (details) => {\n        emit('clamp-toggle', details)\n        emit('update:clamped', details.clamped)\n      },\n    }\n    const ctx = useCodeView(forward)\n    provideCodeView(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      lang: ctx.api.value.lang,\n      lineCount: ctx.api.value.lineCount,\n      lines: ctx.api.value.lines,\n      foldable: ctx.api.value.foldable,\n      clamped: ctx.api.value.clamped,\n      setClamped: ctx.api.value.setClamped,\n    }))\n  },\n})\n\nexport const XhCodeViewHeader = defineComponent({\n  name: 'XhCodeViewHeader',\n  setup(_, { slots }) {\n    const ctx = useCodeViewContext()\n    return () => h('div', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCodeViewFilename = defineComponent({\n  name: 'XhCodeViewFilename',\n  props: {\n    /** 未提供时取 XhCodeViewRoot 上的 filename。 */\n    filename: { type: String },\n  },\n  setup(props, { slots }) {\n    const ctx = useCodeViewContext()\n    // 渲出来了才登记：pre 的 aria-labelledby 只在这个节点真在场时才指过来\n    onMounted(() => {\n      ctx.filenameCount.value++\n    })\n    onBeforeUnmount(() => {\n      ctx.filenameCount.value--\n    })\n    return () => h(\n      'span',\n      ctx.api.value.getFilenameProps() as Record<string, unknown>,\n      slots.default?.() ?? props.filename,\n    )\n  },\n})\n\nexport const XhCodeViewLangLabel = defineComponent({\n  name: 'XhCodeViewLangLabel',\n  setup(_, { slots }) {\n    const ctx = useCodeViewContext()\n    return () => h(\n      'span',\n      ctx.api.value.getLangLabelProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.lang,\n    )\n  },\n})\n\nexport const XhCodeViewPre = defineComponent({\n  name: 'XhCodeViewPre',\n  setup(_, { slots }) {\n    const ctx = useCodeViewContext()\n    // 用 pre 保留代码里的空白与换行\n    return () => h('pre', ctx.api.value.getPreProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCodeViewCode = defineComponent({\n  name: 'XhCodeViewCode',\n  slots: Object as SlotsType<{\n    line?: (props: CodeViewLineSlotProps) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useCodeViewContext()\n    // 行是算出来的派生结构，作者写不出 N 个节点，由组件铺；每行的内容可用 line 插槽接管\n    return () => {\n      const api = ctx.api.value\n      return h('code', api.getCodeProps() as Record<string, unknown>, api.lines.map((line, index) => h(\n        'span',\n        { ...api.getLineProps({ index }) as Record<string, unknown>, key: index },\n        [\n          // 行号槽不开就不建节点，两个适配器同一条判据\n          api.lineNumbers ? h('span', api.getLineNumberProps({ index }) as Record<string, unknown>) : null,\n          h(\n            'span',\n            api.getLineContentProps({ index }) as Record<string, unknown>,\n            slots.line?.({ line, index, number: api.lineNumberAt(index) })\n            // 没有着色结果就一个文本节点，别平白多包一层 span\n            ?? (line.tokens.length === 0\n              ? line.text\n              : line.tokens.map((token, i) => h(\n                  'span',\n                  { ...api.getTokenProps(token) as Record<string, unknown>, key: i },\n                  token.text,\n                ))),\n          ),\n        ],\n      )))\n    }\n  },\n})\n\nexport const XhCodeViewFoldTrigger = defineComponent({\n  name: 'XhCodeViewFoldTrigger',\n  setup(_, { slots }) {\n    const ctx = useCodeViewContext()\n    return () => h('button', ctx.api.value.getFoldTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"code-view.js","names":[],"sources":["../../../src/components/code-view/code-view.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// 提供 code view 相关实现。\n\nimport type { HighlighterPort, Size } from '@xihan-ui/core'\nimport type { CodeLine, CodeViewApi, CodeViewProps, CodeViewTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { createCodeViewHighlighterResource } from '@xihan-ui/headless'\nimport { defineComponent, h, onBeforeUnmount, onMounted, shallowRef } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideCodeView, useCodeViewContext } from './context'\nimport { useCodeView } from './use-code-view'\n\nconst defaultHighlighter = createCodeViewHighlighterResource(() => import('@xihan-ui/code-highlight'))\n\n/** 默认插槽的载荷：语言、行数与折叠状态，以及切换折叠的句柄。 */\nexport type CodeViewRootSlotProps = Pick<CodeViewApi, 'lang' | 'lineCount' | 'lines' | 'foldable' | 'clamped' | 'setClamped'>\n\n/** 逐行插槽的载荷。 */\nexport interface CodeViewLineSlotProps {\n  line: CodeLine\n  /** 0 基行下标。 */\n  index: number\n  /** 该行显示的行号，等于 startLine + index。 */\n  number: number\n}\n\nexport const XhCodeViewRoot = defineComponent({\n  name: 'XhCodeViewRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    code: { type: String, default: '' },\n    lang: { type: String },\n    filename: { type: String },\n    // 三态，undefined 与 false 同样不落 data-complete\n    complete: { type: Boolean, default: undefined },\n    wrap: Boolean,\n    lineNumbers: Boolean,\n    startLine: { type: Number },\n    highlightLines: { type: [String, Array] as PropType<string | readonly number[]> },\n    clamp: { type: Number },\n    // 纯受控：没有 defaultClamped，要非受控就套 collapsible\n    clamped: { type: Boolean, default: undefined },\n    blockFolding: Boolean,\n    /** 折叠着的语法块，写块头的行号；受控，配 v-model:folded。 */\n    folded: { type: Array as PropType<readonly number[]> },\n    defaultFolded: { type: Array as PropType<readonly number[]> },\n    /** 替换着色实现（典型是接入 Shiki）；显式传 null 则关闭着色。 */\n    highlighter: { type: Object as PropType<HighlighterPort | null> },\n    highlightWhileStreaming: { type: Boolean, default: undefined },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<CodeViewTranslations>> },\n  },\n  emits: {\n    'clamp-toggle': (_details: PayloadOf<CodeViewProps, 'onClampToggle'>) => true,\n    'update:clamped': (_clamped: boolean) => true,\n    // folded-change 携带 { folded }，块头行号升序\n    'folded-change': (_details: PayloadOf<CodeViewProps, 'onFoldedChange'>) => true,\n    'update:folded': (_folded: number[]) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: CodeViewRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const configured = withXhConfig('code-view', props)\n    const highlighterRevision = shallowRef(0)\n    const unsubscribe = defaultHighlighter.subscribe(() => highlighterRevision.value++)\n    onBeforeUnmount(unsubscribe)\n    // getter 透传保住响应性：props 变了带动 connect 重算\n    const forward: CodeViewProps = {\n      get code() {\n        return props.code\n      },\n      get lang() {\n        return props.lang\n      },\n      get filename() {\n        return props.filename\n      },\n      get complete() {\n        return props.complete\n      },\n      get wrap() {\n        return props.wrap\n      },\n      get lineNumbers() {\n        return props.lineNumbers\n      },\n      get startLine() {\n        return props.startLine\n      },\n      get highlightLines() {\n        return props.highlightLines\n      },\n      get clamp() {\n        return props.clamp\n      },\n      get clamped() {\n        return props.clamped\n      },\n      get blockFolding() {\n        return props.blockFolding\n      },\n      get folded() {\n        return props.folded\n      },\n      get defaultFolded() {\n        return props.defaultFolded\n      },\n      get highlighter() {\n        if (props.highlighter === null)\n          return undefined\n        if (props.highlighter !== undefined)\n          return props.highlighter\n        void highlighterRevision.value\n        defaultHighlighter.request()\n        return defaultHighlighter.read() ?? undefined\n      },\n      get highlightWhileStreaming() {\n        return props.highlightWhileStreaming\n      },\n      get size() {\n        return configured.size\n      },\n      get translations() {\n        return configured.translations\n      },\n      onClampToggle: (details) => {\n        emit('clamp-toggle', details)\n        emit('update:clamped', details.clamped)\n      },\n      onFoldedChange: (details) => {\n        emit('folded-change', details)\n        emit('update:folded', details.folded)\n      },\n    }\n    const ctx = useCodeView(forward)\n    provideCodeView(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      lang: ctx.api.value.lang,\n      lineCount: ctx.api.value.lineCount,\n      lines: ctx.api.value.lines,\n      foldable: ctx.api.value.foldable,\n      clamped: ctx.api.value.clamped,\n      setClamped: ctx.api.value.setClamped,\n    }))\n  },\n})\n\nexport const XhCodeViewHeader = defineComponent({\n  name: 'XhCodeViewHeader',\n  setup(_, { slots }) {\n    const ctx = useCodeViewContext()\n    return () => h('div', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCodeViewFilename = defineComponent({\n  name: 'XhCodeViewFilename',\n  props: {\n    /** 未提供时取 XhCodeViewRoot 上的 filename。 */\n    filename: { type: String },\n  },\n  setup(props, { slots }) {\n    const ctx = useCodeViewContext()\n    // 渲出来了才登记：pre 的 aria-labelledby 只在这个节点真在场时才指过来\n    onMounted(() => {\n      ctx.filenameCount.value++\n    })\n    onBeforeUnmount(() => {\n      ctx.filenameCount.value--\n    })\n    return () => h(\n      'span',\n      ctx.api.value.getFilenameProps() as Record<string, unknown>,\n      slots.default?.() ?? props.filename ?? ctx.api.value.filename,\n    )\n  },\n})\n\nexport const XhCodeViewLangLabel = defineComponent({\n  name: 'XhCodeViewLangLabel',\n  setup(_, { slots }) {\n    const ctx = useCodeViewContext()\n    return () => h(\n      'span',\n      ctx.api.value.getLangLabelProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.lang,\n    )\n  },\n})\n\nexport const XhCodeViewPre = defineComponent({\n  name: 'XhCodeViewPre',\n  setup(_, { slots }) {\n    const ctx = useCodeViewContext()\n    // 用 pre 保留代码里的空白与换行\n    return () => h('pre', ctx.api.value.getPreProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCodeViewCode = defineComponent({\n  name: 'XhCodeViewCode',\n  slots: Object as SlotsType<{\n    line?: (props: CodeViewLineSlotProps) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useCodeViewContext()\n    // 行是算出来的派生结构，作者写不出 N 个节点，由组件铺；每行的内容可用 line 插槽接管\n    return () => {\n      const api = ctx.api.value\n      return h('code', api.getCodeProps() as Record<string, unknown>, api.lines.map((line, index) => h(\n        'span',\n        { ...api.getLineProps({ index }) as Record<string, unknown>, key: index },\n        [\n          // 行号槽不开就不建节点，两个适配器同一条判据\n          api.lineNumbers ? h('span', api.getLineNumberProps({ index }) as Record<string, unknown>) : null,\n          h(\n            'span',\n            api.getLineContentProps({ index }) as Record<string, unknown>,\n            [\n              // 块头的折叠钮放在正文最前面，由皮肤定位到正文让出的那一列里；不是块头的行不建\n              api.isFoldStart(index) ? h('button', api.getLineFoldTriggerProps({ index }) as Record<string, unknown>) : null,\n              slots.line?.({ line, index, number: api.lineNumberAt(index) })\n              // 没有着色结果就一个文本节点，别平白多包一层 span\n              ?? (line.tokens.length === 0\n                ? line.text\n                : line.tokens.map((token, i) => h(\n                    'span',\n                    { ...api.getTokenProps(token) as Record<string, unknown>, key: i },\n                    token.text,\n                  ))),\n            ],\n          ),\n        ],\n      )))\n    }\n  },\n})\n\nexport const XhCodeViewFoldTrigger = defineComponent({\n  name: 'XhCodeViewFoldTrigger',\n  setup(_, { slots }) {\n    const ctx = useCodeViewContext()\n    return () => h('button', ctx.api.value.getFoldTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AAiBA,MAAM,qBAAqB,wCAAwC,OAAO,2BAA2B;AAcrG,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CAEN,OAAO;EACL,MAAM;GAAE,MAAM;GAAQ,SAAS;EAAG;EAClC,MAAM,EAAE,MAAM,OAAO;EACrB,UAAU,EAAE,MAAM,OAAO;EAEzB,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,MAAM;EACN,aAAa;EACb,WAAW,EAAE,MAAM,OAAO;EAC1B,gBAAgB,EAAE,MAAM,CAAC,QAAQ,KAAK,EAA0C;EAChF,OAAO,EAAE,MAAM,OAAO;EAEtB,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,cAAc;;EAEd,QAAQ,EAAE,MAAM,MAAqC;EACrD,eAAe,EAAE,MAAM,MAAqC;;EAE5D,aAAa,EAAE,MAAM,OAA2C;EAChE,yBAAyB;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7D,MAAM,EAAE,MAAM,OAAyB;EACvC,cAAc,EAAE,MAAM,OAAkD;CAC1E;CACA,OAAO;EACL,iBAAiB,aAAwD;EACzE,mBAAmB,aAAsB;EAEzC,kBAAkB,aAAyD;EAC3E,kBAAkB,YAAsB;CAC1C;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,aAAa,aAAa,aAAa,KAAK;EAClD,MAAM,sBAAsB,WAAW,CAAC;EAExC,gBADoB,mBAAmB,gBAAgB,oBAAoB,OACjD,CAAC;EAqE3B,MAAM,MAAM,YAAY;GAlEtB,IAAI,OAAO;IACT,OAAO,MAAM;GACf;GACA,IAAI,OAAO;IACT,OAAO,MAAM;GACf;GACA,IAAI,WAAW;IACb,OAAO,MAAM;GACf;GACA,IAAI,WAAW;IACb,OAAO,MAAM;GACf;GACA,IAAI,OAAO;IACT,OAAO,MAAM;GACf;GACA,IAAI,cAAc;IAChB,OAAO,MAAM;GACf;GACA,IAAI,YAAY;IACd,OAAO,MAAM;GACf;GACA,IAAI,iBAAiB;IACnB,OAAO,MAAM;GACf;GACA,IAAI,QAAQ;IACV,OAAO,MAAM;GACf;GACA,IAAI,UAAU;IACZ,OAAO,MAAM;GACf;GACA,IAAI,eAAe;IACjB,OAAO,MAAM;GACf;GACA,IAAI,SAAS;IACX,OAAO,MAAM;GACf;GACA,IAAI,gBAAgB;IAClB,OAAO,MAAM;GACf;GACA,IAAI,cAAc;IAChB,IAAI,MAAM,gBAAgB,MACxB,OAAO,KAAA;IACT,IAAI,MAAM,gBAAgB,KAAA,GACxB,OAAO,MAAM;IACf,oBAAyB;IACzB,mBAAmB,QAAQ;IAC3B,OAAO,mBAAmB,KAAK,KAAK,KAAA;GACtC;GACA,IAAI,0BAA0B;IAC5B,OAAO,MAAM;GACf;GACA,IAAI,OAAO;IACT,OAAO,WAAW;GACpB;GACA,IAAI,eAAe;IACjB,OAAO,WAAW;GACpB;GACA,gBAAgB,YAAY;IAC1B,KAAK,gBAAgB,OAAO;IAC5B,KAAK,kBAAkB,QAAQ,OAAO;GACxC;GACA,iBAAiB,YAAY;IAC3B,KAAK,iBAAiB,OAAO;IAC7B,KAAK,iBAAiB,QAAQ,MAAM;GACtC;EAE4B,CAAC;EAC/B,gBAAgB,GAAG;EACnB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,MAAM,IAAI,IAAI,MAAM;GACpB,WAAW,IAAI,IAAI,MAAM;GACzB,OAAO,IAAI,IAAI,MAAM;GACrB,UAAU,IAAI,IAAI,MAAM;GACxB,SAAS,IAAI,IAAI,MAAM;GACvB,YAAY,IAAI,IAAI,MAAM;EAC5B,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,OAAO;;AAEL,UAAU,EAAE,MAAM,OAAO,EAC3B;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,mBAAmB;EAE/B,gBAAgB;GACd,IAAI,cAAc;EACpB,CAAC;EACD,sBAAsB;GACpB,IAAI,cAAc;EACpB,CAAC;EACD,aAAa,EACX,QACA,IAAI,IAAI,MAAM,iBAAiB,GAC/B,MAAM,UAAU,KAAK,MAAM,YAAY,IAAI,IAAI,MAAM,QACvD;CACF;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EACX,QACA,IAAI,IAAI,MAAM,kBAAkB,GAChC,MAAM,UAAU,KAAK,IAAI,IAAI,MAAM,IACrC;CACF;AACF,CAAC;AAED,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAE/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,YAAY,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;AAED,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,OAAO;CAGP,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAE/B,aAAa;GACX,MAAM,MAAM,IAAI,IAAI;GACpB,OAAO,EAAE,QAAQ,IAAI,aAAa,GAA8B,IAAI,MAAM,KAAK,MAAM,UAAU,EAC7F,QACA;IAAE,GAAG,IAAI,aAAa,EAAE,MAAM,CAAC;IAA8B,KAAK;GAAM,GACxE,CAEE,IAAI,cAAc,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,CAAC,CAA4B,IAAI,MAC5F,EACE,QACA,IAAI,oBAAoB,EAAE,MAAM,CAAC,GACjC,CAEE,IAAI,YAAY,KAAK,IAAI,EAAE,UAAU,IAAI,wBAAwB,EAAE,MAAM,CAAC,CAA4B,IAAI,MAC1G,MAAM,OAAO;IAAE;IAAM;IAAO,QAAQ,IAAI,aAAa,KAAK;GAAE,CAAC,MAEzD,KAAK,OAAO,WAAW,IACvB,KAAK,OACL,KAAK,OAAO,KAAK,OAAO,MAAM,EAC5B,QACA;IAAE,GAAG,IAAI,cAAc,KAAK;IAA8B,KAAK;GAAE,GACjE,MAAM,IACR,CAAC,EACP,CACF,CACF,CACF,CAAC,CAAC;EACJ;CACF;AACF,CAAC;AAED,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CAC5G;AACF,CAAC"}

package/dist/components/collapsible/collapsible.d.ts

@@ -20,6 +20,8 @@ declare const XhCollapsibleRoot: import("vue").DefineComponent<import("vue").Ext
   dir: {
     type: PropType<Direction>;
   };
+  lazyMount: BooleanConstructor;
+  unmountOnExit: BooleanConstructor;
 }>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
@@ -41,11 +43,15 @@ declare const XhCollapsibleRoot: import("vue").DefineComponent<import("vue").Ext
   dir: {
     type: PropType<Direction>;
   };
+  lazyMount: BooleanConstructor;
+  unmountOnExit: BooleanConstructor;
 }>> & Readonly<{
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").CollapsibleOpenChangeDetails) => any) | undefined;
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
 }>, {
   disabled: boolean;
+  lazyMount: boolean;
+  unmountOnExit: boolean;
   open: boolean;
   defaultOpen: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

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

@@ -1 +1 @@
-{"version":3,"file":"collapsible.d.ts","names":[],"sources":["../../../src/components/collapsible/collapsible.ts"],"mappings":";;;;;KAiBK,mBAAmB;cAEX,iCAAiB,8BAAA;;;;;;;;IAMF,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;EAIN,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;;IAPT,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;;;;qCAgBlC;;cAGW,mCAAmB,wCAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,8BAAA;;;;;;;;;;qCAsB/B;cAEW,sCAAsB,wCAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,wCAAA,oBAAA,4BAAA;;8BAY/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"collapsible.d.ts","names":[],"sources":["../../../src/components/collapsible/collapsible.ts"],"mappings":";;;;;KAiBK,mBAAmB;cAEX,iCAAiB,8BAAA;;;;;;;;IAMF,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;;EAMN,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;;IATT,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;;;;;;;;qCAkBlC;;cAGW,mCAAmB,wCAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,8BAAA;;;;;;;;;;qCAsB/B;cAEW,sCAAsB,wCAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,wCAAA,oBAAA,4BAAA;;8BAY/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/collapsible/collapsible.js

@@ -15,7 +15,9 @@ const XhCollapsibleRoot = defineComponent({
 		disabled: Boolean,
 		tone: { type: String },
 		size: { type: String },
-		dir: { type: String }
+		dir: { type: String },
+		lazyMount: Boolean,
+		unmountOnExit: Boolean
 	},
 	emits: {
 		"open-change": (_details) => true,
@@ -75,7 +77,7 @@ const XhCollapsibleContent = defineComponent({
 			ref: (el) => {
 				ctx.contentRef.value = el;
 			}
-		}, slots.default?.());
+		}, ctx.api.value.isContentMounted(ctx.visible.value) ? slots.default?.() : void 0);
 	}
 });
 //#endregion