@byline/host-tanstack-start 4.16.0 → 4.18.0

package/dist/admin-shell/chrome/admin-menu-drawer.js

@@ -5,9 +5,9 @@ import { ADMIN_PERMISSIONS_ABILITIES } from "@byline/admin/admin-permissions";
 import { ADMIN_ROLES_ABILITIES } from "@byline/admin/admin-roles";
 import { ADMIN_USERS_ABILITIES } from "@byline/admin/admin-users";
 import { ANALYTICS_ABILITIES } from "@byline/admin/analytics";
-import { collectionAbilityKey, getAdminConfig } from "@byline/core";
+import { documentAbilityKey, getAdminConfig } from "@byline/core";
 import { useTranslation } from "@byline/i18n/react";
-import { ActivityIcon, AnalyticsIcon, CalendarIcon, HomeIcon, RolesIcon, SettingsSlidersIcon, Tooltip, UserIcon, UsersIcon } from "@byline/ui/react";
+import { ActivityIcon, AnalyticsIcon, CalendarIcon, DashboardIcon, RolesIcon, SettingsSlidersIcon, Tooltip, UserIcon, UsersIcon } from "@byline/ui/react";
 import clsx from "clsx";
 import { useSwipeable } from "react-swipeable";
 import { useAbilities } from "../../integrations/abilities.js";
