@burojs/ui-shadcn 0.6.0 → 0.8.0

package/dist/{relation-picker-Z0ZJJ5uS.js → relation-picker-x7P5HKie.js}

@@ -1,18 +1,19 @@
 import { l as cn } from "./use-theme-dnE3Od3I.js";
-import { d as PopoverTrigger, o as useLinkComponent, s as Popover, u as PopoverContent } from "./toaster-C02XbB9r.js";
+import { l as useLinkComponent, m as PopoverTrigger, p as PopoverContent, u as Popover } from "./toaster-Ct_YHGs6.js";
 import { t as Button } from "./button-MWVeZaqj.js";
-import { _ as CommandEmpty, b as CommandItem, d as useRowTitle, h as Command, n as narrowSearchDecl, t as namesHiddenField, x as CommandList, y as CommandInput } from "./search-access-CPPmfuvy.js";
+import { C as CommandEmpty, D as CommandList, E as CommandItem, T as CommandInput, a as namesHiddenField, m as useRowTitle, r as RelationViewButton, t as RelationCreateButton, x as Command, y as LoadError } from "./relation-create-C43cdPQt.js";
 import { t as Skeleton } from "./skeleton-U2noefj5.js";
-import { r as LazyRelationPickerDialog } from "./candidates-gate-Bb70LPAy.js";
-import { n as useSelectCreate, r as RelationViewButton, t as RelationCreateButton } from "./relation-create-h6F9B4C4.js";
-import { composeListFilter, normalizeFixedFilters, relationOpenOf, resolveResourceLabel, resourceKey } from "@burojs/core";
-import { useApp, useI18nCaps, useList, useListAccess, useOptionalT, useRelatedRecord } from "@burojs/react";
+import { t as LazyRelationPickerDialog } from "./lazy-relation-picker-dialog-DN4bvQfg.js";
+import { t as useRelationSelect } from "./relation-select-B8Fq4o-t.js";
+import { r as useRowSubtitle, t as optionSubtitle } from "./use-record-subtitle-gIaCGgbI.js";
+import { composeListFilter, normalizeFixedFilters, relationOpenOf, resolveResourceLabel, resourceKey, routeResourceKey } from "@burojs/core";
+import { useApp, useI18nCaps, useList, useOptionalT, useRelatedRecord } from "@burojs/react";
 import { IconCheck, IconChevronDown, IconLoader2 } from "@tabler/icons-react";
 import * as React from "react";
 import { Suspense, lazy } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/fields/lazy-candidates-picker.tsx
