@burojs/ui-shadcn 0.4.0 → 0.5.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-CX2PBu6l.js

@@ -0,0 +1,63 @@
+import { resolveCandidates, resolveFieldLabel } from "@burojs/core";
+import { useApp, useCandidatesAccess, useI18nCaps, useOptionalT, useTestIds } from "@burojs/react";
+import * as React from "react";
+//#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 = (app.registry.get(to ?? "")?.fields)?.[access.field]?.label;
+		const label = resolveFieldLabel(targetCaps, access.field, typeof declared === "string" ? declared : void 0);
+		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 ? (app.registry.get(resource)?.fields)?.[head]?.label : void 0;
+		const label = resolveFieldLabel(ownerCaps, head ?? source, typeof declared === "string" ? declared : void 0);
+		return {
+			filters: NO_FILTERS,
+			gate: {
+				kind: "empty",
+				testId,
+				message: t("relationPicker.chooseFirst", {
+					params: { label },
+					defaultValue: `Choose ${label} first`
+				})
+			}
+		};
+	}
+	return { filters: resolution.filters };
+}
+//#endregion
+export { useCandidatesGate as t };
+
+//# sourceMappingURL=candidates-gate-CX2PBu6l.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"candidates-gate-CX2PBu6l.js","names":[],"sources":["../src/fields/candidates-gate.ts"],"sourcesContent":["import {\n  type FixedFilterInput,\n  type RelationCandidate,\n  type ScreenSources,\n  resolveCandidates,\n  resolveFieldLabel,\n} from '@burojs/core';\nimport { useApp, useCandidatesAccess, useI18nCaps, useOptionalT, useTestIds } from '@burojs/react';\nimport * as React from 'react';\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 = (\n      app.registry.get(to ?? '')?.fields as Record<string, { label?: unknown }> | undefined\n    )?.[access.field]?.label;\n    const label = resolveFieldLabel(\n      targetCaps,\n      access.field,\n      typeof declared === 'string' ? declared : undefined,\n    );\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        ? (app.registry.get(resource)?.fields as Record<string, { label?: unknown }> | undefined)?.[\n            head\n          ]?.label\n        : undefined;\n    const label = resolveFieldLabel(\n      ownerCaps,\n      head ?? source,\n      typeof declared === 'string' ? declared : undefined,\n    );\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"],"mappings":";;;;AAgBA,MAAM,aAA4B,OAAO,OAAO,CAAC,CAAC;AAClD,MAAM,aAA0C,OAAO,OAAO,CAAC,CAAC;AAShE,SAAgB,kBAAkB,OAMoD;CACpF,MAAM,EAAE,IAAI,YAAY,SAAS,UAAU,cAAc;CACzD,MAAM,IAAI,aAAa;CACvB,MAAM,MAAM,OAAO;CACnB,MAAM,MAAM,WAAW;CACvB,MAAM,YAAY,YAAY,QAAQ;CACtC,MAAM,aAAa,YAAY,MAAM,QAAQ;CAC7C,MAAM,SAAS,oBAAoB,MAAM,IAAI,UAAU;CACvD,MAAM,aAAa,MAAM,cACjB,kBAAkB,YAAY,WAAW,UAAU,GACzD,CAAC,YAAY,OAAO,CACtB;CACA,IAAI,eAAe,KAAA,KAAa,WAAW,WAAW,GAAG,OAAO,EAAE,SAAS,WAAW;CACtF,MAAM,SAAS,IAAI,uBAAuB,UAAU,SAAS;CAC7D,IAAI,OAAO,WAAW,WAAW,OAAO;EAAE,SAAS;EAAY,MAAM,EAAE,MAAM,UAAU;CAAE;CACzF,IAAI,OAAO,WAAW,aAAa;EACjC,MAAM,YACJ,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC,EAAE,OAAA,GAC1B,OAAO,MAAM,EAAE;EACnB,MAAM,QAAQ,kBACZ,YACA,OAAO,OACP,OAAO,aAAa,WAAW,WAAW,KAAA,CAC5C;EACA,OAAO;GACL,SAAS;GACT,MAAM;IACJ,MAAM;IACN;IACA,SAAS,EAAE,iCAAiC;KAC1C,QAAQ,EAAE,MAAM;KAChB,cAAc,wBAAwB;IACxC,CAAC;GACH;EACF;CACF;CACA,IAAI,WAAW,WAAW,WAAW,OAAO;EAAE,SAAS;EAAY,MAAM,EAAE,MAAM,UAAU;CAAE;CAC7F,IAAI,WAAW,WAAW,SAAS;EACjC,MAAM,EAAE,QAAQ,SAAS,WAAW;EACpC,MAAM,OAAO,KAAK;EAIlB,MAAM,YADM,WAAW,YAAY,WAAW,aAErC,SAAS,KAAA,KACX,IAAI,SAAS,IAAI,QAAQ,CAAC,EAAE,OAAA,GAC3B,KACD,EAAE,QACH,KAAA;EACN,MAAM,QAAQ,kBACZ,WACA,QAAQ,QACR,OAAO,aAAa,WAAW,WAAW,KAAA,CAC5C;EACA,OAAO;GACL,SAAS;GACT,MAAM;IACJ,MAAM;IACN;IACA,SAAS,EAAE,8BAA8B;KACvC,QAAQ,EAAE,MAAM;KAChB,cAAc,UAAU,MAAM;IAChC,CAAC;GACH;EACF;CACF;CACA,OAAO,EAAE,SAAS,WAAW,QAAQ;AACvC"}

