@burojs/ui-shadcn 0.6.0 → 0.7.0

package/dist/{relation-picker-dialog-B6nIiJBf.js → relation-picker-dialog-DoEY8EkH.js}

@@ -1,29 +1,34 @@
 import { l as cn } from "./use-theme-dnE3Od3I.js";
 import { t as Button } from "./button-MWVeZaqj.js";
 import { t as Input } from "./input-CUPStzZO.js";
-import { a as DialogFooter, i as DialogDescription, o as DialogHeader, r as DialogContent, s as DialogTitle, t as Dialog } from "./dialog-B_rt9S1c.js";
-import { d as useRowTitle } from "./search-access-CPPmfuvy.js";
-import { C as TableHeader, S as TableHead, t as FilterBuilder, v as Table, w as TableRow, x as TableCell, y as TableBody } from "./filter-builder-Bhn-dhZV.js";
-import { t as RelationCreateButton } from "./relation-create-h6F9B4C4.js";
-import { t as useDialogFilterState } from "./use-dialog-filter-state-C--oMAZG.js";
-import { declaredText, enumNamespaceOf, enumValueText, fieldOptionText, resolveResourceLabel } from "@burojs/core";
-import { useApp, useI18nCaps, useList, useListAccess, useOptionalT } from "@burojs/react";
+import { a as DialogFooter, i as DialogDescription, o as DialogHeader, r as DialogContent, s as DialogTitle, t as Dialog } from "./dialog-C123sVQ8.js";
+import { m as useRowTitle, t as RelationCreateButton } from "./relation-create-C43cdPQt.js";
+import { A as TableRow, D as TableCell, O as TableHead, P as ResolvedFieldDisplay, T as TableBody, k as TableHeader, t as FilterBuilder, w as Table } from "./filter-builder-DaWHUZuV.js";
+import { t as useDialogFilterState } from "./use-dialog-filter-state-B_MqzHaT.js";
+import { columnName, declaredField, declaredText, enumNamespaceOf, enumValueText, fieldOptionText, resolveFieldLabel, resolveResourceLabel, routeResourceKey } from "@burojs/core";
+import { recordKeyOf, useApp, useChromeT, useI18nCaps, useList, useListAccess, useOptionalT } from "@burojs/react";
 import { IconArrowDown, IconArrowUp, IconCheck, IconChevronRight, IconLoader2, IconSearch, IconSelector } from "@tabler/icons-react";
 import * as React from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/fields/relation-picker-dialog.tsx
 const noop = () => void 0;
 const DEBOUNCE_MS = 250;
