@obelism/content 0.16.0 → 0.18.0

package/dist/bridge.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var preview = require('./preview-mpwfmnla.js');
+var preview = require('./preview-ijk3ixwb.js');
 var site = require('./site.js');
 var config = require('./config-ci2hxmas.js');
 
@@ -229,6 +229,7 @@ const onlyWhileEditingSite = ()=>Promise.reject(new Error('Only while signed in
 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')),
     view: onlyWhileEditingSite,
     applyJson: onlyWhileEditingSite,
     openForm: (_container, options = {})=>{
@@ -286,6 +287,7 @@ const createBridge = (win, cmsOrigin)=>{
         mode: isEditing ? 'editor' : null,
         entryId: params.get(preview.PREVIEW_PARAMS.entry),
         environment: params.get(preview.PREVIEW_PARAMS.environment),
+        product: null,
         on: emitter.on,
         getState: ()=>state,
         ...INERT_METHODS,
@@ -478,6 +480,7 @@ const wrapScriptBridge = (script, params)=>{
         mode: script.isEditing ? 'editor' : null,
         entryId: script.entryId,
         environment: params.get(preview.PREVIEW_PARAMS.environment),
+        product: null,
         on: (event, listener)=>{
             if (event === 'update' && !forwardingUpdates) {
                 forwardingUpdates = true;
@@ -537,7 +540,11 @@ const DEFAULT_PROMPT_LABELS = {
     pagesEmpty: 'No pages match',
     pageCurrent: 'This page',
     pageDraft: 'Draft',
-    pageChanged: 'Changed'
+    pageChanged: 'Changed',
+    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.'
 };
 // Icons (Lucide), drawn in the text colour.
 const ICONS = {
@@ -872,6 +879,12 @@ 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.
+    const addProduct = element(doc, 'button', {
+        className: 'action chip product',
+        type: 'button'
+    }, icon(doc, 'newPage'), labels.addProductPage);
     const cancelNew = element(doc, 'button', {
         type: 'button',
         title: labels.newPageCancel
@@ -921,7 +934,7 @@ const mountPromptBox = (doc, bridge, options = {})=>{
     });
     const toolbar = element(doc, 'div', {
         className: 'toolbar'
-    }, scope, newScope, modes, undo, newPage, element(doc, 'span', {
+    }, scope, newScope, modes, undo, addProduct, newPage, element(doc, 'span', {
         className: 'spacer'
     }), minimize, close, divider, send);
     // The pages (on the site): a chip naming this page, opening a search
@@ -1032,7 +1045,9 @@ 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;
-        const onlyNew = pageless && canCreate;
+        // …unless it shows a product: then Add a product page first.
+        const productHere = pageless && canCreate && bridge.product !== null;
+        const onlyNew = pageless && canCreate && !productHere;
         if (!canCreate) creating = false;
         if (onlyNew) creating = true;
         if (creating || pageless || !site) form = false;
@@ -1040,16 +1055,19 @@ const mountPromptBox = (doc, bridge, options = {})=>{
         const showForm = open && available && form;
         if (showForm && !formHandle) mountForm();
         else if (!showForm && formHandle) unmountForm();
-        pillText.textContent = onlyNew ? labels.newPage : labels.open;
+        const offerProduct = productHere && !creating;
+        pillText.textContent = offerProduct ? labels.addProductPage : onlyNew ? labels.newPage : labels.open;
         cancelNew.hidden = onlyNew;
-        scope.hidden = creating;
+        scope.hidden = creating || offerProduct;
         newScope.hidden = !creating;
+        addProduct.hidden = !offerProduct;
+        addProduct.disabled = busy;
         newPage.hidden = creating || form || !canCreate;
         newPage.disabled = busy;
         if (minimized) picking = false;
         pathRow.hidden = !creating || picking || minimized;
         pathInput.disabled = busy;
-        input.hidden = form || picking || minimized;
+        input.hidden = form || picking || minimized || offerProduct;
         formBox.hidden = !form || picking || minimized;
         formBox.classList.toggle('loading', formLoading);
         toolbar.hidden = picking;
@@ -1069,8 +1087,8 @@ const mountPromptBox = (doc, bridge, options = {})=>{
         undo.hidden = creating || !state.canUndo;
         undo.disabled = busy;
         // The form applies edits as they are made.
-        send.hidden = form || minimized;
-        divider.hidden = form || minimized;
+        send.hidden = form || minimized || offerProduct;
+        divider.hidden = form || minimized || offerProduct;
         const toggleLabel = minimized ? labels.expand : labels.minimize;
         minimize.title = toggleLabel;
         minimize.setAttribute('aria-label', toggleLabel);
@@ -1093,7 +1111,7 @@ const mountPromptBox = (doc, bridge, options = {})=>{
         pageChipText.textContent = pages?.find(({ entryId })=>entryId === bridge.entryId)?.name ?? labels.pages;
         const loadingForm = form && formLoading && !picking;
         const working = state.prompting || loadingForm;
-        const note = state.prompting ? creating ? labels.creating : labels.working : loadingForm ? labels.formLoading : message?.text ?? (site && !creating && !picking && !state.selectedUid ? labels.selectHint : '');
+        const note = state.prompting ? creating ? labels.creating : offerProduct ? labels.addingProductPage : labels.working : loadingForm ? labels.formLoading : message?.text ?? (offerProduct ? labels.productPageHint : site && !creating && !picking && !state.selectedUid ? labels.selectHint : '');
         status.textContent = note;
         status.hidden = !note || minimized;
         status.className = `status${working ? ' working' : ''}${!busy && !loadingForm && message?.error ? ' error' : ''}`;
@@ -1303,6 +1321,20 @@ const mountPromptBox = (doc, bridge, options = {})=>{
     pillSignOut.addEventListener('click', ()=>bridge.signOut());
     clearBlock.addEventListener('click', ()=>bridge.select(null));
     newPage.addEventListener('click', ()=>setCreating(true));
+    addProduct.addEventListener('click', async ()=>{
+        message = null;
+        try {
+            // The bridge reloads the page; this shows until it does.
+            await bridge.createProductPage();
+            message = {
+                text: labels.addedProductPage,
+                error: false
+            };
+        } catch (error) {
+            message = failure(error);
+        }
+        refresh();
+    });
     cancelNew.addEventListener('click', ()=>setCreating(false));
     promptMode.addEventListener('click', ()=>setForm(false));
     formMode.addEventListener('click', ()=>setForm(true));
@@ -1483,7 +1515,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}` } = {})=>{
+const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}`, productPath: ownProductPath } = {})=>{
     const doc = win.document;
     const emitter = createEmitter();
     const cleanup = [];
@@ -1493,6 +1525,7 @@ const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}` } = {})
     // Entries changed here since the last publish.
     const touched = new Set();
     let session = null;
+    const productPath = (handle, locale)=>ownProductPath ? ownProductPath(handle, locale) : (session?.productPath ?? '/products/{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;
@@ -1537,6 +1570,16 @@ const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}` } = {})
         return data;
     };
     const pageEntryId = ()=>doc.querySelector(`[${preview.ENTRY_ATTRIBUTE}]`)?.getAttribute(preview.ENTRY_ATTRIBUTE) ?? null;
+    // The product the page shows (editableProduct), if it marks one.
+    const pageProduct = ()=>{
+        const element = doc.querySelector(`[${preview.PRODUCT_ATTRIBUTE}]`);
+        const id = element?.getAttribute(preview.PRODUCT_ATTRIBUTE);
+        const handle = element?.getAttribute(preview.PRODUCT_HANDLE_ATTRIBUTE);
+        return id && handle ? {
+            id,
+            handle
+        } : null;
+    };
     const entryFor = (uid)=>{
         const block = uid ? doc.querySelector(blockSelector(uid)) : null;
         return block?.closest(`[${preview.ENTRY_ATTRIBUTE}]`)?.getAttribute(preview.ENTRY_ATTRIBUTE) ?? pageEntryId();
@@ -1644,6 +1687,9 @@ const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}` } = {})
         get entryId () {
             return pageEntryId();
         },
+        get product () {
+            return pageProduct();
+        },
         environment: null,
         on: emitter.on,
         getState: ()=>state,
@@ -1713,6 +1759,34 @@ const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}` } = {})
                 });
             }
         },
+        async createProductPage (product = pageProduct() ?? undefined) {
+            if (!product) {
+                throw new Error('Nothing on this page is marked as a product: add editableProduct(product)');
+            }
+            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('product-pages', {
+                    product: {
+                        id: product.id,
+                        handle: product.handle
+                    }
+                });
+                // The site's product 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);
@@ -1866,7 +1940,8 @@ const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}` } = {})
                         contentType: page.contentType,
                         status: page.status,
                         path,
-                        url: pagePath(path, code)
+                        url: page.product ? productPath(page.product.handle, code) : pagePath(path, code),
+                        product: page.product ?? null
                     }
                 ];
             });
@@ -2011,7 +2086,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 } = {})=>{
+const getContentBridge = ({ url, prompt = true, pagePath, productPath } = {})=>{
     if (typeof window === 'undefined') return SERVER_BRIDGE;
     const win = window;
     if (win[KEY]) return win[KEY];
@@ -2024,7 +2099,8 @@ const getContentBridge = ({ url, prompt = true, pagePath } = {})=>{
         // own `/cms/login` (@obelism/content/site).
         const sitePath = bridge.isEditing || win.parent !== win ? null : readSiteEditing(win.document);
         if (sitePath) bridge = createSiteBridge(win, sitePath, {
-            pagePath
+            pagePath,
+            productPath
         });
         if (bridge.isEditing && prompt) {
             const unmount = mountPromptBox(win.document, bridge, prompt === true ? {} : prompt);

package/dist/bridge.mjs

@@ -1,4 +1,4 @@
-import { P as PREVIEW_PARAMS, U as UID_ATTRIBUTE, E as ENTRY_ATTRIBUTE } from './preview-h7rwp06v.mjs';
+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 { SITE_EDITING_COOKIE, SITE_REQUEST_HEADER } from './site.mjs';
 import { n as normalizeUrl, D as DEFAULT_URL } from './config-c6qktlz6.mjs';
 
@@ -227,6 +227,7 @@ const onlyWhileEditingSite = ()=>Promise.reject(new Error('Only while signed in
 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')),
     view: onlyWhileEditingSite,
     applyJson: onlyWhileEditingSite,
     openForm: (_container, options = {})=>{
@@ -284,6 +285,7 @@ const createBridge = (win, cmsOrigin)=>{
         mode: isEditing ? 'editor' : null,
         entryId: params.get(PREVIEW_PARAMS.entry),
         environment: params.get(PREVIEW_PARAMS.environment),
+        product: null,
         on: emitter.on,
         getState: ()=>state,
         ...INERT_METHODS,
@@ -476,6 +478,7 @@ const wrapScriptBridge = (script, params)=>{
         mode: script.isEditing ? 'editor' : null,
         entryId: script.entryId,
         environment: params.get(PREVIEW_PARAMS.environment),
+        product: null,
         on: (event, listener)=>{
             if (event === 'update' && !forwardingUpdates) {
                 forwardingUpdates = true;
@@ -535,7 +538,11 @@ const DEFAULT_PROMPT_LABELS = {
     pagesEmpty: 'No pages match',
     pageCurrent: 'This page',
     pageDraft: 'Draft',
-    pageChanged: 'Changed'
+    pageChanged: 'Changed',
+    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.'
 };
 // Icons (Lucide), drawn in the text colour.
 const ICONS = {
@@ -870,6 +877,12 @@ 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.
+    const addProduct = element(doc, 'button', {
+        className: 'action chip product',
+        type: 'button'
+    }, icon(doc, 'newPage'), labels.addProductPage);
     const cancelNew = element(doc, 'button', {
         type: 'button',
         title: labels.newPageCancel
@@ -919,7 +932,7 @@ const mountPromptBox = (doc, bridge, options = {})=>{
     });
     const toolbar = element(doc, 'div', {
         className: 'toolbar'
-    }, scope, newScope, modes, undo, newPage, element(doc, 'span', {
+    }, scope, newScope, modes, undo, addProduct, newPage, element(doc, 'span', {
         className: 'spacer'
     }), minimize, close, divider, send);
     // The pages (on the site): a chip naming this page, opening a search
@@ -1030,7 +1043,9 @@ 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;
-        const onlyNew = pageless && canCreate;
+        // …unless it shows a product: then Add a product page first.
+        const productHere = pageless && canCreate && bridge.product !== null;
+        const onlyNew = pageless && canCreate && !productHere;
         if (!canCreate) creating = false;
         if (onlyNew) creating = true;
         if (creating || pageless || !site) form = false;
@@ -1038,16 +1053,19 @@ const mountPromptBox = (doc, bridge, options = {})=>{
         const showForm = open && available && form;
         if (showForm && !formHandle) mountForm();
         else if (!showForm && formHandle) unmountForm();
-        pillText.textContent = onlyNew ? labels.newPage : labels.open;
+        const offerProduct = productHere && !creating;
+        pillText.textContent = offerProduct ? labels.addProductPage : onlyNew ? labels.newPage : labels.open;
         cancelNew.hidden = onlyNew;
-        scope.hidden = creating;
+        scope.hidden = creating || offerProduct;
         newScope.hidden = !creating;
+        addProduct.hidden = !offerProduct;
+        addProduct.disabled = busy;
         newPage.hidden = creating || form || !canCreate;
         newPage.disabled = busy;
         if (minimized) picking = false;
         pathRow.hidden = !creating || picking || minimized;
         pathInput.disabled = busy;
-        input.hidden = form || picking || minimized;
+        input.hidden = form || picking || minimized || offerProduct;
         formBox.hidden = !form || picking || minimized;
         formBox.classList.toggle('loading', formLoading);
         toolbar.hidden = picking;
@@ -1067,8 +1085,8 @@ const mountPromptBox = (doc, bridge, options = {})=>{
         undo.hidden = creating || !state.canUndo;
         undo.disabled = busy;
         // The form applies edits as they are made.
-        send.hidden = form || minimized;
-        divider.hidden = form || minimized;
+        send.hidden = form || minimized || offerProduct;
+        divider.hidden = form || minimized || offerProduct;
         const toggleLabel = minimized ? labels.expand : labels.minimize;
         minimize.title = toggleLabel;
         minimize.setAttribute('aria-label', toggleLabel);
@@ -1091,7 +1109,7 @@ const mountPromptBox = (doc, bridge, options = {})=>{
         pageChipText.textContent = pages?.find(({ entryId })=>entryId === bridge.entryId)?.name ?? labels.pages;
         const loadingForm = form && formLoading && !picking;
         const working = state.prompting || loadingForm;
-        const note = state.prompting ? creating ? labels.creating : labels.working : loadingForm ? labels.formLoading : message?.text ?? (site && !creating && !picking && !state.selectedUid ? labels.selectHint : '');
+        const note = state.prompting ? creating ? labels.creating : offerProduct ? labels.addingProductPage : labels.working : loadingForm ? labels.formLoading : message?.text ?? (offerProduct ? labels.productPageHint : site && !creating && !picking && !state.selectedUid ? labels.selectHint : '');
         status.textContent = note;
         status.hidden = !note || minimized;
         status.className = `status${working ? ' working' : ''}${!busy && !loadingForm && message?.error ? ' error' : ''}`;
@@ -1301,6 +1319,20 @@ const mountPromptBox = (doc, bridge, options = {})=>{
     pillSignOut.addEventListener('click', ()=>bridge.signOut());
     clearBlock.addEventListener('click', ()=>bridge.select(null));
     newPage.addEventListener('click', ()=>setCreating(true));
+    addProduct.addEventListener('click', async ()=>{
+        message = null;
+        try {
+            // The bridge reloads the page; this shows until it does.
+            await bridge.createProductPage();
+            message = {
+                text: labels.addedProductPage,
+                error: false
+            };
+        } catch (error) {
+            message = failure(error);
+        }
+        refresh();
+    });
     cancelNew.addEventListener('click', ()=>setCreating(false));
     promptMode.addEventListener('click', ()=>setForm(false));
     formMode.addEventListener('click', ()=>setForm(true));
@@ -1481,7 +1513,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}` } = {})=>{
+const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}`, productPath: ownProductPath } = {})=>{
     const doc = win.document;
     const emitter = createEmitter();
     const cleanup = [];
@@ -1491,6 +1523,7 @@ const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}` } = {})
     // Entries changed here since the last publish.
     const touched = new Set();
     let session = null;
