@ryuzaki13/react-foundation-lib 2.8.1 → 2.10.0

package/dist/query-client/index.js

@@ -1,439 +1,2 @@
-import { i as e } from "../chunks/isRecord-DXDTW-jA.js";
-import { uuidv4 as t } from "../crypto/index.js";
-import { broadcastQueryClient as n } from "@tanstack/query-broadcast-client-experimental";
-import { experimental_createQueryPersister as r } from "@tanstack/query-persist-client-core";
-import { MutationCache as i, QueryCache as a, QueryClient as o } from "@tanstack/react-query";
-//#region src/query-client/broadcast.ts
-var s = null;
-function c(e) {
-	s = e;
-}
-function l(e) {
-	s?.(e);
-}
-function u(e, r) {
-	if (typeof window > "u") return {
-		broadcast: () => {},
-		cleanup: () => {}
-	};
-	let i = !1, a = n({
-		queryClient: e,
-		broadcastChannel: r.queriesChannel
-	}), o = t(), s = new BroadcastChannel(r.eventsChannel), c = e.getQueryCache().subscribe((e) => {
-		i || e.type === "updated" && e.action.type === "invalidate" && l({
-			type: "invalidate",
-			keys: [e.query.queryKey],
-			refetchType: "none"
-		});
-	});
-	s.onmessage = (t) => {
-		let n = t.data;
-		if (!d(n) || n.tabId === o) return;
-		let r = n.event;
-		i = !0;
-		try {
-			if (r.type === "invalidate") {
-				let t = r.refetchType ?? "none";
-				for (let n of r.keys) e.invalidateQueries({
-					queryKey: n,
-					refetchType: t
-				});
-				return;
-			}
-			if (r.type === "setQueryData") {
-				e.setQueryData(r.key, r.data);
-				return;
-			}
-		} finally {
-			i = !1;
-		}
-	};
-	function l(e) {
-		let t = {
-			tabId: o,
-			event: e
-		};
-		s.postMessage(t);
-	}
-	return {
-		broadcast: l,
-		cleanup: () => {
-			c(), a(), s.close();
-		}
-	};
-}
-function d(t) {
-	return !e(t) || typeof t.tabId != "string" || !("event" in t) ? !1 : f(t.event);
-}
-function f(t) {
-	return e(t) ? t.type === "invalidate" ? Array.isArray(t.keys) ? t.refetchType === void 0 || t.refetchType === "none" || t.refetchType === "active" || t.refetchType === "inactive" || t.refetchType === "all" : !1 : t.type === "setQueryData" && "key" in t && "data" in t : !1;
-}
-//#endregion
-//#region src/query-client/invalidationBroadcast.ts
-function p(t) {
-	return e(t) && t.type === "query.invalidate" && typeof t.senderId == "string" && Array.isArray(t.queryKey);
-}
-function m(e, n) {
-	if (typeof window > "u" || typeof BroadcastChannel > "u") return {
-		broadcast: () => void 0,
-		cleanup: () => void 0
-	};
-	let r = t(), i = new BroadcastChannel(n.channelName), a = !1, o = !1, s = (e) => {
-		o || !n.matchesQuery(e) || i.postMessage({
-			type: "query.invalidate",
-			senderId: r,
-			queryKey: e
-		});
-	}, c = e.getQueryCache().subscribe((e) => {
-		a || e.type !== "updated" || e.action.type !== "invalidate" || s(e.query.queryKey);
-	});
-	return i.onmessage = (t) => {
-		let i = t.data;
-		if (!(o || !p(i) || i.senderId === r || !n.matchesQuery(i.queryKey))) {
-			a = !0;
-			try {
-				e.invalidateQueries({
-					queryKey: i.queryKey,
-					exact: !0,
-					refetchType: n.refetchType ?? "active"
-				});
-			} finally {
-				a = !1;
-			}
-		}
-	}, {
-		broadcast: s,
-		cleanup() {
-			o || (o = !0, c(), i.close());
-		}
-	};
-}
-//#endregion
-//#region src/query-client/queryPersistenceAdapter.ts
-var h = {};
-function ee(e) {
-	h = e;
-}
-function g() {
-	return h;
-}
-//#endregion
-//#region src/query-client/persistence.ts
-var _ = "queries", v = "session", y = __REACT_QUERY_PERSISTENCE_BUSTER__, b = 7776e6, x = null;
-function S(e) {
-	if (e) return e;
-	if (globalThis.indexedDB !== void 0) return globalThis.indexedDB;
-}
-function C(e) {
-	return new Promise((t, n) => {
-		e.onsuccess = () => t(e.result), e.onerror = () => n(e.error);
-	});
-}
-function w() {
-	if (__DEV__) return `dev:${__APP_ID__}`;
-	let e = g().resolveSystemIdentifier?.();
-	if (e) return e;
-	let t = typeof window > "u" ? "server" : window.location.hostname;
-	return `${__APP_ID__}:${t}`;
-}
-function T() {
-	return `${w()}`;
-}
-function E(e) {
-	return encodeURIComponent(e);
-}
-function D() {
-	return `${T()}-${v}-`;
-}
-function O(e) {
-	return `${D()}${E(e)}-`;
-}
-function k(e, t) {
-	return `${O(e)}${E(t)}`;
-}
-function A(e) {
-	return !!e?.id.trim() && Number.isFinite(Date.parse(e?.expiresAt ?? "")) && Date.parse(e?.expiresAt ?? "") > Date.now();
-}
-function j() {
-	return A(x) ? x : null;
-}
-async function M(e) {
-	let t = z();
-	if (!t?.entries) return;
-	let n = await t.entries();
-	await Promise.all(n.filter(([t]) => e(t)).map(([e]) => t.removeItem(e)));
-}
-async function N(e) {
-	let t = e === void 0 ? D() : O(e);
-	await M((e) => e.startsWith(t));
-}
-async function P(e) {
-	let t = e && A(e) ? {
-		id: e.id.trim(),
-		expiresAt: e.expiresAt
-	} : null;
-	if (x = t, !t) {
-		await N();
-		return;
-	}
-	let n = O(t.id);
-	await M((e) => e.startsWith(D()) && !e.startsWith(n));
-}
-function F(e) {
-	return e.meta?.persist === !0 && e.meta.sessionScoped !== !0;
-}
-function I(e) {
-	let t = e.meta?.sessionPersistence;
-	if (e.meta?.sessionScoped !== !0 || !t || typeof t != "object" || !("cacheName" in t) || !("maxEntries" in t) || typeof t.cacheName != "string" || !/^[a-z0-9][a-z0-9_-]{0,63}$/u.test(t.cacheName) || !Number.isSafeInteger(t.maxEntries) || t.maxEntries < 1 || t.maxEntries > 5e3) return null;
-	let n = "refetchOnRestore" in t ? t.refetchOnRestore : void 0;
-	if (n !== void 0 && typeof n != "boolean") return null;
-	let r = "monotonicRevisionField" in t ? t.monotonicRevisionField : void 0;
-	return r !== void 0 && (typeof r != "string" || !/^[A-Za-z][A-Za-z0-9_]{0,63}$/u.test(r)) ? null : {
-		cacheName: t.cacheName,
-		maxEntries: t.maxEntries,
-		refetchOnRestore: n,
-		monotonicRevisionField: r
-	};
-}
-function L(e, t) {
-	let n = e.state.data;
-	if (typeof n != "object" || !n || Array.isArray(n)) return null;
-	let r = Reflect.get(n, t);
-	return typeof r != "string" || !/^\d+$/u.test(r) ? null : r.replace(/^0+(?=\d)/u, "");
-}
-function R(e, t) {
-	return e.length === t.length ? e === t ? 0 : e < t ? -1 : 1 : e.length - t.length;
-}
-function z(e = {}) {
-	let t = S(e.indexedDB);
-	if (!t) return;
-	let n = t, r = e.dbName ?? w(), i = e.storeName ?? _, a = null;
-	function o() {
-		return a || (a = new Promise((e, t) => {
-			let a = n.open(r, 1);
-			a.onupgradeneeded = () => {
-				let e = a.result;
-				e.objectStoreNames.contains(i) || e.createObjectStore(i);
-			}, a.onsuccess = () => e(a.result), a.onerror = () => t(a.error), a.onblocked = () => t(a.error ?? /* @__PURE__ */ Error("Открытие IndexedDB заблокировано"));
-		}), a);
-	}
-	async function s(e, t) {
-		return C(t((await o()).transaction(i, e).objectStore(i)));
-	}
-	async function c(e, t) {
-		let n = await o();
-		return new Promise((r, a) => {
-			let o = n.transaction(i, e), s = o.objectStore(i);
-			o.oncomplete = () => r(), o.onerror = () => a(o.error), o.onabort = () => a(o.error);
-			try {
-				t(s);
-			} catch (e) {
-				o.abort(), a(e);
-			}
-		});
-	}
-	async function l(e, t) {
-		let n = await o();
-		return new Promise((r, a) => {
-			let o = n.transaction(i, "readwrite"), s = o.objectStore(i), c = s.get(e), l, u = !1;
-			o.oncomplete = () => {
-				u ? r(l) : a(/* @__PURE__ */ Error("IndexedDB-транзакция завершилась без результата обновления"));
-			}, o.onerror = () => a(o.error), o.onabort = () => a(o.error), c.onerror = () => {
-				o.abort(), a(c.error);
-			}, c.onsuccess = () => {
-				try {
-					let n = t(c.result);
-					l = n.result, u = !0, n.action === "set" ? s.put(n.value, e) : n.action === "remove" && s.delete(e);
-				} catch (e) {
-					o.abort(), a(e);
-				}
-			};
-		});
-	}
-	return {
-		getItem: (e) => s("readonly", (t) => t.get(e)),
-		setItem: (e, t) => c("readwrite", (n) => n.put(t, e)),
-		removeItem: (e) => c("readwrite", (t) => t.delete(e)),
-		updateItem: l,
-		entries: async () => {
-			let e = await o();
-			return new Promise((t, n) => {
-				let r = e.transaction(i, "readonly"), a = r.objectStore(i).openCursor(), o = [];
-				r.oncomplete = () => t(o), r.onerror = () => n(r.error), r.onabort = () => n(r.error), a.onsuccess = () => {
-					let e = a.result;
-					e && (o.push([String(e.key), e.value]), e.continue());
-				}, a.onerror = () => n(a.error);
-			});
-		}
-	};
-}
-function B() {
-	let e = z();
-	if (!e) return;
-	let t = e, n = r({
-		storage: t,
-		serialize: (e) => e,
-		deserialize: (e) => e,
-		prefix: T(),
-		buster: g().persistenceBuster ?? y,
-		maxAge: b,
-		refetchOnRestore: !0,
-		filters: { predicate: F }
-	}), i = /* @__PURE__ */ new Map();
-	function a(e, n, a, o = !0, s) {
-		let c = k(e.id, n), l = `${c}:${a}:${o}:${s ?? ""}:${e.expiresAt}`, u = i.get(l);
-		if (u) return u;
-		let d = Promise.resolve(), f = r({
-			storage: {
-				getItem: (n) => j()?.id === e.id ? t.getItem(n) : void 0,
-				removeItem: (e) => t.removeItem(e),
-				entries: () => t.entries(),
-				setItem: async (n, r) => {
-					j()?.id === e.id && (s === void 0 ? await t.setItem(n, r) : await t.updateItem(n, (e) => {
-						if (!e || e.buster !== r.buster) return {
-							action: "set",
-							value: r,
-							result: void 0
-						};
-						let t = L(e, s), n = L(r, s);
-						return t !== null && n !== null && R(t, n) > 0 ? {
-							action: "keep",
-							result: void 0
-						} : {
-							action: "set",
-							value: r,
-							result: void 0
-						};
-					}), d = d.then(async () => {
-						let e = (await t.entries()).filter(([e]) => e.startsWith(`${c}-`));
-						e.sort((e, t) => (t[1].state.dataUpdatedAt ?? 0) - (e[1].state.dataUpdatedAt ?? 0)), await Promise.all(e.slice(a).map(([e]) => t.removeItem(e)));
-					}), await d);
-				}
-			},
-			serialize: (e) => e,
-			deserialize: (e) => e,
-			prefix: c,
-			buster: g().persistenceBuster ?? y,
-			maxAge: b,
-			refetchOnRestore: o,
-			filters: { predicate: (e) => I(e)?.cacheName === n }
-		});
-		return i.set(l, f), f;
-	}
-	return {
-		...n,
-		async persisterFn(e, t, r) {
-			let i = I(r);
-			if (!i) return n.persisterFn(e, t, r);
-			let o = j();
-			return o ? a(o, i.cacheName, i.maxEntries, i.refetchOnRestore, i.monotonicRevisionField).persisterFn(e, t, r) : Promise.resolve(e(t));
-		}
-	};
-}
-//#endregion
-//#region src/query-client/queryMeta.ts
-var V = { persist: !0 }, H = { sessionScoped: !0 };
-function U(e) {
-	let t = e.cacheName.trim();
-	if (!/^[a-z0-9][a-z0-9_-]{0,63}$/u.test(t)) throw Error("Имя session query cache должно содержать только строчные латинские буквы, цифры, _ и -");
-	if (!Number.isSafeInteger(e.maxEntries) || e.maxEntries < 1 || e.maxEntries > 5e3) throw Error("Лимит session query cache должен быть целым числом от 1 до 5000");
-	if (e.refetchOnRestore !== void 0 && typeof e.refetchOnRestore != "boolean") throw Error("Политика refetch после восстановления должна быть boolean");
-	let n = e.monotonicRevisionField?.trim();
-	if (n !== void 0 && !/^[A-Za-z][A-Za-z0-9_]{0,63}$/u.test(n)) throw Error("Имя поля монотонной ревизии должно быть JavaScript-идентификатором длиной до 64 символов");
-	return {
-		sessionScoped: !0,
-		sessionPersistence: {
-			cacheName: t,
-			maxEntries: e.maxEntries,
-			...e.refetchOnRestore === void 0 ? {} : { refetchOnRestore: e.refetchOnRestore },
-			...n === void 0 ? {} : { monotonicRevisionField: n }
-		}
-	};
-}
-//#endregion
-//#region src/query-client/queryClient.ts
-function W({ onQueryError: e, onMutationError: t }) {
-	let n = B();
-	return new o({
-		queryCache: new a({ onError: e }),
-		mutationCache: new i({ onError: t }),
-		defaultOptions: {
-			queries: {
-				staleTime: 6e5,
-				gcTime: 18e5,
-				throwOnError: !1,
-				retry: !1,
-				...n ? { persister: n.persisterFn } : {}
-			},
-			mutations: {
-				throwOnError: !1,
-				retry: !1
-			}
-		}
-	});
-}
-async function G(e, t, n) {
-	await e.cancelQueries({ queryKey: t });
-	let r = e.getQueryData(t);
-	return e.setQueryData(t, n), { previous: r };
-}
-function K(e, t, n) {
-	n?.previous !== void 0 && e.setQueryData(t, n.previous);
-}
-function q(e, t, n, r) {
-	e.setQueryData(t, (e) => r(e, n));
-}
-async function J(e, t, n) {
-	let r = n?.refetchType ?? "none", i = Y(t) ? t : [t];
-	await Promise.all(i.map((t) => e.invalidateQueries({
-		queryKey: t,
-		refetchType: r
-	})));
-}
-function Y(e) {
-	return Array.isArray(e) ? Array.isArray(e[0]) : !1;
-}
-//#endregion
-//#region src/query-client/sessionScoped.ts
-var X = "session-scoped-query-cache-reset", Z;
-function Q(e) {
-	return e.meta?.sessionScoped === !0;
-}
-async function $(e, t = {}) {
-	let n = { predicate: Q };
-	await e.cancelQueries(n);
-	let r = e.getQueryCache().findAll(n);
-	for (let t of r) {
-		if (t.getObserversCount() === 0) {
-			e.getQueryCache().remove(t);
-			continue;
-		}
-		t.reset(), t.setState({
-			data: void 0,
-			dataUpdatedAt: 0
-		});
-	}
-	await e.refetchQueries({
-		predicate: (e) => Q(e) && e.getObserversCount() > 0,
-		type: "active"
-	}, { cancelRefetch: !0 }), t.broadcast !== !1 && Z?.();
-}
-function te(e, t) {
-	if (typeof window > "u" || typeof BroadcastChannel > "u") return { cleanup: () => void 0 };
-	let n = new BroadcastChannel(t.channelName), r = () => {
-		let e = { type: X };
-		n.postMessage(e);
-	};
-	return Z = r, n.onmessage = (t) => {
-		ne(t.data) && $(e, { broadcast: !1 });
-	}, { cleanup: () => {
-		n.onmessage = null, n.close(), Z === r && (Z = void 0);
-	} };
-}
-function ne(e) {
-	return typeof e == "object" && !!e && "type" in e && e.type === X;
-}
-//#endregion
-export { y as REACT_QUERY_PERSISTENCE_BUSTER, b as REACT_QUERY_PERSISTENCE_MAX_AGE, l as broadcastCacheEvent, N as clearSessionQueryPersistence, ee as configureQueryPersistenceProjectAdapter, z as createIndexedDbQueryStorage, W as createQueryClient, B as createReactQueryPersister, U as createSessionQueryPersistenceMeta, g as getQueryPersistenceProjectAdapter, j as getSessionQueryPersistenceScope, m as installQueryInvalidationBroadcast, u as installReactQueryBroadcast, te as installSessionScopedQueryReset, Q as isSessionScopedQuery, K as onErrorOptimistic, G as onMutateOptimistic, J as onSettledOptimistic, q as onSuccessOptimistic, V as persistedQueryMeta, $ as resetSessionScopedQueries, H as sessionScopedQueryMeta, c as setBroadcastFn, P as setSessionQueryPersistenceScope, F as shouldPersistQuery };
-
-//# sourceMappingURL=index.js.map
+import { C as e, E as t, S as n, T as r, _ as i, a, b as o, c as s, d as c, f as l, g as u, h as d, i as f, l as p, m, n as h, o as g, p as _, r as v, s as y, t as b, u as x, v as S, w as C, x as w, y as T } from "../chunks/query-client-BsiuEoJD.js";
+export { _ as REACT_QUERY_PERSISTENCE_BUSTER, m as REACT_QUERY_PERSISTENCE_MAX_AGE, C as broadcastCacheEvent, d as clearSessionQueryPersistence, w as configureQueryPersistenceProjectAdapter, u as createIndexedDbQueryStorage, a as createQueryClient, i as createReactQueryPersister, x as createSessionQueryPersistenceMeta, n as getQueryPersistenceProjectAdapter, S as getSessionQueryPersistenceScope, e as installQueryInvalidationBroadcast, r as installReactQueryBroadcast, b as installSessionScopedQueryReset, f as installSessionScopedQueryResetLifecycle, h as isSessionScopedQuery, g as onErrorOptimistic, y as onMutateOptimistic, s as onSettledOptimistic, p as onSuccessOptimistic, c as persistedQueryMeta, v as resetSessionScopedQueries, l as sessionScopedQueryMeta, t as setBroadcastFn, T as setSessionQueryPersistenceScope, o as shouldPersistQuery };

