@burojs/ui-shadcn 0.5.0 → 0.7.0

package/dist/{toaster-C7CiYA4Z.cjs → toaster-BbByOytP.cjs}

@@ -39,57 +39,26 @@ function useLinkComponent() {
 	return (0, react.useContext)(LinkComponentContext);
 }
 //#endregion
-//#region src/layout/language-storage.ts
-const DEFAULT_LANGUAGE = "ru";
-function loadLanguage(storageKey = _burojs_react.DEFAULT_LANGUAGE_STORAGE_KEY) {
-	if (typeof window === "undefined") return "ru";
-	try {
-		const saved = window.localStorage.getItem(storageKey);
-		if (saved === "ru" || saved === "en") return saved;
-	} catch {}
-	return "ru";
-}
-function saveLanguage(code, storageKey = _burojs_react.DEFAULT_LANGUAGE_STORAGE_KEY) {
-	if (typeof window === "undefined") return;
-	try {
-		window.localStorage.setItem(storageKey, code);
-	} catch {}
-}
-function loadLocale(storageKey = _burojs_react.DEFAULT_LANGUAGE_STORAGE_KEY) {
-	if (typeof window === "undefined") return void 0;
-	try {
-		return window.localStorage.getItem(storageKey) ?? void 0;
-	} catch {
-		return;
-	}
-}
-function saveLocale(code, storageKey = _burojs_react.DEFAULT_LANGUAGE_STORAGE_KEY) {
-	if (typeof window === "undefined") return;
-	try {
-		window.localStorage.setItem(storageKey, code);
-	} catch {}
-}
-//#endregion
 //#region src/lib/friendly-error.ts
 const DEV_FACING = /^Error \(status code:|^Failed to fetch$|^NetworkError|^Load failed$|^TypeError: (Failed to fetch|NetworkError)/i;
 const NETWORK = /Failed to fetch|NetworkError|Load failed|ERR_INTERNET_DISCONNECTED/i;
 const HTTP_TRACE = /\b(?:GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\b[^\n]*->\s*(\d{3})\b/;
-const STRINGS = {
-	ru: {
-		title: "Не удалось выполнить запрос",
-		offline: "Нет связи с сервером. Проверьте подключение и повторите.",
-		unavailable: "Сервис временно недоступен. Повторите попытку через минуту.",
-		generic: "Попробуйте повторить действие."
-	},
-	en: {
-		title: "Request failed",
-		offline: "Cannot reach the server. Check your connection and try again.",
-		unavailable: "The service is temporarily unavailable. Try again in a minute.",
-		generic: "Please try again."
-	}
+const en = {
+	title: "Request failed",
+	offline: "Cannot reach the server. Check your connection and try again.",
+	unavailable: "The service is temporarily unavailable. Try again in a minute.",
+	generic: "Please try again."
 };
-function toFriendlyError(message, description, locale) {
-	const s = (locale !== void 0 ? STRINGS[locale] : void 0) ?? STRINGS.en;
+function friendlyStringsFrom(t) {
+	const pick = (name) => t(`requestError.${name}`, { defaultValue: en[name] }) || en[name];
+	return {
+		title: pick("title"),
+		offline: pick("offline"),
+		unavailable: pick("unavailable"),
+		generic: pick("generic")
+	};
+}
+function toFriendlyError(message, description, strings) {
 	const raw = `${String(message ?? "")} ${String(description ?? "")}`;
 	const isDevFacing = DEV_FACING.test(String(message ?? "").trim());
 	const isNetwork = NETWORK.test(raw);
@@ -97,8 +66,8 @@ function toFriendlyError(message, description, locale) {
 	if (trace) {
 		const status = Number(trace[1]);
 		return {
-			title: s.title,
-			detail: status >= 500 ? s.unavailable : s.generic,
+			title: strings.title,
+			detail: status >= 500 ? strings.unavailable : strings.generic,
 			replaced: true
 		};
 	}
@@ -108,21 +77,42 @@ function toFriendlyError(message, description, locale) {
 		replaced: false
 	};
 	return {
-		title: s.title,
-		detail: isNetwork ? s.offline : String(description ?? "") || s.generic,
+		title: strings.title,
+		detail: isNetwork ? strings.offline : String(description ?? "") || strings.generic,
 		replaced: true
 	};
 }
+function isNetworkFailure(text) {
+	return NETWORK.test(text);
+}
+function technicalTexts(error) {
+	if (error === null || typeof error !== "object") return [];
+	const out = [];
+	try {
+		const { details, cause } = error;
+		if (typeof details === "string") out.push(details);
+		else if (details !== null && typeof details === "object") {
+			const inner = details.message;
+			if (typeof inner === "string") out.push(inner);
+		}
+		if (cause instanceof Error) out.push(cause.message);
+		else if (typeof cause === "string") out.push(cause);
+		if (error instanceof Error) out.push(error.message);
+	} catch {}
+	return out;
+}
+function technicalText(error) {
+	return technicalTexts(error)[0];
+}
 //#endregion
 //#region src/notification/notification-provider.ts
 function createNotificationProvider(options = {}) {
-	const resolveLocale = options.resolveLocale ?? (() => loadLocale());
 	return {
 		open: ({ type, message, description }) => {
 			let text = message;
 			let detail = description;
 			if (type === "error") {
-				const friendly = toFriendlyError(message, description, resolveLocale());
+				const friendly = toFriendlyError(message, description, options.resolveStrings?.() ?? en);
 				text = friendly.title;
 				detail = friendly.detail;
 			}
@@ -138,34 +128,36 @@ function createNotificationProvider(options = {}) {
 function Toaster(props) {
 	const t = (0, _burojs_react.useOptionalT)();
 	const { resolved: theme } = require_use_theme.useTheme();
-	const locale = (0, _burojs_react.useOptionalLocale)();
-	const localeRef = (0, react.useRef)(locale);
-	localeRef.current = locale;
-	const sink = (0, react.useMemo)(() => createNotificationProvider({ resolveLocale: () => localeRef.current ?? loadLocale() }), []);
+	const tRef = (0, react.useRef)(t);
+	tRef.current = t;
+	const sink = (0, react.useMemo)(() => createNotificationProvider({ resolveStrings: () => friendlyStringsFrom(tRef.current) }), []);
 	(0, _burojs_react.useRegisterNotificationSink)(sink);
+	const { toastOptions, ...rest } = props;
+	const kitClassNames = {
+		toast: "group toast group-[.toaster]:bg-background group-[.toaster]:text-foreground group-[.toaster]:border-border group-[.toaster]:shadow-lg",
+		description: "group-[.toast]:text-muted-foreground",
+		actionButton: "group-[.toast]:bg-primary group-[.toast]:text-primary-foreground",
+		cancelButton: "group-[.toast]:bg-muted group-[.toast]:text-muted-foreground",
+		closeButton: "group-[.toast]:bg-background group-[.toast]:text-muted-foreground group-[.toast]:border-border group-[.toast]:hover:bg-muted group-[.toast]:hover:text-foreground"
+	};
 	return (0, react_jsx_runtime.jsx)(sonner.Toaster, {
-		containerAriaLabel: t("notifications.region", { defaultValue: "Notifications" }),
+		customAriaLabel: props.customAriaLabel ?? props.containerAriaLabel ?? t("notifications.region", { defaultValue: "Notifications" }),
 		theme,
 		position: "top-right",
 		closeButton: true,
 		className: "toaster group",
-		toastOptions: { classNames: {
-			toast: "group toast group-[.toaster]:bg-background group-[.toaster]:text-foreground group-[.toaster]:border-border group-[.toaster]:shadow-lg",
-			description: "group-[.toast]:text-muted-foreground",
-			actionButton: "group-[.toast]:bg-primary group-[.toast]:text-primary-foreground",
-			cancelButton: "group-[.toast]:bg-muted group-[.toast]:text-muted-foreground",
-			closeButton: "group-[.toast]:bg-background group-[.toast]:text-muted-foreground group-[.toast]:border-border group-[.toast]:hover:bg-muted group-[.toast]:hover:text-foreground"
-		} },
-		...props
+		...rest,
+		toastOptions: {
+			...toastOptions,
+			classNames: {
+				...kitClassNames,
+				...toastOptions?.classNames
+			},
+			closeButtonAriaLabel: toastOptions?.closeButtonAriaLabel ?? t("notifications.close", { defaultValue: "Close notification" })
+		}
 	});
 }
 //#endregion
-Object.defineProperty(exports, "DEFAULT_LANGUAGE", {
-	enumerable: true,
-	get: function() {
-		return DEFAULT_LANGUAGE;
-	}
-});
 Object.defineProperty(exports, "LinkComponentProvider", {
 	enumerable: true,
 	get: function() {
@@ -208,28 +200,28 @@ Object.defineProperty(exports, "Toaster", {
 		return Toaster;
 	}
 });
-Object.defineProperty(exports, "loadLanguage", {
+Object.defineProperty(exports, "friendlyStringsFrom", {
 	enumerable: true,
 	get: function() {
-		return loadLanguage;
+		return friendlyStringsFrom;
 	}
 });
-Object.defineProperty(exports, "loadLocale", {
+Object.defineProperty(exports, "isNetworkFailure", {
 	enumerable: true,
 	get: function() {
-		return loadLocale;
+		return isNetworkFailure;
 	}
 });
-Object.defineProperty(exports, "saveLanguage", {
+Object.defineProperty(exports, "technicalText", {
 	enumerable: true,
 	get: function() {
-		return saveLanguage;
+		return technicalText;
 	}
 });
-Object.defineProperty(exports, "saveLocale", {
+Object.defineProperty(exports, "technicalTexts", {
 	enumerable: true,
 	get: function() {
-		return saveLocale;
+		return technicalTexts;
 	}
 });
 Object.defineProperty(exports, "toFriendlyError", {
@@ -245,4 +237,4 @@ Object.defineProperty(exports, "useLinkComponent", {
 	}
 });
 
-//# sourceMappingURL=toaster-C7CiYA4Z.cjs.map
+//# sourceMappingURL=toaster-BbByOytP.cjs.map

package/dist/toaster-BbByOytP.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"toaster-BbByOytP.cjs","names":["PopoverPrimitive","React","cn","forwardRef","createContext","useContext","toast","useOptionalT","useTheme","useRef","useMemo","SonnerToaster"],"sources":["../src/primitives/popover.tsx","../src/layout/link-component.tsx","../src/lib/friendly-error.ts","../src/notification/notification-provider.ts","../src/notification/toaster.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport * as PopoverPrimitive from '@radix-ui/react-popover';\nimport { cn } from '../lib/cn.js';\n\n/**\n * Thin wrapper around Radix Popover, mirroring the structure of the\n * Dialog / Select primitives in this package so the Tailwind tokens\n * stay aligned. Re-exports `Root` / `Trigger` / `Anchor` / `Close`\n * directly (no styling needed) and styles `Content` to match the\n * shadcn Popover defaults.\n */\n\nconst Popover = PopoverPrimitive.Root;\nconst PopoverTrigger = PopoverPrimitive.Trigger;\nconst PopoverAnchor = PopoverPrimitive.Anchor;\nconst PopoverClose = PopoverPrimitive.Close;\n\nexport type PopoverContentProps = React.ComponentPropsWithoutRef<typeof PopoverPrimitive.Content>;\n\nconst PopoverContent = React.forwardRef<\n  React.ElementRef<typeof PopoverPrimitive.Content>,\n  PopoverContentProps\n>(({ className, align = 'start', sideOffset = 4, ...props }, ref) => (\n  <PopoverPrimitive.Portal>\n    <PopoverPrimitive.Content\n      ref={ref}\n      align={align}\n      sideOffset={sideOffset}\n      className={cn(\n        'z-50 w-72 rounded-md border bg-popover p-3 text-popover-foreground shadow-md outline-hidden',\n        'duration-[var(--duration-overlay)] ease-[var(--ease-overlay)]',\n        'data-[state=open]:animate-in data-[state=closed]:animate-out',\n        'data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0',\n        'data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95',\n        'data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2',\n        className,\n      )}\n      {...props}\n    />\n  </PopoverPrimitive.Portal>\n));\nPopoverContent.displayName = PopoverPrimitive.Content.displayName;\n\nexport { Popover, PopoverTrigger, PopoverAnchor, PopoverClose, PopoverContent };\n","'use client';\nimport {\n  type AnchorHTMLAttributes,\n  type ComponentType,\n  type ReactElement,\n  type ReactNode,\n  createContext,\n  forwardRef,\n  useContext,\n} from 'react';\n\n/**\n * Props every `LinkComponent` must accept. We intentionally mirror the\n * native `<a>` API surface so adopters writing a small wrapper around\n * their router's link primitive (next/link, react-router, TanStack\n * Router, etc.) can pass them straight through.\n *\n * `next/link` already accepts these names verbatim. `react-router`'s\n * `<Link>` uses `to` instead of `href` — adopters wrap once:\n *\n *   const RouterLink: LinkComponent = ({ href, ...rest }) =>\n *     <Link to={href} {...rest} />;\n */\nexport type LinkComponentProps = Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> & {\n  href: string;\n  children?: ReactNode;\n};\n\nexport type LinkComponent = ComponentType<LinkComponentProps>;\n\n/**\n * Default fallback — a plain `<a href>` anchor. Triggers a full\n * document load. Adopters that ship a SPA router (Next.js App Router,\n * react-router) install their router's `<Link>` via\n * `<LinkComponentProvider>` so internal navigation stays client-side.\n */\nconst DefaultLinkComponent: LinkComponent = forwardRef<HTMLAnchorElement, LinkComponentProps>(\n  function DefaultLinkComponent({ children, ...rest }, ref) {\n    return (\n      <a ref={ref} {...rest}>\n        {children}\n      </a>\n    );\n  },\n);\n\nconst LinkComponentContext = createContext<LinkComponent>(DefaultLinkComponent);\n\nexport interface LinkComponentProviderProps {\n  /**\n   * The router-aware Link component to use throughout `@burojs/ui-shadcn` for\n   * internal navigation. Pass `Link` from `next/link` for Next.js App Router;\n   * wrap your router's link primitive once for react-router / TanStack Router.\n   */\n  linkComponent: LinkComponent;\n  children: ReactNode;\n}\n\n/**\n * Install a router-aware `LinkComponent` for every framework component that\n * renders an internal navigation link (sidebar entries, action links, relation\n * cells, the list-empty Create CTA, …). Without it the framework falls back to\n * a raw `<a>` — correct, but a full document reload on every click.\n *\n * This is a link component and nothing else: the location and imperative\n * navigation are the `RouterAdapter`'s (`RouterAdapterProvider` and\n * `useRouteNavigate` from `@burojs/react`), the one router seam.\n *\n *   import Link from 'next/link';\n *   <LinkComponentProvider linkComponent={Link}>\n *     <App />\n *   </LinkComponentProvider>\n */\nexport function LinkComponentProvider({\n  linkComponent,\n  children,\n}: LinkComponentProviderProps): ReactElement {\n  return (\n    <LinkComponentContext.Provider value={linkComponent}>{children}</LinkComponentContext.Provider>\n  );\n}\n\n/**\n * Read the current `LinkComponent`. Call this from any framework\n * component that needs to render an internal-navigation link, then\n * use the returned component in JSX:\n *\n *   const RouterLink = useLinkComponent();\n *   return <RouterLink href={href}>{label}</RouterLink>;\n *\n * Always returns a usable component — the default fallback emits a\n * raw `<a href>` so the component never has to null-check.\n */\nexport function useLinkComponent(): LinkComponent {\n  return useContext(LinkComponentContext);\n}\n","/**\n * Turn a developer-facing error string into something a user can act on.\n *\n * Two surfaces need this and they are reached by different code paths — the\n * notification provider (a legacy query adapter's default query-error\n * toast) and the inline\n * error panel a list renders in place of its rows. Fixing only the first left\n * `/document_document` still printing a raw English «Failed to fetch» under a\n * Russian heading, which is how this ended up in a second acceptance round.\n * One helper, both call sites.\n *\n * Anything we do not recognise is passed through unchanged: a message written\n * by the adopter's own `onError` is almost certainly better than a generic\n * substitute.\n */\n\n/** A legacy query adapter's own untranslated wording plus the raw fetch/network failures. */\nconst DEV_FACING =\n  /^Error \\(status code:|^Failed to fetch$|^NetworkError|^Load failed$|^TypeError: (Failed to fetch|NetworkError)/i;\nconst NETWORK = /Failed to fetch|NetworkError|Load failed|ERR_INTERNET_DISCONNECTED/i;\n/**\n * A machine transport trace, e.g.\n *   «Temporal GET /namespaces/default/schedules?maximumPageSize=10 -> 502»\n *\n * A data provider that reports which call failed is doing the right thing —\n * that string belongs in a bug report. It does not belong in front of an\n * operator as the entire explanation of why their page is empty, which is\n * exactly what `/schedules` did when the Temporal cluster went down.\n *\n * Recognised by an HTTP verb followed by an arrow and a status code; nothing\n * an adopter would hand-write looks like this, so the pass-through contract\n * for adopter-authored messages is preserved.\n */\nconst HTTP_TRACE = /\\b(?:GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\\b[^\\n]*->\\s*(\\d{3})\\b/;\n\n/** The four sentences a recognised failure is replaced with: the bundle keys `requestError.*`. */\nexport interface FriendlyErrorStrings {\n  readonly title: string;\n  readonly offline: string;\n  readonly unavailable: string;\n  readonly generic: string;\n}\n\n/**\n * The framework's code language: used where no i18n is configured, and for any\n * key the active bundles do not carry.\n */\nexport const en: FriendlyErrorStrings = {\n  title: 'Request failed',\n  offline: 'Cannot reach the server. Check your connection and try again.',\n  unavailable: 'The service is temporarily unavailable. Try again in a minute.',\n  generic: 'Please try again.',\n};\n\n/**\n * Resolve {@link FriendlyErrorStrings} through a translate function (`useT()`,\n * `useOptionalT()`), taking the English default for each key it cannot find.\n */\nexport function friendlyStringsFrom(\n  t: (key: string, options?: { defaultValue?: string }) => string,\n): FriendlyErrorStrings {\n  const pick = (name: keyof FriendlyErrorStrings): string =>\n    t(`requestError.${name}`, { defaultValue: en[name] }) || en[name];\n  return {\n    title: pick('title'),\n    offline: pick('offline'),\n    unavailable: pick('unavailable'),\n    generic: pick('generic'),\n  };\n}\n\nexport interface FriendlyError {\n  /** Short headline. Empty when the original message should be kept. */\n  title: string;\n  /** Explanation the user can act on. */\n  detail: string;\n  /** True when the input was recognised as developer-facing and replaced. */\n  replaced: boolean;\n}\n\n/**\n * @param strings the sentences to substitute, already in the active language:\n *   {@link friendlyStringsFrom} builds them from the app's translate function,\n *   and {@link en} is the default where none is configured.\n */\nexport function toFriendlyError(\n  message: unknown,\n  description: unknown,\n  strings: FriendlyErrorStrings,\n): FriendlyError {\n  const raw = `${String(message ?? '')} ${String(description ?? '')}`;\n  const isDevFacing = DEV_FACING.test(String(message ?? '').trim());\n  const isNetwork = NETWORK.test(raw);\n  const trace = HTTP_TRACE.exec(String(message ?? '').trim());\n\n  if (trace) {\n    // 5xx is the server's problem and waiting is the right advice; anything\n    // else is at least not something the operator can read a URL out of.\n    const status = Number(trace[1]);\n    return {\n      title: strings.title,\n      detail: status >= 500 ? strings.unavailable : strings.generic,\n      replaced: true,\n    };\n  }\n\n  if (!isDevFacing && !isNetwork) {\n    return {\n      title: String(message ?? ''),\n      detail: String(description ?? ''),\n      replaced: false,\n    };\n  }\n  return {\n    title: strings.title,\n    detail: isNetwork ? strings.offline : String(description ?? '') || strings.generic,\n    replaced: true,\n  };\n}\n\n/** Whether a technical text says the network itself failed (a dead connection, a refused fetch). */\nexport function isNetworkFailure(text: string): boolean {\n  return NETWORK.test(text);\n}\n\n/**\n * Every developer-facing text a failure carries, most specific first: string `details`, else\n * `details.message`; then an `Error` cause's message or a string cause; then the message of the\n * error itself when it is a plain `Error`. A provider's `details` is often its own sentence\n * (\"did not answer a mutation; it may have been applied\"), so the thrown fetch error in `cause`\n * must stay readable behind it. A `DataError`'s `message` is a reference a user may read; this is\n * what it no longer carries.\n */\nexport function technicalTexts(error: unknown): readonly string[] {\n  if (error === null || typeof error !== 'object') return [];\n  const out: string[] = [];\n  try {\n    const { details, cause } = error as { readonly details?: unknown; readonly cause?: unknown };\n    if (typeof details === 'string') out.push(details);\n    else if (details !== null && typeof details === 'object') {\n      const inner = (details as { readonly message?: unknown }).message;\n      if (typeof inner === 'string') out.push(inner);\n    }\n    if (cause instanceof Error) out.push(cause.message);\n    // The normaliser moves a legacy string `message` into `cause`.\n    else if (typeof cause === 'string') out.push(cause);\n    if (error instanceof Error) out.push(error.message);\n  } catch {\n    // A getter that throws on a hostile error object: there is no more technical text to read.\n  }\n  return out;\n}\n\n/** The first of {@link technicalTexts}: for the friendly path and development logs only. */\nexport function technicalText(error: unknown): string | undefined {\n  return technicalTexts(error)[0];\n}\n","import type { NotificationSinkMessage } from '@burojs/react';\nimport { toast } from 'sonner';\nimport { type FriendlyErrorStrings, en, toFriendlyError } from '../lib/friendly-error.js';\n\n/** `<Toaster>`'s sink: `@burojs/react`'s `NotificationSink`, plus `close`. */\nexport interface NotificationSink {\n  open(args: NotificationSinkMessage): void;\n  close(key: string): void;\n}\n\n/**\n * A legacy query adapter can build its default query-error notification outside\n * our i18n bundle: the user saw «Error (status code: undefined)» / «Failed to fetch», plus it duplicated\n * the inline error state a list already renders. We can't localize a string we\n * don't own, so `toFriendlyError` recognises it and substitutes plain language.\n * The SAME helper backs the list's inline panel — see friendly-error.ts for why\n * that matters.\n */\nexport interface NotificationProviderOptions {\n  /**\n   * The sentences an error toast is rewritten with (`requestError.*` in the active bundle), or\n   * `undefined` for the English defaults. `<Toaster>` passes one built from the app's translate\n   * function; a sink built outside React passes its own.\n   *\n   * ⚠️ It is a FUNCTION, not a value, and that is load-bearing: both examples\n   * build this sink once (`React.useMemo(…, [])`) and it has no React context\n   * to subscribe to, so strings captured at construction would freeze in\n   * whatever language was active on the first render. Called per toast instead.\n   */\n  readonly resolveStrings?: () => FriendlyErrorStrings | undefined;\n}\n\nexport function createNotificationProvider(\n  options: NotificationProviderOptions = {},\n): NotificationSink {\n  return {\n    open: ({ type, message, description }) => {\n      let text = message;\n      let detail = description;\n      if (type === 'error') {\n        const friendly = toFriendlyError(message, description, options.resolveStrings?.() ?? en);\n        text = friendly.title;\n        detail = friendly.detail;\n      }\n      // `info` is a plain notice that dismisses itself — never `toast.loading`,\n      // whose spinner stays on screen until someone closes it.\n      const fn = type === 'error' ? toast.error : type === 'info' ? toast.info : toast.success;\n      fn(text, { description: detail });\n    },\n    close: (key: string) => {\n      toast.dismiss(key);\n    },\n  };\n}\n","'use client';\nimport { useOptionalT, useRegisterNotificationSink } from '@burojs/react';\nimport { useMemo, useRef } from 'react';\nimport { Toaster as SonnerToaster, type ToasterProps as SonnerProps, toast } from 'sonner';\nimport { friendlyStringsFrom } from '../lib/friendly-error.js';\nimport { useTheme } from '../layout/use-theme.js';\nimport { createNotificationProvider } from './notification-provider.js';\n\nexport interface ToasterProps extends SonnerProps {}\n\n/**\n * Shadcn-canonical Sonner setup, and — inside a `<BuroProvider>` — the app's\n * notification sink: the dispatcher's default `notify` (every handler's\n * `notify`, and a thrown handler's error) is delivered here. Outside a\n * provider it registers nothing and still renders anything sent with `toast()`.\n *\n * Bound to design tokens via `toastOptions.classNames`, so toasts inherit the\n * app's light/dark theme through the same CSS-variable cascade as the rest of\n * the UI; `theme` is reactive via `useTheme()`. The error sentences come from\n * the ACTIVE bundle (`requestError.*`), read per toast so a language switch is\n * honoured; with no i18n provider they are the English defaults.\n */\nexport function Toaster(props: ToasterProps): React.ReactElement {\n  // `useOptionalT`: the toaster may sit outside a BuroProvider, so it must\n  // degrade rather than throw.\n  const t = useOptionalT();\n  const { resolved: theme } = useTheme();\n  const tRef = useRef(t);\n  tRef.current = t;\n  const sink = useMemo(\n    () => createNotificationProvider({ resolveStrings: () => friendlyStringsFrom(tRef.current) }),\n    [],\n  );\n  useRegisterNotificationSink(sink);\n\n  const { toastOptions, ...rest } = props;\n  const kitClassNames = {\n    toast:\n      'group toast group-[.toaster]:bg-background group-[.toaster]:text-foreground group-[.toaster]:border-border group-[.toaster]:shadow-lg',\n    description: 'group-[.toast]:text-muted-foreground',\n    actionButton: 'group-[.toast]:bg-primary group-[.toast]:text-primary-foreground',\n    cancelButton: 'group-[.toast]:bg-muted group-[.toast]:text-muted-foreground',\n    closeButton:\n      'group-[.toast]:bg-background group-[.toast]:text-muted-foreground group-[.toast]:border-border group-[.toast]:hover:bg-muted group-[.toast]:hover:text-foreground',\n  };\n\n  return (\n    <SonnerToaster\n      /*\n        ⚠️ Sonner's default accessible name is \"Notifications alt+T\" and reaches\n        the accessibility tree on every page. `customAriaLabel` replaces it\n        wholly (the hotkey hint leaves the name) with the adopter's own\n        `customAriaLabel` or `containerAriaLabel` (sonner 2 ignores the latter\n        once the former is set, so it is honoured here), else the bundle's\n        `notifications.region`. The literal fallback is English, like every\n        framework default.\n      */\n      customAriaLabel={\n        props.customAriaLabel ??\n        props.containerAriaLabel ??\n        t('notifications.region', { defaultValue: 'Notifications' })\n      }\n      theme={theme}\n      position=\"top-right\"\n      closeButton\n      className=\"toaster group\"\n      {...rest}\n      /*\n        The adopter's `toastOptions` merge with ours instead of replacing them:\n        the adopter wins per key, and per slot inside `classNames`. The close\n        button's label is the bundle's `notifications.close` unless the adopter\n        names their own.\n      */\n      toastOptions={{\n        ...toastOptions,\n        classNames: { ...kitClassNames, ...toastOptions?.classNames },\n        closeButtonAriaLabel:\n          toastOptions?.closeButtonAriaLabel ??\n          t('notifications.close', { defaultValue: 'Close notification' }),\n      }}\n    />\n  );\n}\n\nexport { toast };\n"],"mappings":";;;;;;;;;AAcA,MAAM,UAAUA,wBAAiB;AACjC,MAAM,iBAAiBA,wBAAiB;AACxC,MAAM,gBAAgBA,wBAAiB;AACvC,MAAM,eAAeA,wBAAiB;AAItC,MAAM,iBAAiBC,MAAM,YAG1B,EAAE,WAAW,QAAQ,SAAS,aAAa,GAAG,GAAG,SAAS,SAC3D,GAAA,kBAAA,IAAA,CAACD,wBAAiB,QAAlB,EAAA,WACE,GAAA,kBAAA,IAAA,CAACA,wBAAiB,SAAlB;CACO;CACE;CACK;CACZ,WAAWE,kBAAAA,GACT,+FACA,iEACA,gEACA,8DACA,gEACA,+JACA,SACF;CACA,GAAI;AACL,CAAA,EACsB,CAAA,CAC1B;AACD,eAAe,cAAcF,wBAAiB,QAAQ;;;ACPtD,MAAM,wBAAA,GAAsCG,MAAAA,WAAAA,CAC1C,SAAS,qBAAqB,EAAE,UAAU,GAAG,QAAQ,KAAK;CACxD,QACE,GAAA,kBAAA,IAAA,CAAC,KAAD;EAAQ;EAAK,GAAI;EACd;CACA,CAAA;AAEP,CACF;AAEA,MAAM,wBAAA,GAAuBC,MAAAA,cAAAA,CAA6B,oBAAoB;AA2B9E,SAAgB,sBAAsB,EACpC,eACA,YAC2C;CAC3C,QACE,GAAA,kBAAA,IAAA,CAAC,qBAAqB,UAAtB;EAA+B,OAAO;EAAgB;CAAwC,CAAA;AAElG;AAaA,SAAgB,mBAAkC;CAChD,QAAA,GAAOC,MAAAA,WAAAA,CAAW,oBAAoB;AACxC;;;AC9EA,MAAM,aACJ;AACF,MAAM,UAAU;AAchB,MAAM,aAAa;AAcnB,MAAa,KAA2B;CACtC,OAAO;CACP,SAAS;CACT,aAAa;CACb,SAAS;AACX;AAMA,SAAgB,oBACd,GACsB;CACtB,MAAM,QAAQ,SACZ,EAAE,gBAAgB,QAAQ,EAAE,cAAc,GAAG,MAAM,CAAC,KAAK,GAAG;CAC9D,OAAO;EACL,OAAO,KAAK,OAAO;EACnB,SAAS,KAAK,SAAS;EACvB,aAAa,KAAK,aAAa;EAC/B,SAAS,KAAK,SAAS;CACzB;AACF;AAgBA,SAAgB,gBACd,SACA,aACA,SACe;CACf,MAAM,MAAM,GAAG,OAAO,WAAW,EAAE,EAAE,GAAG,OAAO,eAAe,EAAE;CAChE,MAAM,cAAc,WAAW,KAAK,OAAO,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC;CAChE,MAAM,YAAY,QAAQ,KAAK,GAAG;CAClC,MAAM,QAAQ,WAAW,KAAK,OAAO,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC;CAE1D,IAAI,OAAO;EAGT,MAAM,SAAS,OAAO,MAAM,EAAE;EAC9B,OAAO;GACL,OAAO,QAAQ;GACf,QAAQ,UAAU,MAAM,QAAQ,cAAc,QAAQ;GACtD,UAAU;EACZ;CACF;CAEA,IAAI,CAAC,eAAe,CAAC,WACnB,OAAO;EACL,OAAO,OAAO,WAAW,EAAE;EAC3B,QAAQ,OAAO,eAAe,EAAE;EAChC,UAAU;CACZ;CAEF,OAAO;EACL,OAAO,QAAQ;EACf,QAAQ,YAAY,QAAQ,UAAU,OAAO,eAAe,EAAE,KAAK,QAAQ;EAC3E,UAAU;CACZ;AACF;AAGA,SAAgB,iBAAiB,MAAuB;CACtD,OAAO,QAAQ,KAAK,IAAI;AAC1B;AAUA,SAAgB,eAAe,OAAmC;CAChE,IAAI,UAAU,QAAQ,OAAO,UAAU,UAAU,OAAO,CAAC;CACzD,MAAM,MAAgB,CAAC;CACvB,IAAI;EACF,MAAM,EAAE,SAAS,UAAU;EAC3B,IAAI,OAAO,YAAY,UAAU,IAAI,KAAK,OAAO;OAC5C,IAAI,YAAY,QAAQ,OAAO,YAAY,UAAU;GACxD,MAAM,QAAS,QAA2C;GAC1D,IAAI,OAAO,UAAU,UAAU,IAAI,KAAK,KAAK;EAC/C;EACA,IAAI,iBAAiB,OAAO,IAAI,KAAK,MAAM,OAAO;OAE7C,IAAI,OAAO,UAAU,UAAU,IAAI,KAAK,KAAK;EAClD,IAAI,iBAAiB,OAAO,IAAI,KAAK,MAAM,OAAO;CACpD,QAAQ,CAER;CACA,OAAO;AACT;AAGA,SAAgB,cAAc,OAAoC;CAChE,OAAO,eAAe,KAAK,CAAC,CAAC;AAC/B;;;AC5HA,SAAgB,2BACd,UAAuC,CAAC,GACtB;CAClB,OAAO;EACL,OAAO,EAAE,MAAM,SAAS,kBAAkB;GACxC,IAAI,OAAO;GACX,IAAI,SAAS;GACb,IAAI,SAAS,SAAS;IACpB,MAAM,WAAW,gBAAgB,SAAS,aAAa,QAAQ,iBAAiB,KAAK,EAAE;IACvF,OAAO,SAAS;IAChB,SAAS,SAAS;GACpB;GAIA,CADW,SAAS,UAAUC,OAAAA,MAAM,QAAQ,SAAS,SAASA,OAAAA,MAAM,OAAOA,OAAAA,MAAM,QAAA,CAC9E,MAAM,EAAE,aAAa,OAAO,CAAC;EAClC;EACA,QAAQ,QAAgB;GACtB,OAAA,MAAM,QAAQ,GAAG;EACnB;CACF;AACF;;;AC/BA,SAAgB,QAAQ,OAAyC;CAG/D,MAAM,KAAA,GAAIC,cAAAA,aAAAA,CAAa;CACvB,MAAM,EAAE,UAAU,UAAUC,kBAAAA,SAAS;CACrC,MAAM,QAAA,GAAOC,MAAAA,OAAAA,CAAO,CAAC;CACrB,KAAK,UAAU;CACf,MAAM,QAAA,GAAOC,MAAAA,QAAAA,OACL,2BAA2B,EAAE,sBAAsB,oBAAoB,KAAK,OAAO,EAAE,CAAC,GAC5F,CAAC,CACH;CACA,CAAA,GAAA,cAAA,4BAAA,CAA4B,IAAI;CAEhC,MAAM,EAAE,cAAc,GAAG,SAAS;CAClC,MAAM,gBAAgB;EACpB,OACE;EACF,aAAa;EACb,cAAc;EACd,cAAc;EACd,aACE;CACJ;CAEA,QACE,GAAA,kBAAA,IAAA,CAACC,OAAAA,SAAD;EAUE,iBACE,MAAM,mBACN,MAAM,sBACN,EAAE,wBAAwB,EAAE,cAAc,gBAAgB,CAAC;EAEtD;EACP,UAAS;EACT,aAAA;EACA,WAAU;EACV,GAAI;EAOJ,cAAc;GACZ,GAAG;GACH,YAAY;IAAE,GAAG;IAAe,GAAG,cAAc;GAAW;GAC5D,sBACE,cAAc,wBACd,EAAE,uBAAuB,EAAE,cAAc,qBAAqB,CAAC;EACnE;CACD,CAAA;AAEL"}

package/dist/{toaster-CfCRLgR-.js → toaster-Ct_YHGs6.js}

@@ -1,5 +1,5 @@
 import { l as cn, n as useTheme } from "./use-theme-dnE3Od3I.js";
-import { DEFAULT_LANGUAGE_STORAGE_KEY, useOptionalLocale, useOptionalT, useRegisterNotificationSink } from "@burojs/react";
+import { useOptionalT, useRegisterNotificationSink } from "@burojs/react";
 import * as React from "react";
 import { createContext, forwardRef, useContext, useMemo, useRef } from "react";
 import * as PopoverPrimitive from "@radix-ui/react-popover";
@@ -38,57 +38,26 @@ function useLinkComponent() {
 	return useContext(LinkComponentContext);
 }
 //#endregion
-//#region src/layout/language-storage.ts
-const DEFAULT_LANGUAGE = "ru";
-function loadLanguage(storageKey = DEFAULT_LANGUAGE_STORAGE_KEY) {
-	if (typeof window === "undefined") return "ru";
-	try {
-		const saved = window.localStorage.getItem(storageKey);
-		if (saved === "ru" || saved === "en") return saved;
-	} catch {}
-	return "ru";
-}
-function saveLanguage(code, storageKey = DEFAULT_LANGUAGE_STORAGE_KEY) {
-	if (typeof window === "undefined") return;
-	try {
-		window.localStorage.setItem(storageKey, code);
-	} catch {}
-}
-function loadLocale(storageKey = DEFAULT_LANGUAGE_STORAGE_KEY) {
-	if (typeof window === "undefined") return void 0;
-	try {
-		return window.localStorage.getItem(storageKey) ?? void 0;
-	} catch {
-		return;
-	}
-}
-function saveLocale(code, storageKey = DEFAULT_LANGUAGE_STORAGE_KEY) {
-	if (typeof window === "undefined") return;
-	try {
-		window.localStorage.setItem(storageKey, code);
-	} catch {}
-}
-//#endregion
 //#region src/lib/friendly-error.ts
 const DEV_FACING = /^Error \(status code:|^Failed to fetch$|^NetworkError|^Load failed$|^TypeError: (Failed to fetch|NetworkError)/i;
 const NETWORK = /Failed to fetch|NetworkError|Load failed|ERR_INTERNET_DISCONNECTED/i;
 const HTTP_TRACE = /\b(?:GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\b[^\n]*->\s*(\d{3})\b/;
-const STRINGS = {
-	ru: {
-		title: "Не удалось выполнить запрос",
-		offline: "Нет связи с сервером. Проверьте подключение и повторите.",
-		unavailable: "Сервис временно недоступен. Повторите попытку через минуту.",
-		generic: "Попробуйте повторить действие."
-	},
-	en: {
-		title: "Request failed",
-		offline: "Cannot reach the server. Check your connection and try again.",
-		unavailable: "The service is temporarily unavailable. Try again in a minute.",
-		generic: "Please try again."
-	}
+const en = {
+	title: "Request failed",
+	offline: "Cannot reach the server. Check your connection and try again.",
+	unavailable: "The service is temporarily unavailable. Try again in a minute.",
+	generic: "Please try again."
 };
-function toFriendlyError(message, description, locale) {
-	const s = (locale !== void 0 ? STRINGS[locale] : void 0) ?? STRINGS.en;
+function friendlyStringsFrom(t) {
+	const pick = (name) => t(`requestError.${name}`, { defaultValue: en[name] }) || en[name];
+	return {
+		title: pick("title"),
+		offline: pick("offline"),
+		unavailable: pick("unavailable"),
+		generic: pick("generic")
+	};
+}
+function toFriendlyError(message, description, strings) {
 	const raw = `${String(message ?? "")} ${String(description ?? "")}`;
 	const isDevFacing = DEV_FACING.test(String(message ?? "").trim());
 	const isNetwork = NETWORK.test(raw);
@@ -96,8 +65,8 @@ function toFriendlyError(message, description, locale) {
 	if (trace) {
 		const status = Number(trace[1]);
 		return {
-			title: s.title,
-			detail: status >= 500 ? s.unavailable : s.generic,
+			title: strings.title,
+			detail: status >= 500 ? strings.unavailable : strings.generic,
 			replaced: true
 		};
 	}
@@ -107,21 +76,42 @@ function toFriendlyError(message, description, locale) {
 		replaced: false
 	};
 	return {
-		title: s.title,
-		detail: isNetwork ? s.offline : String(description ?? "") || s.generic,
+		title: strings.title,
+		detail: isNetwork ? strings.offline : String(description ?? "") || strings.generic,
 		replaced: true
 	};
 }
+function isNetworkFailure(text) {
+	return NETWORK.test(text);
+}
+function technicalTexts(error) {
+	if (error === null || typeof error !== "object") return [];
+	const out = [];
+	try {
+		const { details, cause } = error;
+		if (typeof details === "string") out.push(details);
+		else if (details !== null && typeof details === "object") {
+			const inner = details.message;
+			if (typeof inner === "string") out.push(inner);
+		}
+		if (cause instanceof Error) out.push(cause.message);
+		else if (typeof cause === "string") out.push(cause);
+		if (error instanceof Error) out.push(error.message);
+	} catch {}
+	return out;
+}
+function technicalText(error) {
+	return technicalTexts(error)[0];
+}
 //#endregion
 //#region src/notification/notification-provider.ts
 function createNotificationProvider(options = {}) {
-	const resolveLocale = options.resolveLocale ?? (() => loadLocale());
 	return {
 		open: ({ type, message, description }) => {
 			let text = message;
 			let detail = description;
 			if (type === "error") {
-				const friendly = toFriendlyError(message, description, resolveLocale());
+				const friendly = toFriendlyError(message, description, options.resolveStrings?.() ?? en);
 				text = friendly.title;
 				detail = friendly.detail;
 			}
@@ -137,28 +127,36 @@ function createNotificationProvider(options = {}) {
 function Toaster$1(props) {
 	const t = useOptionalT();
 	const { resolved: theme } = useTheme();
-	const locale = useOptionalLocale();
-	const localeRef = useRef(locale);
-	localeRef.current = locale;
-	const sink = useMemo(() => createNotificationProvider({ resolveLocale: () => localeRef.current ?? loadLocale() }), []);
+	const tRef = useRef(t);
+	tRef.current = t;
+	const sink = useMemo(() => createNotificationProvider({ resolveStrings: () => friendlyStringsFrom(tRef.current) }), []);
 	useRegisterNotificationSink(sink);
+	const { toastOptions, ...rest } = props;
+	const kitClassNames = {
+		toast: "group toast group-[.toaster]:bg-background group-[.toaster]:text-foreground group-[.toaster]:border-border group-[.toaster]:shadow-lg",
+		description: "group-[.toast]:text-muted-foreground",
+		actionButton: "group-[.toast]:bg-primary group-[.toast]:text-primary-foreground",
+		cancelButton: "group-[.toast]:bg-muted group-[.toast]:text-muted-foreground",
+		closeButton: "group-[.toast]:bg-background group-[.toast]:text-muted-foreground group-[.toast]:border-border group-[.toast]:hover:bg-muted group-[.toast]:hover:text-foreground"
+	};
 	return jsx(Toaster, {
-		containerAriaLabel: t("notifications.region", { defaultValue: "Notifications" }),
+		customAriaLabel: props.customAriaLabel ?? props.containerAriaLabel ?? t("notifications.region", { defaultValue: "Notifications" }),
 		theme,
 		position: "top-right",
 		closeButton: true,
 		className: "toaster group",
-		toastOptions: { classNames: {
-			toast: "group toast group-[.toaster]:bg-background group-[.toaster]:text-foreground group-[.toaster]:border-border group-[.toaster]:shadow-lg",
-			description: "group-[.toast]:text-muted-foreground",
-			actionButton: "group-[.toast]:bg-primary group-[.toast]:text-primary-foreground",
-			cancelButton: "group-[.toast]:bg-muted group-[.toast]:text-muted-foreground",
-			closeButton: "group-[.toast]:bg-background group-[.toast]:text-muted-foreground group-[.toast]:border-border group-[.toast]:hover:bg-muted group-[.toast]:hover:text-foreground"
-		} },
-		...props
+		...rest,
+		toastOptions: {
+			...toastOptions,
+			classNames: {
+				...kitClassNames,
+				...toastOptions?.classNames
+			},
+			closeButtonAriaLabel: toastOptions?.closeButtonAriaLabel ?? t("notifications.close", { defaultValue: "Close notification" })
+		}
 	});
 }
 //#endregion
-export { DEFAULT_LANGUAGE_STORAGE_KEY as a, saveLanguage as c, useLinkComponent as d, Popover as f, PopoverTrigger as g, PopoverContent as h, DEFAULT_LANGUAGE as i, saveLocale as l, PopoverClose as m, toast$1 as n, loadLanguage as o, PopoverAnchor as p, toFriendlyError as r, loadLocale as s, Toaster$1 as t, LinkComponentProvider as u };
+export { technicalText as a, LinkComponentProvider as c, PopoverAnchor as d, PopoverClose as f, isNetworkFailure as i, useLinkComponent as l, PopoverTrigger as m, toast$1 as n, technicalTexts as o, PopoverContent as p, friendlyStringsFrom as r, toFriendlyError as s, Toaster$1 as t, Popover as u };
 
-//# sourceMappingURL=toaster-CfCRLgR-.js.map
+//# sourceMappingURL=toaster-Ct_YHGs6.js.map

package/dist/toaster-Ct_YHGs6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toaster-Ct_YHGs6.js","names":["Toaster","SonnerToaster"],"sources":["../src/primitives/popover.tsx","../src/layout/link-component.tsx","../src/lib/friendly-error.ts","../src/notification/notification-provider.ts","../src/notification/toaster.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport * as PopoverPrimitive from '@radix-ui/react-popover';\nimport { cn } from '../lib/cn.js';\n\n/**\n * Thin wrapper around Radix Popover, mirroring the structure of the\n * Dialog / Select primitives in this package so the Tailwind tokens\n * stay aligned. Re-exports `Root` / `Trigger` / `Anchor` / `Close`\n * directly (no styling needed) and styles `Content` to match the\n * shadcn Popover defaults.\n */\n\nconst Popover = PopoverPrimitive.Root;\nconst PopoverTrigger = PopoverPrimitive.Trigger;\nconst PopoverAnchor = PopoverPrimitive.Anchor;\nconst PopoverClose = PopoverPrimitive.Close;\n\nexport type PopoverContentProps = React.ComponentPropsWithoutRef<typeof PopoverPrimitive.Content>;\n\nconst PopoverContent = React.forwardRef<\n  React.ElementRef<typeof PopoverPrimitive.Content>,\n  PopoverContentProps\n>(({ className, align = 'start', sideOffset = 4, ...props }, ref) => (\n  <PopoverPrimitive.Portal>\n    <PopoverPrimitive.Content\n      ref={ref}\n      align={align}\n      sideOffset={sideOffset}\n      className={cn(\n        'z-50 w-72 rounded-md border bg-popover p-3 text-popover-foreground shadow-md outline-hidden',\n        'duration-[var(--duration-overlay)] ease-[var(--ease-overlay)]',\n        'data-[state=open]:animate-in data-[state=closed]:animate-out',\n        'data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0',\n        'data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95',\n        'data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2',\n        className,\n      )}\n      {...props}\n    />\n  </PopoverPrimitive.Portal>\n));\nPopoverContent.displayName = PopoverPrimitive.Content.displayName;\n\nexport { Popover, PopoverTrigger, PopoverAnchor, PopoverClose, PopoverContent };\n","'use client';\nimport {\n  type AnchorHTMLAttributes,\n  type ComponentType,\n  type ReactElement,\n  type ReactNode,\n  createContext,\n  forwardRef,\n  useContext,\n} from 'react';\n\n/**\n * Props every `LinkComponent` must accept. We intentionally mirror the\n * native `<a>` API surface so adopters writing a small wrapper around\n * their router's link primitive (next/link, react-router, TanStack\n * Router, etc.) can pass them straight through.\n *\n * `next/link` already accepts these names verbatim. `react-router`'s\n * `<Link>` uses `to` instead of `href` — adopters wrap once:\n *\n *   const RouterLink: LinkComponent = ({ href, ...rest }) =>\n *     <Link to={href} {...rest} />;\n */\nexport type LinkComponentProps = Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> & {\n  href: string;\n  children?: ReactNode;\n};\n\nexport type LinkComponent = ComponentType<LinkComponentProps>;\n\n/**\n * Default fallback — a plain `<a href>` anchor. Triggers a full\n * document load. Adopters that ship a SPA router (Next.js App Router,\n * react-router) install their router's `<Link>` via\n * `<LinkComponentProvider>` so internal navigation stays client-side.\n */\nconst DefaultLinkComponent: LinkComponent = forwardRef<HTMLAnchorElement, LinkComponentProps>(\n  function DefaultLinkComponent({ children, ...rest }, ref) {\n    return (\n      <a ref={ref} {...rest}>\n        {children}\n      </a>\n    );\n  },\n);\n\nconst LinkComponentContext = createContext<LinkComponent>(DefaultLinkComponent);\n\nexport interface LinkComponentProviderProps {\n  /**\n   * The router-aware Link component to use throughout `@burojs/ui-shadcn` for\n   * internal navigation. Pass `Link` from `next/link` for Next.js App Router;\n   * wrap your router's link primitive once for react-router / TanStack Router.\n   */\n  linkComponent: LinkComponent;\n  children: ReactNode;\n}\n\n/**\n * Install a router-aware `LinkComponent` for every framework component that\n * renders an internal navigation link (sidebar entries, action links, relation\n * cells, the list-empty Create CTA, …). Without it the framework falls back to\n * a raw `<a>` — correct, but a full document reload on every click.\n *\n * This is a link component and nothing else: the location and imperative\n * navigation are the `RouterAdapter`'s (`RouterAdapterProvider` and\n * `useRouteNavigate` from `@burojs/react`), the one router seam.\n *\n *   import Link from 'next/link';\n *   <LinkComponentProvider linkComponent={Link}>\n *     <App />\n *   </LinkComponentProvider>\n */\nexport function LinkComponentProvider({\n  linkComponent,\n  children,\n}: LinkComponentProviderProps): ReactElement {\n  return (\n    <LinkComponentContext.Provider value={linkComponent}>{children}</LinkComponentContext.Provider>\n  );\n}\n\n/**\n * Read the current `LinkComponent`. Call this from any framework\n * component that needs to render an internal-navigation link, then\n * use the returned component in JSX:\n *\n *   const RouterLink = useLinkComponent();\n *   return <RouterLink href={href}>{label}</RouterLink>;\n *\n * Always returns a usable component — the default fallback emits a\n * raw `<a href>` so the component never has to null-check.\n */\nexport function useLinkComponent(): LinkComponent {\n  return useContext(LinkComponentContext);\n}\n","/**\n * Turn a developer-facing error string into something a user can act on.\n *\n * Two surfaces need this and they are reached by different code paths — the\n * notification provider (a legacy query adapter's default query-error\n * toast) and the inline\n * error panel a list renders in place of its rows. Fixing only the first left\n * `/document_document` still printing a raw English «Failed to fetch» under a\n * Russian heading, which is how this ended up in a second acceptance round.\n * One helper, both call sites.\n *\n * Anything we do not recognise is passed through unchanged: a message written\n * by the adopter's own `onError` is almost certainly better than a generic\n * substitute.\n */\n\n/** A legacy query adapter's own untranslated wording plus the raw fetch/network failures. */\nconst DEV_FACING =\n  /^Error \\(status code:|^Failed to fetch$|^NetworkError|^Load failed$|^TypeError: (Failed to fetch|NetworkError)/i;\nconst NETWORK = /Failed to fetch|NetworkError|Load failed|ERR_INTERNET_DISCONNECTED/i;\n/**\n * A machine transport trace, e.g.\n *   «Temporal GET /namespaces/default/schedules?maximumPageSize=10 -> 502»\n *\n * A data provider that reports which call failed is doing the right thing —\n * that string belongs in a bug report. It does not belong in front of an\n * operator as the entire explanation of why their page is empty, which is\n * exactly what `/schedules` did when the Temporal cluster went down.\n *\n * Recognised by an HTTP verb followed by an arrow and a status code; nothing\n * an adopter would hand-write looks like this, so the pass-through contract\n * for adopter-authored messages is preserved.\n */\nconst HTTP_TRACE = /\\b(?:GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\\b[^\\n]*->\\s*(\\d{3})\\b/;\n\n/** The four sentences a recognised failure is replaced with: the bundle keys `requestError.*`. */\nexport interface FriendlyErrorStrings {\n  readonly title: string;\n  readonly offline: string;\n  readonly unavailable: string;\n  readonly generic: string;\n}\n\n/**\n * The framework's code language: used where no i18n is configured, and for any\n * key the active bundles do not carry.\n */\nexport const en: FriendlyErrorStrings = {\n  title: 'Request failed',\n  offline: 'Cannot reach the server. Check your connection and try again.',\n  unavailable: 'The service is temporarily unavailable. Try again in a minute.',\n  generic: 'Please try again.',\n};\n\n/**\n * Resolve {@link FriendlyErrorStrings} through a translate function (`useT()`,\n * `useOptionalT()`), taking the English default for each key it cannot find.\n */\nexport function friendlyStringsFrom(\n  t: (key: string, options?: { defaultValue?: string }) => string,\n): FriendlyErrorStrings {\n  const pick = (name: keyof FriendlyErrorStrings): string =>\n    t(`requestError.${name}`, { defaultValue: en[name] }) || en[name];\n  return {\n    title: pick('title'),\n    offline: pick('offline'),\n    unavailable: pick('unavailable'),\n    generic: pick('generic'),\n  };\n}\n\nexport interface FriendlyError {\n  /** Short headline. Empty when the original message should be kept. */\n  title: string;\n  /** Explanation the user can act on. */\n  detail: string;\n  /** True when the input was recognised as developer-facing and replaced. */\n  replaced: boolean;\n}\n\n/**\n * @param strings the sentences to substitute, already in the active language:\n *   {@link friendlyStringsFrom} builds them from the app's translate function,\n *   and {@link en} is the default where none is configured.\n */\nexport function toFriendlyError(\n  message: unknown,\n  description: unknown,\n  strings: FriendlyErrorStrings,\n): FriendlyError {\n  const raw = `${String(message ?? '')} ${String(description ?? '')}`;\n  const isDevFacing = DEV_FACING.test(String(message ?? '').trim());\n  const isNetwork = NETWORK.test(raw);\n  const trace = HTTP_TRACE.exec(String(message ?? '').trim());\n\n  if (trace) {\n    // 5xx is the server's problem and waiting is the right advice; anything\n    // else is at least not something the operator can read a URL out of.\n    const status = Number(trace[1]);\n    return {\n      title: strings.title,\n      detail: status >= 500 ? strings.unavailable : strings.generic,\n      replaced: true,\n    };\n  }\n\n  if (!isDevFacing && !isNetwork) {\n    return {\n      title: String(message ?? ''),\n      detail: String(description ?? ''),\n      replaced: false,\n    };\n  }\n  return {\n    title: strings.title,\n    detail: isNetwork ? strings.offline : String(description ?? '') || strings.generic,\n    replaced: true,\n  };\n}\n\n/** Whether a technical text says the network itself failed (a dead connection, a refused fetch). */\nexport function isNetworkFailure(text: string): boolean {\n  return NETWORK.test(text);\n}\n\n/**\n * Every developer-facing text a failure carries, most specific first: string `details`, else\n * `details.message`; then an `Error` cause's message or a string cause; then the message of the\n * error itself when it is a plain `Error`. A provider's `details` is often its own sentence\n * (\"did not answer a mutation; it may have been applied\"), so the thrown fetch error in `cause`\n * must stay readable behind it. A `DataError`'s `message` is a reference a user may read; this is\n * what it no longer carries.\n */\nexport function technicalTexts(error: unknown): readonly string[] {\n  if (error === null || typeof error !== 'object') return [];\n  const out: string[] = [];\n  try {\n    const { details, cause } = error as { readonly details?: unknown; readonly cause?: unknown };\n    if (typeof details === 'string') out.push(details);\n    else if (details !== null && typeof details === 'object') {\n      const inner = (details as { readonly message?: unknown }).message;\n      if (typeof inner === 'string') out.push(inner);\n    }\n    if (cause instanceof Error) out.push(cause.message);\n    // The normaliser moves a legacy string `message` into `cause`.\n    else if (typeof cause === 'string') out.push(cause);\n    if (error instanceof Error) out.push(error.message);\n  } catch {\n    // A getter that throws on a hostile error object: there is no more technical text to read.\n  }\n  return out;\n}\n\n/** The first of {@link technicalTexts}: for the friendly path and development logs only. */\nexport function technicalText(error: unknown): string | undefined {\n  return technicalTexts(error)[0];\n}\n","import type { NotificationSinkMessage } from '@burojs/react';\nimport { toast } from 'sonner';\nimport { type FriendlyErrorStrings, en, toFriendlyError } from '../lib/friendly-error.js';\n\n/** `<Toaster>`'s sink: `@burojs/react`'s `NotificationSink`, plus `close`. */\nexport interface NotificationSink {\n  open(args: NotificationSinkMessage): void;\n  close(key: string): void;\n}\n\n/**\n * A legacy query adapter can build its default query-error notification outside\n * our i18n bundle: the user saw «Error (status code: undefined)» / «Failed to fetch», plus it duplicated\n * the inline error state a list already renders. We can't localize a string we\n * don't own, so `toFriendlyError` recognises it and substitutes plain language.\n * The SAME helper backs the list's inline panel — see friendly-error.ts for why\n * that matters.\n */\nexport interface NotificationProviderOptions {\n  /**\n   * The sentences an error toast is rewritten with (`requestError.*` in the active bundle), or\n   * `undefined` for the English defaults. `<Toaster>` passes one built from the app's translate\n   * function; a sink built outside React passes its own.\n   *\n   * ⚠️ It is a FUNCTION, not a value, and that is load-bearing: both examples\n   * build this sink once (`React.useMemo(…, [])`) and it has no React context\n   * to subscribe to, so strings captured at construction would freeze in\n   * whatever language was active on the first render. Called per toast instead.\n   */\n  readonly resolveStrings?: () => FriendlyErrorStrings | undefined;\n}\n\nexport function createNotificationProvider(\n  options: NotificationProviderOptions = {},\n): NotificationSink {\n  return {\n    open: ({ type, message, description }) => {\n      let text = message;\n      let detail = description;\n      if (type === 'error') {\n        const friendly = toFriendlyError(message, description, options.resolveStrings?.() ?? en);\n        text = friendly.title;\n        detail = friendly.detail;\n      }\n      // `info` is a plain notice that dismisses itself — never `toast.loading`,\n      // whose spinner stays on screen until someone closes it.\n      const fn = type === 'error' ? toast.error : type === 'info' ? toast.info : toast.success;\n      fn(text, { description: detail });\n    },\n    close: (key: string) => {\n      toast.dismiss(key);\n    },\n  };\n}\n","'use client';\nimport { useOptionalT, useRegisterNotificationSink } from '@burojs/react';\nimport { useMemo, useRef } from 'react';\nimport { Toaster as SonnerToaster, type ToasterProps as SonnerProps, toast } from 'sonner';\nimport { friendlyStringsFrom } from '../lib/friendly-error.js';\nimport { useTheme } from '../layout/use-theme.js';\nimport { createNotificationProvider } from './notification-provider.js';\n\nexport interface ToasterProps extends SonnerProps {}\n\n/**\n * Shadcn-canonical Sonner setup, and — inside a `<BuroProvider>` — the app's\n * notification sink: the dispatcher's default `notify` (every handler's\n * `notify`, and a thrown handler's error) is delivered here. Outside a\n * provider it registers nothing and still renders anything sent with `toast()`.\n *\n * Bound to design tokens via `toastOptions.classNames`, so toasts inherit the\n * app's light/dark theme through the same CSS-variable cascade as the rest of\n * the UI; `theme` is reactive via `useTheme()`. The error sentences come from\n * the ACTIVE bundle (`requestError.*`), read per toast so a language switch is\n * honoured; with no i18n provider they are the English defaults.\n */\nexport function Toaster(props: ToasterProps): React.ReactElement {\n  // `useOptionalT`: the toaster may sit outside a BuroProvider, so it must\n  // degrade rather than throw.\n  const t = useOptionalT();\n  const { resolved: theme } = useTheme();\n  const tRef = useRef(t);\n  tRef.current = t;\n  const sink = useMemo(\n    () => createNotificationProvider({ resolveStrings: () => friendlyStringsFrom(tRef.current) }),\n    [],\n  );\n  useRegisterNotificationSink(sink);\n\n  const { toastOptions, ...rest } = props;\n  const kitClassNames = {\n    toast:\n      'group toast group-[.toaster]:bg-background group-[.toaster]:text-foreground group-[.toaster]:border-border group-[.toaster]:shadow-lg',\n    description: 'group-[.toast]:text-muted-foreground',\n    actionButton: 'group-[.toast]:bg-primary group-[.toast]:text-primary-foreground',\n    cancelButton: 'group-[.toast]:bg-muted group-[.toast]:text-muted-foreground',\n    closeButton:\n      'group-[.toast]:bg-background group-[.toast]:text-muted-foreground group-[.toast]:border-border group-[.toast]:hover:bg-muted group-[.toast]:hover:text-foreground',\n  };\n\n  return (\n    <SonnerToaster\n      /*\n        ⚠️ Sonner's default accessible name is \"Notifications alt+T\" and reaches\n        the accessibility tree on every page. `customAriaLabel` replaces it\n        wholly (the hotkey hint leaves the name) with the adopter's own\n        `customAriaLabel` or `containerAriaLabel` (sonner 2 ignores the latter\n        once the former is set, so it is honoured here), else the bundle's\n        `notifications.region`. The literal fallback is English, like every\n        framework default.\n      */\n      customAriaLabel={\n        props.customAriaLabel ??\n        props.containerAriaLabel ??\n        t('notifications.region', { defaultValue: 'Notifications' })\n      }\n      theme={theme}\n      position=\"top-right\"\n      closeButton\n      className=\"toaster group\"\n      {...rest}\n      /*\n        The adopter's `toastOptions` merge with ours instead of replacing them:\n        the adopter wins per key, and per slot inside `classNames`. The close\n        button's label is the bundle's `notifications.close` unless the adopter\n        names their own.\n      */\n      toastOptions={{\n        ...toastOptions,\n        classNames: { ...kitClassNames, ...toastOptions?.classNames },\n        closeButtonAriaLabel:\n          toastOptions?.closeButtonAriaLabel ??\n          t('notifications.close', { defaultValue: 'Close notification' }),\n      }}\n    />\n  );\n}\n\nexport { toast };\n"],"mappings":"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"}

package/dist/{use-dialog-filter-state-BDcgS5Oz.js → use-dialog-filter-state-B_MqzHaT.js}

@@ -1,9 +1,10 @@
-import { n as narrowSearchDecl, t as namesHiddenField } from "./search-access-CURsWn-U.js";
-import { EMPTY_FILTER_GROUP, composeListFilter } from "@burojs/core";
+import { a as namesHiddenField, o as narrowSearchDecl } from "./relation-create-C43cdPQt.js";
+import { EMPTY_FILTER_GROUP, composeListFilter, routeResourceKey } 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) {
+function useDialogFilterState(resourceInput, options) {
+	const resource = routeResourceKey(resourceInput);
 	const def = useApp().registry.get(resource);
 	const { available, fixed } = useFilterFields(resource, {
 		fixedFilters: options.fixedFilters,
@@ -84,4 +85,4 @@ function useDialogFilterState(resource, options) {
 //#endregion
 export { useDialogFilterState as t };
 
-//# sourceMappingURL=use-dialog-filter-state-BDcgS5Oz.js.map
+//# sourceMappingURL=use-dialog-filter-state-B_MqzHaT.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-dialog-filter-state-B_MqzHaT.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  routeResourceKey,\n  type ResourceNameOrRef,\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<const N extends string = string>(\n  resourceInput: ResourceNameOrRef<N>,\n  options: UseDialogFilterStateOptions,\n): DialogFilterState {\n  const resource = routeResourceKey(resourceInput);\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":";;;;;AAkFA,SAAgB,qBACd,eACA,SACmB;CACnB,MAAM,WAAW,iBAAiB,aAAa;CAE/C,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-dialog-filter-state-BBCC0OEK.cjs → use-dialog-filter-state-tNvqAAjh.cjs}

@@ -1,9 +1,10 @@
-const require_search_access = require("./search-access-B7G5oR8n.cjs");
+const require_relation_create = require("./relation-create-DDEYcKfw.cjs");
 let _burojs_core = require("@burojs/core");
 let _burojs_react = require("@burojs/react");
 let react = require("react");
 //#region src/fields/use-dialog-filter-state.ts
-function useDialogFilterState(resource, options) {
+function useDialogFilterState(resourceInput, options) {
+	const resource = (0, _burojs_core.routeResourceKey)(resourceInput);
 	const def = (0, _burojs_react.useApp)().registry.get(resource);
 	const { available, fixed } = (0, _burojs_react.useFilterFields)(resource, {
 		fixedFilters: options.fixedFilters,
@@ -30,7 +31,7 @@ function useDialogFilterState(resource, options) {
 	const accessReady = access.status === "ready";
 	const searchDecl = (0, react.useMemo)(() => {
 		const declared = def?.views?.list?.search;
-		return require_search_access.narrowSearchDecl(declared !== void 0 ? declared : searchField === void 0 ? void 0 : { fields: [searchField] }, (field) => access.fieldVisible(field));
+		return require_relation_create.narrowSearchDecl(declared !== void 0 ? declared : searchField === void 0 ? void 0 : { fields: [searchField] }, (field) => access.fieldVisible(field));
 	}, [
 		def,
 		searchField,
@@ -53,7 +54,7 @@ function useDialogFilterState(resource, options) {
 		searchDecl,
 		searchContext
 	]);
-	const blocked = !accessReady || require_search_access.namesHiddenField(filter, (field) => access.fieldVisible(field));
+	const blocked = !accessReady || require_relation_create.namesHiddenField(filter, (field) => access.fieldVisible(field));
 	return (0, react.useMemo)(() => ({
 		searchEnabled: searchDecl !== void 0,
 		blocked,
@@ -89,4 +90,4 @@ Object.defineProperty(exports, "useDialogFilterState", {
 	}
 });
 
-//# sourceMappingURL=use-dialog-filter-state-BBCC0OEK.cjs.map
+//# sourceMappingURL=use-dialog-filter-state-tNvqAAjh.cjs.map

package/dist/use-dialog-filter-state-tNvqAAjh.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-dialog-filter-state-tNvqAAjh.cjs","names":["routeResourceKey","useApp","useFilterFields","useState","EMPTY_FILTER_GROUP","useCallback","useListAccess","useMemo","narrowSearchDecl","composeListFilter","namesHiddenField"],"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  routeResourceKey,\n  type ResourceNameOrRef,\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<const N extends string = string>(\n  resourceInput: ResourceNameOrRef<N>,\n  options: UseDialogFilterStateOptions,\n): DialogFilterState {\n  const resource = routeResourceKey(resourceInput);\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":";;;;;AAkFA,SAAgB,qBACd,eACA,SACmB;CACnB,MAAM,YAAA,GAAWA,aAAAA,iBAAAA,CAAiB,aAAa;CAE/C,MAAM,OAAA,GADMC,cAAAA,OAAAA,CACE,CAAC,CAAC,SAAS,IAAI,QAAQ;CACrC,MAAM,EAAE,WAAW,WAAA,GAAUC,cAAAA,gBAAAA,CAAgB,UAAU;EACrD,cAAc,QAAQ;EACtB,SAAS,QAAQ;CACnB,CAAC;CAED,MAAM,CAAC,OAAO,kBAAA,GAAiBC,MAAAA,SAAAA,CAAsBC,aAAAA,kBAAkB;CACvE,MAAM,CAAC,QAAQ,mBAAA,GAAkBD,MAAAA,SAAAA,CAAS,EAAE;CAC5C,MAAM,CAAC,MAAM,YAAA,GAAWA,MAAAA,SAAAA,CAAS,CAAC;CAKlC,MAAM,YAAA,GAAWE,MAAAA,YAAAA,EAAa,SAAsB;EAClD,cAAc,IAAI;EAClB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAEL,MAAM,aAAA,GAAYA,MAAAA,YAAAA,EAAa,SAAiB;EAC9C,eAAe,IAAI;EACnB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAEL,MAAM,SAAA,GAAQA,MAAAA,YAAAA,OAAkB;EAC9B,cAAcD,aAAAA,kBAAkB;EAChC,eAAe,EAAE;EACjB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAOL,MAAM,EAAE,gBAAgB;CACxB,MAAM,UAAA,GAASE,cAAAA,cAAAA,CAAc,QAAQ;CACrC,MAAM,cAAc,OAAO,WAAW;CACtC,MAAM,cAAA,GAAaC,MAAAA,QAAAA,OAAsC;EACvD,MAAM,WAAW,KAAK,OAAO,MAAM;EAOnC,OAAOC,wBAAAA,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,iBAAA,GAAgBD,MAAAA,QAAAA,QAAe;EAAE;EAAU;CAAI,IAAI,CAAC,UAAU,GAAG,CAAC;CAExE,MAAM,UAAA,GAASA,MAAAA,QAAAA,QAAAA,GACPE,aAAAA,kBAAAA,CAAkB;EAAE;EAAO;EAAO;EAAQ;EAAY;CAAc,CAAC,GAC3E;EAAC;EAAO;EAAO;EAAQ;EAAY;CAAa,CAClD;CAIA,MAAM,UAAU,CAAC,eAAeC,wBAAAA,iBAAiB,SAAS,UAAU,OAAO,aAAa,KAAK,CAAC;CAE9F,QAAA,GAAOH,MAAAA,QAAAA,QACE;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"}