@burojs/ui-shadcn 0.7.0 → 0.8.0

package/dist/index.d.cts

@@ -2,8 +2,8 @@ import { t as THEME_STORAGE_KEY } from "./theme-storage-key-pYlp4aDS.cjs";
 import { webPlatform } from "@burojs/react/web";
 import * as React$1 from "react";
 import { AnchorHTMLAttributes, ComponentType, JSX, ReactElement, ReactNode, SVGProps } from "react";
-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 } from "@burojs/react";
+import { ActionDensity, AnyFrameHandle, AppRuntime, AuthResult, Check, CheckSurface, CustomPageDef, DraftOption, EntityRef, EnumControl, EnumNameOrRef, ErasedResourceHandle, ExportArtifact, ExportTarget, FieldDeclaration, FieldStatus, FieldZone, FilterExpression, FilterGroup, FilterOperator, FixedFilterInput, FormBody, FrameHandle, HrefOpts, I18nCaps, NavGroupDef, NavNode, PortableValue, RecordId, RecordTitleContext, 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, EnumUseSite, FieldBinding, FieldImplementation, FieldImplementationLayout, FieldLinkState, FieldPresentation, FilterFieldSpec, FilterKind, FormSubmitContext, FormValues, ListOptionFilter, QuickSettledRow, RowRecord, SavedViewEntry, ScalarDisplayProps, ScalarInputProps, UIPresentationHostProps, UIPresentationHosts, UseFormControllerFormOptions, modeForSurface } from "@burojs/react";
 import { ToasterProps as ToasterProps$1, toast } from "sonner";
 import { z } from "zod";
 import { isImage } from "@burojs/file-storage";
@@ -512,25 +512,84 @@ type RecordPageProps<N extends string = string> = {
  */
 declare function RecordPage<const N extends string = string>(props: RecordPageProps<N>): ReactElement;
 //#endregion
-//#region src/layout/record-breadcrumbs.d.ts
+//#region src/layout/breadcrumbs.d.ts
+/** A crumb; `jump` makes its click start a fresh trail (`useOriginIntent`), as a group link does. */
+type Segment = {
+  label: string;
+  href?: string;
+  jump?: boolean;
+};
+interface BreadcrumbsBaseProps {
+  className?: string;
+  /**
+   * Scopes the trail offers help for, outermost first. Defaults to the resource
+   * this breadcrumb is rooted at (none for a trail without a resource).
+   */
+  docScopes?: string[];
+  /**
+   * Segments rendered before the resource segment (or before the page label in
+   * a trail without one), each followed by a chevron — the group chain. A
+   * segment with an `href` renders as a link; without one, as muted text.
+   */
+  leadingSegments?: Segment[];
+  /** Optional testid forwarded to the root nav. */
+  'data-testid'?: string;
+}
+/** A trail that ends at, or passes through, a resource: its list link, then the record. */
+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;
+  /**
+   * Display label for the trailing segment (the current page). When omitted
+   * the resource segment itself is the current crumb (a list page).
+   */
+  pageLabel?: string;
+  /**
+   * Segments rendered between the resource link and the trailing page label —
+   * the record on an edit page («Documents › live-one › Edit»). A segment
+   * without `href` renders as plain text.
+   */
+  middleSegments?: Segment[];
+  /**
+   * Where the resource crumb links instead of the list's canonical address: the list as the user
+   * had it, filters and page included (a record page reached from it, navigation origin).
+   */
+  resourceHref?: string;
+  /**
+   * Segments that replace the leading segments and the resource crumb: the trail of the page the
+   * user came from when it is not this resource's list (a parent record's card). `middleSegments`
+   * are not drawn with them.
+   */
+  rootSegments?: Segment[];
+}
+/** A trail with no resource segment: a custom page or a group index. */
+interface PageBreadcrumbsProps extends BreadcrumbsBaseProps {
+  resource?: never;
+  /** The test-id name of the current crumb: the custom page's or the group's key. */
+  name: string;
+  /** The current page's label, the trail's last crumb. */
+  pageLabel: string;
+  recordId?: never;
+  middleSegments?: never;
+  resourceHref?: never;
+  rootSegments?: never;
+}
+type BreadcrumbsProps<N extends string = string> = ResourceBreadcrumbsProps<N> | PageBreadcrumbsProps;
 /**
- * The record trail of the current route, the one `<HeaderBreadcrumbs>` draws
- * there; record and flow pages draw none of their own.
- *
- * On a record route whose operation is available: the group chain, the
- * resource, then the record (show), the record linking to show when show is
- * available plus "Edit" (edit), or "Create" (create). The record crumb is the
- * record's title once `<RecordPage>` has loaded it, and the id while it loads,
- * has failed, or is not mounted at all.
- *
- * On a page-hosted flow's route: the record's edit-shaped trail ending with the
- * flow's label, once the flow page shows its form or its "not available"
- * notice; until then, and on every not-found it answers with, the record's
- * show trail with the id, so a flow the user may not run is never named. A
- * name no flow answers to is the framework 404, with no trail.
- *
- * Nothing on any other route.
+ * The navigation breadcrumb, in two shapes. With `resource`: the leading
+ * segments, the resource (a link to its canonical, nesting-aware list href,
+ * or the current crumb on a bare list), the middle segments and the page
+ * label. Without: the leading segments and the page label only, test ids
+ * named by `name`. The last crumb is always the "you are here" marker — an
+ * 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<const N extends string = string>(input: BreadcrumbsProps<N>): ReactElement | null;
+//#endregion
+//#region src/layout/record-breadcrumbs.d.ts
 declare function RecordBreadcrumbs(): ReactElement | null;
 //#endregion
 //#region src/record/record-screen.d.ts
@@ -772,68 +831,6 @@ declare function loadLocale(storageKey?: string): string | undefined;
 /** Persist a locale code. Counterpart to {@link loadLocale}. */
 declare function saveLocale(code: string, storageKey?: string): void;
 //#endregion