package/dist/candidates-gate-DiFI52r7.cjs

@@ -0,0 +1,70 @@
+const require_use_theme = require("./use-theme-DFlpXils.cjs");
+let _burojs_core = require("@burojs/core");
+let _burojs_react = require("@burojs/react");
+let react = require("react");
+react = require_use_theme.__toESM(react, 1);
+//#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 = (0, _burojs_react.useOptionalT)();
+	const app = (0, _burojs_react.useApp)();
+	const tid = (0, _burojs_react.useTestIds)();
+	const ownerCaps = (0, _burojs_react.useI18nCaps)(resource);
+	const targetCaps = (0, _burojs_react.useI18nCaps)(to ?? resource);
+	const access = (0, _burojs_react.useCandidatesAccess)(to ?? "", candidates);
+	const resolution = react.useMemo(() => (0, _burojs_core.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 = (app.registry.get(to ?? "")?.fields)?.[access.field]?.label;
+		const label = (0, _burojs_core.resolveFieldLabel)(targetCaps, access.field, typeof declared === "string" ? declared : void 0);
+		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 ? (app.registry.get(resource)?.fields)?.[head]?.label : void 0;
+		const label = (0, _burojs_core.resolveFieldLabel)(ownerCaps, head ?? source, typeof declared === "string" ? declared : void 0);
+		return {
+			filters: NO_FILTERS,
+			gate: {
+				kind: "empty",
+				testId,
+				message: t("relationPicker.chooseFirst", {
+					params: { label },
+					defaultValue: `Choose ${label} first`
+				})
+			}
+		};
+	}
+	return { filters: resolution.filters };
+}
+//#endregion
+Object.defineProperty(exports, "useCandidatesGate", {
+	enumerable: true,
+	get: function() {
+		return useCandidatesGate;
+	}
+});
+
+//# sourceMappingURL=candidates-gate-DiFI52r7.cjs.map

