@opendesign-plus/components 0.0.1-rc.100 → 0.0.1-rc.102

package/dist/treeshaking/components/article-anchor/OArticleAnchor.vue_vue_type_script_setup_true_lang.mjs

@@ -31,13 +31,21 @@ var OArticleAnchor_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ d
 			type: Boolean,
 			default: true
 		},
+		idPrefix: { default: "" },
 		container: {},
 		targetOffset: {},
+		bounds: { default: 5 },
+		changeHash: {
+			type: Boolean,
+			default: true
+		},
 		radius: { default: "var(--o-radius-xs)" }
 	},
-	setup(__props, { expose: __expose }) {
+	emits: ["change", "click"],
+	setup(__props, { expose: __expose, emit: __emit }) {
 		const props = __props;
 		const { t } = useI18n();
+		const emit = __emit;
 		const autoItems = ref([]);
 		const items = computed(() => props.items.length ? props.items : autoItems.value);
 		const titleText = computed(() => props.title || t("articleAnchor.title"));
@@ -48,12 +56,48 @@ var OArticleAnchor_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ d
 		watch([() => props.size, expanded], () => {
 			document.body.style.overflow = props.size === "mobile" && expanded.value ? "hidden" : "";
 		});
-		const onAnchorClick = () => {
+		const onAnchorClick = (ev, link) => {
+			emit("click", ev, link);
 			if (props.size === "pad") expanded.value = false;
 		};
+		const onAnchorChange = (link) => {
+			emit("change", link);
+		};
+		/** hash 别名映射：href 为展示地址（如 #a），observeHref 为实际目标（如 #user-content-a） */
+		const hrefAliasMap = computed(() => {
+			const map = /* @__PURE__ */ new Map();
+			const walk = (list) => {
+				list.forEach((item) => {
+					if (item.observeHref && item.observeHref !== item.href) map.set(item.href, item.observeHref);
+					if (item.children?.length) walk(item.children);
+				});
+			};
+			walk(items.value);
+			return map;
+		});
+		const jumpFromHash = (hash) => {
+			const link = (anchorRef.value?.$el)?.querySelector(`a[href="${CSS.escape(hash)}"]`);
+			if (link) {
+				link.click();
+				return;
+			}
+			const observeHref = hrefAliasMap.value.get(hash);
+			const el = observeHref && document.getElementById(observeHref.replace(/^#/, ""));
+			if (!el) return;
+			const container = typeof props.container === "string" ? document.querySelector(props.container) || window : props.container || window;
+			const offsetTop = el.getBoundingClientRect().top - (container === window ? document.documentElement.clientTop : container.getBoundingClientRect().top);
+			const y = (container === window ? window.scrollY : container.scrollTop) + offsetTop - (props.targetOffset ?? 0);
+			if (container === window) window.scrollTo({ top: y });
+			else container.scrollTo({ top: y });
+		};
+		const onHashChange = () => {
+			if (!window.location.hash) return;
+			jumpFromHash(decodeURIComponent(window.location.hash));
+		};
 		const pcSlotRef = ref();
 		const padSlotRef = ref();
 		const hiddenSlotRef = ref();
+		const anchorRef = ref();
 		const teleportTarget = computed(() => {
 			if (props.size === "pc") return pcSlotRef.value;
 			if (props.size === "pad" && expanded.value) return padSlotRef.value;
@@ -96,9 +140,16 @@ var OArticleAnchor_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ d
 					if (props.writeId) elH.id = id;
 				}
 				seen.add(id);
+				let href = `#${id}`;
+				let observeHref;
+				if (props.idPrefix && id.startsWith(props.idPrefix) && id.length > props.idPrefix.length) {
+					href = `#${id.slice(props.idPrefix.length)}`;
+					observeHref = `#${id}`;
+				}
 				const item = {
-					id,
+					href,
 					title: (elH.textContent || "").trim(),
+					observeHref,
 					children: []
 				};
 				while (stack.length > 1 && stack[stack.length - 1].level >= level) stack.pop();
@@ -142,15 +193,19 @@ var OArticleAnchor_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ d
 		onMounted(() => {
 			collect();
 			ensureObserver();
+			onHashChange();
+			window.addEventListener("hashchange", onHashChange);
 		});
 		onBeforeUnmount(() => {
 			teardownObserver();
 			document.body.style.overflow = "";
+			window.removeEventListener("hashchange", onHashChange);
 		});
 		watch(() => [
 			props.selector,
 			props.autoExtract,
-			props.maxLevel
+			props.maxLevel,
+			props.idPrefix
 		], () => {
 			teardownObserver();
 			collect();
@@ -225,15 +280,25 @@ var OArticleAnchor_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ d
 					to: teleportTarget.value,
 					disabled: !teleportTarget.value
 				}, [createElementVNode("div", _hoisted_2, [createVNode(unref(OAnchor), {
+					ref_key: "anchorRef",
+					ref: anchorRef,
 					layout: "v",
 					size: "small",
 					container: __props.container,
 					"target-offset": __props.targetOffset,
+					bounds: __props.bounds,
+					"change-hash": __props.changeHash,
+					onChange: onAnchorChange,
 					onClick: onAnchorClick
 				}, {
 					default: withCtx(() => [createVNode(ArticleAnchorItems_default, { items: items.value }, null, 8, ["items"])]),
 					_: 1
-				}, 8, ["container", "target-offset"])])], 8, ["to", "disabled"]))
+				}, 8, [
+					"container",
+					"target-offset",
+					"bounds",
+					"change-hash"
+				])])], 8, ["to", "disabled"]))
 			])) : createCommentVNode("", true);
 		};
 	}

