@burojs/ui-shadcn 0.4.0 → 0.6.0

package/README.md

@@ -51,15 +51,32 @@ are the working examples to copy from. (This line named `apps/playground` as
 the Next example. It was wrong twice over: that application had been a Vite
 app since 2026-07-31, and SP9 has now deleted it.)
 
+## Router setup
+
+Mount your router's `RouterAdapterProvider` (`@burojs/react`) above
+`<BuroProvider>`: it is the router's only binding, and every route match, active
+nav item, breadcrumb and framework navigation goes through it. Then give
+`<LinkComponentProvider linkComponent={…}>` your router's link component, which
+only renders anchors. `RouterAdapterProvider`'s docblock has the react-router and
+Next App Router adapters; `examples/vite` and `examples/next` mount them.
+
+## App shell
+
+**→ [docs/app-shell-guide.md](../../docs/app-shell-guide.md)** covers
+`AppShell`, the ready-made application chrome, and how to replace any part of it.
+
 ## What's included
 
-- Layout: AppLayout, Sidebar, Breadcrumbs
+- Layout: AppLayout, AppSidebar and AppHeader (each slot you omit gets its default — brand, `<NavMain />` and `<UserMenu />`; `<HeaderBreadcrumbs />`, the palette chip, app actions and refresh — and `false` empties it), Sidebar, Breadcrumbs, HeaderBreadcrumbs (the header trail of the current route)
 - Auth: LoginForm
-- Resource views: ResourceList, ResourceShow, ResourceEdit, ResourceCreate
+- Resource views: ResourceList, and `<RecordScreen resource mode recordId? …>` — a record's show, edit or create screen outside a route, in the built-in frame or in your own layout of its pieces (`RecordTitle`, `RecordActions`, `CopyId`, `FormActions`)
+- Record pages: `<RecordPage resource action />` (plus `defaults` on `action="create"`) — show, edit and create wired to data (`useOne`, `useUpdateOne`, `useCreateOne`), with translated loading / not-found / session-expired / error states and the open panel of a keyed tabs node in the URL (`?<tabsKey>=<panelKey>`); `<ResourcePageRouter>` / `<NavAreaPage>` render it for every record route (a different layout is a frame on the screen, `views.<mode>.frame`; record overrides were removed in P6); the page draws no breadcrumb trail of its own: `<HeaderBreadcrumbs />` in `<AppHeader breadcrumbs>` draws the record trail there (`<RecordBreadcrumbs />` standalone), with the record's title once the page has loaded it and the id while it loads or has failed, and on a page-hosted flow's route ending with the flow's label; each show and edit visit is recorded under the signed-in user for the command palette's Recent group
+- Custom pages: a page declared with a `body` (`defineCustomPage({ …, body: (l) => [l.place(block, { key })] })`) renders on its route under its label as the `<h1>`, behind the page's and its groups' `visible`; a page without `body` is a nav entry over a route the host owns
 - Field renderers: text, number, boolean, date, enum, textarea (display + form input)