package/dist/query-client/sessionScoped.d.ts

@@ -1,19 +1,5 @@
 import { type Query, type QueryClient } from "@tanstack/react-query";
-export type ResetSessionScopedQueriesOptions = {
-    /**
-     * Передавать ли команду сброса другим вкладкам. При обработке входящего
-     * сообщения значение отключается, чтобы вкладки не создавали цикл событий.
-     */
-    readonly broadcast?: boolean;
-};
-export type InstallSessionScopedQueryResetOptions = {
-    /** Уникальное для приложения имя служебного BroadcastChannel. */
-    readonly channelName: string;
-};
-export type InstalledSessionScopedQueryReset = {
-    /** Освобождает канал и прекращает межвкладочную синхронизацию. */
-    readonly cleanup: () => void;
-};
+import { type InstalledSessionScopedQueryReset, type InstallSessionScopedQueryResetOptions, type ResetSessionScopedQueriesOptions } from "./sessionScopedTypes";
 /** Проверяет, относится ли query к данным текущей серверной сессии. */
 export declare function isSessionScopedQuery(query: Pick<Query, "meta">): boolean;
 /**

package/dist/query-client/sessionScoped.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessionScoped.d.ts","sourceRoot":"","sources":["../../src/query-client/sessionScoped.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAQrE,MAAM,MAAM,gCAAgC,GAAG;IAC9C;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG;IACnD,iEAAiE;IACjE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC9C,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC7B,CAAC;AAIF,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAExE;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,GAAE,gCAAqC,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BvI;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC7C,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,qCAAqC,GAC5C,gCAAgC,CA4BlC"}
+{"version":3,"file":"sessionScoped.d.ts","sourceRoot":"","sources":["../../src/query-client/sessionScoped.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGrE,OAAO,EACN,KAAK,gCAAgC,EACrC,KAAK,qCAAqC,EAC1C,KAAK,gCAAgC,EACrC,MAAM,sBAAsB,CAAC;AAU9B,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAExE;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,GAAE,gCAAqC,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDvI;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC7C,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,qCAAqC,GAC5C,gCAAgC,CA4ClC"}

package/dist/query-client/sessionScopedResetLifecycle.d.ts

@@ -0,0 +1,16 @@
+import { type QueryClient } from "@tanstack/react-query";
+import { type InstalledSessionScopedQueryResetLifecycle, type SessionScopedQueryResetLifecycle, type SessionScopedQueryResetOutcome } from "./sessionScopedResetLifecycleTypes";
+type SessionScopedQueryResetBoundary = Readonly<{
+    retirement: Promise<readonly unknown[]> | null;
+    complete: (outcome: SessionScopedQueryResetOutcome) => Promise<readonly unknown[]>;
+}>;
+/**
+ * Устанавливать до запуска session-bound runtime на весь срок жизни QueryClient.
+ * Поздняя регистрация не может восстановить пропущенный before: вместо частичной
+ * защиты она синхронно отклоняется до startup нового consumer.
+ */
+export declare function installSessionScopedQueryResetLifecycle(queryClient: QueryClient, lifecycle: SessionScopedQueryResetLifecycle): InstalledSessionScopedQueryResetLifecycle;
+/** Приватная пара одного reset: перекрывающиеся вызовы не объединяются и не меняют прежний Query flow. */
+export declare function beginSessionScopedQueryReset(queryClient: QueryClient): SessionScopedQueryResetBoundary;
+export {};
+//# sourceMappingURL=sessionScopedResetLifecycle.d.ts.map