@@ -59,7 +59,7 @@ function AdminMenuDrawer({ analyticsEnabled = false, scheduledPublicationEnabled
     const canReadPermissions = has(ADMIN_PERMISSIONS_ABILITIES.read);
     const canReadActivity = has(ADMIN_ACTIVITY_ABILITIES.read);
     const canReadAnalytics = analyticsEnabled && has(ANALYTICS_ABILITIES.read);
-    const canSeeScheduledPublications = scheduledPublicationEnabled && getAdminConfig().collections.some((collection)=>has(collectionAbilityKey(collection.path, 'changeStatus')) && has(collectionAbilityKey(collection.path, 'publish')));
+    const canSeeScheduledPublications = scheduledPublicationEnabled && getAdminConfig().collections.some((collection)=>has(documentAbilityKey(collection, 'changeStatus')) && has(documentAbilityKey(collection, 'publish')));
     const showAdminSection = canReadUsers || canReadRoles || canReadPermissions || canReadActivity;
     const handlers = useSwipeable({
         onSwipedLeft: ()=>{
@@ -91,23 +91,13 @@ function AdminMenuDrawer({ analyticsEnabled = false, scheduledPublicationEnabled
                     /*#__PURE__*/ jsx(MenuItem, {
                         to: getAdminRoutePath(),
                         label: t('chrome.menu.dashboard'),
-                        icon: /*#__PURE__*/ jsx(HomeIcon, {
+                        icon: /*#__PURE__*/ jsx(DashboardIcon, {
                             width: "20px",
                             height: "20px"
                         }),
                         pathname: pathname,
                         compact: compact
                     }),
-                    canSeeScheduledPublications && /*#__PURE__*/ jsx(MenuItem, {
-                        to: getAdminRoutePath('scheduled-publications'),
-                        label: t('chrome.menu.scheduledPublications'),
-                        icon: /*#__PURE__*/ jsx(CalendarIcon, {
-                            width: "18px",
-                            height: "18px"
-                        }),
-                        pathname: pathname,
-                        compact: compact
-                    }),
                     canReadAnalytics && /*#__PURE__*/ jsx(MenuItem, {
                         to: getAdminRoutePath('analytics'),
                         label: t('chrome.menu.analytics'),
@@ -118,6 +108,16 @@ function AdminMenuDrawer({ analyticsEnabled = false, scheduledPublicationEnabled
                         pathname: pathname,
                         compact: compact
                     }),
+                    canSeeScheduledPublications && /*#__PURE__*/ jsx(MenuItem, {
+                        to: getAdminRoutePath('scheduled-publications'),
+                        label: t('chrome.menu.scheduledPublications'),
+                        icon: /*#__PURE__*/ jsx(CalendarIcon, {
+                            width: "18px",
+                            height: "18px"
+                        }),
+                        pathname: pathname,
+                        compact: compact
+                    }),
                     showAdminSection && /*#__PURE__*/ jsxs(Fragment, {
                         children: [
                             /*#__PURE__*/ jsx("li", {

package/dist/admin-shell/chrome/dashboard.js

@@ -1,5 +1,5 @@
 import { jsx, jsxs } from "react/jsx-runtime";
-import { filterReadableCollections, getAdminConfig, getWorkflowStatuses, groupCollectionsForAdmin } from "@byline/core";
+import { filterReadableCollections, getAdminConfig, getWorkflowStatuses, groupCollectionsForAdmin, isSingleton } from "@byline/core";
 import { useTranslation } from "@byline/i18n/react";
 import { Card, Container, Section } from "@byline/ui/react";
 import clsx from "clsx";
@@ -119,6 +119,40 @@ function CollectionCard({ collection, stats }) {
         ]
     });
 }
+function SingletonCard({ singleton }) {
+    const { t } = useTranslation('byline-admin');
+    const destination = getAdminRoutePath('singletons', '$singleton');
+    const params = {
+        singleton: singleton.path
+    };
+    return /*#__PURE__*/ jsx(Card, {
+        children: /*#__PURE__*/ jsx(Link, {
+            to: destination,
+            params: params,
+            className: clsx('byline-dashboard-card-link', dashboard_module.cardLink),
+            children: /*#__PURE__*/ jsx(Card.Header, {
+                children: /*#__PURE__*/ jsxs("div", {
+                    className: clsx('byline-dashboard-card-header', dashboard_module.cardHeader),
+                    children: [
+                        /*#__PURE__*/ jsx(Card.Title, {
+                            className: clsx('byline-dashboard-card-title', dashboard_module.cardTitle),
+                            children: /*#__PURE__*/ jsx("span", {
+                                className: clsx('byline-dashboard-title-text', dashboard_module.titleText),
+                                children: singleton.label
+                            })
+                        }),
+                        /*#__PURE__*/ jsx(Card.Description, {
+                            className: "muted",
+                            children: t("dashboard.collectionDescription", {
+                                label: singleton.label
+                            })
+                        })
+                    ]
+                })
+            })
+        })
+    });
+}
 function AdminDashboard({ statsMap }) {
     const config = getAdminConfig();
     const { t } = useTranslation('byline-admin');
@@ -147,10 +181,12 @@ function AdminDashboard({ statsMap }) {
                         }),
                         /*#__PURE__*/ jsx("div", {
                             className: clsx('byline-dashboard-grid', dashboard_module.grid),
-                            children: bucket.collections.map((collection)=>/*#__PURE__*/ jsx(CollectionCard, {
-                                    collection: collection,
-                                    stats: statsMap[collection.path]
-                                }, collection.path))
+                            children: bucket.collections.map((resource)=>isSingleton(resource) ? /*#__PURE__*/ jsx(SingletonCard, {
+                                    singleton: resource
+                                }, resource.path) : /*#__PURE__*/ jsx(CollectionCard, {
+                                    collection: resource,
+                                    stats: statsMap[resource.path]
+                                }, resource.path))
                         })
                     ]
                 }, bucket.name ?? '__ungrouped__'))

package/dist/admin-shell/chrome/dashboard.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+export {};

package/dist/admin-shell/chrome/router-pager.d.ts

@@ -13,6 +13,13 @@ interface RouterPageProps extends PaginationProps {
  * A convenience pager wrapped around uikit's Pagination with `asChild`
  * targets that delegate to TanStack Router's `<Link>`. `asChild` merges
  * the existing button styles into the rendered Link.
+ *
+ * `smoothScrollToTop` is for a pager sitting *below* a long list: turning a
+ * page there should carry the reader back to the top rather than leaving them
+ * at the foot of a fresh page. It suppresses the router's own instant
+ * `resetScroll` and animates instead — so the component owes an actual
+ * scroll, which was the missing half: the flag disabled the reset and put
+ * nothing in its place, so a bottom pager did not scroll at all.
  */
 export declare function RouterPager({ className, smoothScrollToTop, 'aria-label': ariaLabel, ...rest }: RouterPageProps): React.JSX.Element;
 export {};

package/dist/admin-shell/chrome/router-pager.js

@@ -1,11 +1,19 @@
 import { jsx } from "react/jsx-runtime";
+import { useCallback } from "react";
 import { useRouterState } from "@tanstack/react-router";
 import { ChevronLeftDoubleIcon, ChevronLeftIcon, ChevronRightDoubleIcon, ChevronRightIcon, Pagination } from "@byline/ui/react";
 import { Link } from "./loose-router.js";
+import { scrollWindowToTop } from "./scroll-to-top.js";
 function RouterPager({ className, smoothScrollToTop, 'aria-label': ariaLabel, ...rest }) {
     const location = useRouterState({
         select: (s)=>s.location
     });
+    const handleScrollToTop = useCallback(()=>{
+        if (true !== smoothScrollToTop) return;
+        scrollWindowToTop();
+    }, [
+        smoothScrollToTop
+    ]);
     return /*#__PURE__*/ jsx(Pagination, {
         variant: "dashboard",
         ...rest,
@@ -19,6 +27,7 @@ function RouterPager({ className, smoothScrollToTop, 'aria-label': ariaLabel, ..
                     return /*#__PURE__*/ jsx(Pagination.First, {
                         render: item.disabled ? /*#__PURE__*/ jsx("div", {}) : /*#__PURE__*/ jsx(Link, {
                             resetScroll: true !== smoothScrollToTop,
+                            onClick: handleScrollToTop,
                             to: location.pathname,
                             search: params
                         }),
@@ -32,6 +41,7 @@ function RouterPager({ className, smoothScrollToTop, 'aria-label': ariaLabel, ..
                     return /*#__PURE__*/ jsx(Pagination.Previous, {
                         render: item.disabled ? /*#__PURE__*/ jsx("div", {}) : /*#__PURE__*/ jsx(Link, {
                             resetScroll: true !== smoothScrollToTop,
+                            onClick: handleScrollToTop,
                             to: location.pathname,
                             search: params
                         }),
@@ -46,6 +56,7 @@ function RouterPager({ className, smoothScrollToTop, 'aria-label': ariaLabel, ..
                     return /*#__PURE__*/ jsx(Pagination.Number, {
                         render: item.disabled ? /*#__PURE__*/ jsx("div", {}) : /*#__PURE__*/ jsx(Link, {
                             resetScroll: true !== smoothScrollToTop,
+                            onClick: handleScrollToTop,
                             to: location.pathname,
                             search: params
                         }),
@@ -61,6 +72,7 @@ function RouterPager({ className, smoothScrollToTop, 'aria-label': ariaLabel, ..
                     return /*#__PURE__*/ jsx(Pagination.Next, {
                         render: item.disabled ? /*#__PURE__*/ jsx("div", {}) : /*#__PURE__*/ jsx(Link, {
                             resetScroll: true !== smoothScrollToTop,
+                            onClick: handleScrollToTop,
                             to: location.pathname,
                             search: params
                         }),
@@ -75,6 +87,7 @@ function RouterPager({ className, smoothScrollToTop, 'aria-label': ariaLabel, ..
                     return /*#__PURE__*/ jsx(Pagination.Last, {
                         render: item.disabled ? /*#__PURE__*/ jsx("div", {}) : /*#__PURE__*/ jsx(Link, {
                             resetScroll: true !== smoothScrollToTop,
+                            onClick: handleScrollToTop,
                             to: location.pathname,
                             search: params
                         }),

package/dist/admin-shell/chrome/scroll-to-top.d.ts

@@ -0,0 +1,20 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+/**
+ * Return the reader to the top of the page.
+ *
+ * Separate from `RouterPager` so the behaviour can be asserted without
+ * mounting a router. `smoothScrollToTop` suppresses TanStack's instant
+ * `resetScroll` in favour of an animated one, which makes a missing
+ * implementation silent — the page simply does not move. That is what
+ * happened to every pager carrying the flag.
+ *
+ * Honours `prefers-reduced-motion`: those readers still arrive at the top,
+ * without the travel.
+ */
+export declare function scrollWindowToTop(): void;

package/dist/admin-shell/chrome/scroll-to-top.js

@@ -0,0 +1,9 @@
+function scrollWindowToTop() {
+    if ("u" < typeof window) return;
+    const prefersReducedMotion = window.matchMedia?.('(prefers-reduced-motion: reduce)').matches;
+    window.scrollTo({
+        top: 0,
+        behavior: true === prefersReducedMotion ? 'auto' : 'smooth'
+    });
+}
+export { scrollWindowToTop };

package/dist/admin-shell/collections/api.d.ts

@@ -5,7 +5,7 @@
  *
  * Copyright (c) Infonomic Company Limited
  */
-import type { CollectionDefinition } from '@byline/core';
+import type { MultiCollectionDefinition } from '@byline/core';
 import type { AnyCollectionSchemaTypes } from '@byline/core/zod-schemas';
 import type { ContentLocaleOption } from './view-menu.js';
 import 'react-json-view-lite/dist/index.css';
@@ -16,7 +16,7 @@ import 'react-json-view-lite/dist/index.css';
  * `.byline-api-head`, `.byline-api-title`, `.byline-api-viewer`.
  */
 export declare const ApiView: ({ collectionDefinition, initialData, locale, depth, contentLocales, defaultContentLocale, }: {
-    collectionDefinition: CollectionDefinition;
+    collectionDefinition: MultiCollectionDefinition;
     initialData: AnyCollectionSchemaTypes['UpdateType'];
     /** Currently active locale from the route search param (undefined → all). */
     locale?: string;

package/dist/admin-shell/collections/create.d.ts

@@ -5,9 +5,9 @@
  *
  * Copyright (c) Infonomic Company Limited
  */
-import type { CollectionAdminConfig, CollectionDefinition } from '@byline/core';
+import type { CollectionAdminConfig, MultiCollectionDefinition } from '@byline/core';
 export declare const CreateView: ({ collectionDefinition, adminConfig, initialData, from, }: {
-    collectionDefinition: CollectionDefinition;
+    collectionDefinition: MultiCollectionDefinition;
     adminConfig?: CollectionAdminConfig;
     initialData?: Record<string, any>;
     /** URL-encoded list search state to return to on cancel — see list-return-state.ts. */

package/dist/admin-shell/collections/create.js

@@ -72,6 +72,7 @@ const CreateView = ({ collectionDefinition, adminConfig, initialData, from })=>{
                 status: 'failed',
                 message: description
             });
+            throw err;
         }
     };
     return /*#__PURE__*/ jsx(Section, {

package/dist/admin-shell/collections/edit.d.ts

@@ -5,11 +5,11 @@
  *
  * Copyright (c) Infonomic Company Limited
  */
-import type { CollectionAdminConfig, CollectionDefinition } from '@byline/core';
+import type { CollectionAdminConfig, MultiCollectionDefinition } from '@byline/core';
 import type { AnyCollectionSchemaTypes } from '@byline/core/zod-schemas';
 import type { ContentLocaleOption } from './view-menu.js';
 export declare const EditView: ({ collectionDefinition, adminConfig, initialData, locale, contentLocales, defaultContentLocale, returnSearch, }: {
-    collectionDefinition: CollectionDefinition;
+    collectionDefinition: MultiCollectionDefinition;
     adminConfig?: CollectionAdminConfig;
     initialData: AnyCollectionSchemaTypes['UpdateType'];
     locale?: string;

package/dist/admin-shell/collections/edit.js

@@ -632,6 +632,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                 status: 'failed',
                 message: description
             });
+            throw err;
         }
     };
     return /*#__PURE__*/ jsx(Section, {

package/dist/admin-shell/collections/history.d.ts

@@ -5,28 +5,20 @@
  *
  * Copyright (c) Infonomic Company Limited
  */
-import type { CollectionAdminConfig, CollectionDefinition, WorkflowStatus } from '@byline/core';
+import type { CollectionAdminConfig, MultiCollectionDefinition, WorkflowStatus } from '@byline/core';
 import type { AnyCollectionSchemaTypes } from '@byline/core/zod-schemas';
 import { type DocumentHistoryData } from './document-history.js';
 import type { ContentLocaleOption } from './view-menu.js';
 export declare const HistoryView: ({ collectionDefinition, adminConfig, data, auditLog, workflowStatuses, currentDocument, contentLocales, defaultContentLocale, }: {
-    collectionDefinition: CollectionDefinition;
+    collectionDefinition: MultiCollectionDefinition;
     adminConfig?: CollectionAdminConfig;
     data: AnyCollectionSchemaTypes['HistoryType'] & {
-        /**
-         * Audit display labels (the acting user per version), resolved admin-side from each
-         * version's `createdBy` id (see docs/07-auth-and-security/02-auditability.md — Workstream 1). Ids
-         * absent from the map belong to deleted users.
-         */
+        /** Admin-resolved acting-user labels keyed by raw version actor id. */
         actors?: Record<string, {
             label: string;
         }>;
     };
-    /**
-     * Document-grain audit log for the "Document history" tab (docs/07-auth-and-security/02-auditability.md —
-     * Workstream 3): the non-versioned path / available-locales / status
-     * changes and the deletion event, with admin-resolved actor labels.
-     */
+    /** Collection-only document-grain audit log. */
     auditLog?: DocumentHistoryData;
     workflowStatuses?: WorkflowStatus[];
     currentDocument?: Record<string, unknown> | null;