@burojs/ui-shadcn 0.3.0 → 0.5.0

package/dist/use-dialog-filter-state-BDcgS5Oz.js

@@ -0,0 +1,87 @@
+import { n as narrowSearchDecl, t as namesHiddenField } from "./search-access-CURsWn-U.js";
+import { EMPTY_FILTER_GROUP, composeListFilter } from "@burojs/core";
+import { useApp, useFilterFields, useListAccess } from "@burojs/react";
+import { useCallback, useMemo, useState } from "react";
+//#region src/fields/use-dialog-filter-state.ts
+function useDialogFilterState(resource, options) {
+	const def = useApp().registry.get(resource);
+	const { available, fixed } = useFilterFields(resource, {
+		fixedFilters: options.fixedFilters,
+		enabled: options.enabled
+	});
+	const [group, setGroupState] = useState(EMPTY_FILTER_GROUP);
+	const [search, setSearchState] = useState("");
+	const [page, setPage] = useState(1);
+	const setGroup = useCallback((next) => {
+		setGroupState(next);
+		setPage(1);
+	}, []);
+	const setSearch = useCallback((next) => {
+		setSearchState(next);
+		setPage(1);
+	}, []);
+	const reset = useCallback(() => {
+		setGroupState(EMPTY_FILTER_GROUP);
+		setSearchState("");
+		setPage(1);
+	}, []);
+	const { searchField } = options;
+	const access = useListAccess(resource);
+	const accessReady = access.status === "ready";
+	const searchDecl = useMemo(() => {
+		const declared = def?.views?.list?.search;
+		return narrowSearchDecl(declared !== void 0 ? declared : searchField === void 0 ? void 0 : { fields: [searchField] }, (field) => access.fieldVisible(field));
+	}, [
+		def,
+		searchField,
+		access
+	]);
+	const searchContext = useMemo(() => ({
+		resource,
+		def
+	}), [resource, def]);
+	const filter = useMemo(() => composeListFilter({
+		fixed,
+		group,
+		search,
+		searchDecl,
+		searchContext
+	}), [
+		fixed,
+		group,
+		search,
+		searchDecl,
+		searchContext
+	]);
+	const blocked = !accessReady || namesHiddenField(filter, (field) => access.fieldVisible(field));
+	return useMemo(() => ({
+		searchEnabled: searchDecl !== void 0,
+		blocked,
+		group,
+		setGroup,
+		search,
+		setSearch,
+		page,
+		setPage,
+		available,
+		fixed,
+		filter,
+		reset
+	}), [
+		group,
+		setGroup,
+		search,
+		setSearch,
+		page,
+		available,
+		fixed,
+		filter,
+		reset,
+		searchDecl,
+		blocked
+	]);
+}
+//#endregion
+export { useDialogFilterState as t };
+
+//# sourceMappingURL=use-dialog-filter-state-BDcgS5Oz.js.map

