@object-ui/fields 17.3.0 → 17.6.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { default as React } from 'react';
 import { FieldMetadata } from '@object-ui/types';
-import { resolveFieldCurrency } from './currency';
+import { humanizeLabel, ComponentMeta } from '@object-ui/core';
+import { resolveFieldCurrency } from './currency.js';
 /**
  * Pick the most reasonable display name from an arbitrary record object.
  * Tries common name-like keys in priority order, then falls back to undefined.
@@ -29,34 +30,52 @@ export interface CellRendererProps {
  */
 export declare function coerceToSafeValue(value: unknown): string | number | boolean | null | undefined;
 export { resolveFieldCurrency };
-export declare function formatCurrency(value: number, currency?: string): string;
+export declare function formatCurrency(value: number, currency?: string, locale?: string): string;
 /**
  * Format currency value in compact form for mobile display.
  * E.g., $150,000 → $150K, $1,200,000 → $1.2M
  * When `currency` is undefined, returns a compact number without symbol.
  */
-export declare function formatCompactCurrency(value: number, currency?: string): string;
+export declare function formatCompactCurrency(value: number, currency?: string, locale?: string): string;
 /**
  * Format a plain number with thousands separators, no currency symbol.
  * Used as a safe fallback when a currency-typed field has no `currency`
  * configured — we'd rather render `1,234.50` than silently assume USD.
  */