-//#region src/layout/breadcrumbs.d.ts
-type Segment = {
-  label: string;
-  href?: string;
-};
-interface BreadcrumbsBaseProps {
-  className?: string;
-  /**
-   * Scopes the trail offers help for, outermost first. Defaults to the resource
-   * this breadcrumb is rooted at (none for a trail without a resource).
-   */
-  docScopes?: string[];
-  /**
-   * Segments rendered before the resource segment (or before the page label in
-   * a trail without one), each followed by a chevron — the group chain. A
-   * segment with an `href` renders as a link; without one, as muted text.
-   */
-  leadingSegments?: Segment[];
-  /** Optional testid forwarded to the root nav. */
-  'data-testid'?: string;
-}
-/** A trail that ends at, or passes through, a resource: its list link, then the record. */
-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;
-  /**
-   * Display label for the trailing segment (the current page). When omitted
-   * the resource segment itself is the current crumb (a list page).
-   */
-  pageLabel?: string;
-  /**
-   * Segments rendered between the resource link and the trailing page label —
-   * the record on an edit page («Documents › live-one › Edit»). A segment
-   * without `href` renders as plain text.
-   */
-  middleSegments?: Segment[];
-}
-/** A trail with no resource segment: a custom page or a group index. */
-interface PageBreadcrumbsProps extends BreadcrumbsBaseProps {
-  resource?: never;
-  /** The test-id name of the current crumb: the custom page's or the group's key. */
-  name: string;
-  /** The current page's label, the trail's last crumb. */
-  pageLabel: string;
-  recordId?: never;
-  middleSegments?: never;
-}
-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,
- * or the current crumb on a bare list), the middle segments and the page
- * label. Without: the leading segments and the page label only, test ids
- * named by `name`. The last crumb is always the "you are here" marker — an
- * 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<const N extends string = string>(input: BreadcrumbsProps<N>): ReactElement | null;
-//#endregion
 //#region src/layout/header-breadcrumbs.d.ts
 /**
  * The page's one breadcrumb trail, and `<AppHeader>`'s default `breadcrumbs`:
@@ -1758,6 +1755,27 @@ interface AuthPageProps {
  */
 declare function AuthPage({ children, brand, footer, className }: AuthPageProps): React.ReactElement;
 //#endregion
