@feugene/granularity 0.43.0 → 0.44.0

package/dist/components/GrScrollSpy/chunks/GrScrollSpy-CQCH3zLC.js

@@ -0,0 +1,207 @@
+import { n as useGranularityTranslations } from "../../../chunks/granularityI18n-BC5zsj_d.js";
+import { t as useScrollSpy } from "../../../chunks/useScrollSpy-CIJpw0RI.js";
+import { a as scrollSpyRootClass, i as scrollSpyListClass, r as grScrollSpyItemClass } from "../../../chunks/config-BkQ2jvXv.js";
+import { Fragment, computed, createCommentVNode, createElementBlock, createElementVNode, defineComponent, normalizeClass, normalizeStyle, openBlock, ref, renderList, renderSlot, toDisplayString, unref, watchEffect } from "vue";
+//#region src/components/GrScrollSpy/scrollSpyItems.ts
+/**
+* Значение пропа `offset` в CSS-длину для инлайновой переменной.
+*
+* Строка уходит как есть и намеренно не валидируется: `4rem`,
+* `var(--gr-navbar-height)`, `calc(…)` обязаны работать — иначе проп проигрывает
+* голому `style`. Отрицательное зажимается в ноль: линия активации выше верха
+* скроллпорта смысла не имеет.
+*/
+function scrollSpyOffsetLength(value) {
+	if (value == null) return void 0;
+	if (typeof value === "number") {
+		if (!Number.isFinite(value)) return void 0;
+		return `${Math.max(0, value)}px`;
+	}
+	const trimmed = value.trim();
+	return trimmed === "" ? void 0 : trimmed;
+}
+/**
+* Наш ли это клик.
+*
+* Пункт остаётся `<a href="#id">` ровно ради того, что браузер умеет с ссылкой
+* сам: `Cmd`-клик открывает в новой вкладке, средняя кнопка — тоже. Перехватив
+* их, компонент отнял бы у пользователя работающее поведение и ничего не дал
+* взамен.
+*/
+function anchorClickHandled(event) {
+	if (event.defaultPrevented || event.button !== 0) return false;
+	return !(event.metaKey || event.ctrlKey || event.shiftKey || event.altKey);
+}
+/**
+* Предки активного пункта — те разделы выше по списку, чей уровень мельче.
+*
+* Считается по документному порядку массива, а не по дереву: дерево позволило
+* бы объявить вложенность, противоречащую порядку разделов на странице.
+*/
+function ancestorSectionIds(sections, activeId) {
+	const ancestors = /* @__PURE__ */ new Set();
+	if (activeId === null) return ancestors;
+	const index = sections.findIndex((section) => section.id === activeId);
+	if (index < 0) return ancestors;
+	let level = sections[index].level ?? 1;
+	for (let cursor = index - 1; cursor >= 0; cursor -= 1) {
+		const candidate = sections[cursor].level ?? 1;
+		if (candidate < level) {
+			ancestors.add(sections[cursor].id);
+			level = candidate;
+		}
+	}
+	return ancestors;
+}
+//#endregion
+//#region src/components/GrScrollSpy/GrScrollSpy.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = ["aria-label"];
+var _hoisted_2 = ["aria-level", "data-level"];
+var _hoisted_3 = [
+	"href",
+	"data-active",
+	"data-ancestor",
+	"aria-current",
+	"onClick"
+];
+//#endregion
+//#region src/components/GrScrollSpy/GrScrollSpy.vue
+var GrScrollSpy_default = /* @__PURE__ */ defineComponent({
+	__name: "GrScrollSpy",
+	props: {
+		sections: {},
+		offset: { default: void 0 },
+		scroller: { default: void 0 },
+		ariaLabel: { default: void 0 },
+		updateHash: {
+			type: Boolean,
+			default: true
+		},
+		behavior: { default: void 0 },
+		focusTarget: {
+			type: Boolean,
+			default: true
+		},
+		disabled: {
+			type: Boolean,
+			default: false
+		}
+	},
+	emits: ["activeChange", "select"],
+	setup(__props, { expose: __expose, emit: __emit }) {
+		const props = __props;
+		const emit = __emit;
+		const { t } = useGranularityTranslations();
+		const rootEl = ref(null);
+		const label = computed(() => props.ariaLabel ?? t("gr.scrollSpy.label", "On this page"));
+		const rootStyle = computed(() => {
+			const length = scrollSpyOffsetLength(props.offset);
+			return length === void 0 ? void 0 : { "--gr-scroll-spy-offset": length };
+		});
+		/**
+		* Отступ берётся из вычисленного стиля, а не из пропа: браузер уже разрешил
+		* `4rem`, `var(...)` и `calc(...)` в used value, и свой парсер CSS не нужен.
+		* Заодно работает отступ, заданный каскадом, — а он и есть общий дефолт группы.
+		*
+		* Носитель — `scroll-margin-top` на корне: вычисленное значение этого свойства
+		* всегда абсолютная длина, а на само оглавление оно влияет ровно там, где нужно,
+		* и в ту же сторону — отодвигает его от края при переходе по якорю.
+		*/
+		function measureOffsetPx() {
+			const el = rootEl.value;
+			if (!el || typeof getComputedStyle !== "function") return 0;
+			const parsed = Number.parseFloat(getComputedStyle(el).scrollMarginTop);
+			return Number.isFinite(parsed) ? Math.max(0, parsed) : 0;
+		}
+		function resolveScroller() {
+			const value = props.scroller;
+			if (typeof value === "string") return typeof document === "undefined" ? null : document.querySelector(value);
+			return value ?? null;
+		}
+		const spy = useScrollSpy({
+			sections: () => Array.isArray(props.sections) ? props.sections.map((section) => section.id) : [],
+			scroller: resolveScroller,
+			offset: measureOffsetPx,
+			disabled: () => props.disabled,
+			onChange: (id) => emit("activeChange", id)
+		});
+		const ancestors = computed(() => ancestorSectionIds(props.sections ?? [], spy.active.value));
+		function itemState(id) {
+			if (spy.active.value === id) return "active";
+			return ancestors.value.has(id) ? "ancestor" : "idle";
+		}
+		/**
+		* `preventDefault()` отнимает у ссылки то, что браузер делает сам при переходе
+		* по якорю, — перенос точки последовательной навигации. Без компенсации
+		* клавиатурный пользователь после активации пункта продолжает `Tab` внутри
+		* оглавления, а не с начала раздела.
+		*
+		* `preventScroll` обязателен: иначе фокус телепортирует прокрутку и подерётся с
+		* плавной. Временный `tabindex` снимается по `blur` — чужой DOM остаётся чужим.
+		*/
+		function focusSection(id) {
+			const el = typeof document === "undefined" ? null : document.getElementById(id);
+			if (!el) return;
+			if (!el.hasAttribute("tabindex")) {
+				el.setAttribute("tabindex", "-1");
+				el.addEventListener("blur", () => el.removeAttribute("tabindex"), { once: true });
+			}
+			el.focus({ preventScroll: true });
+		}
+		function activate(id, event) {
+			spy.scrollTo(id, props.behavior === void 0 ? void 0 : { behavior: props.behavior });
+			if (props.updateHash && typeof history !== "undefined") history.replaceState(null, "", `#${id}`);
+			if (props.focusTarget) focusSection(id);
+			if (event) emit("select", id, event);
+		}
+		function onItemClick(id, event) {
+			if (!anchorClickHandled(event)) return;
+			event.preventDefault();
+			activate(id, event);
+		}
+		__expose({
+			active: spy.active,
+			scrollTo: spy.scrollTo,
+			refresh: spy.refresh
+		});
+		if (process.env.NODE_ENV !== "production") watchEffect(() => {
+			if (!Array.isArray(props.sections)) console.warn(`[granularity] GrScrollSpy: обязательный проп \`sections\` должен быть массивом — получено ${String(props.sections)}.`);
+		});
+		return (_ctx, _cache) => {
+			return Array.isArray(__props.sections) && __props.sections.length > 0 ? (openBlock(), createElementBlock("nav", {
+				key: 0,
+				ref_key: "rootEl",
+				ref: rootEl,
+				"data-gr-scroll-spy": "",
+				"aria-label": label.value,
+				class: normalizeClass(unref(scrollSpyRootClass)),
+				style: normalizeStyle(rootStyle.value)
+			}, [createElementVNode("ul", {
+				role: "list",
+				class: normalizeClass(unref(scrollSpyListClass))
+			}, [(openBlock(true), createElementBlock(Fragment, null, renderList(__props.sections, (section) => {
+				return openBlock(), createElementBlock("li", {
+					key: section.id,
+					"aria-level": section.level ?? 1,
+					"data-level": section.level ?? 1,
+					style: normalizeStyle({ paddingInlineStart: `calc(var(--gr-scroll-spy-indent, 0.75rem) * ${(section.level ?? 1) - 1})` })
+				}, [renderSlot(_ctx.$slots, "item", {
+					section,
+					active: unref(spy).active.value === section.id,
+					ancestor: ancestors.value.has(section.id),
+					activate: () => activate(section.id)
+				}, () => [createElementVNode("a", {
+					href: `#${section.id}`,
+					"data-gr-scroll-spy-item": "",
+					"data-active": unref(spy).active.value === section.id ? "true" : void 0,
+					"data-ancestor": ancestors.value.has(section.id) ? "true" : void 0,
+					"aria-current": unref(spy).active.value === section.id ? "location" : void 0,
+					class: normalizeClass(unref(grScrollSpyItemClass)(itemState(section.id))),
+					onClick: ($event) => onItemClick(section.id, $event)
+				}, toDisplayString(section.label), 11, _hoisted_3)])], 12, _hoisted_2);
+			}), 128))], 2)], 14, _hoisted_1)) : createCommentVNode("", true);
+		};
+	}
+});
+//#endregion
+export { GrScrollSpy_default as t };