-export declare function formatNumber(value: number, decimals?: number): string;
+export declare function formatNumber(value: number, decimals?: number, locale?: string): string;
 /**
- * Format percent value
+ * Format percent value.
  * Handles both decimal (0.8 = 80%) and whole number (80 = 80%) inputs.
- */
-export declare function formatPercent(value: number, precision?: number): string;
-/**
- * Humanize a snake_case or kebab-case string into Title Case.
- * Used as fallback label when no explicit option.label exists.
  *
- * Examples:
- *   "in_progress" → "In Progress"
- *   "high-priority" → "High Priority"
- *   "active" → "Active"
- */
-export declare function humanizeLabel(value: string): string;
+ * `locale` is the third positional parameter, matching {@link formatNumber} and
+ * {@link formatCurrency} — the shape the sibling formatters already use.
+ * Callers should pass the tag from `useDisplayLocale()`.
+ *
+ * Before objectui#4553 this function took no locale and never touched `Intl`:
+ * its whole body was `${percentDisplayValue(value).toFixed(precision)}%`, so it
+ * rendered in NO locale rather than the machine's — an ASCII decimal mark and
+ * never a grouping separator, byte-identical on every machine. That made
+ * `1235%` the output everywhere, which is wrong in en-US as well as in German,
+ * so the grouping and the locale are fixed together: en output MOVES from
+ * `1235%` to `1,235%` at four digits and up, and that move is the fix.
+ */
+export declare function formatPercent(value: number, precision?: number, locale?: string): string;
+/**
+ * Humanize a snake_case or kebab-case string into Title Case — the fallback
+ * label when no explicit `option.label` exists.
+ *
+ * Defined in `@object-ui/core` (`utils/humanize-label.ts`) and re-exported here
+ * because this package is one of its two doorways: `plugin-grid`,
+ * `plugin-gantt` and `plugin-detail` read it from `@object-ui/fields`, while
+ * `plugin-charts` reads the same function straight from core. Until
+ * objectui#5444 this file and `plugin-charts`' `ObjectChart.tsx` each held a
+ * byte-identical private copy; core is the shared ancestor both packages
+ * already depend on, so the convention has one home and no new dependency edge
+ * (objectui#4389: core-canonical logic, plugins consume). The core docstring
+ * carries the convention itself, and the reason it stays distinct from
+ * `humanizeFieldKey`'s camelCase-splitting KEY convention.
+ */
+export { humanizeLabel };
 /** Options shared by {@link formatDate} / {@link formatRelativeDate}. */
 export interface DateDisplayOptions {
     dueLike?: boolean;
@@ -81,9 +100,17 @@ export declare function formatRelativeDate(value: string | Date | number, option
  */
 export declare function formatDate(value: string | Date | number, style?: string, options?: DateDisplayOptions): string;
 /**
- * Format datetime value
+ * Format datetime value.
+ *
+ * `options` mirrors {@link formatDate}'s and is optional, so an existing
+ * caller that passes nothing keeps the exact runtime-default behavior it had.
+ * Before objectui#4272 the parameter did not exist at all, which meant no
+ * caller could localize this function however hard it tried — it always handed
+ * `Intl` an `undefined` tag, i.e. the MACHINE's locale, which is neither of
+ * the repo's two locale channels. Callers should pass the tag from
+ * `useDisplayLocale()`.
  */
-export declare function formatDateTime(value: string | Date | number): string;
+export declare function formatDateTime(value: string | Date | number, options?: DateDisplayOptions): string;
 /**
  * Text field cell renderer
  */
@@ -114,6 +141,43 @@ export declare function DateCellRenderer({ value, field }: CellRendererProps): R
  * DateTime field cell renderer (Airtable-style with date and time visually separated)
  */
 export declare function DateTimeCellRenderer({ value }: CellRendererProps): React.ReactElement;
+/** The six pill colors plus the two dot colors derived from one declared hex. */
+export interface HexBadgePalette {
+    bg: string;
+    fg: string;
+    border: string;
+    bgDark: string;
+    fgDark: string;
+    borderDark: string;
+    dot: string;
+    dotDark: string;
+}
+/**
+ * Derive a full soft-pill palette from an author-declared hex.
+ *
+ * The declared LIGHTNESS is what separates two same-hue tiers (`#2ecc71` is
+ * l=0.49, `#1e8449` is l=0.32 — their hues differ by 0.1°), so it has to
+ * survive into the *surface*. A fixed pale tint — the obvious reading of
+ * "compute a soft pill from the hex" — does not carry it: measured, that
+ * leaves the reported pair ΔE 2.3 apart in Lab, at the ~2.3 just-noticeable
+ * threshold, which would close this issue on paper while the user still cannot
+ * tell the two badges apart. Letting the tint depth track the declared
+ * lightness puts them ΔE 8.0 apart instead.
+ */
+export declare function deriveHexBadgePalette(color: string): HexBadgePalette | undefined;
+/** A className plus the custom properties it reads. */
+export interface HexColorAppearance {
+    className: string;
+    style: React.CSSProperties;
+}
+/**
+ * Soft-pill appearance for an explicitly declared hex, or `undefined` for
+ * every other kind of declaration (family name, no colour at all) so the
+ * caller falls back to `getBadgeColorClasses`.
+ */
+export declare function getBadgeHexAppearance(color?: string): HexColorAppearance | undefined;
+/** Dot appearance for an explicitly declared hex (see `getBadgeHexAppearance`). */
+export declare function getDotHexAppearance(color?: string): HexColorAppearance | undefined;
 export declare function getBadgeColorClasses(color?: string, val?: unknown): string;
 /**
  * Resolve a semantic color name (e.g. "red", "green") for a value, suitable
@@ -226,25 +290,47 @@ export declare function JsonCellRenderer({ value }: CellRendererProps): React.Re
  */
 export declare function ColorSwatchCellRenderer({ value }: CellRendererProps): React.ReactElement;
 /**
- * Renders `markdown` / `richtext` values as formatted GFM markdown (lazy-loaded,
- * sanitized) instead of the raw markup string.
- */
-export declare function MarkdownCellRenderer({ value }: CellRendererProps): React.ReactElement;
-/**
- * Renders an `html` value as sanitized, formatted HTML instead of raw markup.
+ * The rich-content display pipelines — `markdown` through the GFM renderer,
+ * `html`/`richtext` through the sanitizing HTML renderer — live in
+ * `./widgets/richTextDisplay.js` rather than here, so `RichTextField` can
+ * import them without importing this barrel back (objectui#5498). Re-exported
+ * unchanged: they are part of this package's published surface, and
+ * `RICH_TEXT_CELL_RENDERERS` below is the one table both the cell resolver and
+ * the widget's readonly branch read.
  */
-export declare function HtmlCellRenderer({ value }: CellRendererProps): React.ReactElement;
+export { MarkdownCellRenderer, HtmlCellRenderer } from './widgets/richTextDisplay.js';
 /**
  * Renders a `location`/`geolocation` value as readable coordinates with a pin.
  * Accepts `{ lat, lng }` / `{ latitude, longitude }`, a `"lat,lng"` string,
  * or a `[lat, lng]` array. Falls back to compact JSON for anything else.
  */
 export declare function LocationCellRenderer({ value }: CellRendererProps): React.ReactElement;
+/**
+ * Renders an `address` value as a formatted single-line postal address instead
+ * of stringified JSON (objectui#4037).
+ *
+ * The detail page's display registry mapped `address` to {@link JsonCellRenderer},
+ * so a populated address read as `{"street":"中策路 1 号","city":"杭州",…}` on the
+ * detail page and in its inline-edit read state — while the very same value
+ * rendered correctly in the create/edit dialog, whose input registry has always
+ * carried `address`. Read side only: nothing about the input widget changes.
+ *
+ * Layout is not invented here. It is {@link formatAddress} — the rule
+ * `AddressField`'s own readonly branch already applied, over the sub-field set
+ * its inputs expose — so a readonly form and a detail page cannot spell one
+ * stored address two ways.
+ *
+ * Anything `formatAddress` cannot recognize falls back to compact JSON rather
+ * than rendering blank: an unknown shape stays visible (today's behaviour) and
+ * is never silently swallowed by the fix.
+ */
+export declare function AddressCellRenderer({ value }: CellRendererProps): React.ReactElement;
 /**
  * Get the appropriate cell renderer for a field type
  */
 export declare function getCellRenderer(fieldType: string): React.FC<CellRendererProps>;
-export { mapFieldTypeToFormType } from './field-type-alias';
+export { mapFieldTypeToFormType } from './field-type-alias.js';
+export { RETIRED_FIELD_TYPES, isRetiredFieldType, reportRetiredFieldType, resetRetiredFieldTypeReports, } from './field-type-alias.js';
 /**
  * Formats file size in bytes to human-readable string
  * @param bytes - File size in bytes (must be non-negative)
@@ -264,6 +350,235 @@ export declare function buildValidationRules(field: any): any;
  * @returns Whether the condition is met
  */
 export declare function evaluateCondition(condition: any, formData: any): boolean;
+declare const fieldWidgetMap: {
+    text: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/TextField.js').TextField;
+    }>;
+    textarea: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/TextAreaField.js').TextAreaField;
+    }>;
+    number: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/NumberField.js').NumberField;
+    }>;
+    boolean: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/BooleanField.js').BooleanField;
+    }>;
+    select: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/SelectField.js').SelectField;
+    }>;
+    date: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/DateField.js').DateField;
+    }>;
+    datetime: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/DateTimeField.js').DateTimeField;
+    }>;
+    time: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/TimeField.js').TimeField;
+    }>;
+    email: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/EmailField.js').EmailField;
+    }>;
+    phone: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/PhoneField.js').PhoneField;
+    }>;
+    url: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/UrlField.js').UrlField;
+    }>;
+    multiselect: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/MultiSelectField.js').MultiSelectField;
+    }>;
+    radio: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/RadioField.js').RadioField;
+    }>;
+    checkboxes: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/CheckboxesField.js').CheckboxesField;
+    }>;
+    tags: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/TagsField.js').TagsField;
+    }>;
+    currency: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/CurrencyField.js').CurrencyField;
+    }>;
+    percent: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/PercentField.js').PercentField;
+    }>;
+    password: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/PasswordField.js').PasswordField;
+    }>;
+    markdown: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/RichTextField.js').RichTextField;
+    }>;
+    html: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/RichTextField.js').RichTextField;
+    }>;
+    richtext: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/RichTextField.js').RichTextField;
+    }>;
+    lookup: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/LookupField.js').LookupField;
+    }>;
+    master_detail: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/LookupField.js').LookupField;
+    }>;
+    file: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/FileField.js').FileField;
+    }>;
+    image: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/ImageField.js').ImageField;
+    }>;
+    location: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/LocationField.js').LocationField;
+    }>;
+    formula: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/FormulaField.js').FormulaField;
+    }>;
+    summary: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/SummaryField.js').SummaryField;
+    }>;
+    auto_number: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/AutoNumberField.js').AutoNumberField;
+    }>;
+    user: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/UserField.js').UserField;
+    }>;
+    object: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/ObjectField.js').ObjectField;
+    }>;
+    vector: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/VectorField.js').VectorField;
+    }>;
+    grid: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/GridField.js').GridField;
+    }>;
+    color: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/ColorField.js').ColorField;
+    }>;
+    slider: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/SliderField.js').SliderField;
+    }>;
+    rating: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/RatingField.js').RatingField;
+    }>;
+    code: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/CodeField.js').CodeField;
+    }>;
+    avatar: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/AvatarField.js').AvatarField;
+    }>;
+    address: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/AddressField.js').AddressField;
+    }>;
+    geolocation: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/GeolocationField.js').GeolocationField;
+    }>;
+    signature: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/SignatureField.js').SignatureField;
+    }>;
+    qrcode: () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/QRCodeField.js').QRCodeField;
+    }>;
+    'object-ref': () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/ObjectRefField.js').ObjectRefField;
+    }>;
+    'filter-condition': () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/FilterConditionField.js').FilterConditionField;
+    }>;
+    'recipient-picker': () => Promise<{
+        default: React.ComponentType<any>;
+    } | {
+        default: typeof import('./widgets/RecipientPickerField.js').RecipientPickerField;
+    }>;
+};
+/** The registered field widget keys, as a literal union (objectui#4857). */
+export type RegisteredFieldWidgetType = keyof typeof fieldWidgetMap;
 /**
  * Every field type the form can render (the canonical list of supported types).
  * Exported so inline editing can be checked against it — a form type must
@@ -283,6 +598,18 @@ export declare const FORM_FIELD_TYPES: readonly string[];
  * support can never drift behind the form surface (ADR-0059).
  */
 export declare function resolveFormWidgetType(fieldType: string): string;
