@burojs/ui-shadcn 0.6.0 → 0.7.0

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import { t as THEME_STORAGE_KEY } from "./theme-storage-key-pYlp4aDS.js";
-import { ActionDensity, AnyFrameHandle, AppRuntime, AuthResult, Check, CheckSurface, CustomPageDef, DraftOption, EntityRef, ErasedResourceHandle, ExportArtifact, ExportTarget, FieldDeclaration, FilterExpression, FilterGroup, FilterOperator, FixedFilterInput, FormBody, FrameHandle, HrefOpts, I18nCaps, NavGroupDef, NavNode, PortableValue, RelationCandidate, RelationOpen, ResolvedFixedFilter, ResourceDef, ResourceFieldMap, ResourceHandle, RouteMatch, SavedViewDef, ScopeSource, ScreenMode, ScreenSources, SearchDecl, SectionDef, SortExpression, StandardSchemaV1, TaskRunReport, UiSettingsIssue, ValidationIssues, ValueCodec, i18nPrefixToRef } from "@burojs/core";
-import { BlockImplementationCatalog, CheckGateState, CollectionDisplayProps, CollectionInputProps, DEFAULT_LANGUAGE_STORAGE_KEY, FieldBinding, FieldImplementation, FieldImplementationLayout, FieldPresentation, FilterFieldSpec, FilterKind, FormValues, QuickSettledRow, RowRecord, SavedViewEntry, ScalarDisplayProps, ScalarInputProps, UIPresentationHostProps, UIPresentationHosts, UseFormControllerFormOptions, modeForSurface, useApp, useOptionalT, useTestIds } from "@burojs/react";
+import { webPlatform } from "@burojs/react/web";
+import { ActionDensity, AnyFrameHandle, AppRuntime, AuthResult, Check, CheckSurface, CustomPageDef, DraftOption, EntityRef, EnumControl, EnumNameOrRef, ErasedResourceHandle, ExportArtifact, ExportTarget, FieldDeclaration, FilterExpression, FilterGroup, FilterOperator, FixedFilterInput, FormBody, FrameHandle, HrefOpts, I18nCaps, NavGroupDef, NavNode, PortableValue, RecordId, RelationCandidate, RelationOpen, ResolvedColumnUi, ResolvedFixedFilter, ResourceDef, ResourceFieldMap, ResourceHandle, ResourceHandleOf, ResourceNameArg, ResourceNameOrRef, ResourceRefArg, RouteMatch, SavedViewDef, ScopeSource, ScreenMode, ScreenSources, SearchDecl, SectionDef, SortExpression, StandardSchemaV1, TaskRunReport, UiSettingsIssue, UiSurface, ValidationIssues, i18nPrefixToRef } from "@burojs/core";
+import { BlockImplementationCatalog, CheckGateState, CollectionDisplayProps, CollectionInputProps, DEFAULT_LANGUAGE_STORAGE_KEY, FieldBinding, FieldImplementation, FieldImplementationLayout, FieldLinkState, FieldPresentation, FilterFieldSpec, FilterKind, FormSubmitContext, FormValues, ListOptionFilter, QuickSettledRow, RowRecord, SavedViewEntry, ScalarDisplayProps, ScalarInputProps, UIPresentationHostProps, UIPresentationHosts, UseFormControllerFormOptions, modeForSurface, useApp, useTestIds } from "@burojs/react";
 import * as React$1 from "react";
-import { AnchorHTMLAttributes, ComponentProps, ComponentType, JSX, ReactElement, ReactNode, SVGProps } from "react";
+import { AnchorHTMLAttributes, ComponentType, JSX, ReactElement, ReactNode, SVGProps } from "react";
 import { ClassValue } from "clsx";
 import * as PopoverPrimitive from "@radix-ui/react-popover";
 import { Slot as Slot$1 } from "@radix-ui/react-slot";
@@ -353,7 +354,10 @@ declare function useLayout(key: string): NavLayout | undefined;
 /**
  * Non-hook-in-loop layout lookup: read the Components registry once, return a
  * resolver `(key) => NavLayout | undefined`. Lets `NavChrome` resolve a
- * variable-length group chain without violating Rules of Hooks.
+ * variable-length group chain without violating Rules of Hooks. The registry
+ * (`layout.<key>`) wins; the built-ins (`secondary-sidebar`, `tabs`) are the
+ * fallback, so they work without registration. `flat` and `collapsible` resolve
+ * to nothing: they are main-sidebar-only groupings.
  */
 declare function useLayoutResolver(): (key: string) => NavLayout | undefined;
 //#endregion
