@object-ui/components 11.3.0 → 11.5.0

package/CHANGELOG.md

@@ -1,5 +1,148 @@
 # @object-ui/components
 
+## 11.5.0
+
+### Minor Changes
+
+- 6fffd3d: Client-side data-invalidation bus — refresh data, don't rebuild UI (objectui#2269 P1).
+
+  - `@object-ui/react` gains the bus: `notifyDataChanged({objectName, recordId?})`, `useDataInvalidation(objectName, recordId?)` (reader nonce), `subscribeDataChanges`, and `useMutationInvalidationBridge(dataSource)` which fans every dataSource write (`MutationEvent`) onto the bus. The bus also dispatches the legacy `objectui:related-changed` window event, so pre-bus listeners keep working.
+  - The `key={refreshKey}` remount of `RecordDetailView` (AppContent) and the `key={actionRefreshKey}` remount of `DetailView` (RecordDetailView) are GONE: record data now refetches in place via the bus — scroll, collapsed sections, tabs and in-progress inline edits survive every save/action/undo. All nine action-success bumps became precisely-scoped `notifyDataChanged` calls; undo/redo use the operation's own `objectName`/`recordId`.
+  - `RelatedCountStore` is wired to the bus (tab count badges refetch after any change to their object) and its `useSyncExternalStore` snapshot is now a monotonic version — previously it returned the same `Map` reference, so `emit()` never re-rendered subscribers and invalidations left badges stale; `useRelatedCountVersion()` is exported and drives the probe effect's re-fetch.
+  - app-shell also gains the reserved URL-param registry (`urlParams.ts` — `form`/`formObject`/`formLink`/`tab`/`recordId`/`palette`/`shortcuts` constants replace scattered string literals) and AGENTS.md Commandment #8 (UI-state classification: state that must survive a data refresh may never live only in an uncontrolled component).
+
+- 9255686: Record detail tabs are URL-addressable (`?tab=`) and survive subtree remounts (objectui#2257, ADR-0054 C3).
+
+  - `buildDefaultTabs` emits STABLE semantic tab values (`details` / `related:<child>` / `related` / `activity` / `history`) instead of leaving the renderer to synthesize index-derived ones.
+  - `PageTabsRenderer` honors `item.value`, a host-provided `schema.defaultTab` (validated against actual tabs) and `schema.onTabChange`; index fallback kept for authored schemas without values.
+  - app-shell `RecordDetailView` restores the active tab from `?tab=` and writes it back with `replace` (tab switches never stack history), via the pure `withPageTabsUrlSync` page-tree injector (never mutates authored/memoized page schemas). Legacy `DetailView.autoTabs` wired to the same contract (`defaultTab`/`onTabChange`).
+  - Fixes the tab strip resetting to Details after save-refresh remounts (`refreshKey`-style) and dev-StrictMode URL churn; enables `?tab=` deep links; invalid values fall back to Details.
+
+### Patch Changes
+
+- Updated dependencies [544d8eb]
+- Updated dependencies [6fffd3d]
+- Updated dependencies [9255686]
+- Updated dependencies [fae75e2]
+- Updated dependencies [1072701]
+  - @object-ui/i18n@11.5.0
+  - @object-ui/react@11.5.0
+  - @object-ui/types@11.5.0
+  - @object-ui/core@11.5.0
+  - @object-ui/react-runtime@11.5.0
+  - @object-ui/sdui-parser@11.5.0
+
+## 11.4.0
+
+### Patch Changes
+
+- 1948c5b: fix(plugin-grid): keep the grid's row selection in sync when a bulk-action dialog closes
+
+  Closing a bulk-action result dialog (e.g. 派工 / 下推) on **Done** cleared
+  ObjectGrid's `selectedRows` — which drives the selection toolbar — but never
+  touched the DataTable's internal checkbox state. Two visible problems:
+
+  - **Desync on success.** The toolbar disappeared while every row stayed visibly
+    ticked, because the checkboxes are table-internal state the grid couldn't
+    reach.
+
+  - **Lost selection on total failure.** When the run failed for _every_ row
+    (0 succeeded — a precondition error, say), the toolbar still vanished,
+    stranding the user with no way to retry the exact rows they'd picked.
+
+  The dialog-close handler now gates the reset on `result.succeeded > 0`: a total
+  failure keeps both the selection _and_ the toolbar (and skips the phantom
+  refetch) so the user can fix the cause and retry. When it does reset, a new
+  `selectionResetKey` prop on DataTable clears the internal checkbox selection in
+  lockstep with the toolbar, so the two never drift apart.
+
+- bce581a: Fix dependent (cascading) lookups: unlock on parent selection and enforce the
+  cascade filter on every candidate surface (#2215).
+
+  Two breaks made `depends_on` unusable end to end:
+
+  - **The gate never unlocked in create mode.** `LookupField` resolved dependent
+    values from `ctx.formValues` — a member `SchemaRendererContext` never had —
+    and nothing injected the `dependentValues` prop, so with a fresh record
+    (`ctx.data = {}`) the child lookup stayed disabled no matter what the user
+    picked in the parent field. The form renderer now injects its live form
+    values (the same reactive snapshot that drives field rules) as
+    `dependentValues` for data-source fields.
+  - **The Level-2 table picker bypassed the cascade.** The `depends_on` chain
+    only reached the quick-select popover filter; `RecordPickerDialog` (and the
+    search-first `PeoplePicker`) received just `lookup_filters`, listing the full
+    unfiltered record set. Both pickers now take a `baseFilter` — a hard
+    `$filter` constraint merged after `lookupFilters` and user filter-bar input,
+    so it can never be widened back out — and `LookupField` passes the dependent
+    chain there, shares the same filter with the popover query, and disables the
+    browse-all button while dependencies are missing.
+
+- c38d107: Fix view-level `FormField.visibleOn` (CEL) never taking effect (#2212).
+
+  The spec ships `visibleOn` as an Expression object `{ dialect: 'cel', source }`
+  (what the `P` template emits) or a bare string, but the whole chain dropped it:
+
+  - `sectionFields.ts` / `ObjectForm.tsx` only accepted the bare-string shape and
+    attached a dead `visible()` closure no renderer ever called — the Expression
+    object shape was silently discarded.
+  - The form renderer destructured `visibleOn` out of the field config and never
+    evaluated it.
+  - `RecordFormPage` dropped a `simple` form view's `sections` entirely, so
+    page-mode create/edit fell back to the raw schema (every field, no authored
+    selection/grouping) while the modal path honored the same view.
+  - `ObjectForm`'s grouped-sections path matched section fields by name only,
+    dropping per-field `visibleOn` overrides.
+
+  `visibleOn` now flows through normalization verbatim (both wire shapes) and is
+  evaluated reactively by the form renderer with the canonical expression engine
+  (`evalFieldPredicate` — same engine, record scope, and fail-open semantics as
+  field-level `visibleWhen`; both predicates must allow a field for it to show).
+  Sectioned/flat normalization also copies field-level `visibleWhen` /
+  `readonlyWhen` / `requiredWhen` rules it previously lost.
+
+- 7782698: fix(components): page:header record title honours `nameField` via the unified ADR-0079 resolver
+
+  The default console record detail page renders the synthesized `page:header`
+  (`buildDefaultPageSchema`, renderViaSchema default-on), whose record-chip title
+  chain probed `objSchema.primaryField` (not a spec property — always undefined),
+  `titleFormat`, then hardcoded `name`/`full_name`/`title`/`subject`/
+  `display_name`/`label` record keys. It never consulted the object's declared
+  `nameField`/`displayNameField`, so an object titled by e.g. `subject` rendered
+  `<ObjectLabel> <id-prefix>` as its H1 instead of the record's real name.
+
+  `PageHeaderRenderer` now resolves through `getRecordDisplayName(objSchema, data,
+{ deriveFromRecordKeys: false })` after the author overrides and before the
+  legacy probes — mirroring `DetailView.resolveDisplayTitle` so both headers
+  agree. `RecordDetailView`'s `primaryField` derivation and
+  `buildDefaultPageSchema`'s highlight-strip dedup also honour
+  `nameField`/`displayNameField`.
+
+- e84d64d: Block record-scoped toolbar actions launched with zero rows selected (#2210).
+
+  A flow/script action that also mounts on list rows (`locations` includes
+  `list_item`) has no record to run on when triggered from the list toolbar with
+  nothing selected — pre-fix the wizard opened anyway, collected input, and died
+  at its first record-bound node ("Update requires an ID or options.multi=true").
+  The console runtime now blocks up front with "select a row first", mirroring
+  the existing multi-selection guard. Pure object-level toolbar actions
+  (`locations: ['list_toolbar']` only) keep triggering without a record.
+
+  The action renderers (button/icon/menu/group) now forward the `locations`
+  declaration to the ActionRunner — previously it was dropped by their
+  allow-list payloads, so the runtime could not tell the two shapes apart.
+
+- Updated dependencies [8bf6295]
+- Updated dependencies [1948c5b]
+- Updated dependencies [9cd9be1]
+- Updated dependencies [c38d107]
+- Updated dependencies [790558b]
+  - @object-ui/types@11.4.0
+  - @object-ui/i18n@11.4.0
+  - @object-ui/core@11.4.0
+  - @object-ui/react@11.4.0
+  - @object-ui/react-runtime@11.4.0
+  - @object-ui/sdui-parser@11.4.0
+
 ## 11.3.0
 
 ### Minor Changes

package/dist/custom/mobile-dialog-content.d.ts

@@ -24,4 +24,24 @@ import * as DialogPrimitive from "@radix-ui/react-dialog";
  * interaction with the dialog's own dropdown — it must not close the dialog.
  */
 export declare function isInsidePopperLayer(target: Element | null | undefined): boolean;
+type InteractOutsideHandler = NonNullable<React.ComponentPropsWithoutRef<typeof DialogPrimitive.Content>['onInteractOutside']>;
+/**
+ * Popper-aware interact-outside guard for Radix Dialog/Sheet content.
+ *
+ * Covers a second dismissal path `isInsidePopperLayer` alone cannot: with a
+ * dropdown OPEN, one outside click must only close the dropdown — but
+ * radix-dialog@1.1.17 defers its outside-pointerdown verdict to the `click`
+ * phase (`deferPointerDownOutside`), while radix-select@2.3.1 dismisses and
+ * unregisters on `pointerdown`. By the deferred verdict the dialog has become
+ * the top layer, so it treats the dropdown-closing click as its own outside
+ * click and dismisses too (#2156).
+ *
+ * The guard snapshots "was a popper flyout open?" on every `pointerdown`
+ * (document capture phase — runs before Radix's bubble-phase dismissal
+ * unmounts the flyout) and swallows the pointer-initiated interact-outside
+ * that follows. Focus-driven interact-outside (Tab out) is untouched, as is a
+ * plain backdrop click with no flyout open.
+ */
+export declare function usePopperAwareInteractOutside(onInteractOutside?: InteractOutsideHandler): InteractOutsideHandler;
 export declare const MobileDialogContent: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export {};

package/dist/hooks/related-count-store.d.ts

@@ -56,6 +56,14 @@ declare function invalidateAll(): void;
  * probe is in flight or before the first request.
  */
 export declare function useRelatedCount(objectName: string | undefined, relField: string | undefined, parentId: string | undefined): number | undefined;
+/**
+ * Subscribe to the store's monotonic version. Put it in an effect dependency
+ * array to RE-RUN count probes after an invalidation (#2269) — invalidate
+ * deletes the cached numbers, and this version bump is what makes the probe
+ * effect fetch them again (fetchCount returns cached values without emitting,
+ * so the loop settles once every probed key is warm again).
+ */
+export declare function useRelatedCountVersion(): number;
 /**
  * Imperative store API for non-React callers (mutation handlers, tests).
  * Prefer `useRelatedCount` in components.

package/dist/index.d.ts

@@ -13,7 +13,7 @@ export { useResizeObserver } from './hooks/use-resize-observer';
 export type { ElementSize } from './hooks/use-resize-observer';
 export { useExportJob } from './hooks/use-export-job';
 export type { UseExportJobOptions, UseExportJobReturn } from './hooks/use-export-job';
-export { useRelatedCount, RelatedCountStore } from './hooks/related-count-store';
+export { useRelatedCount, useRelatedCountVersion, RelatedCountStore } from './hooks/related-count-store';
 export type { ControlType, ConfigField, ConfigSection, ConfigPanelSchema, } from './types/config-panel';
 export declare function initializeComponents(): boolean;
 export * from './debug';