package/dist/query-client/sessionScopedResetLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionScopedResetLifecycle.d.ts","sourceRoot":"","sources":["../../src/query-client/sessionScopedResetLifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EACN,KAAK,yCAAyC,EAC9C,KAAK,gCAAgC,EACrC,KAAK,8BAA8B,EACnC,MAAM,oCAAoC,CAAC;AAO5C,KAAK,+BAA+B,GAAG,QAAQ,CAAC;IAC/C,UAAU,EAAE,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAC/C,QAAQ,EAAE,CAAC,OAAO,EAAE,8BAA8B,KAAK,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;CACnF,CAAC,CAAC;AAmBH;;;;GAIG;AACH,wBAAgB,uCAAuC,CACtD,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,gCAAgC,GACzC,yCAAyC,CAc3C;AAED,0GAA0G;AAC1G,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,WAAW,GAAG,+BAA+B,CA+BtG"}

package/dist/query-client/sessionScopedResetLifecycleTypes.d.ts

@@ -0,0 +1,16 @@
+/** Результат retirement и самого reset; ошибки остаются в отклонённом Promise вызывающего кода. */
+export type SessionScopedQueryResetOutcome = Readonly<{
+    status: "completed" | "failed";
+}>;
+/** Техническая граница внешних session-bound ресурсов, без знания auth или содержимого Query. */
+export type SessionScopedQueryResetLifecycle = Readonly<{
+    /** Синхронно отзывает допуск; Promise завершает освобождение ресурсов до отмены и очистки Query. */
+    beforeReset: () => void | Promise<void>;
+    /** Парный finally: вызывается и после cleanup регистрации; failed не разрешает восстановить прежний scope. */
+    afterReset: (outcome: SessionScopedQueryResetOutcome) => void;
+}>;
+export type InstalledSessionScopedQueryResetLifecycle = Readonly<{
+    /** Идемпотентно запрещает будущие before, не отменяя уже захваченную пару текущего reset. */
+    cleanup: () => void;
+}>;
+//# sourceMappingURL=sessionScopedResetLifecycleTypes.d.ts.map

