@feugene/granularity 0.12.0 → 0.16.0

package/dist/chunks/useOverlayLayer-BupuP_hs.js

@@ -0,0 +1,149 @@
+import { n as isComposingEvent } from "./keyboard-zYvvyHd4.js";
+import { nextTick, onUnmounted, watch } from "vue";
+//#region src/composables/internal/overlayStack.ts
+/**
+* Единый стек слоёв оверлеев: модалки, drawer'ы, просмотрщик, панели селектов,
+* дропдауны, подсказки — всё, что открывается поверх страницы.
+*
+* Список один, и порядок регистрации совпадает с порядком открытия, но из него
+* выводятся **две разные вершины**:
+*
+*  - **Esc** → последний слой любого рода. Дропдаун, открытый внутри модалки,
+*    обязан закрыться первым — пользователь видит верхним именно его.
+*  - **`inert`** → ставится на модальные слои ниже последнего **модального**.
+*    Немодальный слой сверху модалку не понижает: иначе окно ушло бы в `inert`
+*    вместе со своим же открытым дропдауном и перестало отвечать.
+*
+* Вести эти две вершины в двух независимых реестрах нельзя: реестры описывают
+* один и тот же порядок и расходятся молча — достаточно оверлея, который
+* зарегистрировался в одном и забыл про другой.
+*
+* Ловушку фокуса стек не реализует сам, но питает её (`useFocusTrap`): он
+* видит слои из **разных деревьев рендера** (диалоги `useDialogService`
+* монтируются отдельным `render()` в `body`) и знает их корни.
+*/
+var stack = [];
+var listening = false;
+var nextId = 1;
+/** Пересчитывает верхний **модальный** слой и уведомляет все модальные. */
+function syncTopmost() {
+	const modals = stack.filter((layer) => layer.modal);
+	const top = modals[modals.length - 1];
+	for (const layer of modals) layer.setTopmost?.(layer === top);
+}
+function handleKeydown(event) {
+	if (event.key !== "Escape") return;
+	if (isComposingEvent(event)) return;
+	if (stack.length === 0) return;
+	const top = stack[stack.length - 1];
+	event.preventDefault();
+	event.stopPropagation();
+	if (typeof event.stopImmediatePropagation === "function") event.stopImmediatePropagation();
+	if (top.shouldClose()) top.close();
+}
+function startListening() {
+	if (listening) return;
+	if (typeof window === "undefined") return;
+	window.addEventListener("keydown", handleKeydown, true);
+	listening = true;
+}
+function stopListening() {
+	if (!listening) return;
+	if (typeof window === "undefined") return;
+	window.removeEventListener("keydown", handleKeydown, true);
+	listening = false;
+}
+/** Регистрирует слой как верхний и возвращает его id. */
+function pushOverlayLayer(layer) {
+	const id = nextId++;
+	stack.push({
+		...layer,
+		id
+	});
+	startListening();
+	syncTopmost();
+	return id;
+}
+/** Снимает слой со стека (при закрытии или размонтировании). */
+function removeOverlayLayer(id) {
+	const index = stack.findIndex((item) => item.id === id);
+	if (index >= 0) stack.splice(index, 1);
+	if (stack.length === 0) stopListening();
+	syncTopmost();
+}
+/**
+* Корни слоёв, открытых **поверх** данного.
+*
+* Ими ловушка фокуса дополняет свой контейнер: всё, что открыто изнутри слоя
+* (панель селекта, меню, подсказка), лежит в `body` отдельным поддеревом, и
+* без этого списка ловушка утаскивала бы из него фокус обратно в окно.
+*/
+function layerRootsAbove(id) {
+	const index = stack.findIndex((layer) => layer.id === id);
+	if (index < 0) return [];
+	return stack.slice(index + 1).map((layer) => layer.root?.() ?? null).filter((root) => root !== null);
+}
+//#endregion
+//#region src/composables/useOverlayLayer.ts
+/**
+* Регистрирует оверлей в общем стеке слоёв, пока `open` истинно.
+*
+* Один контракт на порядок Esc, `inert` и возврат фокуса — три механизма,
+* которые обязаны видеть один и тот же порядок слоёв. Что берёт на себя:
+*
+*  - **Esc** — верхнему слою, вниз не проваливается;
+*  - **`inert`** — через `onTopmostChange` у модальных слоёв;
+*  - **возврат фокуса** — по единому правилу (см. ниже).
+*
+* Чего **не** делает: фокус-ловушку — это `useFocusTrap`, отдельный примитив.
+* Поповеру ловушка и не нужна: Tab обязан уводить фокус наружу и закрывать его,
+* поэтому связка «слой + ловушка» собирается в компоненте, а не тут.
+*
+* Правило возврата фокуса: восстанавливаем, **только если на момент закрытия
+* фокус всё ещё внутри слоя**. Если пользователь кликнул в другое поле, фокус
+* уже там — забирать его обратно нельзя. Эвристика «возвращать, если открыли с
+* клавиатуры» промахивается в обе стороны: мышью открытый слой фокус не вернёт,
+* а клавиатурный отберёт его у того, куда пользователь ушёл сам.
+*/
+function useOverlayLayer(open, onDismiss, options = {}) {
+	let layerId = null;
+	let previouslyFocused = null;
+	function register() {
+		if (layerId !== null) return;
+		if (typeof window === "undefined") return;
+		if (options.restoreFocus !== false && typeof document !== "undefined") previouslyFocused = document.activeElement ?? null;
+		layerId = pushOverlayLayer({
+			modal: typeof options.modal === "function" ? options.modal() : options.modal ?? false,
+			shouldClose: () => options.closeOnEscape?.() ?? true,
+			close: onDismiss,
+			setTopmost: options.onTopmostChange,
+			root: () => options.root?.value ?? null
+		});
+	}
+	function unregister() {
+		if (layerId === null) return;
+		removeOverlayLayer(layerId);
+		layerId = null;
+		restoreFocus();
+	}
+	function restoreFocus() {
+		const target = previouslyFocused;
+		previouslyFocused = null;
+		if (options.restoreFocus === false || !target) return;
+		if (typeof document === "undefined") return;
+		const active = document.activeElement;
+		const root = options.root?.value;
+		if (root && active && active !== document.body && !root.contains(active)) return;
+		nextTick(() => {
+			if (target.isConnected) target.focus?.();
+		});
+	}
+	watch(open, (isOpen) => {
+		if (isOpen) register();
+		else unregister();
+	}, { immediate: true });
+	onUnmounted(unregister);
+	return { rootsAbove: () => layerId === null ? [] : layerRootsAbove(layerId) };
+}
+//#endregion
+export { useOverlayLayer as t };

