@burojs/ui-shadcn 0.4.0 → 0.6.0

package/dist/toaster-C02XbB9r.js

@@ -0,0 +1,135 @@
+import { l as cn, n as useTheme } from "./use-theme-dnE3Od3I.js";
+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";
+import { jsx } from "react/jsx-runtime";
+import { Toaster, toast, toast as toast$1 } from "sonner";
+//#region src/primitives/popover.tsx
+const Popover = PopoverPrimitive.Root;
+const PopoverTrigger = PopoverPrimitive.Trigger;
+const PopoverAnchor = PopoverPrimitive.Anchor;
+const PopoverClose = PopoverPrimitive.Close;
+const PopoverContent = React.forwardRef(({ className, align = "start", sideOffset = 4, ...props }, ref) => jsx(PopoverPrimitive.Portal, { children: jsx(PopoverPrimitive.Content, {
+	ref,
+	align,
+	sideOffset,
+	className: cn("z-50 w-72 rounded-md border bg-popover p-3 text-popover-foreground shadow-md outline-hidden", "duration-[var(--duration-overlay)] ease-[var(--ease-overlay)]", "data-[state=open]:animate-in data-[state=closed]:animate-out", "data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0", "data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95", "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", className),
+	...props
+}) }));
+PopoverContent.displayName = PopoverPrimitive.Content.displayName;
+//#endregion
+//#region src/layout/link-component.tsx
+const DefaultLinkComponent = forwardRef(function DefaultLinkComponent({ children, ...rest }, ref) {
+	return jsx("a", {
+		ref,
+		...rest,
+		children
+	});
+});
+const LinkComponentContext = createContext(DefaultLinkComponent);
+function LinkComponentProvider({ linkComponent, children }) {
+	return jsx(LinkComponentContext.Provider, {
+		value: linkComponent,
+		children
+	});
+}
+function useLinkComponent() {
+	return useContext(LinkComponentContext);
+}
+//#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 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 friendlyStringsFrom(t) {
+	const pick = (name) => {
+		const key = `requestError.${name}`;
+		const value = t(key);
+		return value && value !== key ? value : 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);
+	const trace = HTTP_TRACE.exec(String(message ?? "").trim());
+	if (trace) {
+		const status = Number(trace[1]);
+		return {
+			title: strings.title,
+			detail: status >= 500 ? strings.unavailable : strings.generic,
+			replaced: true
+		};
+	}
+	if (!isDevFacing && !isNetwork) return {
+		title: String(message ?? ""),
+		detail: String(description ?? ""),
+		replaced: false
+	};
+	return {
+		title: strings.title,
+		detail: isNetwork ? strings.offline : String(description ?? "") || strings.generic,
+		replaced: true
+	};
+}
+//#endregion
+//#region src/notification/notification-provider.ts
+function createNotificationProvider(options = {}) {
+	return {
+		open: ({ type, message, description }) => {
+			let text = message;
+			let detail = description;
+			if (type === "error") {
+				const friendly = toFriendlyError(message, description, options.resolveStrings?.() ?? en);
+				text = friendly.title;
+				detail = friendly.detail;
+			}
+			(type === "error" ? toast.error : type === "info" ? toast.info : toast.success)(text, { description: detail });
+		},
+		close: (key) => {
+			toast.dismiss(key);
+		}
+	};
+}
+//#endregion
+//#region src/notification/toaster.tsx
+function Toaster$1(props) {
+	const t = useOptionalT();
+	const { resolved: theme } = useTheme();
+	const tRef = useRef(t);
+	tRef.current = t;
+	const sink = useMemo(() => createNotificationProvider({ resolveStrings: () => friendlyStringsFrom(tRef.current) }), []);
+	useRegisterNotificationSink(sink);
+	return jsx(Toaster, {
+		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
+	});
+}
+//#endregion
+export { LinkComponentProvider as a, PopoverAnchor as c, PopoverTrigger as d, toFriendlyError as i, PopoverClose as l, toast$1 as n, useLinkComponent as o, friendlyStringsFrom as r, Popover as s, Toaster$1 as t, PopoverContent as u };
+
+//# sourceMappingURL=toaster-C02XbB9r.js.map

package/dist/toaster-C02XbB9r.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toaster-C02XbB9r.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(t: (key: string) => string): FriendlyErrorStrings {\n  const pick = (name: keyof FriendlyErrorStrings): string => {\n    const key = `requestError.${name}`;\n    const value = t(key);\n    return value && value !== key ? value : en[name];\n  };\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","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  return (\n    <SonnerToaster\n      /*\n        ⚠️ Sonner's default accessible name is \"Notifications alt+T\" and reaches\n        the accessibility tree on every page; it is replaced by the bundle's\n        `notifications.region`. The literal fallback is English, like every\n        framework default.\n      */\n      containerAriaLabel={t('notifications.region', { defaultValue: 'Notifications' })}\n      theme={theme}\n      position=\"top-right\"\n      closeButton\n      className=\"toaster group\"\n      toastOptions={{\n        classNames: {\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      {...props}\n    />\n  );\n}\n\nexport { toast };\n"],"mappings":"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"}