package/dist/query-client/sessionScopedResetLifecycleTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionScopedResetLifecycleTypes.d.ts","sourceRoot":"","sources":["../../src/query-client/sessionScopedResetLifecycleTypes.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CAAC;IAAE,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAA;CAAE,CAAC,CAAC;AAE1F,iGAAiG;AACjG,MAAM,MAAM,gCAAgC,GAAG,QAAQ,CAAC;IACvD,oGAAoG;IACpG,WAAW,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,8GAA8G;IAC9G,UAAU,EAAE,CAAC,OAAO,EAAE,8BAA8B,KAAK,IAAI,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,MAAM,yCAAyC,GAAG,QAAQ,CAAC;IAChE,6FAA6F;IAC7F,OAAO,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC,CAAC"}

package/dist/query-client/sessionScopedTypes.d.ts

@@ -0,0 +1,15 @@
+export type ResetSessionScopedQueriesOptions = Readonly<{
+    /** Отключается при обработке входящего сообщения, чтобы вкладки не создавали цикл reset. */
+    broadcast?: boolean;
+}>;
+export type InstallSessionScopedQueryResetOptions = Readonly<{
+    /** Уникальное для приложения имя служебного BroadcastChannel. */
+    channelName: string;
+    /** Ошибка входящего reset; без callback выводится в console.error, не становится unhandled rejection. */
+    onError?: (error: unknown) => void | Promise<void>;
+}>;
+export type InstalledSessionScopedQueryReset = Readonly<{
+    /** Освобождает канал и прекращает межвкладочную синхронизацию. */
+    cleanup: () => void;
+}>;
+//# sourceMappingURL=sessionScopedTypes.d.ts.map