+    const productPath = (handle, locale)=>ownProductPath ? ownProductPath(handle, locale) : (session?.productPath ?? '/products/{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;
@@ -1535,6 +1568,16 @@ const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}` } = {})
         return data;
     };
     const pageEntryId = ()=>doc.querySelector(`[${ENTRY_ATTRIBUTE}]`)?.getAttribute(ENTRY_ATTRIBUTE) ?? null;
+    // The product the page shows (editableProduct), if it marks one.
+    const pageProduct = ()=>{
+        const element = doc.querySelector(`[${PRODUCT_ATTRIBUTE}]`);
+        const id = element?.getAttribute(PRODUCT_ATTRIBUTE);
+        const handle = element?.getAttribute(PRODUCT_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();
@@ -1642,6 +1685,9 @@ const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}` } = {})
         get entryId () {
             return pageEntryId();
         },
+        get product () {
+            return pageProduct();
+        },
         environment: null,
         on: emitter.on,
         getState: ()=>state,
@@ -1711,6 +1757,34 @@ const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}` } = {})
                 });
             }
         },
+        async createProductPage (product = pageProduct() ?? undefined) {
+            if (!product) {
+                throw new Error('Nothing on this page is marked as a product: add editableProduct(product)');
+            }
+            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('product-pages', {
+                    product: {
+                        id: product.id,
+                        handle: product.handle
+                    }
+                });
+                // The site's product 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);
@@ -1864,7 +1938,8 @@ const createSiteBridge = (win, basePath, { pagePath = (path)=>`/${path}` } = {})
                         contentType: page.contentType,
                         status: page.status,
                         path,
-                        url: pagePath(path, code)
+                        url: page.product ? productPath(page.product.handle, code) : pagePath(path, code),
+                        product: page.product ?? null
                     }
                 ];
             });
@@ -2009,7 +2084,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 } = {})=>{
+const getContentBridge = ({ url, prompt = true, pagePath, productPath } = {})=>{
     if (typeof window === 'undefined') return SERVER_BRIDGE;
     const win = window;
     if (win[KEY]) return win[KEY];
@@ -2022,7 +2097,8 @@ const getContentBridge = ({ url, prompt = true, pagePath } = {})=>{
         // own `/cms/login` (@obelism/content/site).
         const sitePath = bridge.isEditing || win.parent !== win ? null : readSiteEditing(win.document);
         if (sitePath) bridge = createSiteBridge(win, sitePath, {
-            pagePath
+            pagePath,
+            productPath
         });
         if (bridge.isEditing && prompt) {
             const unmount = mountPromptBox(win.document, bridge, prompt === true ? {} : prompt);

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { R as RichTextFormat, E as Entry, a as RedirectList, b as Redirect, c as EntryList, M as ModelFile, A as Asset, B as Block, I as ImproveBlock, d as EntryStub, e as RichTextNode } from './types-m3j4tltp.js';
-export { C as ContentTypeDefinition, f as ContentTypeKind, g as Environment, F as FieldDefinition, h as FieldType, i as RichTextDocument, j as RichTextMark } from './types-m3j4tltp.js';
+import { R as RichTextFormat, E as Entry, a as RedirectList, b as Redirect, c as EntryList, M as ModelFile, A as Asset, B as Block, I as ImproveBlock, S as ShopifyItem, L as LinkTarget, d as Link, e as EntryStub, f as RichTextNode } from './types-mtjco3a5.js';
+export { C as ContentTypeDefinition, g as ContentTypeKind, h as Environment, F as FieldDefinition, i as FieldType, j as RichTextDocument, k as RichTextMark } from './types-mtjco3a5.js';
 
 type ContentClientOptions = {
     token: string;
@@ -60,6 +60,8 @@ declare const DEFAULT_URL = "https://content.obelism.studio";
 
 declare const UID_ATTRIBUTE = "data-cms-uid";
 declare const ENTRY_ATTRIBUTE = "data-cms-entry";
+declare const PRODUCT_ATTRIBUTE = "data-cms-product";
+declare const PRODUCT_HANDLE_ATTRIBUTE = "data-cms-product-handle";
 type Editable = {
     'data-cms-uid'?: string;
     'data-cms-entry'?: string;
@@ -70,6 +72,14 @@ declare const editable: (target: {
     id: string;
     fields: unknown;
 } | null | undefined) => Editable;
+type EditableProduct = {
+    'data-cms-product'?: string;
+    'data-cms-product-handle'?: string;
+};
+declare const editableProduct: (product: {
+    id: string;
+    handle: string;
+} | null | undefined) => EditableProduct;
 
 declare class ContentApiError extends Error {
     readonly status: number;
@@ -96,6 +106,12 @@ declare const IMPROVE_BLOCK = "_improve";
 declare const isImproveBlock: (block: Block) => block is ImproveBlock;
 declare const pickImproveVariant: <TBlock extends Block>(block: ImproveBlock<TBlock>, option: string | null | undefined, fallback?: string) => TBlock[];
 
+type LinkHrefOptions = {
+    url?: ((path: string) => string) | undefined;
+    product?: ((product: ShopifyItem, page: LinkTarget | null) => string) | undefined;
+};
+declare const linkHref: (link: Link | null | undefined, { url, product, }?: LinkHrefOptions) => string | null;
+
 declare const PREVIEW_PARAMS: {
     readonly preview: "cms_preview";
     readonly entry: "cms_entry";
@@ -110,6 +126,50 @@ type PreviewParams = {
 type SearchParamsInput = URL | URLSearchParams | string | Record<string, string | string[] | undefined>;
 declare const readPreviewParams: (input: SearchParamsInput) => PreviewParams | null;
 
+declare const SHOPIFY_STOREFRONT_API_VERSION = "2026-10";
+type ShopifyStorefrontOptions = {
+    shop: string;
+    storefrontToken: string;
+    country?: string | undefined;
+    language?: string | undefined;
+    init?: RequestInit | undefined;
+    fetch?: typeof fetch | undefined;
+};
+type ShopifyMoney = {
+    amount: string;
+    currencyCode: string;
+};
+type ShopifyImage = {
+    url: string;
+    altText: string | null;
+    width: number | null;
+    height: number | null;
+};
+type ShopifyProduct = {
+    id: string;
+    handle: string;
+    title: string;
+    availableForSale: boolean;
+    featuredImage: ShopifyImage | null;
+    priceRange: {
+        minVariantPrice: ShopifyMoney;
+    };
+};
+type ShopifyCollection = {
+    id: string;
+    handle: string;
+    title: string;
+    products: ShopifyProduct[];
+};
+declare class ShopifyStorefrontError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+declare const fetchShopifyCollection: (item: ShopifyItem, options: ShopifyStorefrontOptions & {
+    first?: number | undefined;
+}) => Promise<ShopifyCollection | null>;
+declare const fetchShopifyProducts: (items: ShopifyItem | ShopifyItem[] | null | undefined, options: ShopifyStorefrontOptions) => Promise<ShopifyProduct[]>;
+
 declare const SAFE_HREF: RegExp;
 declare const escapeHtml: (value: string) => string;
 type RichTextHtmlOptions = {
@@ -135,6 +195,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, ModelFile, PREVIEW_PARAMS, Redirect, RedirectList, RichTextFormat, RichTextNode, SAFE_HREF, UID_ATTRIBUTE, alternateLinks, editable, escapeHtml, headingLevel, imageSrcSet, imageUrl, isImproveBlock, pickImproveVariant, readPreviewParams, richTextToHtml, richTextToPlainText, sitemapXml };
-export type { AlternateLink, ContentClientOptions, EntriesQuery, ImageTransform, LocalizedUrlOptions, PageLookup, PreviewParams, RedirectsQuery, RequestOptions, RichTextHtmlOptions, SitemapOptions };
+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 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/preview.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":[]}