@rebasepro/cms 0.22.0 → 0.23.0

package/dist/preview/util.d.ts

@@ -1,4 +1,5 @@
 import { CollectionSize } from "@rebasepro/cms-types";
+import type { DateProperty } from "@rebasepro/types";
 import type { PreviewSize } from "../types/components/PropertyPreviewProps.js";
 export declare function sanitizeUrl(url: string | undefined): string;
 export declare const SMALL_THUMBNAIL = 40;
@@ -6,3 +7,27 @@ export declare const MEDIUM_THUMBNAIL = 100;
 export declare const LARGE_THUMBNAIL = 200;
 export declare function getThumbnailMeasure(size: PreviewSize): number;
 export declare function getPreviewSizeFrom(size: CollectionSize): PreviewSize;
+/**
+ * The zone a date property is shown and entered in.
+ *
+ * A `columnType: "date"` column holds a calendar day with no zone. It travels
+ * as that day's UTC midnight, and Postgres keeps the date part of whatever it
+ * is given, so it is read and written in UTC. In the browser's own zone a
+ * stored 15th showed as the 14th west of Greenwich, and a 15th picked east of
+ * it was stored as the 14th.
+ *
+ * Any other date is shown in the property's declared `timezone`, or the
+ * browser's when it declares none.
+ */
+export declare function getDatePropertyTimezone(property: DateProperty): string | undefined;
+/**
+ * Whether a date property is picked and shown as a day or a day and a time. A
+ * `date` column holds no time, so it is a day whatever `mode` says.
+ */
+export declare function getDatePropertyMode(property: DateProperty): "date" | "date_time" | undefined;
+/**
+ * Whether a value has nothing to show: absent, a blank string, an empty list.
+ * A preview of one draws the empty marker, which is the right thing for a
+ * column of values and the wrong thing for the one line under a record's name.
+ */
+export declare function isEmptyPreviewValue(value: unknown): boolean;

package/dist/util/navigation_utils.d.ts

@@ -1,10 +1,10 @@
-import type { UrlController, SidePanelController, AdminCollection } from "@rebasepro/cms-types";
+import type { UrlController, SidePanelBindingProps, SidePanelController, AdminCollection } from "@rebasepro/cms-types";
 export { removeInitialAndTrailingSlashes, removeInitialSlash, removeTrailingSlash, addInitialSlash, getLastSegment, resolveCollectionPathIds, getCollectionBySlugWithin, getCollectionPathsCombinations } from "@rebasepro/app";
 /**
  * Navigate to a entity using either a side panel or full-screen mode.
  * This is an admin-specific UI concern and lives here (not in common).
  */