package/dist/components/GrScrollSpy/chunks/GrScrollSpy-CQCH3zLC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GrScrollSpy-CQCH3zLC.js","names":[],"sources":["../../../../src/components/GrScrollSpy/scrollSpyItems.ts","../../../../src/components/GrScrollSpy/GrScrollSpy.vue","../../../../src/components/GrScrollSpy/GrScrollSpy.vue"],"sourcesContent":["/**\n * Арифметика пунктов оглавления: всё, что следует из того, что пункт —\n * **ссылка**, а не из положения прокрутки. Положение живёт в\n * `composables/internal/scrollSpyGeometry.ts`.\n */\n\n/** Раздел в оглавлении. */\nexport interface GrScrollSpySection {\n  id: string\n  label: string\n  /** Уровень вложенности, 1 — верхний. Влияет на отступ и цепочку предков. */\n  level?: number\n}\n\n/**\n * Значение пропа `offset` в CSS-длину для инлайновой переменной.\n *\n * Строка уходит как есть и намеренно не валидируется: `4rem`,\n * `var(--gr-navbar-height)`, `calc(…)` обязаны работать — иначе проп проигрывает\n * голому `style`. Отрицательное зажимается в ноль: линия активации выше верха\n * скроллпорта смысла не имеет.\n */\nexport function scrollSpyOffsetLength(value: number | string | undefined): string | undefined {\n  if (value == null)\n    return undefined\n\n  if (typeof value === 'number') {\n    if (!Number.isFinite(value))\n      return undefined\n\n    // Число выносится в переменную, чтобы литерал остался одним токеном: гейт\n    // safelist разбирает шаблонные строки по пробелам и обломок вида `value)}px`\n    // принимает за утилиту UnoCSS — которой он, по совпадению, и оказывается.\n    const px = Math.max(0, value)\n\n    return `${px}px`\n  }\n\n  const trimmed = value.trim()\n\n  return trimmed === '' ? undefined : trimmed\n}\n\n/**\n * Наш ли это клик.\n *\n * Пункт остаётся `<a href=\"#id\">` ровно ради того, что браузер умеет с ссылкой\n * сам: `Cmd`-клик открывает в новой вкладке, средняя кнопка — тоже. Перехватив\n * их, компонент отнял бы у пользователя работающее поведение и ничего не дал\n * взамен.\n */\nexport function anchorClickHandled(event: {\n  button: number\n  metaKey: boolean\n  ctrlKey: boolean\n  shiftKey: boolean\n  altKey: boolean\n  defaultPrevented: boolean\n}): boolean {\n  if (event.defaultPrevented || event.button !== 0)\n    return false\n\n  return !(event.metaKey || event.ctrlKey || event.shiftKey || event.altKey)\n}\n\n/**\n * Предки активного пункта — те разделы выше по списку, чей уровень мельче.\n *\n * Считается по документному порядку массива, а не по дереву: дерево позволило\n * бы объявить вложенность, противоречащую порядку разделов на странице.\n */\nexport function ancestorSectionIds(\n  sections: readonly GrScrollSpySection[],\n  activeId: string | null,\n): Set<string> {\n  const ancestors = new Set<string>()\n\n  if (activeId === null)\n    return ancestors\n\n  const index = sections.findIndex(section => section.id === activeId)\n\n  if (index < 0)\n    return ancestors\n\n  let level = sections[index].level ?? 1\n\n  for (let cursor = index - 1; cursor >= 0; cursor -= 1) {\n    const candidate = sections[cursor].level ?? 1\n\n    if (candidate < level) {\n      ancestors.add(sections[cursor].id)\n      level = candidate\n    }\n  }\n\n  return ancestors\n}\n","<script setup lang=\"ts\">\nimport { computed, ref, watchEffect } from 'vue'\n\nimport { useGranularityTranslations } from '../../internal/granularityI18n'\nimport { useScrollSpy } from '../../composables/useScrollSpy'\n\nimport type { GrScrollSpySection } from './scrollSpyItems'\nimport { anchorClickHandled, ancestorSectionIds, scrollSpyOffsetLength } from './scrollSpyItems'\nimport { grScrollSpyItemClass, scrollSpyListClass, scrollSpyRootClass } from './grScrollSpyStyles'\n\n/**\n * GrScrollSpy — оглавление длинной страницы, которое знает, до какого раздела\n * дочитали: активный пункт подсвечивается по прокрутке, клик по пункту ведёт к\n * разделу.\n *\n * Логика положения живёт в композабле `useScrollSpy` и доступна отдельно — этот\n * компонент добавляет к ней разметку, `aria-current` и всё, что следует из того,\n * что пункт является ссылкой.\n */\nexport interface GrScrollSpyProps {\n  /** Разделы в порядке их следования на странице. */\n  sections: GrScrollSpySection[]\n  /**\n   * Отступ линии активации от верха скроллпорта. Число — пиксели, строка — как\n   * есть. Почти всегда равен отступу липкой шапки (`--gr-affix-offset`).\n   */\n  offset?: number | string\n  /** Скроллпорт: элемент или селектор. Не задан — ищется от первого раздела. */\n  scroller?: HTMLElement | string | null\n  ariaLabel?: string\n  /** Обновлять `#hash` адреса при переходе. */\n  updateHash?: boolean\n  /** Плавность прокрутки. Под `prefers-reduced-motion` всегда мгновенная. */\n  behavior?: ScrollBehavior\n  /** Переносить фокус на раздел, как это делает переход по якорю. */\n  focusTarget?: boolean\n  disabled?: boolean\n}\n\nexport interface GrScrollSpyEmits {\n  (e: 'activeChange', id: string | null): void\n  (e: 'select', id: string, event: MouseEvent): void\n}\n\nconst props = withDefaults(defineProps<GrScrollSpyProps>(), {\n  offset: undefined,\n  scroller: undefined,\n  ariaLabel: undefined,\n  updateHash: true,\n  behavior: undefined,\n  focusTarget: true,\n  disabled: false,\n})\n\nconst emit = defineEmits<GrScrollSpyEmits>()\n\ndefineSlots<{\n  /** Пункт целиком. `activate` повторяет клик по нему. */\n  item?: (props: {\n    section: GrScrollSpySection\n    active: boolean\n    ancestor: boolean\n    activate: () => void\n  }) => unknown\n}>()\n\nconst { t } = useGranularityTranslations()\n\nconst rootEl = ref<HTMLElement | null>(null)\n\nconst label = computed(() => props.ariaLabel ?? t('gr.scrollSpy.label', 'On this page'))\n\nconst rootStyle = computed(() => {\n  const length = scrollSpyOffsetLength(props.offset)\n\n  return length === undefined ? undefined : { '--gr-scroll-spy-offset': length }\n})\n\n/**\n * Отступ берётся из вычисленного стиля, а не из пропа: браузер уже разрешил\n * `4rem`, `var(...)` и `calc(...)` в used value, и свой парсер CSS не нужен.\n * Заодно работает отступ, заданный каскадом, — а он и есть общий дефолт группы.\n *\n * Носитель — `scroll-margin-top` на корне: вычисленное значение этого свойства\n * всегда абсолютная длина, а на само оглавление оно влияет ровно там, где нужно,\n * и в ту же сторону — отодвигает его от края при переходе по якорю.\n */\nfunction measureOffsetPx(): number {\n  const el = rootEl.value\n\n  if (!el || typeof getComputedStyle !== 'function')\n    return 0\n\n  const parsed = Number.parseFloat(getComputedStyle(el).scrollMarginTop)\n\n  return Number.isFinite(parsed) ? Math.max(0, parsed) : 0\n}\n\nfunction resolveScroller(): HTMLElement | null {\n  const value = props.scroller\n\n  if (typeof value === 'string')\n    return typeof document === 'undefined' ? null : document.querySelector<HTMLElement>(value)\n\n  return value ?? null\n}\n\nconst spy = useScrollSpy({\n  sections: () => (Array.isArray(props.sections) ? props.sections.map(section => section.id) : []),\n  scroller: resolveScroller,\n  offset: measureOffsetPx,\n  disabled: () => props.disabled,\n  onChange: id => emit('activeChange', id),\n})\n\nconst ancestors = computed(() => ancestorSectionIds(props.sections ?? [], spy.active.value))\n\nfunction itemState(id: string): 'active' | 'ancestor' | 'idle' {\n  if (spy.active.value === id)\n    return 'active'\n\n  return ancestors.value.has(id) ? 'ancestor' : 'idle'\n}\n\n/**\n * `preventDefault()` отнимает у ссылки то, что браузер делает сам при переходе\n * по якорю, — перенос точки последовательной навигации. Без компенсации\n * клавиатурный пользователь после активации пункта продолжает `Tab` внутри\n * оглавления, а не с начала раздела.\n *\n * `preventScroll` обязателен: иначе фокус телепортирует прокрутку и подерётся с\n * плавной. Временный `tabindex` снимается по `blur` — чужой DOM остаётся чужим.\n */\nfunction focusSection(id: string): void {\n  const el = typeof document === 'undefined' ? null : document.getElementById(id)\n\n  if (!el)\n    return\n\n  if (!el.hasAttribute('tabindex')) {\n    el.setAttribute('tabindex', '-1')\n    el.addEventListener('blur', () => el.removeAttribute('tabindex'), { once: true })\n  }\n\n  el.focus({ preventScroll: true })\n}\n\nfunction activate(id: string, event?: MouseEvent): void {\n  spy.scrollTo(id, props.behavior === undefined ? undefined : { behavior: props.behavior })\n\n  if (props.updateHash && typeof history !== 'undefined') {\n    // `replaceState`, а не `pushState`: запись истории на каждый пункт\n    // превратила бы «Назад» в отмену прокрутки вместо возврата на страницу.\n    history.replaceState(null, '', `#${id}`)\n  }\n\n  if (props.focusTarget)\n    focusSection(id)\n\n  if (event)\n    emit('select', id, event)\n}\n\nfunction onItemClick(id: string, event: MouseEvent): void {\n  if (!anchorClickHandled(event))\n    return\n\n  event.preventDefault()\n  activate(id, event)\n}\n\ndefineExpose({\n  active: spy.active,\n  scrollTo: spy.scrollTo,\n  refresh: spy.refresh,\n})\n\nif (__GR_DEV__) {\n  watchEffect(() => {\n    if (!Array.isArray(props.sections)) {\n      console.warn(\n        `[granularity] GrScrollSpy: обязательный проп \\`sections\\` должен быть массивом — получено ${String(props.sections)}.`,\n      )\n    }\n  })\n}\n</script>\n\n<template>\n  <!--\n    Пустой список не рендерит ничего: пустой лендмарк `navigation` шумит в\n    списке ориентиров у диктора, не давая взамен ни одной цели.\n  -->\n  <nav\n    v-if=\"Array.isArray(sections) && sections.length > 0\"\n    ref=\"rootEl\"\n    data-gr-scroll-spy\n    :aria-label=\"label\"\n    :class=\"scrollSpyRootClass\"\n    :style=\"rootStyle\"\n  >\n    <!--\n      `role=\"list\"` обязателен: снятый `list-style` отнимает у списка роль в\n      WebKit, и оглавление перестаёт объявляться списком.\n    -->\n    <ul role=\"list\" :class=\"scrollSpyListClass\">\n      <li\n        v-for=\"section in sections\"\n        :key=\"section.id\"\n        :aria-level=\"section.level ?? 1\"\n        :data-level=\"section.level ?? 1\"\n        :style=\"{ paddingInlineStart: `calc(var(--gr-scroll-spy-indent, 0.75rem) * ${(section.level ?? 1) - 1})` }\"\n      >\n        <slot\n          name=\"item\"\n          :section=\"section\"\n          :active=\"spy.active.value === section.id\"\n          :ancestor=\"ancestors.has(section.id)\"\n          :activate=\"() => activate(section.id)\"\n        >\n          <a\n            :href=\"`#${section.id}`\"\n            data-gr-scroll-spy-item\n            :data-active=\"spy.active.value === section.id ? 'true' : undefined\"\n            :data-ancestor=\"ancestors.has(section.id) ? 'true' : undefined\"\n            :aria-current=\"spy.active.value === section.id ? 'location' : undefined\"\n            :class=\"grScrollSpyItemClass(itemState(section.id))\"\n            @click=\"onItemClick(section.id, $event)\"\n          >\n            {{ section.label }}\n          </a>\n        </slot>\n      </li>\n    </ul>\n  </nav>\n</template>\n","<script setup lang=\"ts\">\nimport { computed, ref, watchEffect } from 'vue'\n\nimport { useGranularityTranslations } from '../../internal/granularityI18n'\nimport { useScrollSpy } from '../../composables/useScrollSpy'\n\nimport type { GrScrollSpySection } from './scrollSpyItems'\nimport { anchorClickHandled, ancestorSectionIds, scrollSpyOffsetLength } from './scrollSpyItems'\nimport { grScrollSpyItemClass, scrollSpyListClass, scrollSpyRootClass } from './grScrollSpyStyles'\n\n/**\n * GrScrollSpy — оглавление длинной страницы, которое знает, до какого раздела\n * дочитали: активный пункт подсвечивается по прокрутке, клик по пункту ведёт к\n * разделу.\n *\n * Логика положения живёт в композабле `useScrollSpy` и доступна отдельно — этот\n * компонент добавляет к ней разметку, `aria-current` и всё, что следует из того,\n * что пункт является ссылкой.\n */\nexport interface GrScrollSpyProps {\n  /** Разделы в порядке их следования на странице. */\n  sections: GrScrollSpySection[]\n  /**\n   * Отступ линии активации от верха скроллпорта. Число — пиксели, строка — как\n   * есть. Почти всегда равен отступу липкой шапки (`--gr-affix-offset`).\n   */\n  offset?: number | string\n  /** Скроллпорт: элемент или селектор. Не задан — ищется от первого раздела. */\n  scroller?: HTMLElement | string | null\n  ariaLabel?: string\n  /** Обновлять `#hash` адреса при переходе. */\n  updateHash?: boolean\n  /** Плавность прокрутки. Под `prefers-reduced-motion` всегда мгновенная. */\n  behavior?: ScrollBehavior\n  /** Переносить фокус на раздел, как это делает переход по якорю. */\n  focusTarget?: boolean\n  disabled?: boolean\n}\n\nexport interface GrScrollSpyEmits {\n  (e: 'activeChange', id: string | null): void\n  (e: 'select', id: string, event: MouseEvent): void\n}\n\nconst props = withDefaults(defineProps<GrScrollSpyProps>(), {\n  offset: undefined,\n  scroller: undefined,\n  ariaLabel: undefined,\n  updateHash: true,\n  behavior: undefined,\n  focusTarget: true,\n  disabled: false,\n})\n\nconst emit = defineEmits<GrScrollSpyEmits>()\n\ndefineSlots<{\n  /** Пункт целиком. `activate` повторяет клик по нему. */\n  item?: (props: {\n    section: GrScrollSpySection\n    active: boolean\n    ancestor: boolean\n    activate: () => void\n  }) => unknown\n}>()\n\nconst { t } = useGranularityTranslations()\n\nconst rootEl = ref<HTMLElement | null>(null)\n\nconst label = computed(() => props.ariaLabel ?? t('gr.scrollSpy.label', 'On this page'))\n\nconst rootStyle = computed(() => {\n  const length = scrollSpyOffsetLength(props.offset)\n\n  return length === undefined ? undefined : { '--gr-scroll-spy-offset': length }\n})\n\n/**\n * Отступ берётся из вычисленного стиля, а не из пропа: браузер уже разрешил\n * `4rem`, `var(...)` и `calc(...)` в used value, и свой парсер CSS не нужен.\n * Заодно работает отступ, заданный каскадом, — а он и есть общий дефолт группы.\n *\n * Носитель — `scroll-margin-top` на корне: вычисленное значение этого свойства\n * всегда абсолютная длина, а на само оглавление оно влияет ровно там, где нужно,\n * и в ту же сторону — отодвигает его от края при переходе по якорю.\n */\nfunction measureOffsetPx(): number {\n  const el = rootEl.value\n\n  if (!el || typeof getComputedStyle !== 'function')\n    return 0\n\n  const parsed = Number.parseFloat(getComputedStyle(el).scrollMarginTop)\n\n  return Number.isFinite(parsed) ? Math.max(0, parsed) : 0\n}\n\nfunction resolveScroller(): HTMLElement | null {\n  const value = props.scroller\n\n  if (typeof value === 'string')\n    return typeof document === 'undefined' ? null : document.querySelector<HTMLElement>(value)\n\n  return value ?? null\n}\n\nconst spy = useScrollSpy({\n  sections: () => (Array.isArray(props.sections) ? props.sections.map(section => section.id) : []),\n  scroller: resolveScroller,\n  offset: measureOffsetPx,\n  disabled: () => props.disabled,\n  onChange: id => emit('activeChange', id),\n})\n\nconst ancestors = computed(() => ancestorSectionIds(props.sections ?? [], spy.active.value))\n\nfunction itemState(id: string): 'active' | 'ancestor' | 'idle' {\n  if (spy.active.value === id)\n    return 'active'\n\n  return ancestors.value.has(id) ? 'ancestor' : 'idle'\n}\n\n/**\n * `preventDefault()` отнимает у ссылки то, что браузер делает сам при переходе\n * по якорю, — перенос точки последовательной навигации. Без компенсации\n * клавиатурный пользователь после активации пункта продолжает `Tab` внутри\n * оглавления, а не с начала раздела.\n *\n * `preventScroll` обязателен: иначе фокус телепортирует прокрутку и подерётся с\n * плавной. Временный `tabindex` снимается по `blur` — чужой DOM остаётся чужим.\n */\nfunction focusSection(id: string): void {\n  const el = typeof document === 'undefined' ? null : document.getElementById(id)\n\n  if (!el)\n    return\n\n  if (!el.hasAttribute('tabindex')) {\n    el.setAttribute('tabindex', '-1')\n    el.addEventListener('blur', () => el.removeAttribute('tabindex'), { once: true })\n  }\n\n  el.focus({ preventScroll: true })\n}\n\nfunction activate(id: string, event?: MouseEvent): void {\n  spy.scrollTo(id, props.behavior === undefined ? undefined : { behavior: props.behavior })\n\n  if (props.updateHash && typeof history !== 'undefined') {\n    // `replaceState`, а не `pushState`: запись истории на каждый пункт\n    // превратила бы «Назад» в отмену прокрутки вместо возврата на страницу.\n    history.replaceState(null, '', `#${id}`)\n  }\n\n  if (props.focusTarget)\n    focusSection(id)\n\n  if (event)\n    emit('select', id, event)\n}\n\nfunction onItemClick(id: string, event: MouseEvent): void {\n  if (!anchorClickHandled(event))\n    return\n\n  event.preventDefault()\n  activate(id, event)\n}\n\ndefineExpose({\n  active: spy.active,\n  scrollTo: spy.scrollTo,\n  refresh: spy.refresh,\n})\n\nif (__GR_DEV__) {\n  watchEffect(() => {\n    if (!Array.isArray(props.sections)) {\n      console.warn(\n        `[granularity] GrScrollSpy: обязательный проп \\`sections\\` должен быть массивом — получено ${String(props.sections)}.`,\n      )\n    }\n  })\n}\n</script>\n\n<template>\n  <!--\n    Пустой список не рендерит ничего: пустой лендмарк `navigation` шумит в\n    списке ориентиров у диктора, не давая взамен ни одной цели.\n  -->\n  <nav\n    v-if=\"Array.isArray(sections) && sections.length > 0\"\n    ref=\"rootEl\"\n    data-gr-scroll-spy\n    :aria-label=\"label\"\n    :class=\"scrollSpyRootClass\"\n    :style=\"rootStyle\"\n  >\n    <!--\n      `role=\"list\"` обязателен: снятый `list-style` отнимает у списка роль в\n      WebKit, и оглавление перестаёт объявляться списком.\n    -->\n    <ul role=\"list\" :class=\"scrollSpyListClass\">\n      <li\n        v-for=\"section in sections\"\n        :key=\"section.id\"\n        :aria-level=\"section.level ?? 1\"\n        :data-level=\"section.level ?? 1\"\n        :style=\"{ paddingInlineStart: `calc(var(--gr-scroll-spy-indent, 0.75rem) * ${(section.level ?? 1) - 1})` }\"\n      >\n        <slot\n          name=\"item\"\n          :section=\"section\"\n          :active=\"spy.active.value === section.id\"\n          :ancestor=\"ancestors.has(section.id)\"\n          :activate=\"() => activate(section.id)\"\n        >\n          <a\n            :href=\"`#${section.id}`\"\n            data-gr-scroll-spy-item\n            :data-active=\"spy.active.value === section.id ? 'true' : undefined\"\n            :data-ancestor=\"ancestors.has(section.id) ? 'true' : undefined\"\n            :aria-current=\"spy.active.value === section.id ? 'location' : undefined\"\n            :class=\"grScrollSpyItemClass(itemState(section.id))\"\n            @click=\"onItemClick(section.id, $event)\"\n          >\n            {{ section.label }}\n          </a>\n        </slot>\n      </li>\n    </ul>\n  </nav>\n</template>\n"],"mappings":"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"}

package/dist/components/GrScrollSpy/index.js

@@ -0,0 +1,3 @@
+import { t as GrScrollSpy_default } from "./chunks/GrScrollSpy-CQCH3zLC.js";
+import { n as grScrollSpySafelist, t as grScrollSpyConfig } from "../../chunks/config-BkQ2jvXv.js";
+export { GrScrollSpy_default as GrScrollSpy, GrScrollSpy_default as default, grScrollSpyConfig, grScrollSpySafelist };

package/dist/composables/useScrollSpy.js

@@ -0,0 +1,2 @@
+import { t as useScrollSpy } from "../chunks/useScrollSpy-CIJpw0RI.js";
+export { useScrollSpy };

package/dist/granular-provider-node.js

@@ -1,2 +1,2 @@
-import { a as granularityDefaultThemes, i as granularityComponentConfigs, n as GRANULARITY_PROVIDER_ID, o as granularityThemeNames, r as createGranularityProvider, t as granularityProvider } from "./chunks/granular-provider-BohXQcNt.js";
+import { a as granularityDefaultThemes, i as granularityComponentConfigs, n as GRANULARITY_PROVIDER_ID, o as granularityThemeNames, r as createGranularityProvider, t as granularityProvider } from "./chunks/granular-provider-CCNbQa5U.js";
 export { GRANULARITY_PROVIDER_ID, createGranularityProvider, granularityProvider as default, granularityProvider, granularityComponentConfigs, granularityDefaultThemes, granularityThemeNames };

package/dist/granular-provider.js

@@ -1,2 +1,2 @@
-import { a as granularityDefaultThemes, i as granularityComponentConfigs, n as GRANULARITY_PROVIDER_ID, o as granularityThemeNames, r as createGranularityProvider, t as granularityProvider } from "./chunks/granular-provider-BohXQcNt.js";
+import { a as granularityDefaultThemes, i as granularityComponentConfigs, n as GRANULARITY_PROVIDER_ID, o as granularityThemeNames, r as createGranularityProvider, t as granularityProvider } from "./chunks/granular-provider-CCNbQa5U.js";
 export { GRANULARITY_PROVIDER_ID, createGranularityProvider, granularityProvider as default, granularityProvider, granularityComponentConfigs, granularityDefaultThemes, granularityThemeNames };

package/dist/i18n/all.js

@@ -1,4 +1,4 @@
-import { n as ru, r as en, t as es } from "../chunks/es-B4t_3Wnh.js";
+import { n as ru, r as en, t as es } from "../chunks/es-CeKkMxZ_.js";
 //#region src/i18n/all.ts
 var all = [
 	en,

package/dist/i18n/index.js

@@ -1,3 +1,3 @@
 import { t as GRANULARITY_I18N_KEY } from "../chunks/adapter-CAOxmn2G.js";
-import { i as GRANULARITY_I18N_BLOCK, n as ru, r as en, t as es } from "../chunks/es-B4t_3Wnh.js";
+import { i as GRANULARITY_I18N_BLOCK, n as ru, r as en, t as es } from "../chunks/es-CeKkMxZ_.js";
 export { GRANULARITY_I18N_BLOCK, GRANULARITY_I18N_KEY, en, es, ru };

package/dist/index.js

@@ -168,6 +168,9 @@ import { t as grRadioGroupConfig } from "./chunks/config-QaIc_gRa.js";
 import { n as grRatingSafelist, t as grRatingConfig } from "./chunks/config-DRbojEzO.js";
 import { t as GrRating_default } from "./components/GrRating/chunks/GrRating-DTriyyqG.js";
 import { n as GrFormErrorBanner_default, r as GrUploadErrorBanner_default, t as useResponseError } from "./components/GrResponseErrorBanner/chunks/GrResponseErrorBanner-ZvBvEQDZ.js";
+import { t as useScrollSpy } from "./chunks/useScrollSpy-CIJpw0RI.js";
+import { t as GrScrollSpy_default } from "./components/GrScrollSpy/chunks/GrScrollSpy-CQCH3zLC.js";
+import { n as grScrollSpySafelist, t as grScrollSpyConfig } from "./chunks/config-BkQ2jvXv.js";
 import { n as titleWhenTruncated, t as GrSegmented_default } from "./components/GrSegmented/chunks/GrSegmented-CuDaKA6S.js";
 import { n as grSegmentedSafelist, t as grSegmentedConfig } from "./chunks/config-rLkc9Zn2.js";
 import { n as grSelectSafelist, t as grSelectConfig } from "./chunks/config--t2dxj0t.js";
@@ -211,4 +214,4 @@ import { t as GrTreeSelect_default } from "./components/GrTreeSelect/chunks/GrTr
 import "./composables/useGrComponentConfig.js";
 import "./composables/useGranularityTranslations.js";
 import { GRANULARITY_THEME_STATE, granularityThemePlugin, initThemeEarly, useTheme } from "./composables/useTheme.js";
-export { FileValidationError, GRANULARITY_THEME_STATE, GRANULARITY_TOAST_STATE, GR_KBD_TOKENS, GR_TONES, GrAffix_default as GrAffix, GrAlert_default as GrAlert, GrAutocomplete_default as GrAutocomplete, GrAvatar_default as GrAvatar, GrAvatarGroup_default as GrAvatarGroup, GrBadge_default as GrBadge, GrBadgeWrap_default as GrBadgeWrap, GrBottomNav_default as GrBottomNav, GrBreadcrumbs_default as GrBreadcrumbs, GrButton_default as GrButton, GrButtonGroup_default as GrButtonGroup, GrCard_default as GrCard, GrCarousel_default as GrCarousel, GrCarouselSlide_default as GrCarouselSlide, GrCheckbox_default as GrCheckbox, GrCheckboxGroup_default as GrCheckboxGroup, GrChip_default as GrChip, GrChipGroup_default as GrChipGroup, GrCollapse_default as GrCollapse, GrCollapseItem_default as GrCollapseItem, GrColorPicker_default as GrColorPicker, GrCommandPalette_default as GrCommandPalette, GrConfigProvider_default as GrConfigProvider, GrConfirmDialog_default as GrConfirmDialog, GrContextMenu_default as GrContextMenu, GrDataTable_default as GrDataTable, GrDelta_default as GrDelta, GrDescriptionList_default as GrDescriptionList, GrDialog_default as GrDialog, GrDialogCloseButton_default as GrDialogCloseButton, GrDialogFooter_default as GrDialogFooter, GrDialogHeader_default as GrDialogHeader, GrDialogServiceHost_default as GrDialogServiceHost, GrDivider_default as GrDivider, GrDrawer_default as GrDrawer, GrDropdown_default as GrDropdown, GrDropdownMenu_default as GrDropdownMenu, GrDropdownMenuColumn_default as GrDropdownMenuColumn, GrDropdownMenuColumns_default as GrDropdownMenuColumns, GrDropdownMenuDivider_default as GrDropdownMenuDivider, GrDropdownMenuGroup_default as GrDropdownMenuGroup, GrDropdownMenuHeader_default as GrDropdownMenuHeader, GrDropdownMenuItem_default as GrDropdownMenuItem, GrDropdownMenuList_default as GrDropdownMenuList, GrEmptyState_default as GrEmptyState, GrFilePreview_default as GrFilePreview, GrFileUpload_default as GrFileUpload, GrForm_default as GrForm, GrFormErrorBanner_default as GrFormErrorBanner, GrFormField_default as GrFormField, GrFormFile_default as GrFormFile, GrFormSection_default as GrFormSection, GrIcon_default as GrIcon, GrImageViewer_default as GrImageViewer, GrInput_default as GrInput, GrInputTag_default as GrInputTag, GrJsonViewer_default as GrJsonViewer, GrKbd_default as GrKbd, GrLink_default as GrLink, GrList_default as GrList, GrListItem_default as GrListItem, GrLoading_default as GrLoading, GrModal_default as GrModal, GrNavbar_default as GrNavbar, GrNumberInput_default as GrNumberInput, GrPagination_default as GrPagination, GrPopover_default as GrPopover, GrProgressBar_default as GrProgressBar, GrProgressCircle_default as GrProgressCircle, GrPromptDialog_default as GrPromptDialog, GrRadio_default as GrRadio, GrRadioGroup_default as GrRadioGroup, GrRating_default as GrRating, GrResponseErrorBanner_default as GrResponseErrorBanner, GrSegmented_default as GrSegmented, GrSelect_default as GrSelect, GrSidebar_default as GrSidebar, GrSidebarGroup_default as GrSidebarGroup, GrSidebarItem_default as GrSidebarItem, GrSkeleton_default as GrSkeleton, GrSlider_default as GrSlider, GrSortableList_default as GrSortableList, GrSplitter_default as GrSplitter, GrStatistic_default as GrStatistic, GrSteps_default as GrSteps, GrSwitch_default as GrSwitch, GrTabPanel_default as GrTabPanel, GrTabPanels_default as GrTabPanels, GrTable_default as GrTable, GrTabs_default as GrTabs, GrTextarea_default as GrTextarea, GrTimeline_default as GrTimeline, GrTimelineItem_default as GrTimelineItem, GrToaster_default as GrToaster, GrTooltip_default as GrTooltip, GrTransfer_default as GrTransfer, GrTree_default as GrTree, GrTreeSelect_default as GrTreeSelect, GrUploadAbortError, GrUploadErrorBanner_default as GrUploadErrorBanner, GrUploadHttpError, GrValue_default as GrValue, coreResponseErrorParsers, createGrFormMessageResolver, createLoading, createResponseErrorClassifier, deltaDirection, deltaTone, dialogService, extendDefaultParsers, fileKindOf, findKbdToken, formatBadgeValue, formatStatisticValue, getByPath, grAffixConfig, grAffixSafelist, grAlertConfig, grAutocompleteConfig, grAutocompleteSafelist, grAvatarConfig, grAvatarSafelist, grBadgeConfig, grBadgeSafelist, grBadgeWrapConfig, grBadgeWrapSafelist, grBottomNavConfig, grBottomNavSafelist, grBreadcrumbsConfig, grBreadcrumbsSafelist, grButtonConfig, grButtonGroupConfig, grButtonSafelist, grCardConfig, grCardSafelist, grCarouselConfig, grCarouselSafelist, grCheckboxConfig, grCheckboxGroupConfig, grCheckboxSafelist, grChipConfig, grChipGroupConfig, grChipGroupSafelist, grChipSafelist, grCollapseConfig, grCollapseSafelist, grColorPickerConfig, grColorPickerSafelist, grCommandPaletteConfig, grCommandPaletteSafelist, grConfigProviderConfig, grConfirmDialogConfig, grContextMenuConfig, grDataTableConfig, grDataTableSafelist, grDeltaConfig, grDeltaSafelist, grDescriptionListConfig, grDescriptionListSafelist, grDialogSafelist, grDialogServiceConfig, grDividerConfig, grDividerSafelist, grDrawerConfig, grDrawerSafelist, grDropdownConfig, grDropdownMenuConfig, grDropdownMenuSafelist, grDropdownSafelist, grEmptyStateConfig, grEmptyStateSafelist, grFilePreviewConfig, grFilePreviewSafelist, grFileUploadConfig, grFileUploadSafelist, grFormConfig, grFormFieldConfig, grFormFieldSafelist, grFormFileConfig, grFormFileSafelist, grFormSectionConfig, grFormSectionSafelist, grIconConfig, grIconSafelist, grImageViewerConfig, grImageViewerSafelist, grInputConfig, grInputSafelist, grInputTagConfig, grInputTagSafelist, grJsonViewerConfig, grJsonViewerSafelist, grKbdConfig, grKbdSafelist, grLinkConfig, grLinkSafelist, grListConfig, grListSafelist, grLoadingConfig, grLoadingSafelist, grModalConfig, grModalSafelist, grNavbarConfig, grNavbarSafelist, grNumberInputConfig, grNumberInputSafelist, grPaginationConfig, grPaginationSafelist, grPopoverConfig, grPopoverSafelist, grProgressBarConfig, grProgressBarSafelist, grProgressCircleConfig, grProgressCircleSafelist, grPromptDialogConfig, grRadioConfig, grRadioGroupConfig, grRadioSafelist, grRatingConfig, grRatingSafelist, grSegmentedConfig, grSegmentedSafelist, grSelectConfig, grSelectSafelist, grSidebarConfig, grSidebarSafelist, grSkeletonConfig, grSliderConfig, grSliderSafelist, grSortableListConfig, grSortableListSafelist, grSplitterConfig, grSplitterSafelist, grStatisticConfig, grStatisticSafelist, grStepsConfig, grStepsSafelist, grSwitchConfig, grSwitchSafelist, grTabPanelsConfig, grTableConfig, grTableSafelist, grTabsConfig, grTabsSafelist, grTextareaConfig, grTextareaSafelist, grTimelineConfig, grTimelineSafelist, grToasterConfig, grToasterSafelist, grTooltipConfig, grTooltipSafelist, grTransferConfig, grTransferSafelist, grTreeConfig, grTreeSafelist, grTreeSelectConfig, grTreeSelectSafelist, grValueConfig, grValueSafelist, granularityDialogServicePlugin, granularityThemePlugin, granularityToastPlugin, initThemeEarly, initialsFrom, isEmpty, isPreviewableKind, normalizeError, resolveBreadcrumbsFit, resolveBreadcrumbsLayout, resolveGrConfig, runFieldRules, setByPath, sizeFromPointer, teardownDialogService, titleWhenTruncated, useAnnouncer, useComboboxNavigation, useDialogService, useDismissible, useDragGesture, useDragSort, useFloating, useFocusTrap, useGrButtonGroup, useGrComponentDefaults, useGrComponentProp, useGrComponentSize, useGrConfig, useGrFormContext, useGrFormControl, useGrFormFieldContext, useGrThemeAttrs, useGranularityTranslations, useOverlayLayer, usePortalTarget, useResponseError, useRovingFocus, useTheme, useToast, useVirtualList, vAutofocus, vAutosize, vClickOutside, vDropzone, vHotkey, vLoading };
+export { FileValidationError, GRANULARITY_THEME_STATE, GRANULARITY_TOAST_STATE, GR_KBD_TOKENS, GR_TONES, GrAffix_default as GrAffix, GrAlert_default as GrAlert, GrAutocomplete_default as GrAutocomplete, GrAvatar_default as GrAvatar, GrAvatarGroup_default as GrAvatarGroup, GrBadge_default as GrBadge, GrBadgeWrap_default as GrBadgeWrap, GrBottomNav_default as GrBottomNav, GrBreadcrumbs_default as GrBreadcrumbs, GrButton_default as GrButton, GrButtonGroup_default as GrButtonGroup, GrCard_default as GrCard, GrCarousel_default as GrCarousel, GrCarouselSlide_default as GrCarouselSlide, GrCheckbox_default as GrCheckbox, GrCheckboxGroup_default as GrCheckboxGroup, GrChip_default as GrChip, GrChipGroup_default as GrChipGroup, GrCollapse_default as GrCollapse, GrCollapseItem_default as GrCollapseItem, GrColorPicker_default as GrColorPicker, GrCommandPalette_default as GrCommandPalette, GrConfigProvider_default as GrConfigProvider, GrConfirmDialog_default as GrConfirmDialog, GrContextMenu_default as GrContextMenu, GrDataTable_default as GrDataTable, GrDelta_default as GrDelta, GrDescriptionList_default as GrDescriptionList, GrDialog_default as GrDialog, GrDialogCloseButton_default as GrDialogCloseButton, GrDialogFooter_default as GrDialogFooter, GrDialogHeader_default as GrDialogHeader, GrDialogServiceHost_default as GrDialogServiceHost, GrDivider_default as GrDivider, GrDrawer_default as GrDrawer, GrDropdown_default as GrDropdown, GrDropdownMenu_default as GrDropdownMenu, GrDropdownMenuColumn_default as GrDropdownMenuColumn, GrDropdownMenuColumns_default as GrDropdownMenuColumns, GrDropdownMenuDivider_default as GrDropdownMenuDivider, GrDropdownMenuGroup_default as GrDropdownMenuGroup, GrDropdownMenuHeader_default as GrDropdownMenuHeader, GrDropdownMenuItem_default as GrDropdownMenuItem, GrDropdownMenuList_default as GrDropdownMenuList, GrEmptyState_default as GrEmptyState, GrFilePreview_default as GrFilePreview, GrFileUpload_default as GrFileUpload, GrForm_default as GrForm, GrFormErrorBanner_default as GrFormErrorBanner, GrFormField_default as GrFormField, GrFormFile_default as GrFormFile, GrFormSection_default as GrFormSection, GrIcon_default as GrIcon, GrImageViewer_default as GrImageViewer, GrInput_default as GrInput, GrInputTag_default as GrInputTag, GrJsonViewer_default as GrJsonViewer, GrKbd_default as GrKbd, GrLink_default as GrLink, GrList_default as GrList, GrListItem_default as GrListItem, GrLoading_default as GrLoading, GrModal_default as GrModal, GrNavbar_default as GrNavbar, GrNumberInput_default as GrNumberInput, GrPagination_default as GrPagination, GrPopover_default as GrPopover, GrProgressBar_default as GrProgressBar, GrProgressCircle_default as GrProgressCircle, GrPromptDialog_default as GrPromptDialog, GrRadio_default as GrRadio, GrRadioGroup_default as GrRadioGroup, GrRating_default as GrRating, GrResponseErrorBanner_default as GrResponseErrorBanner, GrScrollSpy_default as GrScrollSpy, GrSegmented_default as GrSegmented, GrSelect_default as GrSelect, GrSidebar_default as GrSidebar, GrSidebarGroup_default as GrSidebarGroup, GrSidebarItem_default as GrSidebarItem, GrSkeleton_default as GrSkeleton, GrSlider_default as GrSlider, GrSortableList_default as GrSortableList, GrSplitter_default as GrSplitter, GrStatistic_default as GrStatistic, GrSteps_default as GrSteps, GrSwitch_default as GrSwitch, GrTabPanel_default as GrTabPanel, GrTabPanels_default as GrTabPanels, GrTable_default as GrTable, GrTabs_default as GrTabs, GrTextarea_default as GrTextarea, GrTimeline_default as GrTimeline, GrTimelineItem_default as GrTimelineItem, GrToaster_default as GrToaster, GrTooltip_default as GrTooltip, GrTransfer_default as GrTransfer, GrTree_default as GrTree, GrTreeSelect_default as GrTreeSelect, GrUploadAbortError, GrUploadErrorBanner_default as GrUploadErrorBanner, GrUploadHttpError, GrValue_default as GrValue, coreResponseErrorParsers, createGrFormMessageResolver, createLoading, createResponseErrorClassifier, deltaDirection, deltaTone, dialogService, extendDefaultParsers, fileKindOf, findKbdToken, formatBadgeValue, formatStatisticValue, getByPath, grAffixConfig, grAffixSafelist, grAlertConfig, grAutocompleteConfig, grAutocompleteSafelist, grAvatarConfig, grAvatarSafelist, grBadgeConfig, grBadgeSafelist, grBadgeWrapConfig, grBadgeWrapSafelist, grBottomNavConfig, grBottomNavSafelist, grBreadcrumbsConfig, grBreadcrumbsSafelist, grButtonConfig, grButtonGroupConfig, grButtonSafelist, grCardConfig, grCardSafelist, grCarouselConfig, grCarouselSafelist, grCheckboxConfig, grCheckboxGroupConfig, grCheckboxSafelist, grChipConfig, grChipGroupConfig, grChipGroupSafelist, grChipSafelist, grCollapseConfig, grCollapseSafelist, grColorPickerConfig, grColorPickerSafelist, grCommandPaletteConfig, grCommandPaletteSafelist, grConfigProviderConfig, grConfirmDialogConfig, grContextMenuConfig, grDataTableConfig, grDataTableSafelist, grDeltaConfig, grDeltaSafelist, grDescriptionListConfig, grDescriptionListSafelist, grDialogSafelist, grDialogServiceConfig, grDividerConfig, grDividerSafelist, grDrawerConfig, grDrawerSafelist, grDropdownConfig, grDropdownMenuConfig, grDropdownMenuSafelist, grDropdownSafelist, grEmptyStateConfig, grEmptyStateSafelist, grFilePreviewConfig, grFilePreviewSafelist, grFileUploadConfig, grFileUploadSafelist, grFormConfig, grFormFieldConfig, grFormFieldSafelist, grFormFileConfig, grFormFileSafelist, grFormSectionConfig, grFormSectionSafelist, grIconConfig, grIconSafelist, grImageViewerConfig, grImageViewerSafelist, grInputConfig, grInputSafelist, grInputTagConfig, grInputTagSafelist, grJsonViewerConfig, grJsonViewerSafelist, grKbdConfig, grKbdSafelist, grLinkConfig, grLinkSafelist, grListConfig, grListSafelist, grLoadingConfig, grLoadingSafelist, grModalConfig, grModalSafelist, grNavbarConfig, grNavbarSafelist, grNumberInputConfig, grNumberInputSafelist, grPaginationConfig, grPaginationSafelist, grPopoverConfig, grPopoverSafelist, grProgressBarConfig, grProgressBarSafelist, grProgressCircleConfig, grProgressCircleSafelist, grPromptDialogConfig, grRadioConfig, grRadioGroupConfig, grRadioSafelist, grRatingConfig, grRatingSafelist, grScrollSpyConfig, grScrollSpySafelist, grSegmentedConfig, grSegmentedSafelist, grSelectConfig, grSelectSafelist, grSidebarConfig, grSidebarSafelist, grSkeletonConfig, grSliderConfig, grSliderSafelist, grSortableListConfig, grSortableListSafelist, grSplitterConfig, grSplitterSafelist, grStatisticConfig, grStatisticSafelist, grStepsConfig, grStepsSafelist, grSwitchConfig, grSwitchSafelist, grTabPanelsConfig, grTableConfig, grTableSafelist, grTabsConfig, grTabsSafelist, grTextareaConfig, grTextareaSafelist, grTimelineConfig, grTimelineSafelist, grToasterConfig, grToasterSafelist, grTooltipConfig, grTooltipSafelist, grTransferConfig, grTransferSafelist, grTreeConfig, grTreeSafelist, grTreeSelectConfig, grTreeSelectSafelist, grValueConfig, grValueSafelist, granularityDialogServicePlugin, granularityThemePlugin, granularityToastPlugin, initThemeEarly, initialsFrom, isEmpty, isPreviewableKind, normalizeError, resolveBreadcrumbsFit, resolveBreadcrumbsLayout, resolveGrConfig, runFieldRules, setByPath, sizeFromPointer, teardownDialogService, titleWhenTruncated, useAnnouncer, useComboboxNavigation, useDialogService, useDismissible, useDragGesture, useDragSort, useFloating, useFocusTrap, useGrButtonGroup, useGrComponentDefaults, useGrComponentProp, useGrComponentSize, useGrConfig, useGrFormContext, useGrFormControl, useGrFormFieldContext, useGrThemeAttrs, useGranularityTranslations, useOverlayLayer, usePortalTarget, useResponseError, useRovingFocus, useScrollSpy, useTheme, useToast, useVirtualList, vAutofocus, vAutosize, vClickOutside, vDropzone, vHotkey, vLoading };

package/dist/theme.js

@@ -1,4 +1,4 @@
-import { a as grThemeTokens, n as grDerivedTokens, t as grComponentTokens } from "./chunks/generated-VcxJTo_q.js";
+import { a as grThemeTokens, n as grDerivedTokens, t as grComponentTokens } from "./chunks/generated-Hxu_sWPs.js";
 //#region src/theme/color.ts
 function parseHex(value) {
 	const match = value.trim().match(/^#([\da-f]{3}|[\da-f]{6})$/i);

package/dist/tokens.js

@@ -1,2 +1,2 @@
-import { a as grThemeTokens, i as grThemeNames, n as grDerivedTokens, r as grFoundationTokens, t as grComponentTokens } from "./chunks/generated-VcxJTo_q.js";
+import { a as grThemeTokens, i as grThemeNames, n as grDerivedTokens, r as grFoundationTokens, t as grComponentTokens } from "./chunks/generated-Hxu_sWPs.js";
 export { grComponentTokens, grDerivedTokens, grFoundationTokens, grThemeNames, grThemeTokens };

package/dist/types/components/GrScrollSpy/GrScrollSpy.vue.d.ts

@@ -0,0 +1,105 @@
+import type { GrScrollSpySection } from './scrollSpyItems';
+/**
+ * GrScrollSpy — оглавление длинной страницы, которое знает, до какого раздела
+ * дочитали: активный пункт подсвечивается по прокрутке, клик по пункту ведёт к
+ * разделу.
+ *
+ * Логика положения живёт в композабле `useScrollSpy` и доступна отдельно — этот
+ * компонент добавляет к ней разметку, `aria-current` и всё, что следует из того,
+ * что пункт является ссылкой.
+ */
+export interface GrScrollSpyProps {
+    /** Разделы в порядке их следования на странице. */
+    sections: GrScrollSpySection[];
+    /**
+     * Отступ линии активации от верха скроллпорта. Число — пиксели, строка — как
+     * есть. Почти всегда равен отступу липкой шапки (`--gr-affix-offset`).
+     */
+    offset?: number | string;
+    /** Скроллпорт: элемент или селектор. Не задан — ищется от первого раздела. */
+    scroller?: HTMLElement | string | null;
+    ariaLabel?: string;
+    /** Обновлять `#hash` адреса при переходе. */
+    updateHash?: boolean;
+    /** Плавность прокрутки. Под `prefers-reduced-motion` всегда мгновенная. */
+    behavior?: ScrollBehavior;
+    /** Переносить фокус на раздел, как это делает переход по якорю. */
+    focusTarget?: boolean;
+    disabled?: boolean;
+}
+export interface GrScrollSpyEmits {
+    (e: 'activeChange', id: string | null): void;
+    (e: 'select', id: string, event: MouseEvent): void;
+}
+type __VLS_Slots = {
+    /** Пункт целиком. `activate` повторяет клик по нему. */
+    item?: (props: {
+        section: GrScrollSpySection;
+        active: boolean;
+        ancestor: boolean;
+        activate: () => void;
+    }) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrScrollSpyProps>, {
+    offset: undefined;
+    scroller: undefined;
+    ariaLabel: undefined;
+    updateHash: boolean;
+    behavior: undefined;
+    focusTarget: boolean;
+    disabled: boolean;
+}>>, {
+    active: Readonly<import("vue").Ref<string | null, string | null>>;
+    scrollTo: (id: string, options?: {
+        behavior?: ScrollBehavior;
+    }) => void;
+    refresh: () => void;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    activeChange: (id: string | null) => void;
+    select: (id: string, event: MouseEvent) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrScrollSpyProps>, {
+    offset: undefined;
+    scroller: undefined;
+    ariaLabel: undefined;
+    updateHash: boolean;
+    behavior: undefined;
+    focusTarget: boolean;
+    disabled: boolean;
+}>>> & Readonly<{
+    onSelect?: ((id: string, event: MouseEvent) => any) | undefined;
+    onActiveChange?: ((id: string | null) => any) | undefined;
+}>, {
+    offset: number | string;
+    disabled: boolean;
+    ariaLabel: string;
+    behavior: ScrollBehavior;
+    scroller: HTMLElement | string | null;
+    updateHash: boolean;
+    focusTarget: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<Required<T>[K]>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/types/components/GrScrollSpy/config.d.ts

@@ -0,0 +1 @@
+export declare const grScrollSpyConfig: import("@feugene/unocss-preset-granular/contract").GranularComponentDescriptor<"GrScrollSpy">;

package/dist/types/components/GrScrollSpy/grScrollSpyStyles.d.ts

@@ -0,0 +1,26 @@
+export declare const scrollSpyRootClass = "text-[length:var(--gr-control-text-sm)] leading-[var(--gr-leading-sm)] [scroll-margin-top:var(--gr-scroll-spy-offset,0px)]";
+export declare const scrollSpyListClass = "flex flex-col [list-style:none]";
+/**
+ * Пункт — ссылка, поэтому `no-underline` и своё фокус-кольцо: `focus:outline-none`
+ * снимает системное, `focus-visible:ring-*` возвращает кольцо пакета.
+ *
+ * `ease-*` обязателен рядом с `duration-*`: без него кривую подставит `presetMini`,
+ * то есть движение задавал бы пресет, а не дизайн-система.
+ */
+export declare const scrollSpyItemBaseClass = "block truncate no-underline border-s-2 ps-2 pe-2 py-1 rounded-e-[var(--gr-radius-control)] transition-colors duration-[var(--gr-duration-fast)] ease-[var(--gr-ease-out)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";
+/**
+ * Активный пункт отличается **тремя** признаками — цветом рельса, весом и
+ * цветом текста. Одного цвета мало: он не виден при монохромном зрении и не
+ * существует для диктора, которому состояние приходит через `aria-current`.
+ *
+ * Приглушение неактивных — токеном текста, а не `opacity`: прозрачность
+ * разбавляет выверенные на AA цвета и роняет контраст.
+ */
+export declare const scrollSpyItemIdleClass = "border-s-[var(--gr-scroll-spy-rail,var(--gr-brd))] text-[var(--gr-muted-fg)] hover:text-[var(--gr-fg)]";
+/**
+ * Предок активного пункта. Без него оглавление с двумя уровнями читается как
+ * сломанное: активен подраздел, а его раздел выглядит выключенным.
+ */
+export declare const scrollSpyItemAncestorClass = "border-s-[var(--gr-scroll-spy-rail,var(--gr-brd))] text-[var(--gr-fg)]";
+export declare const scrollSpyItemActiveClass = "border-s-[var(--gr-scroll-spy-marker,var(--gr-primary))] font-600 text-[var(--gr-primary-text)]";
+export declare function grScrollSpyItemClass(state: 'active' | 'ancestor' | 'idle'): string;

package/dist/types/components/GrScrollSpy/index.d.ts

@@ -0,0 +1,9 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrScrollSpyComponent from './GrScrollSpy.vue';
+export { default } from './GrScrollSpy.vue';
+export { default as GrScrollSpy } from './GrScrollSpy.vue';
+export type { GrScrollSpyEmits, GrScrollSpyProps } from './GrScrollSpy.vue';
+export type { GrScrollSpySection } from './scrollSpyItems';
+export { grScrollSpyConfig } from './config';
+export { grScrollSpySafelist } from './safelist';
+export type GrScrollSpyInstance = ComponentExposed<typeof GrScrollSpyComponent>;

package/dist/types/components/GrScrollSpy/safelist.d.ts

@@ -0,0 +1 @@
+export declare const grScrollSpySafelist: string[];

package/dist/types/components/GrScrollSpy/scrollSpyItems.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Арифметика пунктов оглавления: всё, что следует из того, что пункт —
+ * **ссылка**, а не из положения прокрутки. Положение живёт в
+ * `composables/internal/scrollSpyGeometry.ts`.
+ */
+/** Раздел в оглавлении. */
+export interface GrScrollSpySection {
+    id: string;
+    label: string;
+    /** Уровень вложенности, 1 — верхний. Влияет на отступ и цепочку предков. */
+    level?: number;
+}
+/**
+ * Значение пропа `offset` в CSS-длину для инлайновой переменной.
+ *
+ * Строка уходит как есть и намеренно не валидируется: `4rem`,
+ * `var(--gr-navbar-height)`, `calc(…)` обязаны работать — иначе проп проигрывает
+ * голому `style`. Отрицательное зажимается в ноль: линия активации выше верха
+ * скроллпорта смысла не имеет.
+ */
+export declare function scrollSpyOffsetLength(value: number | string | undefined): string | undefined;
+/**
+ * Наш ли это клик.
+ *
+ * Пункт остаётся `<a href="#id">` ровно ради того, что браузер умеет с ссылкой
+ * сам: `Cmd`-клик открывает в новой вкладке, средняя кнопка — тоже. Перехватив
+ * их, компонент отнял бы у пользователя работающее поведение и ничего не дал
+ * взамен.
+ */
+export declare function anchorClickHandled(event: {
+    button: number;
+    metaKey: boolean;
+    ctrlKey: boolean;
+    shiftKey: boolean;
+    altKey: boolean;
+    defaultPrevented: boolean;
+}): boolean;
+/**
+ * Предки активного пункта — те разделы выше по списку, чей уровень мельче.
+ *
+ * Считается по документному порядку массива, а не по дереву: дерево позволило
+ * бы объявить вложенность, противоречащую порядку разделов на странице.
+ */
+export declare function ancestorSectionIds(sections: readonly GrScrollSpySection[], activeId: string | null): Set<string>;

package/dist/types/composables/internal/scrollSpyGeometry.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Арифметика положения чтения: чистые функции без DOM и без реактивности.
+ *
+ * Вынесена отдельно по той же причине, что и геометрия перестановки в
+ * `dragSortGeometry.ts`: ошибка здесь проявляется не исключением, а
+ * «подсветился не тот раздел», и поймать это можно только тестом на числах. В
+ * jsdom проверить нечем вовсе — там нет ни прокрутки, ни раскладки.
+ *
+ * Композабл `useScrollSpy` сводит `DOMRect` к числам и зовёт эти функции; что
+ * значит активный раздел для разметки, решает уже компонент.
+ */
+/** Верх раздела в координатах вьюпорта. */
+export interface ScrollSpyRect {
+    id: string;
+    top: number;
+}
+/**
+ * Какой раздел читают сейчас.
+ *
+ * Правило — «последний, чей верх выше линии», а не «самый видимый». Максимум
+ * доли пересечения ошибается двумя способами: длинный раздел выигрывает у
+ * короткого независимо от того, что читают, и подсветка отскакивает назад,
+ * когда следующий раздел только показался снизу. Здесь ответ — заголовок,
+ * ближайший сверху к линии чтения.
+ *
+ * Порядок массива на ответ не влияет: выбор идёт по геометрии. Это снимает
+ * класс дефектов, где объявленный список разошёлся с порядком разделов на
+ * странице — подсветку в таком случае невозможно отладить.
+ *
+ * `atEnd` побеждает правило линии, и без него последний раздел недостижим:
+ * раздел короче остатка скроллпорта никогда не доводит свой верх до линии,
+ * потому что прокрутка кончается раньше.
+ */
+export declare function activeSectionId(rects: readonly ScrollSpyRect[], line: number, atEnd: boolean): string | null;
+/**
+ * `rootMargin` наблюдателя: верх корня поджимается на отступ, и тогда его край
+ * совпадает с линией активации.
+ *
+ * Единицы только `px`: `rootMargin` произвольных длин не принимает, поэтому
+ * отступ приходит сюда уже замеренным.
+ */
+export declare function scrollSpyRootMargin(offsetPx: number): string;
+/**
+ * Куда прокрутить скроллпорт, чтобы верх раздела встал на линию активации.
+ *
+ * Своя арифметика вместо `scrollIntoView` — по трём независимым причинам:
+ * тот двигает всех предков (у карусели это стоило прыжка страницы на каждом
+ * шаге автопрокрутки), не умеет наш отступ, и в jsdom отсутствует вовсе, то
+ * есть клик стал бы непроверяемым.
+ */
+export declare function scrollSpyTargetTop(scrollTop: number, sectionTop: number, portTop: number, offset: number, maxScrollTop: number): number;
+/**
+ * Прокручивается ли предок.
+ *
+ * Читается вычисленный `overflow-y`, а не объявленный: при
+ * `overflow-x: hidden; overflow-y: visible` спецификация превращает вычисленный
+ * `overflow-y` в `auto`, то есть предок действительно становится скроллпортом.
+ */
+export declare function isScrollableOverflow(overflowY: string): boolean;
+/**
+ * Доехали ли до дна.
+ *
+ * `maxScrollTop > 1` — обязательное условие, а не перестраховка: содержимое
+ * короче скроллпорта даёт «дно» на нулевой прокрутке, и правило `atEnd`
+ * подсветило бы последний раздел на странице, где позиции чтения нет вовсе.
+ */
+export declare function isScrolledToEnd(scrollTop: number, maxScrollTop: number): boolean;