@object-ui/components 11.4.0 → 11.5.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @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

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';