@feugene/granularity 0.16.0 → 0.19.0

package/dist/composables/useRovingFocus.js

@@ -0,0 +1,150 @@
+import { computed, ref } from "vue";
+//#region src/composables/useRovingFocus.ts
+function useRovingFocus(options) {
+	const activeKey = ref();
+	const orientation = () => options.orientation?.() ?? "vertical";
+	const wraps = () => options.wrap?.() ?? true;
+	const skips = () => options.skipDisabled?.() ?? false;
+	const disabled = (key) => options.isDisabled?.(key) ?? false;
+	function firstFocusable(items) {
+		if (!skips()) return items[0];
+		return items.find((key) => !disabled(key)) ?? items[0];
+	}
+	/**
+	* Роверный элемент. Порядок: явно активный (если ещё в наборе) → стартовый →
+	* первый доступный. Именно здесь живёт инвариант «ровно один `tabindex=0`»:
+	* пока набор непуст, ответ не бывает пустым.
+	*/
+	const rovingKey = computed(() => {
+		const items = options.items();
+		if (items.length === 0) return void 0;
+		const active = activeKey.value;
+		if (active !== void 0 && items.includes(active)) return active;
+		const initial = options.initialKey?.();
+		if (initial !== void 0 && items.includes(initial)) return initial;
+		return firstFocusable(items);
+	});
+	function tabindexFor(key) {
+		return rovingKey.value === key ? 0 : -1;
+	}
+	function setActive(key) {
+		activeKey.value = key;
+	}
+	function reset() {
+		activeKey.value = void 0;
+	}
+	function focusKey(key) {
+		const previous = rovingKey.value;
+		activeKey.value = key;
+		if (key !== previous) options.onMove?.(key, previous);
+		const focusNow = () => {
+			options.elementFor(key)?.focus();
+		};
+		const pending = options.beforeFocus?.(key);
+		if (pending && typeof pending.then === "function") return pending.then(focusNow);
+		focusNow();
+		return Promise.resolve();
+	}
+	/**
+	* Индекс цели после сдвига. `undefined` — движение невозможно: упёрлись в
+	* край без зацикливания либо весь набор выключен.
+	*/
+	function targetIndex(from, delta) {
+		const items = options.items();
+		const len = items.length;
+		if (len === 0 || delta === 0) return void 0;
+		let index = from;
+		for (let attempt = 0; attempt < len; attempt += 1) {
+			const next = index + delta;
+			if (next < 0 || next >= len) {
+				if (!wraps()) return void 0;
+				index = (next % len + len) % len;
+			} else index = next;
+			if (!skips() || !disabled(items[index])) return index;
+		}
+	}
+	function currentIndex() {
+		const items = options.items();
+		const key = rovingKey.value;
+		return key === void 0 ? -1 : items.indexOf(key);
+	}
+	function moveBy(delta) {
+		const items = options.items();
+		const from = currentIndex();
+		if (from < 0) return false;
+		const target = targetIndex(from, delta);
+		if (target === void 0) {
+			const edge = delta > 0 ? "end" : "start";
+			return options.onOverflow?.(edge, delta) ?? false;
+		}
+		focusKey(items[target]);
+		return true;
+	}
+	function rowBounds(index) {
+		const len = options.items().length;
+		const width = Math.max(1, options.columns?.() ?? len);
+		const row = Math.floor(index / width);
+		return [row * width, Math.min(row * width + width - 1, len - 1)];
+	}
+	function moveToEdge(edge) {
+		const items = options.items();
+		if (items.length === 0) return false;
+		const from = currentIndex();
+		const [start, end] = orientation() === "grid" && from >= 0 ? rowBounds(from) : [0, items.length - 1];
+		const target = edge === "start" ? start : end;
+		if (!skips()) {
+			focusKey(items[target]);
+			return true;
+		}
+		const direction = edge === "start" ? 1 : -1;
+		for (let index = target; index >= start && index <= end; index += direction) {
+			const key = items[index];
+			if (!disabled(key)) {
+				focusKey(key);
+				return true;
+			}
+		}
+		return false;
+	}
+	/** Шаг вперёд/назад по объявленной ориентации; `0` — клавиша этой оси не касается. */
+	function deltaForKey(key) {
+		const mode = orientation();
+		const columns = Math.max(1, options.columns?.() ?? 1);
+		switch (key) {
+			case "ArrowRight": return mode === "vertical" ? 0 : 1;
+			case "ArrowLeft": return mode === "vertical" ? 0 : -1;
+			case "ArrowDown":
+				if (mode === "horizontal") return 0;
+				return mode === "grid" ? columns : 1;
+			case "ArrowUp":
+				if (mode === "horizontal") return 0;
+				return mode === "grid" ? -columns : -1;
+			default: return 0;
+		}
+	}
+	function handleNavigationKeys(event) {
+		if (event.altKey || event.ctrlKey || event.metaKey) return false;
+		if (event.key === "Home" || event.key === "End") {
+			const moved = moveToEdge(event.key === "Home" ? "start" : "end");
+			if (moved) event.preventDefault();
+			return moved;
+		}
+		const delta = deltaForKey(event.key);
+		if (delta === 0) return false;
+		const moved = moveBy(delta);
+		if (moved) event.preventDefault();
+		return moved;
+	}
+	return {
+		rovingKey,
+		tabindexFor,
+		setActive,
+		reset,
+		focusKey,
+		moveBy,
+		moveToEdge,
+		handleNavigationKeys
+	};
+}
+//#endregion
+export { useRovingFocus };