+//#region src/fields/object-group.d.ts
+/**
+ * The input chrome of an object field (T2 5.5): a bordered group around its properties. The
+ * shell lays the properties out in the declared layout and hands them over as `children`; the
+ * field's own label is the leaf's, so the group is named by it.
+ */
+declare function ObjectGroupInput(props: ScalarInputProps<unknown>): ReactElement;
+/** The display chrome of an object field: the same group around its properties' displays. */
+declare function ObjectGroupDisplay(props: ScalarDisplayProps<unknown>): ReactElement;
+//#endregion
+//#region src/fields/repeater.d.ts
+/**
+ * The input chrome of an array field (T2 5.5): its elements, each with move-up, move-down and
+ * remove, and an add button. The shell supplies the elements (`renderElement`), their stable keys
+ * and the one set of actions; the repeater only draws them. Test ids are
+ * `<input id>:item:<n>`, `:add`, `:empty` and, per element, `:remove:<n>`, `:up:<n>`, `:down:<n>`.
+ */
+declare function RepeaterInput(props: CollectionInputProps<unknown>): ReactElement;
+/** The display chrome of an array field: a read-only list of its elements' displays. */
+declare function RepeaterDisplay(props: CollectionDisplayProps<unknown>): ReactElement;
+//#endregion
 //#region src/fields/default-renderers.d.ts
 /** Immutable, trusted shadcn implementations keyed by the compiler's UI IDs. */
 declare const shadcnFieldImplementations: Readonly<{
@@ -1771,6 +1789,8 @@ declare const shadcnFieldImplementations: Readonly<{
   dateTime: FieldImplementation<unknown, Readonly<Record<string, unknown>>>;
   'date-time': FieldImplementation<unknown, Readonly<Record<string, unknown>>>;
   'default:date-time': FieldImplementation<unknown, Readonly<Record<string, unknown>>>;
+  time: FieldImplementation<unknown, Readonly<Record<string, unknown>>>;
+  'default:time': FieldImplementation<unknown, Readonly<Record<string, unknown>>>;
   enum: FieldImplementation<unknown, Readonly<Record<string, unknown>>>;
   json: FieldImplementation<unknown, Readonly<Record<string, unknown>>>;
   relation: Readonly<{
@@ -1780,12 +1800,23 @@ 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>>>;
+    chrome?: true;
     texts?: Readonly<Record<string, string>>;
   }>;
   richText: FieldImplementation<unknown, Readonly<Record<string, unknown>>>;
   'rich-text': FieldImplementation<unknown, Readonly<Record<string, unknown>>>;
   'default:rich-text': FieldImplementation<unknown, Readonly<Record<string, unknown>>>;
   file: FieldImplementation<unknown, Readonly<Record<string, unknown>>>;
+  object: Readonly<{
+    Input: typeof ObjectGroupInput;
+    Display: typeof ObjectGroupDisplay;
+    chrome: true;
+  }>;
+  array: Readonly<{
+    CollectionInput: typeof RepeaterInput;
+    CollectionDisplay: typeof RepeaterDisplay;
+    chrome: true;
+  }>;
 }>;
 //#endregion
 //#region src/blocks/builtins.d.ts
@@ -1796,6 +1827,14 @@ declare const shadcnFieldImplementations: Readonly<{
  */
 declare const shadcnBlockImplementations: BlockImplementationCatalog;
 //#endregion
+//#region src/resource/use-record-subtitle.d.ts
+/**
+ * A record's second line as code declares it (REF-136): the resource's `recordSubtitle`, or a
+ * relation field's `optionSubtitle` for that field's options. A string is the line, `null` says
+ * there is none, `undefined` (or a blank string) leaves it to the surface.
+ */
+type RecordSubtitleFn = (record: Readonly<Record<string, unknown>>, ctx?: RecordTitleContext) => string | null | undefined;
+//#endregion
 //#region src/fields/registry.d.ts
 interface FieldRendererProps {
   value: unknown;
@@ -1813,6 +1852,8 @@ interface FieldRendererProps {
     ui?: Record<string, unknown>;
     /** The field's declared `texts`; an option's label is read from it (`fieldOptionText`). */
     texts?: unknown;
+    /** A date field's zone: an IANA name or a value source (REF-118 §4.2). */
+    zone?: unknown;
   };
   options?: Array<{
     value: string;
@@ -1854,11 +1895,18 @@ interface FieldInputProps {
   relationSeeds?: Readonly<Record<string, unknown>>;
   /** A relation select's extra filters from the form's `filter` function (P7 3.4). */
   fixedFilters?: readonly FixedFilterInput[];
+  /** A relation select's option subtitle, the field's `optionSubtitle` (REF-136). */
+  optionSubtitle?: RecordSubtitleFn;
   /**
    * The field owner's source states, projected by what the user may view: what a relation's
    * `candidates` refs are read from (P7 3.4).
    */
   metaSources?: ScreenSources;
+  /**
+   * What a `changed` operand compares against: the form's starting values (seeded on a create).
+   * An enum control reads its available set against them. Absent: `record`.
+   */
+  baseline?: Readonly<Record<string, unknown>>;
   /**
    * 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.
@@ -1932,7 +1980,14 @@ interface FieldInputProps {
     name: string;
     meta?: Record<string, unknown>;
     ui?: Record<string, unknown>;
+    /** A date field's zone: an IANA name or a value source (REF-118 §4.2). */
+    zone?: unknown;
   };
+  /**
+   * The form's live values, when the field is edited in a form. A date field whose zone is a
+   * `ref('record', …)` reads it, so changing the zone column re-reads the box (REF-118 C5).
+   */
+  values?: Readonly<Record<string, unknown>>;
   /**
    * Registry name of the resource this field belongs to.
    *
@@ -1962,7 +2017,7 @@ declare function BooleanDisplay({ value, text }: FieldRendererProps): React$1.Re
 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, text }: FieldRendererProps): React$1.ReactElement;
+declare function DateDisplay(props: FieldRendererProps): React$1.ReactElement;
 declare function DateInput(props: FieldInputProps): React$1.ReactElement;
 //#endregion
 //#region src/fields/enum.d.ts
@@ -1975,8 +2030,12 @@ declare function EnumDisplay({ value, options, field, resource }: FieldRendererP
  * 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.
+ *
+ * The field's `meta.narrow` (REF-132 §7.2) removes options here as it does on a
+ * registered enum's picker; a current value that is not offered still shows,
+ * first and inert (§8).
  */
-declare function EnumInput({ name, id, value, onChange, testid, options, field, placeholder, disabled, required, ariaInvalid, ariaDescribedBy, ariaErrorMessage, ariaLabelledBy, resource }: FieldInputProps): React$1.ReactElement;
+declare function EnumInput({ name, id, value, onChange, testid, options, field, placeholder, disabled, required, ariaInvalid, ariaDescribedBy, ariaErrorMessage, ariaLabelledBy, resource, record, values, metaSources, baseline }: FieldInputProps): React$1.ReactElement;
 //#endregion
 //#region src/fields/textarea.d.ts
 declare function TextareaDisplay({ value, text: formatted }: FieldRendererProps): React$1.ReactElement;
@@ -2164,6 +2223,11 @@ interface RelationPickerProps<N extends string = string> {
   fieldName?: string;
   /** The field's `ui.open` (P7 3.6): what the "view" button opens, or no button for `none`. */
   open?: RelationOpen;
+  /**
+   * The options' second line over the target row (a relation field's `optionSubtitle`): wins over
+   * the target's `recordSubtitle`; without either, `#<id>`.
+   */
+  optionSubtitle?: RecordSubtitleFn;
   /**
    * The read scope of the option reads (the popover, "Advanced search" and the create hand-back).
    * Default `'context'`: the record around the picker narrows its options, except by the field
@@ -2181,7 +2245,7 @@ interface RelationPickerProps<N extends string = string> {
   /** Forwarded to the trigger button as `aria-errormessage` (WAI-ARIA 1.2). */
   ariaErrorMessage?: string;
 }
-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;
+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, optionSubtitle, 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
@@ -2558,12 +2622,30 @@ interface ResolvedFieldDisplayProps {
   readonly columnEntry?: {
     readonly display?: unknown;
   };
+  /**
+   * The object property paths the form's plan holds absent by a `when` (REF-132 1a-9,
+   * `ScreenPlan.absentPaths`), dotted from the record root (`'head.vsd'`), at or below this field.
+   * An object group draws no property at or below one of them. Absent: every property is drawn.
+   */
+  readonly absentPaths?: readonly string[];
+  /**
+   * Each object path below this field whose status path rules decide (REF-131 S1,
+   * `ScreenPlan.fieldPaths`), dotted from the record root (`'head.y'`). An object group draws an
+   * `inactive` part not at all and any other part that is not `active` read-only. Absent: every
+   * part follows the field.
+   */
+  readonly pathStatus?: Readonly<Record<string, FieldStatus>>;
 }
 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. */
   readonly form?: Readonly<Record<string, unknown>>;
+  /**
+   * What a `changed` operand compares against: the form controller's starting values (seeded on a
+   * create). An enum picker reads its available set against them. Absent: `record`.
+   */
+  readonly baseline?: Readonly<Record<string, unknown>>;
   readonly onBlur?: () => void;
   readonly disabled?: boolean;
   readonly required?: boolean;
@@ -2594,6 +2676,11 @@ interface ResolvedFieldInputProps extends Omit<ResolvedFieldDisplayProps, 'fallb
    * Never read from `field.meta`, which a layer can write.
    */
   readonly fixedFilters?: readonly FixedFilterInput[];
+  /**
+   * A relation select's option subtitle (the field's `optionSubtitle`, REF-136): code, handed down
+   * by the form controller on its own channel, as `fixedFilters` is.
+   */
+  readonly optionSubtitle?: FieldBinding['optionSubtitle'];
   /** An inline link field's rights, hidden keys and load state, from the form controller. */
   readonly link?: FieldLinkState;
   readonly fallback: ReactNode;
@@ -3030,6 +3117,13 @@ interface EnumPickerProps<N extends string = string> {
   clearable?: boolean;
   /** Label for the clear item. Defaults to "All". */
   clearLabel?: string;
+  /**
+   * The field's use site (REF-132 §7.2): its `params`, its `narrow` and the sources they read.
+   * Given, the picker offers only the available set (§7.6); absent, every value, as a filter
+   * offers them. Either way a current value that is not offered still shows (§8), as a
+   * "current" item that cannot be picked again once the user moves away.
+   */
+  use?: EnumUseSite;
 }
 /**
  * Single picker primitive that renders enum values with one of the
@@ -3043,7 +3137,7 @@ interface EnumPickerProps<N extends string = string> {
  * matches the EnumBadge fallback policy: a half-shipped enum should not
  * crash the form.
  */
-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;
+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, use }: EnumPickerProps<N>): React$1.ReactElement;
 //#endregion
 //#region src/primitives/button.d.ts
 declare const buttonVariants: (props?: ({
@@ -4916,6 +5010,11 @@ interface FilterValueControlProps {
    */
   readonly placeholder?: string;
   readonly autoFocus?: boolean;
+  /**
+   * `FilterFieldSpec.zone`: the zone a date-time box reads and writes in, before the user's, the
+   * app's and the host's (REF-118 §4.2). Other kinds ignore it.
+   */
+  readonly zone?: FieldZone;
   /**
    * Delay (ms) before a scalar single-value edit (`ScalarValueInput`'s
    * text/number/date box) commits upward. Only that control debounces —
@@ -5346,7 +5445,9 @@ declare function ShowPageHeader<const N extends string = string>({ resource: res
 }): React.ReactElement | null;
 /**
  * The edit-page `<PageHeader>`: the back-link, the record's title and the resolved
- * `<ActionOverflow surface="edit">` item-action list.
+ * `<ActionOverflow surface="edit">` item-action list. The back-link is `backHref` when given,
+ * else where the record page's Save returns (`useReturnTarget`): where the user came from, by
+ * default, else the record's show page, else the list.
  */
 declare function EditPageHeader<const N extends string = string>({ resource: resourceInput, record, backHref, breadcrumbs }: {
   resource: ResourceNameOrRef<N>;