@rebasepro/plugin-data-enhancement 0.0.1-canary.4d4fb3e → 0.0.1-canary.ca2cb6e

package/dist/common/src/collections/CollectionRegistry.d.ts

@@ -3,9 +3,11 @@ export declare class CollectionRegistry {
     private collectionsByTableName;
     private collectionsBySlug;
     private rootCollections;
+    private cachedCollectionsList;
     private rawCollectionsByTableName;
     private rawCollectionsBySlug;
     private rawRootCollections;
+    private cachedRawCollectionsList;
     private lastRawInputSnapshot;
     constructor(collections?: EntityCollection[]);
     reset(): void;
@@ -21,6 +23,12 @@ export declare class CollectionRegistry {
     register(collection: EntityCollection, rawCollection?: EntityCollection): void;
     private _registerRecursively;
     normalizeCollection(collection: EntityCollection): EntityCollection;
+    /**
+     * Extract Relation[] from properties that have inline relation config (i.e. `target` is set).
+     * This allows developers to define relations directly on properties without a separate
+     * `relations[]` entry on the collection.
+     */
+    private extractRelationsFromProperties;
     private normalizeProperties;
     private normalizeProperty;
     get(path: string): EntityCollection | undefined;

package/dist/common/src/util/entities.d.ts

@@ -34,3 +34,25 @@ export declare function getRelationFrom<M extends Record<string, unknown>>(entit
 export declare function normalizeToEntityRelation(value: unknown): EntityRelation | null;
 export declare function traverseValuesProperties<M extends Record<string, unknown>>(inputValues: Partial<EntityValues<M>>, properties: Properties, operation: (value: unknown, property: Property) => unknown): EntityValues<M> | undefined;
 export declare function traverseValueProperty(inputValue: unknown, property: Property, operation: (value: unknown, property: Property) => unknown): unknown;
+/**
+ * Relation reference types used throughout the server layer.
+ * These replace the 50+ manual `{ id, path, __type: "relation" }` constructions.
+ */
+export interface RelationRef {
+    readonly id: string | number;
+    readonly path: string;
+    readonly __type: "relation";
+}
+export interface RelationRefWithData extends RelationRef {
+    readonly data: Entity;
+}
+/**
+ * Create a lightweight relation stub for CMS views.
+ * Replaces inline `{ id, path, __type: "relation" }` object literals.
+ */
+export declare function createRelationRef(id: string | number, path: string): RelationRef;
+/**
+ * Create a hydrated relation reference that includes the full entity data.
+ * Used when entity data has been pre-fetched (e.g., via batch loading or JOINs).
+ */
+export declare function createRelationRefWithData(id: string | number, path: string, data: Entity): RelationRefWithData;

package/dist/common/src/util/relations.d.ts

@@ -1,12 +1,22 @@
-import { EntityCollection, PostgresCollection, Property, Relation } from "@rebasepro/types";
-export declare function sanitizeRelation(relation: Partial<Relation>, sourceCollection: PostgresCollection): Relation;
-export declare function resolveCollectionRelations(collection: PostgresCollection): Record<string, Relation>;
+import { EntityCollection, Property, Relation } from "@rebasepro/types";
+export declare function sanitizeRelation(relation: Partial<Relation>, sourceCollection: EntityCollection): Relation;
+export declare function resolveCollectionRelations(collection: EntityCollection): Record<string, Relation>;
 export declare function resolvePropertyRelation({ propertyKey, property, sourceCollection }: {
     propertyKey: string;
     property: Property;
-    sourceCollection: PostgresCollection;
+    sourceCollection: EntityCollection;
 }): Relation | undefined;
 export declare function getTableName(collection: EntityCollection): string;
 export declare function getTableVarName(tableName: string): string;
 export declare function getEnumVarName(tableName: string, propName: string): string;
 export declare function getColumnName(fullColumn: string): string;
+/**
+ * Look up a relation by key with forgiving normalization.
+ *
+ * `resolveCollectionRelations` stores each relation under a single canonical
+ * key (no aliases). This helper tries the given key as-is, then falls back to
+ * slug form (underscores → hyphens) and snake_case form (hyphens → underscores)
+ * so that callers that receive a key from external input (URL path segments,
+ * user-provided config, etc.) can still find the right entry.
+ */
+export declare function findRelation(resolvedRelations: Record<string, Relation>, key: string): Relation | undefined;

package/dist/common/src/util/resolutions.d.ts

@@ -19,7 +19,7 @@ export type ResolvePropertyProps<M extends Record<string, unknown> = Record<stri
     authController: AuthController;
 };
 export declare function resolveProperty<M extends Record<string, unknown> = Record<string, unknown>>(props: ResolvePropertyProps<M>): Property | null;
-export declare function resolveRelationProperty(property: RelationProperty, relations: Relation[]): RelationProperty;
+export declare function resolveRelationProperty(property: RelationProperty, relations: Relation[], propertyKey?: string): RelationProperty;
 /**
  * Resolve enum aliases for a string or number property
  * @param property

package/dist/core/src/components/UserDisplay.d.ts

@@ -2,6 +2,6 @@ import { User } from "@rebasepro/types";
 /**
  * Component to render a single user with name and email
  */
-export declare function UserDisplay({ user, }: {
+export declare function UserDisplay({ user }: {
     user: User | null;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/core/src/components/UserSelectPopover.d.ts

@@ -59,4 +59,4 @@ export interface UserSelectPopoverProps {
  *
  * @group Components
  */
-export declare function UserSelectPopover({ selectedUser, onUserSelected, users, loading, currentUser, defaultLabel, renderLimit, className, size, }: UserSelectPopoverProps): import("react/jsx-runtime").JSX.Element;
+export declare function UserSelectPopover({ selectedUser, onUserSelected, users, loading, currentUser, defaultLabel, renderLimit, className, size }: UserSelectPopoverProps): import("react/jsx-runtime").JSX.Element;

package/dist/core/src/components/common/types.d.ts

@@ -5,6 +5,10 @@ export type EntityCollectionTableController<M extends Record<string, any>> = {
      * This cell is displayed as selected
      */
     selectedCell?: SelectedCellProps<any>;
+    /**
+     * Store used to sync selection state across cells efficiently.
+     */
+    selectionStore?: any;
     /**
      * Select a table cell
      * @param cell

package/dist/core/src/core/PluginLifecycleManager.d.ts

@@ -11,7 +11,7 @@ import type { RebasePlugin, RebaseContext } from "@rebasepro/types";
  *
  * @internal
  */
-export declare function PluginLifecycleManager({ plugins, context, }: {
+export declare function PluginLifecycleManager({ plugins, context }: {
     plugins: RebasePlugin[];
     context: RebaseContext;
 }): null;

package/dist/core/src/core/PluginProviderStack.d.ts

@@ -13,7 +13,7 @@ import React from "react";
  *
  * @group Core
  */
-export declare function PluginProviderStack({ plugins, scope, scopeProps, children, }: {
+export declare function PluginProviderStack({ plugins, scope, scopeProps, children }: {
     plugins: RebasePlugin[];
     scope: "root" | "form";
     scopeProps?: Record<string, unknown>;

package/dist/core/src/core/RebaseProps.d.ts

@@ -100,7 +100,7 @@ export type RebaseProps<USER extends User> = {
      * If you are using the Rebase user management plugin, this
      * prop will be implemented automatically.
      */
-    userManagement?: UserManagementDelegate;
+    userManagement?: UserManagementDelegate<USER>;
     /**
      * Plugins loaded in the CMS
      */

package/dist/core/src/hooks/data/useEntityFetch.d.ts

@@ -18,6 +18,14 @@ export interface EntityFetchResult<M extends Record<string, any>> {
     dataLoading: boolean;
     dataLoadingError?: Error;
 }
+/**
+ * Pre-populate the entity fetch cache with entities loaded from a collection.
+ * This allows entity detail views to render instantly using cached data,
+ * while the background fetch/listener brings in fresh data.
+ * @param path - The collection path (e.g. "products")
+ * @param entities - Array of entities to cache
+ */
+export declare function populateEntityFetchCache<M extends Record<string, any>>(path: string, entities: Entity<M>[]): void;
 /**
  * This hook is used to fetch an entity.
  * It gives real time updates if the driver supports it.

package/dist/core/src/hooks/data/useUserSelector.d.ts

@@ -0,0 +1,31 @@
+import { User } from "@rebasepro/types";
+export interface UserSelectorItem {
+    uid: string;
+    label: string;
+    description?: string;
+    user: User;
+}
+export interface UseUserSelectorProps {
+    /**
+     * Page size for pagination. Defaults to 10.
+     */
+    pageSize?: number;
+}
+export interface UserSelectorController {
+    items: UserSelectorItem[];
+    isLoading: boolean;
+    error: Error | undefined;
+    search: (searchString: string) => void;
+    loadMore: () => void;
+    hasMore: boolean;
+    getUser: (uid: string) => User | null;
+}
+/**
+ * Hook to manage user selection with server-side search and pagination.
+ * Similar to useRelationSelector but for the UserManagementDelegate.
+ *
+ * If the delegate provides `searchUsers`, this hook uses server-side
+ * search/pagination. Otherwise it falls back to client-side filtering
+ * over the in-memory `users` array.
+ */
+export declare function useUserSelector({ pageSize }?: UseUserSelectorProps): UserSelectorController;

package/dist/core/src/hooks/index.d.ts

@@ -2,6 +2,7 @@ export * from "./data/useData";
 export * from "./data/useCollectionFetch";
 export * from "./data/useEntityFetch";
 export * from "./data/useRelationSelector";
+export * from "./data/useUserSelector";
 export * from "./data/save";
 export * from "./data/delete";
 export * from "./useUnsavedChangesDialog";

package/dist/core/src/hooks/useBackendStorageSource.d.ts

@@ -1,7 +1,7 @@
 /**
  * React hook for using backend storage API as a StorageSource
  */
-import { StorageSource } from '@rebasepro/types';
+import { StorageSource } from "@rebasepro/types";
 export interface BackendStorageSourceProps {
     /**
      * Backend API URL (e.g., 'http://localhost:3001')

package/dist/core/src/hooks/useStudioBridge.d.ts

@@ -43,7 +43,7 @@ export declare const StudioBridgeContext: React.Context<StudioBridge>;
  * </StudioBridgeProvider>
  * ```
  */
-export declare function StudioBridgeProvider({ value, children, }: {
+export declare function StudioBridgeProvider({ value, children }: {
     value: Partial<StudioBridge>;
     children: React.ReactNode;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/core/src/hooks/useTranslation.d.ts

@@ -1,5 +1,5 @@
 /**
- * Internal hook for translating FireCMS UI strings.
+ * Internal hook for translating Rebase UI strings.
  *
  * Uses the `rebase_core` i18next namespace that is initialised by
  * `RebaseI18nProvider`. Do NOT use `react-i18next` directly in internal

package/dist/core/src/i18n/RebaseI18nProvider.d.ts

@@ -9,7 +9,7 @@ export interface RebaseI18nProviderProps {
     /** BCP-47 locale tag, e.g. "en", "es", "fr". Defaults to "en". */
     locale?: string;
     /**
-     * Override or extend any FireCMS UI string, keyed by locale.
+     * Override or extend any Rebase UI string, keyed by locale.
      *
      * @example
      * translations={{
@@ -22,10 +22,10 @@ export interface RebaseI18nProviderProps {
     };
 }
 /**
- * Initialises a dedicated i18next instance for FireCMS's internal UI strings.
+ * Initialises a dedicated i18next instance for Rebase's internal UI strings.
  *
  * This instance is isolated from any app-level i18next configuration the
- * consumer may have. Mount this at the top of the FireCMS component tree.
+ * consumer may have. Mount this at the top of the Rebase component tree.
  *
  * @internal
  */

package/dist/core/src/locales/en.d.ts

@@ -3,7 +3,7 @@ import { RebaseTranslations } from "@rebasepro/types";
  * English baseline translations for @rebasepro/core.
  *
  * This is the single source of truth for all default UI strings.
- * Override any key via the `translations` prop on FireCMS entry-point components.
+ * Override any key via the `translations` prop on Rebase entry-point components.
  *
  * @group Core
  */

package/dist/core/src/locales/es.d.ts

@@ -3,7 +3,7 @@ import { RebaseTranslations } from "@rebasepro/types";
  * Spanish baseline translations for @rebasepro/core.
  *
  * This is the single source of truth for all default UI strings in Spanish.
- * Override any key via the `translations` prop on FireCMS entry-point components.
+ * Override any key via the `translations` prop on Rebase entry-point components.
  *
  * @group Core
  */

package/dist/core/src/util/constants.d.ts

@@ -0,0 +1 @@
+export declare const STUDIO_NAVIGATION_GROUPS: string[];