@obelism/content 0.19.2 → 0.21.0

package/dist/bridge.mjs

@@ -1,4 +1,4 @@
-import { P as PREVIEW_PARAMS, U as UID_ATTRIBUTE, E as ENTRY_ATTRIBUTE, a as PRODUCT_ATTRIBUTE, b as PRODUCT_HANDLE_ATTRIBUTE } from './preview-jcmxxj92.mjs';
+import { P as PREVIEW_PARAMS, U as UID_ATTRIBUTE, E as ENTRY_ATTRIBUTE, C as COLLECTION_ATTRIBUTE, a as COLLECTION_HANDLE_ATTRIBUTE, b as PRODUCT_ATTRIBUTE, c as PRODUCT_HANDLE_ATTRIBUTE } from './preview-fu3qtgfx.mjs';
 import { SITE_EDITING_COOKIE, SITE_REQUEST_HEADER } from './site.mjs';
 import { n as normalizeUrl, D as DEFAULT_URL } from './config-c6qktlz6.mjs';
 
@@ -10,7 +10,7 @@ import { n as normalizeUrl, D as DEFAULT_URL } from './config-c6qktlz6.mjs';
 //
 // Sites tag a block's clickable element with `data-numbers-id={block._uid}`
 // and load Obelism numbers' script; the CMS reads the rates from numbers
-// (the CMS's content/docs/guides/visual-editor.mdx, "Click rates").
+// (the CMS's content/docs/guides/canvas.mdx, "Click rates").
 const DEFAULT_STATS_LABELS = {
     clicked: '{rate}% clicked',
     title: '{clickers} of {viewers} visitors of its page clicked it in the last 30 days ({clicks} clicks)'
@@ -163,6 +163,91 @@ const mountStatsOverlay = (win, { selector, onSelect, labels: labelOverrides })=
     };
 };
 
+// Content's canvas shows a whole page in a frame as tall as the page, so the
+// frame is the page's height, not the screen's. Sizes in viewport-height
+// units (`vh`, `svh`, `lvh`, `dvh`) would follow it: a `100vh` hero makes
+// the page taller, the canvas makes the frame taller, and the hero grows
+// again. The editor sends the height the frame stands for (`viewport`), and
+// this rewrites those units in the page's stylesheets as pixels of that
+// height. Stylesheets from another origin can't be read and keep theirs.
+const UNIT = /(-?\d*\.?\d+)(?:s|l|d)?vh\b/g;
+// A value with its viewport-height units as pixels of `height`, or null when
+// it has none.
+const freezeValue = (value, height)=>{
+    UNIT.lastIndex = 0;
+    if (!UNIT.test(value)) return null;
+    return value.replace(UNIT, (_, amount)=>`${Math.round(Number(amount) * height / 100 * 100) / 100}px`);
+};
+const freezeStyle = (style, height)=>{
+    for(let index = 0; index < style.length; index++){
+        const property = style.item(index);
+        const frozen = freezeValue(style.getPropertyValue(property), height);
+        if (frozen !== null) {
+            style.setProperty(property, frozen, style.getPropertyPriority(property));
+        }
+    }
+};
+// Style rules, and those inside @media, @supports and @layer blocks.
+const freezeRules = (rules, height)=>{
+    for (const rule of Array.from(rules)){
+        const { style, cssRules } = rule;
+        if (style) freezeStyle(style, height);
+        if (cssRules) freezeRules(cssRules, height);
+    }
+};
+const createViewportUnits = (doc)=>{
+    const done = new WeakSet();
+    let height = null;
+    let observer = null;
+    let scheduled = false;
+    const freezeSheets = ()=>{
+        if (height === null) return;
+        for (const sheet of Array.from(doc.styleSheets)){
+            if (done.has(sheet)) continue;
+            let rules;
+            try {
+                rules = sheet.cssRules;
+            } catch  {
+                continue;
+            }
+            done.add(sheet);
+            freezeRules(rules, height);
+        }
+        doc.querySelectorAll('[style*="vh"]').forEach((element)=>{
+            freezeStyle(element.style, height);
+        });
+    };
+    return {
+        freeze (next) {
+            // Once: the frame stands for one screen size until it reloads.
+            if (height !== null || !(next > 0)) return;
+            height = next;
+            freezeSheets();
+            const View = doc.defaultView?.MutationObserver;
+            if (!View) return;
+            // Once per frame, however much the page changes in it.
+            observer = new View(()=>{
+                if (scheduled) return;
+                scheduled = true;
+                const run = ()=>{
+                    scheduled = false;
+                    freezeSheets();
+                };
+                if (doc.defaultView?.requestAnimationFrame) {
+                    doc.defaultView.requestAnimationFrame(run);
+                } else run();
+            });
+            observer.observe(doc.documentElement, {
+                childList: true,
+                subtree: true
+            });
+        },
+        destroy () {
+            observer?.disconnect();
+        }
+    };
+};
+
 // The site's half of the visual editor (the CMS's public/bridge.js, as a
 // module). Inside the editor's iframe it outlines blocks, tells the editor
 // which one was clicked, hands the editor's live, unsaved entry to listeners