package/dist/composables/useRovingFocus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRovingFocus.js","names":[],"sources":["../../src/composables/useRovingFocus.ts"],"sourcesContent":["import type { ComputedRef, Ref } from 'vue'\nimport { computed, ref } from 'vue'\n\n/**\n * Roving tabindex: группа — одна остановка `Tab`, внутрь заходят стрелками.\n *\n * Механика написана в пакете шесть раз (`GrDropdownMenu`, `GrTree`, `GrTabs`,\n * `GrSegmented`, `GrRadio`, `GrInputTag`) и разошлась не стилистически, а по\n * существу: у одних кольцо зациклено, у других упирается в края; одни\n * пропускают выключенные элементы, другие намеренно нет; адресуются то\n * индексом, то ключом, то значением. Каждое расхождение здесь стало опцией —\n * поэтому опций много, и это дешевле, чем седьмая копия.\n *\n * Осознанно **не** обобщается активация: `Enter`/`Space` и «двигает ли стрелка\n * выбор» — доменная логика компонента. У `GrSegmented` и `GrRadio` стрелка\n * меняет значение, у `GrTree` и `GrInputTag` — нет, у `GrTabs` это проп.\n * Примитив ведёт фокус и отдаёт `onMove`; что делать с переездом, решает\n * компонент.\n *\n * Инвариант «ровно один элемент с `tabindex=\"0\"`» держит `rovingKey`: это\n * `computed`, а не `ref`, поэтому при смене набора он самокорректируется в\n * момент чтения. Отдельная нормализация с `watch(..., { flush: 'sync' })`,\n * как в `GrTree`, больше не нужна.\n */\n\n/** Какие стрелки ведут по набору. */\nexport type GrRovingOrientation = 'horizontal' | 'vertical' | 'both' | 'grid'\n\n/** Край набора, в который упёрлось движение. */\nexport type GrRovingEdge = 'start' | 'end'\n\nexport interface UseRovingFocusOptions<TKey> {\n  /** Ключи элементов в порядке отображения. Индекс, значение, opaque-ключ — что угодно сравнимое по `===`. */\n  items: () => readonly TKey[]\n  /**\n   * DOM-узел элемента. Массив ref-ов, `Map`, `querySelector` — примитиву\n   * безразлично, знать раскладку обязан компонент.\n   */\n  elementFor: (key: TKey) => HTMLElement | null | undefined\n  /** Выключен ли элемент. Спрашивается только при `skipDisabled`. */\n  isDisabled?: (key: TKey) => boolean\n  /** По умолчанию `vertical`. */\n  orientation?: () => GrRovingOrientation\n  /** Ширина строки для `orientation: 'grid'`. Игнорируется в остальных режимах. */\n  columns?: () => number\n  /** Замкнуто ли кольцо. По умолчанию `true`. */\n  wrap?: () => boolean\n  /**\n   * Пропускать выключенные при движении. По умолчанию `false`: в паттерне\n   * `menu` выключенный пункт остаётся в обходе намеренно — `aria-disabled`\n   * оставляет его фокусируемым, чтобы скринридер прочёл, что он есть.\n   */\n  skipDisabled?: () => boolean\n  /**\n   * Стартовый элемент, когда фокус в группе ещё не был — обычно выбранное\n   * значение.\n   *\n   * **Выключенность здесь не проверяется, и это не упущение.** Проверить её\n   * автоматически по `isDisabled` нельзя: у `GrSegmented` загружающийся сегмент\n   * остановку `Tab` сохраняет, хотя для движения заблокирован, а у `GrRadio`\n   * выключенный переключатель терять её обязан. Условие знает только вызывающий,\n   * поэтому геттер обязан вернуть `undefined` для значения, которое не может\n   * принять фокус. Забыть об этом — значит оставить группу без остановки `Tab`\n   * вовсе: элемент с `tabindex=\"0\"` будет назначен, но отрисует `-1`.\n   */\n  initialKey?: () => TKey | undefined\n  /**\n   * Позиция переехала — компонент решает, менять ли заодно выбор. Вызывается\n   * **до** переноса фокуса: в `radiogroup` стрелка переносит выбор, и модель\n   * обязана примениться раньше, чем сфокусируется целевой элемент.\n   */\n  onMove?: (key: TKey, previous: TKey | undefined) => void\n  /**\n   * Движение упёрлось в край при `wrap: false`. Вернул `true` — считаем клавишу\n   * обработанной (кольцо `GrInputTag` так отдаёт фокус полю ввода, календарь —\n   * листает месяц).\n   */\n  onOverflow?: (edge: GrRovingEdge, delta: number) => boolean\n  /**\n   * Донести элемент до экрана перед фокусом: виртуализация, `scrollIntoView`,\n   * ожидание перерисовки после `onMove`. Вернул промис — фокус ждёт ровно его,\n   * без добавленных примитивом тиков; вернул `undefined` — фокус остаётся\n   * синхронным, чтобы не менять тайминг у компонентов, которые на него\n   * полагаются.\n   */\n  beforeFocus?: (key: TKey) => void | Promise<void>\n}\n\nexport interface UseRovingFocusReturn<TKey> {\n  /** Элемент, который держит `tabindex=\"0\"`. Никогда не «никто» при непустом наборе. */\n  rovingKey: ComputedRef<TKey | undefined>\n  /** `0` для роверного элемента, `-1` для всех остальных. */\n  tabindexFor: (key: TKey) => 0 | -1\n  /** Сделать активным без переноса фокуса — для синхронизации с мышью (`@focus`, `@click`). */\n  setActive: (key: TKey) => void\n  /**\n   * Забыть явно наведённый фокус: остановка `Tab` возвращается к производной\n   * (`initialKey` → первый доступный). Нужно, когда набор опустел, — иначе\n   * устаревший ключ всплывёт, как только элементы появятся снова.\n   */\n  reset: () => void\n  /** Сделать активным и перенести фокус. */\n  focusKey: (key: TKey) => Promise<void>\n  /** Сдвиг на `delta` позиций от текущего. Вернёт `false`, если движение не состоялось. */\n  moveBy: (delta: number) => boolean\n  /** На край набора (в `grid` — на край текущей строки). */\n  moveToEdge: (edge: GrRovingEdge) => boolean\n  /**\n   * Стрелки, `Home`, `End` по объявленной ориентации. Возвращает `true`, если\n   * клавиша обработана (с `preventDefault`) — остальное компонент разбирает сам.\n   */\n  handleNavigationKeys: (event: KeyboardEvent) => boolean\n}\n\nexport function useRovingFocus<TKey>(\n  options: UseRovingFocusOptions<TKey>,\n): UseRovingFocusReturn<TKey> {\n  const activeKey: Ref<TKey | undefined> = ref()\n\n  const orientation = (): GrRovingOrientation => options.orientation?.() ?? 'vertical'\n  const wraps = (): boolean => options.wrap?.() ?? true\n  const skips = (): boolean => options.skipDisabled?.() ?? false\n  const disabled = (key: TKey): boolean => options.isDisabled?.(key) ?? false\n\n  function firstFocusable(items: readonly TKey[]): TKey | undefined {\n    if (!skips()) return items[0]\n    return items.find(key => !disabled(key)) ?? items[0]\n  }\n\n  /**\n   * Роверный элемент. Порядок: явно активный (если ещё в наборе) → стартовый →\n   * первый доступный. Именно здесь живёт инвариант «ровно один `tabindex=0`»:\n   * пока набор непуст, ответ не бывает пустым.\n   */\n  const rovingKey = computed<TKey | undefined>(() => {\n    const items = options.items()\n    if (items.length === 0) return undefined\n\n    const active = activeKey.value\n    if (active !== undefined && items.includes(active)) return active\n\n    const initial = options.initialKey?.()\n    if (initial !== undefined && items.includes(initial)) return initial\n\n    return firstFocusable(items)\n  })\n\n  function tabindexFor(key: TKey): 0 | -1 {\n    return rovingKey.value === key ? 0 : -1\n  }\n\n  function setActive(key: TKey): void {\n    activeKey.value = key\n  }\n\n  function reset(): void {\n    activeKey.value = undefined\n  }\n\n  function focusKey(key: TKey): Promise<void> {\n    const previous = rovingKey.value\n    activeKey.value = key\n\n    // Состояние — до фокуса: `onMove` часто меняет модель (в `radiogroup`\n    // стрелка переносит выбор), и компонент вправе рассчитывать, что к моменту\n    // фокуса оно уже применено.\n    if (key !== previous) options.onMove?.(key, previous)\n\n    const focusNow = (): void => {\n      options.elementFor(key)?.focus()\n    }\n\n    const pending = options.beforeFocus?.(key)\n    if (pending && typeof pending.then === 'function') {\n      return pending.then(focusNow)\n    }\n\n    focusNow()\n    return Promise.resolve()\n  }\n\n  /**\n   * Индекс цели после сдвига. `undefined` — движение невозможно: упёрлись в\n   * край без зацикливания либо весь набор выключен.\n   */\n  function targetIndex(from: number, delta: number): number | undefined {\n    const items = options.items()\n    const len = items.length\n    if (len === 0 || delta === 0) return undefined\n\n    let index = from\n\n    // Шагов не больше размера набора: полный оборот без единого доступного\n    // элемента означает, что двигаться некуда. Шаг на каждой итерации тот же —\n    // выключенный элемент в сетке перешагивается по вертикали, сохраняя\n    // колонку; прыжок «вбок» был бы неожиданным.\n    for (let attempt = 0; attempt < len; attempt += 1) {\n      const next = index + delta\n\n      if (next < 0 || next >= len) {\n        if (!wraps()) return undefined\n        // Зацикливание по модулю набора. Колонку это сохраняет, когда длина\n        // кратна ширине строки — у календарной сетки 42 = 6 × 7 так и есть.\n        index = ((next % len) + len) % len\n      }\n      else {\n        index = next\n      }\n\n      if (!skips() || !disabled(items[index])) return index\n    }\n\n    return undefined\n  }\n\n  function currentIndex(): number {\n    const items = options.items()\n    const key = rovingKey.value\n    return key === undefined ? -1 : items.indexOf(key)\n  }\n\n  function moveBy(delta: number): boolean {\n    const items = options.items()\n    // `rovingKey` пуст только при пустом наборе — двигаться нечем.\n    const from = currentIndex()\n    if (from < 0) return false\n\n    const target = targetIndex(from, delta)\n    if (target === undefined) {\n      const edge: GrRovingEdge = delta > 0 ? 'end' : 'start'\n      return options.onOverflow?.(edge, delta) ?? false\n    }\n\n    void focusKey(items[target])\n    return true\n  }\n\n  function rowBounds(index: number): [number, number] {\n    const len = options.items().length\n    const width = Math.max(1, options.columns?.() ?? len)\n    const row = Math.floor(index / width)\n    return [row * width, Math.min(row * width + width - 1, len - 1)]\n  }\n\n  function moveToEdge(edge: GrRovingEdge): boolean {\n    const items = options.items()\n    if (items.length === 0) return false\n\n    const from = currentIndex()\n    // В сетке `Home`/`End` — края строки (в календаре это начало и конец\n    // недели); в линейных режимах — края всего набора.\n    const [start, end] = orientation() === 'grid' && from >= 0\n      ? rowBounds(from)\n      : [0, items.length - 1]\n\n    const target = edge === 'start' ? start : end\n    if (!skips()) {\n      void focusKey(items[target])\n      return true\n    }\n\n    const direction = edge === 'start' ? 1 : -1\n    for (let index = target; index >= start && index <= end; index += direction) {\n      const key = items[index]\n      if (!disabled(key)) {\n        void focusKey(key)\n        return true\n      }\n    }\n    return false\n  }\n\n  /** Шаг вперёд/назад по объявленной ориентации; `0` — клавиша этой оси не касается. */\n  function deltaForKey(key: string): number {\n    const mode = orientation()\n    const columns = Math.max(1, options.columns?.() ?? 1)\n\n    switch (key) {\n      case 'ArrowRight':\n        return mode === 'vertical' ? 0 : 1\n      case 'ArrowLeft':\n        return mode === 'vertical' ? 0 : -1\n      case 'ArrowDown':\n        if (mode === 'horizontal') return 0\n        return mode === 'grid' ? columns : 1\n      case 'ArrowUp':\n        if (mode === 'horizontal') return 0\n        return mode === 'grid' ? -columns : -1\n      default:\n        return 0\n    }\n  }\n\n  function handleNavigationKeys(event: KeyboardEvent): boolean {\n    if (event.altKey || event.ctrlKey || event.metaKey) return false\n\n    if (event.key === 'Home' || event.key === 'End') {\n      const moved = moveToEdge(event.key === 'Home' ? 'start' : 'end')\n      if (moved) event.preventDefault()\n      return moved\n    }\n\n    const delta = deltaForKey(event.key)\n    if (delta === 0) return false\n\n    const moved = moveBy(delta)\n    if (moved) event.preventDefault()\n    return moved\n  }\n\n  return { rovingKey, tabindexFor, setActive, reset, focusKey, moveBy, moveToEdge, handleNavigationKeys }\n}\n"],"mappings":"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"}

package/dist/directives/hotkey.js

@@ -1,4 +1,4 @@
-import { i as shiftSatisfied, n as isComposingEvent, r as isEditableTarget, t as eventMatchesKey } from "../chunks/keyboard-zYvvyHd4.js";
+import { a as shiftSatisfied, i as isEditableTarget, n as isAppleDevice, r as isComposingEvent, t as eventMatchesKey } from "../chunks/keyboard-DE2yhz_b.js";
 //#region src/directives/hotkey.ts
 var states = /* @__PURE__ */ new WeakMap();
 function normalizeBinding(value) {
@@ -36,13 +36,15 @@ function parseHotkeys(map) {
 		if (!parts.length) continue;
 		let ctrl = false;
 		let meta = false;
+		let mod = false;
 		let alt = false;
 		let shift = false;
 		const keyToken = parts.at(-1);
 		if (!keyToken) continue;
 		for (const p of parts.slice(0, -1)) {
 			const t = p.toLowerCase();
-			if (t === "ctrl" || t === "control") ctrl = true;
+			if (t === "mod") mod = true;
+			else if (t === "ctrl" || t === "control") ctrl = true;
 			else if (t === "meta" || t === "cmd" || t === "command" || t === "⌘") meta = true;
 			else if (t === "alt" || t === "option") alt = true;
 			else if (t === "shift") shift = true;
@@ -53,6 +55,7 @@ function parseHotkeys(map) {
 			key,
 			ctrl,
 			meta,
+			mod,
 			alt,
 			shift,
 			entry
@@ -61,11 +64,14 @@ function parseHotkeys(map) {
 	return parsed;
 }
 function matchesHotkey(event, hk) {
-	if (hk.ctrl !== event.ctrlKey) return false;
-	if (hk.meta !== event.metaKey) return false;
+	const apple = hk.mod ? isAppleDevice() : false;
+	const expectMeta = hk.meta || hk.mod && apple;
+	const expectCtrl = hk.ctrl || hk.mod && !apple;
+	if (expectCtrl !== event.ctrlKey) return false;
+	if (expectMeta !== event.metaKey) return false;
 	if (hk.alt !== event.altKey) return false;
 	if (!shiftSatisfied(event, hk.key, hk.shift)) return false;
-	return eventMatchesKey(event, hk.key, { codeFallback: hk.ctrl || hk.meta || hk.alt });
+	return eventMatchesKey(event, hk.key, { codeFallback: expectCtrl || expectMeta || hk.alt });
 }
 function resolveEntry(entry) {
 	if (typeof entry === "function") return {
@@ -112,9 +118,9 @@ var vHotkey = {
 				for (const hk of current.hotkeys) {
 					if (!matchesHotkey(event, hk)) continue;
 					const entry = resolveEntry(hk.entry);
-					const hasModifier = hk.ctrl || hk.meta || hk.alt || hk.shift;
+					const hasModifier = hk.ctrl || hk.meta || hk.mod || hk.alt || hk.shift;
 					if (editable && !entry.allowInEditable && !hasModifier && hk.key !== "Escape") continue;
-					if (entry.preventDefault ?? (hk.ctrl || hk.meta || hk.alt)) event.preventDefault();
+					if (entry.preventDefault ?? (hk.ctrl || hk.meta || hk.mod || hk.alt)) event.preventDefault();
 					if (entry.stopPropagation) event.stopPropagation();
 					entry.handler(event);
 					return;

package/dist/directives/hotkey.js.map

@@ -1 +1 @@
-{"version":3,"file":"hotkey.js","names":[],"sources":["../../src/directives/hotkey.ts"],"sourcesContent":["import type { Directive } from 'vue'\n\nimport { eventMatchesKey, isComposingEvent, isEditableTarget, shiftSatisfied } from '../internal/keyboard'\n\nexport type HotkeyHandler = (event: KeyboardEvent) => void\n\nexport type HotkeyEntry =\n  | HotkeyHandler\n  | {\n      handler: HotkeyHandler\n      /** По умолчанию: `true` для комбинаций с Ctrl/Meta/Alt, иначе `false`. */\n      preventDefault?: boolean\n      /** По умолчанию `false`. */\n      stopPropagation?: boolean\n      /** Разрешить срабатывать, когда фокус в `input/textarea/[contenteditable]`. */\n      allowInEditable?: boolean\n    }\n\nexport type HotkeyMap = Record<string, HotkeyEntry>\n\n/**\n * Где слушать клавиатуру:\n * - `'global'` (по умолчанию) — слушатель на `window`; хоткеи работают из любого места страницы.\n * - `'element'` — слушатель на самом элементе; хоткеи срабатывают только когда фокус внутри\n *   элемента (событие всплывает до него). Элемент должен быть фокусируемым (`tabindex`).\n */\nexport type HotkeyScope = 'global' | 'element'\n\nexport type HotkeyBindingValue =\n  | HotkeyMap\n  | {\n      handlers: HotkeyMap\n      enabled?: boolean\n      scope?: HotkeyScope\n    }\n\ntype ParsedHotkey = {\n  original: string\n  key: string\n  ctrl: boolean\n  meta: boolean\n  alt: boolean\n  shift: boolean\n  entry: HotkeyEntry\n}\n\ntype InternalState = {\n  enabled: boolean\n  hotkeys: ParsedHotkey[]\n  listener: (event: KeyboardEvent) => void\n  /** Цель, на которой висит слушатель (`window` для 'global', сам `el` для 'element'). */\n  target: Window | HTMLElement\n}\n\nconst states = new WeakMap<HTMLElement, InternalState>()\n\nfunction normalizeBinding(value: HotkeyBindingValue | undefined) {\n  if (!value) return { enabled: false, handlers: {} as HotkeyMap, scope: 'global' as HotkeyScope }\n  if ('handlers' in (value as any)) {\n    const v = value as { handlers: HotkeyMap; enabled?: boolean; scope?: HotkeyScope }\n    return { enabled: v.enabled ?? true, handlers: v.handlers ?? {}, scope: v.scope ?? 'global' }\n  }\n  return { enabled: true, handlers: value as HotkeyMap, scope: 'global' as HotkeyScope }\n}\n\nfunction normalizeKeyToken(token: string): string {\n  const t = token.trim().toLowerCase()\n  if (t === 'esc') return 'Escape'\n  if (t === 'escape') return 'Escape'\n  if (t === 'space') return ' '\n  if (t.length === 1) return t\n  return token.trim()\n}\n\nfunction parseHotkeys(map: HotkeyMap): ParsedHotkey[] {\n  const parsed: ParsedHotkey[] = []\n\n  for (const [combo, entry] of Object.entries(map)) {\n    const parts = combo\n      .split('+')\n      .map(p => p.trim())\n      .filter(Boolean)\n\n    if (!parts.length) continue\n\n    let ctrl = false\n    let meta = false\n    let alt = false\n    let shift = false\n\n    const keyToken = parts.at(-1)\n    if (!keyToken) continue\n    for (const p of parts.slice(0, -1)) {\n      const t = p.toLowerCase()\n      if (t === 'ctrl' || t === 'control') ctrl = true\n      else if (t === 'meta' || t === 'cmd' || t === 'command' || t === '⌘') meta = true\n      else if (t === 'alt' || t === 'option') alt = true\n      else if (t === 'shift') shift = true\n    }\n\n    const key = normalizeKeyToken(keyToken)\n    parsed.push({ original: combo, key, ctrl, meta, alt, shift, entry })\n  }\n\n  return parsed\n}\n\nfunction matchesHotkey(event: KeyboardEvent, hk: ParsedHotkey): boolean {\n  if (hk.ctrl !== event.ctrlKey) return false\n  if (hk.meta !== event.metaKey) return false\n  if (hk.alt !== event.altKey) return false\n  if (!shiftSatisfied(event, hk.key, hk.shift)) return false\n\n  // По физическому коду матчатся только комбинации с модификаторами: там\n  // клавиша — позиция на клавиатуре, и `Ctrl+K` обязан работать на любой\n  // раскладке. Одиночная клавиша — печатная, её раскладка и определяет.\n  return eventMatchesKey(event, hk.key, { codeFallback: hk.ctrl || hk.meta || hk.alt })\n}\n\nfunction resolveEntry(entry: HotkeyEntry) {\n  if (typeof entry === 'function') {\n    return {\n      handler: entry,\n      preventDefault: undefined as boolean | undefined,\n      stopPropagation: false,\n      allowInEditable: false,\n    }\n  }\n\n  return {\n    handler: entry.handler,\n    preventDefault: entry.preventDefault,\n    stopPropagation: entry.stopPropagation ?? false,\n    allowInEditable: entry.allowInEditable ?? false,\n  }\n}\n\n/**\n * `v-hotkey` — горячие клавиши на компонент/страницу.\n *\n * Пример:\n * ```vue\n * <div v-hotkey=\"{ 'Escape': close, 'Ctrl+K': openSearch }\" />\n * ```\n *\n * По умолчанию слушатель глобальный (`window`). Чтобы хоткеи срабатывали только\n * когда фокус внутри элемента, используйте `scope: 'element'`:\n * ```vue\n * <div tabindex=\"0\" v-hotkey=\"{ handlers: { 'j': next }, scope: 'element' }\" />\n * ```\n */\nexport const vHotkey: Directive<HTMLElement, HotkeyBindingValue> = {\n  mounted(el, binding) {\n    if (typeof window === 'undefined') return\n\n    const { enabled, handlers, scope } = normalizeBinding(binding.value)\n    const target: Window | HTMLElement = scope === 'element' ? el : window\n\n    const state: InternalState = {\n      enabled,\n      hotkeys: parseHotkeys(handlers),\n      listener: (event: KeyboardEvent) => {\n        const current = states.get(el)\n        if (!current?.enabled) return\n        if (!el.isConnected) return\n        // Клавиша во время IME-композиции принадлежит композиции, а не хоткею.\n        if (isComposingEvent(event)) return\n\n        const editable = isEditableTarget(event.target)\n\n        for (const hk of current.hotkeys) {\n          if (!matchesHotkey(event, hk)) continue\n\n          const entry = resolveEntry(hk.entry)\n\n          // По умолчанию не перехватываем \"простые\" клавиши во время ввода.\n          const hasModifier = hk.ctrl || hk.meta || hk.alt || hk.shift\n          if (editable && !entry.allowInEditable && !hasModifier && hk.key !== 'Escape') {\n            continue\n          }\n\n          const preventDefault = entry.preventDefault ?? (hk.ctrl || hk.meta || hk.alt)\n          if (preventDefault) event.preventDefault()\n          if (entry.stopPropagation) event.stopPropagation()\n\n          entry.handler(event)\n          return\n        }\n      },\n      target,\n    }\n\n    states.set(el, state)\n    target.addEventListener('keydown', state.listener as EventListener)\n  },\n  updated(el, binding) {\n    const state = states.get(el)\n    if (!state) return\n\n    const next = normalizeBinding(binding.value)\n    state.enabled = next.enabled\n    state.hotkeys = parseHotkeys(next.handlers)\n\n    // Смена scope на лету — переносим слушатель на новую цель.\n    const nextTarget: Window | HTMLElement = next.scope === 'element' ? el : window\n    if (nextTarget !== state.target) {\n      state.target.removeEventListener('keydown', state.listener as EventListener)\n      state.target = nextTarget\n      nextTarget.addEventListener('keydown', state.listener as EventListener)\n    }\n  },\n  unmounted(el) {\n    const state = states.get(el)\n    if (!state) return\n    state.target.removeEventListener('keydown', state.listener as EventListener)\n    states.delete(el)\n  },\n}\n"],"mappings":"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"}
+{"version":3,"file":"hotkey.js","names":[],"sources":["../../src/directives/hotkey.ts"],"sourcesContent":["import type { Directive } from 'vue'\n\nimport { eventMatchesKey, isAppleDevice, isComposingEvent, isEditableTarget, shiftSatisfied } from '../internal/keyboard'\n\nexport type HotkeyHandler = (event: KeyboardEvent) => void\n\nexport type HotkeyEntry =\n  | HotkeyHandler\n  | {\n      handler: HotkeyHandler\n      /** По умолчанию: `true` для комбинаций с Ctrl/Meta/Alt, иначе `false`. */\n      preventDefault?: boolean\n      /** По умолчанию `false`. */\n      stopPropagation?: boolean\n      /** Разрешить срабатывать, когда фокус в `input/textarea/[contenteditable]`. */\n      allowInEditable?: boolean\n    }\n\nexport type HotkeyMap = Record<string, HotkeyEntry>\n\n/**\n * Где слушать клавиатуру:\n * - `'global'` (по умолчанию) — слушатель на `window`; хоткеи работают из любого места страницы.\n * - `'element'` — слушатель на самом элементе; хоткеи срабатывают только когда фокус внутри\n *   элемента (событие всплывает до него). Элемент должен быть фокусируемым (`tabindex`).\n */\nexport type HotkeyScope = 'global' | 'element'\n\nexport type HotkeyBindingValue =\n  | HotkeyMap\n  | {\n      handlers: HotkeyMap\n      enabled?: boolean\n      scope?: HotkeyScope\n    }\n\ntype ParsedHotkey = {\n  original: string\n  key: string\n  ctrl: boolean\n  meta: boolean\n  /** `mod` — Cmd на macOS, Ctrl на прочих: подсказка и привязка пишутся одинаково. */\n  mod: boolean\n  alt: boolean\n  shift: boolean\n  entry: HotkeyEntry\n}\n\ntype InternalState = {\n  enabled: boolean\n  hotkeys: ParsedHotkey[]\n  listener: (event: KeyboardEvent) => void\n  /** Цель, на которой висит слушатель (`window` для 'global', сам `el` для 'element'). */\n  target: Window | HTMLElement\n}\n\nconst states = new WeakMap<HTMLElement, InternalState>()\n\nfunction normalizeBinding(value: HotkeyBindingValue | undefined) {\n  if (!value) return { enabled: false, handlers: {} as HotkeyMap, scope: 'global' as HotkeyScope }\n  if ('handlers' in (value as any)) {\n    const v = value as { handlers: HotkeyMap; enabled?: boolean; scope?: HotkeyScope }\n    return { enabled: v.enabled ?? true, handlers: v.handlers ?? {}, scope: v.scope ?? 'global' }\n  }\n  return { enabled: true, handlers: value as HotkeyMap, scope: 'global' as HotkeyScope }\n}\n\nfunction normalizeKeyToken(token: string): string {\n  const t = token.trim().toLowerCase()\n  if (t === 'esc') return 'Escape'\n  if (t === 'escape') return 'Escape'\n  if (t === 'space') return ' '\n  if (t.length === 1) return t\n  return token.trim()\n}\n\nfunction parseHotkeys(map: HotkeyMap): ParsedHotkey[] {\n  const parsed: ParsedHotkey[] = []\n\n  for (const [combo, entry] of Object.entries(map)) {\n    const parts = combo\n      .split('+')\n      .map(p => p.trim())\n      .filter(Boolean)\n\n    if (!parts.length) continue\n\n    let ctrl = false\n    let meta = false\n    let mod = false\n    let alt = false\n    let shift = false\n\n    const keyToken = parts.at(-1)\n    if (!keyToken) continue\n    for (const p of parts.slice(0, -1)) {\n      const t = p.toLowerCase()\n      if (t === 'mod') mod = true\n      else if (t === 'ctrl' || t === 'control') ctrl = true\n      else if (t === 'meta' || t === 'cmd' || t === 'command' || t === '⌘') meta = true\n      else if (t === 'alt' || t === 'option') alt = true\n      else if (t === 'shift') shift = true\n    }\n\n    const key = normalizeKeyToken(keyToken)\n    parsed.push({ original: combo, key, ctrl, meta, mod, alt, shift, entry })\n  }\n\n  return parsed\n}\n\nfunction matchesHotkey(event: KeyboardEvent, hk: ParsedHotkey): boolean {\n  // Платформа читается в момент события: `navigator` в теле модуля на сервере\n  // либо отсутствует, либо отвечает не за ту машину.\n  const apple = hk.mod ? isAppleDevice() : false\n  const expectMeta = hk.meta || (hk.mod && apple)\n  const expectCtrl = hk.ctrl || (hk.mod && !apple)\n\n  if (expectCtrl !== event.ctrlKey) return false\n  if (expectMeta !== event.metaKey) return false\n  if (hk.alt !== event.altKey) return false\n  if (!shiftSatisfied(event, hk.key, hk.shift)) return false\n\n  // По физическому коду матчатся только комбинации с модификаторами: там\n  // клавиша — позиция на клавиатуре, и `Ctrl+K` обязан работать на любой\n  // раскладке. Одиночная клавиша — печатная, её раскладка и определяет.\n  return eventMatchesKey(event, hk.key, { codeFallback: expectCtrl || expectMeta || hk.alt })\n}\n\nfunction resolveEntry(entry: HotkeyEntry) {\n  if (typeof entry === 'function') {\n    return {\n      handler: entry,\n      preventDefault: undefined as boolean | undefined,\n      stopPropagation: false,\n      allowInEditable: false,\n    }\n  }\n\n  return {\n    handler: entry.handler,\n    preventDefault: entry.preventDefault,\n    stopPropagation: entry.stopPropagation ?? false,\n    allowInEditable: entry.allowInEditable ?? false,\n  }\n}\n\n/**\n * `v-hotkey` — горячие клавиши на компонент/страницу.\n *\n * Пример:\n * ```vue\n * <div v-hotkey=\"{ 'Escape': close, 'Ctrl+K': openSearch }\" />\n * ```\n *\n * По умолчанию слушатель глобальный (`window`). Чтобы хоткеи срабатывали только\n * когда фокус внутри элемента, используйте `scope: 'element'`:\n * ```vue\n * <div tabindex=\"0\" v-hotkey=\"{ handlers: { 'j': next }, scope: 'element' }\" />\n * ```\n */\nexport const vHotkey: Directive<HTMLElement, HotkeyBindingValue> = {\n  mounted(el, binding) {\n    if (typeof window === 'undefined') return\n\n    const { enabled, handlers, scope } = normalizeBinding(binding.value)\n    const target: Window | HTMLElement = scope === 'element' ? el : window\n\n    const state: InternalState = {\n      enabled,\n      hotkeys: parseHotkeys(handlers),\n      listener: (event: KeyboardEvent) => {\n        const current = states.get(el)\n        if (!current?.enabled) return\n        if (!el.isConnected) return\n        // Клавиша во время IME-композиции принадлежит композиции, а не хоткею.\n        if (isComposingEvent(event)) return\n\n        const editable = isEditableTarget(event.target)\n\n        for (const hk of current.hotkeys) {\n          if (!matchesHotkey(event, hk)) continue\n\n          const entry = resolveEntry(hk.entry)\n\n          // По умолчанию не перехватываем \"простые\" клавиши во время ввода.\n          const hasModifier = hk.ctrl || hk.meta || hk.mod || hk.alt || hk.shift\n          if (editable && !entry.allowInEditable && !hasModifier && hk.key !== 'Escape') {\n            continue\n          }\n\n          const preventDefault = entry.preventDefault ?? (hk.ctrl || hk.meta || hk.mod || hk.alt)\n          if (preventDefault) event.preventDefault()\n          if (entry.stopPropagation) event.stopPropagation()\n\n          entry.handler(event)\n          return\n        }\n      },\n      target,\n    }\n\n    states.set(el, state)\n    target.addEventListener('keydown', state.listener as EventListener)\n  },\n  updated(el, binding) {\n    const state = states.get(el)\n    if (!state) return\n\n    const next = normalizeBinding(binding.value)\n    state.enabled = next.enabled\n    state.hotkeys = parseHotkeys(next.handlers)\n\n    // Смена scope на лету — переносим слушатель на новую цель.\n    const nextTarget: Window | HTMLElement = next.scope === 'element' ? el : window\n    if (nextTarget !== state.target) {\n      state.target.removeEventListener('keydown', state.listener as EventListener)\n      state.target = nextTarget\n      nextTarget.addEventListener('keydown', state.listener as EventListener)\n    }\n  },\n  unmounted(el) {\n    const state = states.get(el)\n    if (!state) return\n    state.target.removeEventListener('keydown', state.listener as EventListener)\n    states.delete(el)\n  },\n}\n"],"mappings":"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"}

package/dist/directives/loading.js

@@ -1,4 +1,4 @@
-import { t as ensurePortalRoot } from "../chunks/portalRoot-CWD4zHBm.js";
+import { t as ensurePortalRoot } from "../chunks/portalRoot-CVhCgdG6.js";
 import { n as markInert, t as inertableOutside } from "../chunks/inert-DIHCCn_1.js";
 import { t as GrLoading_default } from "../components/GrLoading/chunks/GrLoading-CH95CFzS.js";
 import { createVNode, render } from "vue";

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-CtrXGa7c.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-C6uAujdJ.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-CtrXGa7c.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-C6uAujdJ.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-Bv8vvqdT.js";
+import { n as ru, r as en, t as es } from "../chunks/es-DGMHwknJ.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-Bv8vvqdT.js";
+import { i as GRANULARITY_I18N_BLOCK, n as ru, r as en, t as es } from "../chunks/es-DGMHwknJ.js";
 export { GRANULARITY_I18N_BLOCK, GRANULARITY_I18N_KEY, en, es, ru };