-function RelationPickerDialog({ to, open, onOpenChange, onSelect, onSelectRow, searchField, valueField = "id", fixedFilters, scope = "context", scopeField, create, createSeeds, fieldName, onBeforeCreate, pageSize = 8, multiple = false, selected, onToggle, onDone }) {
+function RelationPickerDialog({ to: toInput, open, onOpenChange, onSelect, onSelectRow, searchField, valueField: valueFieldProp, fixedFilters, scope = "context", scopeField, create, createSeeds, fieldName, onBeforeCreate, pageSize = 8, multiple = false, selected, onToggle, onDone, disabledKeys, disabledLabel }) {
+	const to = routeResourceKey(toInput);
 	const app = useApp();
 	const caps = useI18nCaps();
+	const targetCaps = useI18nCaps(to);
 	const t = useOptionalT();
+	const chromeT = useChromeT();
 	const tr = (key, params, fallback) => t?.(key, {
 		params,
 		defaultValue: fallback
 	}) ?? fallback ?? key;
 	const targetDef = app.registry.get(to);
 	const rowTitle = useRowTitle(to, targetDef?.displayField);
+	const declaredIdField = (targetDef?.data)?.idField;
+	const idField = typeof declaredIdField === "string" && declaredIdField.length > 0 ? declaredIdField : "id";
+	const valueField = valueFieldProp ?? idField;
 	const [search, setSearchInput] = React.useState("");
 	const [debounced, setDebounced] = React.useState("");
 	const [sort, setSort] = React.useState({
@@ -52,7 +57,7 @@ function RelationPickerDialog({ to, open, onOpenChange, onSelect, onSelectRow, s
 	}, [open]);
 	const listAccess = useListAccess(to);
 	const extraColumns = React.useMemo(() => {
-		return (targetDef?.views?.list?.columns ?? []).filter((c) => c !== "id" && c !== displayField).filter((c) => listAccess.status === "ready" && listAccess.columnVisible(c)).slice(0, 2);
+		return (targetDef?.views?.list?.columns ?? []).map(columnName).filter((c) => c !== "id" && c !== displayField).filter((c) => listAccess.status === "ready" && listAccess.columnVisible(c)).slice(0, 2);
 	}, [
 		targetDef,
 		displayField,
@@ -82,6 +87,42 @@ function RelationPickerDialog({ to, open, onOpenChange, onSelect, onSelectRow, s
 	const pageIsFull = rows.length >= pageSize;
 	const hasNextPage = knownTotal ? filterState.page < totalPages : pageIsFull;
 	const isLoading = query.isLoading || query.isFetching;
+	const keyOf = (row) => valueField === idField ? recordKeyOf(targetDef, row) : row[valueField];
+	const pageKeys = rows.map(keyOf).filter((key) => typeof key === "string" || typeof key === "number");
+	const asked = JSON.stringify(pageKeys);
+	const [disabled, setDisabled] = React.useState(void 0);
+	const [attempt, setAttempt] = React.useState(0);
+	React.useEffect(() => {
+		if (disabledKeys === void 0 || pageKeys.length === 0) return;
+		const controller = new AbortController();
+		disabledKeys(pageKeys, controller.signal).then((keys) => {
+			if (!controller.signal.aborted) setDisabled({
+				asked,
+				attempt,
+				keys
+			});
+		}, () => {
+			if (!controller.signal.aborted) setDisabled({
+				asked,
+				attempt,
+				keys: "failed"
+			});
+		});
+		return () => controller.abort();
+	}, [
+		asked,
+		attempt,
+		disabledKeys
+	]);
+	const answer = disabledKeys === void 0 || pageKeys.length === 0 || disabled === void 0 || disabled.asked !== asked || disabled.attempt !== attempt ? void 0 : disabled.keys;
+	const checking = disabledKeys !== void 0 && pageKeys.length > 0 && answer === void 0;
+	const checkFailed = answer === "failed";
+	const isDisabled = (row) => {
+		if (disabledKeys === void 0) return false;
+		if (answer === void 0 || answer === "failed") return true;
+		return answer.has(String(keyOf(row)));
+	};
+	const disabledCount = answer === void 0 || answer === "failed" ? 0 : rows.filter(isDisabled).length;
 	const toggleSort = (field) => {
 		setSort((prev) => prev.field === field ? {
 			field,
@@ -91,14 +132,11 @@ function RelationPickerDialog({ to, open, onOpenChange, onSelect, onSelectRow, s
 			dir: "asc"
 		});
 	};
-	const SortIcon = ({ field }) => {
-		if (sort.field !== field) return jsx(IconSelector, { className: "ml-1 inline size-3 opacity-40" });
-		return sort.dir === "asc" ? jsx(IconArrowUp, { className: "ml-1 inline size-3" }) : jsx(IconArrowDown, { className: "ml-1 inline size-3" });
-	};
 	const targetLabel = resolveResourceLabel(caps, to, "single", targetDef);
 	const colCount = 2 + extraColumns.length;
 	const pick = (row) => {
-		const picked = valueField === "id" ? row.id : row[valueField];
+		if (isDisabled(row)) return;
+		const picked = keyOf(row);
 		if (picked === null || picked === void 0 || picked === "") return;
 		if (multiple) {
 			onToggle?.(picked, row);
@@ -161,7 +199,14 @@ function RelationPickerDialog({ to, open, onOpenChange, onSelect, onSelectRow, s
 								jsxs(TableHead, {
 									className: "h-9 w-14 cursor-pointer select-none",
 									onClick: () => toggleSort("id"),
-									children: ["ID ", jsx(SortIcon, { field: "id" })]
+									children: [
+										tr("relationPicker.idColumn", void 0, "ID"),
+										" ",
+										jsx(SortIcon, {
+											field: "id",
+											sort
+										})
+									]
 								}),
 								jsxs(TableHead, {
 									className: cn("h-9 select-none", titleSortable && "cursor-pointer"),
@@ -169,13 +214,19 @@ function RelationPickerDialog({ to, open, onOpenChange, onSelect, onSelectRow, s
 									children: [
 										targetLabel,
 										" ",
-										titleSortable && jsx(SortIcon, { field: displayField })
+										titleSortable && jsx(SortIcon, {
+											field: displayField,
+											sort
+										})
 									]
 								}),
 								extraColumns.map((c) => jsxs(TableHead, {
 									className: "h-9 cursor-pointer select-none",
 									onClick: () => toggleSort(c),
-									children: [declaredText("field", targetDef?.fields?.[c], "label") ?? c, jsx(SortIcon, { field: c })]
+									children: [resolveFieldLabel(targetCaps, c, declaredText("field", targetDef?.fields?.[c], "label")), jsx(SortIcon, {
+										field: c,
+										sort
+									})]
 								}, c)),
 								jsx(TableHead, { className: "h-9 w-8" })
 							]
@@ -195,16 +246,19 @@ function RelationPickerDialog({ to, open, onOpenChange, onSelect, onSelectRow, s
 							children: tr("relation.noResults", void 0, "No results.")
 						})
 					}) : rows.map((row) => {
-						const idStr = String(row.id);
+						const idStr = String(recordKeyOf(targetDef, row));
+						const rowDisabled = isDisabled(row);
+						const checked = rowDisabled || (selected ?? []).some((key) => String(key) === String(keyOf(row)));
 						return jsxs(TableRow, {
-							className: "cursor-pointer",
+							className: cn(rowDisabled ? "cursor-not-allowed opacity-60" : "cursor-pointer"),
 							"data-testid": `relation-picker-dialog:${to}:row:${idStr}`,
-							...multiple ? { "aria-selected": (selected ?? []).some((key) => String(key) === String(valueField === "id" ? row.id : row[valueField])) } : {},
+							...multiple ? { "aria-selected": checked } : {},
+							...rowDisabled ? { "aria-disabled": true } : {},
 							onClick: () => pick(row),
 							children: [
-								jsxs(TableCell, {
+								jsx(TableCell, {
 									className: "py-2 tabular-nums text-muted-foreground",
-									children: ["#", idStr]
+									children: tr("relationPicker.recordNumber", { id: idStr }, `#${idStr}`)
 								}),
 								jsx(TableCell, {
 									className: "py-2 font-medium",
@@ -212,12 +266,22 @@ function RelationPickerDialog({ to, open, onOpenChange, onSelect, onSelectRow, s
 								}),
 								extraColumns.map((c) => jsx(TableCell, {
 									className: "py-2 text-muted-foreground",
-									children: formatCell(row[c], targetDef?.fields?.[c], (ns) => app.registry.enums.get(ns))
+									children: jsx(ResolvedFieldDisplay, {
+										resource: targetDef?.ref ?? {
+											namespace: "default",
+											id: to
+										},
+										name: c,
+										field: (targetDef === void 0 ? void 0 : declaredField(targetDef, c)) ?? targetDef?.fields?.[c] ?? { type: "unknown" },
+										value: row[c],
+										record: row,
+										fallback: formatCell(row[c], targetDef?.fields?.[c], (ns) => app.registry.enums.get(ns))
+									})
 								}, c)),
 								jsx(TableCell, {
 									className: "py-2 text-right",
 									children: multiple ? jsx(IconCheck, {
-										className: cn("ml-auto size-4", (selected ?? []).some((key) => String(key) === String(valueField === "id" ? row.id : row[valueField])) ? "opacity-100" : "opacity-0"),
+										className: cn("ml-auto size-4", checked ? "opacity-100" : "opacity-0"),
 										"aria-hidden": true
 									}) : jsx(IconChevronRight, { className: "ml-auto size-4 text-muted-foreground/50" })
 								})
@@ -227,17 +291,47 @@ function RelationPickerDialog({ to, open, onOpenChange, onSelect, onSelectRow, s
 				}),
 				jsxs(DialogFooter, {
 					className: "flex-row items-center justify-between gap-2 border-t px-4 py-2.5 sm:justify-between",
-					children: [jsx("div", {
-						className: "flex items-center",
-						children: create !== void 0 && jsx(RelationCreateButton, {
-							to,
-							fieldName: fieldName ?? to,
-							create,
-							seeds: createSeeds,
-							search,
-							beforeOpen: onBeforeCreate ?? noop,
-							className: "inline-flex items-center gap-1 whitespace-nowrap text-sm text-foreground hover:underline disabled:opacity-50"
-						})
+					children: [jsxs("div", {
+						className: "flex items-center gap-3",
+						children: [
+							checking && jsxs("span", {
+								role: "status",
+								className: "inline-flex items-center gap-1.5 text-sm text-muted-foreground",
+								"data-testid": `relation-picker-dialog:${to}:disabled-checking`,
+								children: [jsx(IconLoader2, {
+									className: "size-3.5 animate-spin",
+									"aria-hidden": "true"
+								}), tr("relationPicker.checking", void 0, "Checking these rows…")]
+							}),
+							checkFailed && jsxs("span", {
+								role: "alert",
+								className: "inline-flex items-center gap-2 text-sm text-destructive",
+								"data-testid": `relation-picker-dialog:${to}:disabled-failed`,
+								children: [tr("relationPicker.checkFailed", void 0, "These rows could not be checked, so none can be chosen."), jsx(Button, {
+									type: "button",
+									size: "sm",
+									variant: "outline",
+									className: "h-7",
+									onClick: () => setAttempt((n) => n + 1),
+									"data-testid": `relation-picker-dialog:${to}:disabled-retry`,
+									children: chromeT("actions.retry", { defaultValue: "Retry" })
+								})]
+							}),
+							disabledCount > 0 && disabledLabel !== void 0 && jsx("span", {
+								className: "text-sm text-muted-foreground",
+								"data-testid": `relation-picker-dialog:${to}:disabled-count`,
+								children: disabledLabel(disabledCount)
+							}),
+							create !== void 0 && jsx(RelationCreateButton, {
+								to,
+								fieldName: fieldName ?? to,
+								create,
+								seeds: createSeeds,
+								search,
+								beforeOpen: onBeforeCreate ?? noop,
+								className: "inline-flex items-center gap-1 whitespace-nowrap text-sm text-foreground hover:underline disabled:opacity-50"
+							})
+						]
 					}), jsxs("div", {
 						className: "flex items-center gap-2 text-sm text-muted-foreground",
 						children: [
@@ -283,6 +377,10 @@ function RelationPickerDialog({ to, open, onOpenChange, onSelect, onSelectRow, s
 		})
 	});
 }
+function SortIcon({ field, sort }) {
+	if (sort.field !== field) return jsx(IconSelector, { className: "ml-1 inline size-3 opacity-40" });
+	return sort.dir === "asc" ? jsx(IconArrowUp, { className: "ml-1 inline size-3" }) : jsx(IconArrowDown, { className: "ml-1 inline size-3" });
+}
 function formatCell(value, field, enumOf) {
 	if (value == null || value === "") return "—";
 	if (typeof value === "boolean") return value ? "✓" : "—";
@@ -300,4 +398,4 @@ function formatCell(value, field, enumOf) {
 //#endregion
 export { RelationPickerDialog };
 
-//# sourceMappingURL=relation-picker-dialog-B6nIiJBf.js.map
+//# sourceMappingURL=relation-picker-dialog-DoEY8EkH.js.map

package/dist/relation-picker-dialog-DoEY8EkH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-picker-dialog-DoEY8EkH.js","names":[],"sources":["../src/fields/relation-picker-dialog.tsx"],"sourcesContent":["'use client';\nimport * as React from 'react';\nimport {\n  IconArrowDown,\n  IconArrowUp,\n  IconCheck,\n  IconChevronRight,\n  IconSelector,\n  IconLoader2,\n  IconSearch,\n} from '@tabler/icons-react';\nimport {\n  type FixedFilterInput,\n  type DtoSource,\n  type ScopeSource,\n  declaredField,\n  declaredText,\n  enumNamespaceOf,\n  enumValueText,\n  fieldOptionText,\n  resolveFieldLabel,\n  resolveResourceLabel,\n  routeResourceKey,\n  type ResourceNameOrRef,\n  columnName,\n} from '@burojs/core';\nimport {\n  recordKeyOf,\n  useApp,\n  useChromeT,\n  useI18nCaps,\n  useList,\n  useListAccess,\n  useOptionalT,\n} from '@burojs/react';\nimport { useRowTitle } from '../resource/use-row-title.js';\nimport { ResolvedFieldDisplay } from './resolved-field.js';\nimport { cn } from '../lib/cn.js';\nimport { Button } from '../primitives/button.js';\nimport {\n  Dialog,\n  DialogContent,\n  DialogDescription,\n  DialogFooter,\n  DialogHeader,\n  DialogTitle,\n} from '../primitives/dialog.js';\nimport { Input } from '../primitives/input.js';\nimport {\n  Table,\n  TableBody,\n  TableCell,\n  TableHead,\n  TableHeader,\n  TableRow,\n} from '../primitives/table.js';\nimport { FilterBuilder } from '../list-kit/filter-builder/filter-builder.js';\nimport { useDialogFilterState } from './use-dialog-filter-state.js';\nimport { RelationCreateButton, type SelectCreate } from './relation-create.js';\n\nconst noop = (): void => undefined;\n\n/**\n * Advanced-search modal for the relation picker (#11 / #9). The inline popover\n * handles the quick \"type a few letters\" case; this dialog is the escalation:\n * the full target list with SEARCH, per-column FILTERS, SORTING and PAGINATION,\n * plus a \"Create\" shortcut. Resolved generically from the registry so it works\n * for any resource with no per-field wiring.\n *\n * #9 — compact, and the table area is a FIXED height so paging never resizes /\n * jumps the dialog; responsive down to mobile.\n */\nexport interface RelationPickerDialogProps<N extends string = string> {\n  to: ResourceNameOrRef<N>;\n  open: boolean;\n  onOpenChange: (open: boolean) => void;\n  onSelect: (value: string | number) => void;\n  /** Optional: receives the FULL chosen row (for prefilling sibling fields). */\n  onSelectRow?: (row: Record<string, unknown>) => void;\n  /**\n   * Fallback search field — an OVERRIDE, not a required prop. The search box\n   * expands through `useDialogFilterState`, which resolves what to search in\n   * this order:\n   *   1. the TARGET resource's own `views.list.search` declaration, if any —\n   *      always wins, regardless of this prop;\n   *   2. this `searchField` prop, when the target declares no search;\n   *   3. the target's `displayField` (itself falling back to `'name'`), when\n   *      neither of the above is available.\n   *\n   * A resolver-shaped `SearchDecl` has no single field that could be named\n   * here, and a target with no search declaration at all should still be\n   * searchable somehow — hence the two-step fallback instead of requiring\n   * this prop outright.\n   */\n  searchField?: string;\n  /**\n   * Which field of the chosen row `onSelect` returns. Defaults to the target's id\n   * field (`data.idField`, else `id`: a normal FK relation). Set to another column (e.g. `gtin`) for \"relate by a non-id\n   * value\" pickers — the core mechanic behind the playground GTIN field.\n   */\n  valueField?: string;\n  /**\n   * Optional extra filters ANDed into every query (e.g. scope by product\n   * group) — the same `FixedFilterInput` shape `useResourceList` and\n   * `RelationPickerProps.fixedFilters` take: a bare AST expression\n   * (`@burojs/core`'s `FilterExpression`, defaulting to `lock: true`, no\n   * badge), or `{ filter, lock?, label? }` for finer control. `lock: false`\n   * leaves the field open in the builder instead of hiding it; `label`\n   * renders it as an undeletable badge.\n   */\n  fixedFilters?: readonly FixedFilterInput[];\n  /**\n   * The read scope of the dialog's list, as the select's own option reads take it. Default\n   * `'context'`: the record around the select narrows the rows.\n   */\n  scope?: ScopeSource;\n  /**\n   * The record field the select writes (`useList`'s `scopeField`): the record's value of it never\n   * narrows the rows offered for it. Absent: every field of the record narrows.\n   */\n  scopeField?: string;\n  /**\n   * The select's one pending create (P6-34), shared with its popover. With it the footer offers\n   * \"+ Create\" (the target's `quick.create`, handed back through the select's own query); without\n   * it the dialog offers none. The dialog is not a dismiss scope and holds no form: the sheet a\n   * create opens stacks above it.\n   */\n  create?: SelectCreate;\n  /** The trusted `defaults` of that create: the registry field's static `eq` literals (P6-31). */\n  createSeeds?: Readonly<Record<string, unknown>>;\n  /** The form field holding the key (the create button's test id). */\n  fieldName?: string;\n  /** Runs before a create opens: the select returns focus to its trigger. */\n  onBeforeCreate?: () => void;\n  pageSize?: number;\n  /**\n   * A to-many select's choice (P7 3.5): a click toggles the row in `selected` through `onToggle`\n   * and the dialog stays open until the user is done. Without it, a click picks one row and closes.\n   */\n  multiple?: boolean;\n  /** The keys already chosen (`multiple` only): their rows are marked. */\n  selected?: readonly (string | number)[];\n  /** A row toggled in `multiple` mode: its value, and the row itself. */\n  onToggle?: (value: string | number, row: Record<string, unknown>) => void;\n  /**\n   * `multiple` only: the Select button confirms the choice through this instead of closing the\n   * dialog with `onOpenChange(false)`, so a confirm and a dismissal can be told apart.\n   */\n  onDone?: () => void;\n  /**\n   * Asked once per shown page with the keys of its rows: rows whose key is in the resolved set\n   * are drawn checked and disabled (a link panel's already-linked targets). Until it answers the\n   * page's rows cannot be picked and the footer says the rows are being checked; when it fails\n   * none of them can, and the footer says so with a Retry.\n   */\n  disabledKeys?: (\n    keys: readonly (string | number)[],\n    signal: AbortSignal,\n  ) => Promise<ReadonlySet<string>>;\n  /**\n   * With `disabledKeys`: the footer's note for the page's disabled rows, given how many there\n   * are (the caller says what they are, \"3 already linked\"). Absent: no note.\n   */\n  disabledLabel?: (count: number) => React.ReactNode;\n}\n\nconst DEBOUNCE_MS = 250;\n\n/** The disabled rows of a page: the keys asked (and the attempt), and the answer. */\ninterface DisabledState {\n  readonly asked: string;\n  readonly attempt: number;\n  readonly keys: ReadonlySet<string> | 'failed';\n}\n\ntype EnumOption = { value: string; label: string };\n\nexport function RelationPickerDialog<const N extends string = string>({\n  to: toInput,\n  open,\n  onOpenChange,\n  onSelect,\n  onSelectRow,\n  searchField,\n  valueField: valueFieldProp,\n  fixedFilters,\n  scope = 'context',\n  scopeField,\n  create,\n  createSeeds,\n  fieldName,\n  onBeforeCreate,\n  pageSize = 8,\n  multiple = false,\n  selected,\n  onToggle,\n  onDone,\n  disabledKeys,\n  disabledLabel,\n}: RelationPickerDialogProps<N>): React.ReactElement {\n  const to = routeResourceKey(toInput);\n  const app = useApp();\n  const caps = useI18nCaps();\n  // The target's own caps: a column header reads `resources.<to>.fields.<f>.label` first.\n  const targetCaps = useI18nCaps(to);\n  const t = useOptionalT();\n  const chromeT = useChromeT();\n  const tr = (key: string, params?: Record<string, unknown>, fallback?: string) =>\n    t?.(key, { params, defaultValue: fallback }) ?? fallback ?? key;\n  const targetDef = app.registry.get(to);\n  const rowTitle = useRowTitle(to, targetDef?.displayField);\n  const declaredIdField = (targetDef?.data as { readonly idField?: unknown } | undefined)?.idField;\n  const idField =\n    typeof declaredIdField === 'string' && declaredIdField.length > 0 ? declaredIdField : 'id';\n  const valueField = valueFieldProp ?? idField;\n\n  const [search, setSearchInput] = React.useState('');\n  const [debounced, setDebounced] = React.useState('');\n  const [sort, setSort] = React.useState<{ field: string; dir: 'asc' | 'desc' }>({\n    field: 'id',\n    dir: 'desc',\n  });\n\n  const displayField = targetDef?.displayField ?? 'name';\n\n  // Resolution order (see `RelationPickerDialogProps.searchField`'s doc):\n  // the target's own `views.list.search` declaration always wins inside\n  // `useDialogFilterState`; this `searchField` prop is only consulted THERE\n  // when the target declares no search at all, and `displayField` is what\n  // this dialog hands the hook when the caller didn't override either — so\n  // a target with no declaration and no override is still searchable.\n  //\n  // `enabled: open` — `RelationPickerDialog` is always mounted by\n  // `<RelationPicker>` (it's a controlled dialog, not conditionally\n  // rendered), so without this gate the field-derivation walk inside\n  // `useFilterFields` (`categorizeField` over every field of the target)\n  // would run on every mount and every `fixedFilters`-identity change of\n  // EVERY relation field on a form, whether its dialog ever opens or not.\n  // Gating recomputes in full the moment `open` flips true — same render,\n  // before the dialog shows anything, so nothing it displays changes.\n  const filterState = useDialogFilterState(to, {\n    fixedFilters,\n    searchField: searchField ?? displayField,\n    enabled: open,\n  });\n\n  React.useEffect(() => {\n    const h = setTimeout(() => setDebounced(search), DEBOUNCE_MS);\n    return () => clearTimeout(h);\n  }, [search]);\n\n  // The debounced text is the one thing this dialog composes itself — the\n  // rest of the filter (fixed scope, the builder's group, and the actual\n  // `fixed → search → group` composition) all live in `useDialogFilterState`\n  // now, via the SAME `composeListFilter` core the list page uses.\n  React.useEffect(() => {\n    filterState.setSearch(debounced);\n    // `filterState.setSearch` is stable (useCallback, empty deps) — only\n    // `debounced` driving this is real; including the whole `filterState`\n    // object would refire on every recompute of its OWN memo (its `filter`\n    // depends on this very effect's result), which is not what \"debounced\n    // changed\" means.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [debounced]);\n\n  // Reset volatile state each time the dialog opens.\n  React.useEffect(() => {\n    if (open) {\n      setSearchInput('');\n      setDebounced('');\n      filterState.reset();\n    }\n    // `filterState.reset` is stable (useCallback, empty deps); `filterState`\n    // itself is excluded for the same reason as the effect above.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [open]);\n\n  const listAccess = useListAccess(to);\n  const extraColumns = React.useMemo(() => {\n    const declared = (targetDef?.views?.list?.columns ?? []).map(columnName);\n    // The same predicate as the list table: a pending decision shows no extra column.\n    return declared\n      .filter((c) => c !== 'id' && c !== displayField)\n      .filter((c) => listAccess.status === 'ready' && listAccess.columnVisible(c))\n      .slice(0, 2);\n  }, [targetDef, displayField, listAccess]);\n  const titleSortable = listAccess.status === 'ready' && listAccess.fieldVisible(displayField);\n  // A sort on a field the user may not view is an ordering oracle: it is dropped, never sent.\n  const effectiveSortField =\n    sort.field === 'id' ||\n    (sort.field === displayField ? titleSortable : extraColumns.includes(sort.field))\n      ? sort.field\n      : 'id';\n\n  const query = useList(to, {\n    ...(filterState.filter ? { filter: filterState.filter } : {}),\n    sort: [\n      {\n        field: effectiveSortField,\n        direction: effectiveSortField === sort.field ? sort.dir : 'desc',\n      },\n    ],\n    pagination: { kind: 'offset', page: filterState.page, pageSize },\n    scope,\n    ...(scopeField === undefined ? {} : { scopeField }),\n    enabled: open && targetDef != null && !filterState.blocked,\n  });\n\n  const rows = (query.data?.data ?? []) as Array<{ id: unknown } & Record<string, unknown>>;\n  // Unknown-total contract: a provider that cannot count omits `total` (Hasura\n  // `noAggregate` targets such as `users` / `code_code`). Deriving `totalPages`\n  // from a `?? 0` fallback pinned it to 1 and disabled Next forever. With an\n  // unknown total we page forward while the page is full.\n  const total = query.data?.total;\n  const knownTotal = typeof total === 'number';\n  const totalPages = knownTotal ? Math.max(1, Math.ceil(total / pageSize)) : undefined;\n  const pageIsFull = rows.length >= pageSize;\n  const hasNextPage = knownTotal ? filterState.page < (totalPages as number) : pageIsFull;\n  const isLoading = query.isLoading || query.isFetching;\n\n  // The key a row is chosen, selected and disabled by: the target's idField unless a value field\n  // names another column.\n  const keyOf = (row: Record<string, unknown>): unknown =>\n    valueField === idField ? recordKeyOf(targetDef, row) : row[valueField];\n  // The page's keys, asked of `disabledKeys` once per distinct set.\n  const pageKeys = rows\n    .map(keyOf)\n    .filter((key): key is string | number => typeof key === 'string' || typeof key === 'number');\n  const asked = JSON.stringify(pageKeys);\n  const [disabled, setDisabled] = React.useState<DisabledState | undefined>(undefined);\n  // A Retry after a failed answer asks the same keys again.\n  const [attempt, setAttempt] = React.useState(0);\n  // biome-ignore lint/correctness/useExhaustiveDependencies: keyed by the page's keys, not the rows' identity\n  React.useEffect(() => {\n    if (disabledKeys === undefined || pageKeys.length === 0) return;\n    const controller = new AbortController();\n    disabledKeys(pageKeys, controller.signal).then(\n      (keys) => {\n        if (!controller.signal.aborted) setDisabled({ asked, attempt, keys });\n      },\n      () => {\n        // Fails closed: a row that may already be linked is never offered.\n        if (!controller.signal.aborted) setDisabled({ asked, attempt, keys: 'failed' });\n      },\n    );\n    return () => controller.abort();\n  }, [asked, attempt, disabledKeys]);\n  // The answer for the page shown now; undefined while it is being asked.\n  const answer =\n    disabledKeys === undefined ||\n    pageKeys.length === 0 ||\n    disabled === undefined ||\n    disabled.asked !== asked ||\n    disabled.attempt !== attempt\n      ? undefined\n      : disabled.keys;\n  const checking = disabledKeys !== undefined && pageKeys.length > 0 && answer === undefined;\n  const checkFailed = answer === 'failed';\n  const isDisabled = (row: Record<string, unknown>): boolean => {\n    if (disabledKeys === undefined) return false;\n    if (answer === undefined || answer === 'failed') return true;\n    return answer.has(String(keyOf(row)));\n  };\n  const disabledCount =\n    answer === undefined || answer === 'failed' ? 0 : rows.filter(isDisabled).length;\n\n  const toggleSort = (field: string) => {\n    setSort((prev) =>\n      prev.field === field\n        ? { field, dir: prev.dir === 'asc' ? 'desc' : 'asc' }\n        : { field, dir: 'asc' },\n    );\n  };\n\n  const targetLabel = resolveResourceLabel(caps, to, 'single', targetDef);\n  const colCount = 2 + extraColumns.length;\n\n  const pick = (row: { id: unknown } & Record<string, unknown>) => {\n    if (isDisabled(row)) return;\n    const picked = keyOf(row);\n    // A row without the value the field stores is never written as its id instead (spec 4.2).\n    if (picked === null || picked === undefined || picked === '') return;\n    if (multiple) {\n      onToggle?.(picked as string | number, row as Record<string, unknown>);\n      return;\n    }\n    onSelect(picked as string | number);\n    onSelectRow?.(row as Record<string, unknown>);\n    onOpenChange(false);\n  };\n\n  return (\n    <Dialog open={open} onOpenChange={onOpenChange} modal={create?.pending !== true}>\n      <DialogContent\n        // While a create of this select is open its sheet stacks above this dialog and stays\n        // interactive: the dialog neither traps focus nor closes on a click outside, and Escape\n        // closes only the sheet (P6-67).\n        {...(create?.pending === true\n          ? {\n              onInteractOutside: (event: Event) => event.preventDefault(),\n              onEscapeKeyDown: (event: KeyboardEvent) => event.preventDefault(),\n            }\n          : {})}\n        className=\"flex max-h-[85vh] w-[calc(100vw-1.5rem)] max-w-3xl flex-col gap-0 overflow-hidden p-0\"\n        data-testid={`relation-picker-dialog:${to}`}\n      >\n        <DialogHeader className=\"border-b px-4 py-3\">\n          <DialogTitle className=\"text-base\">\n            {tr('relationPicker.title', { name: targetLabel }, `Select: ${targetLabel}`)}\n          </DialogTitle>\n          <DialogDescription className=\"sr-only\">\n            {tr('relationPicker.advancedSearch', undefined, 'Advanced search')}\n          </DialogDescription>\n        </DialogHeader>\n\n        {/* Search + the filter builder (#9 / Task 5 SP3) */}\n        <div className=\"flex flex-wrap items-center gap-2 border-b px-4 py-2.5\">\n          {filterState.searchEnabled && (\n            <div className=\"relative min-w-[12rem] flex-1\">\n              <IconSearch className=\"pointer-events-none absolute left-2.5 top-2.5 size-4 text-muted-foreground\" />\n              <Input\n                autoFocus\n                value={search}\n                onChange={(e) => setSearchInput(e.target.value)}\n                placeholder={tr('toolbar.search', { name: targetLabel }, `Search ${targetLabel}…`)}\n                data-testid={`relation-picker-dialog:${to}:search`}\n                className=\"h-9 pl-8\"\n              />\n            </div>\n          )}\n          {/*\n            No `pinnedFields`/`pinnedValue`/`setPinnedValue` — this dialog has\n            no pinned slot (`useDialogFilterState`'s doc: a modal has no\n            spare real estate for always-visible facets), so `FilterBuilder`\n            falls back to its own stable empty-array defaults.\n          */}\n          <FilterBuilder\n            group={filterState.group}\n            setGroup={filterState.setGroup}\n            available={filterState.available}\n            fixed={filterState.fixed}\n            setPage={filterState.setPage}\n            testIdBase={`relation-picker-dialog:${to}:filter`}\n          />\n        </div>\n\n        {/* Fixed-height table area — constant height so paging never jumps. */}\n        <div className=\"h-[46vh] min-h-[16rem] overflow-auto\">\n          <Table>\n            <TableHeader className=\"sticky top-0 z-10 bg-background shadow-[inset_0_-1px_0_var(--border)]\">\n              <TableRow className=\"hover:bg-transparent\">\n                <TableHead\n                  className=\"h-9 w-14 cursor-pointer select-none\"\n                  onClick={() => toggleSort('id')}\n                >\n                  {tr('relationPicker.idColumn', undefined, 'ID')}{' '}\n                  <SortIcon field=\"id\" sort={sort} />\n                </TableHead>\n                <TableHead\n                  className={cn('h-9 select-none', titleSortable && 'cursor-pointer')}\n                  {...(titleSortable ? { onClick: () => toggleSort(displayField) } : {})}\n                >\n                  {targetLabel} {titleSortable && <SortIcon field={displayField} sort={sort} />}\n                </TableHead>\n                {extraColumns.map((c) => (\n                  <TableHead\n                    key={c}\n                    className=\"h-9 cursor-pointer select-none\"\n                    onClick={() => toggleSort(c)}\n                  >\n                    {resolveFieldLabel(\n                      targetCaps,\n                      c,\n                      declaredText('field', targetDef?.fields?.[c], 'label'),\n                    )}\n                    <SortIcon field={c} sort={sort} />\n                  </TableHead>\n                ))}\n                <TableHead className=\"h-9 w-8\" />\n              </TableRow>\n            </TableHeader>\n            <TableBody>\n              {isLoading ? (\n                <TableRow className=\"hover:bg-transparent\">\n                  <TableCell colSpan={colCount + 1} className=\"h-64 text-center\">\n                    <IconLoader2 className=\"mx-auto size-4 animate-spin text-muted-foreground\" />\n                  </TableCell>\n                </TableRow>\n              ) : rows.length === 0 ? (\n                <TableRow className=\"hover:bg-transparent\">\n                  <TableCell\n                    colSpan={colCount + 1}\n                    className=\"h-64 text-center text-sm text-muted-foreground\"\n                  >\n                    {tr('relation.noResults', undefined, 'No results.')}\n                  </TableCell>\n                </TableRow>\n              ) : (\n                rows.map((row) => {\n                  const idStr = String(recordKeyOf(targetDef, row));\n                  const rowDisabled = isDisabled(row);\n                  // A disabled row is drawn checked: it is already chosen elsewhere.\n                  const checked =\n                    rowDisabled ||\n                    (selected ?? []).some((key) => String(key) === String(keyOf(row)));\n                  return (\n                    <TableRow\n                      key={idStr}\n                      className={cn(\n                        rowDisabled ? 'cursor-not-allowed opacity-60' : 'cursor-pointer',\n                      )}\n                      data-testid={`relation-picker-dialog:${to}:row:${idStr}`}\n                      {...(multiple ? { 'aria-selected': checked } : {})}\n                      {...(rowDisabled ? { 'aria-disabled': true } : {})}\n                      onClick={() => pick(row)}\n                    >\n                      <TableCell className=\"py-2 tabular-nums text-muted-foreground\">\n                        {tr('relationPicker.recordNumber', { id: idStr }, `#${idStr}`)}\n                      </TableCell>\n                      <TableCell className=\"py-2 font-medium\">{rowTitle(row)}</TableCell>\n                      {extraColumns.map((c) => (\n                        <TableCell key={c} className=\"py-2 text-muted-foreground\">\n                          {/* The list's display renderers: locale numbers and dates, enum labels. */}\n                          <ResolvedFieldDisplay\n                            resource={targetDef?.ref ?? { namespace: 'default', id: to }}\n                            name={c}\n                            field={\n                              (targetDef === undefined\n                                ? undefined\n                                : declaredField(targetDef as unknown as DtoSource, c)) ??\n                              (targetDef?.fields?.[c] as never) ?? { type: 'unknown' }\n                            }\n                            value={row[c]}\n                            record={row}\n                            fallback={formatCell(row[c], targetDef?.fields?.[c], (ns) =>\n                              app.registry.enums.get(ns),\n                            )}\n                          />\n                        </TableCell>\n                      ))}\n                      <TableCell className=\"py-2 text-right\">\n                        {multiple ? (\n                          <IconCheck\n                            className={cn('ml-auto size-4', checked ? 'opacity-100' : 'opacity-0')}\n                            aria-hidden\n                          />\n                        ) : (\n                          <IconChevronRight className=\"ml-auto size-4 text-muted-foreground/50\" />\n                        )}\n                      </TableCell>\n                    </TableRow>\n                  );\n                })\n              )}\n            </TableBody>\n          </Table>\n        </div>\n\n        <DialogFooter className=\"flex-row items-center justify-between gap-2 border-t px-4 py-2.5 sm:justify-between\">\n          {/*\n            A wrapper that is always there: the footer is `justify-between`, so dropping its first\n            child (no create offered) would slide the pager to the left edge.\n          */}\n          <div className=\"flex items-center gap-3\">\n            {checking && (\n              <span\n                role=\"status\"\n                className=\"inline-flex items-center gap-1.5 text-sm text-muted-foreground\"\n                data-testid={`relation-picker-dialog:${to}:disabled-checking`}\n              >\n                <IconLoader2 className=\"size-3.5 animate-spin\" aria-hidden=\"true\" />\n                {tr('relationPicker.checking', undefined, 'Checking these rows…')}\n              </span>\n            )}\n            {checkFailed && (\n              <span\n                role=\"alert\"\n                className=\"inline-flex items-center gap-2 text-sm text-destructive\"\n                data-testid={`relation-picker-dialog:${to}:disabled-failed`}\n              >\n                {tr(\n                  'relationPicker.checkFailed',\n                  undefined,\n                  'These rows could not be checked, so none can be chosen.',\n                )}\n                <Button\n                  type=\"button\"\n                  size=\"sm\"\n                  variant=\"outline\"\n                  className=\"h-7\"\n                  onClick={() => setAttempt((n) => n + 1)}\n                  data-testid={`relation-picker-dialog:${to}:disabled-retry`}\n                >\n                  {chromeT('actions.retry', { defaultValue: 'Retry' })}\n                </Button>\n              </span>\n            )}\n            {disabledCount > 0 && disabledLabel !== undefined && (\n              <span\n                className=\"text-sm text-muted-foreground\"\n                data-testid={`relation-picker-dialog:${to}:disabled-count`}\n              >\n                {disabledLabel(disabledCount)}\n              </span>\n            )}\n            {create !== undefined && (\n              <RelationCreateButton\n                to={to}\n                fieldName={fieldName ?? to}\n                create={create}\n                seeds={createSeeds}\n                search={search}\n                beforeOpen={onBeforeCreate ?? noop}\n                className=\"inline-flex items-center gap-1 whitespace-nowrap text-sm text-foreground hover:underline disabled:opacity-50\"\n              />\n            )}\n          </div>\n          <div className=\"flex items-center gap-2 text-sm text-muted-foreground\">\n            <span className=\"hidden tabular-nums sm:inline\">\n              {knownTotal\n                ? tr(\n                    'pagination.pageOf',\n                    { page: filterState.page, total: totalPages },\n                    `${filterState.page} / ${totalPages}`,\n                  )\n                : tr('pagination.pageOnly', { page: filterState.page }, `${filterState.page}`)}\n            </span>\n            <Button\n              type=\"button\"\n              size=\"sm\"\n              variant=\"outline\"\n              className=\"h-8\"\n              disabled={filterState.page <= 1}\n              onClick={() => filterState.setPage(Math.max(1, filterState.page - 1))}\n              data-testid={`relation-picker-dialog:${to}:prev`}\n            >\n              {tr('relationPicker.prev', undefined, 'Prev')}\n            </Button>\n            <Button\n              type=\"button\"\n              size=\"sm\"\n              variant=\"outline\"\n              className=\"h-8\"\n              disabled={!hasNextPage}\n              onClick={() => filterState.setPage(filterState.page + 1)}\n              data-testid={`relation-picker-dialog:${to}:next`}\n            >\n              {tr('relationPicker.next', undefined, 'Next')}\n            </Button>\n            {multiple && (\n              <Button\n                type=\"button\"\n                size=\"sm\"\n                className=\"h-8\"\n                onClick={() => (onDone === undefined ? onOpenChange(false) : onDone())}\n                data-testid={`relation-picker-dialog:${to}:done`}\n              >\n                {tr('relationPicker.select', undefined, 'Select')}\n              </Button>\n            )}\n          </div>\n        </DialogFooter>\n      </DialogContent>\n    </Dialog>\n  );\n}\n\n/**\n * A column's sort arrow. Declared here, not inside the dialog: a component made in a render is a\n * new type on every render, so React replaced these icons each time the dialog rendered — and a\n * node removed from the dialog while focus was crossing into the filter popover (which is portaled\n * outside it, so focus sits on `body` for that moment) makes the dialog's focus scope take focus\n * back, which closed the popover on any click inside it.\n */\nfunction SortIcon({\n  field,\n  sort,\n}: {\n  readonly field: string;\n  readonly sort: { readonly field: string; readonly dir: 'asc' | 'desc' };\n}): React.ReactElement {\n  if (sort.field !== field) return <IconSelector className=\"ml-1 inline size-3 opacity-40\" />;\n  return sort.dir === 'asc' ? (\n    <IconArrowUp className=\"ml-1 inline size-3\" />\n  ) : (\n    <IconArrowDown className=\"ml-1 inline size-3\" />\n  );\n}\n\nfunction formatCell(\n  value: unknown,\n  field: unknown,\n  enumOf: (namespace: string) => Parameters<typeof enumValueText>[0],\n): string {\n  if (value == null || value === '') return '—';\n  if (typeof value === 'boolean') return value ? '✓' : '—';\n  // Map an option value → its human label: the field's `texts.options`, the bound enum's\n  // `texts`, else a label the field's `meta.options` carries (adopter data).\n  const namespace =\n    field !== null && typeof field === 'object'\n      ? enumNamespaceOf(field as Parameters<typeof enumNamespaceOf>[0])\n      : undefined;\n  const declared =\n    fieldOptionText(field, String(value)) ??\n    (namespace === undefined ? undefined : enumValueText(enumOf(namespace), String(value)));\n  if (declared !== undefined) return declared;\n  const options = (field as { meta?: { options?: EnumOption[] } } | undefined)?.meta?.options;\n  if (Array.isArray(options)) {\n    const hit = options.find((o) => o.value === String(value));\n    if (hit && typeof hit.label === 'string') return hit.label;\n  }\n  const s = String(value);\n  return s.length > 40 ? `${s.slice(0, 40)}…` : s;\n}\n"],"mappings":"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"}

package/dist/relation-select-B8Fq4o-t.js

@@ -0,0 +1,48 @@
+import { n as useSelectCreate, o as narrowSearchDecl } from "./relation-create-C43cdPQt.js";
+import { useApp, useListAccess } from "@burojs/react";
+import * as React from "react";
+//#region src/fields/relation-select.ts
+function useRelationSelect(input) {
+	const { to, by, searchField, fixedFilters, scope, scopeField, held, onValue } = input;
+	const app = useApp();
+	const targetDef = to === "" ? void 0 : app.registry.get(to);
+	const targetIdField = (targetDef?.data)?.idField;
+	const idField = typeof targetIdField === "string" && targetIdField.length > 0 ? targetIdField : "id";
+	const valueField = by ?? idField;
+	const effectiveSearchField = searchField ?? targetDef?.displayField ?? "name";
+	const access = useListAccess(to);
+	const searchDecl = React.useMemo(() => narrowSearchDecl(targetDef?.views?.list?.search ?? { fields: [effectiveSearchField] }, (name) => access.fieldVisible(name)), [
+		targetDef,
+		effectiveSearchField,
+		access
+	]);
+	const { create, reader } = useSelectCreate({
+		to,
+		by,
+		valueField,
+		idField,
+		fixedFilters,
+		scope,
+		...scopeField === void 0 ? {} : { scopeField },
+		held,
+		searchDecl,
+		searchContext: {
+			resource: to,
+			def: targetDef
+		},
+		onValue
+	});
+	return {
+		targetDef,
+		access,
+		idField,
+		valueField,
+		searchDecl,
+		create,
+		reader
+	};
+}
+//#endregion
+export { useRelationSelect as t };
+
+//# sourceMappingURL=relation-select-B8Fq4o-t.js.map

package/dist/relation-select-B8Fq4o-t.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-select-B8Fq4o-t.js","names":[],"sources":["../src/fields/relation-select.ts"],"sourcesContent":["'use client';\n\nimport type { FixedFilterInput, ScopeSource, SearchDecl } from '@burojs/core';\nimport { useApp, useListAccess } from '@burojs/react';\nimport * as React from 'react';\nimport { type SelectCreate, useSelectCreate } from './relation-create.js';\nimport { narrowSearchDecl } from './search-access.js';\n\n/**\n * What a relation select needs to read its target and hand back a created record: the shared\n * wiring of `RelationPicker` and `useRelationPicker` (one place decides the value field, the\n * search declaration and the select's one pending create).\n */\nexport interface RelationSelectInput {\n  readonly to: string;\n  /** The target field the value holds; absent: the target's id field. */\n  readonly by: string | undefined;\n  /** The fallback search field when the target declares no `views.list.search`. */\n  readonly searchField?: string | undefined;\n  /** Every filter the option reads carry (candidate filters included). */\n  readonly fixedFilters: readonly FixedFilterInput[] | undefined;\n  readonly scope: ScopeSource;\n  /** The record field the select writes (`useList`'s `scopeField`). */\n  readonly scopeField?: string | undefined;\n  /** The candidates gate is not ready: no create starts and no hand-back reads. */\n  readonly held: boolean;\n  /** Called with the value of a created record that came back through the option query. */\n  readonly onValue: (value: string | number) => void;\n}\n\nexport interface RelationSelect {\n  readonly targetDef: ReturnType<ReturnType<typeof useApp>['registry']['get']>;\n  readonly access: ReturnType<typeof useListAccess>;\n  /** The target's id field (`data.idField`, else `id`). */\n  readonly idField: string;\n  /** The row field an option writes and is compared on: `by`, else the id field. */\n  readonly valueField: string;\n  /** The search set, without the fields the user may not view; undefined: no search. */\n  readonly searchDecl: SearchDecl | undefined;\n  readonly create: SelectCreate;\n  /** Mount it inside the select's read scope while a created record is handed back. */\n  readonly reader: React.ReactNode;\n}\n\n/** The shared wiring of a relation select (see {@link RelationSelectInput}). */\nexport function useRelationSelect(input: RelationSelectInput): RelationSelect {\n  const { to, by, searchField, fixedFilters, scope, scopeField, held, onValue } = input;\n  const app = useApp();\n  // An unresolved target (`''`: the picker hook's field that names no relation) is unregistered.\n  const targetDef = to === '' ? undefined : app.registry.get(to);\n  const targetIdField = (targetDef?.data as { readonly idField?: unknown } | undefined)?.idField;\n  const idField =\n    typeof targetIdField === 'string' && targetIdField.length > 0 ? targetIdField : 'id';\n  const valueField = by ?? idField;\n  // Search resolution: the target's declared `views.list.search` wins; else `searchField`, else\n  // the target's `displayField`, else `'name'` — narrowed to the fields the user may view.\n  const effectiveSearchField = searchField ?? targetDef?.displayField ?? 'name';\n  const access = useListAccess(to);\n  const searchDecl = React.useMemo<SearchDecl | undefined>(\n    () =>\n      narrowSearchDecl(\n        targetDef?.views?.list?.search ?? { fields: [effectiveSearchField] },\n        (name) => access.fieldVisible(name),\n      ),\n    [targetDef, effectiveSearchField, access],\n  );\n  const { create, reader } = useSelectCreate({\n    to,\n    by,\n    valueField,\n    idField,\n    fixedFilters,\n    scope,\n    ...(scopeField === undefined ? {} : { scopeField }),\n    held,\n    searchDecl,\n    searchContext: { resource: to, def: targetDef },\n    onValue,\n  });\n  return { targetDef, access, idField, valueField, searchDecl, create, reader };\n}\n"],"mappings":";;;;AA6CA,SAAgB,kBAAkB,OAA4C;CAC5E,MAAM,EAAE,IAAI,IAAI,aAAa,cAAc,OAAO,YAAY,MAAM,YAAY;CAChF,MAAM,MAAM,OAAO;CAEnB,MAAM,YAAY,OAAO,KAAK,KAAA,IAAY,IAAI,SAAS,IAAI,EAAE;CAC7D,MAAM,iBAAiB,WAAW,KAAA,EAAqD;CACvF,MAAM,UACJ,OAAO,kBAAkB,YAAY,cAAc,SAAS,IAAI,gBAAgB;CAClF,MAAM,aAAa,MAAM;CAGzB,MAAM,uBAAuB,eAAe,WAAW,gBAAgB;CACvE,MAAM,SAAS,cAAc,EAAE;CAC/B,MAAM,aAAa,MAAM,cAErB,iBACE,WAAW,OAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,oBAAoB,EAAE,IAClE,SAAS,OAAO,aAAa,IAAI,CACpC,GACF;EAAC;EAAW;EAAsB;CAAM,CAC1C;CACA,MAAM,EAAE,QAAQ,WAAW,gBAAgB;EACzC;EACA;EACA;EACA;EACA;EACA;EACA,GAAI,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,WAAW;EACjD;EACA;EACA,eAAe;GAAE,UAAU;GAAI,KAAK;EAAU;EAC9C;CACF,CAAC;CACD,OAAO;EAAE;EAAW;EAAQ;EAAS;EAAY;EAAY;EAAQ;CAAO;AAC9E"}

package/dist/relation-select-Cr3CfNLy.cjs

@@ -0,0 +1,55 @@
+const require_use_theme = require("./use-theme-DFlpXils.cjs");
+const require_relation_create = require("./relation-create-DDEYcKfw.cjs");
+let _burojs_react = require("@burojs/react");
+let react = require("react");
+react = require_use_theme.__toESM(react, 1);
+//#region src/fields/relation-select.ts
+function useRelationSelect(input) {
+	const { to, by, searchField, fixedFilters, scope, scopeField, held, onValue } = input;
+	const app = (0, _burojs_react.useApp)();
+	const targetDef = to === "" ? void 0 : app.registry.get(to);
+	const targetIdField = (targetDef?.data)?.idField;
+	const idField = typeof targetIdField === "string" && targetIdField.length > 0 ? targetIdField : "id";
+	const valueField = by ?? idField;
+	const effectiveSearchField = searchField ?? targetDef?.displayField ?? "name";
+	const access = (0, _burojs_react.useListAccess)(to);
+	const searchDecl = react.useMemo(() => require_relation_create.narrowSearchDecl(targetDef?.views?.list?.search ?? { fields: [effectiveSearchField] }, (name) => access.fieldVisible(name)), [
+		targetDef,
+		effectiveSearchField,
+		access
+	]);
+	const { create, reader } = require_relation_create.useSelectCreate({
+		to,
+		by,
+		valueField,
+		idField,
+		fixedFilters,
+		scope,
+		...scopeField === void 0 ? {} : { scopeField },
+		held,
+		searchDecl,
+		searchContext: {
+			resource: to,
+			def: targetDef
+		},
+		onValue
+	});
+	return {
+		targetDef,
+		access,
+		idField,
+		valueField,
+		searchDecl,
+		create,
+		reader
+	};
+}
+//#endregion
+Object.defineProperty(exports, "useRelationSelect", {
+	enumerable: true,
+	get: function() {
+		return useRelationSelect;
+	}
+});
+
+//# sourceMappingURL=relation-select-Cr3CfNLy.cjs.map

package/dist/relation-select-Cr3CfNLy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-select-Cr3CfNLy.cjs","names":["useApp","useListAccess","React","narrowSearchDecl","useSelectCreate"],"sources":["../src/fields/relation-select.ts"],"sourcesContent":["'use client';\n\nimport type { FixedFilterInput, ScopeSource, SearchDecl } from '@burojs/core';\nimport { useApp, useListAccess } from '@burojs/react';\nimport * as React from 'react';\nimport { type SelectCreate, useSelectCreate } from './relation-create.js';\nimport { narrowSearchDecl } from './search-access.js';\n\n/**\n * What a relation select needs to read its target and hand back a created record: the shared\n * wiring of `RelationPicker` and `useRelationPicker` (one place decides the value field, the\n * search declaration and the select's one pending create).\n */\nexport interface RelationSelectInput {\n  readonly to: string;\n  /** The target field the value holds; absent: the target's id field. */\n  readonly by: string | undefined;\n  /** The fallback search field when the target declares no `views.list.search`. */\n  readonly searchField?: string | undefined;\n  /** Every filter the option reads carry (candidate filters included). */\n  readonly fixedFilters: readonly FixedFilterInput[] | undefined;\n  readonly scope: ScopeSource;\n  /** The record field the select writes (`useList`'s `scopeField`). */\n  readonly scopeField?: string | undefined;\n  /** The candidates gate is not ready: no create starts and no hand-back reads. */\n  readonly held: boolean;\n  /** Called with the value of a created record that came back through the option query. */\n  readonly onValue: (value: string | number) => void;\n}\n\nexport interface RelationSelect {\n  readonly targetDef: ReturnType<ReturnType<typeof useApp>['registry']['get']>;\n  readonly access: ReturnType<typeof useListAccess>;\n  /** The target's id field (`data.idField`, else `id`). */\n  readonly idField: string;\n  /** The row field an option writes and is compared on: `by`, else the id field. */\n  readonly valueField: string;\n  /** The search set, without the fields the user may not view; undefined: no search. */\n  readonly searchDecl: SearchDecl | undefined;\n  readonly create: SelectCreate;\n  /** Mount it inside the select's read scope while a created record is handed back. */\n  readonly reader: React.ReactNode;\n}\n\n/** The shared wiring of a relation select (see {@link RelationSelectInput}). */\nexport function useRelationSelect(input: RelationSelectInput): RelationSelect {\n  const { to, by, searchField, fixedFilters, scope, scopeField, held, onValue } = input;\n  const app = useApp();\n  // An unresolved target (`''`: the picker hook's field that names no relation) is unregistered.\n  const targetDef = to === '' ? undefined : app.registry.get(to);\n  const targetIdField = (targetDef?.data as { readonly idField?: unknown } | undefined)?.idField;\n  const idField =\n    typeof targetIdField === 'string' && targetIdField.length > 0 ? targetIdField : 'id';\n  const valueField = by ?? idField;\n  // Search resolution: the target's declared `views.list.search` wins; else `searchField`, else\n  // the target's `displayField`, else `'name'` — narrowed to the fields the user may view.\n  const effectiveSearchField = searchField ?? targetDef?.displayField ?? 'name';\n  const access = useListAccess(to);\n  const searchDecl = React.useMemo<SearchDecl | undefined>(\n    () =>\n      narrowSearchDecl(\n        targetDef?.views?.list?.search ?? { fields: [effectiveSearchField] },\n        (name) => access.fieldVisible(name),\n      ),\n    [targetDef, effectiveSearchField, access],\n  );\n  const { create, reader } = useSelectCreate({\n    to,\n    by,\n    valueField,\n    idField,\n    fixedFilters,\n    scope,\n    ...(scopeField === undefined ? {} : { scopeField }),\n    held,\n    searchDecl,\n    searchContext: { resource: to, def: targetDef },\n    onValue,\n  });\n  return { targetDef, access, idField, valueField, searchDecl, create, reader };\n}\n"],"mappings":";;;;;;AA6CA,SAAgB,kBAAkB,OAA4C;CAC5E,MAAM,EAAE,IAAI,IAAI,aAAa,cAAc,OAAO,YAAY,MAAM,YAAY;CAChF,MAAM,OAAA,GAAMA,cAAAA,OAAAA,CAAO;CAEnB,MAAM,YAAY,OAAO,KAAK,KAAA,IAAY,IAAI,SAAS,IAAI,EAAE;CAC7D,MAAM,iBAAiB,WAAW,KAAA,EAAqD;CACvF,MAAM,UACJ,OAAO,kBAAkB,YAAY,cAAc,SAAS,IAAI,gBAAgB;CAClF,MAAM,aAAa,MAAM;CAGzB,MAAM,uBAAuB,eAAe,WAAW,gBAAgB;CACvE,MAAM,UAAA,GAASC,cAAAA,cAAAA,CAAc,EAAE;CAC/B,MAAM,aAAaC,MAAM,cAErBC,wBAAAA,iBACE,WAAW,OAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,oBAAoB,EAAE,IAClE,SAAS,OAAO,aAAa,IAAI,CACpC,GACF;EAAC;EAAW;EAAsB;CAAM,CAC1C;CACA,MAAM,EAAE,QAAQ,WAAWC,wBAAAA,gBAAgB;EACzC;EACA;EACA;EACA;EACA;EACA;EACA,GAAI,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,WAAW;EACjD;EACA;EACA,eAAe;GAAE,UAAU;GAAI,KAAK;EAAU;EAC9C;CACF,CAAC;CACD,OAAO;EAAE;EAAW;EAAQ;EAAS;EAAY;EAAY;EAAQ;CAAO;AAC9E"}