package/dist/candidates-gate-DiFI52r7.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidates-gate-DiFI52r7.cjs","names":["useOptionalT","useApp","useTestIds","useI18nCaps","useCandidatesAccess","React","resolveCandidates","resolveFieldLabel"],"sources":["../src/fields/candidates-gate.ts"],"sourcesContent":["import {\n  type FixedFilterInput,\n  type RelationCandidate,\n  type ScreenSources,\n  resolveCandidates,\n  resolveFieldLabel,\n} from '@burojs/core';\nimport { useApp, useCandidatesAccess, useI18nCaps, useOptionalT, useTestIds } from '@burojs/react';\nimport * as React from 'react';\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 = (\n      app.registry.get(to ?? '')?.fields as Record<string, { label?: unknown }> | undefined\n    )?.[access.field]?.label;\n    const label = resolveFieldLabel(\n      targetCaps,\n      access.field,\n      typeof declared === 'string' ? declared : undefined,\n    );\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        ? (app.registry.get(resource)?.fields as Record<string, { label?: unknown }> | undefined)?.[\n            head\n          ]?.label\n        : undefined;\n    const label = resolveFieldLabel(\n      ownerCaps,\n      head ?? source,\n      typeof declared === 'string' ? declared : undefined,\n    );\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"],"mappings":";;;;;;AAgBA,MAAM,aAA4B,OAAO,OAAO,CAAC,CAAC;AAClD,MAAM,aAA0C,OAAO,OAAO,CAAC,CAAC;AAShE,SAAgB,kBAAkB,OAMoD;CACpF,MAAM,EAAE,IAAI,YAAY,SAAS,UAAU,cAAc;CACzD,MAAM,KAAA,GAAIA,cAAAA,aAAAA,CAAa;CACvB,MAAM,OAAA,GAAMC,cAAAA,OAAAA,CAAO;CACnB,MAAM,OAAA,GAAMC,cAAAA,WAAAA,CAAW;CACvB,MAAM,aAAA,GAAYC,cAAAA,YAAAA,CAAY,QAAQ;CACtC,MAAM,cAAA,GAAaA,cAAAA,YAAAA,CAAY,MAAM,QAAQ;CAC7C,MAAM,UAAA,GAASC,cAAAA,oBAAAA,CAAoB,MAAM,IAAI,UAAU;CACvD,MAAM,aAAaC,MAAM,eAAA,GACjBC,aAAAA,kBAAAA,CAAkB,YAAY,WAAW,UAAU,GACzD,CAAC,YAAY,OAAO,CACtB;CACA,IAAI,eAAe,KAAA,KAAa,WAAW,WAAW,GAAG,OAAO,EAAE,SAAS,WAAW;CACtF,MAAM,SAAS,IAAI,uBAAuB,UAAU,SAAS;CAC7D,IAAI,OAAO,WAAW,WAAW,OAAO;EAAE,SAAS;EAAY,MAAM,EAAE,MAAM,UAAU;CAAE;CACzF,IAAI,OAAO,WAAW,aAAa;EACjC,MAAM,YACJ,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC,EAAE,OAAA,GAC1B,OAAO,MAAM,EAAE;EACnB,MAAM,SAAA,GAAQC,aAAAA,kBAAAA,CACZ,YACA,OAAO,OACP,OAAO,aAAa,WAAW,WAAW,KAAA,CAC5C;EACA,OAAO;GACL,SAAS;GACT,MAAM;IACJ,MAAM;IACN;IACA,SAAS,EAAE,iCAAiC;KAC1C,QAAQ,EAAE,MAAM;KAChB,cAAc,wBAAwB;IACxC,CAAC;GACH;EACF;CACF;CACA,IAAI,WAAW,WAAW,WAAW,OAAO;EAAE,SAAS;EAAY,MAAM,EAAE,MAAM,UAAU;CAAE;CAC7F,IAAI,WAAW,WAAW,SAAS;EACjC,MAAM,EAAE,QAAQ,SAAS,WAAW;EACpC,MAAM,OAAO,KAAK;EAIlB,MAAM,YADM,WAAW,YAAY,WAAW,aAErC,SAAS,KAAA,KACX,IAAI,SAAS,IAAI,QAAQ,CAAC,EAAE,OAAA,GAC3B,KACD,EAAE,QACH,KAAA;EACN,MAAM,SAAA,GAAQA,aAAAA,kBAAAA,CACZ,WACA,QAAQ,QACR,OAAO,aAAa,WAAW,WAAW,KAAA,CAC5C;EACA,OAAO;GACL,SAAS;GACT,MAAM;IACJ,MAAM;IACN;IACA,SAAS,EAAE,8BAA8B;KACvC,QAAQ,EAAE,MAAM;KAChB,cAAc,UAAU,MAAM;IAChC,CAAC;GACH;EACF;CACF;CACA,OAAO,EAAE,SAAS,WAAW,QAAQ;AACvC"}