@object-ui/components 17.1.0 → 17.3.0

package/dist/custom/combobox.d.ts

@@ -10,7 +10,17 @@ export interface ComboboxOption {
     value: string;
     label: string;
 }
-export interface ComboboxProps {
+/**
+ * Beyond its own named props, the combobox accepts standard button attributes
+ * (`id`, `aria-*`, `data-*`, handlers, …) and forwards them to the trigger —
+ * the focusable `role="combobox"` button a user and their screen reader
+ * actually interact with. Without this seam a field widget rendering a
+ * Combobox had no element to deliver `aria-invalid` / `aria-describedby` to
+ * after a validation failure (objectui#3318; the same reason #3306 routes the
+ * select's pass-through onto `SelectTrigger`). `value` / `onChange` are
+ * omitted: this component's own `value` / `onValueChange` contract owns them.
+ */
+export interface ComboboxProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "value" | "onChange"> {
     options: ComboboxOption[];
     value?: string;
     onValueChange?: (value: string) => void;
@@ -20,4 +30,4 @@ export interface ComboboxProps {
     className?: string;
     disabled?: boolean;
 }
-export declare function Combobox({ options, value, onValueChange, placeholder, searchPlaceholder, emptyText, className, disabled, }: ComboboxProps): React.JSX.Element;
+export declare function Combobox({ options, value, onValueChange, placeholder, searchPlaceholder, emptyText, className, disabled, ...triggerProps }: ComboboxProps): React.JSX.Element;

package/dist/custom/field.d.ts

@@ -8,6 +8,12 @@ import { VariantProps } from 'class-variance-authority';
  */
 import * as React from "react";
 declare const fieldVariants: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;
+/**
+ * Props for {@link FieldContainer}.
+ *
+ * Note this one keeps its natural name: the spec does not export `FieldProps`.
+ * Only the component itself had to move — see the note on `FieldContainer`.
+ */
 export interface FieldProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof fieldVariants> {
     label?: React.ReactNode;
     description?: React.ReactNode;
@@ -15,5 +21,17 @@ export interface FieldProps extends React.HTMLAttributes<HTMLDivElement>, Varian
     required?: boolean;
     htmlFor?: string;
 }
-declare const Field: React.ForwardRefExoticComponent<FieldProps & React.RefAttributes<HTMLDivElement>>;
-export { Field };
+/**
+ * A labelled form-control wrapper: label, slotted control, description, error.
+ *
+ * Named `FieldContainer`, not `Field` (objectstack#4115): `@objectstack/spec/data`
+ * exports `Field` — an object FIELD's metadata (type, reference_to, options,
+ * permissions, …) and its builder namespace — which has nothing to do with this
+ * `<div>`. Two unrelated things under one name is the defect that issue exists
+ * to remove; `@object-ui/app-shell` already renamed the same kind of collision
+ * (`FieldInput` → `ScreenFieldInput`, objectui#3169) for the same reason.
+ * `__tests__/share-filter-sort-spec-parity.test.ts` pins that the spec does not
+ * own the new name.
+ */
+declare const FieldContainer: React.ForwardRefExoticComponent<FieldProps & React.RefAttributes<HTMLDivElement>>;
+export { FieldContainer };

package/dist/custom/filter-builder.d.ts

@@ -6,7 +6,23 @@
  * LICENSE file in the root directory of this source tree.
  */
 import * as React from "react";
-export interface FilterCondition {
+/**
+ * One row of the FilterBuilder UI.
+ *
+ * Deliberately NOT `FilterCondition` (objectstack#4115): the spec owns that
+ * name for the RECURSIVE ObjectQL predicate AST — `{ [field]: FieldOperators }`
+ * with `$and` / `$or` / `$not` branches — which is a query, not a row. This is
+ * one flat `{ field, operator, value }` line plus the React key the list needs,
+ * and `operator` here is the builder's own dropdown vocabulary
+ * (`FILTER_BUILDER_OPERATORS`), not the spec's `$`-tokens.
+ *
+ * `@object-ui/types` already renamed its identical concept to
+ * `FilterBuilderCondition` (objectui#3068); this is the same thing, so it takes
+ * the same name rather than inventing a second dialect. Note the same name is
+ * NOT the right answer everywhere: `@object-ui/app-shell`'s `FilterCondition`
+ * really was the spec's ObjectQL AST and was re-exported (objectui#3169).
+ */
+export interface FilterBuilderCondition {
     id: string;
     field: string;
     operator: string;
@@ -15,7 +31,7 @@ export interface FilterCondition {
 export interface FilterGroup {
     id: string;
     logic: "and" | "or";
-    conditions: FilterCondition[];
+    conditions: FilterBuilderCondition[];
 }
 export interface FilterBuilderProps {
     fields?: Array<{
@@ -129,9 +145,9 @@ interface LookupValuePickerProps {
         displayField?: string;
         idField?: string;
     };
-    value: FilterCondition["value"];
+    value: FilterBuilderCondition["value"];
     multiple: boolean;
-    onChange: (value: FilterCondition["value"]) => void;
+    onChange: (value: FilterBuilderCondition["value"]) => void;
 }
 declare function LookupValuePicker({ field, value, multiple, onChange }: LookupValuePickerProps): React.JSX.Element;
 export { FilterBuilder, LookupValuePicker };

package/dist/custom/navigation-overlay.d.ts

@@ -53,7 +53,13 @@ export interface NavigationOverlayProps {
      * When omitted, the expand button is not rendered.
      */
     onExpand?: () => void;
-    /** Optional label for the expand button (accessible name & tooltip). */
+    /**
+     * Optional label for the expand button (accessible name & tooltip).
+     *
+     * When omitted the overlay resolves `detail.openAsFullPage` from the session
+     * locale (English when no `I18nProvider` is mounted) — it is no longer a
+     * hardcoded English literal (objectstack#5506).
+     */
     expandLabel?: string;
     /**
      * Optional storage key for persisting the user's manually-resized drawer

package/dist/custom/sort-builder.d.ts

@@ -1,3 +1,4 @@
+import { SortItem as SpecSortItem } from '@objectstack/spec/shared';
 /**
  * ObjectUI
  * Copyright (c) 2024-present ObjectStack Inc.
@@ -6,10 +7,20 @@
  * LICENSE file in the root directory of this source tree.
  */
 import * as React from "react";
-export interface SortItem {
+/**
+ * One row of the SortBuilder UI: the spec's `SortItem` (`{ field, order }`)
+ * plus the React key this list needs.
+ *
+ * Derived rather than re-declared (objectstack#4115). The old hand copy agreed
+ * with the spec key-for-key, which is the state one spec release away from
+ * drifting — a new sort key (`nulls`, say) would have appeared in the spec and
+ * silently gone missing here. `id` is the ONE local addition and it is
+ * synthetic: `normalize()` mints it, and `SortBuilder`'s change comparison
+ * strips it before diffing precisely because it is not part of the contract.
+ */
+export interface SortItem extends SpecSortItem {
+    /** React key for the row. Synthetic — never part of the emitted sort. */
     id: string;
-    field: string;
-    order: 'asc' | 'desc';
 }
 export interface SortBuilderProps {
     fields?: Array<{

package/dist/index.css

@@ -443,6 +443,9 @@
   .left-\[50\%\] {
     left: 50%;
   }
+  .isolate {
+    isolation: isolate;
+  }
   .z-10 {
     z-index: 10;
   }
@@ -2733,6 +2736,9 @@
   .fade-in-80 {
     --tw-enter-opacity: 0.8;
   }
+  .paused {
+    animation-play-state: paused;
+  }
   .ring-inset {
     --tw-ring-inset: inset;
   }