package/dist/toaster-Cr51X7bz.cjs

@@ -0,0 +1,195 @@
+const require_use_theme = require("./use-theme-DFlpXils.cjs");
+let _burojs_react = require("@burojs/react");
+let react = require("react");
+react = require_use_theme.__toESM(react, 1);
+let _radix_ui_react_popover = require("@radix-ui/react-popover");
+_radix_ui_react_popover = require_use_theme.__toESM(_radix_ui_react_popover, 1);
+let react_jsx_runtime = require("react/jsx-runtime");
+let sonner = require("sonner");
+//#region src/primitives/popover.tsx
+const Popover = _radix_ui_react_popover.Root;
+const PopoverTrigger = _radix_ui_react_popover.Trigger;
+const PopoverAnchor = _radix_ui_react_popover.Anchor;
+const PopoverClose = _radix_ui_react_popover.Close;
+const PopoverContent = react.forwardRef(({ className, align = "start", sideOffset = 4, ...props }, ref) => (0, react_jsx_runtime.jsx)(_radix_ui_react_popover.Portal, { children: (0, react_jsx_runtime.jsx)(_radix_ui_react_popover.Content, {
+	ref,
+	align,
+	sideOffset,
+	className: require_use_theme.cn("z-50 w-72 rounded-md border bg-popover p-3 text-popover-foreground shadow-md outline-hidden", "duration-[var(--duration-overlay)] ease-[var(--ease-overlay)]", "data-[state=open]:animate-in data-[state=closed]:animate-out", "data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0", "data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95", "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", className),
+	...props
+}) }));
+PopoverContent.displayName = _radix_ui_react_popover.Content.displayName;
+//#endregion
+//#region src/layout/link-component.tsx
+const DefaultLinkComponent = (0, react.forwardRef)(function DefaultLinkComponent({ children, ...rest }, ref) {
+	return (0, react_jsx_runtime.jsx)("a", {
+		ref,
+		...rest,
+		children
+	});
+});
+const LinkComponentContext = (0, react.createContext)(DefaultLinkComponent);
+function LinkComponentProvider({ linkComponent, children }) {
+	return (0, react_jsx_runtime.jsx)(LinkComponentContext.Provider, {
+		value: linkComponent,
+		children
+	});
+}
+function useLinkComponent() {
+	return (0, react.useContext)(LinkComponentContext);
+}
+//#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 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 friendlyStringsFrom(t) {
+	const pick = (name) => {
+		const key = `requestError.${name}`;
+		const value = t(key);
+		return value && value !== key ? value : 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);
+	const trace = HTTP_TRACE.exec(String(message ?? "").trim());
+	if (trace) {
+		const status = Number(trace[1]);
+		return {
+			title: strings.title,
+			detail: status >= 500 ? strings.unavailable : strings.generic,
+			replaced: true
+		};
+	}
+	if (!isDevFacing && !isNetwork) return {
+		title: String(message ?? ""),
+		detail: String(description ?? ""),
+		replaced: false
+	};
+	return {
+		title: strings.title,
+		detail: isNetwork ? strings.offline : String(description ?? "") || strings.generic,
+		replaced: true
+	};
+}
+//#endregion
+//#region src/notification/notification-provider.ts
+function createNotificationProvider(options = {}) {
+	return {
+		open: ({ type, message, description }) => {
+			let text = message;
+			let detail = description;
+			if (type === "error") {
+				const friendly = toFriendlyError(message, description, options.resolveStrings?.() ?? en);
+				text = friendly.title;
+				detail = friendly.detail;
+			}
+			(type === "error" ? sonner.toast.error : type === "info" ? sonner.toast.info : sonner.toast.success)(text, { description: detail });
+		},
+		close: (key) => {
+			sonner.toast.dismiss(key);
+		}
+	};
+}
+//#endregion
+//#region src/notification/toaster.tsx
+function Toaster(props) {
+	const t = (0, _burojs_react.useOptionalT)();
+	const { resolved: theme } = require_use_theme.useTheme();
+	const tRef = (0, react.useRef)(t);
+	tRef.current = t;
+	const sink = (0, react.useMemo)(() => createNotificationProvider({ resolveStrings: () => friendlyStringsFrom(tRef.current) }), []);
+	(0, _burojs_react.useRegisterNotificationSink)(sink);
+	return (0, react_jsx_runtime.jsx)(sonner.Toaster, {
+		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
+	});
+}
+//#endregion
+Object.defineProperty(exports, "LinkComponentProvider", {
+	enumerable: true,
+	get: function() {
+		return LinkComponentProvider;
+	}
+});
+Object.defineProperty(exports, "Popover", {
+	enumerable: true,
+	get: function() {
+		return Popover;
+	}
+});
+Object.defineProperty(exports, "PopoverAnchor", {
+	enumerable: true,
+	get: function() {
+		return PopoverAnchor;
+	}
+});
+Object.defineProperty(exports, "PopoverClose", {
+	enumerable: true,
+	get: function() {
+		return PopoverClose;
+	}
+});
+Object.defineProperty(exports, "PopoverContent", {
+	enumerable: true,
+	get: function() {
+		return PopoverContent;
+	}
+});
+Object.defineProperty(exports, "PopoverTrigger", {
+	enumerable: true,
+	get: function() {
+		return PopoverTrigger;
+	}
+});
+Object.defineProperty(exports, "Toaster", {
+	enumerable: true,
+	get: function() {
+		return Toaster;
+	}
+});
+Object.defineProperty(exports, "friendlyStringsFrom", {
+	enumerable: true,
+	get: function() {
+		return friendlyStringsFrom;
+	}
+});
+Object.defineProperty(exports, "toFriendlyError", {
+	enumerable: true,
+	get: function() {
+		return toFriendlyError;
+	}
+});
+Object.defineProperty(exports, "useLinkComponent", {
+	enumerable: true,
+	get: function() {
+		return useLinkComponent;
+	}
+});
+
+//# sourceMappingURL=toaster-Cr51X7bz.cjs.map