-- Actions: ActionButton, BulkActionToolbar (wrap @burojs/react useAction)
-- Notifications: Toaster + NotificationProvider (Sonner)
-- UI presentation hosts: dialog/sheet chrome for the framework-mounted `<UIPresentations/>` overlay stack (`shadcnPresentationHosts`), backing `modal`/`formModal` actions
+- Actions: ActionButton (links, modals and flows), FlowActionButton, AppFlowButton, BulkActionToolbar (bulk flows); `useAction` from `@burojs/react/flows` runs a flow from your own control
+- Notifications: Toaster (Sonner) — render it inside `<BuroProvider>`, where it registers itself as the dispatcher's notification sink
+- Unsaved-changes dialog: `<NavigationGuardDialog>`, registered by `<AppLayout>` (the guard itself is `<BuroProvider>`'s)
+- UI presentation hosts: dialog/sheet chrome for the framework-mounted `<UIPresentations/>` overlay stack (`shadcnPresentationHosts`), backing `modal` actions and the flow host (`screens.flow`, the `buro:flow` dialog or sheet)
 - Vendored shadcn primitives: Button, Input, Label, Form, Table, Card, Dialog, Sheet, Select, Checkbox, Textarea, Badge
 
 ## License

package/dist/bulk-summary-CwSd6Yjb.cjs

@@ -0,0 +1,108 @@
+const require_button = require("./button-BxnnE28H.cjs");
+let _burojs_core = require("@burojs/core");
+let _burojs_react = require("@burojs/react");
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+let _burojs_react_flows = require("@burojs/react/flows");
+//#region src/flows/bulk-summary.tsx
+const text = (t, key, fallback, params) => {
+	const value = t(key, params === void 0 ? void 0 : { params });
+	return value === key ? fallback : value;
+};
+function FlowBulkSummary({ resource, actionName, label, total, progress }) {
+	const t = (0, _burojs_react.useOptionalT)();
+	const caps = (0, _burojs_react.useI18nCaps)(resource);
+	const forget = (0, _burojs_react_flows.useForgetEachAttempt)({
+		resource,
+		action: actionName
+	});
+	const [forgotten, setForgotten] = (0, react.useState)(() => new Set());
+	const forgetText = text(t, "flow.forget", "I've checked — forget it");
+	const testid = (0, _burojs_react.useTestIds)().bulkSummary(resource, actionName);
+	const own = `resources.${resource}.actions.${actionName}.summary`;
+	const params = {
+		count: progress.success.length,
+		total
+	};
+	const heading = caps.has(own) ? caps.t(own, { params }) : `${label}: ${text(t, "flow.bulkSummary", `${progress.success.length} processed`, params)} / ${total}`;
+	const notProcessed = progress.rejected.filter((entry) => entry.reason !== "server");
+	const refused = progress.rejected.filter((entry) => entry.reason === "server");
+	const groups = [
+		{
+			key: "not-processed",
+			title: text(t, "flow.rejected.precondition", "The record changed. Nothing was sent."),
+			ids: notProcessed.map((entry) => entry.id)
+		},
+		{
+			key: "rejected",
+			title: text(t, "flow.rejected.validation", "The server refused the values."),
+			ids: refused.map((entry) => entry.id)
+		},
+		{
+			key: "failed",
+			title: text(t, "flow.failed", "The request could not be sent."),
+			ids: progress.failed
+		},
+		{
+			key: "unknown",
+			title: text(t, "flow.unknown", "It may have been applied. Nothing was resent."),
+			ids: progress.unknown.filter((id) => !forgotten.has(id))
+		},
+		{
+			key: "unresolved",
+			title: text(t, "flow.bulkUnresolved", "Skipped: an earlier request for it may have been applied."),
+			ids: progress.unresolved.filter((id) => !forgotten.has(id))
+		},
+		{
+			key: "not-attempted",
+			title: text(t, "flow.bulkNotAttempted", "Not attempted."),
+			ids: progress.notAttempted
+		}
+	];
+	return (0, react_jsx_runtime.jsxs)("div", {
+		"data-testid": testid,
+		className: "flex flex-col gap-3 text-sm",
+		children: [(0, react_jsx_runtime.jsx)("p", {
+			"data-testid": `${testid}:heading`,
+			className: "font-medium",
+			children: heading
+		}), groups.filter((group) => group.ids.length > 0).map((group) => (0, react_jsx_runtime.jsxs)("section", {
+			"data-testid": `${testid}:${group.key}`,
+			children: [(0, react_jsx_runtime.jsxs)("h3", {
+				className: "font-medium",
+				children: [
+					group.title,
+					" ",
+					(0, react_jsx_runtime.jsxs)("span", {
+						"data-testid": `${testid}:${group.key}:count`,
+						className: "tabular-nums",
+						children: [
+							"(",
+							group.ids.length,
+							")"
+						]
+					})
+				]
+			}), (0, react_jsx_runtime.jsxs)("ul", {
+				className: "flex flex-wrap gap-1 text-muted-foreground",
+				children: [group.ids.slice(0, _burojs_core.BULK_SUMMARY_IDS).map((id) => (0, react_jsx_runtime.jsxs)("li", {
+					"data-testid": `${testid}:${group.key}:${id}`,
+					className: "flex items-center gap-1",
+					children: [id, group.key === "unknown" || group.key === "unresolved" ? (0, react_jsx_runtime.jsx)(require_button.Button, {
+						type: "button",
+						size: "sm",
+						variant: "ghost",
+						className: "h-6 px-1.5 text-xs",
+						"data-testid": `${testid}:forget:${id}`,
+						onClick: () => void forget(id).then(() => setForgotten((previous) => new Set([...previous, id]))),
+						children: forgetText
+					}) : null]
+				}, id)), group.ids.length > _burojs_core.BULK_SUMMARY_IDS ? (0, react_jsx_runtime.jsxs)("li", { children: ["+", group.ids.length - _burojs_core.BULK_SUMMARY_IDS] }) : null]
+			})]
+		}, group.key))]
+	});
+}
+//#endregion
+exports.FlowBulkSummary = FlowBulkSummary;
+
+//# sourceMappingURL=bulk-summary-CwSd6Yjb.cjs.map

package/dist/bulk-summary-CwSd6Yjb.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-summary-CwSd6Yjb.cjs","names":["useOptionalT","useI18nCaps","useForgetEachAttempt","useState","useTestIds","BULK_SUMMARY_IDS","Button"],"sources":["../src/flows/bulk-summary.tsx"],"sourcesContent":["'use client';\nimport { BULK_SUMMARY_IDS, type BulkProgress } from '@burojs/core';\nimport { useI18nCaps, useOptionalT, useTestIds } from '@burojs/react';\nimport { useForgetEachAttempt } from '@burojs/react/flows';\nimport { type ReactElement, useState } from 'react';\nimport { Button } from '../primitives/button.js';\n\nexport interface FlowBulkSummaryProps {\n  readonly resource: string;\n  readonly actionName: string;\n  /** The action's label. */\n  readonly label: string;\n  /** How many ids the run was given. */\n  readonly total: number;\n  readonly progress: BulkProgress;\n}\n\ntype Translate = ReturnType<typeof useOptionalT>;\nconst text = (t: Translate, key: string, fallback: string, params?: Record<string, unknown>) => {\n  const value = t(key, params === undefined ? undefined : { params });\n  return value === key ? fallback : value;\n};\n\n/**\n * A bulk flow's summary (P4 spec 4.16): the count that succeeded of the ids given (the flow's\n * own `resources.<r>.actions.<name>.summary`, `{{count}}` of `{{total}}`, else the framework's\n * count text), then one group per other outcome with its count and up to `BULK_SUMMARY_IDS` ids —\n * not processed (gone or its precondition failed), refused, failed, unknown (may have been\n * applied), unresolved from an earlier run, not attempted.\n */\nexport function FlowBulkSummary({\n  resource,\n  actionName,\n  label,\n  total,\n  progress,\n}: FlowBulkSummaryProps): ReactElement {\n  const t = useOptionalT();\n  const caps = useI18nCaps(resource);\n  // An id the run left unknown, or found unresolved, has its exit here (P4-C review I3): the user\n  // checked the record, and the id's attempt is forgotten — the next run sends it again.\n  const forget = useForgetEachAttempt({ resource, action: actionName });\n  const [forgotten, setForgotten] = useState<ReadonlySet<string>>(() => new Set());\n  const forgetText = text(t, 'flow.forget', \"I've checked — forget it\");\n  const tid = useTestIds();\n  const testid = tid.bulkSummary(resource, actionName);\n  const own = `resources.${resource}.actions.${actionName}.summary`;\n  const params = { count: progress.success.length, total };\n  const heading = caps.has(own)\n    ? caps.t(own, { params })\n    : `${label}: ${text(t, 'flow.bulkSummary', `${progress.success.length} processed`, params)} / ${total}`;\n  const notProcessed = progress.rejected.filter((entry) => entry.reason !== 'server');\n  const refused = progress.rejected.filter((entry) => entry.reason === 'server');\n  const groups: readonly { key: string; title: string; ids: readonly string[] }[] = [\n    {\n      key: 'not-processed',\n      title: text(t, 'flow.rejected.precondition', 'The record changed. Nothing was sent.'),\n      ids: notProcessed.map((entry) => entry.id),\n    },\n    {\n      key: 'rejected',\n      title: text(t, 'flow.rejected.validation', 'The server refused the values.'),\n      ids: refused.map((entry) => entry.id),\n    },\n    {\n      key: 'failed',\n      title: text(t, 'flow.failed', 'The request could not be sent.'),\n      ids: progress.failed,\n    },\n    {\n      key: 'unknown',\n      title: text(t, 'flow.unknown', 'It may have been applied. Nothing was resent.'),\n      ids: progress.unknown.filter((id) => !forgotten.has(id)),\n    },\n    {\n      key: 'unresolved',\n      title: text(\n        t,\n        'flow.bulkUnresolved',\n        'Skipped: an earlier request for it may have been applied.',\n      ),\n      ids: progress.unresolved.filter((id) => !forgotten.has(id)),\n    },\n    {\n      key: 'not-attempted',\n      title: text(t, 'flow.bulkNotAttempted', 'Not attempted.'),\n      ids: progress.notAttempted,\n    },\n  ];\n  return (\n    <div data-testid={testid} className=\"flex flex-col gap-3 text-sm\">\n      <p data-testid={`${testid}:heading`} className=\"font-medium\">\n        {heading}\n      </p>\n      {groups\n        .filter((group) => group.ids.length > 0)\n        .map((group) => (\n          <section key={group.key} data-testid={`${testid}:${group.key}`}>\n            <h3 className=\"font-medium\">\n              {group.title}{' '}\n              <span data-testid={`${testid}:${group.key}:count`} className=\"tabular-nums\">\n                ({group.ids.length})\n              </span>\n            </h3>\n            <ul className=\"flex flex-wrap gap-1 text-muted-foreground\">\n              {group.ids.slice(0, BULK_SUMMARY_IDS).map((id) => (\n                <li\n                  key={id}\n                  data-testid={`${testid}:${group.key}:${id}`}\n                  className=\"flex items-center gap-1\"\n                >\n                  {id}\n                  {group.key === 'unknown' || group.key === 'unresolved' ? (\n                    <Button\n                      type=\"button\"\n                      size=\"sm\"\n                      variant=\"ghost\"\n                      className=\"h-6 px-1.5 text-xs\"\n                      data-testid={`${testid}:forget:${id}`}\n                      onClick={() =>\n                        void forget(id).then(() =>\n                          setForgotten((previous) => new Set([...previous, id])),\n                        )\n                      }\n                    >\n                      {forgetText}\n                    </Button>\n                  ) : null}\n                </li>\n              ))}\n              {group.ids.length > BULK_SUMMARY_IDS ? (\n                <li>+{group.ids.length - BULK_SUMMARY_IDS}</li>\n              ) : null}\n            </ul>\n          </section>\n        ))}\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/bulk-summary-GxMDP4bw.js

@@ -0,0 +1,108 @@
+import { t as Button } from "./button-MWVeZaqj.js";
+import { BULK_SUMMARY_IDS } from "@burojs/core";
+import { useI18nCaps, useOptionalT, useTestIds } from "@burojs/react";
+import { useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useForgetEachAttempt } from "@burojs/react/flows";
+//#region src/flows/bulk-summary.tsx
+const text = (t, key, fallback, params) => {
+	const value = t(key, params === void 0 ? void 0 : { params });
+	return value === key ? fallback : value;
+};
+function FlowBulkSummary({ resource, actionName, label, total, progress }) {
+	const t = useOptionalT();
+	const caps = useI18nCaps(resource);
+	const forget = useForgetEachAttempt({
+		resource,
+		action: actionName
+	});
+	const [forgotten, setForgotten] = useState(() => new Set());
+	const forgetText = text(t, "flow.forget", "I've checked — forget it");
+	const testid = useTestIds().bulkSummary(resource, actionName);
+	const own = `resources.${resource}.actions.${actionName}.summary`;
+	const params = {
+		count: progress.success.length,
+		total
+	};
+	const heading = caps.has(own) ? caps.t(own, { params }) : `${label}: ${text(t, "flow.bulkSummary", `${progress.success.length} processed`, params)} / ${total}`;
+	const notProcessed = progress.rejected.filter((entry) => entry.reason !== "server");
+	const refused = progress.rejected.filter((entry) => entry.reason === "server");
+	const groups = [
+		{
+			key: "not-processed",
+			title: text(t, "flow.rejected.precondition", "The record changed. Nothing was sent."),
+			ids: notProcessed.map((entry) => entry.id)
+		},
+		{
+			key: "rejected",
+			title: text(t, "flow.rejected.validation", "The server refused the values."),
+			ids: refused.map((entry) => entry.id)
+		},
+		{
+			key: "failed",
+			title: text(t, "flow.failed", "The request could not be sent."),
+			ids: progress.failed
+		},
+		{
+			key: "unknown",
+			title: text(t, "flow.unknown", "It may have been applied. Nothing was resent."),
+			ids: progress.unknown.filter((id) => !forgotten.has(id))
+		},
+		{
+			key: "unresolved",
+			title: text(t, "flow.bulkUnresolved", "Skipped: an earlier request for it may have been applied."),
+			ids: progress.unresolved.filter((id) => !forgotten.has(id))
+		},
+		{
+			key: "not-attempted",
+			title: text(t, "flow.bulkNotAttempted", "Not attempted."),
+			ids: progress.notAttempted
+		}
+	];
+	return jsxs("div", {
+		"data-testid": testid,
+		className: "flex flex-col gap-3 text-sm",
+		children: [jsx("p", {
+			"data-testid": `${testid}:heading`,
+			className: "font-medium",
+			children: heading
+		}), groups.filter((group) => group.ids.length > 0).map((group) => jsxs("section", {
+			"data-testid": `${testid}:${group.key}`,
+			children: [jsxs("h3", {
+				className: "font-medium",
+				children: [
+					group.title,
+					" ",
+					jsxs("span", {
+						"data-testid": `${testid}:${group.key}:count`,
+						className: "tabular-nums",
+						children: [
+							"(",
+							group.ids.length,
+							")"
+						]
+					})
+				]
+			}), jsxs("ul", {
+				className: "flex flex-wrap gap-1 text-muted-foreground",
+				children: [group.ids.slice(0, BULK_SUMMARY_IDS).map((id) => jsxs("li", {
+					"data-testid": `${testid}:${group.key}:${id}`,
+					className: "flex items-center gap-1",
+					children: [id, group.key === "unknown" || group.key === "unresolved" ? jsx(Button, {
+						type: "button",
+						size: "sm",
+						variant: "ghost",
+						className: "h-6 px-1.5 text-xs",
+						"data-testid": `${testid}:forget:${id}`,
+						onClick: () => void forget(id).then(() => setForgotten((previous) => new Set([...previous, id]))),
+						children: forgetText
+					}) : null]
+				}, id)), group.ids.length > BULK_SUMMARY_IDS ? jsxs("li", { children: ["+", group.ids.length - BULK_SUMMARY_IDS] }) : null]
+			})]
+		}, group.key))]
+	});
+}
+//#endregion
+export { FlowBulkSummary };
+
+//# sourceMappingURL=bulk-summary-GxMDP4bw.js.map

package/dist/bulk-summary-GxMDP4bw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-summary-GxMDP4bw.js","names":[],"sources":["../src/flows/bulk-summary.tsx"],"sourcesContent":["'use client';\nimport { BULK_SUMMARY_IDS, type BulkProgress } from '@burojs/core';\nimport { useI18nCaps, useOptionalT, useTestIds } from '@burojs/react';\nimport { useForgetEachAttempt } from '@burojs/react/flows';\nimport { type ReactElement, useState } from 'react';\nimport { Button } from '../primitives/button.js';\n\nexport interface FlowBulkSummaryProps {\n  readonly resource: string;\n  readonly actionName: string;\n  /** The action's label. */\n  readonly label: string;\n  /** How many ids the run was given. */\n  readonly total: number;\n  readonly progress: BulkProgress;\n}\n\ntype Translate = ReturnType<typeof useOptionalT>;\nconst text = (t: Translate, key: string, fallback: string, params?: Record<string, unknown>) => {\n  const value = t(key, params === undefined ? undefined : { params });\n  return value === key ? fallback : value;\n};\n\n/**\n * A bulk flow's summary (P4 spec 4.16): the count that succeeded of the ids given (the flow's\n * own `resources.<r>.actions.<name>.summary`, `{{count}}` of `{{total}}`, else the framework's\n * count text), then one group per other outcome with its count and up to `BULK_SUMMARY_IDS` ids —\n * not processed (gone or its precondition failed), refused, failed, unknown (may have been\n * applied), unresolved from an earlier run, not attempted.\n */\nexport function FlowBulkSummary({\n  resource,\n  actionName,\n  label,\n  total,\n  progress,\n}: FlowBulkSummaryProps): ReactElement {\n  const t = useOptionalT();\n  const caps = useI18nCaps(resource);\n  // An id the run left unknown, or found unresolved, has its exit here (P4-C review I3): the user\n  // checked the record, and the id's attempt is forgotten — the next run sends it again.\n  const forget = useForgetEachAttempt({ resource, action: actionName });\n  const [forgotten, setForgotten] = useState<ReadonlySet<string>>(() => new Set());\n  const forgetText = text(t, 'flow.forget', \"I've checked — forget it\");\n  const tid = useTestIds();\n  const testid = tid.bulkSummary(resource, actionName);\n  const own = `resources.${resource}.actions.${actionName}.summary`;\n  const params = { count: progress.success.length, total };\n  const heading = caps.has(own)\n    ? caps.t(own, { params })\n    : `${label}: ${text(t, 'flow.bulkSummary', `${progress.success.length} processed`, params)} / ${total}`;\n  const notProcessed = progress.rejected.filter((entry) => entry.reason !== 'server');\n  const refused = progress.rejected.filter((entry) => entry.reason === 'server');\n  const groups: readonly { key: string; title: string; ids: readonly string[] }[] = [\n    {\n      key: 'not-processed',\n      title: text(t, 'flow.rejected.precondition', 'The record changed. Nothing was sent.'),\n      ids: notProcessed.map((entry) => entry.id),\n    },\n    {\n      key: 'rejected',\n      title: text(t, 'flow.rejected.validation', 'The server refused the values.'),\n      ids: refused.map((entry) => entry.id),\n    },\n    {\n      key: 'failed',\n      title: text(t, 'flow.failed', 'The request could not be sent.'),\n      ids: progress.failed,\n    },\n    {\n      key: 'unknown',\n      title: text(t, 'flow.unknown', 'It may have been applied. Nothing was resent.'),\n      ids: progress.unknown.filter((id) => !forgotten.has(id)),\n    },\n    {\n      key: 'unresolved',\n      title: text(\n        t,\n        'flow.bulkUnresolved',\n        'Skipped: an earlier request for it may have been applied.',\n      ),\n      ids: progress.unresolved.filter((id) => !forgotten.has(id)),\n    },\n    {\n      key: 'not-attempted',\n      title: text(t, 'flow.bulkNotAttempted', 'Not attempted.'),\n      ids: progress.notAttempted,\n    },\n  ];\n  return (\n    <div data-testid={testid} className=\"flex flex-col gap-3 text-sm\">\n      <p data-testid={`${testid}:heading`} className=\"font-medium\">\n        {heading}\n      </p>\n      {groups\n        .filter((group) => group.ids.length > 0)\n        .map((group) => (\n          <section key={group.key} data-testid={`${testid}:${group.key}`}>\n            <h3 className=\"font-medium\">\n              {group.title}{' '}\n              <span data-testid={`${testid}:${group.key}:count`} className=\"tabular-nums\">\n                ({group.ids.length})\n              </span>\n            </h3>\n            <ul className=\"flex flex-wrap gap-1 text-muted-foreground\">\n              {group.ids.slice(0, BULK_SUMMARY_IDS).map((id) => (\n                <li\n                  key={id}\n                  data-testid={`${testid}:${group.key}:${id}`}\n                  className=\"flex items-center gap-1\"\n                >\n                  {id}\n                  {group.key === 'unknown' || group.key === 'unresolved' ? (\n                    <Button\n                      type=\"button\"\n                      size=\"sm\"\n                      variant=\"ghost\"\n                      className=\"h-6 px-1.5 text-xs\"\n                      data-testid={`${testid}:forget:${id}`}\n                      onClick={() =>\n                        void forget(id).then(() =>\n                          setForgotten((previous) => new Set([...previous, id])),\n                        )\n                      }\n                    >\n                      {forgetText}\n                    </Button>\n                  ) : null}\n                </li>\n              ))}\n              {group.ids.length > BULK_SUMMARY_IDS ? (\n                <li>+{group.ids.length - BULK_SUMMARY_IDS}</li>\n              ) : null}\n            </ul>\n          </section>\n        ))}\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/button-BxnnE28H.cjs

@@ -0,0 +1,55 @@
+const require_use_theme = require("./use-theme-DFlpXils.cjs");
+let react = require("react");
+react = require_use_theme.__toESM(react, 1);
+let react_jsx_runtime = require("react/jsx-runtime");
+let _radix_ui_react_slot = require("@radix-ui/react-slot");
+//#region src/primitives/button.tsx
+const buttonVariants = (0, require("class-variance-authority").cva)("inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 disabled:saturate-0 aria-disabled:cursor-not-allowed aria-disabled:opacity-50 aria-disabled:saturate-0 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0", {
+	variants: {
+		variant: {
+			default: "bg-primary text-primary-foreground hover:bg-primary/90",
+			destructive: "bg-destructive text-destructive-foreground hover:bg-destructive/90",
+			outline: "border border-input bg-background text-foreground hover:bg-accent hover:text-accent-foreground",
+			secondary: "bg-secondary text-secondary-foreground hover:bg-secondary/80",
+			ghost: "hover:bg-accent hover:text-accent-foreground",
+			link: "text-primary underline-offset-4 hover:underline"
+		},
+		size: {
+			default: "h-9 px-4 py-2",
+			sm: "h-8 rounded-md px-3 text-xs",
+			lg: "h-10 rounded-md px-6",
+			icon: "h-9 w-9"
+		}
+	},
+	defaultVariants: {
+		variant: "default",
+		size: "default"
+	}
+});
+const Button = react.forwardRef(({ className, variant, size, asChild = false, ...props }, ref) => {
+	return (0, react_jsx_runtime.jsx)(asChild ? _radix_ui_react_slot.Slot : "button", {
+		className: require_use_theme.cn(buttonVariants({
+			variant,
+			size,
+			className
+		})),
+		ref,
+		...props
+	});
+});
+Button.displayName = "Button";
+//#endregion
+Object.defineProperty(exports, "Button", {
+	enumerable: true,
+	get: function() {
+		return Button;
+	}
+});
+Object.defineProperty(exports, "buttonVariants", {
+	enumerable: true,
+	get: function() {
+		return buttonVariants;
+	}
+});
+
+//# sourceMappingURL=button-BxnnE28H.cjs.map

package/dist/button-BxnnE28H.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"button-BxnnE28H.cjs","names":["cva","React","Slot","cn"],"sources":["../src/primitives/button.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { Slot } from '@radix-ui/react-slot';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { cn } from '../lib/cn.js';\n\nconst buttonVariants = cva(\n  'inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 disabled:saturate-0 aria-disabled:cursor-not-allowed aria-disabled:opacity-50 aria-disabled:saturate-0 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0',\n  {\n    variants: {\n      variant: {\n        default: 'bg-primary text-primary-foreground hover:bg-primary/90',\n        destructive: 'bg-destructive text-destructive-foreground hover:bg-destructive/90',\n        outline:\n          'border border-input bg-background text-foreground hover:bg-accent hover:text-accent-foreground',\n        secondary: 'bg-secondary text-secondary-foreground hover:bg-secondary/80',\n        ghost: 'hover:bg-accent hover:text-accent-foreground',\n        link: 'text-primary underline-offset-4 hover:underline',\n      },\n      size: {\n        // Shadcn new-york current defaults. The shared stylesheet keeps the\n        // standard 16px root; editable controls choose responsive typography\n        // locally when they need mobile `text-base` and desktop `md:text-sm`.\n        default: 'h-9 px-4 py-2',\n        sm: 'h-8 rounded-md px-3 text-xs',\n        lg: 'h-10 rounded-md px-6',\n        icon: 'h-9 w-9',\n      },\n    },\n    defaultVariants: {\n      variant: 'default',\n      size: 'default',\n    },\n  },\n);\n\nexport interface ButtonProps\n  extends React.ButtonHTMLAttributes<HTMLButtonElement>,\n    VariantProps<typeof buttonVariants> {\n  asChild?: boolean;\n}\n\nconst Button = React.forwardRef<HTMLButtonElement, ButtonProps>(\n  ({ className, variant, size, asChild = false, ...props }, ref) => {\n    const Comp = asChild ? Slot : 'button';\n    return (\n      <Comp className={cn(buttonVariants({ variant, size, className }))} ref={ref} {...props} />\n    );\n  },\n);\nButton.displayName = 'Button';\n\nexport { Button, buttonVariants };\n"],"mappings":";;;;;;AAOA,MAAM,kBAAA,qCAAiBA,CAAAA,CAAAA,IAAAA,CACrB,ieACA;CACE,UAAU;EACR,SAAS;GACP,SAAS;GACT,aAAa;GACb,SACE;GACF,WAAW;GACX,OAAO;GACP,MAAM;EACR;EACA,MAAM;GAIJ,SAAS;GACT,IAAI;GACJ,IAAI;GACJ,MAAM;EACR;CACF;CACA,iBAAiB;EACf,SAAS;EACT,MAAM;CACR;AACF,CACF;AAQA,MAAM,SAASC,MAAM,YAClB,EAAE,WAAW,SAAS,MAAM,UAAU,OAAO,GAAG,SAAS,QAAQ;CAEhE,QACE,GAAA,kBAAA,IAAA,CAFW,UAAUC,qBAAAA,OAAO,UAE5B;EAAM,WAAWC,kBAAAA,GAAG,eAAe;GAAE;GAAS;GAAM;EAAU,CAAC,CAAC;EAAQ;EAAK,GAAI;CAAQ,CAAA;AAE7F,CACF;AACA,OAAO,cAAc"}

package/dist/button-MWVeZaqj.js

@@ -0,0 +1,44 @@
+import { l as cn } from "./use-theme-dnE3Od3I.js";
+import * as React from "react";
+import { jsx } from "react/jsx-runtime";
+import { Slot } from "@radix-ui/react-slot";
+import { cva } from "class-variance-authority";
+//#region src/primitives/button.tsx
+const buttonVariants = cva("inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 disabled:saturate-0 aria-disabled:cursor-not-allowed aria-disabled:opacity-50 aria-disabled:saturate-0 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0", {
+	variants: {
+		variant: {
+			default: "bg-primary text-primary-foreground hover:bg-primary/90",
+			destructive: "bg-destructive text-destructive-foreground hover:bg-destructive/90",
+			outline: "border border-input bg-background text-foreground hover:bg-accent hover:text-accent-foreground",
+			secondary: "bg-secondary text-secondary-foreground hover:bg-secondary/80",
+			ghost: "hover:bg-accent hover:text-accent-foreground",
+			link: "text-primary underline-offset-4 hover:underline"
+		},
+		size: {
+			default: "h-9 px-4 py-2",
+			sm: "h-8 rounded-md px-3 text-xs",
+			lg: "h-10 rounded-md px-6",
+			icon: "h-9 w-9"
+		}
+	},
+	defaultVariants: {
+		variant: "default",
+		size: "default"
+	}
+});
+const Button = React.forwardRef(({ className, variant, size, asChild = false, ...props }, ref) => {
+	return jsx(asChild ? Slot : "button", {
+		className: cn(buttonVariants({
+			variant,
+			size,
+			className
+		})),
+		ref,
+		...props
+	});
+});
+Button.displayName = "Button";
+//#endregion
+export { buttonVariants as n, Button as t };
+
+//# sourceMappingURL=button-MWVeZaqj.js.map

package/dist/button-MWVeZaqj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"button-MWVeZaqj.js","names":[],"sources":["../src/primitives/button.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { Slot } from '@radix-ui/react-slot';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { cn } from '../lib/cn.js';\n\nconst buttonVariants = cva(\n  'inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 disabled:saturate-0 aria-disabled:cursor-not-allowed aria-disabled:opacity-50 aria-disabled:saturate-0 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0',\n  {\n    variants: {\n      variant: {\n        default: 'bg-primary text-primary-foreground hover:bg-primary/90',\n        destructive: 'bg-destructive text-destructive-foreground hover:bg-destructive/90',\n        outline:\n          'border border-input bg-background text-foreground hover:bg-accent hover:text-accent-foreground',\n        secondary: 'bg-secondary text-secondary-foreground hover:bg-secondary/80',\n        ghost: 'hover:bg-accent hover:text-accent-foreground',\n        link: 'text-primary underline-offset-4 hover:underline',\n      },\n      size: {\n        // Shadcn new-york current defaults. The shared stylesheet keeps the\n        // standard 16px root; editable controls choose responsive typography\n        // locally when they need mobile `text-base` and desktop `md:text-sm`.\n        default: 'h-9 px-4 py-2',\n        sm: 'h-8 rounded-md px-3 text-xs',\n        lg: 'h-10 rounded-md px-6',\n        icon: 'h-9 w-9',\n      },\n    },\n    defaultVariants: {\n      variant: 'default',\n      size: 'default',\n    },\n  },\n);\n\nexport interface ButtonProps\n  extends React.ButtonHTMLAttributes<HTMLButtonElement>,\n    VariantProps<typeof buttonVariants> {\n  asChild?: boolean;\n}\n\nconst Button = React.forwardRef<HTMLButtonElement, ButtonProps>(\n  ({ className, variant, size, asChild = false, ...props }, ref) => {\n    const Comp = asChild ? Slot : 'button';\n    return (\n      <Comp className={cn(buttonVariants({ variant, size, className }))} ref={ref} {...props} />\n    );\n  },\n);\nButton.displayName = 'Button';\n\nexport { Button, buttonVariants };\n"],"mappings":";;;;;;AAOA,MAAM,iBAAiB,IACrB,ieACA;CACE,UAAU;EACR,SAAS;GACP,SAAS;GACT,aAAa;GACb,SACE;GACF,WAAW;GACX,OAAO;GACP,MAAM;EACR;EACA,MAAM;GAIJ,SAAS;GACT,IAAI;GACJ,IAAI;GACJ,MAAM;EACR;CACF;CACA,iBAAiB;EACf,SAAS;EACT,MAAM;CACR;AACF,CACF;AAQA,MAAM,SAAS,MAAM,YAClB,EAAE,WAAW,SAAS,MAAM,UAAU,OAAO,GAAG,SAAS,QAAQ;CAEhE,OACE,IAFW,UAAU,OAAO,UAE5B;EAAM,WAAW,GAAG,eAAe;GAAE;GAAS;GAAM;EAAU,CAAC,CAAC;EAAQ;EAAK,GAAI;CAAQ,CAAA;AAE7F,CACF;AACA,OAAO,cAAc"}

package/dist/candidates-gate-Bb70LPAy.js

@@ -0,0 +1,135 @@
+import { declaredText, resolveCandidates, resolveFieldLabel } from "@burojs/core";
+import { useApp, useCandidatesAccess, useI18nCaps, useOptionalT, useTestIds } from "@burojs/react";
+import * as React from "react";
+import { Suspense, lazy } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/fields/lazy-relation-picker-dialog.tsx
+const Dialog = lazy(() => import("./relation-picker-dialog-B6nIiJBf.js").then((module) => ({ default: module.RelationPickerDialog })));
+function LazyRelationPickerDialog(props) {
+	return jsx(Suspense, {
+		fallback: null,
+		children: jsx(Dialog, { ...props })
+	});
+}
+//#endregion
+//#region src/fields/candidates-match.ts
+function rowMatches(row, filters) {
+	let unknown = false;
+	for (const filter of filters) {
+		const group = filter;
+		if (Array.isArray(group.and) || Array.isArray(group.or)) {
+			const answers = (Array.isArray(group.and) ? group.and : group.or).map((part) => rowMatches(row, [part]));
+			const all = Array.isArray(group.and);
+			const decided = answers.filter((answer) => answer !== void 0);
+			if (all ? decided.includes(false) : decided.length > 0 && !decided.includes(true)) return false;
+			if (decided.length < answers.length && !(all ? false : decided.includes(true))) unknown = true;
+			continue;
+		}
+		const { field, op, value } = filter;
+		if (typeof field !== "string" || typeof op !== "string") continue;
+		if (!Object.hasOwn(row, field)) {
+			unknown = true;
+			continue;
+		}
+		const held = holds(row[field], op, value);
+		if (held === false) return false;
+		if (held === void 0) unknown = true;
+	}
+	return unknown ? void 0 : true;
+}
+function holds(actual, op, expected) {
+	const list = Array.isArray(expected) ? expected : void 0;
+	const text = (value) => String(value ?? "").toLowerCase();
+	switch (op) {
+		case "eq": return Object.is(actual, expected) || String(actual) === String(expected);
+		case "neq": return !(Object.is(actual, expected) || String(actual) === String(expected));
+		case "in": return list === void 0 ? void 0 : list.some((entry) => String(entry) === String(actual));
+		case "notIn": return list === void 0 ? void 0 : !list.some((entry) => String(entry) === String(actual));
+		case "gt": return compare(actual, expected, (a, b) => a > b);
+		case "gte": return compare(actual, expected, (a, b) => a >= b);
+		case "lt": return compare(actual, expected, (a, b) => a < b);
+		case "lte": return compare(actual, expected, (a, b) => a <= b);
+		case "contains": return text(actual).includes(text(expected));
+		case "startsWith": return text(actual).startsWith(text(expected));
+		case "endsWith": return text(actual).endsWith(text(expected));
+		case "isNull": return actual === null || actual === void 0;
+		case "isNotNull": return actual !== null && actual !== void 0;
+		default: return;
+	}
+}
+function compare(actual, expected, test) {
+	return typeof actual === "number" && typeof expected === "number" || typeof actual === "string" && typeof expected === "string" ? test(actual, expected) : void 0;
+}
+//#endregion
+//#region src/fields/candidates-gate.ts
+const NO_SOURCES = Object.freeze({});
+const NO_FILTERS = Object.freeze([]);
+function useCandidatesGate(input) {
+	const { to, candidates, sources, resource, fieldName } = input;
+	const t = useOptionalT();
+	const app = useApp();
+	const tid = useTestIds();
+	const ownerCaps = useI18nCaps(resource);
+	const targetCaps = useI18nCaps(to ?? resource);
+	const access = useCandidatesAccess(to ?? "", candidates);
+	const resolution = React.useMemo(() => resolveCandidates(candidates, sources ?? NO_SOURCES), [candidates, sources]);
+	if (candidates === void 0 || candidates.length === 0) return { filters: NO_FILTERS };
+	const testId = tid.relationCandidatesHint(resource, fieldName);
+	if (access.status === "pending") return {
+		filters: NO_FILTERS,
+		gate: { kind: "pending" }
+	};
+	if (access.status === "forbidden") {
+		const declared = declaredText("field", (app.registry.get(to ?? "")?.fields)?.[access.field], "label");
+		const label = resolveFieldLabel(targetCaps, access.field, declared);
+		return {
+			filters: NO_FILTERS,
+			gate: {
+				kind: "forbidden",
+				testId,
+				message: t("relationPicker.cannotSearchBy", {
+					params: { label },
+					defaultValue: `You cannot search by ${label}`
+				})
+			}
+		};
+	}
+	if (resolution.status === "pending") return {
+		filters: NO_FILTERS,
+		gate: { kind: "pending" }
+	};
+	if (resolution.status === "empty") {
+		const { source, path } = resolution.hint;
+		const head = path[0];
+		const declared = (source === "values" || source === "record") && head !== void 0 ? declaredText("field", (app.registry.get(resource)?.fields)?.[head], "label") : void 0;
+		const label = resolveFieldLabel(ownerCaps, head ?? source, declared);
+		return {
+			filters: NO_FILTERS,
+			gate: {
+				kind: "empty",
+				testId,
+				message: t("relationPicker.chooseFirst", {
+					params: { label },
+					defaultValue: `Choose ${label} first`
+				})
+			}
+		};
+	}
+	return { filters: resolution.filters };
+}
+function useCandidateSelection(input) {
+	const { fixedFilters } = input;
+	const gate = useCandidatesGate(input);
+	const filters = gate.filters;
+	const combined = React.useMemo(() => filters.length === 0 ? fixedFilters : [...filters, ...fixedFilters ?? []], [filters, fixedFilters]);
+	const rowFits = React.useMemo(() => filters.length === 0 ? void 0 : (row) => rowMatches(row, filters), [filters]);
+	return {
+		fixedFilters: combined,
+		...gate.gate === void 0 ? {} : { gate: gate.gate },
+		...rowFits === void 0 ? {} : { rowFits }
+	};
+}
+//#endregion
+export { useCandidatesGate as n, LazyRelationPickerDialog as r, useCandidateSelection as t };
+
+//# sourceMappingURL=candidates-gate-Bb70LPAy.js.map

package/dist/candidates-gate-Bb70LPAy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidates-gate-Bb70LPAy.js","names":[],"sources":["../src/fields/lazy-relation-picker-dialog.tsx","../src/fields/candidates-match.ts","../src/fields/candidates-gate.ts"],"sourcesContent":["import { type ComponentProps, type ReactElement, Suspense, lazy } from 'react';\nimport type { RelationPickerDialog } from './relation-picker-dialog.js';\n\nconst Dialog = lazy(() =>\n  import('./relation-picker-dialog.js').then((module) => ({\n    default: module.RelationPickerDialog,\n  })),\n);\n\n/** The \"Advanced search\" dialog, loaded on the first open: nothing is drawn until it arrives. */\nexport function LazyRelationPickerDialog(\n  props: ComponentProps<typeof RelationPickerDialog>,\n): ReactElement {\n  return (\n    <Suspense fallback={null}>\n      <Dialog {...props} />\n    </Suspense>\n  );\n}\n","import type { FixedFilterInput } from '@burojs/core';\n\ntype Entry = { readonly field?: unknown; readonly op?: unknown; readonly value?: unknown };\n\n/**\n * Whether `row` meets every candidate filter (P7 3.4): `true`, `false`, or `undefined` when the\n * row does not carry a field a filter names (a narrower projection), so nothing can be said.\n * Only the flat `{ field, op, value }` entries candidates resolve to are evaluated; this is what\n * \"does not match the current filter\" is decided on, never what is sent.\n */\nexport function rowMatches(\n  row: Readonly<Record<string, unknown>>,\n  filters: readonly FixedFilterInput[],\n): boolean | undefined {\n  let unknown = false;\n  for (const filter of filters) {\n    const group = filter as { readonly and?: unknown; readonly or?: unknown };\n    if (Array.isArray(group.and) || Array.isArray(group.or)) {\n      const parts = (\n        Array.isArray(group.and) ? group.and : group.or\n      ) as readonly FixedFilterInput[];\n      const answers = parts.map((part) => rowMatches(row, [part]));\n      const all = Array.isArray(group.and);\n      const decided = answers.filter((answer) => answer !== undefined);\n      if (all ? decided.includes(false) : decided.length > 0 && !decided.includes(true))\n        return false;\n      if (decided.length < answers.length && !(all ? false : decided.includes(true)))\n        unknown = true;\n      continue;\n    }\n    const { field, op, value } = filter as Entry;\n    if (typeof field !== 'string' || typeof op !== 'string') continue;\n    if (!Object.hasOwn(row, field)) {\n      unknown = true;\n      continue;\n    }\n    const held = holds(row[field], op, value);\n    if (held === false) return false;\n    if (held === undefined) unknown = true;\n  }\n  return unknown ? undefined : true;\n}\n\nfunction holds(actual: unknown, op: string, expected: unknown): boolean | undefined {\n  const list = Array.isArray(expected) ? (expected as readonly unknown[]) : undefined;\n  const text = (value: unknown) => String(value ?? '').toLowerCase();\n  switch (op) {\n    case 'eq':\n      return Object.is(actual, expected) || String(actual) === String(expected);\n    case 'neq':\n      return !(Object.is(actual, expected) || String(actual) === String(expected));\n    case 'in':\n      return list === undefined\n        ? undefined\n        : list.some((entry) => String(entry) === String(actual));\n    case 'notIn':\n      return list === undefined\n        ? undefined\n        : !list.some((entry) => String(entry) === String(actual));\n    case 'gt':\n      return compare(actual, expected, (a, b) => a > b);\n    case 'gte':\n      return compare(actual, expected, (a, b) => a >= b);\n    case 'lt':\n      return compare(actual, expected, (a, b) => a < b);\n    case 'lte':\n      return compare(actual, expected, (a, b) => a <= b);\n    case 'contains':\n      return text(actual).includes(text(expected));\n    case 'startsWith':\n      return text(actual).startsWith(text(expected));\n    case 'endsWith':\n      return text(actual).endsWith(text(expected));\n    case 'isNull':\n      return actual === null || actual === undefined;\n    case 'isNotNull':\n      return actual !== null && actual !== undefined;\n    default:\n      return undefined;\n  }\n}\n\nfunction compare(\n  actual: unknown,\n  expected: unknown,\n  test: (a: number | string, b: number | string) => boolean,\n): boolean | undefined {\n  const both =\n    (typeof actual === 'number' && typeof expected === 'number') ||\n    (typeof actual === 'string' && typeof expected === 'string');\n  return both ? test(actual as number | string, expected as number | string) : undefined;\n}\n","import {\n  type FixedFilterInput,\n  type RelationCandidate,\n  type ScreenSources,\n  resolveCandidates,\n  resolveFieldLabel,\n  declaredText,\n} from '@burojs/core';\nimport { useApp, useCandidatesAccess, useI18nCaps, useOptionalT, useTestIds } from '@burojs/react';\nimport * as React from 'react';\nimport { rowMatches } from './candidates-match.js';\n\n/** A select that must not read its target now (P7 3.4): why, and what it tells the user. */\nexport type CandidatesGate =\n  | { readonly kind: 'pending' }\n  | { readonly kind: 'empty'; readonly message: string; readonly testId: string }\n  | { readonly kind: 'forbidden'; readonly message: string; readonly testId: string };\n\nconst NO_SOURCES: ScreenSources = Object.freeze({});\nconst NO_FILTERS: readonly FixedFilterInput[] = Object.freeze([]);\n\n/**\n * A relation field's `candidates` as the select applies them (P7 3.4): the filters to send and,\n * when they say the target must not be read yet, the gate that tells the user why. The refs are\n * read from the owner's projected sources, so a field P5 hides reads `null` (the select asks for\n * it first, and sends nothing); a candidate on a target field the user may not view forbids the\n * read; an undecided source or permission map keeps the select disabled.\n */\nexport function useCandidatesGate(input: {\n  readonly to: string | undefined;\n  readonly candidates: readonly RelationCandidate[] | undefined;\n  readonly sources: ScreenSources | undefined;\n  readonly resource: string;\n  readonly fieldName: string;\n}): { readonly filters: readonly FixedFilterInput[]; readonly gate?: CandidatesGate } {\n  const { to, candidates, sources, resource, fieldName } = input;\n  const t = useOptionalT();\n  const app = useApp();\n  const tid = useTestIds();\n  const ownerCaps = useI18nCaps(resource);\n  const targetCaps = useI18nCaps(to ?? resource);\n  const access = useCandidatesAccess(to ?? '', candidates);\n  const resolution = React.useMemo(\n    () => resolveCandidates(candidates, sources ?? NO_SOURCES),\n    [candidates, sources],\n  );\n  if (candidates === undefined || candidates.length === 0) return { filters: NO_FILTERS };\n  const testId = tid.relationCandidatesHint(resource, fieldName);\n  if (access.status === 'pending') return { filters: NO_FILTERS, gate: { kind: 'pending' } };\n  if (access.status === 'forbidden') {\n    const declared = declaredText(\n      'field',\n      (app.registry.get(to ?? '')?.fields as Record<string, unknown> | undefined)?.[access.field],\n      'label',\n    );\n    const label = resolveFieldLabel(targetCaps, access.field, declared);\n    return {\n      filters: NO_FILTERS,\n      gate: {\n        kind: 'forbidden',\n        testId,\n        message: t('relationPicker.cannotSearchBy', {\n          params: { label },\n          defaultValue: `You cannot search by ${label}`,\n        }),\n      },\n    };\n  }\n  if (resolution.status === 'pending') return { filters: NO_FILTERS, gate: { kind: 'pending' } };\n  if (resolution.status === 'empty') {\n    const { source, path } = resolution.hint;\n    const head = path[0];\n    // The field a `values` / `record` ref reads is labelled as the owner labels it; any other\n    // source (`scope`, `user`) names the key it reads, humanised.\n    const own = source === 'values' || source === 'record';\n    const declared =\n      own && head !== undefined\n        ? declaredText(\n            'field',\n            (app.registry.get(resource)?.fields as Record<string, unknown> | undefined)?.[head],\n            'label',\n          )\n        : undefined;\n    const label = resolveFieldLabel(ownerCaps, head ?? source, declared);\n    return {\n      filters: NO_FILTERS,\n      gate: {\n        kind: 'empty',\n        testId,\n        message: t('relationPicker.chooseFirst', {\n          params: { label },\n          defaultValue: `Choose ${label} first`,\n        }),\n      },\n    };\n  }\n  return { filters: resolution.filters };\n}\n\n/**\n * A select's declared candidates as the shared select wiring applies them (`CandidatesRelationPicker`\n * and `useRelationPicker`): the gate, the resolved candidate filters prepended to the caller's\n * `fixedFilters`, and whether a loaded row fits them (`undefined` when no candidate filter applies).\n */\nexport function useCandidateSelection(input: {\n  readonly to: string | undefined;\n  readonly candidates: readonly RelationCandidate[] | undefined;\n  readonly sources: ScreenSources | undefined;\n  readonly resource: string;\n  readonly fieldName: string;\n  readonly fixedFilters: readonly FixedFilterInput[] | undefined;\n}): {\n  readonly fixedFilters: readonly FixedFilterInput[] | undefined;\n  readonly gate?: CandidatesGate;\n  readonly rowFits?: (row: Record<string, unknown>) => boolean | undefined;\n} {\n  const { fixedFilters } = input;\n  const gate = useCandidatesGate(input);\n  const filters = gate.filters;\n  const combined = React.useMemo(\n    () => (filters.length === 0 ? fixedFilters : [...filters, ...(fixedFilters ?? [])]),\n    [filters, fixedFilters],\n  );\n  const rowFits = React.useMemo(\n    () =>\n      filters.length === 0 ? undefined : (row: Record<string, unknown>) => rowMatches(row, filters),\n    [filters],\n  );\n  return {\n    fixedFilters: combined,\n    ...(gate.gate === undefined ? {} : { gate: gate.gate }),\n    ...(rowFits === undefined ? {} : { rowFits }),\n  };\n}\n"],"mappings":"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"}