@@ -171,10 +256,10 @@ const mountStatsOverlay = (win, { selector, onSelect, labels: labelOverrides })=
 // Messages are only exchanged with the CMS origin, and only with the parent
 // window:
 // - site → editor: { source: 'obelism-content-bridge', type: 'ready' |
-//   'select' | 'prompt' | 'undo', uid?, id?, prompt? }
+//   'size' | 'select' | 'prompt' | 'undo', uid?, id?, prompt?, height? }
 // - editor → site: { source: 'obelism-content-editor', type: 'connect' |
 //   'update' | 'select' | 'saved' | 'published' | 'features' |
-//   'promptResult' | 'promptState' | 'stats', … }
+//   'promptResult' | 'promptState' | 'stats' | 'viewport', … }
 const BRIDGE_SOURCE = 'obelism-content-bridge';
 const EDITOR_SOURCE = 'obelism-content-editor';
 // How long a prompt may take before it counts as failed.
@@ -228,6 +313,7 @@ const INERT_METHODS = {
     prompt: inertPrompt,
     createPage: ()=>Promise.reject(new Error('New pages are made on the site itself')),
     createProductPage: ()=>Promise.reject(new Error('Product pages are made on the site itself')),
+    createCollectionPage: ()=>Promise.reject(new Error('Collection pages are made on the site itself')),
     view: onlyWhileEditingSite,
     applyJson: onlyWhileEditingSite,
     openForm: (_container, options = {})=>{
@@ -286,6 +372,7 @@ const createBridge = (win, cmsOrigin)=>{
         entryId: params.get(PREVIEW_PARAMS.entry),
         environment: params.get(PREVIEW_PARAMS.environment),
         product: null,
+        collection: null,
         on: emitter.on,
         getState: ()=>state,
         ...INERT_METHODS,
@@ -340,9 +427,32 @@ const createBridge = (win, cmsOrigin)=>{
     };
     doc.addEventListener('click', onClick, true);
     cleanup.push(()=>doc.removeEventListener('click', onClick, true));
-    const ready = ()=>send('ready', {
-            url: win.location.href
+    // The page's height, which an editor on another origin can't read: the
+    // canvas makes its frame as tall as the page. With `ready`, and as `size`
+    // whenever it changes.
+    const pageHeight = ()=>Math.ceil(Math.max(doc.documentElement.scrollHeight, doc.body?.scrollHeight ?? 0));
+    let sentHeight = 0;
+    const ready = ()=>{
+        sentHeight = pageHeight();
+        send('ready', {
+            url: win.location.href,
+            height: sentHeight
         });
+    };
+    const Observer = win.ResizeObserver;
+    if (typeof Observer === 'function') {
+        const observer = new Observer(()=>{
+            const height = pageHeight();
+            if (height === sentHeight) return;
+            sentHeight = height;
+            send('size', {
+                height
+            });
+        });
+        observer.observe(doc.documentElement);
+        if (doc.body) observer.observe(doc.body);
+        cleanup.push(()=>observer.disconnect());
+    }
     // Prompts waiting for the editor's answer, by id.
     const pending = new Map();
     let nextId = 0;
@@ -406,6 +516,8 @@ const createBridge = (win, cmsOrigin)=>{
             settle(id)?.reject(new Error('The bridge was destroyed'));
         }
     });
+    const viewportUnits = createViewportUnits(doc);
+    cleanup.push(()=>viewportUnits.destroy());
     const onMessage = (event)=>{
         if (event.origin !== cmsOrigin || event.source !== win.parent) return;
         const data = event.data;
@@ -438,6 +550,10 @@ const createBridge = (win, cmsOrigin)=>{
                 statsVisible: data.visible !== false
             });
             showStats();
+        } else if (data.type === 'viewport' && typeof data.height === 'number') {
+            // The canvas: the frame is as tall as the page (`size`), so `vh`
+            // sizes are fixed at the screen height it stands for.
+            viewportUnits.freeze(data.height);
         } else if (data.type === 'promptState') {
             setState({
                 canUndo: data.canUndo === true
@@ -479,6 +595,7 @@ const wrapScriptBridge = (script, params)=>{
         entryId: script.entryId,
         environment: params.get(PREVIEW_PARAMS.environment),
         product: null,
+        collection: null,
         on: (event, listener)=>{
             if (event === 'update' && !forwardingUpdates) {
                 forwardingUpdates = true;
@@ -507,6 +624,7 @@ const DEFAULT_PROMPT_LABELS = {
     minimize: 'Minimize, to see the page',
     expand: 'Expand',
     scopeEntry: 'Whole page',
+    scopeNoPage: 'Whole page',
     scopeBlock: 'Selected block',
     clearBlock: 'Edit the whole page instead',
     working: 'Working on it…',
@@ -542,7 +660,11 @@ const DEFAULT_PROMPT_LABELS = {
     addProductPage: 'Add a product page',
     addingProductPage: 'Making the product page…',
     addedProductPage: 'Opening the product page…',
-    productPageHint: 'This product has no page yet. Add one for what the store doesn’t say.'
+    productPageHint: 'This product has no page yet. Add one for what the store doesn’t say.',
+    addCollectionPage: 'Add a collection page',
+    addingCollectionPage: 'Making the collection page…',
+    addedCollectionPage: 'Opening the collection page…',
+    collectionPageHint: 'This collection has no page yet. Add one for what goes around its products.'
 };
 const SIDE_KEY = 'obelism-content-prompt-side';
 // How far the pointer moves before it drags the box, not clicks it.
@@ -632,7 +754,7 @@ button:disabled { cursor: not-allowed; }
 button:focus-visible { outline: 2px solid rgb(var(--theme-accent-rgb)); outline-offset: 2px; }
 
 /* Closed: one floating pill that reads like an empty field, with the mark. */
-.bar { display: flex; justify-content: center; }
+.bar { display: flex; flex-wrap: wrap; justify-content: center; align-items: center; gap: 8px; }
 .pill {
 	display: flex; align-items: center; gap: 12px; width: min(560px, 100%); height: 56px;
 	padding: 0 22px 0 26px; border-radius: var(--border-radius-pill);
@@ -763,7 +885,7 @@ button.chip:disabled { opacity: .5; }
 
 /* On the site: storing the draft, and the way out. */
 .footer {
-	display: flex; align-items: center; gap: 8px; padding: 10px 12px 10px 22px;
+	display: flex; flex-wrap: wrap; align-items: center; gap: 8px; padding: 10px 12px 10px 22px;
 	border-top: 1px solid rgb(var(--theme-border-rgb) / .2);
 	background: rgb(var(--theme-background-actions-rgb) / .45);
 }
@@ -921,8 +1043,9 @@ const mountPromptBox = (doc, bridge, options = {})=>{
         className: 'action chip',
         type: 'button'
     }, icon(doc, 'newPage'), labels.newPage);
-    // A product the site marks (editableProduct) without a page of its own:
-    // one click makes its product page, which the page then shows.
+    // A product (collection) the site marks (editableProduct,
+    // editableCollection) without a page of its own: one click makes its
+    // page, which the page then shows.
     const addProduct = element(doc, 'button', {
         className: 'action chip product',
         type: 'button'
@@ -1017,6 +1140,16 @@ const mountPromptBox = (doc, bridge, options = {})=>{
     }, element(doc, 'label', {
         className: 'search'
     }, icon(doc, 'search'), search), optionList, pagesNote);
+    // The page's own controls (`actions`), in the footer while open and next
+    // to the pill while closed.
+    const actionsInFooter = element(doc, 'slot');
+    actionsInFooter.name = 'actions-footer';
+    const actionsInBar = element(doc, 'slot');
+    actionsInBar.name = 'actions-bar';
+    if (options.actions) {
+        options.actions.slot = 'actions-bar';
+        host.appendChild(options.actions);
+    }
     const unsaved = element(doc, 'span', {
         className: 'unsaved'
     });
@@ -1043,7 +1176,7 @@ const mountPromptBox = (doc, bridge, options = {})=>{
         className: 'footer'
     }, pageChip, unsaved, element(doc, 'span', {
         className: 'spacer'
-    }), signOut, save, publish);
+    }), actionsInFooter, signOut, save, publish);
     const panel = element(doc, 'form', {
         className: 'panel'
     }, status, pathRow, input, formBox, toolbar, pagesSection, footer);
@@ -1051,7 +1184,7 @@ const mountPromptBox = (doc, bridge, options = {})=>{
         className: 'root'
     }, element(doc, 'div', {
         className: 'bar'
-    }, pill, viewing), panel);
+    }, pill, viewing, actionsInBar), panel);
     shadow.append(element(doc, 'style', {
         textContent: CSS
     }), root);
@@ -1080,7 +1213,7 @@ const mountPromptBox = (doc, bridge, options = {})=>{
         dragged = false;
         if (event.button !== 0 || !event.isPrimary) return;
         const target = event.target;
-        const control = target.closest('button, input, textarea, iframe, a, label, .pages, .form');
+        const control = target.closest('button, input, textarea, select, iframe, a, label, .pages, .form');
         if (control && control !== pill) return;
         const { left, right } = root.getBoundingClientRect();
         drag = {
@@ -1176,8 +1309,20 @@ const mountPromptBox = (doc, bridge, options = {})=>{
         // A page of the site that isn't an entry (no `editable(entry)`, like a
         // hand-written /about) has nothing to edit: only New page.
         const pageless = site && bridge.entryId === null;
-        // …unless it shows a product: then Add a product page first.
-        const productHere = pageless && canCreate && bridge.product !== null;
+        // …unless it shows a product (collection): then Add a product
+        // (collection) page first.
+        const shopHere = !pageless || !canCreate ? null : bridge.product ? 'product' : bridge.collection ? 'collection' : null;
+        const productHere = shopHere !== null;
+        const shopCopy = shopHere === 'collection' ? {
+            add: labels.addCollectionPage,
+            adding: labels.addingCollectionPage,
+            hint: labels.collectionPageHint
+        } : {
+            add: labels.addProductPage,
+            adding: labels.addingProductPage,
+            hint: labels.productPageHint
+        };
+        addProduct.lastChild.textContent = shopCopy.add;
         const onlyNew = pageless && canCreate && !productHere;
         if (!canCreate) creating = false;
         if (onlyNew) creating = true;
@@ -1187,7 +1332,7 @@ const mountPromptBox = (doc, bridge, options = {})=>{
         if (showForm && !formHandle) mountForm();
         else if (!showForm && formHandle) unmountForm();
         const offerProduct = productHere && !creating;
-        pillText.textContent = offerProduct ? labels.addProductPage : onlyNew ? labels.newPage : labels.open;
+        pillText.textContent = offerProduct ? shopCopy.add : onlyNew ? labels.newPage : labels.open;
         cancelNew.hidden = onlyNew;
         scope.hidden = creating || offerProduct;
         newScope.hidden = !creating;
@@ -1205,7 +1350,7 @@ const mountPromptBox = (doc, bridge, options = {})=>{
         toolbar.hidden = picking;
         pagesSection.hidden = !picking;
         input.placeholder = creating ? labels.newPagePlaceholder : labels.placeholder;
-        scopeText.textContent = state.selectedUid ? labels.scopeBlock : labels.scopeEntry;
+        scopeText.textContent = state.selectedUid ? labels.scopeBlock : pageless ? labels.scopeNoPage : labels.scopeEntry;
         clearBlock.hidden = !state.selectedUid;
         pageIcon.hidden = !!state.selectedUid;
         blockIcon.hidden = !state.selectedUid;
@@ -1235,7 +1380,11 @@ const mountPromptBox = (doc, bridge, options = {})=>{
         publish.hidden = !state.features.includes('publish') || pageless;
         publish.disabled = busy;
         publish.textContent = state.publishing ? labels.publishing : labels.publish;
-        signOut.hidden = !site;
+        signOut.hidden = !site || options.signOut === false;
+        pillSignOut.hidden = options.signOut === false;
+        if (options.actions) {
+            options.actions.slot = open && available ? 'actions-footer' : 'actions-bar';
+        }
         footer.hidden = !site;
         unsaved.hidden = !state.unsaved;
         pageChip.hidden = !site;
@@ -1244,7 +1393,7 @@ const mountPromptBox = (doc, bridge, options = {})=>{
         const loadingForm = form && formLoading && !picking;
         const working = state.prompting;
         // A form opening says so in its own place.
-        const note = state.prompting ? creating ? labels.creating : offerProduct ? labels.addingProductPage : labels.working : loadingForm ? '' : message?.text ?? (offerProduct ? labels.productPageHint : site && !creating && !picking && !state.selectedUid ? labels.selectHint : '');
+        const note = state.prompting ? creating ? labels.creating : offerProduct ? shopCopy.adding : labels.working : loadingForm ? '' : message?.text ?? (offerProduct ? shopCopy.hint : site && !creating && !picking && !state.selectedUid ? labels.selectHint : '');
         status.textContent = note;
         status.hidden = !note || minimized;
         status.className = `status${working ? ' working' : ''}${!busy && !loadingForm && message?.error ? ' error' : ''}`;
@@ -1467,11 +1616,19 @@ const mountPromptBox = (doc, bridge, options = {})=>{
         message = null;
         try {
             // The bridge reloads the page; this shows until it does.
-            await bridge.createProductPage();
-            message = {
-                text: labels.addedProductPage,
-                error: false
-            };
+            if (bridge.product) {
+                await bridge.createProductPage();
+                message = {
+                    text: labels.addedProductPage,
+                    error: false
+                };
+            } else {
+                await bridge.createCollectionPage();
+                message = {
+                    text: labels.addedCollectionPage,
+                    error: false
+                };
+            }
         } catch (error) {
             message = failure(error);
         }
@@ -1668,7 +1825,7 @@ const FORM_BURST_MS = 1000;
 // How long the page waits for the form's edits to settle before it shows
 // them.
 const FORM_RENDER_MS = 300;
-const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}`, productPath: ownProductPath } = {})=>{
+const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}`, productPath: ownProductPath, collectionPath: ownCollectionPath } = {})=>{
     const doc = win.document;
     const emitter = createEmitter();
     const cleanup = [];
@@ -1679,6 +1836,7 @@ const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}`, produc
     const touched = new Set();
     let session = null;
     const productPath = (handle, locale)=>ownProductPath ? ownProductPath(handle, locale) : (session?.productPath ?? '/products/{handle}').replaceAll('{handle}', encodeURIComponent(handle));
+    const collectionPath = (handle, locale)=>ownCollectionPath ? ownCollectionPath(handle, locale) : (session?.collectionPath ?? '/collections/{handle}').replaceAll('{handle}', encodeURIComponent(handle));
     // The open form's, if any; and when the form last changed content, for
     // undo steps (-Infinity: the next edit starts a new step).
     let closeForm = null;
@@ -1733,6 +1891,16 @@ const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}`, produc
             handle
         } : null;
     };
+    // The collection the page shows (editableCollection), if it marks one.
+    const pageCollection = ()=>{
+        const element = doc.querySelector(`[${COLLECTION_ATTRIBUTE}]`);
+        const id = element?.getAttribute(COLLECTION_ATTRIBUTE);
+        const handle = element?.getAttribute(COLLECTION_HANDLE_ATTRIBUTE);
+        return id && handle ? {
+            id,
+            handle
+        } : null;
+    };
     const entryFor = (uid)=>{
         const block = uid ? doc.querySelector(blockSelector(uid)) : null;
         return block?.closest(`[${ENTRY_ATTRIBUTE}]`)?.getAttribute(ENTRY_ATTRIBUTE) ?? pageEntryId();
@@ -1843,6 +2011,9 @@ const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}`, produc
         get product () {
             return pageProduct();
         },
+        get collection () {
+            return pageCollection();
+        },
         environment: null,
         on: emitter.on,
         getState: ()=>state,
@@ -1940,6 +2111,34 @@ const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}`, produc
                 });
             }
         },
+        async createCollectionPage (collection = pageCollection() ?? undefined) {
+            if (!collection) {
+                throw new Error('Nothing on this page is marked as a collection: add editableCollection(collection)');
+            }
+            if (!has('create')) throw new Error('You may not add pages here');
+            if (state.unsaved) {
+                throw new Error('Save or undo your changes before adding a page');
+            }
+            setState({
+                prompting: true
+            });
+            try {
+                const made = await api('collection-pages', {
+                    collection: {
+                        id: collection.id,
+                        handle: collection.handle
+                    }
+                });
+                // The site's collection route finds its page now (drafts, while
+                // editing): show it.
+                win.location.reload();
+                return made;
+            } finally{
+                setState({
+                    prompting: false
+                });
+            }
+        },
         async view (options = {}) {
             const { uid, entryId } = target(options.uid);
             const entry = await load(entryId);
@@ -2093,8 +2292,9 @@ const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}`, produc
                         contentType: page.contentType,
                         status: page.status,
                         path,
-                        url: page.product ? productPath(page.product.handle, code) : pagePath(path, code),
-                        product: page.product ?? null
+                        url: page.product ? productPath(page.product.handle, code) : page.collection ? collectionPath(page.collection.handle, code) : pagePath(path, code),
+                        product: page.product ?? null,
+                        collection: page.collection ?? null
                     }
                 ];
             });
@@ -2239,7 +2439,7 @@ const peekContentBridge = ()=>typeof window === 'undefined' ? null : window[KEY]
 //   if (bridge.isEditing) bridge.on('update', ({ entry }) => render(entry))
 //
 // The first call's options win: there is one bridge per page.
-const getContentBridge = ({ url, prompt = true, pagePath, productPath } = {})=>{
+const getContentBridge = ({ url, prompt = true, pagePath, productPath, collectionPath } = {})=>{
     if (typeof window === 'undefined') return SERVER_BRIDGE;
     const win = window;
     if (win[KEY]) return win[KEY];
@@ -2253,12 +2453,26 @@ const getContentBridge = ({ url, prompt = true, pagePath, productPath } = {})=>{
         const sitePath = bridge.isEditing || win.parent !== win ? null : readSiteEditing(win.document);
         if (sitePath) bridge = createSiteBridge(win, sitePath, {
             pagePath,
-            productPath
+            productPath,
+            collectionPath
         });
         if (bridge.isEditing && prompt) {
-            const unmount = mountPromptBox(win.document, bridge, prompt === true ? {} : prompt);
+            const doc = win.document;
+            let unmount = ()=>{};
+            let destroyed = false;
+            const mount = ()=>{
+                if (destroyed) return;
+                unmount = mountPromptBox(doc, bridge, prompt === true ? {} : prompt);
+            };
+            // A script tag in <head> runs before there is a body to mount into.
+            if (doc.body) mount();
+            else doc.addEventListener('DOMContentLoaded', mount, {
+                once: true
+            });
             const destroy = bridge.destroy;
             bridge.destroy = ()=>{
+                destroyed = true;
+                doc.removeEventListener('DOMContentLoaded', mount);
                 unmount();
                 destroy();
             };

package/dist/index.d.mts

@@ -80,6 +80,14 @@ declare const editableProduct: (product: {
     id: string;
     handle: string;
 } | null | undefined) => EditableProduct;
+type EditableCollection = {
+    'data-cms-collection'?: string;
+    'data-cms-collection-handle'?: string;
+};
+declare const editableCollection: (collection: {
+    id: string;
+    handle: string;
+} | null | undefined) => EditableCollection;
 
 declare class ContentApiError extends Error {
     readonly status: number;
@@ -195,6 +203,6 @@ type SitemapOptions = LocalizedUrlOptions & {
 };
 declare const sitemapXml: (entries: Iterable<Page>, { exclude, ...options }: SitemapOptions) => string;
 
-export { Asset, Block, ContentApiError, ContentClient, DEFAULT_URL, ENTRY_ATTRIBUTE, Entry, EntryList, EntryStub, IMPROVE_BLOCK, ImproveBlock, Link, LinkTarget, ModelFile, PREVIEW_PARAMS, PRODUCT_ATTRIBUTE, PRODUCT_HANDLE_ATTRIBUTE, Redirect, RedirectList, RichTextFormat, RichTextNode, SAFE_HREF, SHOPIFY_STOREFRONT_API_VERSION, ShopifyItem, ShopifyStorefrontError, UID_ATTRIBUTE, alternateLinks, editable, editableProduct, escapeHtml, fetchShopifyCollection, fetchShopifyProducts, headingLevel, imageSrcSet, imageUrl, isImproveBlock, linkHref, pickImproveVariant, readPreviewParams, richTextToHtml, richTextToPlainText, sitemapXml };
+export { Asset, Block, ContentApiError, ContentClient, DEFAULT_URL, ENTRY_ATTRIBUTE, Entry, EntryList, EntryStub, IMPROVE_BLOCK, ImproveBlock, Link, LinkTarget, ModelFile, PREVIEW_PARAMS, PRODUCT_ATTRIBUTE, PRODUCT_HANDLE_ATTRIBUTE, Redirect, RedirectList, RichTextFormat, RichTextNode, SAFE_HREF, SHOPIFY_STOREFRONT_API_VERSION, ShopifyItem, ShopifyStorefrontError, UID_ATTRIBUTE, alternateLinks, editable, editableCollection, editableProduct, escapeHtml, fetchShopifyCollection, fetchShopifyProducts, headingLevel, imageSrcSet, imageUrl, isImproveBlock, linkHref, pickImproveVariant, readPreviewParams, richTextToHtml, richTextToPlainText, sitemapXml };
 export type { AlternateLink, ContentClientOptions, EntriesQuery, ImageTransform, LinkHrefOptions, LocalizedUrlOptions, PageLookup, PreviewParams, RedirectsQuery, RequestOptions, RichTextHtmlOptions, ShopifyCollection, ShopifyImage, ShopifyMoney, ShopifyProduct, ShopifyStorefrontOptions, SitemapOptions };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sources":["../src/client.ts","../src/config.ts","../src/editable.ts","../src/errors.ts","../src/images.ts","../src/improve.ts","../src/links.ts","../src/preview.ts","../src/shopify.ts","../src/richText.ts","../src/sitemap.ts"],"mappings":"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","names":[]}
+{"version":3,"file":"index.d.mts","sources":["../src/client.ts","../src/config.ts","../src/editable.ts","../src/errors.ts","../src/images.ts","../src/improve.ts","../src/links.ts","../src/preview.ts","../src/shopify.ts","../src/richText.ts","../src/sitemap.ts"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -80,6 +80,14 @@ declare const editableProduct: (product: {
     id: string;
     handle: string;
 } | null | undefined) => EditableProduct;
+type EditableCollection = {
+    'data-cms-collection'?: string;
+    'data-cms-collection-handle'?: string;
+};
+declare const editableCollection: (collection: {
+    id: string;
+    handle: string;
+} | null | undefined) => EditableCollection;
 
 declare class ContentApiError extends Error {
     readonly status: number;
@@ -195,6 +203,6 @@ type SitemapOptions = LocalizedUrlOptions & {
 };
 declare const sitemapXml: (entries: Iterable<Page>, { exclude, ...options }: SitemapOptions) => string;
 
-export { Asset, Block, ContentApiError, ContentClient, DEFAULT_URL, ENTRY_ATTRIBUTE, Entry, EntryList, EntryStub, IMPROVE_BLOCK, ImproveBlock, Link, LinkTarget, ModelFile, PREVIEW_PARAMS, PRODUCT_ATTRIBUTE, PRODUCT_HANDLE_ATTRIBUTE, Redirect, RedirectList, RichTextFormat, RichTextNode, SAFE_HREF, SHOPIFY_STOREFRONT_API_VERSION, ShopifyItem, ShopifyStorefrontError, UID_ATTRIBUTE, alternateLinks, editable, editableProduct, escapeHtml, fetchShopifyCollection, fetchShopifyProducts, headingLevel, imageSrcSet, imageUrl, isImproveBlock, linkHref, pickImproveVariant, readPreviewParams, richTextToHtml, richTextToPlainText, sitemapXml };
+export { Asset, Block, ContentApiError, ContentClient, DEFAULT_URL, ENTRY_ATTRIBUTE, Entry, EntryList, EntryStub, IMPROVE_BLOCK, ImproveBlock, Link, LinkTarget, ModelFile, PREVIEW_PARAMS, PRODUCT_ATTRIBUTE, PRODUCT_HANDLE_ATTRIBUTE, Redirect, RedirectList, RichTextFormat, RichTextNode, SAFE_HREF, SHOPIFY_STOREFRONT_API_VERSION, ShopifyItem, ShopifyStorefrontError, UID_ATTRIBUTE, alternateLinks, editable, editableCollection, editableProduct, escapeHtml, fetchShopifyCollection, fetchShopifyProducts, headingLevel, imageSrcSet, imageUrl, isImproveBlock, linkHref, pickImproveVariant, readPreviewParams, richTextToHtml, richTextToPlainText, sitemapXml };
 export type { AlternateLink, ContentClientOptions, EntriesQuery, ImageTransform, LinkHrefOptions, LocalizedUrlOptions, PageLookup, PreviewParams, RedirectsQuery, RequestOptions, RichTextHtmlOptions, ShopifyCollection, ShopifyImage, ShopifyMoney, ShopifyProduct, ShopifyStorefrontOptions, SitemapOptions };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sources":["../src/client.ts","../src/config.ts","../src/editable.ts","../src/errors.ts","../src/images.ts","../src/improve.ts","../src/links.ts","../src/preview.ts","../src/shopify.ts","../src/richText.ts","../src/sitemap.ts"],"mappings":"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","names":[]}
+{"version":3,"file":"index.d.ts","sources":["../src/client.ts","../src/config.ts","../src/editable.ts","../src/errors.ts","../src/images.ts","../src/improve.ts","../src/links.ts","../src/preview.ts","../src/shopify.ts","../src/richText.ts","../src/sitemap.ts"],"mappings":"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","names":[]}

package/dist/index.js

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var config = require('./config-ci2hxmas.js');
-var preview = require('./preview-ijk3ixwb.js');
+var preview = require('./preview-ooq8w3jv.js');
 
 // A response from the API that wasn't a success. `message` is the API's own
 // `error` text when it sent one.
@@ -513,6 +513,7 @@ exports.PRODUCT_ATTRIBUTE = preview.PRODUCT_ATTRIBUTE;
 exports.PRODUCT_HANDLE_ATTRIBUTE = preview.PRODUCT_HANDLE_ATTRIBUTE;
 exports.UID_ATTRIBUTE = preview.UID_ATTRIBUTE;
 exports.editable = preview.editable;
+exports.editableCollection = preview.editableCollection;
 exports.editableProduct = preview.editableProduct;
 exports.readPreviewParams = preview.readPreviewParams;
 exports.ContentApiError = ContentApiError;

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { n as normalizeUrl, a as DEFAULT_TIMEOUT, b as DELIVERY_PATH, D as DEFAULT_URL } from './config-c6qktlz6.mjs';
-export { E as ENTRY_ATTRIBUTE, P as PREVIEW_PARAMS, a as PRODUCT_ATTRIBUTE, b as PRODUCT_HANDLE_ATTRIBUTE, U as UID_ATTRIBUTE, e as editable, c as editableProduct, r as readPreviewParams } from './preview-jcmxxj92.mjs';
+export { E as ENTRY_ATTRIBUTE, P as PREVIEW_PARAMS, b as PRODUCT_ATTRIBUTE, c as PRODUCT_HANDLE_ATTRIBUTE, U as UID_ATTRIBUTE, e as editable, d as editableCollection, f as editableProduct, r as readPreviewParams } from './preview-fu3qtgfx.mjs';
 
 // A response from the API that wasn't a success. `message` is the API's own
 // `error` text when it sent one.

package/dist/{preview-jcmxxj92.mjs → preview-fu3qtgfx.mjs}

@@ -2,6 +2,8 @@ const UID_ATTRIBUTE = 'data-cms-uid';
 const ENTRY_ATTRIBUTE = 'data-cms-entry';
 const PRODUCT_ATTRIBUTE = 'data-cms-product';
 const PRODUCT_HANDLE_ATTRIBUTE = 'data-cms-product-handle';
+const COLLECTION_ATTRIBUTE = 'data-cms-collection';
+const COLLECTION_HANDLE_ATTRIBUTE = 'data-cms-collection-handle';
 // The attribute that lets editors select a block on the page, in the visual
 // editor and on the site. Spread it on the block's outermost element:
 //
@@ -36,6 +38,18 @@ const editableProduct = (product)=>product?.id ? {
         'data-cms-product': product.id,
         'data-cms-product-handle': product.handle
     } : {};
+// The Shopify collection a page shows, on a collection route: editing on the
+// site then offers "Add a collection page" when the page has no collection
+// page yet (no `editable(entry)`), and makes one for this collection.
+//
+//   <main {...editableCollection(collection)} {...editable(page)}>…</main>
+//
+// `collection` is the store's (its GID and handle), from the Storefront API
+// or a Shopify field.
+const editableCollection = (collection)=>collection?.id ? {
+        'data-cms-collection': collection.id,
+        'data-cms-collection-handle': collection.handle
+    } : {};
 
 // The visual editor loads the site in an iframe at the environment's preview
 // URL plus the entry's path, with these parameters added. `cms_token` is a
@@ -84,4 +98,4 @@ const readPreviewParams = (input)=>{
     };
 };
 
-export { ENTRY_ATTRIBUTE as E, PREVIEW_PARAMS as P, UID_ATTRIBUTE as U, PRODUCT_ATTRIBUTE as a, PRODUCT_HANDLE_ATTRIBUTE as b, editableProduct as c, editable as e, readPreviewParams as r };
+export { COLLECTION_ATTRIBUTE as C, ENTRY_ATTRIBUTE as E, PREVIEW_PARAMS as P, UID_ATTRIBUTE as U, COLLECTION_HANDLE_ATTRIBUTE as a, PRODUCT_ATTRIBUTE as b, PRODUCT_HANDLE_ATTRIBUTE as c, editableCollection as d, editable as e, editableProduct as f, readPreviewParams as r };