package/dist/treeshaking/components/article-anchor/{OArticleAnchor.vue_vue_type_style_index_0_scoped_6e032ecb_lang.css → OArticleAnchor.vue_vue_type_style_index_0_scoped_dcc5e0d5_lang.css}

@@ -1,18 +1,18 @@
-.hover-icon-rotate .o-icon[data-v-6e032ecb] {
+.hover-icon-rotate .o-icon[data-v-dcc5e0d5] {
   transition: all var(--o-duration-m1) var(--o-easing-standard-in);
 }
 @media (hover: hover) {
-.hover-icon-rotate:hover .o-icon[data-v-6e032ecb] {
+.hover-icon-rotate:hover .o-icon[data-v-dcc5e0d5] {
     transform: rotate(-180deg);
 }
 }
-.o-article-anchor__body[data-v-6e032ecb] .o-anchor {
+.o-article-anchor__body[data-v-dcc5e0d5] .o-anchor {
   --anchor-item-link-color: var(--o-color-info2);
   --anchor-item-link-color-active: var(--o-color-primary1);
   --anchor-item-link-color-hover: var(--o-color-primary2);
   --anchor-item-link-color-press: var(--o-color-primary3);
   --anchor-line-bg-color: var(--o-color-control4);
 }
-.o-article-anchor--hidden[data-v-6e032ecb] {
+.o-article-anchor--hidden[data-v-dcc5e0d5] {
   display: none;
 }

package/dist/treeshaking/components/article-anchor/components/ArticleAnchorItems.mjs

@@ -1,6 +1,6 @@
 import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_export-helper.mjs";
 import ArticleAnchorItems_vue_vue_type_script_setup_true_lang_default from "./ArticleAnchorItems.vue_vue_type_script_setup_true_lang.mjs";
-import './ArticleAnchorItems.vue_vue_type_style_index_0_scoped_c0fc5e57_lang.css';
+import './ArticleAnchorItems.vue_vue_type_style_index_0_scoped_126e1824_lang.css';
 // src/components/article-anchor/components/ArticleAnchorItems.vue
-var ArticleAnchorItems_default = /*#__PURE__*/ _plugin_vue_export_helper_default(ArticleAnchorItems_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-c0fc5e57"]]);
+var ArticleAnchorItems_default = /*#__PURE__*/ _plugin_vue_export_helper_default(ArticleAnchorItems_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-126e1824"]]);
 export { ArticleAnchorItems_default as default };

package/dist/treeshaking/components/article-anchor/components/ArticleAnchorItems.vue_vue_type_script_setup_true_lang.mjs

@@ -9,9 +9,10 @@ var ArticleAnchorItems_vue_vue_type_script_setup_true_lang_default = /*@__PURE__
 		return (_ctx, _cache) => {
 			return openBlock(true), createElementBlock(Fragment, null, renderList(__props.items, (item) => {
 				return openBlock(), createBlock(unref(OAnchorItem), {
-					key: item.id,
+					key: item.href,
 					title: item.title,
-					href: `#${item.id}`,
+					href: item.href,
+					"observe-href": item.observeHref,
 					class: "o-article-anchor-item"
 				}, {
 					default: withCtx(() => [item.children?.length ? (openBlock(), createBlock(ArticleAnchorItems_default, {
@@ -19,7 +20,11 @@ var ArticleAnchorItems_vue_vue_type_script_setup_true_lang_default = /*@__PURE__
 						items: item.children
 					}, null, 8, ["items"])) : createCommentVNode("", true)]),
 					_: 2
-				}, 1032, ["title", "href"]);
+				}, 1032, [
+					"title",
+					"href",
+					"observe-href"
+				]);
 			}), 128);
 		};
 	}

package/dist/treeshaking/components/article-anchor/components/{ArticleAnchorItems.vue_vue_type_style_index_0_scoped_c0fc5e57_lang.css → ArticleAnchorItems.vue_vue_type_style_index_0_scoped_126e1824_lang.css}

@@ -1,11 +1,11 @@
-.hover-icon-rotate .o-icon[data-v-c0fc5e57] {
+.hover-icon-rotate .o-icon[data-v-126e1824] {
   transition: all var(--o-duration-m1) var(--o-easing-standard-in);
 }
 @media (hover: hover) {
-.hover-icon-rotate:hover .o-icon[data-v-c0fc5e57] {
+.hover-icon-rotate:hover .o-icon[data-v-126e1824] {
     transform: rotate(-180deg);
 }
 }
-.o-article-anchor-item[data-v-c0fc5e57] {
+.o-article-anchor-item[data-v-126e1824] {
   --link-color: var(--o-color-info2);
 }

package/dist/treeshaking/components/article-anchor/components/ArticleAnchorMobile.mjs

@@ -1,6 +1,6 @@
 import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_export-helper.mjs";
 import ArticleAnchorMobile_vue_vue_type_script_setup_true_lang_default from "./ArticleAnchorMobile.vue_vue_type_script_setup_true_lang.mjs";
-import './ArticleAnchorMobile.vue_vue_type_style_index_0_scoped_648619c2_lang.css';
+import './ArticleAnchorMobile.vue_vue_type_style_index_0_scoped_ccc0d33c_lang.css';
 // src/components/article-anchor/components/ArticleAnchorMobile.vue
-var ArticleAnchorMobile_default = /*#__PURE__*/ _plugin_vue_export_helper_default(ArticleAnchorMobile_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-648619c2"]]);
+var ArticleAnchorMobile_default = /*#__PURE__*/ _plugin_vue_export_helper_default(ArticleAnchorMobile_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-ccc0d33c"]]);
 export { ArticleAnchorMobile_default as default };

package/dist/treeshaking/components/article-anchor/components/ArticleAnchorMobile.vue_vue_type_script_setup_true_lang.mjs

@@ -22,7 +22,7 @@ var ArticleAnchorMobile_vue_vue_type_script_setup_true_lang_default = /*@__PURE_
 		"update:visible"
 	],
 	setup(__props, { emit: __emit }) {
-		useCssVars((_ctx) => ({ "v1994d85b": _ctx.radius }));
+		useCssVars((_ctx) => ({ "v3bf9ee34": _ctx.radius }));
 		const props = __props;
 		const emit = __emit;
 		const visible = computed({
@@ -54,11 +54,12 @@ var ArticleAnchorMobile_vue_vue_type_script_setup_true_lang_default = /*@__PURE_
 			const offset = (props.targetOffset ?? 0) + 1;
 			let current = null;
 			for (const item of flatItems.value) {
-				const el = document.getElementById(item.id);
+				const observeId = (item.observeHref || item.href).replace(/^#/, "");
+				const el = document.getElementById(observeId);
 				if (!el) continue;
-				if (el.getBoundingClientRect().top - containerTop <= offset) current = item.id;
+				if (el.getBoundingClientRect().top - containerTop <= offset) current = item.href;
 			}
-			if (current && active.value !== `#${current}`) active.value = `#${current}`;
+			if (current && active.value !== current) active.value = current;
 		};
 		useEventListener(scrollTarget, "scroll", updateActive);
 		watch(() => props.expanded, (value) => {
@@ -67,8 +68,9 @@ var ArticleAnchorMobile_vue_vue_type_script_setup_true_lang_default = /*@__PURE_
 		watch(() => props.items, () => {
 			nextTick(updateActive);
 		}, { deep: true });
-		const jump = (id) => {
-			document.getElementById(id)?.scrollIntoView({
+		const jump = (item) => {
+			const target = item.observeHref || item.href;
+			document.getElementById(target.replace(/^#/, ""))?.scrollIntoView({
 				behavior: "smooth",
 				block: "start"
 			});
@@ -101,19 +103,19 @@ var ArticleAnchorMobile_vue_vue_type_script_setup_true_lang_default = /*@__PURE_
 					class: "o-article-anchor--mobile__menu"
 				}, {
 					default: withCtx(() => [(openBlock(true), createElementBlock(Fragment, null, renderList(__props.items, (item) => {
-						return openBlock(), createElementBlock(Fragment, { key: item.id }, [createVNode(unref(OMenuItem), {
+						return openBlock(), createElementBlock(Fragment, { key: item.href }, [createVNode(unref(OMenuItem), {
 							class: "o-article-anchor--mobile__menu-item",
-							value: `#${item.id}`,
-							onClick: ($event) => jump(item.id)
+							value: item.href,
+							onClick: ($event) => jump(item)
 						}, {
 							default: withCtx(() => [createTextVNode(toDisplayString(item.title), 1)]),
 							_: 2
 						}, 1032, ["value", "onClick"]), item.children?.length ? (openBlock(true), createElementBlock(Fragment, { key: 0 }, renderList(item.children, (child) => {
 							return openBlock(), createBlock(unref(OMenuItem), {
-								key: child.id,
-								value: `#${child.id}`,
+								key: child.href,
+								value: child.href,
 								class: "o-article-anchor--mobile__menu-subitem",
-								onClick: ($event) => jump(child.id)
+								onClick: ($event) => jump(child)
 							}, {
 								default: withCtx(() => [createTextVNode(toDisplayString(child.title), 1)]),
 								_: 2

package/dist/treeshaking/components/article-anchor/components/{ArticleAnchorMobile.vue_vue_type_style_index_0_scoped_648619c2_lang.css → ArticleAnchorMobile.vue_vue_type_style_index_0_scoped_ccc0d33c_lang.css}

@@ -1,15 +1,15 @@
-.hover-icon-rotate .o-icon[data-v-648619c2] {
+.hover-icon-rotate .o-icon[data-v-ccc0d33c] {
   transition: all var(--o-duration-m1) var(--o-easing-standard-in);
 }
 @media (hover: hover) {
-.hover-icon-rotate:hover .o-icon[data-v-648619c2] {
+.hover-icon-rotate:hover .o-icon[data-v-ccc0d33c] {
     transform: rotate(-180deg);
 }
 }
-.o-article-anchor--mobile[data-v-648619c2] {
-  --o-article-anchor-radius: var(--v1994d85b);
+.o-article-anchor--mobile[data-v-ccc0d33c] {
+  --o-article-anchor-radius: var(--v3bf9ee34);
 }
-.o-article-anchor--mobile__fab[data-v-648619c2] {
+.o-article-anchor--mobile__fab[data-v-ccc0d33c] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -21,27 +21,27 @@
   border-radius: 50%;
   box-shadow: var(--o-shadow-3);
 }
-.o-article-anchor--mobile__fab-icon[data-v-648619c2] {
+.o-article-anchor--mobile__fab-icon[data-v-ccc0d33c] {
   font-size: 24px;
   color: var(--o-color-info2);
   line-height: 1;
 }
-.o-article-anchor--mobile__sheet-title[data-v-648619c2] {
+.o-article-anchor--mobile__sheet-title[data-v-ccc0d33c] {
   color: var(--o-color-info1);
   font-weight: 600;
   font-size: 18px;
   line-height: 26px;
 }
-.o-article-anchor--mobile__menu[data-v-648619c2] {
+.o-article-anchor--mobile__menu[data-v-ccc0d33c] {
   --menu-width: 100%;
 }
-.o-article-anchor--mobile__menu-sub[data-v-648619c2] {
+.o-article-anchor--mobile__menu-sub[data-v-ccc0d33c] {
   padding-left: 16px;
 }
-.o-article-anchor--mobile__menu-item[data-v-648619c2] {
+.o-article-anchor--mobile__menu-item[data-v-ccc0d33c] {
   padding: 12px 16px;
 }
-.o-article-anchor--mobile__menu-subitem[data-v-648619c2] {
+.o-article-anchor--mobile__menu-subitem[data-v-ccc0d33c] {
   padding: 12px 16px;
   padding-left: 28px;
 }

package/dist/treeshaking/components/article-anchor/index.d.ts

@@ -1,21 +1,158 @@
 import { App } from 'vue';
 declare const OArticleAnchor: {
-    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('../../index').ArticleAnchorPropsT> & Readonly<{}>, {
+    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('../../index').ArticleAnchorPropsT> & Readonly<{
+        onChange?: ((link: string) => any) | undefined;
+        onClick?: ((ev: MouseEvent, link?: string | undefined) => any) | undefined;
+    }>, {
         collect: () => void;
         items: import('vue').ComputedRef<import('../../index').ArticleAnchorItemT[]>;
-    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+        change: (link: string) => any;
+        click: (ev: MouseEvent, link?: string | undefined) => any;
+    }, import('vue').PublicProps, {
         size: "pc" | "pad" | "mobile";
         items: import('../../index').ArticleAnchorItemT[];
+        bounds: number;
+        changeHash: boolean;
         radius: string;
         showTitle: boolean;
         selector: string | HTMLElement;
         autoExtract: boolean;
         maxLevel: number;
         writeId: boolean;
+        idPrefix: string;
     }, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
         pcSlotRef: HTMLDivElement;
         padSlotRef: HTMLDivElement;
         hiddenSlotRef: HTMLDivElement;
+        anchorRef: ({
+            $: import('vue').ComponentInternalInstance;
+            $data: {};
+            $props: Partial<{
+                size: "medium" | "small" | "menu";
+                layout: "h" | "v";
+                bounds: number;
+                targetOffset: number;
+                changeHash: boolean;
+            }> & Omit<{
+                readonly size: "small" | "medium" | "menu";
+                readonly layout: "v" | "h";
+                readonly targetOffset: number;
+                readonly bounds: number;
+                readonly changeHash: boolean;
+                readonly container?: string | Window | HTMLElement | undefined;
+                readonly onChange?: ((link: string) => any) | undefined | undefined;
+                readonly onClick?: ((ev: MouseEvent, link?: string | undefined) => any) | undefined | undefined;
+            } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, "size" | "layout" | "targetOffset" | "bounds" | "changeHash">;
+            $attrs: import('vue').Attrs;
+            $refs: {
+                [x: string]: unknown;
+            } & {
+                anchorRef: HTMLDivElement;
+                anchorItemsRef: HTMLDivElement;
+            };
+            $slots: Readonly<{
+                [name: string]: import('vue').Slot<any> | undefined;
+            }>;
+            $root: import('vue').ComponentPublicInstance | null;
+            $parent: import('vue').ComponentPublicInstance | null;
+            $host: Element | null;
+            $emit: ((event: "change", link: string) => void) & ((event: "click", ev: MouseEvent, link?: string | undefined) => void);
+            $el: HTMLDivElement;
+            $options: import('vue').ComponentOptionsBase<Readonly<import('vue').ExtractPropTypes<{
+                layout: {
+                    type: import('vue').PropType<import('@opensig/opendesign').AnchorDirectionT>;
+                    default: string;
+                };
+                size: {
+                    type: import('vue').PropType<import('@opensig/opendesign').AnchorSizeT>;
+                    default: string;
+                };
+                container: {
+                    type: import('vue').PropType<string | HTMLElement | Window>;
+                };
+                bounds: {
+                    type: NumberConstructor;
+                    default: number;
+                };
+                targetOffset: {
+                    type: NumberConstructor;
+                    default: number;
+                };
+                changeHash: {
+                    type: BooleanConstructor;
+                    default: boolean;
+                };
+            }>> & Readonly<{
+                onChange?: ((link: string) => any) | undefined;
+                onClick?: ((ev: MouseEvent, link?: string | undefined) => any) | undefined;
+            }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+                change: (link: string) => any;
+                click: (ev: MouseEvent, link?: string | undefined) => any;
+            }, string, {
+                size: "medium" | "small" | "menu";
+                layout: "h" | "v";
+                bounds: number;
+                targetOffset: number;
+                changeHash: boolean;
+            }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
+                beforeCreate?: (() => void) | (() => void)[];
+                created?: (() => void) | (() => void)[];
+                beforeMount?: (() => void) | (() => void)[];
+                mounted?: (() => void) | (() => void)[];
+                beforeUpdate?: (() => void) | (() => void)[];
+                updated?: (() => void) | (() => void)[];
+                activated?: (() => void) | (() => void)[];
+                deactivated?: (() => void) | (() => void)[];
+                beforeDestroy?: (() => void) | (() => void)[];
+                beforeUnmount?: (() => void) | (() => void)[];
+                destroyed?: (() => void) | (() => void)[];
+                unmounted?: (() => void) | (() => void)[];
+                renderTracked?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+                renderTriggered?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+                errorCaptured?: ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void)[];
+            };
+            $forceUpdate: () => void;
+            $nextTick: typeof import('vue').nextTick;
+            $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
+        } & Readonly<{
+            size: "medium" | "small" | "menu";
+            layout: "h" | "v";
+            bounds: number;
+            targetOffset: number;
+            changeHash: boolean;
+        }> & Omit<Readonly<import('vue').ExtractPropTypes<{
+            layout: {
+                type: import('vue').PropType<import('@opensig/opendesign').AnchorDirectionT>;
+                default: string;
+            };
+            size: {
+                type: import('vue').PropType<import('@opensig/opendesign').AnchorSizeT>;
+                default: string;
+            };
+            container: {
+                type: import('vue').PropType<string | HTMLElement | Window>;
+            };
+            bounds: {
+                type: NumberConstructor;
+                default: number;
+            };
+            targetOffset: {
+                type: NumberConstructor;
+                default: number;
+            };
+            changeHash: {
+                type: BooleanConstructor;
+                default: boolean;
+            };
+        }>> & Readonly<{
+            onChange?: ((link: string) => any) | undefined;
+            onClick?: ((ev: MouseEvent, link?: string | undefined) => any) | undefined;
+        }>, "size" | "layout" | "targetOffset" | "bounds" | "changeHash"> & {} & import('vue').ComponentCustomProperties & {} & {
+            $slots: {
+                default?(_: {}): any;
+            };
+        }) | null;
     }, any, import('vue').ComponentProvideOptions, {
         P: {};
         B: {};
@@ -23,34 +160,49 @@ declare const OArticleAnchor: {
         C: {};
         M: {};
         Defaults: {};
-    }, Readonly<import('../../index').ArticleAnchorPropsT> & Readonly<{}>, {
+    }, Readonly<import('../../index').ArticleAnchorPropsT> & Readonly<{
+        onChange?: ((link: string) => any) | undefined;
+        onClick?: ((ev: MouseEvent, link?: string | undefined) => any) | undefined;
+    }>, {
         collect: () => void;
         items: import('vue').ComputedRef<import('../../index').ArticleAnchorItemT[]>;
     }, {}, {}, {}, {
         size: "pc" | "pad" | "mobile";
         items: import('../../index').ArticleAnchorItemT[];
+        bounds: number;
+        changeHash: boolean;
         radius: string;
         showTitle: boolean;
         selector: string | HTMLElement;
         autoExtract: boolean;
         maxLevel: number;
         writeId: boolean;
+        idPrefix: string;
     }>;
     __isFragment?: never;
     __isTeleport?: never;
     __isSuspense?: never;
-} & import('vue').ComponentOptionsBase<Readonly<import('../../index').ArticleAnchorPropsT> & Readonly<{}>, {
+} & import('vue').ComponentOptionsBase<Readonly<import('../../index').ArticleAnchorPropsT> & Readonly<{
+    onChange?: ((link: string) => any) | undefined;
+    onClick?: ((ev: MouseEvent, link?: string | undefined) => any) | undefined;
+}>, {
     collect: () => void;
     items: import('vue').ComputedRef<import('../../index').ArticleAnchorItemT[]>;
-}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    change: (link: string) => any;
+    click: (ev: MouseEvent, link?: string | undefined) => any;
+}, string, {
     size: "pc" | "pad" | "mobile";
     items: import('../../index').ArticleAnchorItemT[];
+    bounds: number;
+    changeHash: boolean;
     radius: string;
     showTitle: boolean;
     selector: string | HTMLElement;
     autoExtract: boolean;
     maxLevel: number;
     writeId: boolean;
+    idPrefix: string;
 }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & {
     install(app: App): void;
 };

package/dist/treeshaking/components/article-anchor/types.d.ts

@@ -1,8 +1,10 @@
 export interface ArticleAnchorItemT {
-    /** 锚点 id（不含 #），对应页面元素 id */
-    id: string;
+    /** 锚点链接（含 # 前缀），如 '#manual-a'，对应页面元素 id */
+    href: string;
     /** 展示标题 */
     title: string;
+    /** 透传 OAnchorItem：锚点监听的目标元素（含 # 前缀），不传时监听 href */
+    observeHref?: string;
     /** 子锚点（嵌套渲染缩进） */
     children?: ArticleAnchorItemT[];
 }
@@ -23,10 +25,16 @@ export interface ArticleAnchorPropsT {
     maxLevel?: number;
     /** 无 id 标题自动生成 slug 并回写到元素 id（保证锚点可用），默认 true */
     writeId?: boolean;
+    /** 自动收集时，元素 id 若以该前缀开头（如 'user-content-'），则 item.href 去掉前缀展示（#a），observeHref 指向完整 id（#user-content-a）；默认 '' 不处理 */
+    idPrefix?: string;
     /** 透传 OAnchor：滚动容器，默认 window */
     container?: string | HTMLElement | Window;
     /** 透传 OAnchor：滚动偏移量 */
     targetOffset?: number;
+    /** 透传 OAnchor：锚点激活的边界范围，默认 5 */
+    bounds?: number;
+    /** 透传 OAnchor：点击锚点时是否改变地址栏 hash，默认 true */
+    changeHash?: boolean;
     /** 卡片圆角 */
     radius?: string;
 }

package/dist/treeshaking/components/article-pagination/OArticlePagination.mjs

@@ -1,6 +1,6 @@
 import _plugin_vue_export_helper_default from "../../_virtual/_plugin-vue_export-helper.mjs";
 import OArticlePagination_vue_vue_type_script_setup_true_lang_default from "./OArticlePagination.vue_vue_type_script_setup_true_lang.mjs";
-import './OArticlePagination.vue_vue_type_style_index_0_scoped_e78e8bd3_lang.css';
+import './OArticlePagination.vue_vue_type_style_index_0_scoped_8a8cf9f8_lang.css';
 // src/components/article-pagination/OArticlePagination.vue
-var OArticlePagination_default = /*#__PURE__*/ _plugin_vue_export_helper_default(OArticlePagination_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-e78e8bd3"]]);
+var OArticlePagination_default = /*#__PURE__*/ _plugin_vue_export_helper_default(OArticlePagination_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-8a8cf9f8"]]);
 export { OArticlePagination_default as default };