@rebasepro/admin 0.9.1-canary.ff338b5 → 0.10.0

package/dist/preview/components/UrlComponentPreview.d.ts

@@ -1,7 +1,8 @@
 import React from "react";
 import { PreviewType } from "@rebasepro/types";
 import type { PreviewSize } from "../../types/components/PropertyPreviewProps";
-export declare function sanitizeUrl(url: string | undefined): string;
+import { sanitizeUrl } from "../util";
+export { sanitizeUrl };
 /**
  * @group Preview components
  */

package/dist/preview/util.d.ts

@@ -1,5 +1,6 @@
 import { CollectionSize } from "@rebasepro/types";
 import type { PreviewSize } from "../types/components/PropertyPreviewProps";
+export declare function sanitizeUrl(url: string | undefined): string;
 export declare const SMALL_THUMBNAIL = 40;
 export declare const MEDIUM_THUMBNAIL = 100;
 export declare const LARGE_THUMBNAIL = 200;

package/dist/util/view_mode.d.ts

@@ -0,0 +1,54 @@
+import type { CollectionConfig, ViewMode } from "@rebasepro/types";
+/**
+ * Query param that carries the active collection view mode across navigations.
+ */
+export declare const VIEW_MODE_PARAM = "__view";
+export declare const VIEW_MODES: ViewMode[];
+export declare const DEFAULT_VIEW_MODE: ViewMode;
+export type OpenEntityMode = "side_panel" | "full_screen" | "split" | "dialog";
+export declare const DEFAULT_OPEN_ENTITY_MODE: OpenEntityMode;
+export declare function isViewMode(value: string | null | undefined): value is ViewMode;
+/**
+ * Read the active view mode from a query string, if it holds a valid one.
+ *
+ * @param search a query string (e.g. `location.search`). Falls back to the
+ *        current browser location when omitted.
+ */
+export declare function getViewModeFromSearch(search?: string): ViewMode | null;
+/**
+ * Append the active view mode to a URL so the target route keeps rendering the
+ * view the user was last looking at.
+ *
+ * Every entity/collection navigation must go through this — a missed call site
+ * silently resets the user's view mode mid-session.
+ *
+ * @param url the URL to decorate. May already contain a query string and/or hash.
+ * @param search query string to read the view mode from. Defaults to the
+ *        current browser location.
+ */
+export declare function withViewMode(url: string, search?: string): string;
+/**
+ * Resolve the view mode for a collection, honouring the documented priority:
+ * URL param > saved user config > collection default.
+ */
+export declare function resolveViewMode({ collection, search, savedViewMode }: {
+    collection?: Pick<CollectionConfig<any>, "defaultViewMode">;
+    search?: string;
+    savedViewMode?: ViewMode | null;
+}): ViewMode;
+/**
+ * Resolve how clicking an entity should present it.
+ *
+ * An explicit `collection.openEntityMode` always wins. Otherwise the mode is
+ * derived from the active view mode, so the presentation suits the surface the
+ * user is looking at: a board keeps its columns behind an overlay, a wide table
+ * hands the entity the full width, and list/card views use master-detail.
+ *
+ * This is the single source of truth — row clicks, find-by-id and the router
+ * must all resolve through it, otherwise the same entity opens differently
+ * depending on how it was reached.
+ */
+export declare function resolveOpenEntityMode({ collection, viewMode }: {
+    collection?: Pick<CollectionConfig<any>, "openEntityMode">;
+    viewMode?: ViewMode;
+}): OpenEntityMode;