@@ -417,44 +421,19 @@ interface NavChromeProps {
 /**
  * Wrap the active page in its group-chain chrome. Walks `match.groupChain`
  * innermost→outermost, wrapping the accumulating content in each group's
- * registered content layout (secondary-sidebar / tabs). Groups whose layout
- * has no registered content renderer (flat / collapsible — main-sidebar only)
- * contribute no wrapping. No match → children bare.
+ * content layout (secondary-sidebar / tabs). Groups whose layout has no
+ * content renderer (flat / collapsible — main-sidebar only) contribute no
+ * wrapping. No match → children bare (`/login`, a host's own routes).
+ *
+ * Mount it ONCE in the persistent layout, around whatever the router renders —
+ * `AppShell` does this by default. Moving within an area keeps the outer layout
+ * element at the same type and position, so React reconciles it in place: the
+ * secondary sidebar stays the same DOM node and only its active item changes.
+ * Output depends only on the registry, the adapter's pathname and i18n — no
+ * effect decides it, so it renders on the server as on the client.
  */
 declare function NavChrome({ children, entryFilter, icons }: NavChromeProps): ReactElement;
 //#endregion
-//#region src/layout/nav-chrome-boundary.d.ts
-declare function useNavChromeBoundary(): ReadonlySet<string>;
-/**
- * Merge `claim` into the ancestor boundary set and provide it downward. Nested
- * NavAreaLayouts compose: each adds its own group (+ ancestors) to the set.
- */
-declare function NavChromeBoundaryProvider({ claim, children }: {
-  claim: readonly string[];
-  children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
-//#endregion
-//#region src/layout/nav-area-layout.d.ts
-interface NavAreaLayoutProps {
-  groupName: string;
-  children: ReactNode;
-  entryFilter?: (node: {
-    name: string;
-  }) => boolean;
-  icons?: BuildNavItemsArgs['icons'];
-}
-/**
- * Persistent chrome for ONE group, meant to be rendered from a Next
- * `layout.tsx` (so it reconciles across navigations within the area instead of
- * remounting like the page does). Renders the group's registered content layout
- * (active-state from the current match — the layout re-renders on navigation
- * but does not remount, so internal state is preserved), and CLAIMS the group
- * (+ its ancestors) in `NavChromeBoundary` so the descendant page `NavChrome`
- * skips it (no double render). `chromeOn:'list'` groups still collapse on a
- * resource detail action; the boundary claim holds regardless.
- */
-declare function NavAreaLayout({ groupName, children, entryFilter, icons }: NavAreaLayoutProps): ReactElement;
-//#endregion
 //#region src/layout/resource-page-router.d.ts
 interface ResourcePageRouterProps {
   match: RouteMatch;
@@ -483,9 +462,11 @@ interface ResourcePageRouterProps {
  */
 declare function ResourcePageRouter({ match }: ResourcePageRouterProps): ReactElement;
 /**
- * Resolves the active route (`useMatch`, from the router adapter) and renders
- * it inside the group-chain chrome (`NavChrome`), dispatching to the right
- * framework component via `ResourcePageRouter`. No match → a not-found panel;
+ * The page a host mounts: resolves the active route (`useMatch`, from the
+ * router adapter) and dispatches to the right framework component via
+ * `ResourcePageRouter`. Content only — the group-chain chrome (`NavChrome`)
+ * lives in the persistent layout around it (`AppShell` mounts it), so it
+ * survives navigation while this page remounts. No match → a not-found panel;
  * no router adapter at all → the same panel, and in development one
  * `console.error` naming `RouterAdapterProvider` (once per app), because
  * then EVERY route is not-found. Wrapped in a `Suspense` boundary so a
@@ -502,12 +483,13 @@ declare function NavAreaPage(): ReactElement;
  * `defaults` exists on `create` only: show and edit render the record as it
  * is, so the type refuses it there rather than ignoring it.
  */
-type RecordPageProps = {
-  readonly resource?: string;
+type RecordPageProps<N extends string = string> = {
+  /** A name checked against the registered resources, or the entity ref. */
+  readonly resource?: ResourceNameOrRef<N>;
   readonly action: Exclude<ScreenMode, 'create'>;
   readonly defaults?: never;
 } | {
-  readonly resource?: string;
+  readonly resource?: ResourceNameOrRef<N>;
   readonly action?: Extract<ScreenMode, 'create'>;
   /**
    * The caller's tier of starting values, above each field's declared
@@ -528,7 +510,7 @@ type RecordPageProps = {
  * `<ResourcePageRouter>` renders the record route itself; a different layout is a frame on the
  * screen (`views.<mode>.frame`), never a replaced route (P6-56).
  */
-declare function RecordPage(props: RecordPageProps): ReactElement;
+declare function RecordPage<const N extends string = string>(props: RecordPageProps<N>): ReactElement;
 //#endregion
 //#region src/layout/record-breadcrumbs.d.ts
 /**
@@ -553,12 +535,18 @@ declare function RecordBreadcrumbs(): ReactElement | null;
 //#endregion
 //#region src/record/record-screen.d.ts
 type AnyResourceHandle$1 = ResourceHandle<any, any, any, any>;
-interface RecordScreenProps {
-  /** A canonical resource name, or its handle. */
-  readonly resource: string | AnyResourceHandle$1;
+interface RecordScreenProps<N extends string = string> {
+  /**
+   * The resource: its name (checked against the registered resources), its handle or its entity
+   * ref `{ namespace, id }`.
+   */
+  readonly resource: ResourceNameArg<N> | AnyResourceHandle$1 | EntityRef;
   readonly mode: 'show' | 'edit' | 'create';
-  /** The record to read (show, edit); not needed when `record` is given. */
-  readonly recordId?: string;
+  /**
+   * The record to read and write (show, edit), as its id field types it: a number for a numeric id
+   * field. Not needed when `record` is given.
+   */
+  readonly recordId?: RecordId;
   /**
    * The accepted type of a typed create. Without a router, changing it remounts the form for the
    * new type and discards unsaved input without asking for confirmation.
@@ -574,8 +562,12 @@ interface RecordScreenProps {
    * (the form is dirty); any other key is dropped. Not a default, never trusted.
    */
   readonly input?: Readonly<Record<string, unknown>>;
-  /** Replaces the built-in update or create; receives the payload. */
-  readonly onSubmit?: (payload: Record<string, unknown>) => Promise<unknown>;
+  /**
+   * Replaces the built-in update or create; receives the payload (the record's columns) and, as
+   * `context.links`, each inline link field's keys to add and remove; `context.idempotencyKey` and
+   * `context.resend` name the attempt (a resend of an unknown write keeps its key).
+   */
+  readonly onSubmit?: (payload: Record<string, unknown>, context: FormSubmitContext) => Promise<unknown>;
   /** Called after a successful submit with what the write returned. */
   readonly onSuccess?: (result: unknown) => void;
   /** Replaces Cancel's default back navigation. */
@@ -597,7 +589,7 @@ interface RecordScreenProps {
  * `record` is given; writes with the resource's update or create unless
  * `onSubmit` is given. A resource the app does not know renders not-found.
  */
-declare function RecordScreen(props: RecordScreenProps): ReactElement;
+declare function RecordScreen<const N extends string = string>(props: RecordScreenProps<N>): ReactElement;
 //#endregion
 //#region src/record/frame-pieces.d.ts
 /**
@@ -622,11 +614,16 @@ declare const CopyId: () => ReactElement | null;
 declare const FormActions: () => ReactElement | null;
 //#endregion
 //#region src/layout/default-nav-layouts.d.ts
-/** The built-in content-wrapping layouts. Merge into the app's Components registry. */
+/**
+ * The built-in content-wrapping layouts as a Components-registry table.
+ *
+ * Optional: `secondary-sidebar` and `tabs` resolve without it. Spread it into
+ * `BuroProvider`'s `components` only to wrap or re-register the built-ins.
+ */
 declare const defaultNavLayouts: Record<string, NavLayout>;
 //#endregion
 //#region src/layout/context-picker.d.ts
-interface ContextPickerProps {
+interface ContextPickerBase {
   /**
    * Slice name (also used in testid). Free-form — playground uses 'company',
    * 'productGroup', 'location' etc.
@@ -638,8 +635,6 @@ interface ContextPickerProps {
     value: string;
     label: string;
   }>;
-  value: string | null;
-  onChange: (value: string) => void;
   placeholder?: string;
   disabled?: boolean;
   className?: string;
@@ -654,6 +649,19 @@ interface ContextPickerProps {
    */
   hideLabel?: boolean;
 }
+type ContextPickerProps = (ContextPickerBase & {
+  allOption?: undefined;
+  value: string | null;
+  onChange: (value: string) => void;
+}) | (ContextPickerBase & {
+  /**
+   * Adds an "All" item first: `true` labels it with the `scope.all` chrome string, a string
+   * is the label. `value: null` selects it and `onChange` receives `null` for it.
+   */
+  allOption: true | string;
+  value: string | null;
+  onChange: (value: string | null) => void;
+});
 /**
  * Generic context picker — a labeled dropdown that drives a slice value.
  * Used in the sidebar / header to switch company, product group, location, etc.
@@ -661,7 +669,24 @@ interface ContextPickerProps {
  * The component is presentational. Consumers wire it to whatever store they
  * use (auth context, buro context engine, or local state).
  */
-declare function ContextPicker({ sliceName, label, options, value, onChange, placeholder, disabled, className, hideLabel }: ContextPickerProps): React.ReactElement;
+declare function ContextPicker({ sliceName, label, options, value, onChange, placeholder, disabled, className, hideLabel, allOption }: ContextPickerProps): React.ReactElement;
+//#endregion
+//#region src/layout/scope-dimension-picker.d.ts
+interface ScopeDimensionPickerProps {
+  /** A key of `defineScope(...)`. */
+  dimension: string;
+  /** Falls back to `humanizeKey(dimension)`. */
+  label?: string;
+  hideLabel?: boolean;
+  className?: string;
+}
+/**
+ * The control for one scope dimension (read-scope spec 7c.3): the dimension's values as options,
+ * "All" first (nothing selected means everything allowed), writing `useScope().select`. A
+ * selection change, never a transition: no cache is cleared and nothing in flight is cancelled.
+ * Renders nothing for `select: 'none'`.
+ */
+declare function ScopeDimensionPicker(props: ScopeDimensionPickerProps): React.ReactElement | null;
 //#endregion
 //#region src/layout/use-theme.d.ts
 /** What the user picked. `'system'` means "no explicit choice" — nothing is
@@ -769,9 +794,9 @@ interface BreadcrumbsBaseProps {
   'data-testid'?: string;
 }
 /** A trail that ends at, or passes through, a resource: its list link, then the record. */
-interface ResourceBreadcrumbsProps extends BreadcrumbsBaseProps {
-  /** Resource name (the registry key). */
-  resource: string;
+interface ResourceBreadcrumbsProps<N extends string = string> extends BreadcrumbsBaseProps {
+  /** Resource name (the registry key), checked against the registered resources; or its entity ref. */
+  resource: ResourceNameOrRef<N>;
   name?: never;
   /** Identifier for the current page (testid only); a record id on show/edit pages. */
   recordId?: string;
@@ -797,7 +822,7 @@ interface PageBreadcrumbsProps extends BreadcrumbsBaseProps {
   recordId?: never;
   middleSegments?: never;
 }
-type BreadcrumbsProps = ResourceBreadcrumbsProps | PageBreadcrumbsProps;
+type BreadcrumbsProps<N extends string = string> = ResourceBreadcrumbsProps<N> | PageBreadcrumbsProps;
 /**
  * The navigation breadcrumb, in two shapes. With `resource`: the leading
  * segments, the resource (a link to its canonical, nesting-aware list href,
@@ -807,7 +832,7 @@ type BreadcrumbsProps = ResourceBreadcrumbsProps | PageBreadcrumbsProps;
  * emphasised, non-linked span with `aria-current="page"`. Every crumb carries
  * its label as a `title` tooltip, so a truncated one can still be read.
  */
-declare function Breadcrumbs(props: BreadcrumbsProps): ReactElement | null;
+declare function Breadcrumbs<const N extends string = string>(input: BreadcrumbsProps<N>): ReactElement | null;
 //#endregion
 //#region src/layout/header-breadcrumbs.d.ts
 /**
@@ -1033,7 +1058,7 @@ interface CommandPaletteRecentGroupProps {
   heading?: string;
   /**
    * Re-read trigger. When this prop changes the component re-reads
-   * `localStorage` (e.g. flip from `false` → `true` on palette open).
+   * the platform's local store (e.g. flip from `false` → `true` on palette open).
    * Optional — when omitted the component reads only on mount and when
    * the user changes, which is sufficient for the typical "palette
    * dialog re-mounts on each open" use case.
@@ -1207,6 +1232,7 @@ interface CommandPaletteRecordsGroupProps {
  * ```tsx
  * 'use client';
  * import { useCommandPalette } from '@burojs/react';
+ * import { useGlobalShortcut } from '@burojs/react/web';
  * import {
  *   CommandPalette,
  *   CommandPaletteRecordsGroup,
@@ -1214,7 +1240,8 @@ interface CommandPaletteRecordsGroupProps {
  * } from '@burojs/ui-shadcn';
  *
  * function Shell() {
- *   const { open, setOpen } = useCommandPalette();
+ *   const { open, setOpen, toggle } = useCommandPalette();
+ *   useGlobalShortcut({ key: 'k', mod: true }, toggle);
  *   return (
  *     <CommandPalette open={open} onOpenChange={setOpen}>
  *       <CommandPaletteRecordsGroup
@@ -1470,7 +1497,7 @@ interface CommandPaletteCreateGroupProps {
  *
  * 1. Resources with no list page (`views.list.page: false`) are
  *    excluded — they are reached through a parent's placement.
- * 2. `evaluateVisible(def.visible, visibilityCtx)` must return true.
+ * 2. `useResourceVisible()` (the sidebar's predicate: its `visible(ctx)`) must return true.
  *    Same predicate the sidebar + navigation group use, fail-closed
  *    on throwing predicates. Hidden in sidebar → hidden here.
  * 3. Caller-supplied `resourceFilter` (if any). Returning `false`
@@ -1753,6 +1780,7 @@ declare const shadcnFieldImplementations: Readonly<{
     CollectionDisplay?: import("react").ComponentType<CollectionDisplayProps<unknown, Readonly<Record<string, unknown>>>> | undefined;
     layout?: FieldImplementationLayout;
     meta: import("@burojs/core").StandardSchemaV1<unknown, Readonly<Record<string, unknown>>>;
+    texts?: Readonly<Record<string, string>>;
   }>;
   richText: FieldImplementation<unknown, Readonly<Record<string, unknown>>>;
   'rich-text': FieldImplementation<unknown, Readonly<Record<string, unknown>>>;
@@ -1771,13 +1799,18 @@ declare const shadcnBlockImplementations: BlockImplementationCatalog;
 //#region src/fields/registry.d.ts
 interface FieldRendererProps {
   value: unknown;
+  /**
+   * The value's formatted display text (REF-117 §4.6), when the surface declares a transform and
+   * the value is not empty. A built-in display renders it instead of its own formatting; a custom
+   * renderer may ignore it.
+   */
+  text?: string;
   /** True when this renderer is reached through a collection implementation. */
   multiple?: boolean;
   field?: {
     name: string;
     meta?: Record<string, unknown>;
     ui?: Record<string, unknown>;
-    codec?: ValueCodec<unknown, unknown, unknown>;
     /** The field's declared `texts`; an option's label is read from it (`fieldOptionText`). */
     texts?: unknown;
   };
@@ -1826,6 +1859,11 @@ interface FieldInputProps {
    * `candidates` refs are read from (P7 3.4).
    */
   metaSources?: ScreenSources;
+  /**
+   * An inline link field of a record form: what the user may do with it, the keys they cannot
+   * see, and whether the form holds its keys. Only the to-many select reads it.
+   */
+  link?: FieldLinkState;
   id?: string;
   value: unknown;
   /** True when this renderer is reached through a collection implementation. */
@@ -1870,6 +1908,12 @@ interface FieldInputProps {
    * be honored — `<RecordScreen>` already wires both together.
    */
   ariaErrorMessage?: string;
+  /**
+   * Id of the field's label element, when the surface renders one with an id.
+   * A control whose root is not labelable (a radio group) passes it to
+   * `aria-labelledby`; a labelable one is already named by the label's `for`.
+   */
+  ariaLabelledBy?: string;
   /**
    * Field metadata, mirroring `FieldRendererProps.field`. Forwarded by
    * `<RecordScreen>` so renderers that depend on per-field meta (e.g.
@@ -1888,7 +1932,6 @@ interface FieldInputProps {
     name: string;
     meta?: Record<string, unknown>;
     ui?: Record<string, unknown>;
-    codec?: ValueCodec<unknown, unknown, unknown>;
   };
   /**
    * Registry name of the resource this field belongs to.
@@ -1907,27 +1950,36 @@ interface FieldInputProps {
 }
 //#endregion
 //#region src/fields/text.d.ts
-declare function TextDisplay({ value }: FieldRendererProps): React$1.ReactElement;
+declare function TextDisplay({ value, text: formatted }: FieldRendererProps): React$1.ReactElement;
 declare function TextInput({ name, id, value, onChange, testid, placeholder, disabled, required, ariaInvalid, ariaDescribedBy, ariaErrorMessage, minLength, maxLength, pattern }: FieldInputProps): React$1.ReactElement;
 //#endregion
 //#region src/fields/number.d.ts
-declare function NumberDisplay({ value, field }: FieldRendererProps): React$1.ReactElement;
+declare function NumberDisplay({ value, field, text }: FieldRendererProps): React$1.ReactElement;
 declare function NumberInput({ name, id, value, onChange, testid, placeholder, disabled, required, ariaInvalid, ariaDescribedBy, ariaErrorMessage, min, max }: FieldInputProps): React$1.ReactElement;
 //#endregion
 //#region src/fields/boolean.d.ts
-declare function BooleanDisplay({ value }: FieldRendererProps): React$1.ReactElement;
+declare function BooleanDisplay({ value, text }: FieldRendererProps): React$1.ReactElement;
 declare function BooleanInput({ name, id, value, onChange, testid, disabled, required, ariaInvalid, ariaDescribedBy, ariaErrorMessage }: FieldInputProps): React$1.ReactElement;
 //#endregion
 //#region src/fields/date.d.ts
-declare function DateDisplay({ value }: FieldRendererProps): React$1.ReactElement;
-declare function DateInput({ name, id, value, onChange, testid, disabled, required, ariaInvalid, ariaDescribedBy, ariaErrorMessage }: FieldInputProps): React$1.ReactElement;
+declare function DateDisplay({ value, text }: FieldRendererProps): React$1.ReactElement;
+declare function DateInput(props: FieldInputProps): React$1.ReactElement;
 //#endregion
 //#region src/fields/enum.d.ts
 declare function EnumDisplay({ value, options, field, resource }: FieldRendererProps): React$1.ReactElement;
-declare function EnumInput({ name, id, value, onChange, testid, options, field, placeholder, disabled, required, ariaInvalid, ariaDescribedBy, ariaErrorMessage, resource }: FieldInputProps): React$1.ReactElement;
+/**
+ * The options-driven enum input: a field with inline options, or one bound to
+ * an enum only through `meta.enumNamespace`. Renders the control the field
+ * asks for (`ui.control`), else the bound enum's `control`, else a select; the
+ * non-select controls are the shared `EnumChoiceGroup`. When the field is bound
+ * to an enum namespace, each value's summary is read the way `EnumPicker` reads
+ * it (`enum/<ns>/<value>`), so one enum looks the same however its field is
+ * bound; a truly inline enum has no value docs and shows labels only.
+ */
+declare function EnumInput({ name, id, value, onChange, testid, options, field, placeholder, disabled, required, ariaInvalid, ariaDescribedBy, ariaErrorMessage, ariaLabelledBy, resource }: FieldInputProps): React$1.ReactElement;
 //#endregion
 //#region src/fields/textarea.d.ts
-declare function TextareaDisplay({ value }: FieldRendererProps): React$1.ReactElement;
+declare function TextareaDisplay({ value, text: formatted }: FieldRendererProps): React$1.ReactElement;
 declare function TextareaInput({ name, id, value, onChange, testid, placeholder, disabled, required, ariaInvalid, ariaDescribedBy, ariaErrorMessage, className, onKeyDown, minLength, maxLength }: FieldInputProps & {
   className?: string;
   onKeyDown?: React$1.KeyboardEventHandler<HTMLTextAreaElement>;
@@ -1984,9 +2036,9 @@ declare function RelationDisplay({ value, field }: FieldRendererProps): React$1.
  * `RelationDisplay` above), so this wrapper just shapes that `meta` object;
  * `field.name` is set to `''` since standalone usage has no owning field.
  */
-declare function RelationField({ to, value }: {
+declare function RelationField<const N extends string = string>({ to: toInput, value }: {
   /** Target resource name (matches `f.relation({ to: '...' })`). */
-  to: string;
+  to: ResourceNameOrRef<N>;
   /** FK value to resolve, or null/undefined/'' when empty. */
   value: unknown;
 }): React$1.ReactElement;
@@ -2049,9 +2101,9 @@ type CandidatesGate = {
  *  - target row for `value` not found → trigger shows the raw id
  *    (so the operator can at least see what was stored).
  */
-interface RelationPickerProps {
+interface RelationPickerProps<N extends string = string> {
   /** Target resource name (matches `f.relation({ to: '...' })`). */
-  to: string;
+  to: ResourceNameOrRef<N>;
   /** Currently-selected FK value, or null/undefined when empty. */
   value: string | number | null | undefined;
   /** Called with the new selected id (or `by` value), or null when cleared. */
@@ -2129,7 +2181,7 @@ interface RelationPickerProps {
   /** Forwarded to the trigger button as `aria-errormessage` (WAI-ARIA 1.2). */
   ariaErrorMessage?: string;
 }
-declare function RelationPicker({ to, value, onChange, by, searchField, pageSize, clearable, placeholder, name, id, testid, fixedFilters, createSeeds, candidatesGate, rowFits, fieldName, open: openMode, scope, disabled, required, className, ariaInvalid, ariaDescribedBy, ariaErrorMessage }: RelationPickerProps): React$1.ReactElement;
+declare function RelationPicker<const N extends string = string>({ to: toInput, value, onChange, by, searchField, pageSize, clearable, placeholder, name, id, testid, fixedFilters, createSeeds, candidatesGate, rowFits, fieldName, open: openMode, scope, disabled, required, className, ariaInvalid, ariaDescribedBy, ariaErrorMessage }: RelationPickerProps<N>): React$1.ReactElement;
 /**
  * Form-field adapter wrapping `<RelationPicker>` for use as a default
  * Input renderer in the field registry. Reads `field.meta.to` for the
@@ -2164,8 +2216,8 @@ interface SelectCreate {
  * #9 — compact, and the table area is a FIXED height so paging never resizes /
  * jumps the dialog; responsive down to mobile.
  */
-interface RelationPickerDialogProps {
-  to: string;
+interface RelationPickerDialogProps<N extends string = string> {
+  to: ResourceNameOrRef<N>;
   open: boolean;
   onOpenChange: (open: boolean) => void;
   onSelect: (value: string | number) => void;
@@ -2188,8 +2240,8 @@ interface RelationPickerDialogProps {
    */
   searchField?: string;
   /**
-   * Which field of the chosen row `onSelect` returns. Defaults to `id` (a normal
-   * FK relation). Set to another column (e.g. `gtin`) for "relate by a non-id
+   * Which field of the chosen row `onSelect` returns. Defaults to the target's id
+   * field (`data.idField`, else `id`: a normal FK relation). Set to another column (e.g. `gtin`) for "relate by a non-id
    * value" pickers — the core mechanic behind the playground GTIN field.
    */
   valueField?: string;
@@ -2241,18 +2293,34 @@ interface RelationPickerDialogProps {
    * dialog with `onOpenChange(false)`, so a confirm and a dismissal can be told apart.
    */
   onDone?: () => void;
+  /**
+   * Asked once per shown page with the keys of its rows: rows whose key is in the resolved set
+   * are drawn checked and disabled (a link panel's already-linked targets). Until it answers the
+   * page's rows cannot be picked and the footer says the rows are being checked; when it fails
+   * none of them can, and the footer says so with a Retry.
+   */
+  disabledKeys?: (keys: readonly (string | number)[], signal: AbortSignal) => Promise<ReadonlySet<string>>;
+  /**
+   * With `disabledKeys`: the footer's note for the page's disabled rows, given how many there
+   * are (the caller says what they are, "3 already linked"). Absent: no note.
+   */
+  disabledLabel?: (count: number) => React$1.ReactNode;
 }
-declare function RelationPickerDialog({ to, open, onOpenChange, onSelect, onSelectRow, searchField, valueField, fixedFilters, scope, scopeField, create, createSeeds, fieldName, onBeforeCreate, pageSize, multiple, selected, onToggle, onDone }: RelationPickerDialogProps): React$1.ReactElement;
 //#endregion
 //#region src/fields/lazy-relation-picker-dialog.d.ts
 /** The "Advanced search" dialog, loaded on the first open: nothing is drawn until it arrives. */
-declare function LazyRelationPickerDialog(props: ComponentProps<typeof RelationPickerDialog>): ReactElement;
+declare function LazyRelationPickerDialog<const N extends string = string>(props: RelationPickerDialogProps<N>): ReactElement;
 //#endregion
 //#region src/fields/use-relation-picker.d.ts
 type AnyResourceHandle = ResourceHandle<any, any, any, any>;
-type FieldNamesOf<R> = R extends ResourceHandle<any, infer F, any, any> ? keyof F & string : string;
-type UseRelationPickerOptions<R extends AnyResourceHandle | string, TSelect extends FieldNamesOf<R>> = ({
-  readonly to: R;
+type FieldNamesOf<R> = R extends ResourceHandle<any, infer F, any, any> ? keyof F & string : R extends string ? FieldNamesOf<ResourceHandleOf<R>> : string;
+type UseRelationPickerOptions<R extends AnyResourceHandle | string | EntityRef, TSelect extends FieldNamesOf<R>> =
+/**
+ * The target: its handle, its name (checked against the registered resources, and typing
+ * `select` by the registered fields) or its entity ref.
+ */
+({
+  readonly to: ResourceRefArg<R>;
   readonly field?: never;
 } |
 /** A relation field of the surrounding record (`useOptionalRecordFrame()`): `to`, `by` and `candidates` come from its declaration. */
@@ -2274,6 +2342,10 @@ type UseRelationPickerOptions<R extends AnyResourceHandle | string, TSelect exte
   };
   /** Default 'context'. */
   readonly scope?: ScopeSource;
+  /** Rows of each shown page whose key is in the resolved set are drawn checked and disabled. */
+  readonly disabledKeys?: (keys: readonly (string | number)[], signal: AbortSignal) => Promise<ReadonlySet<string>>;
+  /** With `disabledKeys`: the dialog footer's note for a page's disabled rows, given their count. */
+  readonly disabledLabel?: (count: number) => React$1.ReactNode;
 };
 type RelationPickerRow<TSelect extends string> = { readonly [K in TSelect]?: unknown; } & {
   readonly id?: unknown;
@@ -2325,7 +2397,7 @@ interface RelationPickerHandle<TRow> {
  * `element` once, anywhere in the caller's tree; an `open()` while it is not rendered settles
  * `not-mounted`.
  */
-declare function useRelationPicker<R extends AnyResourceHandle | string, TSelect extends FieldNamesOf<R> = FieldNamesOf<R>>(options: UseRelationPickerOptions<R, TSelect>): RelationPickerHandle<RelationPickerRow<TSelect>>;
+declare function useRelationPicker<R extends AnyResourceHandle | string | EntityRef, TSelect extends FieldNamesOf<R> = FieldNamesOf<R>>(options: UseRelationPickerOptions<R, TSelect>): RelationPickerHandle<RelationPickerRow<TSelect>>;
 //#endregion
 //#region src/fields/use-dialog-filter-state.d.ts
 /** The portable erased AST — the only shape this module deals in. */
@@ -2391,7 +2463,7 @@ interface DialogFilterState {
  * screen real estate for a couple of always-visible facets); a modal has no
  * spare real estate to spend on them.
  */
-declare function useDialogFilterState(resource: string, options: UseDialogFilterStateOptions): DialogFilterState;
+declare function useDialogFilterState<const N extends string = string>(resourceInput: ResourceNameOrRef<N>, options: UseDialogFilterStateOptions): DialogFilterState;
 //#endregion
 //#region src/fields/file-display.d.ts
 interface FileFieldProps extends FieldRendererProps {
@@ -2460,7 +2532,6 @@ type FieldLike = LegacyFieldLike & {
   readonly ui?: object;
   readonly options?: FieldDeclaration['options'];
   readonly required?: boolean;
-  readonly codec?: unknown;
 };
 interface ResolvedFieldDisplayProps {
   readonly resource: EntityRef;
@@ -2477,8 +2548,18 @@ interface ResolvedFieldDisplayProps {
    * `form`, so a field P5 withholds stays pending in a `meta` ref as it does everywhere else.
    */
   readonly metaSources?: ScreenSources;
+  /**
+   * The surface the display is drawn on (REF-117 §4.13): `'display'` (the default) for record
+   * screens, `'column'` for a table cell, `'card'` for the default card item. Its layers select
+   * the implementation, its params and its transform.
+   */
+  readonly uiSurface?: Exclude<UiSurface, 'input'>;
+  /** A table cell's list entry, the last layer of the `column` surface. */
+  readonly columnEntry?: {
+    readonly display?: unknown;
+  };
 }
-interface ResolvedFieldInputProps extends Omit<ResolvedFieldDisplayProps, 'fallback'> {
+interface ResolvedFieldInputProps extends Omit<ResolvedFieldDisplayProps, 'fallback' | 'uiSurface' | 'columnEntry'> {
   readonly inputId?: string;
   readonly onChange: (value: unknown) => void;
   /** Live form values, distinct from the edit record baseline. */
@@ -2488,6 +2569,12 @@ interface ResolvedFieldInputProps extends Omit<ResolvedFieldDisplayProps, 'fallb
   readonly required?: boolean;
   readonly placeholder?: string;
   readonly descriptionId?: string;
+  /**
+   * Id of the label the surface renders for this field. A control that a
+   * `<label for>` cannot name (an enum's radio group) uses it as its
+   * `aria-labelledby`.
+   */
+  readonly labelId?: string;
   readonly errorId?: string;
   readonly errorMessage?: string | null;
   /** Current lifecycle state from the enclosing form. */
@@ -2507,6 +2594,8 @@ interface ResolvedFieldInputProps extends Omit<ResolvedFieldDisplayProps, 'fallb
    * Never read from `field.meta`, which a layer can write.
    */
   readonly fixedFilters?: readonly FixedFilterInput[];
+  /** An inline link field's rights, hidden keys and load state, from the form controller. */
+  readonly link?: FieldLinkState;
   readonly fallback: ReactNode;
 }
 //#endregion
@@ -2549,7 +2638,7 @@ type FieldProps = Omit<ResolvedFieldInputProps, 'resource' | 'fallback'> & {
  * wired to the field's value/onChange/disabled state.
  */
 declare function Field({ resource, i18nPrefix, fallback, fixedFilters, field, doc, ...rest }: FieldProps): ReactElement;
-type FieldDisplayProps = Omit<ResolvedFieldDisplayProps, 'resource' | 'fallback'> & {
+type FieldDisplayProps = Omit<ResolvedFieldDisplayProps, 'resource' | 'fallback' | 'uiSurface' | 'columnEntry'> & {
   readonly resource?: EntityRef;
   readonly i18nPrefix?: string;
   readonly fallback?: ReactNode;
@@ -2558,7 +2647,8 @@ type FieldDisplayProps = Omit<ResolvedFieldDisplayProps, 'resource' | 'fallback'
  * Public, resource-independent single-field display brick over
  * `ResolvedFieldDisplay`. See {@link Field} for the `resource`/`i18nPrefix`
  * resolution rule. `fallback` defaults to a `<span>` rendering the value, or
- * an em dash when the value is empty.
+ * an em dash when the value is empty. It draws the record screens' `display`
+ * surface, with the field's copy action and overflow around it (REF-117 P8).
  */
 declare function FieldDisplay({ resource, i18nPrefix, fallback, value, ...rest }: FieldDisplayProps): ReactElement;
 //#endregion
@@ -2701,10 +2791,10 @@ interface DeclarativeDisplayProps<F extends ResourceFieldMap = ResourceFieldMap>
 declare function DeclarativeDisplay<F extends ResourceFieldMap = ResourceFieldMap>(props: DeclarativeDisplayProps<F>): ReactElement;
 //#endregion
 //#region src/export/export-dialog.d.ts
-interface ExportDialogProps {
+interface ExportDialogProps<N extends string = string> {
   readonly open: boolean;
   readonly onOpenChange: (open: boolean) => void;
-  readonly resource: string;
+  readonly resource: ResourceNameOrRef<N>;
   readonly target: ExportTarget;
   /**
    * The list's currently visible columns — what "as in table" (the default) sends as `request.columns`.
@@ -2733,7 +2823,7 @@ interface ExportDialogProps {
  * menu-held dialog, deleted in P4) — this dialog
  * never repeats that shape.
  */
-declare function ExportDialog({ open, onOpenChange, resource, target, visibleColumns, estimatedCount, scope }: ExportDialogProps): React$1.ReactElement;
+declare function ExportDialog<const N extends string = string>({ open, onOpenChange, resource: resourceInput, target, visibleColumns, estimatedCount, scope }: ExportDialogProps<N>): React$1.ReactElement;
 //#endregion
 //#region src/export/download.d.ts
 /**
@@ -2756,8 +2846,8 @@ declare function ExportDialog({ open, onOpenChange, resource, target, visibleCol
 declare function downloadArtifact(artifact: ExportArtifact): void;
 //#endregion
 //#region src/export/export-button.d.ts
-interface ExportButtonProps {
-  resource: string;
+interface ExportButtonProps<N extends string = string> {
+  resource: ResourceNameOrRef<N>;
   className?: string;
 }
 /**
@@ -2787,7 +2877,7 @@ interface ExportButtonProps {
  *    of any rule. `useResourceExport` already answers the existence
  *    question; `useCapability` is asked ONLY about permission.
  */
-declare function ExportButton({ resource, className }: ExportButtonProps): React$1.ReactElement | null;
+declare function ExportButton<const N extends string = string>({ resource: resourceInput, className }: ExportButtonProps<N>): React$1.ReactElement | null;
 //#endregion
 //#region src/export/run-watcher.d.ts
 /**
@@ -2816,9 +2906,12 @@ declare function ExportButton({ resource, className }: ExportButtonProps): React
 declare function useExportRunWatcher(): void;
 //#endregion
 //#region src/enum/enum-badge.d.ts
-interface EnumBadgeProps {
-  /** Name of the enum registered via `defineEnum` + `app.use(...)`. */
-  enumName: string;
+interface EnumBadgeProps<N extends string = string> {
+  /**
+   * Name of the enum registered via `defineEnum` + `app.use(...)`, checked against the
+   * registered enums, or its entity ref `{ namespace, id }` (untyped).
+   */
+  enumName: EnumNameOrRef<N>;
   /** Raw value as stored on the record. */
   value: string | null | undefined;
   /** Test-id override. Defaults to `enum-badge:<enumName>:<value>`. */
@@ -2847,12 +2940,13 @@ interface EnumBadgeProps {
  *  - Value is unknown AND no `fallback` declared → render the raw value
  *    as a plain badge (variant `outline`).
  */
-declare function EnumBadge({ enumName, value, testid, className, presentation }: EnumBadgeProps): React$1.ReactElement;
+declare function EnumBadge<const N extends string = string>({ enumName: enumInput, value, testid, className, presentation }: EnumBadgeProps<N>): React$1.ReactElement;
 //#endregion
 //#region src/enum/enum-display.d.ts
 type EnumDisplayVariant = 'badge' | 'plain' | 'icon-label';
-interface EnumDisplayProps {
-  enumName: string;
+interface EnumDisplayProps<N extends string = string> {
+  /** The enum's name, checked against the registered enums, or its entity ref `{ namespace, id }`. */
+  enumName: EnumNameOrRef<N>;
   value: string | null | undefined;
   /** Display variant. Defaults to 'badge'. */
   variant?: EnumDisplayVariant;
@@ -2873,10 +2967,9 @@ interface EnumDisplayProps {
  * every variant. Unregistered enums fall back to raw value text (logged
  * once via console.warn, dev-only).
  */
-declare function EnumDisplay$1({ enumName, value, variant, testid, className }: EnumDisplayProps): React$1.ReactElement;
+declare function EnumDisplay$1<const N extends string = string>({ enumName: enumInput, value, variant, testid, className }: EnumDisplayProps<N>): React$1.ReactElement;
 //#endregion
 //#region src/enum/enum-picker.d.ts
-type EnumPickerRenderAs = 'select' | 'radio' | 'segmented';
 /**
  * Internal sentinel used as the `value` for the "All" / clear item when
  * `clearable` is set. Radix `<SelectItem value="">` is forbidden, so we use
@@ -2884,18 +2977,23 @@ type EnumPickerRenderAs = 'select' | 'radio' | 'segmented';
  * it back to `undefined` before calling the consumer's `onChange`.
  */
 declare const ENUM_PICKER_CLEAR_SENTINEL = "__buro_clear__";
-interface EnumPickerProps {
-  enumName: string;
+interface EnumPickerProps<N extends string = string> {
+  /** The enum's name, checked against the registered enums, or its entity ref `{ namespace, id }`. */
+  enumName: EnumNameOrRef<N>;
   value: string | null | undefined;
   /**
-   * Called whenever the user picks an option. When `clearable` is true and
-   * the user picks the "All" item, `value` is `undefined` — consumers use
-   * that to clear their state. In non-clearable mode the value is always a
-   * string (one of the enum's declared values).
+   * Called whenever the user picks an option. `value` is `undefined` when
+   * the user picks the select's "All" item (`clearable`) or the "None"
+   * option of a non-required `cards` / `radio` / `segmented` control —
+   * consumers use that to clear their state. Otherwise it is one of the
+   * enum's declared values.
    */
   onChange: (value: string | undefined) => void;
-  /** Picker render mode. Defaults to `'select'`. */
-  renderAs?: EnumPickerRenderAs;
+  /**
+   * The control that renders the values. Defaults to `'select'`. `cards`,
+   * `radio` and `segmented` offer a "None" option first unless `required`.
+   */
+  control?: EnumControl;
   /** HTML name attribute (form integration). */
   name?: string;
   /** HTML id attribute. */
@@ -2912,6 +3010,12 @@ interface EnumPickerProps {
   ariaDescribedBy?: string;
   /** Current field-error element id, valid only while ariaInvalid is true. */
   ariaErrorMessage?: string;
+  /**
+   * Id of the field's label. Names the `cards` / `radio` / `segmented` group
+   * (`aria-labelledby`), which a `<label for>` cannot. The select trigger is a
+   * labelable button and keeps its name from the label's `for`.
+   */
+  ariaLabelledBy?: string;
   className?: string;
   /**
    * When `true`, prepend an "All" item (label customizable via
@@ -2920,33 +3024,26 @@ interface EnumPickerProps {
    * valid state. Defaults to `false` so existing form-input call sites
    * (where the value is required) keep their old behavior.
    *
-   * Currently only honored in `select` mode — the radio/segmented modes
-   * don't yet need a clear affordance.
+   * Only honored by the `select` control. The other controls clear through
+   * their "None" option, shown whenever `required` is not set.
    */
   clearable?: boolean;
   /** Label for the clear item. Defaults to "All". */
   clearLabel?: string;
 }
 /**
- * Single picker primitive that renders enum values as a Select (default),
- * RadioGroup (`renderAs='radio'`), or segmented control (`renderAs='segmented'`).
+ * Single picker primitive that renders enum values with one of the
+ * `EnumControl`s: a Select (default), bordered cards (`control='cards'`), a
+ * compact radio list (`control='radio'`), or a segmented control
+ * (`control='segmented'`). The three non-select controls are the shared
+ * `EnumChoiceGroup`; this component only resolves the options (label, icon,
+ * value summary) from the registered enum.
  *
  * Falls back to a disabled placeholder when the enum is not registered —
  * matches the EnumBadge fallback policy: a half-shipped enum should not
  * crash the form.
- *
- * The radio mode uses native HTML `<input type="radio">` rather than
- * pulling `@radix-ui/react-radio-group` into the bundle: the playground
- * doesn't need keyboard-focus arrow-key navigation in v1, and the dep
- * footprint is real (~6kB gzipped). If a future fire needs the richer
- * keyboard semantics, swap the `<input>` markup for the radix primitive
- * — the props API stays the same.
- *
- * Segmented mode renders a row of buttons styled like the Tabs primitive
- * but acts as a single-select control (one button is `aria-pressed=true`
- * at a time).
  */
-declare function EnumPicker({ enumName, value, onChange, renderAs, name, id, testid, placeholder, disabled, required, ariaInvalid, ariaDescribedBy, ariaErrorMessage, className, clearable, clearLabel }: EnumPickerProps): React$1.ReactElement;
+declare function EnumPicker<const N extends string = string>({ enumName: enumInput, value, onChange, control, name, id, testid, placeholder, disabled, required, ariaInvalid, ariaDescribedBy, ariaErrorMessage, ariaLabelledBy, className, clearable, clearLabel }: EnumPickerProps<N>): React$1.ReactElement;
 //#endregion
 //#region src/primitives/button.d.ts
 declare const buttonVariants: (props?: ({
@@ -2959,8 +3056,9 @@ interface ButtonProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement>, V
 declare const Button: React$1.ForwardRefExoticComponent<ButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
 //#endregion
 //#region src/actions/action-button.d.ts
-interface ActionButtonProps {
-  resource: string;
+interface ActionButtonProps<N extends string = string> {
+  /** A name checked against the registered resources, or the entity ref. */
+  resource: ResourceNameOrRef<N>;
   actionName: string;
   record?: {
     id: string;
@@ -3009,6 +3107,16 @@ interface ActionButtonProps {
    * Destructive actions get destructive item styling.
    */
   asMenuItem?: boolean;
+  /**
+   * The sources of the screen the button is drawn on (a record screen's header or frame:
+   * `FormController.sources`), which the action's `when` reads before its own `record`, `scope`,
+   * `user` and `route` (T4 D9 part 4: the screen's win where both have one, except `record`,
+   * which stays the action's own unprojected row; the action's fill the rest). The screen loads
+   * what its item actions' `when`s read (its show and edit demand them), never waiting on it. Absent in
+   * a record's menu: a `when` there reads the action's own four only, and a ref to any other
+   * source leaves it undecided, which hides the action.
+   */
+  sources?: ScreenSources;
 }
 /**
  * A denial the rule asked to SHOW.
@@ -3031,7 +3139,7 @@ interface ActionButtonProps {
  * toast-on-click behaviour, and copying it into app code would fork the one
  * place accessibility for a denied action is decided.
  */
-interface DisabledActionProps {
+interface DisabledActionProps<N extends string = string> {
   reason?: string;
   label: React.ReactNode;
   icon?: string;
@@ -3046,7 +3154,7 @@ interface DisabledActionProps {
    * same way the record form's field-lock reason is scoped, so a resource can
    * override the generic wording via `resources.<res>.<key>`.
    */
-  resource?: string;
+  resource?: ResourceNameOrRef<N>;
   /**
    * Density for the STANDALONE control (ignored for `asMenuItem`, which is
    * always icon + label). Defaults to `'regular'`, so every caller that
@@ -3065,12 +3173,12 @@ interface DisabledActionProps {
   /** Surface name, for the same no-icon warning key `resolveControlChrome` keys on. */
   surface?: string;
 }
-declare function DisabledAction({ reason, label, icon, testid, size, variant, className, asMenuItem, resource, density, actionName, surface }: DisabledActionProps): React.ReactElement;
-declare function ActionButton(props: ActionButtonProps): React.ReactElement | null;
+declare function DisabledAction<const N extends string = string>({ reason, label, icon, testid, size, variant, className, asMenuItem, resource: resourceInput, density, actionName, surface }: DisabledActionProps<N>): React.ReactElement;
+declare function ActionButton<const N extends string = string>(input: ActionButtonProps<N>): React.ReactElement | null;
 //#endregion
 //#region src/actions/action-overflow.d.ts
-interface ActionOverflowProps {
-  resource: string;
+interface ActionOverflowProps<N extends string = string> {
+  resource: ResourceNameOrRef<N>;
   record: {
     id: string;
   } & Record<string, unknown>;
@@ -3091,6 +3199,14 @@ interface ActionOverflowProps {
    * control wide. Default: {@link RowActionsCollapseContext}.
    */
   collapse?: boolean;
+  /**
+   * The sources of the screen the actions are drawn on (a record screen's header or frame:
+   * `FormController.sources`): an action's `when` reads them besides `record` (T4 D9 part 4). The
+   * screen loads what its item actions' `when`s read (its show and edit demand them), so a `with`
+   * source no node reads still decides here. Absent in a record's menu (a row, an overlay's item
+   * menu): a `when` there reads `record` only, and a ref to any other source hides the action.
+   */
+  sources?: ScreenSources;
 }
 /**
  * Collapses an entity's actions into an overflow menu so tables and detail
@@ -3109,7 +3225,7 @@ interface ActionOverflowProps {
  * `ghost` used to strip a destructive standalone action of its destructive
  * look.
  */
-declare function ActionOverflow({ resource, record, surface, className, hideFlows, collapse }: ActionOverflowProps): React.ReactElement | null;
+declare function ActionOverflow<const N extends string = string>({ resource: resourceInput, record, surface, className, hideFlows, collapse, sources }: ActionOverflowProps<N>): React.ReactElement | null;
 //#endregion
 //#region src/actions/action-surface.d.ts
 /**
@@ -3126,8 +3242,8 @@ type ActionSurface = 'row' | 'show' | 'edit' | 'list';
 type BulkRecord = {
   id: string;
 } & Record<string, unknown>;
-interface BulkActionToolbarProps<TRecord extends BulkRecord = BulkRecord> {
-  resource: string;
+interface BulkActionToolbarProps<TRecord extends BulkRecord = BulkRecord, N extends string = string> {
+  resource: ResourceNameOrRef<N>;
   /**
    * TanStack table instance from the surrounding `<ResourceList>`. Used only
    * as a FALLBACK, for standalone call sites that have no accumulated set of
@@ -3171,12 +3287,18 @@ interface BulkActionToolbarProps<TRecord extends BulkRecord = BulkRecord> {
   visibleColumns?: readonly string[];
   /** How the built-in bulk Export reads the resource: the scope of the list the ids came from. */
   scope?: ScopeSource;
+  /**
+   * The bar's controls in place of the resource's bulk actions and the built-in Export (a link
+   * panel's Detach). The count and Clear stay.
+   */
+  actions?: React.ReactNode;
 }
-declare function BulkActionToolbar<TRecord extends BulkRecord = BulkRecord>({ resource, table, selectedRecords, selectedIds, onClearSelection, onSelectionChange, className, visibleColumns, scope }: BulkActionToolbarProps<TRecord>): React.ReactElement | null;
+declare function BulkActionToolbar<TRecord extends BulkRecord = BulkRecord, const N extends string = string>({ resource: resourceInput, table, selectedRecords, selectedIds, onClearSelection, onSelectionChange, className, visibleColumns, scope, actions }: BulkActionToolbarProps<TRecord, N>): React.ReactElement | null;
 //#endregion
 //#region src/flows/flow-action-button.d.ts
-interface FlowActionButtonProps {
-  readonly resource: string;
+interface FlowActionButtonProps<N extends string = string> {
+  /** A name checked against the registered resources, or the entity ref. */
+  readonly resource: ResourceNameOrRef<N>;
   /** The flow's name in the resource's `actions`. */
   readonly actionName: string;
   readonly record?: {
@@ -3199,7 +3321,7 @@ interface FlowActionButtonProps {
  * sources load then: until it has decided, the control is busy and a second click does nothing,
  * so one click sends at most once.
  */
-declare function FlowActionButton(props: FlowActionButtonProps): ReactElement | null;
+declare function FlowActionButton<const N extends string = string>(input: FlowActionButtonProps<N>): ReactElement | null;
 //#endregion
 //#region src/flows/app-flow-button.d.ts
 interface AppFlowButtonProps {
@@ -3251,6 +3373,11 @@ interface CheckConfirmDialogProps {
    * the old dialog's `confirmLabel` did.
    */
   readonly proceedLabel?: ReactNode;
+  /**
+   * Overrides the neutral `checks.back` label on the cancelling button: a flow's own `dismiss`
+   * ("Keep the order"), the word every cancel button of that flow says.
+   */
+  readonly cancelLabel?: ReactNode;
   /**
    * `'destructive'` styles the confirming button destructively — restoring
    * what `action.variant === 'destructive'` used to produce. Default
@@ -3271,7 +3398,7 @@ interface CheckConfirmDialogProps {
  * is removed here too so a blocked user is never offered a button that does
  * nothing.
  */
-declare function CheckConfirmDialog({ state, testid, onAnchorFocus, title, proceedLabel, tone }: CheckConfirmDialogProps): ReactElement;
+declare function CheckConfirmDialog({ state, testid, onAnchorFocus, title, proceedLabel, cancelLabel, tone }: CheckConfirmDialogProps): ReactElement;
 //#endregion
 //#region src/data-table/use-buro-data-table.d.ts
 /**
@@ -3508,9 +3635,26 @@ interface FacetedFilterOption {
   icon?: React.ComponentType<{
     className?: string;
   }>;
+  /** Optional secondary line drawn under the label (an option filter's `doc.summary`). */
+  summary?: string;
 }
-interface DataTableFacetedFilterProps<TData, TValue> {
-  column: Column<TData, TValue>;
+/**
+ * The column-free multi-select under {@link DataTableFacetedFilter}: the selection is a plain
+ * list of option values the caller owns. Anything that is not a table column mounts it directly:
+ * an option filter of a list (T4 D3) drives it from `filters.presets`, a scope dimension picker
+ * from the dimension's selection.
+ */
+interface FacetedFilterPickerProps {
+  /** The selected option values. */
+  selected: readonly string[];
+  /** Called with the whole next selection (empty for Clear or the last deselect). */
+  onChange: (next: string[]) => void;
+  /** A hint for the control: the trigger's tooltip and a line at the top of the popover. */
+  hint?: string;
+  /** Shown beside the title while nothing is selected, e.g. "All". */
+  emptyLabel?: string;
+  /** Whether the footer offers to clear the selection. Default `true`. */
+  clearable?: boolean;
   title: string;
   options?: FacetedFilterOption[];
   /**
@@ -3538,11 +3682,20 @@ interface DataTableFacetedFilterProps<TData, TValue> {
    *   'search'  → the cmdk search input
    *   'option'  → option item (value passed as second arg)
    *   'clear'   → the Clear-filters footer item
+   *   'hint'    → the hint line at the top of the popover
    */
-  getTestId?: (role: 'trigger' | 'option' | 'clear' | 'search', value?: string) => string | undefined;
+  getTestId?: (role: 'trigger' | 'option' | 'clear' | 'search' | 'hint', value?: string) => string | undefined;
   className?: string;
 }
-declare function DataTableFacetedFilter<TData, TValue>({ column, title, options, loadOptions, selectedLabelFor, searchPlaceholder, emptyText, getTestId, className }: DataTableFacetedFilterProps<TData, TValue>): React.ReactElement;
+interface DataTableFacetedFilterProps<TData, TValue> extends Omit<FacetedFilterPickerProps, 'selected' | 'onChange' | 'hint' | 'getTestId'> {
+  column: Column<TData, TValue>;
+  /** As `FacetedFilterPickerProps.getTestId`, without `'hint'`: a column filter has no hint. */
+  getTestId?: (role: 'trigger' | 'option' | 'clear' | 'search', value?: string) => string | undefined;
+}
+/** A faceted filter bound to a TanStack column: the column's filter value is the selection. */
+declare function DataTableFacetedFilter<TData, TValue>({ column, getTestId, ...rest }: DataTableFacetedFilterProps<TData, TValue>): React.ReactElement;
+/** The picker behind `DataTableFacetedFilter`, controlled by a plain selection. */
+declare function FacetedFilterPicker({ title, options, loadOptions, selectedLabelFor, searchPlaceholder, emptyText, getTestId, className, selected: selectedList, onChange, hint, emptyLabel, clearable }: FacetedFilterPickerProps): React.ReactElement;
 //#endregion
 //#region src/data-table/data-table-text-filter.d.ts
 /**
@@ -3694,7 +3847,7 @@ interface DataTableOperatorFilterProps<TData, TValue> {
  * an adopter can override per-locale via composition rather than
  * patching this file.
  */
-declare function formatOperatorLabel(op: FilterOperator, t?: (key: string, opts?: {
+declare function formatOperatorLabel(op: FilterOperator, chromeT?: (key: string, opts?: {
   defaultValue?: string;
 }) => string): string;
 declare function DataTableOperatorFilter<TData, TValue>({ column, operators, defaultOperator, valueKind, getTestId, className }: DataTableOperatorFilterProps<TData, TValue>): React.ReactElement;
@@ -3906,20 +4059,14 @@ declare function DataTableToolbar<TData>({ table, searchColumnId, searchPlacehol
  * once per character. Re-syncs from the external `value` when it changes
  * (deep-link / saved view / clear-all).
  */
-declare function ListSearchInput({ resource, label, value, onCommit, placeholder }: {
-  resource: string;
-  label: string;
+declare function ListSearchInput<const N extends string = string>({ resource: resourceInput, value, onCommit, placeholder }: {
+  resource: ResourceNameOrRef<N>;
   value: string;
   onCommit: (next: string) => void;
   /**
-   * Override the placeholder. The default falls back to `toolbar.searchBy`
-   * ("Search by {name}…") fed by `label` — a plain per-field template that
-   * promises nothing about HOW the query is matched. Every host in this
-   * repo passes an explicit `placeholder` instead of relying on this
-   * default: `<ResourceListPage>` distinguishes a declarative
-   * `views.list.search` (names its first field) from a resolver (generic
-   * `list.search` label, since the framework cannot know what a resolver
-   * matches), and a `related-list` placement names its own search field.
+   * Override the placeholder. The default is the kit's `list.search` ("Search"):
+   * a plain word that promises nothing about HOW the query is matched and
+   * names no field, because the framework cannot know what the search matches.
    */
   placeholder?: string;
 }): import("react/jsx-runtime").JSX.Element;
@@ -3954,8 +4101,8 @@ declare function ListSearchInput({ resource, label, value, onCommit, placeholder
  * label "Columns" with no icon, popover `align="start" w-64 p-2`
  * with no header.
  */
-declare function ColumnsToggle({ resource, def, allAvailable, required, visibleColumns, defaultVisible, onChange, onResetSizes, onRestoreDefaults }: {
-  resource: string;
+declare function ColumnsToggle<const N extends string = string>({ resource: resourceInput, def, allAvailable, required, visibleColumns, defaultVisible, onChange, onResetSizes, onRestoreDefaults }: {
+  resource: ResourceNameOrRef<N>;
   def: ResourceDef;
   allAvailable: string[];
   required: string[];
@@ -4004,8 +4151,8 @@ declare const ListSavedViews: () => ReactElement | null;
 type RowRecord$1 = {
   id: string;
 } & Record<string, unknown>;
-interface ResourceListProps {
-  resource: string;
+interface ResourceListProps<N extends string = string> {
+  resource: ResourceNameOrRef<N>;
   data?: RowRecord$1[];
   total?: number;
   page?: number;
@@ -4059,9 +4206,11 @@ interface ResourceListProps {
   selectable?: boolean;
   /**
    * The row-actions column (each row's item actions). `false` draws none: a read-only list
-   * offers nothing to do with a row but open it.
+   * offers nothing to do with a row but open it. A function draws its own controls in the column
+   * instead of the item actions (a link panel's Detach); keep its identity stable, the columns
+   * are rebuilt when it changes.
    */
-  rowActions?: boolean;
+  rowActions?: boolean | ((row: RowRecord$1) => React.ReactNode);
   /**
    * Accumulating selection owned by the caller. When provided the component
    * is CONTROLLED: this is the WHOLE selected set (ids that are not on the
@@ -4099,7 +4248,12 @@ interface ResourceListProps {
   createHref?: string;
   /** Whether the list is currently filtered (changes empty-state copy). */
   isFiltered?: boolean;
-  /** Called when the user clicks the "Clear filter" link in the filtered-empty state. */
+  /**
+   * Called when the user clicks the "Clear filter" button in the empty state. The button is drawn
+   * exactly when this is given: the caller decides whether there is anything to reset (a list
+   * that starts filtered has rows narrowed and nothing to reset). `isFiltered` only picks the
+   * wording.
+   */
   onClearFilter?: () => void;
   /**
    * Replacement for the "no rows" rendering, forwarded to
@@ -4178,6 +4332,13 @@ interface ResourceListProps {
    * honour an explicit direction and fall back to toggling when it's undefined.
    */
   onSort?: (field: string, direction?: 'asc' | 'desc' | null) => void;
+  /**
+   * Whether a column offers sort (T4 D7). The list kit passes the controller's
+   * `sorting.sortable`; when omitted, core's `isColumnSortable` decides — nothing sorts by
+   * default, a field's `sort` or the app's `lists.sortable` turns a column on, and a link never
+   * sorts. A column offers sort only when this says yes AND `onSort` is supplied.
+   */
+  sortable?: (column: string) => boolean;
   /**
    * Hide a column from a column-header menu. Receives the column name; the
    * parent removes it from the visible-columns list. When omitted, the header
@@ -4207,6 +4368,24 @@ interface ResourceListProps {
    * `views.list.optionalColumns` / `requiredColumns`).
    */
   columns?: string[];
+  /**
+   * Each data column's resolved presentation by name (REF-117 §4.9, P10): its width (`default`,
+   * `min`, `max`), whether it resizes, its alignment, and its cell display (implementation,
+   * params, transform, overflow). The list controller's `columns.ui`, which `ListBody` passes.
+   * A column it does not cover, or every column when it is omitted (a standalone mount),
+   * resolves here with core's `resolveColumnUi` over its field and its `views.list` entry, so
+   * a field's `ui.column` holds either way. A width is a default, not a floor: the floor is
+   * `min` (C13).
+   */
+  columnUi?: Readonly<Record<string, ResolvedColumnUi>>;
+  /**
+   * Where the user's column layout (widths, order, pinning) is stored: the list id of the
+   * `buro/table-layout` UI setting, beside the resource (REF-117 §4.10, C18). The route list passes
+   * `'route'`, a placement `<owner resource>/<placement key path>`. A list rendered by hand passes
+   * its own stable id to keep the layout across mounts; without one, the layout lasts for the mount.
+   * Nothing is stored without a `UiSettingsProvider` either.
+   */
+  layoutId?: string;
   /**
    * Optional callback that hands the parent the underlying TanStack
    * `Table` instance. Fires once after the table is mounted (and
@@ -4220,7 +4399,7 @@ interface ResourceListProps {
    */
   tableRef?: (table: Table$1<RowRecord$1> | null) => void;
 }
-declare function ResourceList({ resource, data, total, page, pageSize, onPageSize, onRequestCount, isCountingRows, pageSizeOptions, onPage, loadMore, selectable, rowActions, selectedIds, onSelectionChange, className, isLoading, error, onRetry, createHref, isFiltered, onClearFilter, emptyState, rowsView, rowHref, rowQuick, rowLinkKey, renderCell, sort, onSort, onHideColumn, requiredColumns, resetLayout, columns: columnsOverride, tableRef }: ResourceListProps): React.ReactElement;
+declare function ResourceList<const N extends string = string>({ resource: resourceInput, data, total, page, pageSize, onPageSize, onRequestCount, isCountingRows, pageSizeOptions, onPage, loadMore, selectable, rowActions, selectedIds, onSelectionChange, className, isLoading, error, onRetry, createHref, isFiltered, onClearFilter, emptyState, rowsView, rowHref, rowQuick, rowLinkKey, renderCell, sort, onSort, sortable, onHideColumn, requiredColumns, resetLayout, columns: columnsOverride, columnUi, layoutId, tableRef }: ResourceListProps<N>): React.ReactElement;
 //#endregion
 //#region src/list-kit/cursor-load-more.d.ts
 /**
@@ -4279,7 +4458,7 @@ declare function CursorLoadMore({ hasMore, loading, onMore }: CursorLoadMoreProp
 /**
  * Props of {@link ResourceListPage}.
  */
-interface ResourceListPageProps {
+interface ResourceListPageProps<N extends string = string> {
   /**
    * Registry name of the resource to list.
    *
@@ -4289,7 +4468,7 @@ interface ResourceListPageProps {
    * should 404 before mounting this component (the playground's
    * `app/(admin)/[resource]/page.tsx` does exactly that).
    */
-  resource: string;
+  resource: ResourceNameOrRef<N>;
   /**
    * Extra `meta` merged into the underlying `useList` call — and therefore
    * into the react-query cache key. This is the seam for app-level query
@@ -4314,10 +4493,10 @@ interface ResourceListPageProps {
    */
   meta?: Record<string, unknown>;
   /**
-   * App-level per-cell renderer, consulted AFTER this component's own
-   * built-in branches (typed discriminator → declared `enum` field) and
-   * BEFORE `<ResourceList>`'s default field-type display. Return
-   * `undefined` to fall through, exactly like `<ResourceList renderCell>`.
+   * App-level per-cell renderer, consulted AFTER a typed resource's
+   * discriminator badge and BEFORE the declared-`enum` badge and
+   * `<ResourceList>`'s default field-type display. Return `undefined` to
+   * fall through, exactly like `<ResourceList renderCell>`.
    *
    * The built-ins cover what the registry can describe on its own; this
    * prop is for the rest — the playground uses it for a legacy hardcoded
@@ -4391,9 +4570,10 @@ interface ResourceListPageProps {
  * covers:
  *
  * - **`list.cell.<resource>`** (level 1) is consulted for every cell, AFTER
- *   this component's own built-in branches (typed discriminator →
- *   declared `enum` field) and BEFORE `<ResourceList>`'s default field-type
- *   display — the same position the `renderCell` prop occupies, and the
+ *   a typed resource's discriminator badge and BEFORE the declared-`enum`
+ *   badge and `<ResourceList>`'s default field-type display (a field with
+ *   its own `ui.display` skips the enum badge) — the same position the
+ *   `renderCell` prop occupies, and the
  *   explicit prop wins when both are present. Everything else — filters,
  *   saved views, the columns menu, the table, pagination — stays standard.
  * - **`list.filters.<resource>`** (level 2) replaces the filter region —
@@ -4414,13 +4594,14 @@ interface ResourceListPageProps {
  *
  * @see docs/superpowers/plans/2026-07-26-cfb3-assembled-page-slots.md — Tasks B3.1, B3.2
  */
-declare function ResourceListPage({ resource, meta, renderCell, emptyState }: ResourceListPageProps): import("react/jsx-runtime").JSX.Element;
+declare function ResourceListPage<const N extends string = string>({ resource: resourceInput, meta, renderCell, emptyState }: ResourceListPageProps<N>): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/list-kit/filter-builder/filter-region.d.ts
 /**
- * The default `list.filters.<resource>` content — search box, pinned
- * controls, the builder popover trigger, applied-filter badges and a
- * "Clear all" action, left to right. Props-free: like every list slot, it
+ * The default `list.filters.<resource>` content — search box, option
+ * pickers, pinned controls, the builder popover trigger, applied-filter badges and a
+ * "Clear filters" action (shown while `filters.canReset`, which returns the list to its initial
+ * state), left to right. Props-free: like every list slot, it
  * reads the live controller from `useResourceListContext()` rather than a
  * prop chain, which is the SAME contract a registered
  * `list.filters.<resource>` slot fulfils — an adopter that wants a
@@ -4429,7 +4610,7 @@ declare function ResourceListPage({ resource, meta, renderCell, emptyState }: Re
  * exported) into its own region instead of forking this file.
  *
  * A THIN wrapper: everything that needs the list controller (the search
- * box, its placeholder, "Clear all") stays here — that's the page's
+ * box, its placeholder, "Clear filters") stays here — that's the page's
  * concern, not the builder's — and everything else (the pinned controls,
  * the panel, the badges, and the `open`/`focusPath`/`externalRemoval`
  * wiring between them) is `<FilterBuilder>`'s job, which has no controller
@@ -4458,6 +4639,13 @@ interface FilterBuilderProps {
   readonly pinnedFields?: readonly FilterFieldSpec[];
   readonly pinnedValue?: readonly Expression$2[];
   readonly setPinnedValue?: (next: readonly Expression$2[]) => void;
+  /**
+   * The list's option filters (`filters.presets`), drawn as faceted pickers before the pinned
+   * controls. Absent where there are none (the relation picker's dialog).
+   */
+  readonly presets?: readonly ListOptionFilter[];
+  /** `filters.setPreset`: it resets the page itself, so no `setPage(1)` is composed here. */
+  readonly setPreset?: (id: string, optionIds: readonly string[]) => void;
   /** Apply / a pinned write / a badge × all reset to page 1, same as every other filter mutation. */
   readonly setPage: (page: number) => void;
   readonly testIdBase: string;
@@ -4632,33 +4820,6 @@ interface FilterBadgesProps {
   readonly pinnedValue?: readonly Expression$1[];
   readonly setPinnedValue?: (next: readonly Expression$1[]) => void;
 }
-/**
- * One badge per top-level row of the APPLIED filter group, plus one per
- * `filters.fixed` entry that carries a `label`, plus one per PINNED-slot
- * expression no `pinnedFields` control claims (finding 3, see `pinnedValue`
- * above).
- *
- * Group-row badges have two very different click targets:
- *  - the × removes that row and calls `setGroup` IMMEDIATELY, bypassing the
- *    panel's draft entirely — this is a deletion, not an edit, and making
- *    the user re-open the panel and press "Apply" to confirm a removal they
- *    already committed to would be a broken expectation;
- *  - the body opens the panel with `focusPath` pointing at this row, for a
- *    user who wants to ADJUST rather than remove it. It is a real
- *    `<button>` (finding 6 of the SP2 final review — it used to be a plain
- *    `<div onClick>`, reachable and activatable only by mouse), so it picks
- *    up keyboard focus, Enter/Space activation, and a browser-native
- *    accessible name (its own text — the `describeRow` summary — same as
- *    any other button whose label IS its content) for free. It sits beside
- *    the × as a SIBLING, not a nested/overlapping hit target, so activating
- *    one never also triggers the other.
- *
- * Fixed-filter badges (labelled call-site narrowing) and orphan pinned-slot
- * badges both render with NO body affordance: fixed badges because the
- * user did not add them and cannot remove them; pinned-slot badges because
- * there is no builder row behind them to focus — only a working × to
- * remove that one expression from the pinned slot.
- */
 declare function FilterBadges(props: FilterBadgesProps): React.ReactElement;
 //#endregion
 //#region src/list-kit/filter-builder/pinned-filter-controls.d.ts
@@ -4704,6 +4865,28 @@ interface PinnedFilterControlsProps {
  */
 declare function PinnedFilterControls(props: PinnedFilterControlsProps): React.ReactElement;
 //#endregion
+//#region src/list-kit/filter-builder/preset-filter-controls.d.ts
+interface PresetFilterControlsProps {
+  /** The list's option filters (`filters.presets`). */
+  readonly presets: readonly ListOptionFilter[];
+  /**
+   * `filters.setPreset`: it writes the whole selection of one filter and resets the page to 1
+   * itself, so this component does not.
+   */
+  readonly setPreset: (id: string, optionIds: readonly string[]) => void;
+  readonly testIdBase: string;
+}
+/**
+ * One faceted multi-select per option filter (T4 D3, D4): the filter's label is the trigger, its
+ * `doc.summary` the hint, each option shows its label with its `doc.summary` under it. The
+ * trigger doubles as the chip: it lists the selected options, and deselecting the last one (or
+ * the picker's own Clear) writes an empty selection, which the URL keeps as `?<ns>.<id>=` so a
+ * reload keeps the initial option removed.
+ *
+ * Test ids: `<base>:preset:<id>:trigger | :option:<optionId> | :clear | :search | :hint`.
+ */
+declare function PresetFilterControls(props: PresetFilterControlsProps): React.ReactElement;
+//#endregion
 //#region src/list-kit/filter-builder/values/filter-value-control.d.ts
 interface FilterValueControlProps {
   readonly kind: FilterKind;
@@ -4723,7 +4906,9 @@ interface FilterValueControlProps {
    */
   readonly fieldLabel?: string;
   /**
-   * Visible hint inside a text/number box (`ScalarValueInput`). Only a caller
+   * Visible hint inside a text/number box (`ScalarValueInput`), and the empty
+   * text of a select-like trigger (enum, options, relation, boolean), whose
+   * accessible name stays "Value for <field>". Only a caller
    * that shows the control with nothing naming its field beside it passes one:
    * the pinned toolbar (`PinnedFilterControls`) gives the field's label, so a
    * pinned text filter is not an unlabelled empty box (REF-44). A builder row
@@ -4917,8 +5102,8 @@ declare function listSlot(region: ListSlotRegion, resource: string): string;
  * `'filters'` overload's contract is byte-identical to before this
  * region existed.
  */
-declare function useListSlot(region: 'cell', resource: string): ListCellRenderer | undefined;
-declare function useListSlot(region: 'filters', resource: string): ListSlot | undefined;
+declare function useListSlot<const N extends string = string>(region: 'cell', resource: ResourceNameOrRef<N>): ListCellRenderer | undefined;
+declare function useListSlot<const N extends string = string>(region: 'filters', resource: ResourceNameOrRef<N>): ListSlot | undefined;
 //#endregion
 //#region src/saved-views/saved-views-dropdown.d.ts
 /**
@@ -4965,14 +5150,14 @@ declare function useListSlot(region: 'filters', resource: string): ListSlot | un
  * dialogs, and `onDeleteEntry`/`onManage` to the delete flow / manage
  * dialog.
  */
-interface SavedViewsDropdownProps {
+interface SavedViewsDropdownProps<N extends string = string> {
   /**
    * The resource the views belong to. Declared views (`adopterViews`) read their label from
    * `resources.<resource>.savedViews.<id>` in the bundle (that resource's own entry only, never
    * `resources._` or `common`); without it they render as declared.
    * User-saved `entries` are user data and always render as written.
    */
-  resource?: string;
+  resource?: ResourceNameOrRef<N>;
   /** Adopter-defined views from `def.views.list.savedViews`. Always read-only. */
   adopterViews: SavedViewDef[];
   /** Adapter-backed entries, WITH scope/permission metadata (Task 9). */
@@ -5032,14 +5217,12 @@ interface SavedViewsDropdownProps {
   /** Popover content alignment. Default: 'start'. */
   popoverAlign?: 'start' | 'center' | 'end';
 }
-declare function SavedViewsDropdown({ resource, adopterViews, entries, issues, onApply, onSaveCurrent, canSaveCurrent, onManage, onRenameEntry, onDeleteEntry, onForkEntry, canFork, getTestId, triggerLabel, iconOnly, triggerClassName, popoverContentClassName, popoverAlign }: SavedViewsDropdownProps): React.ReactElement;
+declare function SavedViewsDropdown<const N extends string = string>({ resource: resourceInput, adopterViews, entries, issues, onApply, onSaveCurrent, canSaveCurrent, onManage, onRenameEntry, onDeleteEntry, onForkEntry, canFork, getTestId, triggerLabel, iconOnly, triggerClassName, popoverContentClassName, popoverAlign }: SavedViewsDropdownProps<N>): React.ReactElement;
 //#endregion
 //#region src/resource/list-error-state.d.ts
 interface ListErrorStateProps {
   /** Whatever the query threw. */
-  error: {
-    message?: string;
-  } | Error;
+  error: unknown;
   /** When provided, a Retry button is rendered and calls this. */
   onRetry?: () => void;
   /** Resource name, used to build the retry button's test id. */
@@ -5064,12 +5247,14 @@ interface ListErrorStateProps {
  * When Temporal was briefly down, the only recovery was reloading the page.
  *
  * A slot author should not have to re-derive an error state the framework
- * already knows how to render, so this is now shared by both. `toFriendlyError`
- * keeps the technical string out of the operator's face while leaving
- * adopter-written messages verbatim; the raw text stays reachable under
- * «Details» for whoever has to file the bug.
+ * already knows how to render, so this is now shared by both. It is the `list`
+ * surface of `<LoadError>`: the sentence is the error's own text (its code's, its
+ * message reference's), a plain-language sentence for a dead network or an
+ * unavailable service, or `list.errorBody`; an HTTP trace or a thrown message is
+ * never the sentence. The raw text stays reachable under «Details», in
+ * development, for whoever has to file the bug.
  */
-declare function ListErrorState({ error, onRetry, resource, title, className }: ListErrorStateProps): React.ReactElement;
+declare function ListErrorState(props: ListErrorStateProps): React.ReactElement;
 //#endregion
 //#region src/resource/record-display-name.d.ts
 /**
@@ -5079,9 +5264,9 @@ declare function ListErrorState({ error, onRetry, resource, title, className }:
 declare function recordDisplayName(record: Record<string, unknown>, displayField?: string): string;
 //#endregion
 //#region src/resource/page-header.d.ts
-interface PageHeaderProps {
+interface PageHeaderProps<N extends string = string> {
   /** Resource name (matches the registry key). Used for back-link target + label resolution. */
-  resource: string;
+  resource: ResourceNameOrRef<N>;
   /**
    * Page mode. Drives default title:
    *  - 'list'   → labelPlural
@@ -5146,13 +5331,13 @@ interface PageHeaderProps {
   labelOverride?: string;
   className?: string;
 }
-declare function PageHeader({ resource, mode, recordName, backHref, backLabel, actions, title, breadcrumbs, backLink, visibleTitle, labelOverride, className }: PageHeaderProps): React.ReactElement | null;
+declare function PageHeader<const N extends string = string>({ resource: resourceInput, mode, recordName, backHref, backLabel, actions, title, breadcrumbs, backLink, visibleTitle, labelOverride, className }: PageHeaderProps<N>): React.ReactElement | null;
 /**
  * The show-page `<PageHeader>`: the breadcrumb, the record's title and the resolved
  * `<ActionOverflow surface="show">` item-action list, then any `extraActions`.
  */
-declare function ShowPageHeader({ resource, record, extraActions, breadcrumbs }: {
-  resource: string;
+declare function ShowPageHeader<const N extends string = string>({ resource: resourceInput, record, extraActions, breadcrumbs }: {
+  resource: ResourceNameOrRef<N>;
   record: {
     id: string;
   } & Record<string, unknown>;
@@ -5163,8 +5348,8 @@ declare function ShowPageHeader({ resource, record, extraActions, breadcrumbs }:
  * The edit-page `<PageHeader>`: the back-link, the record's title and the resolved
  * `<ActionOverflow surface="edit">` item-action list.
  */
-declare function EditPageHeader({ resource, record, backHref, breadcrumbs }: {
-  resource: string;
+declare function EditPageHeader<const N extends string = string>({ resource: resourceInput, record, backHref, breadcrumbs }: {
+  resource: ResourceNameOrRef<N>;
   record: {
     id: string;
   } & Record<string, unknown>;
@@ -5173,9 +5358,9 @@ declare function EditPageHeader({ resource, record, backHref, breadcrumbs }: {
 }): React.ReactElement;
 //#endregion
 //#region src/resource/create-button.d.ts
-interface CreateButtonProps {
+interface CreateButtonProps<N extends string = string> {
   /** Resource this creates. Required — the button gates itself. */
-  resource: string;
+  resource: ResourceNameOrRef<N>;
   /** Target create route, e.g. `resourceCreateHref(def, resource)`. Ignored with `onOpen`. */
   href: string;
   /**
@@ -5204,14 +5389,15 @@ interface CreateButtonProps {
  * nothing for `absent`/`hidden`, a focusable `aria-disabled` control with a
  * toast reason for `disabled`, and the normal link for `available`.
  */
-declare function CreateButton({ resource, href, testid, size, variant, label, className, onOpen }: CreateButtonProps): React.ReactElement | null;
+declare function CreateButton<const N extends string = string>({ resource: resourceInput, href, testid, size, variant, label, className, onOpen }: CreateButtonProps<N>): React.ReactElement | null;
 //#endregion
 //#region src/resource/form-context.d.ts
 /**
  * Minimal form-control handle exposed to field renderers so a field can update
  * SIBLING fields (a field renderer otherwise only sees its own value). Used for
  * reactive prefills — e.g. picking a product on a GTIN field also fills the
- * «Product name» / «Code type» fields (#2). `<RecordScreen>` provides it.
+ * «Product name» / «Code type» fields (#2). Every form host provides it:
+ * `<RecordScreen>`, a flow's form and `<DeclarativeForm>`.
  */
 interface FormControl {
   /** Merge a patch of `{ fieldName: value }` into the form's live values. */
@@ -5655,8 +5841,22 @@ type SelectContentProps = React$1.ComponentPropsWithoutRef<typeof SelectPrimitiv
 declare const SelectContent: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 type SelectLabelProps = React$1.ComponentPropsWithoutRef<typeof SelectPrimitive.Label>;
 declare const SelectLabel: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectLabelProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
-type SelectItemProps = React$1.ComponentPropsWithoutRef<typeof SelectPrimitive.Item>;
-declare const SelectItem: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectItemProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+type SelectItemProps = React$1.ComponentPropsWithoutRef<typeof SelectPrimitive.Item> & {
+  /**
+   * Secondary text rendered under the label. It sits outside `ItemText` on
+   * purpose: Radix clones everything inside `ItemText` into the closed trigger,
+   * so a description placed there would be glued onto the selected value.
+   */
+  description?: React$1.ReactNode;
+};
+declare const SelectItem: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectItemProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & {
+  /**
+   * Secondary text rendered under the label. It sits outside `ItemText` on
+   * purpose: Radix clones everything inside `ItemText` into the closed trigger,
+   * so a description placed there would be glued onto the selected value.
+   */
+  description?: React$1.ReactNode;
+} & React$1.RefAttributes<HTMLDivElement>>;
 type SelectSeparatorProps = React$1.ComponentPropsWithoutRef<typeof SelectPrimitive.Separator>;
 declare const SelectSeparator: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectSeparatorProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 //#endregion
@@ -6160,14 +6360,22 @@ interface AppShellProps {
   palette?: Slot;
   /** Passed to `AppLayout`, typically `<DocPanel />`. */
   docPanel?: ReactNode;
+  /**
+   * Default `true`: `children` render inside `<NavChrome>`, the secondary sidebar and tabs of
+   * the active navigation group chain, mounted once here so it keeps its DOM node while the
+   * user moves within an area. `false` renders `children` bare, for an app that places
+   * `<NavChrome>` itself (also the way to pass it `entryFilter` or `icons`).
+   */
+  navChrome?: boolean;
   children: ReactNode;
 }
 /**
- * `AppLayout` with the default sidebar, header and command palette, and the brand and user
- * context they read. Renders inside `BuroProvider`, a `RouterAdapter` and a
- * `LinkComponentProvider`; it does not boot the runtime, own routes or guard auth.
+ * `AppLayout` with the default sidebar, header and command palette, the area chrome
+ * (`<NavChrome>`) around its children, and the brand and user context they read. Renders inside
+ * `BuroProvider`, a `RouterAdapter` and a `LinkComponentProvider`; it does not boot the runtime,
+ * own routes or guard auth.
  */
-declare function AppShell({ brand, user, loginPath, sidebar, header, palette, docPanel, children }: AppShellProps): ReactElement;
+declare function AppShell({ brand, user, loginPath, sidebar, header, palette, docPanel, navChrome, children }: AppShellProps): ReactElement;
 //#endregion
 //#region src/shell/default-command-palette.d.ts
 interface DefaultCommandPaletteProps {
@@ -6298,5 +6506,5 @@ declare function useLanguagePaletteActions(): ActionItem[];
 declare const PACKAGE_NAME: "@burojs/ui-shadcn";
 declare const PACKAGE_VERSION: "0.0.0";
 //#endregion
-export { ActionButton, type ActionButtonProps, type ActionItem, ActionOverflow, type ActionOverflowProps, type ActionSurface, AlertDialog, AlertDialogAction, AlertDialogActionProps, AlertDialogCancel, AlertDialogCancelProps, AlertDialogContent, AlertDialogContentProps, AlertDialogDescription, AlertDialogDescriptionProps, AlertDialogFooter, AlertDialogFooterProps, AlertDialogHeader, AlertDialogHeaderProps, AlertDialogOverlay, AlertDialogOverlayProps, AlertDialogPortal, AlertDialogTitle, AlertDialogTitleProps, AlertDialogTrigger, AppActions, AppFlowButton, type AppFlowButtonProps, AppHeader, type AppHeaderProps, AppLayout, type AppLayoutProps, AppShell, type AppShellProps, AppSidebar, type AppSidebarProps, AuthPage, type AuthPageProps, Avatar, AvatarFallback, AvatarImage, Badge, BadgeProps, BooleanDisplay, BooleanInput, BrandMark, Breadcrumbs, type BreadcrumbsProps, type BuildNavItemsArgs, BulkActionToolbar, type BulkActionToolbarProps, Button, ButtonProps, Card, CardContent, CardContentProps, CardDescription, CardDescriptionProps, CardFooter, CardFooterProps, CardHeader, CardHeaderProps, CardProps, CardTitle, CardTitleProps, CheckConfirmDialog, type CheckConfirmDialogProps, Checkbox, CheckboxProps, Collapsible, CollapsibleContent, CollapsibleTrigger, ColumnsToggle, Command, CommandDialog, CommandDialogProps, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandLoading, CommandLoadingProps, CommandPalette, CommandPaletteActionsGroup, type CommandPaletteActionsGroupProps, type CommandPaletteActionsTestIdRole, CommandPaletteCreateGroup, type CommandPaletteCreateGroupProps, type CommandPaletteCreateTestIdRole, CommandPaletteDocsGroup, type CommandPaletteDocsGroupProps, CommandPaletteNavigationGroups, type CommandPaletteNavigationGroupsProps, type CommandPaletteNavigationTestIdRole, type CommandPaletteProps, CommandPaletteRecentGroup, type CommandPaletteRecentGroupProps, type CommandPaletteRecentTestIdRole, CommandPaletteRecordsGroup, type CommandPaletteRecordsGroupProps, type CommandPaletteRecordsTestIdRole, type CommandPaletteTestIdRole, CommandPaletteTrigger, type CommandPaletteTriggerProps, CommandSeparator, ContextPicker, type ContextPickerProps, CopyId, CreateButton, type CreateButtonProps, CursorLoadMore, type CursorLoadMoreProps, DEFAULT_LANGUAGE_STORAGE_KEY, DataTable, DataTableDateRangeFilter, type DataTableDateRangeFilterProps, DataTableEnumFilter, type DataTableEnumFilterProps, DataTableFacetedFilter, type DataTableFacetedFilterProps, DataTableNumRangeFilter, type DataTableNumRangeFilterProps, DataTableOperatorFilter, type DataTableOperatorFilterProps, type DataTableProps, DataTableRowActions, type DataTableRowActionsProps, DataTableTextFilter, type DataTableTextFilterProps, DataTableToolbar, type DataTableToolbarProps, DataTableViewOptions, type DataTableViewOptionsProps, DateDisplay, DateInput, DeclarativeDisplay, type DeclarativeDisplayProps, DeclarativeForm, type DeclarativeFormProps, type DeclarativeFormSlots, DefaultCommandPalette, type DefaultCommandPaletteProps, Dialog, DialogClose, DialogContent, DialogContentProps, DialogDescription, DialogDescriptionProps, type DialogFilterState, DialogFooter, DialogFooterProps, DialogHeader, DialogHeaderProps, DialogOverlayProps, DialogPresentationHost, DialogPresentationShell, DialogTitle, DialogTitleProps, DialogTrigger, DisabledAction, type DisabledActionProps, DocBrowser, type DocBrowserProps, DocInfo, type DocInfoProps, DocPanel, type DocPanelProps, DocTrailHelp, type DocTrailHelpProps, DocumentTitleProvider, type DraftRemovalSignal, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ENUM_PICKER_CLEAR_SENTINEL, EditPageHeader, EnumBadge, type EnumBadgeProps, EnumDisplay, EnumInput, EnumPicker, type EnumPickerProps, type EnumPickerRenderAs, EnumDisplay$1 as EnumValueDisplay, type EnumDisplayProps as EnumValueDisplayProps, type EnumDisplayVariant as EnumValueDisplayVariant, ExportButton, type ExportButtonProps, ExportDialog, type ExportDialogProps, type FacetedFilterOption, Field, FieldDisplay, type FieldDisplayProps, type FieldProps, FileDisplay, FileField, type FileFieldProps, FileInput, type FileInputProps, FilterBadges, type FilterBadgesProps, FilterBuilder, type FilterBuilderProps, type FilterOperator, FilterPanel, type FilterPanelProps, FilterRegion, FilterValueControl, type FilterValueControlProps, FlowActionButton, type FlowActionButtonProps, Form, FormActions, FormControl, FormControlProps, FormDescription, FormDescriptionProps, FormField, FormItem, FormItemProps, FormLabel, FormLabelProps, FormMessage, FormMessageProps, HeaderBreadcrumbs, HelpButton, type HelpButtonProps, Icon, IconComponent, IconProps, Input, InputProps, Label, LabelProps, LanguageSubmenu, LanguageSwitch, type LanguageSwitchApi, type LanguageSwitchProps, type LinkComponent, type LinkComponentProps, LinkComponentProvider, type LinkComponentProviderProps, LinkKeysDisplay, ListBody, ListBulkBar, type ListCellRenderer, ListColumns, ListControls, ListCreate, ListErrorState, type ListErrorStateProps, ListExport, ListFilters, ListFlows, ListLive, ListSavedViews, ListSearchInput, type ListSlot, type ListSlotRegion, type LoginCredentials, LoginForm, type LoginFormProps, NavAreaLayout, type NavAreaLayoutProps, NavAreaPage, NavChrome, NavChromeBoundaryProvider, type NavChromeProps, type NavItem, type NavLayout, type NavLayoutProps, NavMain, type NavMainProps, type NavTreeEntry, type NavTreeLayout, type NavTreeSection, NavigationGuardDialog, NumberDisplay, NumberInput, PACKAGE_NAME, PACKAGE_VERSION, type PageBreadcrumbsProps, PageHeader, type PageHeaderProps, type PaletteState, PinnedFilterControls, type PinnedFilterControlsProps, Popover, PopoverAnchor, PopoverClose, PopoverContent, PopoverContentProps, PopoverPresentationHost, PopoverTrigger, type PresentationCopy, Progress, ProgressProps, RecordActions, RecordBreadcrumbs, RecordPage, type RecordPageProps, RecordScreen, type RecordScreenProps, RecordTitle, RefreshButton, type RefreshButtonProps, RelationDisplay, RelationField, RelationManyDisplay, RelationPicker, type RelationPickerCancelReason, LazyRelationPickerDialog as RelationPickerDialog, type RelationPickerDialogProps, type RelationPickerHandle, RelationPickerInput, type RelationPickerOpenOptions, type RelationPickerProps, type RelationPickerResult, type RelationPickerRow, type ResolvedTheme, type ResourceBreadcrumbsProps, ResourceList, ResourceListPage, type ResourceListPageProps, type ResourceListProps, ResourcePageRouter, type ResourcePageRouterProps, type RowActionDescriptor, SavedViewsDropdown, type SavedViewsDropdownProps, type ScopeOption, ScopeSwitcher, type ScopeSwitcherProps, SecondarySidebarLayout, Select, SelectContent, SelectContentProps, SelectGroup, SelectItem, SelectItemProps, SelectLabel, SelectLabelProps, SelectScrollDownButton, SelectScrollDownButtonProps, SelectScrollUpButton, SelectScrollUpButtonProps, SelectSeparator, SelectSeparatorProps, SelectTrigger, SelectTriggerProps, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetContentProps, SheetDescription, SheetDescriptionProps, SheetFooter, SheetFooterProps, SheetHeader, SheetHeaderProps, SheetOverlayProps, SheetPresentationHost, SheetPresentationShell, SheetTitle, SheetTitleProps, SheetTrigger, type ShellBrand, type ShellContextValue, ShellProvider, type ShellProviderProps, type ShellUser, type ShellUserMapper, ShowPageHeader, Sidebar, SidebarBrand, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuButtonProps, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubButtonProps, SidebarMenuSubItem, SidebarProps, SidebarProvider, SidebarProviderProps, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, type Slot, type SpacingKey, THEME_CHOICES, THEME_STORAGE_KEY, Table, TableBody, TableBodyProps, TableCaption, TableCaptionProps, TableCell, TableCellProps, TableHead, TableHeadProps, TableHeader, TableHeaderProps, TableProps, TableRow, TableRowProps, Tabs, TabsContent, TabsContentProps, TabsLayout, TabsList, TabsListProps, TabsTrigger, TabsTriggerProps, TaskRunPanel, TaskRunPanelProps, TextDisplay, TextInput, Textarea, TextareaDisplay, TextareaInput, TextareaProps, type ThemeChoice, ThemeSubmenu, ThemeToggle, Toaster, type ToasterProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TypographyKey, type UseBuroDataTableOptions, type UseDialogFilterStateOptions, type UseNavTreeOptions, type UseRelationPickerOptions, type UseThemeResult, UserMenu, type UserMenuProps, badgeVariants, buildNavItems, buroSortingToTanStack, buttonVariants, cn, defaultNavLayouts, defaultUserMapper, downloadArtifact, formatOperatorLabel, hasIcon, i18nPrefixToRef, isImage, layoutSlot, listSlot, loadLocale, localeLabel, modeForSurface, recordDisplayName, registerIcons, relationLinkClassName, resolveNavIcon, resolveUpdater, saveLocale, shadcnBlockImplementations, shadcnFieldImplementations, shadcnPresentationHosts, spacing, tanStackSortingToBuro, toast, typography, useBuroDataTable, useCurrentUser, useDialogFilterState, useDocumentTitle, useExportRunWatcher, useFormControl, useFormField, useHref, useIsMobile, useLanguagePaletteActions, useLanguageSwitch, useLayout, useLayoutResolver, useLinkComponent, useListSlot, useMatch, useNavChromeBoundary, useNavIcon, useNavTree, useNavVisible, useOptionalSidebar, usePaletteState, usePresentationCopy, useRelationPicker, useShell, useSidebar, useTheme, useThemePaletteActions, wrapperEnabled };
+export { ActionButton, type ActionButtonProps, type ActionItem, ActionOverflow, type ActionOverflowProps, type ActionSurface, AlertDialog, AlertDialogAction, AlertDialogActionProps, AlertDialogCancel, AlertDialogCancelProps, AlertDialogContent, AlertDialogContentProps, AlertDialogDescription, AlertDialogDescriptionProps, AlertDialogFooter, AlertDialogFooterProps, AlertDialogHeader, AlertDialogHeaderProps, AlertDialogOverlay, AlertDialogOverlayProps, AlertDialogPortal, AlertDialogTitle, AlertDialogTitleProps, AlertDialogTrigger, AppActions, AppFlowButton, type AppFlowButtonProps, AppHeader, type AppHeaderProps, AppLayout, type AppLayoutProps, AppShell, type AppShellProps, AppSidebar, type AppSidebarProps, AuthPage, type AuthPageProps, Avatar, AvatarFallback, AvatarImage, Badge, BadgeProps, BooleanDisplay, BooleanInput, BrandMark, Breadcrumbs, type BreadcrumbsProps, type BuildNavItemsArgs, BulkActionToolbar, type BulkActionToolbarProps, Button, ButtonProps, Card, CardContent, CardContentProps, CardDescription, CardDescriptionProps, CardFooter, CardFooterProps, CardHeader, CardHeaderProps, CardProps, CardTitle, CardTitleProps, CheckConfirmDialog, type CheckConfirmDialogProps, Checkbox, CheckboxProps, Collapsible, CollapsibleContent, CollapsibleTrigger, ColumnsToggle, Command, CommandDialog, CommandDialogProps, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandLoading, CommandLoadingProps, CommandPalette, CommandPaletteActionsGroup, type CommandPaletteActionsGroupProps, type CommandPaletteActionsTestIdRole, CommandPaletteCreateGroup, type CommandPaletteCreateGroupProps, type CommandPaletteCreateTestIdRole, CommandPaletteDocsGroup, type CommandPaletteDocsGroupProps, CommandPaletteNavigationGroups, type CommandPaletteNavigationGroupsProps, type CommandPaletteNavigationTestIdRole, type CommandPaletteProps, CommandPaletteRecentGroup, type CommandPaletteRecentGroupProps, type CommandPaletteRecentTestIdRole, CommandPaletteRecordsGroup, type CommandPaletteRecordsGroupProps, type CommandPaletteRecordsTestIdRole, type CommandPaletteTestIdRole, CommandPaletteTrigger, type CommandPaletteTriggerProps, CommandSeparator, ContextPicker, type ContextPickerProps, CopyId, CreateButton, type CreateButtonProps, CursorLoadMore, type CursorLoadMoreProps, DEFAULT_LANGUAGE_STORAGE_KEY, DataTable, DataTableDateRangeFilter, type DataTableDateRangeFilterProps, DataTableEnumFilter, type DataTableEnumFilterProps, DataTableFacetedFilter, type DataTableFacetedFilterProps, DataTableNumRangeFilter, type DataTableNumRangeFilterProps, DataTableOperatorFilter, type DataTableOperatorFilterProps, type DataTableProps, DataTableRowActions, type DataTableRowActionsProps, DataTableTextFilter, type DataTableTextFilterProps, DataTableToolbar, type DataTableToolbarProps, DataTableViewOptions, type DataTableViewOptionsProps, DateDisplay, DateInput, DeclarativeDisplay, type DeclarativeDisplayProps, DeclarativeForm, type DeclarativeFormProps, type DeclarativeFormSlots, DefaultCommandPalette, type DefaultCommandPaletteProps, Dialog, DialogClose, DialogContent, DialogContentProps, DialogDescription, DialogDescriptionProps, type DialogFilterState, DialogFooter, DialogFooterProps, DialogHeader, DialogHeaderProps, DialogOverlayProps, DialogPresentationHost, DialogPresentationShell, DialogTitle, DialogTitleProps, DialogTrigger, DisabledAction, type DisabledActionProps, DocBrowser, type DocBrowserProps, DocInfo, type DocInfoProps, DocPanel, type DocPanelProps, DocTrailHelp, type DocTrailHelpProps, DocumentTitleProvider, type DraftRemovalSignal, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ENUM_PICKER_CLEAR_SENTINEL, EditPageHeader, EnumBadge, type EnumBadgeProps, EnumDisplay, EnumInput, EnumPicker, type EnumPickerProps, EnumDisplay$1 as EnumValueDisplay, type EnumDisplayProps as EnumValueDisplayProps, type EnumDisplayVariant as EnumValueDisplayVariant, ExportButton, type ExportButtonProps, ExportDialog, type ExportDialogProps, type FacetedFilterOption, FacetedFilterPicker, type FacetedFilterPickerProps, Field, FieldDisplay, type FieldDisplayProps, type FieldProps, FileDisplay, FileField, type FileFieldProps, FileInput, type FileInputProps, FilterBadges, type FilterBadgesProps, FilterBuilder, type FilterBuilderProps, type FilterOperator, FilterPanel, type FilterPanelProps, FilterRegion, FilterValueControl, type FilterValueControlProps, FlowActionButton, type FlowActionButtonProps, Form, FormActions, FormControl, FormControlProps, FormDescription, FormDescriptionProps, FormField, FormItem, FormItemProps, FormLabel, FormLabelProps, FormMessage, FormMessageProps, HeaderBreadcrumbs, HelpButton, type HelpButtonProps, Icon, IconComponent, IconProps, Input, InputProps, Label, LabelProps, LanguageSubmenu, LanguageSwitch, type LanguageSwitchApi, type LanguageSwitchProps, type LinkComponent, type LinkComponentProps, LinkComponentProvider, type LinkComponentProviderProps, LinkKeysDisplay, ListBody, ListBulkBar, type ListCellRenderer, ListColumns, ListControls, ListCreate, ListErrorState, type ListErrorStateProps, ListExport, ListFilters, ListFlows, ListLive, ListSavedViews, ListSearchInput, type ListSlot, type ListSlotRegion, type LoginCredentials, LoginForm, type LoginFormProps, NavAreaPage, NavChrome, type NavChromeProps, type NavItem, type NavLayout, type NavLayoutProps, NavMain, type NavMainProps, type NavTreeEntry, type NavTreeLayout, type NavTreeSection, NavigationGuardDialog, NumberDisplay, NumberInput, PACKAGE_NAME, PACKAGE_VERSION, type PageBreadcrumbsProps, PageHeader, type PageHeaderProps, type PaletteState, PinnedFilterControls, type PinnedFilterControlsProps, Popover, PopoverAnchor, PopoverClose, PopoverContent, PopoverContentProps, PopoverPresentationHost, PopoverTrigger, type PresentationCopy, PresetFilterControls, type PresetFilterControlsProps, Progress, ProgressProps, RecordActions, RecordBreadcrumbs, RecordPage, type RecordPageProps, RecordScreen, type RecordScreenProps, RecordTitle, RefreshButton, type RefreshButtonProps, RelationDisplay, RelationField, RelationManyDisplay, RelationPicker, type RelationPickerCancelReason, LazyRelationPickerDialog as RelationPickerDialog, type RelationPickerDialogProps, type RelationPickerHandle, RelationPickerInput, type RelationPickerOpenOptions, type RelationPickerProps, type RelationPickerResult, type RelationPickerRow, type ResolvedTheme, type ResourceBreadcrumbsProps, ResourceList, ResourceListPage, type ResourceListPageProps, type ResourceListProps, ResourcePageRouter, type ResourcePageRouterProps, type RowActionDescriptor, SavedViewsDropdown, type SavedViewsDropdownProps, ScopeDimensionPicker, type ScopeDimensionPickerProps, type ScopeOption, ScopeSwitcher, type ScopeSwitcherProps, SecondarySidebarLayout, Select, SelectContent, SelectContentProps, SelectGroup, SelectItem, SelectItemProps, SelectLabel, SelectLabelProps, SelectScrollDownButton, SelectScrollDownButtonProps, SelectScrollUpButton, SelectScrollUpButtonProps, SelectSeparator, SelectSeparatorProps, SelectTrigger, SelectTriggerProps, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetContentProps, SheetDescription, SheetDescriptionProps, SheetFooter, SheetFooterProps, SheetHeader, SheetHeaderProps, SheetOverlayProps, SheetPresentationHost, SheetPresentationShell, SheetTitle, SheetTitleProps, SheetTrigger, type ShellBrand, type ShellContextValue, ShellProvider, type ShellProviderProps, type ShellUser, type ShellUserMapper, ShowPageHeader, Sidebar, SidebarBrand, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuButtonProps, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubButtonProps, SidebarMenuSubItem, SidebarProps, SidebarProvider, SidebarProviderProps, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, type Slot, type SpacingKey, THEME_CHOICES, THEME_STORAGE_KEY, Table, TableBody, TableBodyProps, TableCaption, TableCaptionProps, TableCell, TableCellProps, TableHead, TableHeadProps, TableHeader, TableHeaderProps, TableProps, TableRow, TableRowProps, Tabs, TabsContent, TabsContentProps, TabsLayout, TabsList, TabsListProps, TabsTrigger, TabsTriggerProps, TaskRunPanel, TaskRunPanelProps, TextDisplay, TextInput, Textarea, TextareaDisplay, TextareaInput, TextareaProps, type ThemeChoice, ThemeSubmenu, ThemeToggle, Toaster, type ToasterProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TypographyKey, type UseBuroDataTableOptions, type UseDialogFilterStateOptions, type UseNavTreeOptions, type UseRelationPickerOptions, type UseThemeResult, UserMenu, type UserMenuProps, badgeVariants, buildNavItems, buroSortingToTanStack, buttonVariants, cn, defaultNavLayouts, defaultUserMapper, downloadArtifact, formatOperatorLabel, hasIcon, i18nPrefixToRef, isImage, layoutSlot, listSlot, loadLocale, localeLabel, modeForSurface, recordDisplayName, registerIcons, relationLinkClassName, resolveNavIcon, resolveUpdater, saveLocale, shadcnBlockImplementations, shadcnFieldImplementations, shadcnPresentationHosts, spacing, tanStackSortingToBuro, toast, typography, useBuroDataTable, useCurrentUser, useDialogFilterState, useDocumentTitle, useExportRunWatcher, useFormControl, useFormField, useHref, useIsMobile, useLanguagePaletteActions, useLanguageSwitch, useLayout, useLayoutResolver, useLinkComponent, useListSlot, useMatch, useNavIcon, useNavTree, useNavVisible, useOptionalSidebar, usePaletteState, usePresentationCopy, useRelationPicker, useShell, useSidebar, useTheme, useThemePaletteActions, webPlatform, wrapperEnabled };
 //# sourceMappingURL=index.d.ts.map