package/dist/chunks/useOverlayLayer-BupuP_hs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOverlayLayer-BupuP_hs.js","names":[],"sources":["../../src/composables/internal/overlayStack.ts","../../src/composables/useOverlayLayer.ts"],"sourcesContent":["/**\n * Единый стек слоёв оверлеев: модалки, drawer'ы, просмотрщик, панели селектов,\n * дропдауны, подсказки — всё, что открывается поверх страницы.\n *\n * Список один, и порядок регистрации совпадает с порядком открытия, но из него\n * выводятся **две разные вершины**:\n *\n *  - **Esc** → последний слой любого рода. Дропдаун, открытый внутри модалки,\n *    обязан закрыться первым — пользователь видит верхним именно его.\n *  - **`inert`** → ставится на модальные слои ниже последнего **модального**.\n *    Немодальный слой сверху модалку не понижает: иначе окно ушло бы в `inert`\n *    вместе со своим же открытым дропдауном и перестало отвечать.\n *\n * Вести эти две вершины в двух независимых реестрах нельзя: реестры описывают\n * один и тот же порядок и расходятся молча — достаточно оверлея, который\n * зарегистрировался в одном и забыл про другой.\n *\n * Ловушку фокуса стек не реализует сам, но питает её (`useFocusTrap`): он\n * видит слои из **разных деревьев рендера** (диалоги `useDialogService`\n * монтируются отдельным `render()` в `body`) и знает их корни.\n */\n\nimport { isComposingEvent } from '../../internal/keyboard'\n\nexport interface OverlayLayer {\n  /** Уникальный id зарегистрированного слоя. */\n  id: number\n  /**\n   * Модальный слой: блокирует страницу и участвует в вычислении `inert`.\n   * Немодальные (поповеры, меню, подсказки) — только в очереди Esc.\n   */\n  modal: boolean\n  /** Закрывать ли слой по Esc (реактивный геттер: `closeOnEsc` и подобные). */\n  shouldClose: () => boolean\n  /** Закрыть слой. */\n  close: () => void\n  /** Уведомление «этот модальный слой сейчас верхний». Только для `modal`. */\n  setTopmost?: (isTopmost: boolean) => void\n  /**\n   * Корень слоя. Ловушка фокуса нижнего слоя обязана считать его своим:\n   * панель селекта, открытого внутри модалки, телепортирована в `body` и лежит\n   * вне DOM-поддерева окна, но для пользователя это тот же слой.\n   */\n  root?: () => HTMLElement | null\n}\n\nconst stack: OverlayLayer[] = []\nlet listening = false\nlet nextId = 1\n\n/** Пересчитывает верхний **модальный** слой и уведомляет все модальные. */\nfunction syncTopmost(): void {\n  const modals = stack.filter(layer => layer.modal)\n  const top = modals[modals.length - 1]\n  for (const layer of modals) layer.setTopmost?.(layer === top)\n}\n\nfunction handleKeydown(event: KeyboardEvent): void {\n  if (event.key !== 'Escape') return\n  // Esc во время IME-композиции отменяет её, а не закрывает слой.\n  if (isComposingEvent(event)) return\n  if (stack.length === 0) return\n\n  const top = stack[stack.length - 1]\n\n  // Гасим всегда, даже если верхний слой не закрывается по Esc: иначе нажатие\n  // «провалится» на слой ниже и закроет не то, что видит пользователь.\n  event.preventDefault()\n  event.stopPropagation()\n  if (typeof event.stopImmediatePropagation === 'function')\n    event.stopImmediatePropagation()\n\n  if (top.shouldClose()) top.close()\n}\n\nfunction startListening(): void {\n  if (listening) return\n  if (typeof window === 'undefined') return\n  // Capture-фаза опережает любые локальные обработчики: Esc обязан достаться\n  // верхнему слою, а не тому, кто первым подписался.\n  window.addEventListener('keydown', handleKeydown, true)\n  listening = true\n}\n\nfunction stopListening(): void {\n  if (!listening) return\n  if (typeof window === 'undefined') return\n  window.removeEventListener('keydown', handleKeydown, true)\n  listening = false\n}\n\n/** Регистрирует слой как верхний и возвращает его id. */\nexport function pushOverlayLayer(layer: Omit<OverlayLayer, 'id'>): number {\n  const id = nextId++\n  stack.push({ ...layer, id })\n  startListening()\n  syncTopmost()\n  return id\n}\n\n/** Снимает слой со стека (при закрытии или размонтировании). */\nexport function removeOverlayLayer(id: number): void {\n  const index = stack.findIndex(item => item.id === id)\n  if (index >= 0) stack.splice(index, 1)\n  if (stack.length === 0) stopListening()\n  syncTopmost()\n}\n\n/**\n * Корни слоёв, открытых **поверх** данного.\n *\n * Ими ловушка фокуса дополняет свой контейнер: всё, что открыто изнутри слоя\n * (панель селекта, меню, подсказка), лежит в `body` отдельным поддеревом, и\n * без этого списка ловушка утаскивала бы из него фокус обратно в окно.\n */\nexport function layerRootsAbove(id: number): HTMLElement[] {\n  const index = stack.findIndex(layer => layer.id === id)\n  if (index < 0) return []\n\n  return stack\n    .slice(index + 1)\n    .map(layer => layer.root?.() ?? null)\n    .filter((root): root is HTMLElement => root !== null)\n}\n\n/** Корни всех зарегистрированных слоёв. */\nexport function allLayerRoots(): HTMLElement[] {\n  return stack\n    .map(layer => layer.root?.() ?? null)\n    .filter((root): root is HTMLElement => root !== null)\n}\n\n/** Сколько слоёв открыто. Для тестов и диагностики. */\nexport function overlayStackSize(): number {\n  return stack.length\n}\n\n/** Тестовая/служебная очистка стека. */\nexport function resetOverlayStack(): void {\n  stack.splice(0, stack.length)\n  stopListening()\n}\n","import type { Ref } from 'vue'\nimport { nextTick, onUnmounted, watch } from 'vue'\n\nimport { layerRootsAbove, pushOverlayLayer, removeOverlayLayer } from './internal/overlayStack'\n\nexport interface UseOverlayLayerOptions {\n  /**\n   * Модальный слой: блокирует страницу, и модалки под ним получают `inert`.\n   * Немодальные (поповеры, меню, подсказки) участвуют только в очереди Esc.\n   * По умолчанию `false`.\n   *\n   * Геттером — там, где модальность включается пропом (`GrDrawer`): значение\n   * читается в момент регистрации, то есть при каждом открытии.\n   */\n  modal?: boolean | (() => boolean)\n  /**\n   * Закрывать ли слой по Esc. Геттер, а не значение, — чтобы читать реактивный\n   * проп (`closeOnEsc`). По умолчанию закрывается всегда.\n   *\n   * Если геттер вернёт `false`, нажатие всё равно не пройдёт на слой ниже:\n   * пользователь видит верхним этот слой, и Esc адресован ему.\n   */\n  closeOnEscape?: () => boolean\n  /**\n   * Уведомление «этот модальный слой сейчас верхний». Компонент вешает по нему\n   * `inert` на свой корень, когда перестал быть верхним.\n   */\n  onTopmostChange?: (isTopmost: boolean) => void\n  /**\n   * Возвращать фокус элементу, который был активен до открытия. По умолчанию —\n   * да. Отключать имеет смысл там, где фокус с триггера и не уходил: `GrSelect`\n   * ведёт список через `aria-activedescendant`.\n   */\n  restoreFocus?: boolean\n  /**\n   * Корень слоя. Нужен дважды: для правила возврата фокуса (если на момент\n   * закрытия фокус уже вне слоя, пользователь ушёл сам — забирать нельзя) и\n   * для ловушки фокуса слоя под ним, которая обязана считать этот корень\n   * своим (панель селекта внутри модалки телепортирована в `body`).\n   */\n  root?: Ref<HTMLElement | null>\n}\n\nexport interface OverlayLayerHandle {\n  /**\n   * Корни слоёв, открытых поверх этого. Передаётся в `useFocusTrap` как\n   * `containers`: пока панель, открытая изнутри окна, жива, фокус в ней\n   * законен.\n   */\n  rootsAbove: () => HTMLElement[]\n}\n\n/**\n * Регистрирует оверлей в общем стеке слоёв, пока `open` истинно.\n *\n * Один контракт на порядок Esc, `inert` и возврат фокуса — три механизма,\n * которые обязаны видеть один и тот же порядок слоёв. Что берёт на себя:\n *\n *  - **Esc** — верхнему слою, вниз не проваливается;\n *  - **`inert`** — через `onTopmostChange` у модальных слоёв;\n *  - **возврат фокуса** — по единому правилу (см. ниже).\n *\n * Чего **не** делает: фокус-ловушку — это `useFocusTrap`, отдельный примитив.\n * Поповеру ловушка и не нужна: Tab обязан уводить фокус наружу и закрывать его,\n * поэтому связка «слой + ловушка» собирается в компоненте, а не тут.\n *\n * Правило возврата фокуса: восстанавливаем, **только если на момент закрытия\n * фокус всё ещё внутри слоя**. Если пользователь кликнул в другое поле, фокус\n * уже там — забирать его обратно нельзя. Эвристика «возвращать, если открыли с\n * клавиатуры» промахивается в обе стороны: мышью открытый слой фокус не вернёт,\n * а клавиатурный отберёт его у того, куда пользователь ушёл сам.\n */\nexport function useOverlayLayer(\n  open: Ref<boolean>,\n  onDismiss: () => void,\n  options: UseOverlayLayerOptions = {},\n): OverlayLayerHandle {\n  let layerId: number | null = null\n  let previouslyFocused: HTMLElement | null = null\n\n  function register(): void {\n    if (layerId !== null) return\n\n    // Стек — браузерное понятие: Esc, `inert` и возврат фокуса на сервере\n    // бессмысленны. Регистрируйся слой и там — он остался бы в модульном массиве\n    // навсегда, потому что `onUnmounted` при `renderToString` не вызывается, и\n    // каждый серверный рендер открытого оверлея копил бы замыкание со ссылками\n    // на свои компоненты.\n    if (typeof window === 'undefined') return\n\n    if (options.restoreFocus !== false && typeof document !== 'undefined')\n      previouslyFocused = (document.activeElement as HTMLElement) ?? null\n\n    layerId = pushOverlayLayer({\n      modal: typeof options.modal === 'function' ? options.modal() : options.modal ?? false,\n      shouldClose: () => options.closeOnEscape?.() ?? true,\n      close: onDismiss,\n      setTopmost: options.onTopmostChange,\n      root: () => options.root?.value ?? null,\n    })\n  }\n\n  function unregister(): void {\n    if (layerId === null) return\n    removeOverlayLayer(layerId)\n    layerId = null\n\n    restoreFocus()\n  }\n\n  function restoreFocus(): void {\n    const target = previouslyFocused\n    previouslyFocused = null\n\n    if (options.restoreFocus === false || !target) return\n    if (typeof document === 'undefined') return\n\n    // Фокус уже вне слоя — пользователь ушёл сам, отбирать нельзя. Решение\n    // принимаем сейчас, пока слой ещё в DOM, а применяем следующим тиком.\n    const active = document.activeElement\n    const root = options.root?.value\n    if (root && active && active !== document.body && !root.contains(active)) return\n\n    // Возврат откладывается намеренно: ловушка фокуса того же слоя снимает свои\n    // слушатели в этом же флаше, и сфокусируй мы триггер сразу — она затащила бы\n    // фокус обратно в закрывающийся слой.\n    void nextTick(() => {\n      if (target.isConnected) target.focus?.()\n    })\n  }\n\n  watch(\n    open,\n    (isOpen) => {\n      if (isOpen) register()\n      else unregister()\n    },\n    { immediate: true },\n  )\n\n  onUnmounted(unregister)\n\n  return {\n    rootsAbove: () => (layerId === null ? [] : layerRootsAbove(layerId)),\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA8CA,IAAM,QAAwB,CAAC;AAC/B,IAAI,YAAY;AAChB,IAAI,SAAS;;AAGb,SAAS,cAAoB;CAC3B,MAAM,SAAS,MAAM,QAAO,UAAS,MAAM,KAAK;CAChD,MAAM,MAAM,OAAO,OAAO,SAAS;CACnC,KAAK,MAAM,SAAS,QAAQ,MAAM,aAAa,UAAU,GAAG;AAC9D;AAEA,SAAS,cAAc,OAA4B;CACjD,IAAI,MAAM,QAAQ,UAAU;CAE5B,IAAI,iBAAiB,KAAK,GAAG;CAC7B,IAAI,MAAM,WAAW,GAAG;CAExB,MAAM,MAAM,MAAM,MAAM,SAAS;CAIjC,MAAM,eAAe;CACrB,MAAM,gBAAgB;CACtB,IAAI,OAAO,MAAM,6BAA6B,YAC5C,MAAM,yBAAyB;CAEjC,IAAI,IAAI,YAAY,GAAG,IAAI,MAAM;AACnC;AAEA,SAAS,iBAAuB;CAC9B,IAAI,WAAW;CACf,IAAI,OAAO,WAAW,aAAa;CAGnC,OAAO,iBAAiB,WAAW,eAAe,IAAI;CACtD,YAAY;AACd;AAEA,SAAS,gBAAsB;CAC7B,IAAI,CAAC,WAAW;CAChB,IAAI,OAAO,WAAW,aAAa;CACnC,OAAO,oBAAoB,WAAW,eAAe,IAAI;CACzD,YAAY;AACd;;AAGA,SAAgB,iBAAiB,OAAyC;CACxE,MAAM,KAAK;CACX,MAAM,KAAK;EAAE,GAAG;EAAO;CAAG,CAAC;CAC3B,eAAe;CACf,YAAY;CACZ,OAAO;AACT;;AAGA,SAAgB,mBAAmB,IAAkB;CACnD,MAAM,QAAQ,MAAM,WAAU,SAAQ,KAAK,OAAO,EAAE;CACpD,IAAI,SAAS,GAAG,MAAM,OAAO,OAAO,CAAC;CACrC,IAAI,MAAM,WAAW,GAAG,cAAc;CACtC,YAAY;AACd;;;;;;;;AASA,SAAgB,gBAAgB,IAA2B;CACzD,MAAM,QAAQ,MAAM,WAAU,UAAS,MAAM,OAAO,EAAE;CACtD,IAAI,QAAQ,GAAG,OAAO,CAAC;CAEvB,OAAO,MACJ,MAAM,QAAQ,CAAC,CAAC,CAChB,KAAI,UAAS,MAAM,OAAO,KAAK,IAAI,CAAC,CACpC,QAAQ,SAA8B,SAAS,IAAI;AACxD;;;;;;;;;;;;;;;;;;;;;;;ACnDA,SAAgB,gBACd,MACA,WACA,UAAkC,CAAC,GACf;CACpB,IAAI,UAAyB;CAC7B,IAAI,oBAAwC;CAE5C,SAAS,WAAiB;EACxB,IAAI,YAAY,MAAM;EAOtB,IAAI,OAAO,WAAW,aAAa;EAEnC,IAAI,QAAQ,iBAAiB,SAAS,OAAO,aAAa,aACxD,oBAAqB,SAAS,iBAAiC;EAEjE,UAAU,iBAAiB;GACzB,OAAO,OAAO,QAAQ,UAAU,aAAa,QAAQ,MAAM,IAAI,QAAQ,SAAS;GAChF,mBAAmB,QAAQ,gBAAgB,KAAK;GAChD,OAAO;GACP,YAAY,QAAQ;GACpB,YAAY,QAAQ,MAAM,SAAS;EACrC,CAAC;CACH;CAEA,SAAS,aAAmB;EAC1B,IAAI,YAAY,MAAM;EACtB,mBAAmB,OAAO;EAC1B,UAAU;EAEV,aAAa;CACf;CAEA,SAAS,eAAqB;EAC5B,MAAM,SAAS;EACf,oBAAoB;EAEpB,IAAI,QAAQ,iBAAiB,SAAS,CAAC,QAAQ;EAC/C,IAAI,OAAO,aAAa,aAAa;EAIrC,MAAM,SAAS,SAAS;EACxB,MAAM,OAAO,QAAQ,MAAM;EAC3B,IAAI,QAAQ,UAAU,WAAW,SAAS,QAAQ,CAAC,KAAK,SAAS,MAAM,GAAG;EAK1E,eAAoB;GAClB,IAAI,OAAO,aAAa,OAAO,QAAQ;EACzC,CAAC;CACH;CAEA,MACE,OACC,WAAW;EACV,IAAI,QAAQ,SAAS;OAChB,WAAW;CAClB,GACA,EAAE,WAAW,KAAK,CACpB;CAEA,YAAY,UAAU;CAEtB,OAAO,EACL,kBAAmB,YAAY,OAAO,CAAC,IAAI,gBAAgB,OAAO,EACpE;AACF"}

package/dist/chunks/usePortalTarget-RyzEgNTb.js

@@ -0,0 +1,77 @@
+import { s as useGrConfig } from "./context-BSYR7RZs.js";
+import { t as ensurePortalRoot } from "./portalRoot-CWD4zHBm.js";
+import { computed, onMounted, readonly, ref } from "vue";
+//#region src/composables/internal/useTeleportEnabled.ts
+/**
+* Можно ли телепортировать содержимое прямо сейчас.
+*
+* Возвращает `false` на сервере И на первом клиентском рендере, `true` — сразу
+* после монтирования. Использовать так:
+*
+* ```vue
+* <teleport to="body" :disabled="!teleportEnabled">…</teleport>
+* ```
+*
+* ## Зачем, если есть `typeof window !== 'undefined'`
+*
+* Проверка окружения выглядит достаточной, но именно она и ломала гидрацию.
+* `isClient` вычисляется в `setup`, поэтому получалось так:
+*
+* - сервер: `window` нет → телепорт выключен → содержимое остаётся НА МЕСТЕ
+*   (`:disabled` означает «рендерить на месте», а не «не рендерить»);
+* - клиент, первый рендер: `window` есть → телепорт включён → содержимое сразу
+*   уезжает в `body`.
+*
+* Структуры не совпадают, Vue сообщает `Hydration node mismatch`. В лучшем
+* случае это лишний варнинг и осиротевшая копия панели в DOM; в худшем —
+* панель «прилипает» к контейнеру приложения и пишет в него свои стили
+* (`position: fixed` + `display: none` у закрытой панели), после чего страница
+* исчезает целиком.
+*
+* Флаг, поднимаемый в `onMounted`, снимает проблему по построению: **первый**
+* клиентский рендер повторяет серверный, а телепорт включается уже после
+* гидрации. Для компонентов без SSR это ничего не меняет: панели закрыты
+* (`v-show`/`v-if`), а `onMounted` срабатывает в том же тике.
+*
+* Стенд, на котором это воспроизводится и проверяется, — `apps/playground-ssr`.
+*/
+function useTeleportEnabled() {
+	const enabled = ref(false);
+	onMounted(() => {
+		enabled.value = true;
+	});
+	return readonly(enabled);
+}
+//#endregion
+//#region src/composables/usePortalTarget.ts
+/**
+* Куда монтируются оверлеи пакета.
+*
+* Приоритет: локальное переопределение компонента (`teleportTo`) →
+* `portalTarget` из `GrConfigProvider` → общий корень `#gr-portal`, который
+* создаётся при первом обращении.
+*
+* ```vue
+* const { target, enabled } = usePortalTarget(() => props.teleportTo)
+*
+* <teleport :to="target" :disabled="!enabled">…</teleport>
+* ```
+*
+* Композабл публичный: свой оверлей потребителя должен уезжать туда же, куда и
+* оверлеи библиотеки, — иначе он окажется вне ветки портала и будет помечен
+* `inert` вместе со страницей, как только откроется модалка.
+*/
+function usePortalTarget(local) {
+	const config = useGrConfig();
+	const teleportEnabled = useTeleportEnabled();
+	return {
+		target: computed(() => {
+			const explicit = local?.() ?? config.portalTarget?.value;
+			if (explicit) return explicit;
+			return ensurePortalRoot() ?? "body";
+		}),
+		enabled: computed(() => teleportEnabled.value)
+	};
+}
+//#endregion
+export { usePortalTarget as t };

package/dist/chunks/usePortalTarget-RyzEgNTb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePortalTarget-RyzEgNTb.js","names":[],"sources":["../../src/composables/internal/useTeleportEnabled.ts","../../src/composables/usePortalTarget.ts"],"sourcesContent":["import { onMounted, readonly, ref, type Ref } from 'vue'\n\n/**\n * Можно ли телепортировать содержимое прямо сейчас.\n *\n * Возвращает `false` на сервере И на первом клиентском рендере, `true` — сразу\n * после монтирования. Использовать так:\n *\n * ```vue\n * <teleport to=\"body\" :disabled=\"!teleportEnabled\">…</teleport>\n * ```\n *\n * ## Зачем, если есть `typeof window !== 'undefined'`\n *\n * Проверка окружения выглядит достаточной, но именно она и ломала гидрацию.\n * `isClient` вычисляется в `setup`, поэтому получалось так:\n *\n * - сервер: `window` нет → телепорт выключен → содержимое остаётся НА МЕСТЕ\n *   (`:disabled` означает «рендерить на месте», а не «не рендерить»);\n * - клиент, первый рендер: `window` есть → телепорт включён → содержимое сразу\n *   уезжает в `body`.\n *\n * Структуры не совпадают, Vue сообщает `Hydration node mismatch`. В лучшем\n * случае это лишний варнинг и осиротевшая копия панели в DOM; в худшем —\n * панель «прилипает» к контейнеру приложения и пишет в него свои стили\n * (`position: fixed` + `display: none` у закрытой панели), после чего страница\n * исчезает целиком.\n *\n * Флаг, поднимаемый в `onMounted`, снимает проблему по построению: **первый**\n * клиентский рендер повторяет серверный, а телепорт включается уже после\n * гидрации. Для компонентов без SSR это ничего не меняет: панели закрыты\n * (`v-show`/`v-if`), а `onMounted` срабатывает в том же тике.\n *\n * Стенд, на котором это воспроизводится и проверяется, — `apps/playground-ssr`.\n */\nexport function useTeleportEnabled(): Readonly<Ref<boolean>> {\n  const enabled = ref(false)\n\n  onMounted(() => {\n    enabled.value = true\n  })\n\n  return readonly(enabled)\n}\n","import type { ComputedRef } from 'vue'\nimport { computed } from 'vue'\n\nimport { useGrConfig } from '../components/GrConfigProvider/context'\nimport { ensurePortalRoot } from './internal/portalRoot'\nimport { useTeleportEnabled } from './internal/useTeleportEnabled'\n\nexport interface PortalTarget {\n  /** Куда телепортировать: элемент портала либо селектор из конфига. */\n  target: ComputedRef<string | HTMLElement>\n  /**\n   * Можно ли телепортировать прямо сейчас. `false` на сервере и на первом\n   * клиентском рендере — иначе разметка разъедется на гидрации.\n   */\n  enabled: ComputedRef<boolean>\n}\n\n/**\n * Куда монтируются оверлеи пакета.\n *\n * Приоритет: локальное переопределение компонента (`teleportTo`) →\n * `portalTarget` из `GrConfigProvider` → общий корень `#gr-portal`, который\n * создаётся при первом обращении.\n *\n * ```vue\n * const { target, enabled } = usePortalTarget(() => props.teleportTo)\n *\n * <teleport :to=\"target\" :disabled=\"!enabled\">…</teleport>\n * ```\n *\n * Композабл публичный: свой оверлей потребителя должен уезжать туда же, куда и\n * оверлеи библиотеки, — иначе он окажется вне ветки портала и будет помечен\n * `inert` вместе со страницей, как только откроется модалка.\n */\nexport function usePortalTarget(local?: () => string | HTMLElement | undefined): PortalTarget {\n  const config = useGrConfig()\n  const teleportEnabled = useTeleportEnabled()\n\n  const target = computed<string | HTMLElement>(() => {\n    const explicit = local?.() ?? config.portalTarget?.value\n    if (explicit) return explicit\n\n    // Корень создаётся лениво и только на клиенте; до монтирования телепорт\n    // выключен, поэтому `body` здесь — недостижимый запасной вариант, а не\n    // рабочая ветка.\n    return ensurePortalRoot() ?? 'body'\n  })\n\n  return { target, enabled: computed(() => teleportEnabled.value) }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,qBAA6C;CAC3D,MAAM,UAAU,IAAI,KAAK;CAEzB,gBAAgB;EACd,QAAQ,QAAQ;CAClB,CAAC;CAED,OAAO,SAAS,OAAO;AACzB;;;;;;;;;;;;;;;;;;;;ACTA,SAAgB,gBAAgB,OAA8D;CAC5F,MAAM,SAAS,YAAY;CAC3B,MAAM,kBAAkB,mBAAmB;CAY3C,OAAO;EAAE,QAVM,eAAqC;GAClD,MAAM,WAAW,QAAQ,KAAK,OAAO,cAAc;GACnD,IAAI,UAAU,OAAO;GAKrB,OAAO,iBAAiB,KAAK;EAC/B,CAES;EAAQ,SAAS,eAAe,gBAAgB,KAAK;CAAE;AAClE"}

package/dist/chunks/validation-5HhpanPP.js

@@ -0,0 +1,178 @@
+import { a as allowedExtensionsValidator, f as runFileValidators, i as allowedMimeTypesValidator, l as resolveFileValidationMessage, n as maxFileSize, o as acceptValidator, r as maxCountValidator, t as maxTotalSizeBytesValidator } from "./fileValidation-D5TFBhbv.js";
+//#region src/components/GrForm/fileRule.ts
+/**
+* Файловое правило `GrForm` — мост между декларативными `rules` и валидаторами
+* из `src/fileValidation`.
+*
+* Своих проверок здесь нет ни одной: правило собирает те же валидаторы, которые
+* `GrFormFile` и `v-dropzone` запускают на выборе и на drop. Поэтому ограничение,
+* переехавшее из пропов поля в правило формы, не меняет ни поведения, ни текста
+* ошибки — меняется только момент проверки и то, кто о ней сообщает.
+*
+* Модуль чистый (без Vue): его гоняют юнит-тесты без монтирования.
+*/
+var BYTES_IN_MB = 1024 * 1024;
+function mbToBytes(mb) {
+	return typeof mb === "number" && Number.isFinite(mb) ? mb * BYTES_IN_MB : void 0;
+}
+function isFile(value) {
+	return typeof File !== "undefined" && value instanceof File;
+}
+/**
+* Значение поля как набор файлов. Всё, что файлами не является, даёт пустой
+* набор: правило молчит, а пустоту разбирает `required` движка.
+*/
+function fileRuleFiles(value) {
+	if (isFile(value)) return [value];
+	if (Array.isArray(value)) return value.filter(isFile);
+	return [];
+}
+/** Порядок повторяет `GrFormFile`: встроенные проверки, затем валидаторы потребителя. */
+function fileRuleValidators(rule) {
+	return [
+		acceptValidator(rule.accept),
+		...rule.extensions ? [allowedExtensionsValidator(rule.extensions)] : [],
+		...rule.mimeTypes ? [allowedMimeTypesValidator(rule.mimeTypes)] : [],
+		maxFileSize({
+			bytes: rule.maxSizeBytes,
+			mb: rule.maxSizeMb
+		}),
+		maxCountValidator(rule.maxCount),
+		maxTotalSizeBytesValidator(mbToBytes(rule.maxTotalSizeMb)),
+		...rule.validators ?? []
+	];
+}
+/**
+* Первая проблема набора или `undefined`. Первая, а не все: у поля формы одна
+* строка ошибки, и файлы тут не исключение — подробный разбор по каждому файлу
+* остаётся за `GrFormFile`.
+*/
+async function runFileRule(value, rule) {
+	const files = fileRuleFiles(value);
+	if (!files.length) return void 0;
+	const { issues } = await runFileValidators(files, fileRuleValidators(rule), {
+		source: "form",
+		multiple: Array.isArray(value),
+		accept: rule.accept
+	});
+	return issues[0];
+}
+//#endregion
+//#region src/components/GrForm/validation.ts
+/**
+* Движок валидации `GrForm` — чистый (без Vue/i18n), тестируется изолированно.
+*
+* Правило описывает набор проверок значения поля; `runFieldRules` прогоняет их по
+* порядку и возвращает первое сообщение об ошибке (или `undefined`, если валидно).
+* Сообщения резолвит потребитель (компонент) через `resolveMessage` — так i18n и
+* дефолтные тексты остаются в компоненте, а движок ничего о них не знает.
+*/
+var DEFAULT_MESSAGES = {
+	required: "This field is required",
+	min: "Minimum is {min}",
+	max: "Maximum is {max}",
+	len: "Length must be {len}",
+	pattern: "Invalid format",
+	email: "Enter a valid email",
+	url: "Enter a valid URL",
+	file: "Invalid file",
+	invalid: "Invalid value"
+};
+/**
+* Дефолтный резолвер сообщений: `rule.message` сильнее всего, иначе ключ
+* `gr.form.<kind>` из локали, иначе английский фолбэк.
+*
+* Вынесен из `GrForm.vue` и экспортируется наружу не «на всякий случай»:
+* `runFieldRules` публичен, но без резолвера бесполезен — любой, кто хочет
+* прогнать те же правила вне формы, обязан был написать свой.
+*/
+function createGrFormMessageResolver(t) {
+	return (kind, rule, params) => {
+		if (rule.message) return rule.message;
+		const issue = params.issue;
+		if (kind === "file" && issue) return resolveFileValidationMessage(issue, t);
+		return t(`gr.form.${kind}`, DEFAULT_MESSAGES[kind], params);
+	};
+}
+var EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+function isUrl(value) {
+	return URL.canParse(value);
+}
+/** Пустое значение: `null`/`undefined`/пустая (или пробельная) строка/пустой массив. */
+function isEmpty(value) {
+	if (value == null) return true;
+	if (typeof value === "string") return value.trim() === "";
+	if (Array.isArray(value)) return value.length === 0;
+	return false;
+}
+/** Мера значения для min/max/len: число → само значение, строка/массив → длина. */
+function measure(value) {
+	if (typeof value === "number") return value;
+	if (typeof value === "string") return value.length;
+	if (Array.isArray(value)) return value.length;
+	return Number(value);
+}
+/** Достаёт значение из объекта по dot-path (`address.city`). */
+function getByPath(obj, path) {
+	if (!path.includes(".")) return obj[path];
+	return path.split(".").reduce((acc, key) => {
+		if (acc && typeof acc === "object") return acc[key];
+	}, obj);
+}
+/** Записывает значение в объект по dot-path (создаёт промежуточные объекты). */
+function setByPath(obj, path, value) {
+	const keys = path.split(".");
+	const last = keys.pop();
+	let target = obj;
+	for (const key of keys) {
+		if (!target[key] || typeof target[key] !== "object") target[key] = {};
+		target = target[key];
+	}
+	target[last] = value;
+}
+/** Нормализует правило(а) поля в массив. */
+function toRuleArray(rules) {
+	if (!rules) return [];
+	return Array.isArray(rules) ? rules : [rules];
+}
+function ruleMatchesTrigger(rule, trigger) {
+	if (!trigger) return true;
+	if (!rule.trigger) return true;
+	return (Array.isArray(rule.trigger) ? rule.trigger : [rule.trigger]).includes(trigger);
+}
+/** Правила поля, применимые для данного триггера (undefined = все). */
+function rulesForTrigger(rules, trigger) {
+	return rules.filter((rule) => ruleMatchesTrigger(rule, trigger));
+}
+/** Есть ли среди правил `required` (для маркера обязательности в поле). */
+function rulesRequired(rules) {
+	return rules.some((rule) => rule.required === true);
+}
+/**
+* Прогоняет правила по порядку, возвращает первое сообщение об ошибке или `undefined`.
+* Пустое необязательное значение проходит все проверки (кроме `required`).
+*/
+async function runFieldRules(value, rules, model, resolveMessage) {
+	for (const rule of rules) {
+		const empty = isEmpty(value);
+		if (rule.required && empty) return resolveMessage("required", rule, {});
+		if (empty) continue;
+		if (rule.type === "email" && !EMAIL_RE.test(String(value))) return resolveMessage("email", rule, {});
+		if (rule.type === "url" && !isUrl(String(value))) return resolveMessage("url", rule, {});
+		if (rule.len != null && measure(value) !== rule.len) return resolveMessage("len", rule, { len: rule.len });
+		if (rule.min != null && measure(value) < rule.min) return resolveMessage("min", rule, { min: rule.min });
+		if (rule.max != null && measure(value) > rule.max) return resolveMessage("max", rule, { max: rule.max });
+		if (rule.pattern && !rule.pattern.test(String(value))) return resolveMessage("pattern", rule, {});
+		if (rule.file) {
+			const issue = await runFileRule(value, rule.file);
+			if (issue) return resolveMessage("file", rule, { issue });
+		}
+		if (rule.validator) {
+			const result = await rule.validator(value, model);
+			if (result === false) return rule.message ?? resolveMessage("invalid", rule, {});
+			if (typeof result === "string") return result;
+		}
+	}
+}
+//#endregion
+export { rulesRequired as a, toRuleArray as c, rulesForTrigger as i, getByPath as n, runFieldRules as o, isEmpty as r, setByPath as s, createGrFormMessageResolver as t };

package/dist/chunks/validation-5HhpanPP.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-5HhpanPP.js","names":[],"sources":["../../src/components/GrForm/fileRule.ts","../../src/components/GrForm/validation.ts"],"sourcesContent":["/**\n * Файловое правило `GrForm` — мост между декларативными `rules` и валидаторами\n * из `src/fileValidation`.\n *\n * Своих проверок здесь нет ни одной: правило собирает те же валидаторы, которые\n * `GrFormFile` и `v-dropzone` запускают на выборе и на drop. Поэтому ограничение,\n * переехавшее из пропов поля в правило формы, не меняет ни поведения, ни текста\n * ошибки — меняется только момент проверки и то, кто о ней сообщает.\n *\n * Модуль чистый (без Vue): его гоняют юнит-тесты без монтирования.\n */\n\nimport {\n  acceptValidator,\n  allowedExtensionsValidator,\n  allowedMimeTypesValidator,\n  maxCountValidator,\n  maxFileSize,\n  maxTotalSizeBytesValidator,\n  runFileValidators,\n  type FileValidationIssue,\n  type FileValidator,\n} from '../../fileValidation'\n\nexport interface GrFormFileRule {\n  /** W3C `accept`: `'image/*,.pdf'`. */\n  accept?: string\n  /** Белый список расширений (с точкой или без). */\n  extensions?: string[]\n  /** Белый список MIME-типов. */\n  mimeTypes?: string[]\n  /** Предел размера одного файла в мегабайтах. */\n  maxSizeMb?: number\n  /** Предел размера одного файла в байтах. Задан вместе с `maxSizeMb` — берётся меньший. */\n  maxSizeBytes?: number\n  /** Максимум файлов в наборе. */\n  maxCount?: number\n  /** Суммарный размер набора в мегабайтах. */\n  maxTotalSizeMb?: number\n  /** Свои валидаторы — тот же тип, что у `GrFormFile` и `v-dropzone`. Идут после встроенных. */\n  validators?: FileValidator[]\n}\n\nconst BYTES_IN_MB = 1024 * 1024\n\nfunction mbToBytes(mb: number | undefined): number | undefined {\n  return typeof mb === 'number' && Number.isFinite(mb) ? mb * BYTES_IN_MB : undefined\n}\n\nfunction isFile(value: unknown): value is File {\n  return typeof File !== 'undefined' && value instanceof File\n}\n\n/**\n * Значение поля как набор файлов. Всё, что файлами не является, даёт пустой\n * набор: правило молчит, а пустоту разбирает `required` движка.\n */\nexport function fileRuleFiles(value: unknown): File[] {\n  if (isFile(value)) return [value]\n  if (Array.isArray(value)) return value.filter(isFile)\n  return []\n}\n\n/** Порядок повторяет `GrFormFile`: встроенные проверки, затем валидаторы потребителя. */\nexport function fileRuleValidators(rule: GrFormFileRule): FileValidator[] {\n  return [\n    acceptValidator(rule.accept),\n    ...(rule.extensions ? [allowedExtensionsValidator(rule.extensions)] : []),\n    ...(rule.mimeTypes ? [allowedMimeTypesValidator(rule.mimeTypes)] : []),\n    maxFileSize({ bytes: rule.maxSizeBytes, mb: rule.maxSizeMb }),\n    maxCountValidator(rule.maxCount),\n    maxTotalSizeBytesValidator(mbToBytes(rule.maxTotalSizeMb)),\n    ...(rule.validators ?? []),\n  ]\n}\n\n/**\n * Первая проблема набора или `undefined`. Первая, а не все: у поля формы одна\n * строка ошибки, и файлы тут не исключение — подробный разбор по каждому файлу\n * остаётся за `GrFormFile`.\n */\nexport async function runFileRule(\n  value: unknown,\n  rule: GrFormFileRule,\n): Promise<FileValidationIssue | undefined> {\n  const files = fileRuleFiles(value)\n  if (!files.length) return undefined\n\n  const { issues } = await runFileValidators(files, fileRuleValidators(rule), {\n    source: 'form',\n    multiple: Array.isArray(value),\n    accept: rule.accept,\n  })\n\n  return issues[0]\n}\n","/**\n * Движок валидации `GrForm` — чистый (без Vue/i18n), тестируется изолированно.\n *\n * Правило описывает набор проверок значения поля; `runFieldRules` прогоняет их по\n * порядку и возвращает первое сообщение об ошибке (или `undefined`, если валидно).\n * Сообщения резолвит потребитель (компонент) через `resolveMessage` — так i18n и\n * дефолтные тексты остаются в компоненте, а движок ничего о них не знает.\n */\n\nimport { resolveFileValidationMessage, type FileValidationIssue } from '../../fileValidation'\nimport { runFileRule, type GrFormFileRule } from './fileRule'\n\nexport type { GrFormFileRule } from './fileRule'\n\nexport type GrFormTrigger = 'blur' | 'change' | 'submit'\n\n/** Результат кастомного валидатора: `true`/void — ок; `false` — ошибка (дефолт-текст); строка — текст ошибки. */\nexport type GrFormValidatorResult = boolean | string | void\n\nexport interface GrFormRule {\n  /** Значение обязательно (не пустое). */\n  required?: boolean\n  /** Готовый текст ошибки — перекрывает дефолтное сообщение любой проверки этого правила. */\n  message?: string\n  /** Минимум: длина для строки/массива, значение для числа. */\n  min?: number\n  /** Максимум: длина для строки/массива, значение для числа. */\n  max?: number\n  /** Точная длина/значение. */\n  len?: number\n  /** Регулярное выражение (проверяется по `String(value)`). */\n  pattern?: RegExp\n  /** Встроенный тип-валидатор. */\n  type?: 'email' | 'url'\n  /** Ограничения для значения `File | File[]`: тип, размер, количество. */\n  file?: GrFormFileRule\n  /** Кастомный (в т.ч. async) валидатор. Второй аргумент — весь `model`. */\n  validator?: (value: unknown, model: Record<string, unknown>) => GrFormValidatorResult | Promise<GrFormValidatorResult>\n  /** Когда правило срабатывает. По умолчанию — на любом триггере (blur/change/submit). */\n  trigger?: GrFormTrigger | GrFormTrigger[]\n}\n\nexport type GrFormRules = Record<string, GrFormRule | GrFormRule[]>\n\n/** Вид сработавшей проверки — ключ для дефолтного i18n-сообщения. */\nexport type GrFormRuleFailure = 'required' | 'min' | 'max' | 'len' | 'pattern' | 'email' | 'url' | 'file' | 'invalid'\n\nexport type GrFormMessageResolver = (\n  kind: GrFormRuleFailure,\n  rule: GrFormRule,\n  params: Record<string, unknown>,\n) => string\n\n/** Подпись `t()` из `useGranularityTranslations()`: ключ, фолбэк, параметры. */\nexport type GrFormMessageTranslate = (\n  key: string,\n  fallback: string,\n  params?: Record<string, unknown>,\n) => string\n\nconst DEFAULT_MESSAGES: Record<GrFormRuleFailure, string> = {\n  required: 'This field is required',\n  min: 'Minimum is {min}',\n  max: 'Maximum is {max}',\n  len: 'Length must be {len}',\n  pattern: 'Invalid format',\n  email: 'Enter a valid email',\n  url: 'Enter a valid URL',\n  file: 'Invalid file',\n  invalid: 'Invalid value',\n}\n\n/**\n * Дефолтный резолвер сообщений: `rule.message` сильнее всего, иначе ключ\n * `gr.form.<kind>` из локали, иначе английский фолбэк.\n *\n * Вынесен из `GrForm.vue` и экспортируется наружу не «на всякий случай»:\n * `runFieldRules` публичен, но без резолвера бесполезен — любой, кто хочет\n * прогнать те же правила вне формы, обязан был написать свой.\n */\nexport function createGrFormMessageResolver(t: GrFormMessageTranslate): GrFormMessageResolver {\n  return (kind, rule, params) => {\n    if (rule.message) return rule.message\n\n    // Текст файловой ошибки приходит от самого валидатора и локализуется его же\n    // ключом (`gr.fileValidation.*`): иначе одно и то же «файл не того типа»\n    // звучало бы по-разному в поле и в форме. `gr.form.file` — фолбэк на случай\n    // вида `file` без issue: сюда движок не приходит, но резолвер публичный.\n    const issue = params.issue as FileValidationIssue | undefined\n    if (kind === 'file' && issue) return resolveFileValidationMessage(issue, t)\n\n    return t(`gr.form.${kind}`, DEFAULT_MESSAGES[kind], params)\n  }\n}\n\nconst EMAIL_RE = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/\n\nfunction isUrl(value: string): boolean {\n  return URL.canParse(value)\n}\n\n/** Пустое значение: `null`/`undefined`/пустая (или пробельная) строка/пустой массив. */\nexport function isEmpty(value: unknown): boolean {\n  if (value == null) return true\n  if (typeof value === 'string') return value.trim() === ''\n  if (Array.isArray(value)) return value.length === 0\n  return false\n}\n\n/** Мера значения для min/max/len: число → само значение, строка/массив → длина. */\nfunction measure(value: unknown): number {\n  if (typeof value === 'number') return value\n  if (typeof value === 'string') return value.length\n  if (Array.isArray(value)) return value.length\n  return Number(value)\n}\n\n/** Достаёт значение из объекта по dot-path (`address.city`). */\nexport function getByPath(obj: Record<string, unknown>, path: string): unknown {\n  if (!path.includes('.')) return obj[path]\n  return path.split('.').reduce<unknown>((acc, key) => {\n    if (acc && typeof acc === 'object') return (acc as Record<string, unknown>)[key]\n    return undefined\n  }, obj)\n}\n\n/** Записывает значение в объект по dot-path (создаёт промежуточные объекты). */\nexport function setByPath(obj: Record<string, unknown>, path: string, value: unknown): void {\n  const keys = path.split('.')\n  const last = keys.pop() as string\n  let target = obj\n  for (const key of keys) {\n    if (!target[key] || typeof target[key] !== 'object') target[key] = {}\n    target = target[key] as Record<string, unknown>\n  }\n  target[last] = value\n}\n\n/** Нормализует правило(а) поля в массив. */\nexport function toRuleArray(rules: GrFormRule | GrFormRule[] | undefined): GrFormRule[] {\n  if (!rules) return []\n  return Array.isArray(rules) ? rules : [rules]\n}\n\nfunction ruleMatchesTrigger(rule: GrFormRule, trigger?: GrFormTrigger): boolean {\n  if (!trigger) return true // полная валидация (validate()) — все правила\n  if (!rule.trigger) return true // правило без триггера срабатывает на любом\n  const triggers = Array.isArray(rule.trigger) ? rule.trigger : [rule.trigger]\n  return triggers.includes(trigger)\n}\n\n/** Правила поля, применимые для данного триггера (undefined = все). */\nexport function rulesForTrigger(rules: GrFormRule[], trigger?: GrFormTrigger): GrFormRule[] {\n  return rules.filter(rule => ruleMatchesTrigger(rule, trigger))\n}\n\n/** Есть ли среди правил `required` (для маркера обязательности в поле). */\nexport function rulesRequired(rules: GrFormRule[]): boolean {\n  return rules.some(rule => rule.required === true)\n}\n\n/**\n * Прогоняет правила по порядку, возвращает первое сообщение об ошибке или `undefined`.\n * Пустое необязательное значение проходит все проверки (кроме `required`).\n */\nexport async function runFieldRules(\n  value: unknown,\n  rules: GrFormRule[],\n  model: Record<string, unknown>,\n  resolveMessage: GrFormMessageResolver,\n): Promise<string | undefined> {\n  for (const rule of rules) {\n    const empty = isEmpty(value)\n\n    if (rule.required && empty) return resolveMessage('required', rule, {})\n    // Необязательное пустое значение — остальные проверки этого правила пропускаем.\n    if (empty) continue\n\n    if (rule.type === 'email' && !EMAIL_RE.test(String(value))) return resolveMessage('email', rule, {})\n    if (rule.type === 'url' && !isUrl(String(value))) return resolveMessage('url', rule, {})\n\n    if (rule.len != null && measure(value) !== rule.len) return resolveMessage('len', rule, { len: rule.len })\n    if (rule.min != null && measure(value) < rule.min) return resolveMessage('min', rule, { min: rule.min })\n    if (rule.max != null && measure(value) > rule.max) return resolveMessage('max', rule, { max: rule.max })\n\n    if (rule.pattern && !rule.pattern.test(String(value))) return resolveMessage('pattern', rule, {})\n\n    if (rule.file) {\n      const issue = await runFileRule(value, rule.file)\n      if (issue) return resolveMessage('file', rule, { issue })\n    }\n\n    if (rule.validator) {\n      const result = await rule.validator(value, model)\n      if (result === false) return rule.message ?? resolveMessage('invalid', rule, {})\n      if (typeof result === 'string') return result\n    }\n  }\n\n  return undefined\n}\n"],"mappings":"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"}