@object-ui/components 4.5.0 → 4.7.0

package/dist/packages/components/src/custom/navigation-overlay.d.ts

@@ -44,6 +44,28 @@ export interface NavigationOverlayProps {
      * Popover trigger element (for popover mode).
      */
     popoverTrigger?: React.ReactNode;
+    /**
+     * Optional handler invoked when the user clicks the "Expand to full page"
+     * affordance in the drawer/modal header. Mirrors Linear / Notion / Airtable
+     * peek-to-full-page behavior — the consumer is responsible for closing the
+     * overlay and router-pushing to the full record route.
+     *
+     * When omitted, the expand button is not rendered.
+     */
+    onExpand?: () => void;
+    /** Optional label for the expand button (accessible name & tooltip). */
+    expandLabel?: string;
+    /**
+     * Optional storage key for persisting the user's manually-resized drawer
+     * width (drawer mode only). When provided, the drawer renders a drag
+     * handle on its left edge and remembers the resized width in
+     * `localStorage` across sessions. Use a stable, scoped key such as
+     * `'drawer-width:lead'` so different objects get independent widths.
+     *
+     * When omitted, the drag handle is hidden and width is fully controlled
+     * by the `width` prop / configured ceiling.
+     */
+    storageKey?: string;
 }
 /**
  * NavigationOverlay — renders record detail in the configured overlay mode.

package/dist/packages/components/src/hooks/related-count-store.d.ts

@@ -0,0 +1,70 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * Module-scoped store for related-list counts displayed in tab badges
+ * (e.g. "Contacts (12)" on an Account detail). The store deduplicates
+ * concurrent probes for the same key, lets the renderer subscribe with
+ * `useSyncExternalStore`, and exposes invalidation hooks so other parts
+ * of the runtime (bulk delete, inline create, optimistic update) can
+ * keep the badges in sync without a full page refetch.
+ *
+ * Design notes:
+ *  - One global Map keyed by `${objectName}::${relField}::${parentId}` so
+ *    a count fetched by one tab strip is reused by every other consumer.
+ *  - Subscribers receive *all* keyspace changes; coarse-grained but
+ *    badges are cheap to re-render and avoids per-key subscription noise.
+ *  - We deliberately avoid Zustand here — the surface area is one Map +
+ *    an emit() — and the React binding uses the built-in
+ *    `useSyncExternalStore` so we don't grow the dependency graph.
+ */
+interface ProbeFn {
+    (objectName: string, query: {
+        where?: Record<string, unknown>;
+        limit?: number;
+    }): Promise<{
+        total?: number;
+        data?: unknown[];
+    } | unknown[] | {
+        length?: number;
+    }>;
+}
+declare function getCount(objectName: string, relField: string | undefined, parentId: string | undefined): number | undefined;
+declare function setCount(objectName: string, relField: string | undefined, parentId: string | undefined, value: number): void;
+/**
+ * Probe a count via the supplied finder. Deduplicates concurrent requests
+ * for the same key and caches the resulting number until invalidated.
+ */
+declare function fetchCount(probe: ProbeFn, objectName: string, relField: string | undefined, parentId: string | undefined): Promise<number>;
+/**
+ * Invalidate every cached count that involves the given object. Called by
+ * mutation paths (e.g. ObjectGrid's onBulkDelete callback, drawer save) so
+ * the badge updates without forcing a parent re-render.
+ *
+ * When `parentId` is supplied, only entries whose parentId matches are
+ * dropped — useful for "I just created one Contact under Account X".
+ */
+declare function invalidate(objectName: string, parentId?: string): void;
+declare function invalidateAll(): void;
+/**
+ * Subscribe to the related-count store and read the count for a single
+ * (object, relField, parentId) triple. Returns `undefined` while the
+ * probe is in flight or before the first request.
+ */
+export declare function useRelatedCount(objectName: string | undefined, relField: string | undefined, parentId: string | undefined): number | undefined;
+/**
+ * Imperative store API for non-React callers (mutation handlers, tests).
+ * Prefer `useRelatedCount` in components.
+ */
+export declare const RelatedCountStore: {
+    get: typeof getCount;
+    set: typeof setCount;
+    fetch: typeof fetchCount;
+    invalidate: typeof invalidate;
+    invalidateAll: typeof invalidateAll;
+    _reset: () => void;
+};
+export {};

package/dist/packages/components/src/index.d.ts

@@ -12,6 +12,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 type { ControlType, ConfigField, ConfigSection, ConfigPanelSchema, } from './types/config-panel';
 export declare function initializeComponents(): boolean;
 export * from './debug';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/components",
-  "version": "4.5.0",
+  "version": "4.7.0",
   "type": "module",
   "license": "MIT",
   "description": "Standard UI component library for Object UI, built with Shadcn UI + Tailwind CSS",
@@ -69,10 +69,10 @@
     "tailwind-merge": "^3.6.0",
     "tailwindcss-animate": "^1.0.7",
     "vaul": "^1.1.2",
-    "@object-ui/core": "4.5.0",
-    "@object-ui/i18n": "4.5.0",
-    "@object-ui/react": "4.5.0",
-    "@object-ui/types": "4.5.0"
+    "@object-ui/core": "4.7.0",
+    "@object-ui/i18n": "4.7.0",
+    "@object-ui/react": "4.7.0",
+    "@object-ui/types": "4.7.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",