@byline/host-tanstack-start 6.8.0 → 6.9.0

package/dist/admin-shell/chrome/admin-app-bar.d.ts

@@ -1,10 +1,3 @@
-/**
- * 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
- */
 import { type CurrentAdminUser } from '../../server-fns/auth/index.js';
 interface AdminAppBarProps {
     user: CurrentAdminUser;

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

@@ -12,13 +12,17 @@ import 'react-json-view-lite/dist/index.css';
 /**
  * JSON inspector view for a collection document.
  *
+ * Copy JSON and Download JSON render in the view menu's data group, beside the
+ * locale and depth controls whose selection they export.
+ *
  * Stable override handles: `.byline-api-section`, `.byline-api-container`,
- * `.byline-api-head`, `.byline-api-title`, `.byline-api-viewer`.
+ * `.byline-api-head`, `.byline-api-title`, `.byline-api-action`,
+ * `.byline-api-viewer`.
  */
 export declare const ApiView: ({ collectionDefinition, initialData, locale, depth, contentLocales, defaultContentLocale, }: {
     collectionDefinition: MultiCollectionDefinition;
     initialData: AnyCollectionSchemaTypes['UpdateType'];
-    /** Currently active locale from the route search param (undefined → all). */
+    /** Locale from the route search param (undefined → the default content locale). */
     locale?: string;
     /** Populate depth from the route search param (undefined → 0, no populate). */
     depth?: number;

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

@@ -1,6 +1,7 @@
-import { jsx, jsxs } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useState } from "react";
 import { useTranslation } from "@byline/i18n/react";
-import { Container, Section } from "@byline/ui/react";
+import { Container, CopyIcon, DownloadIcon, IconButton, Section, Tooltip, useToastManager } from "@byline/ui/react";
 import clsx from "clsx";
 import { JsonView, darkStyles } from "react-json-view-lite";
 import api_module from "./api.module.js";
@@ -10,6 +11,72 @@ const expandToFirstLevel = (level)=>level < 2;
 const ApiView = ({ collectionDefinition, initialData, locale, depth, contentLocales, defaultContentLocale })=>{
     const { labels, path } = collectionDefinition;
     const { t } = useTranslation('byline-admin');
+    const toastManager = useToastManager();
+    const [copyPending, setCopyPending] = useState(false);
+    const copyJson = async ()=>{
+        setCopyPending(true);
+        try {
+            await navigator.clipboard.writeText(JSON.stringify(initialData, null, 2));
+            toastManager.add({
+                title: t('collections.api.copied'),
+                data: {
+                    intent: 'success',
+                    iconType: 'success',
+                    icon: true,
+                    close: true
+                }
+            });
+        } catch  {
+            toastManager.add({
+                title: t('collections.api.copyFailed'),
+                data: {
+                    intent: 'danger',
+                    iconType: 'danger',
+                    icon: true,
+                    close: true
+                }
+            });
+        } finally{
+            setCopyPending(false);
+        }
+    };
+    const downloadJson = ()=>{
+        try {
+            const blob = new Blob([
+                JSON.stringify(initialData, null, 2)
+            ], {
+                type: 'application/json;charset=utf-8'
+            });
+            const url = URL.createObjectURL(blob);
+            const link = document.createElement('a');
+            try {
+                link.href = url;
+                const selection = [
+                    path,
+                    String(initialData.id),
+                    locale ?? defaultContentLocale
+                ];
+                if (null != depth && depth > 0) selection.push(`depth${depth}`);
+                const filename = selection.join('-').replace(/[^a-zA-Z0-9_-]/g, '-');
+                link.download = `${filename}.json`;
+                document.body.appendChild(link);
+                link.click();
+            } finally{
+                link.remove();
+                setTimeout(()=>URL.revokeObjectURL(url), 1000);
+            }
+        } catch  {
+            toastManager.add({
+                title: t('collections.api.downloadFailed'),
+                data: {
+                    intent: 'danger',
+                    iconType: 'danger',
+                    icon: true,
+                    close: true
+                }
+            });
+        }
+    };
     return /*#__PURE__*/ jsx(Section, {
         className: clsx('byline-api-section', api_module.section),
         children: /*#__PURE__*/ jsxs(Container, {
@@ -31,7 +98,46 @@ const ApiView = ({ collectionDefinition, initialData, locale, depth, contentLoca
                             locale: locale,
                             depth: depth,
                             contentLocales: contentLocales,
-                            defaultContentLocale: defaultContentLocale
+                            defaultContentLocale: defaultContentLocale,
+                            dataActions: /*#__PURE__*/ jsxs(Fragment, {
+                                children: [
+                                    /*#__PURE__*/ jsx(Tooltip, {
+                                        text: t('collections.api.copyJson'),
+                                        side: "bottom",
+                                        delay: 0,
+                                        children: /*#__PURE__*/ jsx(IconButton, {
+                                            type: "button",
+                                            size: "xs",
+                                            variant: "text",
+                                            className: "byline-view-menu-icon-button byline-api-action",
+                                            "aria-label": t('collections.api.copyJson'),
+                                            disabled: copyPending,
+                                            onClick: copyJson,
+                                            children: /*#__PURE__*/ jsx(CopyIcon, {
+                                                width: "18px",
+                                                height: "18px"
+                                            })
+                                        })
+                                    }),
+                                    /*#__PURE__*/ jsx(Tooltip, {
+                                        text: t('collections.api.downloadJson'),
+                                        side: "bottom",
+                                        delay: 0,
+                                        children: /*#__PURE__*/ jsx(IconButton, {
+                                            type: "button",
+                                            size: "xs",
+                                            variant: "text",
+                                            className: "byline-view-menu-icon-button byline-api-action",
+                                            "aria-label": t('collections.api.downloadJson'),
+                                            onClick: downloadJson,
+                                            children: /*#__PURE__*/ jsx(DownloadIcon, {
+                                                width: "20px",
+                                                height: "20px"
+                                            })
+                                        })
+                                    })
+                                ]
+                            })
                         })
                     ]
                 }),

package/dist/admin-shell/collections/api.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/collections/edit.js

@@ -297,6 +297,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData: loadedData,
         }
     };
     const publishedVersion = initialData?._publishedVersion ?? null;
+    const unavailableBlocks = initialData?._unavailableBlocks;
     const restoreWarnings = initialData?._restoreWarnings;
     const handleUnpublish = async ()=>{
         try {
@@ -863,6 +864,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData: loadedData,
                 contentLocales: contentLocales,
                 publishedVersion: publishedVersion,
                 restoreWarnings: restoreWarnings,
+                unavailableBlocks: unavailableBlocks,
                 nextStatus: nextStatus,
                 workflowStatuses: workflowStatuses,
                 onCancel: ()=>{

package/dist/admin-shell/collections/preview-link.js

@@ -1,7 +1,7 @@
 import { jsx } from "react/jsx-runtime";
 import { useState } from "react";
 import { useTranslation } from "@byline/i18n/react";
-import { ExternalLinkIcon, IconButton, useToastManager } from "@byline/ui/react";
+import { ExternalLinkIcon, IconButton, Tooltip, useToastManager } from "@byline/ui/react";
 import clsx from "clsx";
 import { enablePreviewModeFn } from "../../server-fns/preview/index.js";
 import { resolvePreviewUrl } from "./resolve-preview-url.js";
@@ -34,18 +34,22 @@ const PreviewLink = ({ collectionPath, doc, adminConfig, locale, className })=>{
             setBusy(false);
         }
     };
-    return /*#__PURE__*/ jsx(IconButton, {
-        className: clsx('byline-preview-link', className),
-        size: "xs",
-        variant: "text",
-        disabled: busy,
-        onClick: handleClick,
-        "aria-label": t('collections.preview.openAriaLabel'),
-        title: t('collections.preview.title'),
-        children: /*#__PURE__*/ jsx(ExternalLinkIcon, {
-            width: "20px",
-            height: "20px",
-            className: "byline-preview-link-icon"
+    return /*#__PURE__*/ jsx(Tooltip, {
+        text: t('collections.preview.title'),
+        side: "bottom",
+        delay: 0,
+        children: /*#__PURE__*/ jsx(IconButton, {
+            className: clsx('byline-preview-link', className),
+            size: "xs",
+            variant: "text",
+            disabled: busy,
+            onClick: handleClick,
+            "aria-label": t('collections.preview.openAriaLabel'),
+            children: /*#__PURE__*/ jsx(ExternalLinkIcon, {
+                width: "20px",
+                height: "20px",
+                className: "byline-preview-link-icon"
+            })
         })
     });
 };

package/dist/admin-shell/collections/view-menu.d.ts

@@ -5,6 +5,7 @@
  *
  * Copyright (c) Infonomic Company Limited
  */
+import type { ReactNode } from 'react';
 import type { CollectionAdminConfig, PreviewDocument } from '@byline/core';
 export type ViewMenuPaths = 'edit' | 'history' | 'api';
 export interface ContentLocaleOption {
@@ -27,7 +28,7 @@ export interface ContentLocaleOption {
  * route shell (which reads them from the host's i18n config) so this
  * component stays free of host-specific imports.
  */
-export declare const ViewMenu: ({ collection, documentId, activeView, locale, depth, contentLocales, defaultContentLocale, adminConfig, doc, }: {
+export declare const ViewMenu: ({ collection, documentId, activeView, locale, depth, contentLocales, defaultContentLocale, adminConfig, doc, dataActions, }: {
     /** Collection path (e.g. "docs", "news"). */
     collection: string;
     /** The document ID to navigate to. */
@@ -54,4 +55,10 @@ export declare const ViewMenu: ({ collection, documentId, activeView, locale, de
      * entirely (e.g. on the create route, where no doc exists yet).
      */
     doc?: PreviewDocument;
+    /**
+     * Controls that act on the data selected by the locale and depth controls
+     * (the API view's Copy / Download JSON). Rendered first, in the same group
+     * as those controls, so they wrap together ahead of the view navigation.
+     */
+    dataActions?: ReactNode;
 }) => import("react").JSX.Element;

package/dist/admin-shell/collections/view-menu.js

@@ -1,13 +1,13 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useEffect } from "react";
 import { useTranslation } from "@byline/i18n/react";
-import { Button, HistoryIcon, IconButton, Label, Select } from "@byline/ui/react";
+import { Button, HistoryIcon, IconButton, Label, Select, Tooltip } from "@byline/ui/react";
 import clsx from "clsx";
 import { getAdminRoutePath } from "../../routes/admin-path.js";
 import { useNavigate } from "../chrome/loose-router.js";
 import { PreviewLink } from "./preview-link.js";
 import view_menu_module from "./view-menu.module.js";
-const ViewMenu = ({ collection, documentId, activeView, locale, depth, contentLocales, defaultContentLocale, adminConfig, doc })=>{
+const ViewMenu = ({ collection, documentId, activeView, locale, depth, contentLocales, defaultContentLocale, adminConfig, doc, dataActions })=>{
     const navigate = useNavigate();
     const { t } = useTranslation('byline-admin');
     useEffect(()=>{
@@ -79,126 +79,143 @@ const ViewMenu = ({ collection, documentId, activeView, locale, depth, contentLo
     return /*#__PURE__*/ jsxs("div", {
         className: clsx('byline-view-menu', view_menu_module.root),
         children: [
-            /*#__PURE__*/ jsx(Label, {
-                className: clsx('muted byline-view-menu-label', view_menu_module.label),
-                id: "contentLocaleLabel",
-                htmlFor: "contentLocale",
-                label: t('collections.viewMenu.contentLocaleLabel')
-            }),
-            /*#__PURE__*/ jsx(Select, {
-                name: "contentLocale",
-                id: "contentLocale",
-                className: clsx('byline-view-menu-locale-select', view_menu_module.localeSelect),
-                size: "xs",
-                variant: "outlined",
-                value: locale ?? defaultContentLocale,
-                items: [
-                    ...'edit' !== activeView ? [
-                        {
-                            value: 'all',
-                            label: t('collections.viewMenu.localeAll')
-                        }
-                    ] : [],
-                    ...contentLocales.map((loc)=>({
-                            value: loc.code,
-                            label: loc.label
-                        }))
-                ],
-                onValueChange: handleLocaleChange
-            }),
-            'api' === activeView && /*#__PURE__*/ jsxs(Fragment, {
+            /*#__PURE__*/ jsxs("div", {
+                className: clsx('byline-view-menu-data', view_menu_module.group),
                 children: [
+                    dataActions,
                     /*#__PURE__*/ jsx(Label, {
                         className: clsx('muted byline-view-menu-label', view_menu_module.label),
-                        id: "populateDepthLabel",
-                        htmlFor: "populateDepth",
-                        label: t('collections.viewMenu.depthLabel')
+                        id: "contentLocaleLabel",
+                        htmlFor: "contentLocale",
+                        label: t('collections.viewMenu.contentLocaleLabel')
                     }),
                     /*#__PURE__*/ jsx(Select, {
-                        name: "populateDepth",
-                        id: "populateDepth",
-                        className: clsx('byline-view-menu-depth-select', view_menu_module.depthSelect),
+                        name: "contentLocale",
+                        id: "contentLocale",
+                        className: clsx('byline-view-menu-locale-select', view_menu_module.localeSelect),
                         size: "xs",
                         variant: "outlined",
-                        value: String(depth ?? 0),
+                        value: locale ?? defaultContentLocale,
                         items: [
-                            {
-                                value: '0',
-                                label: '0'
-                            },
-                            {
-                                value: '1',
-                                label: '1'
-                            },
-                            {
-                                value: '2',
-                                label: '2'
-                            },
-                            {
-                                value: '3',
-                                label: '3'
-                            }
+                            ...'edit' !== activeView ? [
+                                {
+                                    value: 'all',
+                                    label: t('collections.viewMenu.localeAll')
+                                }
+                            ] : [],
+                            ...contentLocales.map((loc)=>({
+                                    value: loc.code,
+                                    label: loc.label
+                                }))
                         ],
-                        onValueChange: handleDepthChange
+                        onValueChange: handleLocaleChange
+                    }),
+                    'api' === activeView && /*#__PURE__*/ jsxs(Fragment, {
+                        children: [
+                            /*#__PURE__*/ jsx(Label, {
+                                className: clsx('muted byline-view-menu-label', view_menu_module.label),
+                                id: "populateDepthLabel",
+                                htmlFor: "populateDepth",
+                                label: t('collections.viewMenu.depthLabel')
+                            }),
+                            /*#__PURE__*/ jsx(Select, {
+                                name: "populateDepth",
+                                id: "populateDepth",
+                                className: clsx('byline-view-menu-depth-select', view_menu_module.depthSelect),
+                                size: "xs",
+                                variant: "outlined",
+                                value: String(depth ?? 0),
+                                items: [
+                                    {
+                                        value: '0',
+                                        label: '0'
+                                    },
+                                    {
+                                        value: '1',
+                                        label: '1'
+                                    },
+                                    {
+                                        value: '2',
+                                        label: '2'
+                                    },
+                                    {
+                                        value: '3',
+                                        label: '3'
+                                    }
+                                ],
+                                onValueChange: handleDepthChange
+                            })
+                        ]
                     })
                 ]
             }),
-            doc && /*#__PURE__*/ jsx(PreviewLink, {
-                collectionPath: collection,
-                doc: doc,
-                adminConfig: adminConfig,
-                locale: locale,
-                className: clsx('byline-view-menu-icon-button', view_menu_module.iconButton)
-            }),
-            /*#__PURE__*/ jsx(IconButton, {
-                className: clsx('byline-view-menu-icon-button', view_menu_module.iconButton),
-                size: "xs",
-                variant: 'history' === activeView ? 'filled' : 'text',
-                onClick: ()=>navigate({
-                        to: getAdminRoutePath('collections', '$collection', '$id', 'history'),
-                        params: {
-                            collection,
-                            id: documentId
-                        },
-                        search: locale ? {
-                            locale
-                        } : {}
+            /*#__PURE__*/ jsxs("div", {
+                className: clsx('byline-view-menu-nav', view_menu_module.group),
+                children: [
+                    doc && /*#__PURE__*/ jsx(PreviewLink, {
+                        collectionPath: collection,
+                        doc: doc,
+                        adminConfig: adminConfig,
+                        locale: locale,
+                        className: clsx('byline-view-menu-icon-button', view_menu_module.iconButton)
                     }),
-                children: /*#__PURE__*/ jsx(HistoryIcon, {
-                    className: clsx('byline-view-menu-icon-button-icon', view_menu_module.iconButtonIcon)
-                })
-            }),
-            /*#__PURE__*/ jsx(Button, {
-                size: "xs",
-                variant: 'edit' === activeView ? 'filled' : 'outlined',
-                className: clsx('byline-view-menu-button', view_menu_module.button),
-                onClick: ()=>navigate({
-                        to: getAdminRoutePath('collections', '$collection', '$id'),
-                        params: {
-                            collection,
-                            id: documentId
-                        },
-                        search: locale ? {
-                            locale
-                        } : {}
+                    /*#__PURE__*/ jsx(Tooltip, {
+                        text: t('collections.breadcrumbs.history'),
+                        side: "bottom",
+                        delay: 0,
+                        children: /*#__PURE__*/ jsx(IconButton, {
+                            className: clsx('byline-view-menu-icon-button', view_menu_module.iconButton),
+                            size: "xs",
+                            variant: 'history' === activeView ? 'filled' : 'text',
+                            "aria-label": t('collections.breadcrumbs.history'),
+                            onClick: ()=>navigate({
+                                    to: getAdminRoutePath('collections', '$collection', '$id', 'history'),
+                                    params: {
+                                        collection,
+                                        id: documentId
+                                    },
+                                    search: locale ? {
+                                        locale
+                                    } : {}
+                                }),
+                            children: /*#__PURE__*/ jsx(HistoryIcon, {
+                                className: clsx('byline-view-menu-icon-button-icon', view_menu_module.iconButtonIcon)
+                            })
+                        })
                     }),
-                children: t('common.actions.edit')
-            }),
-            /*#__PURE__*/ jsx(Button, {
-                size: "xs",
-                variant: 'api' === activeView ? 'filled' : 'outlined',
-                className: clsx('byline-view-menu-button', view_menu_module.button),
-                onClick: ()=>navigate({
-                        to: getAdminRoutePath('collections', '$collection', '$id', 'api'),
-                        params: {
-                            collection,
-                            id: documentId
-                        },
-                        search: locale ? {
-                            locale
-                        } : {}
+                    /*#__PURE__*/ jsx(Button, {
+                        size: "xs",
+                        variant: 'edit' === activeView ? 'filled' : 'outlined',
+                        className: clsx('byline-view-menu-button', view_menu_module.button),
+                        onClick: ()=>navigate({
+                                to: getAdminRoutePath('collections', '$collection', '$id'),
+                                params: {
+                                    collection,
+                                    id: documentId
+                                },
+                                search: locale ? {
+                                    locale
+                                } : {}
+                            }),
+                        children: t('common.actions.edit')
                     }),
-                children: t('collections.viewMenu.apiButton')
+                    /*#__PURE__*/ jsx(Button, {
+                        size: "xs",
+                        variant: 'api' === activeView ? 'filled' : 'outlined',
+                        className: clsx('byline-view-menu-button', view_menu_module.button),
+                        onClick: ()=>navigate({
+                                to: getAdminRoutePath('collections', '$collection', '$id', 'api'),
+                                params: {
+                                    collection,
+                                    id: documentId
+                                },
+                                search: locale ? {
+                                    locale
+                                } : {}
+                            }),
+                        children: t('collections.viewMenu.apiButton')
+                    })
+                ]
             })
         ]
     });

package/dist/admin-shell/collections/view-menu.module.js

@@ -1,6 +1,7 @@
 import "./view-menu_module.css";
 const view_menu_module = {
     root: "root-vI0s6C",
+    group: "group-cJt4nm",
     label: "label-GcmVPn",
     localeSelect: "localeSelect-JCYsTa",
     depthSelect: "depthSelect-_wY_6k",

package/dist/admin-shell/collections/view-menu_module.css

@@ -1,11 +1,25 @@
 :is(.root-vI0s6C, .byline-view-menu) {
+  flex-wrap: wrap;
   align-items: center;
-  gap: .5rem;
+  gap: .5rem 1.25rem;
   margin-top: .5rem;
   margin-bottom: .5rem;
   display: flex;
 }
 
+@media (min-width: 40rem) {
+  :is(.root-vI0s6C, .byline-view-menu) {
+    justify-content: flex-end;
+  }
+}
+
+:is(.group-cJt4nm, .byline-view-menu-data, .byline-view-menu-nav) {
+  flex-wrap: wrap;
+  align-items: center;
+  gap: .5rem;
+  display: flex;
+}
+
 :is(.label-GcmVPn, .byline-view-menu-label) {
   color: var(--gray-400);
   padding-top: 2px;

package/dist/admin-shell/scheduled-publications/list.js

@@ -1,7 +1,5 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { DocumentMutationNotice } from "../document-mutation-notice.js";
-import { useDocumentMutationState } from "../document-mutation-state.js";
 import { useMemo, useState } from "react";
 import { useRouterState } from "@tanstack/react-router";
 import { deriveScheduledPublicationState } from "@byline/admin/react";
@@ -12,6 +10,8 @@ import { getAdminRoutePath } from "../../routes/admin-path.js";
 import { cancelCollectionDocumentScheduledPublish } from "../../server-fns/collections/index.js";
 import { Link, useNavigate } from "../chrome/loose-router.js";
 import { RouterPager } from "../chrome/router-pager.js";
+import { DocumentMutationNotice } from "../document-mutation-notice.js";
+import { useDocumentMutationState } from "../document-mutation-state.js";
 import list_module from "./list.module.js";
 const STATE_INTENT = {
     none: 'noeffect',

package/dist/admin-shell/singletons/preview-link.js

@@ -2,7 +2,7 @@
 import { jsx } from "react/jsx-runtime";
 import { useState } from "react";
 import { useTranslation } from "@byline/i18n/react";
-import { ExternalLinkIcon, IconButton, useToastManager } from "@byline/ui/react";
+import { ExternalLinkIcon, IconButton, Tooltip, useToastManager } from "@byline/ui/react";
 import clsx from "clsx";
 import { enablePreviewModeFn } from "../../server-fns/preview/index.js";
 function SingletonPreviewLink({ doc, adminConfig, locale, className }) {
@@ -36,18 +36,22 @@ function SingletonPreviewLink({ doc, adminConfig, locale, className }) {
             setBusy(false);
         }
     };
-    return /*#__PURE__*/ jsx(IconButton, {
-        className: clsx('byline-preview-link', className),
-        size: "xs",
-        variant: "text",
-        disabled: busy,
-        onClick: handleClick,
-        "aria-label": t('collections.preview.openAriaLabel'),
-        title: t('collections.preview.title'),
-        children: /*#__PURE__*/ jsx(ExternalLinkIcon, {
-            width: "20px",
-            height: "20px",
-            className: "byline-preview-link-icon"
+    return /*#__PURE__*/ jsx(Tooltip, {
+        text: t('collections.preview.title'),
+        side: "bottom",
+        delay: 0,
+        children: /*#__PURE__*/ jsx(IconButton, {
+            className: clsx('byline-preview-link', className),
+            size: "xs",
+            variant: "text",
+            disabled: busy,
+            onClick: handleClick,
+            "aria-label": t('collections.preview.openAriaLabel'),
+            children: /*#__PURE__*/ jsx(ExternalLinkIcon, {
+                width: "20px",
+                height: "20px",
+                className: "byline-preview-link-icon"
+            })
         })
     });
 }