package/dist/query-client/sessionScopedTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionScopedTypes.d.ts","sourceRoot":"","sources":["../../src/query-client/sessionScopedTypes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gCAAgC,GAAG,QAAQ,CAAC;IACvD,4FAA4F;IAC5F,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC,CAAC;AAEH,MAAM,MAAM,qCAAqC,GAAG,QAAQ,CAAC;IAC5D,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,yGAAyG;IACzG,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD,CAAC,CAAC;AAEH,MAAM,MAAM,gCAAgC,GAAG,QAAQ,CAAC;IACvD,kEAAkE;IAClE,OAAO,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ryuzaki13/react-foundation-lib",
-	"version": "2.8.1",
+	"version": "2.10.0",
 	"description": "Reusable React and TypeScript foundation utilities, hooks, and primitives.",
 	"license": "MIT",
 	"author": "Ryuzaki13",
@@ -61,6 +61,10 @@
 			"types": "./dist/date-segments/index.d.ts",
 			"import": "./dist/date-segments/index.js"
 		},
+		"./decimal": {
+			"types": "./dist/decimal/index.d.ts",
+			"import": "./dist/decimal/index.js"
+		},
 		"./dom": {
 			"types": "./dist/dom/index.d.ts",
 			"import": "./dist/dom/index.js"

package/src/decimal/README.md

@@ -0,0 +1,43 @@
+# Точные десятичные значения
+
+Публичный импорт: `@ryuzaki13/react-foundation-lib/decimal`.
+Модуль вычисляет конечные десятичные значения как целый коэффициент и число
+десятичных разрядов. Строки не переводятся в `number`; округления нет.
+React, browser API и дополнительные зависимости не требуются.
+
+```ts
+import { addDecimals, compareDecimalRatios } from "@ryuzaki13/react-foundation-lib/decimal";
+
+addDecimals("0.1", "0.2"); // "0.3"
+compareDecimalRatios({ numerator: "10", denominator: "3" }, { numerator: "3.33", denominator: "1" }); // 1
+```
+
+| API                                                   | Назначение                                                            |
+| ----------------------------------------------------- | --------------------------------------------------------------------- |
+| `isCanonicalDecimal(unknown, options?)`               | Проверить внешнее значение без преобразования                         |
+| `normalizeDecimal(string, options?)`                  | Убрать начальные и конечные нули; привести отрицательный ноль к `"0"` |
+| `addDecimals`, `subtractDecimals`, `multiplyDecimals` | Получить точный канонический результат двух операндов                 |
+| `sumDecimals(iterable, options?)`                     | Суммировать за один проход; пустой набор даёт `"0"`                   |
+| `compareDecimals`                                     | Вернуть `-1`, `0` или `1`                                             |
+| `compareDecimalRatios`                                | Сравнить отношения без деления; знаменатели строго положительные      |
+
+Каноническая строка содержит знак минус при необходимости, цифры и точку:
+`"0"`, `"0.3"`, `"-12.05"`. Пробелы, плюс, экспонента, запятая, начальные
+нули и конечные нули дробной части в арифметике отклоняются. Нормализация
+допускает только лишние нули; обработка локализованного ввода и внешних JSON
+чисел принадлежит соответствующей входной границе.
+
+`DecimalOptions.maxLength` задаёт положительный безопасный целый предел длины
+входа и результата, включая знак и точку; по умолчанию — 512 символов.
+Вход отклоняется до создания `bigint` и выравнивания разрядов. Неверная форма
+даёт `TypeError`, неверный предел, overflow результата и недопустимый знаменатель
+— `RangeError`. `isCanonicalDecimal` возвращает `false` для неверного значения,
+но неверная конфигурация предела также даёт `RangeError`.
+
+Суммирование проверяет каждый промежуточный результат: даже последующее
+взаимное сокращение не отменяет уже возникшее переполнение. При сравнении
+отношений произведения не сериализуются; они могут превышать предел строки,
+оставаясь ограниченными длиной проверенных операндов.
+
+Предметные правила положительности, единиц измерения и допустимости нуля
+остаются у приложения. Приватные коэффициенты и разрядность не входят в API.