-const CandidatesRelationPicker = lazy(() => import("./candidates-relation-picker-B116Bmqi.js").then((module) => ({ default: module.CandidatesRelationPicker })));
+const CandidatesRelationPicker = lazy(() => import("./candidates-relation-picker-CGXItMN0.js").then((module) => ({ default: module.CandidatesRelationPicker })));
 function LazyCandidatesRelationPicker(props) {
 	return jsx(Suspense, {
 		fallback: jsx(Skeleton, {
@@ -24,56 +25,16 @@ function LazyCandidatesRelationPicker(props) {
 	});
 }
 //#endregion
-//#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
 //#region src/fields/relation-picker.tsx
 const DEBOUNCE_MS = 250;
-function RelationPicker({ to, value, onChange, by, searchField, pageSize = 10, clearable = true, placeholder, name, id, testid, fixedFilters, createSeeds, candidatesGate, rowFits, fieldName, open: openMode, scope = "context", disabled, required, className, ariaInvalid, ariaDescribedBy, ariaErrorMessage }) {
+function RelationPicker({ to: toInput, value, onChange, by, searchField, pageSize = 10, clearable = true, placeholder, name, id, testid, fixedFilters, createSeeds, candidatesGate, rowFits, fieldName, open: openMode, optionSubtitle: optionSubtitle$1, scope = "context", disabled, required, className, ariaInvalid, ariaDescribedBy, ariaErrorMessage }) {
+	const to = routeResourceKey(toInput);
 	const app = useApp();
 	const caps = useI18nCaps();
 	const t = useOptionalT();
 	const targetDef = app.registry.get(to);
 	const rowTitle = useRowTitle(to, targetDef?.displayField);
+	const rowSubtitle = useRowSubtitle(to, optionSubtitle$1);
 	const targetLabel = resolveResourceLabel(caps, to, "single", targetDef).toLowerCase();
 	const RouterLink = useLinkComponent();
 	const tid = testid ?? `relation-picker:${to}`;
@@ -316,11 +277,15 @@ function RelationPicker({ to, value, onChange, by, searchField, pageSize = 10, c
 										"aria-hidden": true
 									}), jsx("span", { children: t("table.loading", { defaultValue: "Loading…" }) })]
 								}),
-								!isLoading && error && jsx("div", {
-									className: "px-3 py-6 text-center text-sm text-muted-foreground",
-									"data-testid": `${childPrefix}:error`,
-									title: error.message,
-									children: t("relation.failed", { defaultValue: "Failed to load options." })
+								!isLoading && error && jsx(LoadError, {
+									surface: "picker",
+									error,
+									testId: `${childPrefix}:error`,
+									className: "block px-3 py-6 text-center text-sm text-muted-foreground",
+									fallback: {
+										key: "relation.failed",
+										default: "Failed to load options."
+									}
 								}),
 								!isLoading && !error && rows.length === 0 && jsx(CommandEmpty, {
 									"data-testid": `${childPrefix}:empty`,
@@ -331,6 +296,7 @@ function RelationPicker({ to, value, onChange, by, searchField, pageSize = 10, c
 									if (rowId === null || rowId === void 0 || rowId === "") return null;
 									const idStr = String(rowId);
 									const label = rowTitle(row);
+									const subtitle = optionSubtitle(rowSubtitle(row), label, idStr);
 									const isSelected = value != null && String(value) === idStr;
 									return jsxs(CommandItem, {
 										value: `${label} ${idStr}`,
@@ -345,9 +311,9 @@ function RelationPicker({ to, value, onChange, by, searchField, pageSize = 10, c
 												className: "truncate",
 												children: label
 											}),
-											label === idStr ? null : jsxs("span", {
+											subtitle === null ? null : jsx("span", {
 												className: "ml-auto shrink-0 pl-2 text-xs text-muted-foreground",
-												children: ["#", idStr]
+												children: subtitle
 											})
 										]
 									}, idStr);
@@ -355,7 +321,7 @@ function RelationPicker({ to, value, onChange, by, searchField, pageSize = 10, c
 							]
 						}),
 						jsxs("div", {
-							className: "flex items-center justify-between gap-2 border-t px-3 py-2 text-sm",
+							className: "flex flex-wrap items-center justify-between gap-x-2 gap-y-1 border-t px-3 py-2 text-sm",
 							children: [clearable && value != null && value !== "" ? jsx("button", {
 								type: "button",
 								onClick: handleClear,
@@ -363,7 +329,7 @@ function RelationPicker({ to, value, onChange, by, searchField, pageSize = 10, c
 								className: "text-muted-foreground hover:text-foreground focus:outline-hidden focus-visible:underline",
 								children: t("relationPicker.clear", { defaultValue: "Clear" })
 							}) : jsx("span", { "aria-hidden": true }), jsxs("div", {
-								className: "flex items-center gap-3",
+								className: "flex flex-wrap items-center gap-x-3 gap-y-1",
 								children: [
 									jsx("button", {
 										type: "button",
@@ -465,6 +431,7 @@ function FieldRelationPicker({ props, to, extra }) {
 	const { name, id, value, onChange, testid, field, disabled, required, relationSeeds } = props;
 	const { ariaInvalid, ariaDescribedBy, ariaErrorMessage } = props;
 	const meta = field?.meta;
+	const subtitle = props.optionSubtitle;
 	return jsx(RelationPicker, {
 		to,
 		value,
@@ -474,12 +441,14 @@ function FieldRelationPicker({ props, to, extra }) {
 		id,
 		testid: testid ?? `relation-picker:${to}`,
 		searchField: meta?.searchField,
+		...meta?.scope === void 0 ? {} : { scope: meta.scope },
 		fixedFilters: extra === void 0 ? props.fixedFilters : extra.fixedFilters,
 		...extra?.candidatesGate === void 0 ? {} : { candidatesGate: extra.candidatesGate },
 		...extra?.rowFits === void 0 ? {} : { rowFits: extra.rowFits },
 		...relationSeeds === void 0 ? {} : { createSeeds: relationSeeds },
 		fieldName: field?.name ?? name,
 		open: relationOpenOf(field ?? {}),
+		...subtitle === void 0 ? {} : { optionSubtitle: subtitle },
 		disabled,
 		required,
 		ariaInvalid,
@@ -488,6 +457,6 @@ function FieldRelationPicker({ props, to, extra }) {
 	});
 }
 //#endregion
-export { useRelationSelect as i, RelationPicker as n, RelationPickerInput as r, FieldRelationPicker as t };
+export { RelationPicker as n, RelationPickerInput as r, FieldRelationPicker as t };
 
-//# sourceMappingURL=relation-picker-Z0ZJJ5uS.js.map
+//# sourceMappingURL=relation-picker-x7P5HKie.js.map

package/dist/relation-picker-x7P5HKie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-picker-x7P5HKie.js","names":["optionSubtitle","optionSubtitleText"],"sources":["../src/fields/lazy-candidates-picker.tsx","../src/fields/relation-picker.tsx"],"sourcesContent":["import { type ReactElement, Suspense, lazy } from 'react';\nimport type { FieldInputProps } from './registry.js';\nimport { Skeleton } from '../primitives/skeleton.js';\n\nconst CandidatesRelationPicker = lazy(() =>\n  import('./candidates-relation-picker.js').then((module) => ({\n    default: module.CandidatesRelationPicker,\n  })),\n);\n\n/**\n * A relation select whose field declares `candidates`: the candidates path is a chunk of its own,\n * so a form without candidates never loads it. Until it arrives a skeleton stands in; no read\n * is sent for the options meanwhile.\n */\nexport function LazyCandidatesRelationPicker(props: FieldInputProps): ReactElement {\n  return (\n    <Suspense\n      fallback={\n        <Skeleton\n          data-buro-skeleton=\"\"\n          data-testid=\"relation-candidates-loading\"\n          className=\"h-9 w-full\"\n        />\n      }\n    >\n      <CandidatesRelationPicker {...props} />\n    </Suspense>\n  );\n}\n","'use client';\n\nimport * as React from 'react';\nimport { IconCheck, IconChevronDown, IconLoader2 } from '@tabler/icons-react';\nimport {\n  composeListFilter,\n  normalizeFixedFilters,\n  resolveResourceLabel,\n  resourceKey,\n  type ErasedResourceHandle,\n  type FilterExpression,\n  type FixedFilterInput,\n  type RelationOpen,\n  relationOpenOf,\n  type ResourceRefInput,\n  type ScopeSource,\n  routeResourceKey,\n  type ResourceNameOrRef,\n} from '@burojs/core';\nimport { useApp, useI18nCaps, useList, useOptionalT, useRelatedRecord } from '@burojs/react';\nimport { LoadError } from '../load-error/load-error-view.js';\nimport type { CandidatesGate } from './candidates-gate.js';\nimport { namesHiddenField } from './search-access.js';\nimport {\n  optionSubtitle as optionSubtitleText,\n  type RecordSubtitleFn,\n  useRowSubtitle,\n} from '../resource/use-record-subtitle.js';\nimport { useRowTitle } from '../resource/use-row-title.js';\nimport { cn } from '../lib/cn.js';\nimport { useLinkComponent } from '../layout/link-component.js';\nimport { Button } from '../primitives/button.js';\nimport {\n  Command,\n  CommandEmpty,\n  CommandInput,\n  CommandItem,\n  CommandList,\n} from '../primitives/command.js';\nimport { Popover, PopoverContent, PopoverTrigger } from '../primitives/popover.js';\nimport { LazyCandidatesRelationPicker } from './lazy-candidates-picker.js';\nimport { LazyRelationPickerDialog } from './lazy-relation-picker-dialog.js';\nimport { RelationCreateButton } from './relation-create.js';\nimport { useRelationSelect } from './relation-select.js';\nimport { RelationViewButton } from './relation-view-button.js';\nimport type { FieldInputProps } from './registry.js';\n\n/** The portable erased AST — the only `fixedFilters` shape this module deals in. */\ntype ErasedExpression = FilterExpression<ErasedResourceHandle>;\n\n/**\n * Single-select relation picker (Relations item 2, v1).\n *\n * Renders a dropdown trigger labelled with the currently-selected\n * record's display name. Clicking opens a popover containing:\n *  - a debounced search input that filters target rows by `searchField`\n *    (defaults to the target's `displayField`) using the data\n *    provider's `contains` operator,\n *  - up to `pageSize` (default 10) result rows,\n *  - a \"Clear\" button when `clearable` is true and a value is set,\n *  - a \"View all\" link to the target's standalone list page so\n *    operators can fall back to the full list when the inline search\n *    can't find what they need.\n *\n * Multi-select / fuller modal / quick-create are deferred to v2 — see\n * docs/superpowers/specs/2026-05-04-relation-picker.md.\n *\n * Failure modes (mirrors RelationDisplay's fail-soft policy):\n *  - target not registered → trigger renders the raw value, picker\n *    is disabled. Caller still gets onChange(null) only via clear.\n *  - useList errors → popover shows muted \"Failed to load\" with the\n *    error message in the title; \"View all\" still works.\n *  - target row for `value` not found → trigger shows the raw id\n *    (so the operator can at least see what was stored).\n */\n\nexport interface RelationPickerProps<N extends string = string> {\n  /** Target resource name (matches `f.relation({ to: '...' })`). */\n  to: ResourceNameOrRef<N>;\n  /** Currently-selected FK value, or null/undefined when empty. */\n  value: string | number | null | undefined;\n  /** Called with the new selected id (or `by` value), or null when cleared. */\n  onChange: (next: string | number | null) => void;\n  /**\n   * The target field the value holds (`meta.by`, spec 4.2): options write `row[by]` and the\n   * selected value is resolved by it. Absent: the target's id field.\n   */\n  by?: string;\n  /**\n   * Field whose value is matched against the search text. Defaults to\n   * the target's `displayField` (which is what the trigger label\n   * already shows, so it's the natural search target).\n   */\n  searchField?: string;\n  /** Initial fetch / max visible rows. Defaults to 10. */\n  pageSize?: number;\n  /** Show a clear button. Defaults to true. */\n  clearable?: boolean;\n  /** Trigger placeholder when value is empty. */\n  placeholder?: string;\n  /** HTML name attribute for the trigger button. */\n  name?: string;\n  /** HTML id attribute. */\n  id?: string;\n  /** Test-id override. Defaults to `relation-picker:<to>`. */\n  testid?: string;\n  /**\n   * Extra filters ANDed onto every query (inline popover + advanced modal) —\n   * the same `FixedFilterInput` shape `useResourceList` takes: a bare AST\n   * expression (`@burojs/core`'s `FilterExpression`, e.g.\n   * `{ field: 'is_active', op: 'eq', value: true }`), or `{ filter, lock?,\n   * label? }` for finer control. A bare expression defaults to `lock: true`\n   * — the field is hidden from the modal's filter builder, with no badge —\n   * which is what keeps the picker from ever offering an out-of-scope\n   * record. Pass `{ filter, lock: false }` to keep the field open to the\n   * user, and add `label` to render it as an undeletable badge instead.\n   */\n  fixedFilters?: readonly FixedFilterInput[];\n  /**\n   * The trusted `defaults` of a create opened from this select (P6-31): the registry field's\n   * static `eq` literals, handed down by the form controller. Never read from `fixedFilters` or\n   * `field.meta`.\n   */\n  createSeeds?: Readonly<Record<string, unknown>>;\n  /**\n   * What the field's `candidates` say about reading the target right now (P7 3.4): `pending`\n   * draws a disabled trigger, `empty` a popover that says what to choose first, `forbidden` a\n   * disabled trigger and why. While set, nothing is read for the options. Absent: read normally.\n   */\n  candidatesGate?: CandidatesGate;\n  /**\n   * Whether a loaded row fits the resolved candidate filters (already in `fixedFilters`):\n   * `false` makes the field say the chosen row \"does not match the current filter\" (P7 3.4).\n   */\n  rowFits?: (row: Record<string, unknown>) => boolean | undefined;\n  /** The form field holding the key (the \"view\" and \"+ create\" test ids); defaults to `name`. */\n  fieldName?: string;\n  /** The field's `ui.open` (P7 3.6): what the \"view\" button opens, or no button for `none`. */\n  open?: RelationOpen;\n  /**\n   * The options' second line over the target row (a relation field's `optionSubtitle`): wins over\n   * the target's `recordSubtitle`; without either, `#<id>`.\n   */\n  optionSubtitle?: RecordSubtitleFn;\n  /**\n   * The read scope of the option reads (the popover, \"Advanced search\" and the create hand-back).\n   * Default `'context'`: the record around the picker narrows its options, except by the field\n   * the picker itself edits (`fieldName`, else `name`). `'none'` reads every row the provider\n   * allows; `'session'` the session's scope selection.\n   */\n  scope?: ScopeSource;\n  disabled?: boolean;\n  required?: boolean;\n  className?: string;\n  /** Forwarded to the trigger button when the field is in an invalid state. */\n  ariaInvalid?: boolean;\n  /** Forwarded to the trigger button as `aria-describedby` (help text only; error id goes via ariaErrorMessage). */\n  ariaDescribedBy?: string;\n  /** Forwarded to the trigger button as `aria-errormessage` (WAI-ARIA 1.2). */\n  ariaErrorMessage?: string;\n}\n\nconst DEBOUNCE_MS = 250;\n\nexport function RelationPicker<const N extends string = string>({\n  to: toInput,\n  value,\n  onChange,\n  by,\n  searchField,\n  pageSize = 10,\n  clearable = true,\n  placeholder,\n  name,\n  id,\n  testid,\n  fixedFilters,\n  createSeeds,\n  candidatesGate,\n  rowFits,\n  fieldName,\n  open: openMode,\n  optionSubtitle,\n  scope = 'context',\n  disabled,\n  required,\n  className,\n  ariaInvalid,\n  ariaDescribedBy,\n  ariaErrorMessage,\n}: RelationPickerProps<N>): React.ReactElement {\n  const to = routeResourceKey(toInput);\n  const app = useApp();\n  const caps = useI18nCaps();\n  const t = useOptionalT();\n  const targetDef = app.registry.get(to);\n  const rowTitle = useRowTitle(to, targetDef?.displayField);\n  const rowSubtitle = useRowSubtitle(to, optionSubtitle);\n  // Lowercased: the label sits mid-sentence in «Select location…».\n  const targetLabel = resolveResourceLabel(caps, to, 'single', targetDef).toLowerCase();\n  const RouterLink = useLinkComponent();\n  // Trigger testid honours the prop override (so callers like\n  // the record form get a deterministic per-field id like\n  // `form-field-input:<resource>:<view>:<field>`), but child elements\n  // (search, options, view-all, clear) keep a stable per-target prefix\n  // so e2e tests don't have to know the parent form's testid path.\n  const tid = testid ?? `relation-picker:${to}`;\n  const childPrefix = `relation-picker:${to}`;\n\n  const triggerRef = React.useRef<HTMLButtonElement | null>(null);\n  // An overlay opened from this select returns focus to the trigger when it closes: the shell\n  // records the focused element as it mounts.\n  const focusTrigger = React.useCallback(() => triggerRef.current?.focus(), []);\n  const [open, setOpen] = React.useState(false);\n  const [dialogOpen, setDialogOpen] = React.useState(false);\n  // The dialog is mounted on its first open, and only while no candidates gate holds the read:\n  // without the candidate filters it would list rows the field must not offer.\n  const gated = candidatesGate !== undefined;\n  const [dialogMounted, setDialogMounted] = React.useState(false);\n  React.useEffect(() => {\n    if (gated) setDialogOpen(false);\n  }, [gated]);\n  React.useEffect(() => {\n    if (dialogOpen) setDialogMounted(true);\n  }, [dialogOpen]);\n  const [search, setSearch] = React.useState('');\n  const [debouncedSearch, setDebouncedSearch] = React.useState('');\n\n  // Debounce the search text so each keystroke doesn't fire a request —\n  // react-query will dedup but the popover can flicker.\n  React.useEffect(() => {\n    const handle = setTimeout(() => setDebouncedSearch(search), DEBOUNCE_MS);\n    return () => clearTimeout(handle);\n  }, [search]);\n\n  // Reset search when the popover closes so reopening starts clean.\n  React.useEffect(() => {\n    if (!open) {\n      setSearch('');\n      setDebouncedSearch('');\n    }\n  }, [open]);\n\n  // Trigger label: fetch the currently-selected target row to show its\n  // display name. Skipped when value is empty (useRelatedRecord handles\n  // that). Same hook RelationDisplay uses, so the cache is shared.\n  // An input resolves the selected value whatever the field's `resolve` says (spec 4.3).\n  const { record: selectedRecord, isLoading: selectedLoading } = useRelatedRecord(\n    to,\n    value,\n    by === undefined ? undefined : { by },\n  );\n  // The record field this picker writes: a record's own scope field never narrows its options.\n  const scopeField = fieldName ?? name;\n  // The value field, the search set and the select's one pending create, shared by the popover\n  // and the \"Advanced search\" dialog (and by `useRelationPicker`).\n  const {\n    access,\n    valueField,\n    searchDecl,\n    create,\n    reader: createReader,\n  } = useRelationSelect({\n    to,\n    by,\n    searchField,\n    fixedFilters,\n    scope,\n    scopeField,\n    held: gated,\n    // As a pick does: the value is written and the \"Advanced search\" dialog, when the create\n    // came from it, is done.\n    onValue: (picked) => {\n      onChange(picked);\n      setDialogOpen(false);\n    },\n  });\n  const accessReady = access.status === 'ready';\n  // List the picker options. `useList` returns `{ data: { data, total } }`.\n  //\n  // Composed through the SAME `composeListFilter` core the dialog\n  // (`RelationPickerDialog`/`useDialogFilterState`) and the list page use —\n  // this popover is a distinct composition SITE (fixed scope + free-text\n  // search only, no builder group), not a second set of rules. Search\n  // resolution mirrors the dialog's: the target's declared\n  // `views.list.search` always wins; the `searchField` prop, else\n  // `displayField`, else `'name'` is the fallback (`useRelationSelect`),\n  // wrapped as a single-field declaration so it goes through the exact same\n  // `searchToFilter` path a real declaration would. Before this, the popover\n  // hand-rolled `{ field: <search field>, op: 'contains', value }`\n  // unconditionally, ignoring a declared `views.list.search` entirely — one\n  // control (popover vs. \"advanced search\") giving two different answers\n  // for the same typed text.\n  const filter = React.useMemo<ErasedExpression | undefined>(\n    () =>\n      composeListFilter({\n        fixed: normalizeFixedFilters(fixedFilters),\n        search: debouncedSearch,\n        searchDecl,\n        searchContext: { resource: to, def: targetDef },\n      }),\n    [fixedFilters, debouncedSearch, searchDecl, to, targetDef],\n  );\n  // An author predicate or a function search naming a hidden field forbids the read.\n  const blocked =\n    !accessReady ||\n    candidatesGate !== undefined ||\n    namesHiddenField(filter, (name) => access.fieldVisible(name));\n\n  const listQuery = useList(to, {\n    ...(filter ? { filter } : {}),\n    pagination: { kind: 'offset', page: 1, pageSize },\n    scope,\n    ...(scopeField === undefined ? {} : { scopeField }),\n    enabled: open && targetDef != null && !blocked,\n  });\n\n  const rows = (listQuery.data?.data ?? []) as Array<{ id: unknown } & Record<string, unknown>>;\n  // ⚠️ The rows the popover already loaded are a better label source than a\n  // second round-trip. `selectedRecord` comes from the batched relation\n  // aggregator; immediately after picking an option that batch has not\n  // resolved the new id yet, so the trigger fell through to its raw-id\n  // fallback and showed «4» instead of «Finished goods warehouse». The picker\n  // is holding the chosen record in `rows` — use it.\n  const triggerLabel = renderTriggerLabel({\n    rowTitle,\n    optionRows: rows,\n    valueField,\n    value,\n    selectedRecord,\n    selectedLoading,\n    targetDef,\n    targetLabel,\n    placeholder,\n    t,\n  });\n\n  // Target not registered — degrade gracefully: render a disabled\n  // trigger with the raw value so the operator can still SEE the\n  // stored FK, but they can't pick a new one because we have no\n  // basePath to drive a \"View all\" link or a useList query.\n  if (!targetDef) {\n    if (process.env.NODE_ENV !== 'production') {\n      // eslint-disable-next-line no-console\n      console.warn(`[RelationPicker] target resource '${to}' not registered — picker disabled`);\n    }\n    return (\n      <Button\n        type=\"button\"\n        variant=\"outline\"\n        disabled\n        data-testid={`${childPrefix}:unregistered`}\n        className={cn('w-full justify-between font-normal', className)}\n        name={name}\n        id={id}\n        aria-required={required}\n      >\n        <span className=\"truncate text-muted-foreground\">\n          {value == null || value === ''\n            ? (placeholder ?? t('field.select', { defaultValue: 'Select…' }))\n            : String(value)}\n        </span>\n        <IconChevronDown className=\"h-4 w-4 opacity-50\" aria-hidden />\n      </Button>\n    );\n  }\n\n  // The candidates say the target must not be read yet (P7 3.4): a disabled trigger, no popover.\n  if (candidatesGate?.kind === 'pending') {\n    return (\n      <Button\n        type=\"button\"\n        variant=\"outline\"\n        disabled\n        data-testid={tid}\n        data-buro-candidates=\"pending\"\n        className={cn('w-full justify-between font-normal', className)}\n        name={name}\n        id={id}\n        aria-required={required}\n        aria-busy=\"true\"\n      >\n        <span className=\"truncate text-muted-foreground\">{triggerLabel}</span>\n        <IconLoader2 className=\"h-4 w-4 shrink-0 animate-spin opacity-50\" aria-hidden />\n      </Button>\n    );\n  }\n  if (candidatesGate?.kind === 'forbidden') {\n    return (\n      <div className=\"flex flex-col gap-1\">\n        <Button\n          type=\"button\"\n          variant=\"outline\"\n          disabled\n          data-testid={tid}\n          data-buro-candidates=\"forbidden\"\n          className={cn('w-full justify-between font-normal', className)}\n          name={name}\n          id={id}\n          aria-required={required}\n          aria-describedby={candidatesGate.testId}\n        >\n          <span className={cn('truncate text-left', value == null && 'text-muted-foreground')}>\n            {triggerLabel}\n          </span>\n          <IconChevronDown className=\"h-4 w-4 shrink-0 opacity-50\" aria-hidden />\n        </Button>\n        <p\n          id={candidatesGate.testId}\n          data-testid={candidatesGate.testId}\n          className=\"text-xs text-muted-foreground\"\n        >\n          {candidatesGate.message}\n        </p>\n      </div>\n    );\n  }\n\n  const targetBasePath = targetDef.basePath ?? `/${to}`;\n  // The chosen row stays as it is when it falls outside the candidates; the field says so.\n  const outside =\n    rowFits !== undefined &&\n    value != null &&\n    value !== '' &&\n    selectedRecord != null &&\n    rowFits(selectedRecord as Record<string, unknown>) === false;\n  const isLoading = listQuery.isLoading || listQuery.isFetching;\n  const error = listQuery.isError ? (listQuery.error as unknown as Error) : null;\n\n  function handleSelect(rowId: unknown): void {\n    // IDs arrive as strings or numbers depending on the data provider.\n    // Pass through as-is so callers can compare to their\n    // schema (e.g. UUID strings stay strings).\n    onChange(rowId as string | number);\n    setOpen(false);\n  }\n\n  function handleClear(): void {\n    onChange(null);\n    setOpen(false);\n  }\n\n  return (\n    <Popover open={open} onOpenChange={setOpen}>\n      <div className=\"flex items-center gap-1\">\n        <PopoverTrigger asChild>\n          <Button\n            ref={triggerRef}\n            type=\"button\"\n            variant=\"outline\"\n            role=\"combobox\"\n            aria-expanded={open}\n            aria-haspopup=\"listbox\"\n            aria-required={required}\n            aria-invalid={ariaInvalid || undefined}\n            aria-describedby={ariaDescribedBy}\n            {...(ariaErrorMessage ? { 'aria-errormessage': ariaErrorMessage } : {})}\n            disabled={disabled}\n            data-testid={tid}\n            name={name}\n            id={id}\n            className={cn('w-full justify-between font-normal', className)}\n          >\n            <span className={cn('truncate text-left', value == null && 'text-muted-foreground')}>\n              {triggerLabel}\n            </span>\n            <IconChevronDown className=\"h-4 w-4 shrink-0 opacity-50\" aria-hidden />\n          </Button>\n        </PopoverTrigger>\n        {!disabled && (\n          <RelationViewButton\n            to={to}\n            value={value}\n            by={by}\n            fieldName={fieldName ?? name ?? to}\n            beforeOpen={focusTrigger}\n            {...(openMode === undefined ? {} : { open: openMode })}\n          />\n        )}\n      </div>\n      {outside && (\n        <p\n          className=\"mt-1 text-xs text-muted-foreground\"\n          data-testid={`${childPrefix}:not-matching`}\n        >\n          {t('relationPicker.notMatching', { defaultValue: 'Does not match the current filter' })}\n        </p>\n      )}\n      <PopoverContent className=\"w-[var(--radix-popover-trigger-width)] p-0\" align=\"start\">\n        {candidatesGate?.kind === 'empty' ? (\n          <p\n            className=\"px-3 py-6 text-center text-sm text-muted-foreground\"\n            data-testid={candidatesGate.testId}\n          >\n            {candidatesGate.message}\n          </p>\n        ) : (\n          /* shouldFilter={false}: cmdk's built-in client filter is disabled\n            because filtering happens server-side via useList's `contains`\n            operator. cmdk still drives keyboard navigation, focus,\n            highlighted-item state, and Enter-to-select. */\n          <Command shouldFilter={false}>\n            {searchDecl !== undefined && (\n              <CommandInput\n                value={search}\n                onValueChange={setSearch}\n                placeholder={t('toolbar.search', {\n                  params: { name: targetLabel },\n                  defaultValue: `Search ${targetLabel}…`,\n                })}\n                data-testid={`${childPrefix}:search`}\n                aria-label={t('toolbar.search', {\n                  params: { name: targetLabel },\n                  defaultValue: `Search ${targetLabel}`,\n                })}\n              />\n            )}\n            <CommandList data-testid={`${childPrefix}:list`}>\n              {isLoading && (\n                <div\n                  className=\"flex items-center justify-center gap-2 py-6 text-sm text-muted-foreground\"\n                  data-testid={`${childPrefix}:loading`}\n                >\n                  <IconLoader2 className=\"h-4 w-4 animate-spin\" aria-hidden />\n                  <span>{t('table.loading', { defaultValue: 'Loading…' })}</span>\n                </div>\n              )}\n              {!isLoading && error && (\n                <LoadError\n                  surface=\"picker\"\n                  error={error}\n                  testId={`${childPrefix}:error`}\n                  className=\"block px-3 py-6 text-center text-sm text-muted-foreground\"\n                  fallback={{ key: 'relation.failed', default: 'Failed to load options.' }}\n                />\n              )}\n              {!isLoading && !error && rows.length === 0 && (\n                <CommandEmpty data-testid={`${childPrefix}:empty`}>\n                  {t('relation.noResults', { defaultValue: 'No results.' })}\n                </CommandEmpty>\n              )}\n              {!isLoading &&\n                !error &&\n                rows.map((row) => {\n                  const rowId = row[valueField];\n                  // A row without the value the field stores cannot be chosen (no fallback to id).\n                  if (rowId === null || rowId === undefined || rowId === '') return null;\n                  const idStr = String(rowId);\n                  const label = rowTitle(row);\n                  const subtitle = optionSubtitleText(rowSubtitle(row), label, idStr);\n                  const isSelected = value != null && String(value) === idStr;\n                  return (\n                    <CommandItem\n                      key={idStr}\n                      // cmdk uses `value` for keyboard-search semantics;\n                      // setting it to `${label} ${idStr}` lets users type\n                      // either the label OR the id and the highlighted\n                      // option still tracks correctly across renders.\n                      value={`${label} ${idStr}`}\n                      data-testid={`${childPrefix}:option:${idStr}`}\n                      onSelect={() => handleSelect(rowId)}\n                    >\n                      <IconCheck\n                        className={cn(\n                          'mr-2 h-4 w-4 shrink-0',\n                          isSelected ? 'opacity-100' : 'opacity-0',\n                        )}\n                        aria-hidden\n                      />\n                      <span className=\"truncate\">{label}</span>\n                      {/* The declared subtitle, else `#<id>` unless the label already is the id\n                          (REF-40). */}\n                      {subtitle === null ? null : (\n                        <span className=\"ml-auto shrink-0 pl-2 text-xs text-muted-foreground\">\n                          {subtitle}\n                        </span>\n                      )}\n                    </CommandItem>\n                  );\n                })}\n            </CommandList>\n            {/* Wraps at narrow widths: four actions do not fit one line of a small popover. */}\n            <div className=\"flex flex-wrap items-center justify-between gap-x-2 gap-y-1 border-t px-3 py-2 text-sm\">\n              {clearable && value != null && value !== '' ? (\n                <button\n                  type=\"button\"\n                  onClick={handleClear}\n                  data-testid={`${childPrefix}:clear`}\n                  className=\"text-muted-foreground hover:text-foreground focus:outline-hidden focus-visible:underline\"\n                >\n                  {t('relationPicker.clear', { defaultValue: 'Clear' })}\n                </button>\n              ) : (\n                <span aria-hidden />\n              )}\n              <div className=\"flex flex-wrap items-center gap-x-3 gap-y-1\">\n                {/* #11 — escalation to the full-list modal: search + sort +\n                  paginate + create, for when the inline popover isn't enough. */}\n                <button\n                  type=\"button\"\n                  onClick={() => {\n                    setOpen(false);\n                    setDialogOpen(true);\n                  }}\n                  data-testid={`${childPrefix}:advanced`}\n                  className=\"text-foreground hover:underline focus:outline-hidden focus-visible:underline\"\n                >\n                  {t('relationPicker.advancedSearch', { defaultValue: 'Advanced search' })}\n                </button>\n                {!disabled && (\n                  <RelationCreateButton\n                    to={to}\n                    fieldName={fieldName ?? name ?? to}\n                    create={create}\n                    seeds={createSeeds}\n                    search={search}\n                    beforeOpen={() => {\n                      setOpen(false);\n                      focusTrigger();\n                    }}\n                    className=\"text-foreground hover:underline focus:outline-hidden focus-visible:underline disabled:opacity-50\"\n                  />\n                )}\n                <RouterLink\n                  href={targetBasePath}\n                  data-testid={`${childPrefix}:view-all`}\n                  className=\"text-muted-foreground hover:text-foreground hover:underline focus:outline-hidden focus-visible:underline\"\n                >\n                  {t('relationPicker.viewAll', { defaultValue: 'Open list' })} →\n                </RouterLink>\n              </div>\n            </div>\n          </Command>\n        )}\n      </PopoverContent>\n      {/*\n        The RAW `searchField` prop, not the resolved fallback — the dialog\n        (Task 5, SP3) does its OWN target-declaration → prop → displayField\n        resolution via `useDialogFilterState`, so handing it an already-\n        resolved value here would just have this component's own\n        `displayField ?? 'name'` fallback (built for the POPOVER's simpler\n        contains-only search) silently stand in for the dialog's, rather\n        than letting the target's declared `views.list.search` win when the\n        caller passed no override at all.\n      */}\n      {dialogMounted && !gated && (\n        <LazyRelationPickerDialog\n          to={to}\n          open={dialogOpen}\n          onOpenChange={setDialogOpen}\n          onSelect={(rowId) => onChange(rowId)}\n          valueField={valueField}\n          searchField={searchField}\n          fixedFilters={fixedFilters}\n          scope={scope}\n          {...(scopeField === undefined ? {} : { scopeField })}\n          {...(disabled ? {} : { create })}\n          createSeeds={createSeeds}\n          fieldName={fieldName ?? name ?? to}\n          onBeforeCreate={focusTrigger}\n        />\n      )}\n      {createReader}\n    </Popover>\n  );\n}\n\ninterface TriggerLabelArgs {\n  value: string | number | null | undefined;\n  selectedRecord: ReturnType<typeof useRelatedRecord>['record'];\n  selectedLoading: boolean;\n  /** Rows already loaded for the popover; used as a same-tick label source. */\n  optionRows?: Array<{ id: unknown } & Record<string, unknown>>;\n  /** The row field the value holds (`by`, else the id field). */\n  valueField: string;\n  targetDef: ReturnType<ReturnType<typeof useApp>['registry']['get']>;\n  /** The resolved, lowercased target label. */\n  targetLabel: string;\n  placeholder?: string;\n  /** The row title under the viewer's field view (id when the display field is hidden). */\n  rowTitle: (row: Record<string, unknown>) => string;\n  t: (key: string, options?: { params?: Record<string, unknown>; defaultValue?: string }) => string;\n}\n\nfunction renderTriggerLabel({\n  value,\n  selectedRecord,\n  selectedLoading,\n  targetLabel,\n  placeholder,\n  optionRows,\n  valueField,\n  t,\n  rowTitle,\n}: TriggerLabelArgs): React.ReactNode {\n  if (value == null || value === '') {\n    return (\n      placeholder ??\n      t('relation.select', {\n        params: { name: targetLabel },\n        defaultValue: `Select ${targetLabel}…`,\n      })\n    );\n  }\n  if (selectedLoading) {\n    return t('table.loading', { defaultValue: 'Loading…' });\n  }\n  if (selectedRecord) {\n    return rowTitle(selectedRecord);\n  }\n  // Not resolved by the aggregator yet (or at all). If the popover already\n  // loaded this record as an option — which it always has right after the\n  // user picked it — label from that instead of showing a bare id.\n  const fromOptions = optionRows?.find((r) => String(r[valueField]) === String(value));\n  if (fromOptions) {\n    return rowTitle(fromOptions);\n  }\n  // Genuinely unknown (404 / not in the loaded page) — show the raw id so the\n  // operator can at least see what was stored.\n  return String(value);\n}\n\n/**\n * Form-field adapter wrapping `<RelationPicker>` for use as a default\n * Input renderer in the field registry. Reads `field.meta.to` for the\n * target resource name. When `meta.to` is absent we degrade to a plain\n * (disabled) text representation of the value with a console warning —\n * same fail-soft as RelationDisplay.\n */\nexport function RelationPickerInput(props: FieldInputProps): React.ReactElement {\n  const { name, id, value, testid, field, required } = props;\n  const meta = field?.meta as { to?: ResourceRefInput; candidates?: unknown } | undefined;\n  let to: string | undefined;\n  try {\n    to = meta?.to === undefined ? undefined : resourceKey(meta.to);\n  } catch {\n    to = undefined;\n  }\n\n  if (!to) {\n    if (process.env.NODE_ENV !== 'production') {\n      // eslint-disable-next-line no-console\n      console.warn(\n        `[RelationPickerInput] no meta.to on field '${field?.name ?? name}' — relation picker disabled`,\n      );\n    }\n    return (\n      <Button\n        type=\"button\"\n        variant=\"outline\"\n        disabled\n        data-testid={`${testid ?? `relation-picker:${name}`}:no-target`}\n        className=\"w-full justify-between font-normal\"\n        name={name}\n        id={id}\n        aria-required={required}\n      >\n        <span className=\"truncate text-muted-foreground\">\n          {value == null || value === '' ? '—' : String(value)}\n        </span>\n      </Button>\n    );\n  }\n\n  // The candidates path is loaded only for a field that declares candidates.\n  if (Array.isArray(meta?.candidates) && meta.candidates.length > 0)\n    return <LazyCandidatesRelationPicker {...props} />;\n  return <FieldRelationPicker props={props} to={to} />;\n}\n\n/** The form field's props as `RelationPicker` takes them; `extra` carries the candidates' part. */\nexport function FieldRelationPicker({\n  props,\n  to,\n  extra,\n}: {\n  props: FieldInputProps;\n  to: string;\n  extra?: {\n    fixedFilters: FieldInputProps['fixedFilters'];\n    candidatesGate?: CandidatesGate;\n    rowFits?: (row: Record<string, unknown>) => boolean | undefined;\n  };\n}): React.ReactElement {\n  const { name, id, value, onChange, testid, field, disabled, required, relationSeeds } = props;\n  const { ariaInvalid, ariaDescribedBy, ariaErrorMessage } = props;\n  const meta = field?.meta as\n    | { by?: unknown; searchField?: string; scope?: ScopeSource }\n    | undefined;\n  const subtitle = props.optionSubtitle;\n  return (\n    <RelationPicker\n      to={to}\n      value={value as string | number | null | undefined}\n      onChange={(v) => onChange(v)}\n      {...(typeof meta?.by === 'string' ? { by: meta.by } : {})}\n      name={name}\n      id={id}\n      testid={testid ?? `relation-picker:${to}`}\n      searchField={meta?.searchField}\n      {...(meta?.scope === undefined ? {} : { scope: meta.scope })}\n      fixedFilters={extra === undefined ? props.fixedFilters : extra.fixedFilters}\n      {...(extra?.candidatesGate === undefined ? {} : { candidatesGate: extra.candidatesGate })}\n      {...(extra?.rowFits === undefined ? {} : { rowFits: extra.rowFits })}\n      {...(relationSeeds === undefined ? {} : { createSeeds: relationSeeds })}\n      fieldName={field?.name ?? name}\n      open={relationOpenOf(field ?? {})}\n      {...(subtitle === undefined ? {} : { optionSubtitle: subtitle })}\n      disabled={disabled}\n      required={required}\n      ariaInvalid={ariaInvalid}\n      ariaDescribedBy={ariaDescribedBy}\n      ariaErrorMessage={ariaErrorMessage}\n    />\n  );\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"}