+/**
+ * The widget keys that must be fed the live record (`dependentValues`) so their
+ * offered option set can be re-resolved per option `visibleWhen` / `dependsOn`.
+ *
+ * Defined in `@object-ui/core`, next to `resolveCascadingOptions` — the
+ * evaluator that reads the record — and re-exported here because this is the
+ * package whose {@link resolveFormWidgetType} produces the keys the set is
+ * keyed on: a consumer resolving a widget key finds the allow-table in the
+ * same place. One definition, two doorways; never a second copy (objectui#4770,
+ * which converged the three private copies that preceded it).
+ */
+export { CASCADE_OPTION_WIDGET_TYPES } from '@object-ui/core';
 /**
  * Lazily-loaded form field widget for a field type. Shares the exact loaders
  * of {@link fieldWidgetMap} (the same components `registerField` registers for
@@ -292,6 +619,59 @@ export declare function resolveFormWidgetType(fieldType: string): string;
  * widget via {@link resolveFormWidgetType}.
  */
 export declare function getLazyFieldWidget(fieldType: string): React.ComponentType<any>;
+/**
+ * The labelling declaration of EVERY registered field widget
+ * (`ComponentMeta.labelling` — the closed `'control' | 'group' | 'display'`
+ * vocabulary, objectui#3961 extended by objectui#4857). This `Record` is keyed
+ * by the widget map's own literal key union, so it is exhaustive BY
+ * CONSTRUCTION: registering a widget without deciding how a host's label
+ * reaches it is a COMPILE error here, not a silent fall-through to the
+ * `'control'` path — the omitted-declaration degradation is exactly the trap
+ * the #4857 ruling named, and it is what turned the display-only four into
+ * fields with no accessible name.
+ *
+ * ## `'group'` — a surface no `<label for>` can reach; the WIDGET consumes the IDREF
+ *
+ * Two shapes, one declaration:
+ *
+ *  - real composites — `address` / `geolocation` render several inputs under one
+ *    container, `checkboxes` / `radio` / `rating` / `multiselect` a set of
+ *    choice controls, and `grid` a whole table of cell inputs plus row actions;
+ *    the host's label names the GROUP, each sub-control keeps its own name (a
+ *    sub-label, the chip's text content, or a cell's own `aria-label`).
+ *  - single non-labelable controls — `file`'s one control is a
+ *    `div[role="button"]` dropzone, `slider`'s is Radix's `span[role="slider"]`
+ *    thumb (objectui#3318), `signature`'s drawing surface is a `<canvas>`
+ *    (objectui#3318). A `div`/`span`/`canvas` cannot be `for`-labelled, so the
+ *    name goes by IDREF to the control (or, for `signature`, its container).
+ *
+ * Measured, not assumed: every `'group'` entry was verified in a real form —
+ * the #3961/#3975 probes for the first seven, the #3318 delivery for
+ * `slider`/`signature`, and the #4857 re-measurement for `grid` (bare config:
+ * one focusable, the auxiliary "Add line" BUTTON — routing `for` there would
+ * have label clicks INSERT A ROW; realistic config: 8 focusables across cell
+ * inputs and row actions — a composite, not a single control).
+ *
+ * ## `'display'` — a pure display in EVERY state; the HOST wraps (objectui#4857)
+ *
+ * `formula` / `summary` / `auto_number` / `vector` have no editable branch at
+ * all: the whole widget is a replacement display with no focusable control, in
+ * the editable state as much as the readonly one (on the real object-form path
+ * they arrive `disabled`, never `readonly`, so the #4788 readonly gate could
+ * not cover them). The form renderer answers the declaration with its own
+ * wrapper — id + `aria-labelledby` + `aria-describedby` + `role="group"`, the
+ * #4788 container — and the label emits no `for`. The widgets spread nothing,
+ * by design; the host is the named surface.
+ *
+ * ## `'control'` — everything else
+ *
+ * The host's `<label for>` reaches a real labelable element. At registration
+ * this is deliberately spelled as ABSENCE of the meta key (one spelling of the
+ * default, objectui#3961), so hosts keep one rule for these and for
+ * out-of-registry widgets alike; the entry here is still mandatory, because
+ * "defaulted by omission" and "decided to be the default" are different facts.
+ */
+export declare const FIELD_WIDGET_LABELLING: Record<RegisteredFieldWidgetType, NonNullable<ComponentMeta['labelling']>>;
 export declare function registerField(fieldType: string): void;
 /**
  * Register all field types (for backward compatibility)
@@ -303,63 +683,72 @@ export declare function registerField(fieldType: string): void;
  * // Register all fields at once
  * registerAllFields();
  */