package/dist/toaster-Cr51X7bz.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"toaster-Cr51X7bz.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(t: (key: string) => string): FriendlyErrorStrings {\n  const pick = (name: keyof FriendlyErrorStrings): string => {\n    const key = `requestError.${name}`;\n    const value = t(key);\n    return value && value !== key ? value : en[name];\n  };\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","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  return (\n    <SonnerToaster\n      /*\n        ⚠️ Sonner's default accessible name is \"Notifications alt+T\" and reaches\n        the accessibility tree on every page; it is replaced by the bundle's\n        `notifications.region`. The literal fallback is English, like every\n        framework default.\n      */\n      containerAriaLabel={t('notifications.region', { defaultValue: 'Notifications' })}\n      theme={theme}\n      position=\"top-right\"\n      closeButton\n      className=\"toaster group\"\n      toastOptions={{\n        classNames: {\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      {...props}\n    />\n  );\n}\n\nexport { toast };\n"],"mappings":"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"}

package/dist/use-dialog-filter-state-C--oMAZG.js

@@ -0,0 +1,87 @@
+import { n as narrowSearchDecl, t as namesHiddenField } from "./search-access-CPPmfuvy.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-C--oMAZG.js.map

package/dist/use-dialog-filter-state-C--oMAZG.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-dialog-filter-state-C--oMAZG.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-dialog-filter-state-Dhe8PcB5.cjs

@@ -0,0 +1,92 @@
+const require_search_access = require("./search-access-Dugvttlg.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) {
+	const def = (0, _burojs_react.useApp)().registry.get(resource);
+	const { available, fixed } = (0, _burojs_react.useFilterFields)(resource, {
+		fixedFilters: options.fixedFilters,
+		enabled: options.enabled
+	});
+	const [group, setGroupState] = (0, react.useState)(_burojs_core.EMPTY_FILTER_GROUP);
+	const [search, setSearchState] = (0, react.useState)("");
+	const [page, setPage] = (0, react.useState)(1);
+	const setGroup = (0, react.useCallback)((next) => {
+		setGroupState(next);
+		setPage(1);
+	}, []);
+	const setSearch = (0, react.useCallback)((next) => {
+		setSearchState(next);
+		setPage(1);
+	}, []);
+	const reset = (0, react.useCallback)(() => {
+		setGroupState(_burojs_core.EMPTY_FILTER_GROUP);
+		setSearchState("");
+		setPage(1);
+	}, []);
+	const { searchField } = options;
+	const access = (0, _burojs_react.useListAccess)(resource);
+	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));
+	}, [
+		def,
+		searchField,
+		access
+	]);
+	const searchContext = (0, react.useMemo)(() => ({
+		resource,
+		def
+	}), [resource, def]);
+	const filter = (0, react.useMemo)(() => (0, _burojs_core.composeListFilter)({
+		fixed,
+		group,
+		search,
+		searchDecl,
+		searchContext
+	}), [
+		fixed,
+		group,
+		search,
+		searchDecl,
+		searchContext
+	]);
+	const blocked = !accessReady || require_search_access.namesHiddenField(filter, (field) => access.fieldVisible(field));
+	return (0, react.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
+Object.defineProperty(exports, "useDialogFilterState", {
+	enumerable: true,
+	get: function() {
+		return useDialogFilterState;
+	}
+});
+
+//# sourceMappingURL=use-dialog-filter-state-Dhe8PcB5.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-dialog-filter-state-Dhe8PcB5.cjs","names":["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} 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,OAAA,GADMA,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,sBAAAA,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,sBAAAA,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"}