-export declare function navigateToEntity({ openEntityMode, collection, entityId, copy, path, selectedTab, defaultValues, sidePanelController, onClose, navigation, replace }: {
+export declare function navigateToEntity({ openEntityMode, collection, entityId, copy, path, selectedTab, defaultValues, sidePanelController, onClose, onUpdate, navigation, replace }: {
     openEntityMode?: "side_panel" | "full_screen" | "split" | "dialog";
     collection?: AdminCollection;
     entityId?: string | number;
@@ -22,6 +22,18 @@ export declare function navigateToEntity({ openEntityMode, collection, entityId,
     path: string;
     sidePanelController: SidePanelController;
     onClose?: () => void;
+    /**
+     * Called when the side panel or dialog saves the record. A full-screen
+     * record replaces the view that opened it, and that view reads
+     * everything again when it comes back, so nothing is called there.
+     */
+    onUpdate?: SidePanelBindingProps["onUpdate"];
     navigation: UrlController;
     replace?: boolean;
 }): void;
+/**
+ * Whether `pathname` is the record at `entityPath` or somewhere below it — one
+ * of its tabs, its `/edit`. A path segment, not a string prefix:
+ * `/c/products/12` is another record, not a place inside `/c/products/1`.
+ */
+export declare function isPathWithinRecord(pathname: string, entityPath: string): boolean;

package/dist/util/view_mode.d.ts

@@ -29,32 +29,26 @@ export declare function isViewMode(value: string | null | undefined, customKeys?
  * @param customKeys keys of the collection's custom views, if any.
  */
 export declare function getViewModeFromSearch(search?: string, customKeys?: readonly 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;
 /**
  * Carry the whole of the collection list's URL state onto a navigation target.
  *
- * `withViewMode` exists because losing the view mode mid-session is jarring.
- * Everything else the list writes to the URL — the search string, the filters,
- * the sort — is state the user built up deliberately, and losing *that* is
- * worse: opening a record from a search and pressing back returned an
- * unfiltered list with an empty search box, so the search had to be retyped
- * for every record they wanted to look at.
+ * Every navigation to the collection or one of its records goes through this —
+ * a missed call site silently resets the list mid-session. The list reads its
+ * state back from the URL on each navigation, so the view mode, the search
+ * string, the filters and the sort all have to travel: a URL without them
+ * returned an unfiltered list with an empty search box, and the search had to
+ * be retyped for every record the user wanted to look at.
  *
  * Copies every param the list currently has rather than an allowlist, because
  * filters are encoded under the field's own name — there is no fixed set to
  * list. Params already on the target win: the caller is more specific.
  *
+ * Carries whatever `__view` holds rather than validating it. These call sites
+ * are navigations with no collection in hand, so they cannot know whether
+ * `map` is one of *this* collection's custom views; checking against the
+ * built-ins here would drop every custom view on the first record click. The
+ * binding validates on read, which is where the answer is knowable.
+ *
  * @param url the URL to decorate. May carry a query string and/or a hash.
  * @param search query string to read from. Defaults to the browser location.
  */

package/dist/{util-DB31IoJE.js → util-CC0ozHoD.js}

@@ -51,7 +51,40 @@ function getPreviewSizeFrom(size) {
 		default: throw Error("Missing mapping value in getPreviewSizeFrom: " + size);
 	}
 }
+/**
+* The zone a date property is shown and entered in.
+*
+* A `columnType: "date"` column holds a calendar day with no zone. It travels
+* as that day's UTC midnight, and Postgres keeps the date part of whatever it
+* is given, so it is read and written in UTC. In the browser's own zone a
+* stored 15th showed as the 14th west of Greenwich, and a 15th picked east of
+* it was stored as the 14th.
+*
+* Any other date is shown in the property's declared `timezone`, or the
+* browser's when it declares none.
+*/
+function getDatePropertyTimezone(property) {
+	return property.columnType === "date" ? "UTC" : property.timezone;
+}
+/**
+* Whether a date property is picked and shown as a day or a day and a time. A
+* `date` column holds no time, so it is a day whatever `mode` says.
+*/
+function getDatePropertyMode(property) {
+	return property.columnType === "date" ? "date" : property.mode;
+}
+/**
+* Whether a value has nothing to show: absent, a blank string, an empty list.
+* A preview of one draws the empty marker, which is the right thing for a
+* column of values and the wrong thing for the one line under a record's name.
+*/
+function isEmptyPreviewValue(value) {
+	if (value === void 0 || value === null) return true;
+	if (typeof value === "string") return value.trim() === "";
+	if (Array.isArray(value)) return value.length === 0;
+	return false;
+}
 //#endregion
-export { getThumbnailMeasure as n, sanitizeUrl as r, getPreviewSizeFrom as t };
+export { isEmptyPreviewValue as a, getThumbnailMeasure as i, getDatePropertyTimezone as n, sanitizeUrl as o, getPreviewSizeFrom as r, getDatePropertyMode as t };
 
-//# sourceMappingURL=util-DB31IoJE.js.map
+//# sourceMappingURL=util-CC0ozHoD.js.map

package/dist/util-CC0ozHoD.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util-CC0ozHoD.js","names":[],"sources":["../src/preview/util.ts"],"sourcesContent":["import { CollectionSize } from \"@rebasepro/cms-types\";\nimport type { DateProperty } from \"@rebasepro/types\";\nimport type { PreviewSize } from \"../types/components/PropertyPreviewProps\";\n/**\n * The schemes a preview link may use — everything else becomes `about:blank`.\n *\n * An allowlist, because the blocklist it replaces could be walked around and\n * the walk-arounds are not exotic. Browsers strip tabs, newlines and carriage\n * returns from a URL before parsing the scheme, so `java\\tscript:alert(1)` and\n * `java%0ascript:…` navigate exactly as `javascript:` does while matching none\n * of the names a blocklist knows. A leading control character does the same.\n *\n * Turned around, none of that matters: a string is either one of these four\n * schemes or it is not a link this panel will follow. `mailto:` and `tel:` are\n * here because a contact field is an ordinary thing to preview; `data:` is not,\n * even for images — a preview renders an `<img>` from its own value rather than\n * navigating to one.\n *\n * Relative URLs are allowed and deliberately: a preview commonly holds\n * `/uploads/x.png`, and a string with no scheme cannot carry one.\n */\nconst ALLOWED_URL_SCHEMES = new Set([\"http:\", \"https:\", \"mailto:\", \"tel:\"]);\n\nexport function sanitizeUrl(url: string | undefined): string {\n    if (!url) return \"about:blank\";\n\n    // The characters a browser removes before it decides what the scheme is.\n    // Stripped here for the same reason, so this function is looking at the\n    // string the browser will act on rather than the one it was handed.\n    //\n    // The control characters are the point, so the rule that objects to them is\n    // off for this line rather than the expression rewritten to hide them from\n    // it: `java\\tscript:` and `java\\nscript:` are the bypasses this exists to\n    // close, and a regex that cannot name a control character cannot remove one.\n    // eslint-disable-next-line no-control-regex\n    const trimmed = url.trim().replace(/[\\u0000-\\u001F\\u007F]/g, \"\");\n    if (!trimmed) return \"about:blank\";\n\n    // No scheme at all — a relative link, which cannot navigate anywhere the\n    // page could not already reach.\n    if (!/^[a-z][a-z0-9+.-]*:/i.test(trimmed)) return trimmed;\n\n    try {\n        // `new URL` normalizes percent-encoding and case, so\n        // `JaVaScRiPt%3aalert(1)` is judged as what it resolves to. The base is\n        // there only so a protocol-relative `//host/path` parses.\n        const parsed = new URL(trimmed, \"https://example.invalid\");\n        return ALLOWED_URL_SCHEMES.has(parsed.protocol) ? trimmed : \"about:blank\";\n    } catch {\n        return \"about:blank\";\n    }\n}\n\nexport const SMALL_THUMBNAIL = 40;\nexport const MEDIUM_THUMBNAIL = 100;\nexport const LARGE_THUMBNAIL = 200;\n\nexport function getThumbnailMeasure(size: PreviewSize): number {\n    if (size === \"small\")\n        return SMALL_THUMBNAIL;\n    else if (size === \"medium\")\n        return MEDIUM_THUMBNAIL;\n    else if (size === \"large\")\n        return LARGE_THUMBNAIL;\n    else throw Error(\"Thumbnail size not mapped\");\n}\n\nexport function getPreviewSizeFrom(size: CollectionSize): PreviewSize {\n    switch (size) {\n        case \"xs\":\n        case \"s\":\n        case \"m\":\n            return \"small\";\n        case \"l\":\n            return \"medium\";\n        case \"xl\":\n            return \"large\";\n        default:\n            throw Error(\"Missing mapping value in getPreviewSizeFrom: \" + size);\n    }\n}\n\n/**\n * The zone a date property is shown and entered in.\n *\n * A `columnType: \"date\"` column holds a calendar day with no zone. It travels\n * as that day's UTC midnight, and Postgres keeps the date part of whatever it\n * is given, so it is read and written in UTC. In the browser's own zone a\n * stored 15th showed as the 14th west of Greenwich, and a 15th picked east of\n * it was stored as the 14th.\n *\n * Any other date is shown in the property's declared `timezone`, or the\n * browser's when it declares none.\n */\nexport function getDatePropertyTimezone(property: DateProperty): string | undefined {\n    return property.columnType === \"date\" ? \"UTC\" : property.timezone;\n}\n\n/**\n * Whether a date property is picked and shown as a day or a day and a time. A\n * `date` column holds no time, so it is a day whatever `mode` says.\n */\nexport function getDatePropertyMode(property: DateProperty): \"date\" | \"date_time\" | undefined {\n    return property.columnType === \"date\" ? \"date\" : property.mode;\n}\n\n/**\n * Whether a value has nothing to show: absent, a blank string, an empty list.\n * A preview of one draws the empty marker, which is the right thing for a\n * column of values and the wrong thing for the one line under a record's name.\n */\nexport function isEmptyPreviewValue(value: unknown): boolean {\n    if (value === undefined || value === null) return true;\n    if (typeof value === \"string\") return value.trim() === \"\";\n    if (Array.isArray(value)) return value.length === 0;\n    return false;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqBA,IAAM,sCAAsB,IAAI,IAAI;CAAC;CAAS;CAAU;CAAW;AAAM,CAAC;AAE1E,SAAgB,YAAY,KAAiC;CACzD,IAAI,CAAC,KAAK,OAAO;CAWjB,MAAM,UAAU,IAAI,KAAK,CAAC,CAAC,QAAQ,0BAA0B,EAAE;CAC/D,IAAI,CAAC,SAAS,OAAO;CAIrB,IAAI,CAAC,uBAAuB,KAAK,OAAO,GAAG,OAAO;CAElD,IAAI;EAIA,MAAM,SAAS,IAAI,IAAI,SAAS,yBAAyB;EACzD,OAAO,oBAAoB,IAAI,OAAO,QAAQ,IAAI,UAAU;CAChE,QAAQ;EACJ,OAAO;CACX;AACJ;AAMA,SAAgB,oBAAoB,MAA2B;CAC3D,IAAI,SAAS,SACT,OAAA;MACC,IAAI,SAAS,UACd,OAAA;MACC,IAAI,SAAS,SACd,OAAA;MACC,MAAM,MAAM,2BAA2B;AAChD;AAEA,SAAgB,mBAAmB,MAAmC;CAClE,QAAQ,MAAR;EACI,KAAK;EACL,KAAK;EACL,KAAK,KACD,OAAO;EACX,KAAK,KACD,OAAO;EACX,KAAK,MACD,OAAO;EACX,SACI,MAAM,MAAM,kDAAkD,IAAI;CAC1E;AACJ;;;;;;;;;;;;;AAcA,SAAgB,wBAAwB,UAA4C;CAChF,OAAO,SAAS,eAAe,SAAS,QAAQ,SAAS;AAC7D;;;;;AAMA,SAAgB,oBAAoB,UAA0D;CAC1F,OAAO,SAAS,eAAe,SAAS,SAAS,SAAS;AAC9D;;;;;;AAOA,SAAgB,oBAAoB,OAAyB;CACzD,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM,OAAO;CAClD,IAAI,OAAO,UAAU,UAAU,OAAO,MAAM,KAAK,MAAM;CACvD,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO,MAAM,WAAW;CAClD,OAAO;AACX"}