package/dist/use-dialog-filter-state-BDcgS5Oz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-dialog-filter-state-BDcgS5Oz.js","names":[],"sources":["../src/fields/use-dialog-filter-state.ts"],"sourcesContent":["import {\n  EMPTY_FILTER_GROUP,\n  composeListFilter,\n  type ErasedResourceHandle,\n  type FilterExpression,\n  type FilterGroup,\n  type FixedFilterInput,\n  type ResolvedFixedFilter,\n  type SearchDecl,\n} from '@burojs/core';\nimport { useApp, useFilterFields, useListAccess, type FilterFieldSpec } from '@burojs/react';\nimport { namesHiddenField, narrowSearchDecl } from './search-access.js';\nimport { useCallback, useMemo, useState } from 'react';\n\n/** The portable erased AST — the only shape this module deals in. */\ntype ErasedExpression = FilterExpression<ErasedResourceHandle>;\n\n/** Options for {@link useDialogFilterState}. */\nexport interface UseDialogFilterStateOptions {\n  /** Call-site narrowing (e.g. scope the target list to a product group). */\n  readonly fixedFilters?: readonly FixedFilterInput[];\n  /**\n   * Fallback search field, used ONLY when the target resource declares no\n   * `views.list.search`. Wrapped into a single-field `SearchFieldsDecl`\n   * (`{ fields: [searchField] }`, implicit `contains` — same degenerate form\n   * `searchToFilter` already gives a bare field-name string) so the override\n   * goes through the exact same `composeListFilter` → `searchToFilter` path\n   * as a real declaration, rather than a second hand-built predicate at the\n   * call site. The target's own declaration always wins when present — this\n   * is a fallback, not an override of a declared search.\n   */\n  readonly searchField?: string;\n  /**\n   * Gates the field-derivation walk (`useFilterFields`'s `categorizeField`\n   * pass over every field of the resource). Defaults to `true`. A caller\n   * whose UI isn't visible yet (e.g. `RelationPickerDialog` before it's\n   * opened) should pass `false` to skip that work on every mount /\n   * `fixedFilters`-identity change; the derivation recomputes in full the\n   * next render where this flips back to `true`.\n   */\n  readonly enabled?: boolean;\n}\n\n/** Return shape of {@link useDialogFilterState}. */\nexport interface DialogFilterState {\n  readonly group: FilterGroup;\n  readonly setGroup: (next: FilterGroup) => void;\n  readonly search: string;\n  readonly setSearch: (next: string) => void;\n  readonly page: number;\n  readonly setPage: (page: number) => void;\n  readonly available: readonly FilterFieldSpec[];\n  readonly fixed: readonly ResolvedFixedFilter[];\n  /** The single expression to hand the data provider. */\n  readonly filter: ErasedExpression | undefined;\n  /** Whether the target has a search for this user (no field left means no search box). */\n  readonly searchEnabled: boolean;\n  /** The read must not be sent: undecided access, or a filter naming a field the user may not view. */\n  readonly blocked: boolean;\n  readonly reset: () => void;\n}\n\n/**\n * Local (non-URL) filter state for the relation-picker's advanced-search\n * dialog.\n *\n * `useResourceList` cannot serve this: it unconditionally calls\n * `useResourceUrlState`, which throws without a `RouterAdapterProvider` and,\n * when one IS present, writes to `?<resource>.*`. A picker dialog mounted\n * inside a form for resource A, searching TARGET resource B, would then\n * write B's list state into the URL — clobbering a real B list page open on\n * another tab of the same app, and reading back whatever that page last\n * wrote on open. So this hook keeps `group`/`search`/`page` in plain\n * `useState` and reuses the SAME composition core's list controller uses\n * (`composeListFilter`) so the two never drift on what a filter means.\n *\n * No `pinned` slot: pinned controls are a list-PAGE affordance (permanent\n * screen real estate for a couple of always-visible facets); a modal has no\n * spare real estate to spend on them.\n */\nexport function useDialogFilterState(\n  resource: string,\n  options: UseDialogFilterStateOptions,\n): DialogFilterState {\n  const app = useApp();\n  const def = app.registry.get(resource);\n  const { available, fixed } = useFilterFields(resource, {\n    fixedFilters: options.fixedFilters,\n    enabled: options.enabled,\n  });\n\n  const [group, setGroupState] = useState<FilterGroup>(EMPTY_FILTER_GROUP);\n  const [search, setSearchState] = useState('');\n  const [page, setPage] = useState(1);\n\n  // Any change to WHAT is filtered invalidates the current page — the same\n  // rule `useResourceList`'s URL-state controller applies to its own\n  // group/search setters.\n  const setGroup = useCallback((next: FilterGroup) => {\n    setGroupState(next);\n    setPage(1);\n  }, []);\n\n  const setSearch = useCallback((next: string) => {\n    setSearchState(next);\n    setPage(1);\n  }, []);\n\n  const reset = useCallback(() => {\n    setGroupState(EMPTY_FILTER_GROUP);\n    setSearchState('');\n    setPage(1);\n  }, []);\n\n  // The target's own declaration always wins; `options.searchField` only\n  // fills in when the target declares no search at all. Memoized so an\n  // omitted declaration doesn't hand `composeListFilter`'s `filter` memo a\n  // fresh `{ fields: [...] }` literal (and therefore a spurious recompute)\n  // on every render — see `UseDialogFilterStateOptions.searchField`'s doc.\n  const { searchField } = options;\n  const access = useListAccess(resource);\n  const accessReady = access.status === 'ready';\n  const searchDecl = useMemo<SearchDecl | undefined>(() => {\n    const declared = def?.views?.list?.search;\n    const base =\n      declared !== undefined\n        ? declared\n        : searchField === undefined\n          ? undefined\n          : { fields: [searchField] };\n    return narrowSearchDecl(base, (field) => access.fieldVisible(field));\n  }, [def, searchField, access]);\n  const searchContext = useMemo(() => ({ resource, def }), [resource, def]);\n\n  const filter = useMemo<ErasedExpression | undefined>(\n    () => composeListFilter({ fixed, group, search, searchDecl, searchContext }),\n    [fixed, group, search, searchDecl, searchContext],\n  );\n\n  // A read whose composed filter names a field the user may not view is forbidden (an author\n  // predicate, or a function search's output); an undecided access sends nothing yet.\n  const blocked = !accessReady || namesHiddenField(filter, (field) => access.fieldVisible(field));\n\n  return useMemo<DialogFilterState>(\n    () => ({\n      searchEnabled: searchDecl !== undefined,\n      blocked,\n      group,\n      setGroup,\n      search,\n      setSearch,\n      page,\n      setPage,\n      available,\n      fixed,\n      filter,\n      reset,\n    }),\n    [\n      group,\n      setGroup,\n      search,\n      setSearch,\n      page,\n      available,\n      fixed,\n      filter,\n      reset,\n      searchDecl,\n      blocked,\n    ],\n  );\n}\n"],"mappings":";;;;;AAgFA,SAAgB,qBACd,UACA,SACmB;CAEnB,MAAM,MADM,OACE,CAAC,CAAC,SAAS,IAAI,QAAQ;CACrC,MAAM,EAAE,WAAW,UAAU,gBAAgB,UAAU;EACrD,cAAc,QAAQ;EACtB,SAAS,QAAQ;CACnB,CAAC;CAED,MAAM,CAAC,OAAO,iBAAiB,SAAsB,kBAAkB;CACvE,MAAM,CAAC,QAAQ,kBAAkB,SAAS,EAAE;CAC5C,MAAM,CAAC,MAAM,WAAW,SAAS,CAAC;CAKlC,MAAM,WAAW,aAAa,SAAsB;EAClD,cAAc,IAAI;EAClB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAEL,MAAM,YAAY,aAAa,SAAiB;EAC9C,eAAe,IAAI;EACnB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAEL,MAAM,QAAQ,kBAAkB;EAC9B,cAAc,kBAAkB;EAChC,eAAe,EAAE;EACjB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAOL,MAAM,EAAE,gBAAgB;CACxB,MAAM,SAAS,cAAc,QAAQ;CACrC,MAAM,cAAc,OAAO,WAAW;CACtC,MAAM,aAAa,cAAsC;EACvD,MAAM,WAAW,KAAK,OAAO,MAAM;EAOnC,OAAO,iBALL,aAAa,KAAA,IACT,WACA,gBAAgB,KAAA,IACd,KAAA,IACA,EAAE,QAAQ,CAAC,WAAW,EAAE,IACD,UAAU,OAAO,aAAa,KAAK,CAAC;CACrE,GAAG;EAAC;EAAK;EAAa;CAAM,CAAC;CAC7B,MAAM,gBAAgB,eAAe;EAAE;EAAU;CAAI,IAAI,CAAC,UAAU,GAAG,CAAC;CAExE,MAAM,SAAS,cACP,kBAAkB;EAAE;EAAO;EAAO;EAAQ;EAAY;CAAc,CAAC,GAC3E;EAAC;EAAO;EAAO;EAAQ;EAAY;CAAa,CAClD;CAIA,MAAM,UAAU,CAAC,eAAe,iBAAiB,SAAS,UAAU,OAAO,aAAa,KAAK,CAAC;CAE9F,OAAO,eACE;EACL,eAAe,eAAe,KAAA;EAC9B;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,IACA;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CACF;AACF"}

package/dist/use-theme-DFlpXils.cjs

@@ -0,0 +1,257 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+const require_layout_theme_storage_key = require("./layout/theme-storage-key.cjs");
+let react = require("react");
+let clsx = require("clsx");
+let tailwind_merge = require("tailwind-merge");
+let github_slugger = require("github-slugger");
+github_slugger = __toESM(github_slugger, 1);
+//#region src/lib/cn.ts
+function cn(...inputs) {
+	return (0, tailwind_merge.twMerge)((0, clsx.clsx)(inputs));
+}
+//#endregion
+//#region src/markdown/anchors.ts
+const DOC_ID_PREFIX = "user-content-";
+function docSlug(text) {
+	return new github_slugger.default().slug(text);
+}
+function readDocHash() {
+	if (typeof window === "undefined") return "";
+	const raw = window.location.hash.replace(/^#/, "");
+	if (raw === "") return "";
+	try {
+		return decodeURIComponent(raw);
+	} catch {
+		return raw;
+	}
+}
+function findDocAnchor(hash, root = document) {
+	let id = hash.replace(/^#/, "");
+	if (id === "") return null;
+	try {
+		id = decodeURIComponent(id);
+	} catch {}
+	const doc = root.ownerDocument ?? root;
+	const pick = (candidate) => {
+		const el = doc.getElementById(candidate);
+		if (!el) return null;
+		return root === doc || root.contains(el) ? el : null;
+	};
+	return pick("user-content-" + id) ?? pick(id);
+}
+function placeInScroller(target) {
+	let container = target.parentElement;
+	while (container) {
+		const style = getComputedStyle(container);
+		if (/(auto|scroll)/.test(style.overflowY) && container.scrollHeight > container.clientHeight + 1) break;
+		container = container.parentElement;
+	}
+	if (!container) {
+		target.scrollIntoView({
+			block: "start",
+			behavior: "auto"
+		});
+		return;
+	}
+	const margin = Number.parseFloat(getComputedStyle(target).scrollMarginTop) || 0;
+	const delta = target.getBoundingClientRect().top - container.getBoundingClientRect().top - margin;
+	container.scrollTop += delta;
+}
+function scrollToDocAnchor(hash, root = document.body, settleMs = 1500) {
+	let stopped = false;
+	const go = () => {
+		if (stopped) return;
+		const target = findDocAnchor(hash, root);
+		if (target) placeInScroller(target);
+	};
+	const raf1 = requestAnimationFrame(() => requestAnimationFrame(go));
+	const observer = typeof ResizeObserver === "undefined" ? null : new ResizeObserver(() => requestAnimationFrame(go));
+	observer?.observe(root);
+	const timer = setTimeout(() => {
+		stopped = true;
+		observer?.disconnect();
+	}, settleMs);
+	return () => {
+		stopped = true;
+		cancelAnimationFrame(raf1);
+		observer?.disconnect();
+		clearTimeout(timer);
+	};
+}
+function docShareUrl(slug, href = window.location.href) {
+	const url = new URL(href);
+	const safe = /[#?%\s]/.test(slug) ? encodeURIComponent(slug) : slug;
+	return `${url.origin}${url.pathname}${url.search}#${safe}`;
+}
+//#endregion
+//#region src/layout/use-theme.ts
+const THEME_CHOICES = [
+	"light",
+	"dark",
+	"system"
+];
+function systemPrefersDark() {
+	return typeof window !== "undefined" && typeof window.matchMedia === "function" && window.matchMedia("(prefers-color-scheme: dark)").matches;
+}
+function readChoice() {
+	if (typeof window === "undefined") return "system";
+	try {
+		const saved = window.localStorage.getItem(require_layout_theme_storage_key.THEME_STORAGE_KEY);
+		if (saved === "light" || saved === "dark") return saved;
+	} catch {}
+	return "system";
+}
+function resolveTheme(choice) {
+	if (choice === "light" || choice === "dark") return choice;
+	return systemPrefersDark() ? "dark" : "light";
+}
+function applyDomClass(resolved) {
+	if (typeof document === "undefined") return;
+	document.documentElement.classList.toggle("dark", resolved === "dark");
+}
+function persistChoice(choice) {
+	if (typeof window === "undefined") return;
+	try {
+		if (choice === "system") window.localStorage.removeItem(require_layout_theme_storage_key.THEME_STORAGE_KEY);
+		else window.localStorage.setItem(require_layout_theme_storage_key.THEME_STORAGE_KEY, choice);
+	} catch {}
+}
+function useTheme() {
+	const [state, setState] = (0, react.useState)({
+		choice: "system",
+		resolved: "light"
+	});
+	(0, react.useEffect)(() => {
+		const choice = readChoice();
+		setState({
+			choice,
+			resolved: resolveTheme(choice)
+		});
+		const root = document.documentElement;
+		const observer = new MutationObserver(() => {
+			const resolved = root.classList.contains("dark") ? "dark" : "light";
+			setState((prev) => prev.resolved === resolved ? prev : {
+				...prev,
+				resolved
+			});
+		});
+		observer.observe(root, {
+			attributes: true,
+			attributeFilter: ["class"]
+		});
+		const mql = typeof window.matchMedia === "function" ? window.matchMedia("(prefers-color-scheme: dark)") : void 0;
+		const onSystemChange = (event) => {
+			const choice = readChoice();
+			if (choice !== "system") return;
+			const resolved = event.matches ? "dark" : "light";
+			applyDomClass(resolved);
+			setState((prev) => prev.choice === choice && prev.resolved === resolved ? prev : {
+				choice,
+				resolved
+			});
+		};
+		mql?.addEventListener("change", onSystemChange);
+		return () => {
+			observer.disconnect();
+			mql?.removeEventListener("change", onSystemChange);
+		};
+	}, []);
+	const setTheme = (0, react.useCallback)((next) => {
+		const resolved = resolveTheme(next);
+		applyDomClass(resolved);
+		persistChoice(next);
+		setState({
+			choice: next,
+			resolved
+		});
+	}, []);
+	return {
+		choice: state.choice,
+		resolved: state.resolved,
+		setTheme
+	};
+}
+//#endregion
+Object.defineProperty(exports, "DOC_ID_PREFIX", {
+	enumerable: true,
+	get: function() {
+		return DOC_ID_PREFIX;
+	}
+});
+Object.defineProperty(exports, "THEME_CHOICES", {
+	enumerable: true,
+	get: function() {
+		return THEME_CHOICES;
+	}
+});
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});
+Object.defineProperty(exports, "cn", {
+	enumerable: true,
+	get: function() {
+		return cn;
+	}
+});
+Object.defineProperty(exports, "docShareUrl", {
+	enumerable: true,
+	get: function() {
+		return docShareUrl;
+	}
+});
+Object.defineProperty(exports, "docSlug", {
+	enumerable: true,
+	get: function() {
+		return docSlug;
+	}
+});
+Object.defineProperty(exports, "findDocAnchor", {
+	enumerable: true,
+	get: function() {
+		return findDocAnchor;
+	}
+});
+Object.defineProperty(exports, "readDocHash", {
+	enumerable: true,
+	get: function() {
+		return readDocHash;
+	}
+});
+Object.defineProperty(exports, "scrollToDocAnchor", {
+	enumerable: true,
+	get: function() {
+		return scrollToDocAnchor;
+	}
+});
+Object.defineProperty(exports, "useTheme", {
+	enumerable: true,
+	get: function() {
+		return useTheme;
+	}
+});
+
+//# sourceMappingURL=use-theme-DFlpXils.cjs.map

package/dist/use-theme-DFlpXils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-theme-DFlpXils.cjs","names":["twMerge","GithubSlugger","THEME_STORAGE_KEY","useState","useCallback"],"sources":["../src/lib/cn.ts","../src/markdown/anchors.ts","../src/layout/use-theme.ts"],"sourcesContent":["import { clsx, type ClassValue } from 'clsx';\nimport { twMerge } from 'tailwind-merge';\n\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n","import GithubSlugger from 'github-slugger';\n\n/**\n * Anchor identity for documentation, in ONE place.\n *\n * Three things have to agree on what `#kak-ustroen-gtin` means: `rehype-slug`,\n * which stamps ids onto headings; the FAQ accordion, which is built from\n * headings but never goes through rehype; and whatever scrolls to a hash. When\n * they disagree the link simply does nothing — no error, no console warning,\n * the page just sits there — so the algorithm lives here and everyone imports it.\n *\n * `github-slugger` is not an extra dependency: `rehype-slug` uses it internally,\n * which is exactly why it is the right choice — matching its output by\n * reimplementing it would be a slow-motion bug in a language with case rules,\n * combining marks and a Cyrillic alphabet.\n */\n\n/** Prefix `rehype-sanitize` renames every id to. See `defaultSchema.clobberPrefix`. */\nexport const DOC_ID_PREFIX = 'user-content-';\n\n/**\n * Slug for a heading's text — the value that appears in a shareable `#hash`.\n *\n * A fresh slugger per call ON PURPOSE. `GithubSlugger` is stateful: it\n * remembers what it has emitted and disambiguates repeats as `foo-1`, `foo-2`.\n * That is right when walking one document top to bottom, and wrong here, where\n * the same heading must produce the same hash every time it is asked about.\n */\nexport function docSlug(text: string): string {\n  return new GithubSlugger().slug(text);\n}\n\n/**\n * The current fragment, DECODED, without its `#`.\n *\n * `window.location.hash` hands back a percent-encoded string —\n * `#%D0%BF%D0%BE%D1%87%D0%B5%D0%BC%D1%83…` for `#почему…` — so every\n * comparison against a slug fails, silently, for exactly the alphabet this\n * project writes its documentation in. It works perfectly in English, which is\n * the worst possible way for it to be wrong.\n */\nexport function readDocHash(): string {\n  if (typeof window === 'undefined') return '';\n  const raw = window.location.hash.replace(/^#/, '');\n  if (raw === '') return '';\n  try {\n    return decodeURIComponent(raw);\n  } catch {\n    // A malformed escape sequence is not worth throwing over.\n    return raw;\n  }\n}\n\n/**\n * Find the element a hash points at.\n *\n * Tries the prefixed id first, because a heading inside sanitized Markdown is\n * the common case, then the bare one for anchors we render ourselves (the FAQ\n * accordion, which is built from React and never passes through the sanitizer).\n */\nexport function findDocAnchor(hash: string, root: Document | Element = document): Element | null {\n  let id = hash.replace(/^#/, '');\n  if (id === '') return null;\n  try {\n    id = decodeURIComponent(id);\n  } catch {\n    /* keep the raw form */\n  }\n\n  /*\n    `getElementById`, NOT `querySelector('#'+id)`.\n\n    A fragment is user input — it arrives from the address bar — and `#a.b:c`\n    is a perfectly ordinary thing to paste and an invalid CSS selector, so\n    `querySelector` throws a `SyntaxError` on it. `CSS.escape` would fix that\n    where it exists, and it does not exist in jsdom, so the crash would have\n    been invisible to the unit suite and live only in production. Looking an id\n    up by id involves no selector parsing at all.\n  */\n  const doc = root.ownerDocument ?? (root as Document);\n  const pick = (candidate: string): Element | null => {\n    const el = doc.getElementById(candidate);\n    if (!el) return null;\n    // Scoped lookups must not reach outside their root — the handbook searches\n    // within the open article so a stale heading elsewhere cannot win.\n    return root === doc || root.contains(el) ? el : null;\n  };\n  return pick(DOC_ID_PREFIX + id) ?? pick(id);\n}\n\n/**\n * Bring an element to the top of ITS OWN scroll container, and nothing else.\n *\n * `scrollIntoView` cannot be used here. It scrolls EVERY scrollable ancestor,\n * the document included — and the document does scroll in this shell, because\n * `SidebarInset` is `min-h-svh` and the app's own sidebar can exceed a short\n * viewport. Clicking an anchor therefore dragged the whole page up: the app\n * header and the handbook's own search box went off the top of the screen, and\n * the layout read as broken. Caught in a screenshot, not by any assertion.\n *\n * Walking to the nearest scrollable ancestor and moving only that keeps the\n * effect where the reader expects it — inside the column they are reading.\n * `scroll-margin-top` is honoured by hand, since we are no longer going through\n * the API that would apply it.\n */\nfunction placeInScroller(target: Element): void {\n  let container = target.parentElement;\n  while (container) {\n    const style = getComputedStyle(container);\n    if (\n      /(auto|scroll)/.test(style.overflowY) &&\n      container.scrollHeight > container.clientHeight + 1\n    ) {\n      break;\n    }\n    container = container.parentElement;\n  }\n  if (!container) {\n    // Nothing between here and the document scrolls; the browser's own\n    // behaviour is then exactly right.\n    target.scrollIntoView({ block: 'start', behavior: 'auto' });\n    return;\n  }\n  const margin = Number.parseFloat(getComputedStyle(target).scrollMarginTop) || 0;\n  const delta = target.getBoundingClientRect().top - container.getBoundingClientRect().top - margin;\n  container.scrollTop += delta;\n}\n\n/**\n * Scroll to an anchor and KEEP it in view while the article settles.\n *\n * One `scrollIntoView` is not enough here. An article's height is not final\n * when its markup lands: a mermaid diagram renders asynchronously and a lazily\n * loaded image has no height until it arrives, and either one appearing ABOVE\n * the target pushes it back down — the reader watches the page scroll to the\n * right place and then drift away from it. Measured: the target ended 731px\n * down a 709px pane, i.e. just off the bottom.\n *\n * So the scroll is repeated whenever the container resizes, for a short window\n * and no longer. The window is a deliberate ceiling rather than a guess at how\n * long rendering takes: after it, the reader owns the scroll position, and\n * yanking it back because a late image loaded would be worse than being a few\n * pixels off.\n */\nexport function scrollToDocAnchor(\n  hash: string,\n  root: Element = document.body,\n  settleMs = 1500,\n): () => void {\n  let stopped = false;\n  const go = () => {\n    if (stopped) return;\n    const target = findDocAnchor(hash, root);\n    if (target) placeInScroller(target);\n  };\n  // Two frames: markdown → hast → DOM, then layout.\n  const raf1 = requestAnimationFrame(() => requestAnimationFrame(go));\n\n  const observer =\n    typeof ResizeObserver === 'undefined'\n      ? null\n      : new ResizeObserver(() => requestAnimationFrame(go));\n  observer?.observe(root);\n  const timer = setTimeout(() => {\n    stopped = true;\n    observer?.disconnect();\n  }, settleMs);\n\n  return () => {\n    stopped = true;\n    cancelAnimationFrame(raf1);\n    observer?.disconnect();\n    clearTimeout(timer);\n  };\n}\n\n/**\n * A shareable url for an anchor on the current page — READABLE.\n *\n * `new URL(…).toString()` percent-encodes the fragment, so a Russian heading\n * becomes forty characters of `%D0%BF%D0%BE…`. That is correct and unusable:\n * the entire point of this link is being pasted into a message where a person\n * reads it, and a wall of escapes tells them nothing about where it goes.\n * Browsers accept a literal fragment and encode it themselves on navigation.\n *\n * The slug is still escaped if it contains anything that would change how the\n * url PARSES — `#`, `?`, whitespace, or a stray `%`. `github-slugger` does not\n * emit those, but this is the one place where being wrong produces a link that\n * silently points somewhere else.\n */\nexport function docShareUrl(slug: string, href: string = window.location.href): string {\n  const url = new URL(href);\n  const safe = /[#?%\\s]/.test(slug) ? encodeURIComponent(slug) : slug;\n  return `${url.origin}${url.pathname}${url.search}#${safe}`;\n}\n","'use client';\nimport { useCallback, useEffect, useState } from 'react';\nimport { THEME_STORAGE_KEY } from './theme-storage-key.js';\n\n/**\n * Re-exported here so most consumers only need one import path. A pre-paint\n * bootstrap is the one exception — `examples/next/app/layout.tsx` imports the\n * constant from the separate, hook-free `@burojs/ui-shadcn/theme-storage-key`\n * subpath instead; see `./theme-storage-key.js` for why a Server Component\n * cannot import it from here.\n */\nexport { THEME_STORAGE_KEY };\n\n/** What the user picked. `'system'` means \"no explicit choice\" — nothing is\n * persisted for it; its absence from storage IS the `system` state. */\nexport type ThemeChoice = 'light' | 'dark' | 'system';\n\n/** Every theme choice, in the order a control offers them. */\nexport const THEME_CHOICES: readonly ThemeChoice[] = ['light', 'dark', 'system'];\n\n/** What is actually painted. Never `'system'` — every reader (Toaster,\n * CodeMirror, Mermaid) only ever needs to know light or dark. */\nexport type ResolvedTheme = 'light' | 'dark';\n\nexport interface UseThemeResult {\n  /** The persisted preference, including `'system'`. Only the theme\n   * submenu (the one place with a three-way control) needs this. */\n  choice: ThemeChoice;\n  /** The resolved light/dark value, kept in sync with the `dark` class on\n   * `<html>`. This is what every read-only consumer wants. */\n  resolved: ResolvedTheme;\n  /** Set a new choice: applies the `dark` class immediately and persists\n   * (or, for `'system'`, clears) the preference. */\n  setTheme: (next: ThemeChoice) => void;\n}\n\nfunction systemPrefersDark(): boolean {\n  return (\n    typeof window !== 'undefined' &&\n    typeof window.matchMedia === 'function' &&\n    window.matchMedia('(prefers-color-scheme: dark)').matches\n  );\n}\n\nfunction readChoice(): ThemeChoice {\n  if (typeof window === 'undefined') return 'system';\n  try {\n    const saved = window.localStorage.getItem(THEME_STORAGE_KEY);\n    if (saved === 'light' || saved === 'dark') return saved;\n  } catch {\n    // localStorage may be disabled — fall through to system\n  }\n  return 'system';\n}\n\nfunction resolveTheme(choice: ThemeChoice): ResolvedTheme {\n  if (choice === 'light' || choice === 'dark') return choice;\n  return systemPrefersDark() ? 'dark' : 'light';\n}\n\nfunction applyDomClass(resolved: ResolvedTheme): void {\n  if (typeof document === 'undefined') return;\n  document.documentElement.classList.toggle('dark', resolved === 'dark');\n}\n\nfunction persistChoice(choice: ThemeChoice): void {\n  if (typeof window === 'undefined') return;\n  try {\n    if (choice === 'system') window.localStorage.removeItem(THEME_STORAGE_KEY);\n    else window.localStorage.setItem(THEME_STORAGE_KEY, choice);\n  } catch {\n    // localStorage may be disabled — the class flip already applied.\n  }\n}\n\ninterface ThemeState {\n  choice: ThemeChoice;\n  resolved: ResolvedTheme;\n}\n\n/**\n * Single source of truth for light/dark/system, replacing seven places that\n * each used to know about the theme independently (a bootstrap script, a\n * command-palette action, a submenu, an unused kit component, and three\n * MutationObserver-based readers).\n *\n * Read-only consumers (Toaster, CodeMirror, Mermaid) only need `resolved`\n * and don't call the public `setTheme`  — they stay in sync via the\n * `<html class=\"dark\">` MutationObserver below, which fires regardless of\n * WHICH writer flipped it. That is deliberate: it's the same mechanism these\n * three already used individually before this hook existed, now shared\n * instead of duplicated, and it means a future writer doesn't need to know\n * about every reader. Every mounted instance — including these \"read-only\"\n * ones — still runs its OWN `onSystemChange` listener below and applies the\n * class itself on an OS change; see that listener for why re-reading storage\n * there (rather than trusting this instance's local `choice`) is required\n * for that to be safe with several instances mounted at once.\n *\n * `choice` (the three-way value, including `'system'`) is NOT synchronized\n * the same way — the `dark` class alone can't tell \"explicitly dark\" apart\n * from \"system, and the system happens to be dark\". The only consumer that\n * needs `choice` is the theme submenu, and Radix unmounts a closed dropdown's\n * content, so it re-reads storage fresh every time it opens; no live\n * cross-component sync of `choice` is needed in practice.\n *\n * NOT used by the bootstrap `<script>` in `app/layout.tsx` — see the comment\n * there for why a hook cannot do that job.\n */\nexport function useTheme(): UseThemeResult {\n  // Safe default for the very first client render, corrected synchronously\n  // by the effect below on mount — mirrors the pattern the three readers\n  // used before migrating here (start light/false, fix it post-mount) so no\n  // component newly grows a hydration-mismatch warning.\n  const [state, setState] = useState<ThemeState>({ choice: 'system', resolved: 'light' });\n\n  useEffect(() => {\n    const choice = readChoice();\n    setState({ choice, resolved: resolveTheme(choice) });\n\n    const root = document.documentElement;\n    const observer = new MutationObserver(() => {\n      const resolved: ResolvedTheme = root.classList.contains('dark') ? 'dark' : 'light';\n      setState((prev) => (prev.resolved === resolved ? prev : { ...prev, resolved }));\n    });\n    observer.observe(root, { attributes: true, attributeFilter: ['class'] });\n\n    const mql =\n      typeof window.matchMedia === 'function'\n        ? window.matchMedia('(prefers-color-scheme: dark)')\n        : undefined;\n    const onSystemChange = (event: { matches: boolean }) => {\n      // Re-read the stored choice instead of trusting this instance's own\n      // `prev.choice`: `choice` is captured once at mount and never\n      // resynchronised, but several `useTheme()` instances mount at once\n      // (Toaster, CodeMirror, Mermaid, the admin layout, the theme submenu\n      // while open). If a later explicit pick only updates the instance that\n      // made it, every OTHER instance still believes `system` applies and\n      // would repaint the whole app back to the OS value on the next\n      // preference flip — silently overriding storage, which is why this\n      // must not trust local state. Storage is already the single source of\n      // truth (`setTheme('system')` clears the key), so a fresh read here is\n      // correct in both directions: an explicit pick is respected, and\n      // `system` is honoured even once the one instance that set it has\n      // unmounted. Every other live instance's listener fires on the same OS\n      // change and independently reaches the same conclusion, so several\n      // instances may call `applyDomClass` with the same value for one\n      // event — redundant, but harmless, and not worth coordinating.\n      const choice = readChoice();\n      if (choice !== 'system') return;\n      const resolved: ResolvedTheme = event.matches ? 'dark' : 'light';\n      applyDomClass(resolved);\n      setState((prev) =>\n        prev.choice === choice && prev.resolved === resolved ? prev : { choice, resolved },\n      );\n    };\n    mql?.addEventListener('change', onSystemChange);\n\n    return () => {\n      observer.disconnect();\n      mql?.removeEventListener('change', onSystemChange);\n    };\n  }, []);\n\n  const setTheme = useCallback((next: ThemeChoice) => {\n    const resolved = resolveTheme(next);\n    applyDomClass(resolved);\n    persistChoice(next);\n    setState({ choice: next, resolved });\n  }, []);\n\n  return { choice: state.choice, resolved: state.resolved, setTheme };\n}\n"],"mappings":"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"}

package/dist/use-theme-dnE3Od3I.js

@@ -0,0 +1,175 @@
+import { THEME_STORAGE_KEY } from "./layout/theme-storage-key.js";
+import { useCallback, useEffect, useState } from "react";
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+import GithubSlugger from "github-slugger";
+//#region src/lib/cn.ts
+function cn(...inputs) {
+	return twMerge(clsx(inputs));
+}
+//#endregion
+//#region src/markdown/anchors.ts
+const DOC_ID_PREFIX = "user-content-";
+function docSlug(text) {
+	return new GithubSlugger().slug(text);
+}
+function readDocHash() {
+	if (typeof window === "undefined") return "";
+	const raw = window.location.hash.replace(/^#/, "");
+	if (raw === "") return "";
+	try {
+		return decodeURIComponent(raw);
+	} catch {
+		return raw;
+	}
+}
+function findDocAnchor(hash, root = document) {
+	let id = hash.replace(/^#/, "");
+	if (id === "") return null;
+	try {
+		id = decodeURIComponent(id);
+	} catch {}
+	const doc = root.ownerDocument ?? root;
+	const pick = (candidate) => {
+		const el = doc.getElementById(candidate);
+		if (!el) return null;
+		return root === doc || root.contains(el) ? el : null;
+	};
+	return pick("user-content-" + id) ?? pick(id);
+}
+function placeInScroller(target) {
+	let container = target.parentElement;
+	while (container) {
+		const style = getComputedStyle(container);
+		if (/(auto|scroll)/.test(style.overflowY) && container.scrollHeight > container.clientHeight + 1) break;
+		container = container.parentElement;
+	}
+	if (!container) {
+		target.scrollIntoView({
+			block: "start",
+			behavior: "auto"
+		});
+		return;
+	}
+	const margin = Number.parseFloat(getComputedStyle(target).scrollMarginTop) || 0;
+	const delta = target.getBoundingClientRect().top - container.getBoundingClientRect().top - margin;
+	container.scrollTop += delta;
+}
+function scrollToDocAnchor(hash, root = document.body, settleMs = 1500) {
+	let stopped = false;
+	const go = () => {
+		if (stopped) return;
+		const target = findDocAnchor(hash, root);
+		if (target) placeInScroller(target);
+	};
+	const raf1 = requestAnimationFrame(() => requestAnimationFrame(go));
+	const observer = typeof ResizeObserver === "undefined" ? null : new ResizeObserver(() => requestAnimationFrame(go));
+	observer?.observe(root);
+	const timer = setTimeout(() => {
+		stopped = true;
+		observer?.disconnect();
+	}, settleMs);
+	return () => {
+		stopped = true;
+		cancelAnimationFrame(raf1);
+		observer?.disconnect();
+		clearTimeout(timer);
+	};
+}
+function docShareUrl(slug, href = window.location.href) {
+	const url = new URL(href);
+	const safe = /[#?%\s]/.test(slug) ? encodeURIComponent(slug) : slug;
+	return `${url.origin}${url.pathname}${url.search}#${safe}`;
+}
+//#endregion
+//#region src/layout/use-theme.ts
+const THEME_CHOICES = [
+	"light",
+	"dark",
+	"system"
+];
+function systemPrefersDark() {
+	return typeof window !== "undefined" && typeof window.matchMedia === "function" && window.matchMedia("(prefers-color-scheme: dark)").matches;
+}
+function readChoice() {
+	if (typeof window === "undefined") return "system";
+	try {
+		const saved = window.localStorage.getItem(THEME_STORAGE_KEY);
+		if (saved === "light" || saved === "dark") return saved;
+	} catch {}
+	return "system";
+}
+function resolveTheme(choice) {
+	if (choice === "light" || choice === "dark") return choice;
+	return systemPrefersDark() ? "dark" : "light";
+}
+function applyDomClass(resolved) {
+	if (typeof document === "undefined") return;
+	document.documentElement.classList.toggle("dark", resolved === "dark");
+}
+function persistChoice(choice) {
+	if (typeof window === "undefined") return;
+	try {
+		if (choice === "system") window.localStorage.removeItem(THEME_STORAGE_KEY);
+		else window.localStorage.setItem(THEME_STORAGE_KEY, choice);
+	} catch {}
+}
+function useTheme() {
+	const [state, setState] = useState({
+		choice: "system",
+		resolved: "light"
+	});
+	useEffect(() => {
+		const choice = readChoice();
+		setState({
+			choice,
+			resolved: resolveTheme(choice)
+		});
+		const root = document.documentElement;
+		const observer = new MutationObserver(() => {
+			const resolved = root.classList.contains("dark") ? "dark" : "light";
+			setState((prev) => prev.resolved === resolved ? prev : {
+				...prev,
+				resolved
+			});
+		});
+		observer.observe(root, {
+			attributes: true,
+			attributeFilter: ["class"]
+		});
+		const mql = typeof window.matchMedia === "function" ? window.matchMedia("(prefers-color-scheme: dark)") : void 0;
+		const onSystemChange = (event) => {
+			const choice = readChoice();
+			if (choice !== "system") return;
+			const resolved = event.matches ? "dark" : "light";
+			applyDomClass(resolved);
+			setState((prev) => prev.choice === choice && prev.resolved === resolved ? prev : {
+				choice,
+				resolved
+			});
+		};
+		mql?.addEventListener("change", onSystemChange);
+		return () => {
+			observer.disconnect();
+			mql?.removeEventListener("change", onSystemChange);
+		};
+	}, []);
+	const setTheme = useCallback((next) => {
+		const resolved = resolveTheme(next);
+		applyDomClass(resolved);
+		persistChoice(next);
+		setState({
+			choice: next,
+			resolved
+		});
+	}, []);
+	return {
+		choice: state.choice,
+		resolved: state.resolved,
+		setTheme
+	};
+}
+//#endregion
+export { docSlug as a, scrollToDocAnchor as c, docShareUrl as i, cn as l, useTheme as n, findDocAnchor as o, DOC_ID_PREFIX as r, readDocHash as s, THEME_CHOICES as t };
+
+//# sourceMappingURL=use-theme-dnE3Od3I.js.map

package/dist/use-theme-dnE3Od3I.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-theme-dnE3Od3I.js","names":[],"sources":["../src/lib/cn.ts","../src/markdown/anchors.ts","../src/layout/use-theme.ts"],"sourcesContent":["import { clsx, type ClassValue } from 'clsx';\nimport { twMerge } from 'tailwind-merge';\n\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n","import GithubSlugger from 'github-slugger';\n\n/**\n * Anchor identity for documentation, in ONE place.\n *\n * Three things have to agree on what `#kak-ustroen-gtin` means: `rehype-slug`,\n * which stamps ids onto headings; the FAQ accordion, which is built from\n * headings but never goes through rehype; and whatever scrolls to a hash. When\n * they disagree the link simply does nothing — no error, no console warning,\n * the page just sits there — so the algorithm lives here and everyone imports it.\n *\n * `github-slugger` is not an extra dependency: `rehype-slug` uses it internally,\n * which is exactly why it is the right choice — matching its output by\n * reimplementing it would be a slow-motion bug in a language with case rules,\n * combining marks and a Cyrillic alphabet.\n */\n\n/** Prefix `rehype-sanitize` renames every id to. See `defaultSchema.clobberPrefix`. */\nexport const DOC_ID_PREFIX = 'user-content-';\n\n/**\n * Slug for a heading's text — the value that appears in a shareable `#hash`.\n *\n * A fresh slugger per call ON PURPOSE. `GithubSlugger` is stateful: it\n * remembers what it has emitted and disambiguates repeats as `foo-1`, `foo-2`.\n * That is right when walking one document top to bottom, and wrong here, where\n * the same heading must produce the same hash every time it is asked about.\n */\nexport function docSlug(text: string): string {\n  return new GithubSlugger().slug(text);\n}\n\n/**\n * The current fragment, DECODED, without its `#`.\n *\n * `window.location.hash` hands back a percent-encoded string —\n * `#%D0%BF%D0%BE%D1%87%D0%B5%D0%BC%D1%83…` for `#почему…` — so every\n * comparison against a slug fails, silently, for exactly the alphabet this\n * project writes its documentation in. It works perfectly in English, which is\n * the worst possible way for it to be wrong.\n */\nexport function readDocHash(): string {\n  if (typeof window === 'undefined') return '';\n  const raw = window.location.hash.replace(/^#/, '');\n  if (raw === '') return '';\n  try {\n    return decodeURIComponent(raw);\n  } catch {\n    // A malformed escape sequence is not worth throwing over.\n    return raw;\n  }\n}\n\n/**\n * Find the element a hash points at.\n *\n * Tries the prefixed id first, because a heading inside sanitized Markdown is\n * the common case, then the bare one for anchors we render ourselves (the FAQ\n * accordion, which is built from React and never passes through the sanitizer).\n */\nexport function findDocAnchor(hash: string, root: Document | Element = document): Element | null {\n  let id = hash.replace(/^#/, '');\n  if (id === '') return null;\n  try {\n    id = decodeURIComponent(id);\n  } catch {\n    /* keep the raw form */\n  }\n\n  /*\n    `getElementById`, NOT `querySelector('#'+id)`.\n\n    A fragment is user input — it arrives from the address bar — and `#a.b:c`\n    is a perfectly ordinary thing to paste and an invalid CSS selector, so\n    `querySelector` throws a `SyntaxError` on it. `CSS.escape` would fix that\n    where it exists, and it does not exist in jsdom, so the crash would have\n    been invisible to the unit suite and live only in production. Looking an id\n    up by id involves no selector parsing at all.\n  */\n  const doc = root.ownerDocument ?? (root as Document);\n  const pick = (candidate: string): Element | null => {\n    const el = doc.getElementById(candidate);\n    if (!el) return null;\n    // Scoped lookups must not reach outside their root — the handbook searches\n    // within the open article so a stale heading elsewhere cannot win.\n    return root === doc || root.contains(el) ? el : null;\n  };\n  return pick(DOC_ID_PREFIX + id) ?? pick(id);\n}\n\n/**\n * Bring an element to the top of ITS OWN scroll container, and nothing else.\n *\n * `scrollIntoView` cannot be used here. It scrolls EVERY scrollable ancestor,\n * the document included — and the document does scroll in this shell, because\n * `SidebarInset` is `min-h-svh` and the app's own sidebar can exceed a short\n * viewport. Clicking an anchor therefore dragged the whole page up: the app\n * header and the handbook's own search box went off the top of the screen, and\n * the layout read as broken. Caught in a screenshot, not by any assertion.\n *\n * Walking to the nearest scrollable ancestor and moving only that keeps the\n * effect where the reader expects it — inside the column they are reading.\n * `scroll-margin-top` is honoured by hand, since we are no longer going through\n * the API that would apply it.\n */\nfunction placeInScroller(target: Element): void {\n  let container = target.parentElement;\n  while (container) {\n    const style = getComputedStyle(container);\n    if (\n      /(auto|scroll)/.test(style.overflowY) &&\n      container.scrollHeight > container.clientHeight + 1\n    ) {\n      break;\n    }\n    container = container.parentElement;\n  }\n  if (!container) {\n    // Nothing between here and the document scrolls; the browser's own\n    // behaviour is then exactly right.\n    target.scrollIntoView({ block: 'start', behavior: 'auto' });\n    return;\n  }\n  const margin = Number.parseFloat(getComputedStyle(target).scrollMarginTop) || 0;\n  const delta = target.getBoundingClientRect().top - container.getBoundingClientRect().top - margin;\n  container.scrollTop += delta;\n}\n\n/**\n * Scroll to an anchor and KEEP it in view while the article settles.\n *\n * One `scrollIntoView` is not enough here. An article's height is not final\n * when its markup lands: a mermaid diagram renders asynchronously and a lazily\n * loaded image has no height until it arrives, and either one appearing ABOVE\n * the target pushes it back down — the reader watches the page scroll to the\n * right place and then drift away from it. Measured: the target ended 731px\n * down a 709px pane, i.e. just off the bottom.\n *\n * So the scroll is repeated whenever the container resizes, for a short window\n * and no longer. The window is a deliberate ceiling rather than a guess at how\n * long rendering takes: after it, the reader owns the scroll position, and\n * yanking it back because a late image loaded would be worse than being a few\n * pixels off.\n */\nexport function scrollToDocAnchor(\n  hash: string,\n  root: Element = document.body,\n  settleMs = 1500,\n): () => void {\n  let stopped = false;\n  const go = () => {\n    if (stopped) return;\n    const target = findDocAnchor(hash, root);\n    if (target) placeInScroller(target);\n  };\n  // Two frames: markdown → hast → DOM, then layout.\n  const raf1 = requestAnimationFrame(() => requestAnimationFrame(go));\n\n  const observer =\n    typeof ResizeObserver === 'undefined'\n      ? null\n      : new ResizeObserver(() => requestAnimationFrame(go));\n  observer?.observe(root);\n  const timer = setTimeout(() => {\n    stopped = true;\n    observer?.disconnect();\n  }, settleMs);\n\n  return () => {\n    stopped = true;\n    cancelAnimationFrame(raf1);\n    observer?.disconnect();\n    clearTimeout(timer);\n  };\n}\n\n/**\n * A shareable url for an anchor on the current page — READABLE.\n *\n * `new URL(…).toString()` percent-encodes the fragment, so a Russian heading\n * becomes forty characters of `%D0%BF%D0%BE…`. That is correct and unusable:\n * the entire point of this link is being pasted into a message where a person\n * reads it, and a wall of escapes tells them nothing about where it goes.\n * Browsers accept a literal fragment and encode it themselves on navigation.\n *\n * The slug is still escaped if it contains anything that would change how the\n * url PARSES — `#`, `?`, whitespace, or a stray `%`. `github-slugger` does not\n * emit those, but this is the one place where being wrong produces a link that\n * silently points somewhere else.\n */\nexport function docShareUrl(slug: string, href: string = window.location.href): string {\n  const url = new URL(href);\n  const safe = /[#?%\\s]/.test(slug) ? encodeURIComponent(slug) : slug;\n  return `${url.origin}${url.pathname}${url.search}#${safe}`;\n}\n","'use client';\nimport { useCallback, useEffect, useState } from 'react';\nimport { THEME_STORAGE_KEY } from './theme-storage-key.js';\n\n/**\n * Re-exported here so most consumers only need one import path. A pre-paint\n * bootstrap is the one exception — `examples/next/app/layout.tsx` imports the\n * constant from the separate, hook-free `@burojs/ui-shadcn/theme-storage-key`\n * subpath instead; see `./theme-storage-key.js` for why a Server Component\n * cannot import it from here.\n */\nexport { THEME_STORAGE_KEY };\n\n/** What the user picked. `'system'` means \"no explicit choice\" — nothing is\n * persisted for it; its absence from storage IS the `system` state. */\nexport type ThemeChoice = 'light' | 'dark' | 'system';\n\n/** Every theme choice, in the order a control offers them. */\nexport const THEME_CHOICES: readonly ThemeChoice[] = ['light', 'dark', 'system'];\n\n/** What is actually painted. Never `'system'` — every reader (Toaster,\n * CodeMirror, Mermaid) only ever needs to know light or dark. */\nexport type ResolvedTheme = 'light' | 'dark';\n\nexport interface UseThemeResult {\n  /** The persisted preference, including `'system'`. Only the theme\n   * submenu (the one place with a three-way control) needs this. */\n  choice: ThemeChoice;\n  /** The resolved light/dark value, kept in sync with the `dark` class on\n   * `<html>`. This is what every read-only consumer wants. */\n  resolved: ResolvedTheme;\n  /** Set a new choice: applies the `dark` class immediately and persists\n   * (or, for `'system'`, clears) the preference. */\n  setTheme: (next: ThemeChoice) => void;\n}\n\nfunction systemPrefersDark(): boolean {\n  return (\n    typeof window !== 'undefined' &&\n    typeof window.matchMedia === 'function' &&\n    window.matchMedia('(prefers-color-scheme: dark)').matches\n  );\n}\n\nfunction readChoice(): ThemeChoice {\n  if (typeof window === 'undefined') return 'system';\n  try {\n    const saved = window.localStorage.getItem(THEME_STORAGE_KEY);\n    if (saved === 'light' || saved === 'dark') return saved;\n  } catch {\n    // localStorage may be disabled — fall through to system\n  }\n  return 'system';\n}\n\nfunction resolveTheme(choice: ThemeChoice): ResolvedTheme {\n  if (choice === 'light' || choice === 'dark') return choice;\n  return systemPrefersDark() ? 'dark' : 'light';\n}\n\nfunction applyDomClass(resolved: ResolvedTheme): void {\n  if (typeof document === 'undefined') return;\n  document.documentElement.classList.toggle('dark', resolved === 'dark');\n}\n\nfunction persistChoice(choice: ThemeChoice): void {\n  if (typeof window === 'undefined') return;\n  try {\n    if (choice === 'system') window.localStorage.removeItem(THEME_STORAGE_KEY);\n    else window.localStorage.setItem(THEME_STORAGE_KEY, choice);\n  } catch {\n    // localStorage may be disabled — the class flip already applied.\n  }\n}\n\ninterface ThemeState {\n  choice: ThemeChoice;\n  resolved: ResolvedTheme;\n}\n\n/**\n * Single source of truth for light/dark/system, replacing seven places that\n * each used to know about the theme independently (a bootstrap script, a\n * command-palette action, a submenu, an unused kit component, and three\n * MutationObserver-based readers).\n *\n * Read-only consumers (Toaster, CodeMirror, Mermaid) only need `resolved`\n * and don't call the public `setTheme`  — they stay in sync via the\n * `<html class=\"dark\">` MutationObserver below, which fires regardless of\n * WHICH writer flipped it. That is deliberate: it's the same mechanism these\n * three already used individually before this hook existed, now shared\n * instead of duplicated, and it means a future writer doesn't need to know\n * about every reader. Every mounted instance — including these \"read-only\"\n * ones — still runs its OWN `onSystemChange` listener below and applies the\n * class itself on an OS change; see that listener for why re-reading storage\n * there (rather than trusting this instance's local `choice`) is required\n * for that to be safe with several instances mounted at once.\n *\n * `choice` (the three-way value, including `'system'`) is NOT synchronized\n * the same way — the `dark` class alone can't tell \"explicitly dark\" apart\n * from \"system, and the system happens to be dark\". The only consumer that\n * needs `choice` is the theme submenu, and Radix unmounts a closed dropdown's\n * content, so it re-reads storage fresh every time it opens; no live\n * cross-component sync of `choice` is needed in practice.\n *\n * NOT used by the bootstrap `<script>` in `app/layout.tsx` — see the comment\n * there for why a hook cannot do that job.\n */\nexport function useTheme(): UseThemeResult {\n  // Safe default for the very first client render, corrected synchronously\n  // by the effect below on mount — mirrors the pattern the three readers\n  // used before migrating here (start light/false, fix it post-mount) so no\n  // component newly grows a hydration-mismatch warning.\n  const [state, setState] = useState<ThemeState>({ choice: 'system', resolved: 'light' });\n\n  useEffect(() => {\n    const choice = readChoice();\n    setState({ choice, resolved: resolveTheme(choice) });\n\n    const root = document.documentElement;\n    const observer = new MutationObserver(() => {\n      const resolved: ResolvedTheme = root.classList.contains('dark') ? 'dark' : 'light';\n      setState((prev) => (prev.resolved === resolved ? prev : { ...prev, resolved }));\n    });\n    observer.observe(root, { attributes: true, attributeFilter: ['class'] });\n\n    const mql =\n      typeof window.matchMedia === 'function'\n        ? window.matchMedia('(prefers-color-scheme: dark)')\n        : undefined;\n    const onSystemChange = (event: { matches: boolean }) => {\n      // Re-read the stored choice instead of trusting this instance's own\n      // `prev.choice`: `choice` is captured once at mount and never\n      // resynchronised, but several `useTheme()` instances mount at once\n      // (Toaster, CodeMirror, Mermaid, the admin layout, the theme submenu\n      // while open). If a later explicit pick only updates the instance that\n      // made it, every OTHER instance still believes `system` applies and\n      // would repaint the whole app back to the OS value on the next\n      // preference flip — silently overriding storage, which is why this\n      // must not trust local state. Storage is already the single source of\n      // truth (`setTheme('system')` clears the key), so a fresh read here is\n      // correct in both directions: an explicit pick is respected, and\n      // `system` is honoured even once the one instance that set it has\n      // unmounted. Every other live instance's listener fires on the same OS\n      // change and independently reaches the same conclusion, so several\n      // instances may call `applyDomClass` with the same value for one\n      // event — redundant, but harmless, and not worth coordinating.\n      const choice = readChoice();\n      if (choice !== 'system') return;\n      const resolved: ResolvedTheme = event.matches ? 'dark' : 'light';\n      applyDomClass(resolved);\n      setState((prev) =>\n        prev.choice === choice && prev.resolved === resolved ? prev : { choice, resolved },\n      );\n    };\n    mql?.addEventListener('change', onSystemChange);\n\n    return () => {\n      observer.disconnect();\n      mql?.removeEventListener('change', onSystemChange);\n    };\n  }, []);\n\n  const setTheme = useCallback((next: ThemeChoice) => {\n    const resolved = resolveTheme(next);\n    applyDomClass(resolved);\n    persistChoice(next);\n    setState({ choice: next, resolved });\n  }, []);\n\n  return { choice: state.choice, resolved: state.resolved, setTheme };\n}\n"],"mappings":"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"}