-export declare function registerAllFields(): void;
 /**
- * Legacy function - kept for backward compatibility
- * @deprecated Use registerAllFields() instead
- */
-export declare function registerFields(): void;
-export * from './widgets/types';
-export * from './widgets/file-value';
-export * from './FieldEditWidget';
-export * from './widgets/TextField';
-export * from './widgets/NumberField';
-export * from './widgets/BooleanField';
-export * from './widgets/SelectField';
-export * from './widgets/DateField';
-export * from './widgets/DateTimeField';
-export * from './widgets/TimeField';
-export * from './widgets/EmailField';
-export * from './widgets/PhoneField';
-export * from './widgets/UrlField';
-export * from './widgets/CurrencyField';
-export * from './widgets/PercentField';
-export * from './widgets/PasswordField';
-export * from './widgets/TextAreaField';
-export * from './widgets/RichTextField';
-export * from './widgets/LookupField';
-export * from './widgets/CapabilityMultiSelectField';
-export * from './widgets/ObjectRefField';
-export * from './widgets/FilterConditionField';
-export * from './widgets/RecipientPickerField';
-export * from './widgets/RecordPickerDialog';
-export * from './widgets/deriveLookupColumns';
-export * from './widgets/FileField';
-export * from './widgets/ImageField';
-export { ImageCropperDialog } from './widgets/ImageCropperDialog';
-export type { ImageCropperDialogProps } from './widgets/ImageCropperDialog';
-export * from './widgets/LocationField';
-export * from './widgets/FormulaField';
-export * from './widgets/SummaryField';
-export * from './widgets/AutoNumberField';
-export * from './widgets/UserField';
-export * from './widgets/ObjectField';
-export * from './widgets/VectorField';
-export * from './widgets/GridField';
-export * from './widgets/ColorField';
-export * from './widgets/SliderField';
-export * from './widgets/RatingField';
-export * from './widgets/CodeField';
-export * from './widgets/AvatarField';
-export * from './widgets/AddressField';
-export * from './widgets/GeolocationField';
-export * from './widgets/SignatureField';
-export * from './widgets/QRCodeField';
-export * from './widgets/MasterDetailField';
-export * from './widgets/MultiSelectField';
-export * from './widgets/RadioField';
-export * from './widgets/CheckboxesField';
-export * from './widgets/TagsField';
-export { withFieldCarrier } from './withFieldCarrier';
-export { toDomProps } from './widgets/toDomProps';
-export type { DomProps } from './widgets/toDomProps';
+ * The widget a RETIRED field-type spelling renders (objectui#4814).
+ *
+ * Shape borrowed from the form renderer's spec-vocabulary boundary (#3090),
+ * which is this repo's settled answer to "an authored entry this renderer
+ * cannot honour": an inline alert that NAMES the offending entry, plus a
+ * `console.error` whose text doubles as the fix instruction. Nothing is thrown
+ * — one retired field must not take down the rest of a record form — but
+ * nothing is silently substituted either, which is the whole point: the author
+ * sees a refusal where they expected an input, not a text box that looks like
+ * it worked.
+ */
+export declare const RetiredFieldTombstone: React.FC<Record<string, any>>;
+export declare function registerAllFields(): void;
+export * from './widgets/types.js';
+export * from './widgets/file-value.js';
+export * from './FieldEditWidget.js';
+export * from './widgets/TextField.js';
+export * from './widgets/NumberField.js';
+export * from './widgets/BooleanField.js';
+export * from './widgets/SelectField.js';
+export * from './widgets/DateField.js';
+export * from './widgets/DateTimeField.js';
+export * from './widgets/TimeField.js';
+export * from './widgets/EmailField.js';
+export * from './widgets/PhoneField.js';
+export * from './widgets/UrlField.js';
+export * from './widgets/CurrencyField.js';
+export * from './widgets/PercentField.js';
+export * from './widgets/PasswordField.js';
+export * from './widgets/TextAreaField.js';
+export * from './widgets/RichTextField.js';
+export * from './widgets/LookupField.js';
+export * from './widgets/CapabilityMultiSelectField.js';
+export * from './widgets/ObjectRefField.js';
+export * from './widgets/FilterConditionField.js';
+export * from './widgets/RecipientPickerField.js';
+export * from './widgets/RecordPickerDialog.js';
+export * from './widgets/deriveLookupColumns.js';
+export * from './widgets/FileField.js';
+export * from './widgets/ImageField.js';
+export { ImageCropperDialog } from './widgets/ImageCropperDialog.js';
+export type { ImageCropperDialogProps } from './widgets/ImageCropperDialog.js';
+export * from './widgets/LocationField.js';
+export * from './widgets/FormulaField.js';
+export * from './widgets/SummaryField.js';
+export * from './widgets/AutoNumberField.js';
+export * from './widgets/UserField.js';
+export * from './widgets/ObjectField.js';
+export * from './widgets/VectorField.js';
+export * from './widgets/GridField.js';
+export * from './widgets/ColorField.js';
+export * from './widgets/SliderField.js';
+export * from './widgets/RatingField.js';
+export * from './widgets/CodeField.js';
+export * from './widgets/AvatarField.js';
+export * from './widgets/AddressField.js';
+export * from './widgets/GeolocationField.js';
+export * from './widgets/SignatureField.js';
+export * from './widgets/QRCodeField.js';
+export * from './widgets/MasterDetailField.js';
+export * from './widgets/MultiSelectField.js';
+export * from './widgets/RadioField.js';
+export * from './widgets/CheckboxesField.js';
+export * from './widgets/TagsField.js';
+export { withFieldCarrier } from './withFieldCarrier.js';
+export { toDomProps } from './widgets/toDomProps.js';
+export type { DomProps } from './widgets/toDomProps.js';
+export { toDateInputValue, toDateTimeInputValue, fromDateTimeInputValue, } from './widgets/nativeDateValue.js';