efficient-web-builder 0.9.0 → 1.0.0

package/dist/lib/content/social-links.d.ts

@@ -0,0 +1,12 @@
+export declare const SOCIAL_PLATFORMS: readonly ["instagram", "facebook", "tiktok", "youtube", "x", "linkedin", "pinterest", "whatsapp"];
+export type SocialPlatform = (typeof SOCIAL_PLATFORMS)[number];
+export declare const SOCIAL_PLATFORM_LABELS: Record<SocialPlatform, string>;
+export type SocialLinks = Partial<Record<SocialPlatform, string>>;
+export declare const EMPTY_SOCIAL_LINKS: SocialLinks;
+export declare function normalizeSocialLinks(raw: unknown): SocialLinks;
+export declare function socialLinksToDraw(links: SocialLinks): {
+    platform: SocialPlatform;
+    href: string;
+    label: string;
+}[];
+export declare const socialUrlField: (platform: SocialPlatform) => `${SocialPlatform}_url`;

package/dist/lib/content/social-links.js

@@ -0,0 +1 @@
+const r=["instagram","facebook","tiktok","youtube","x","linkedin","pinterest","whatsapp"],s={instagram:"Instagram",facebook:"Facebook",tiktok:"TikTok",youtube:"YouTube",x:"X",linkedin:"LinkedIn",pinterest:"Pinterest",whatsapp:"WhatsApp"},a={};function c(t){if(!t||typeof t!="object")return a;const o={};for(const e of r){const i=t[e];if(typeof i!="string")continue;const n=i.trim();!n||!/^https?:\/\//i.test(n)||(o[e]=n)}return o}function p(t){return r.flatMap(o=>{const e=t[o];return e?[{platform:o,href:e,label:s[o]}]:[]})}const u=t=>`${t}_url`;export{a as EMPTY_SOCIAL_LINKS,r as SOCIAL_PLATFORMS,s as SOCIAL_PLATFORM_LABELS,c as normalizeSocialLinks,p as socialLinksToDraw,u as socialUrlField};

package/dist/lib/content/subscribe.d.ts

@@ -0,0 +1,76 @@
+import type { FontRole } from "../fonts.js";
+import { type PopupTextKind } from "../popup/text-kinds.js";
+export declare const SUBSCRIBE_POPUP_SLUG = "subscribe-popup";
+export declare const SUBSCRIBE_POPUP_KIND = "subscribe-popup";
+export declare const SUBSCRIBE_POPUP_PAGE_TITLE = "Pop up - SubscribePopup";
+export declare const SYSTEM_PAGE_SLUGS: readonly string[];
+export declare function isSystemPageSlug(slug: string): boolean;
+export interface SubscribeStat {
+    label: string;
+    value: string;
+}
+export interface SubscribePopupContent {
+    metaLabel: string;
+    issueLabel: string;
+    issueNumber: string;
+    kicker: string;
+    heading: string;
+    deck: string;
+    stats: SubscribeStat[];
+    formLabel: string;
+    formHeading: string;
+    formIntro: string;
+    firstNameLabel: string;
+    firstNamePlaceholder: string;
+    emailLabel: string;
+    emailPlaceholder: string;
+    interestsLabel: string;
+    interests: string[];
+    frequencyLabel: string;
+    frequencies: string[];
+    submitText: string;
+    finePrint: string;
+    dismissText: string;
+    emailInvalidText: string;
+    submitErrorText: string;
+    successHeading: string;
+    successBody: string;
+    keepBrowsingText: string;
+    formSlug: string;
+    autoOpen: boolean;
+    autoOpenDelaySec: number;
+    trigger: PopupTrigger;
+    scrollPercent: number;
+    showOn: PopupShowOn;
+    showOnPages: string[];
+    hideAfter: PopupHideAfter;
+    hideDays: number;
+    formSide: PopupFormSide;
+    valuePanelOnPhone: boolean;
+    sectionAccent: unknown;
+    sectionCorners: unknown;
+    sectionCornerSides: unknown;
+    textStyles: Partial<Record<PopupTextKind, FontRole>>;
+}
+export declare const POPUP_TRIGGERS: readonly ["delay", "scroll", "exit"];
+export type PopupTrigger = (typeof POPUP_TRIGGERS)[number];
+export declare const POPUP_SHOW_ON: readonly ["all", "chosen"];
+export type PopupShowOn = (typeof POPUP_SHOW_ON)[number];
+export declare const POPUP_HIDE_AFTER: readonly ["visit", "days", "never"];
+export type PopupHideAfter = (typeof POPUP_HIDE_AFTER)[number];
+export declare const POPUP_FORM_SIDES: readonly ["right", "left"];
+export type PopupFormSide = (typeof POPUP_FORM_SIDES)[number];
+export declare const POPUP_DELAY_RANGE: {
+    readonly min: 0;
+    readonly max: 60;
+};
+export declare const POPUP_SCROLL_RANGE: {
+    readonly min: 10;
+    readonly max: 90;
+};
+export declare const POPUP_DAYS_RANGE: {
+    readonly min: 1;
+    readonly max: 90;
+};
+export declare const SUBSCRIBE_POPUP_DEFAULTS: SubscribePopupContent;
+export declare function resolveSubscribeContent(rootProps: Record<string, unknown> | undefined | null): SubscribePopupContent;

package/dist/lib/content/subscribe.js

@@ -0,0 +1,2 @@
+import{authoredBoolean as d,authoredNumber as m,authoredString as f,authoredStringList as b}from"./authored-props.js";import{CART_DRAWER_SLUG as P}from"./cart-drawer.js";import{popupTextStyles as p}from"../popup/text-kinds.js";import{SITE_FOOTER_SLUG as h}from"./footer.js";const g="subscribe-popup",C="subscribe-popup",G="Pop up - SubscribePopup",S=[g,h,P];function H(r){return S.includes(r)}const L=["delay","scroll","exit"],x=["all","chosen"],O=["visit","days","never"],y=["right","left"],T={min:0,max:60},A={min:10,max:90},_={min:1,max:90},o={metaLabel:"Meta label",issueLabel:"Label",issueNumber:"00",kicker:"Kicker",heading:`Main heading
+*Highlight line*`,deck:"Add a sentence or two of supporting copy.",stats:[{label:"Label",value:"Value"},{label:"Label",value:"Value"},{label:"Label",value:"Value"},{label:"Label",value:"Value"}],formLabel:"Section label",formHeading:"Main heading *highlight*",formIntro:"Add a sentence or two of supporting copy.",firstNameLabel:"Field label",firstNamePlaceholder:"Placeholder",emailLabel:"Field label",emailPlaceholder:"Placeholder",interestsLabel:"Field label",interests:["Option one","Option two","Option three"],frequencyLabel:"Field label",frequencies:["Option one","Option two","Option three"],submitText:"Button label",finePrint:"Fine print",dismissText:"Dismiss link",emailInvalidText:"Enter a valid email address.",submitErrorText:"Could not subscribe right now. Please try again.",successHeading:"Main heading *highlight*",successBody:"Add a sentence or two of supporting copy \u2014 the {email} and {issue} tokens are substituted here.",keepBrowsingText:"Button label",autoOpen:!1,autoOpenDelaySec:15,formSlug:"",trigger:"delay",scrollPercent:50,showOn:"all",showOnPages:[],hideAfter:"days",hideDays:7,formSide:"right",valuePanelOnPhone:!1,sectionAccent:void 0,sectionCorners:void 0,sectionCornerSides:void 0,textStyles:{}},n=f,E=m,l=d,u=b;function s(r,e,t){return typeof e=="string"&&r.includes(e)?e:t}function a(r,e,t){const i=E(r,t);return Math.min(e.max,Math.max(e.min,Math.round(i)))}function B(r){return typeof r.hideAfter=="string"?s(O,r.hideAfter,o.hideAfter):r.oncePerSession===!0?"visit":r.oncePerSession===!1?"never":o.hideAfter}function U(r){return Array.isArray(r)?r.map(e=>typeof e=="string"?e.trim():"").filter(Boolean).map(e=>e.startsWith("/")?e:`/${e}`):[]}function c(r,e){if(r==null)return e;const t=i=>i.trim()?i:"";if(typeof r=="string")return t(r);if(typeof r=="object"&&"text"in r){const i=r.text;return typeof i=="string"?t(i):""}return e}function k(r,e){return Array.isArray(r)?u(r,[]):e}function I(r,e){return Array.isArray(r)?r.map(t=>{const i=t??{};return{label:n(i.label,""),value:n(i.value,"")}}).filter(t=>t.label||t.value):e}function v(r){const e=r??{},t=o;return{metaLabel:n(e.metaLabel,t.metaLabel),issueLabel:c(e.issueLabel,t.issueLabel),issueNumber:c(e.issueNumber,t.issueNumber),kicker:n(e.kicker,t.kicker),heading:n(e.heading,t.heading),deck:n(e.deck,t.deck),stats:I(e.stats,t.stats),formLabel:n(e.formLabel,t.formLabel),formHeading:n(e.formHeading,t.formHeading),formIntro:n(e.formIntro,t.formIntro),firstNameLabel:n(e.firstNameLabel,t.firstNameLabel),firstNamePlaceholder:n(e.firstNamePlaceholder,t.firstNamePlaceholder),emailLabel:n(e.emailLabel,t.emailLabel),emailPlaceholder:n(e.emailPlaceholder,t.emailPlaceholder),interestsLabel:n(e.interestsLabel,t.interestsLabel),interests:u(e.interests,t.interests),frequencyLabel:n(e.frequencyLabel,t.frequencyLabel),frequencies:k(e.frequencies,t.frequencies),submitText:n(e.submitText,t.submitText),finePrint:n(e.finePrint,t.finePrint),dismissText:n(e.dismissText,t.dismissText),emailInvalidText:n(e.emailInvalidText,t.emailInvalidText),submitErrorText:n(e.submitErrorText,t.submitErrorText),successHeading:n(e.successHeading,t.successHeading),successBody:n(e.successBody,t.successBody),keepBrowsingText:n(e.keepBrowsingText,t.keepBrowsingText),formSlug:typeof e.formSlug=="string"?e.formSlug.trim():t.formSlug,autoOpen:l(e.autoOpen,t.autoOpen),autoOpenDelaySec:a(e.autoOpenDelaySec,T,t.autoOpenDelaySec),trigger:s(L,e.trigger,t.trigger),scrollPercent:a(e.scrollPercent,A,t.scrollPercent),showOn:s(x,e.showOn,t.showOn),showOnPages:U(e.showOnPages),hideAfter:B(e),hideDays:a(e.hideDays,_,t.hideDays),formSide:s(y,e.formSide,t.formSide),valuePanelOnPhone:l(e.valuePanelOnPhone,t.valuePanelOnPhone),sectionAccent:e.sectionAccent,sectionCorners:e.sectionCorners,sectionCornerSides:e.sectionCornerSides,textStyles:p(e)}}export{_ as POPUP_DAYS_RANGE,T as POPUP_DELAY_RANGE,y as POPUP_FORM_SIDES,O as POPUP_HIDE_AFTER,A as POPUP_SCROLL_RANGE,x as POPUP_SHOW_ON,L as POPUP_TRIGGERS,o as SUBSCRIBE_POPUP_DEFAULTS,C as SUBSCRIBE_POPUP_KIND,G as SUBSCRIBE_POPUP_PAGE_TITLE,g as SUBSCRIBE_POPUP_SLUG,S as SYSTEM_PAGE_SLUGS,H as isSystemPageSlug,v as resolveSubscribeContent};

package/dist/lib/content/view-tiers.d.ts

@@ -0,0 +1,6 @@
+export type ViewTier = "desktop" | "tablet" | "mobile";
+export declare const VIEW_TIERS: ViewTier[];
+export declare const VIEW_TIER_LABEL: Record<ViewTier, string>;
+export declare const VIEW_TABLET_MIN = 720;
+export declare const VIEW_DESKTOP_MIN = 1100;
+export declare function viewTierForWidth(width: number): ViewTier;

package/dist/lib/content/view-tiers.js

@@ -0,0 +1 @@
+const p=["desktop","tablet","mobile"],r={desktop:"Desktop",tablet:"Tablet",mobile:"Mobile"},e=720,o=1100;function E(t){return t>=o?"desktop":t>=e?"tablet":"mobile"}export{o as VIEW_DESKTOP_MIN,e as VIEW_TABLET_MIN,p as VIEW_TIERS,r as VIEW_TIER_LABEL,E as viewTierForWidth};

package/dist/lib/editor/preview-href.d.ts

@@ -0,0 +1,6 @@
+export declare function originIsSiteAmbiguous(hostname: string | null | undefined): boolean;
+export declare function editorPreviewHref(opts: {
+    pageSlug: string;
+    siteSlug?: string | null;
+    hostname?: string | null;
+}): string;

package/dist/lib/editor/preview-href.js

@@ -0,0 +1 @@
+import{HOME_PAGE_SLUG as s}from"../puck/home-page.js";const u=/^(localhost|(?:[a-z0-9-]+\.)+localhost|127(?:\.\d{1,3}){3}|0\.0\.0\.0|\[::1\]|::1)$/i;function c(t){return!!t&&u.test(t)}function p(t){const{pageSlug:e,siteSlug:r,hostname:i}=t,o=e===s?"/":`/${encodeURIComponent(e)}`;if(!c(i))return o;const n=r?.trim();return n?`${o}?site=${encodeURIComponent(n)}`:o}export{p as editorPreviewHref,c as originIsSiteAmbiguous};

package/dist/lib/editor-admin-bridge.d.ts

@@ -0,0 +1,29 @@
+import { type RefObject } from "react";
+import { type EditorSession } from "./editor-session.js";
+export interface AuthMessage {
+    type?: string;
+    token?: string;
+    siteId?: string;
+    brandId?: string;
+    theme?: string;
+    can?: unknown;
+}
+export type BridgedCapabilities = {
+    canCreatePlatformTemplate: boolean;
+};
+export declare const NO_BRIDGED_CAPABILITIES: BridgedCapabilities;
+export declare function applyAuthGrant(d: AuthMessage & {
+    token: string;
+}, opts?: {
+    stampChromeTheme?: boolean;
+    session?: EditorSession;
+}): void;
+export interface AdminBridge {
+    token: string | null;
+    tokenRef: RefObject<string | null>;
+    capabilities: BridgedCapabilities;
+}
+export declare function useAdminBridge(handlers?: {
+    onAuth?: (hadToken: boolean) => void;
+    onMessage?: (data: unknown) => void;
+}): AdminBridge;

package/dist/lib/editor-admin-bridge.js

@@ -0,0 +1 @@
+"use client";import{useEffect as p,useRef as u,useState as d}from"react";import{useEditorHost as T}from"./editor-host.js";import{currentEditorSession as g,setSessionBridgedSite as C}from"./editor-session.js";import{useEditorSession as A}from"./editor-session-context.js";import{applyEditorChromeTheme as E}from"./editor-theme.js";const y=500,h={canCreatePlatformTemplate:!1};function S(e){return!e||typeof e!="object"?h:{canCreatePlatformTemplate:e.canCreatePlatformTemplate===!0}}function R(e,n={}){const o=n.session??g();o.auth.token=e.token,o.auth.brandId=e.brandId??null,C(o,e.siteId),(n.stampChromeTheme??!0)&&E(e.theme)}function _(e){const[n,o]=d(null),s=u(null),[k,b]=d(h),a=u(e?.onAuth),c=u(e?.onMessage);p(()=>{a.current=e?.onAuth,c.current=e?.onMessage});const r=T(),i=A();return p(()=>{const f=r.subscribe(l=>{const t=l;if(t.type==="storefront-editor:auth"&&typeof t.token=="string"&&t.token){const I=!!s.current;s.current=t.token,o(t.token),R({...t,token:t.token},{stampChromeTheme:r.ownsDocument,session:i}),b(S(t.can)),a.current?.(I)}else c.current?.(l)});if(r.send("storefront-editor:ready"),!i.usesBridgedToken)return f;const m=window.setInterval(()=>{s.current?window.clearInterval(m):r.send("storefront-editor:ready")},y);return()=>{f(),window.clearInterval(m)}},[r,i]),{token:n,tokenRef:s,capabilities:k}}export{h as NO_BRIDGED_CAPABILITIES,R as applyAuthGrant,_ as useAdminBridge};

package/dist/lib/editor-auth.d.ts

@@ -0,0 +1,3 @@
+export declare function setEditorAuth(token: string | null, brandId: string | null): void;
+export declare function getEditorToken(): string | null;
+export declare function getEditorBrandId(): string | null;

package/dist/lib/editor-auth.js

@@ -0,0 +1 @@
+import{currentEditorSession as t}from"./editor-session.js";function d(n,o){const{auth:r}=t();r.token=n,r.brandId=o}function u(){return t().auth.token}function i(){return t().auth.brandId}export{i as getEditorBrandId,u as getEditorToken,d as setEditorAuth};

package/dist/lib/editor-block-metadata.d.ts

@@ -0,0 +1,6 @@
+import { type ReactNode } from "react";
+export declare function BlockMetadataProvider({ metadata, children, }: {
+    metadata: Record<string, unknown> | undefined;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare const useBlockMetadata: () => Record<string, unknown> | undefined;

package/dist/lib/editor-block-metadata.js

@@ -0,0 +1 @@
+"use client";import{jsx as r}from"react/jsx-runtime";import{createContext as a,useContext as n}from"react";const t=a(void 0);function i({metadata:e,children:o}){return r(t.Provider,{value:e,children:o})}const s=()=>n(t);export{i as BlockMetadataProvider,s as useBlockMetadata};

package/dist/lib/editor-blocks.d.ts

@@ -0,0 +1,20 @@
+import type { ComponentConfig } from "efficient-easel/blocks";
+import { type EditorSession } from "./editor-session.js";
+import { type BlockSet } from "./puck/section-catalog.js";
+export interface EditorBlockCategory {
+    key: string;
+    title: string;
+    components: string[];
+    before?: string;
+}
+export interface EditorBlocks {
+    sets?: readonly BlockSet[];
+    allow?: readonly string[];
+    deny?: readonly string[];
+    host?: Record<string, ComponentConfig>;
+    categories?: EditorBlockCategory[];
+    metadata?: Record<string, unknown>;
+}
+export type OfferedSets = Readonly<Record<BlockSet, boolean>>;
+export declare function offeredSets(blocks: EditorBlocks | null | undefined): OfferedSets;
+export declare function offeredSetsOf(session?: EditorSession): OfferedSets;

package/dist/lib/editor-blocks.js

@@ -0,0 +1 @@
+import{currentEditorSession as o}from"./editor-session.js";import{BLOCK_SETS as n}from"./puck/section-catalog.js";const s={general:!0,commerce:!0,service:!0};function c(e){const r=e?.sets;return r?Object.fromEntries(n.map(t=>[t,r.includes(t)])):s}function u(e=o()){return c(e.blocks)}export{c as offeredSets,u as offeredSetsOf};

package/dist/lib/editor-canvas-styles.d.ts

@@ -0,0 +1,12 @@
+import { type ReactNode } from "react";
+export interface EditorCanvasStyles {
+    mirrorHostStyles: boolean;
+    css: string | null;
+    fontHrefs: readonly string[];
+}
+export declare function EditorCanvasStylesProvider({ value, children, }: {
+    value: EditorCanvasStyles;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useEditorCanvasStyles(): EditorCanvasStyles;
+export declare function CanvasOwnStyles(): import("react").JSX.Element;

package/dist/lib/editor-canvas-styles.js

@@ -0,0 +1 @@
+"use client";import{jsx as e,Fragment as o,jsxs as a}from"react/jsx-runtime";import{createContext as l,useContext as i}from"react";const c={mirrorHostStyles:!0,css:null,fontHrefs:[]},n=l(c);function d({value:t,children:s}){return e(n.Provider,{value:t,children:s})}function u(){return i(n)}function S(){const{css:t,fontHrefs:s}=u();return a(o,{children:[s.map(r=>e("link",{rel:"stylesheet",href:r},r)),t?e("style",{"data-sf-canvas-css":"",children:t}):null]})}export{S as CanvasOwnStyles,d as EditorCanvasStylesProvider,u as useEditorCanvasStyles};

package/dist/lib/editor-chrome.d.ts

@@ -0,0 +1,52 @@
+import type { ComponentType, ReactNode, RefObject } from "react";
+export type EditorSurface = "page" | "section";
+export interface HostPanelProps {
+    placeholderMode: boolean;
+    tokenRef: RefObject<string | null>;
+    siteId: string | null;
+    websiteName: string | null;
+    onOpenWebsiteSettings?: () => void;
+    onAuthExpired: () => void;
+}
+export interface HostPageRow {
+    key: string;
+    label: string;
+    href: string;
+    icon: ReactNode;
+}
+export interface HostProduct {
+    slug: string;
+    name: string;
+    href: string;
+}
+export interface HostLinkRowProps {
+    value: string;
+    onChange: (url: string) => void;
+    pages: readonly {
+        slug: string;
+        layout?: unknown;
+    }[];
+}
+export interface EditorChrome {
+    wrap?: ComponentType<{
+        surface: EditorSurface;
+        children: ReactNode;
+    }>;
+    panels?: {
+        header?: ComponentType<HostPanelProps>;
+        chromePage?: ComponentType;
+    };
+    pageRows?: {
+        title: string;
+        rows: readonly HostPageRow[];
+    };
+    products?: {
+        list(): Promise<readonly HostProduct[]>;
+    };
+    linkRow?: ComponentType<HostLinkRowProps>;
+}
+export declare function ChromeWrap({ wrap: Wrap, surface, children, }: {
+    wrap: EditorChrome["wrap"] | undefined;
+    surface: EditorSurface;
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/lib/editor-chrome.js

@@ -0,0 +1 @@
+"use client";import{jsx as n,Fragment as a}from"react/jsx-runtime";function m({wrap:r,surface:t,children:e}){return r?n(r,{surface:t,children:e}):n(a,{children:e})}export{m as ChromeWrap};

package/dist/lib/editor-document-adapter.d.ts

@@ -0,0 +1,55 @@
+import { type OfferedSets } from "./editor-blocks.js";
+import type { EditorPageRow, SiteRecord, SiteRecordPatch, WebsiteBackend, WebsiteEditLock } from "./web-backend.js";
+export type { EditorPageRow };
+export type EditorCapabilities = {
+    canPublish: boolean;
+    hasSiteSettings: boolean;
+    hasSiteTheme: boolean;
+    placeholderFrames: boolean;
+    mediaEditing: boolean;
+    pageCreationInAdminForm: boolean;
+    canDeletePagesInline: boolean;
+    hasEditLock: boolean;
+    hasEditGuard: boolean;
+    hasPinnedChrome: boolean;
+    explainsSiteSettings: boolean;
+    hasSiteRecord: boolean;
+    canEditSiteRecord: boolean;
+    hasPreviewLink: boolean;
+    hasCatalog: boolean;
+    hasForms: boolean;
+    hasBlog: boolean;
+    offersCommerce: boolean;
+    offersService: boolean;
+};
+export type EditorDocument = {
+    id: string;
+    layout: unknown;
+    kind?: string | null;
+    version?: string | null;
+};
+export interface EditorDocumentAdapter {
+    capabilities: EditorCapabilities;
+    resolve(slug: string): Promise<EditorDocument | null>;
+    saveLayout(id: string, layout: Record<string, unknown>, version: string | null, clientId?: string): Promise<{
+        version: string | null;
+    }>;
+    rereadVersion?(id: string): Promise<string | null>;
+    publish?(id: string, version?: string): Promise<{
+        version: string | null;
+    }>;
+    lock?: WebsiteEditLock;
+    listPages(): Promise<EditorPageRow[]>;
+    createPage?(input: {
+        slug: string;
+        title: string;
+        layout: Record<string, unknown>;
+    }): Promise<EditorPageRow>;
+    deletePage?(id: string): Promise<void>;
+    site?(): Promise<SiteRecord>;
+    updateSite?(patch: SiteRecordPatch): Promise<SiteRecord>;
+    templateName?(): Promise<string>;
+    previewHref?(slug: string): string;
+}
+export declare function makeSitePageAdapter(siteId: string | undefined, backend?: WebsiteBackend, offered?: OfferedSets): EditorDocumentAdapter;
+export declare function makeTemplatePageAdapter(templateId: string, backend?: WebsiteBackend, offered?: OfferedSets): EditorDocumentAdapter;

package/dist/lib/editor-document-adapter.js

@@ -0,0 +1 @@
+"use client";import{offeredSetsOf as c}from"./editor-blocks.js";import{backendOf as m,isEfficientBackend as u}from"./editor-session.js";function h(t,i){const s=i?{siteId:i}:void 0;return{resolve:e=>t.load({slug:e,...s}),saveLayout:(e,o,r,a)=>t.save(e,{layout:o},{version:r,clientId:a??""}),rereadVersion:t.version?e=>t.version(e):void 0,publish:t.publish?(e,o)=>t.publish(e,o?{version:o}:void 0):void 0,listPages:()=>t.list(s),createPage:t.create?e=>t.create({...e,...s}):void 0,deletePage:t.remove?e=>t.remove(e):void 0}}function v(t,i=m(),s=c()){const e=u(i),o=t?{siteId:t}:void 0,r=e?!!t:!0,a=i.site.update;return{capabilities:{canPublish:!!i.pages.publish,hasSiteSettings:e,hasSiteTheme:!!i.theme,placeholderFrames:!1,mediaEditing:!0,pageCreationInAdminForm:!i.pages.create,canDeletePagesInline:!!i.pages.remove,hasEditLock:!!i.lock,hasEditGuard:!0,hasPinnedChrome:e&&s.commerce&&s.service,explainsSiteSettings:!1,hasSiteRecord:r,canEditSiteRecord:r&&!!a,hasPreviewLink:e||!!i.preview,hasCatalog:e&&s.commerce,hasForms:e&&s.service,hasBlog:!!i.blog&&s.service,offersCommerce:s.commerce,offersService:s.service},...h(i.pages,t),lock:i.lock,site:r?()=>i.site.get(o):void 0,updateSite:r&&a?n=>a(n,o):void 0,previewHref:i.preview?n=>i.preview.href(n):void 0}}function f(t,i=m(),s=c()){const e=u(i),o=i.templates,r=o?o.pages(t):{list:()=>Promise.reject(new Error(l)),load:()=>Promise.reject(new Error(l)),save:()=>Promise.reject(new Error(l))};return{capabilities:{canPublish:!1,hasSiteSettings:!1,hasSiteTheme:!1,placeholderFrames:!0,mediaEditing:!1,pageCreationInAdminForm:!r.create,canDeletePagesInline:!!r.remove,hasEditLock:!1,hasEditGuard:!1,hasPinnedChrome:e&&s.commerce&&s.service,explainsSiteSettings:e,hasSiteRecord:!1,canEditSiteRecord:!1,hasPreviewLink:!1,hasCatalog:e&&s.commerce,hasForms:e&&s.service,hasBlog:!!i.blog&&s.service,offersCommerce:s.commerce,offersService:s.service},...h(r,void 0),publish:void 0,templateName:o?()=>o.get(t).then(a=>a.name):void 0}}const l="This editor's backend has no website templates.";export{v as makeSitePageAdapter,f as makeTemplatePageAdapter};

package/dist/lib/editor-document-hooks.d.ts

@@ -0,0 +1,15 @@
+import type { Data } from "efficient-easel/blocks";
+import type { EditorCapabilities } from "./editor-document-adapter.js";
+export interface OpeningDocument {
+    slug: string;
+    isTemplate: boolean;
+    capabilities: EditorCapabilities;
+}
+export interface EditorDocumentHooks {
+    opening?(document: OpeningDocument): (layout: Data) => Promise<Data>;
+    stored?(layout: Data): Data;
+    storedNode?<T extends {
+        type: string;
+        props?: Record<string, unknown>;
+    }>(node: T): T;
+}

package/dist/lib/editor-events.d.ts

@@ -0,0 +1,8 @@
+type Listener = () => void;
+export declare function onCollectionCategoriesChanged(cb: Listener): () => void;
+export declare function emitCollectionCategoriesChanged(): void;
+export declare function onHeaderMenusChanged(cb: Listener): () => void;
+export declare function emitHeaderMenusChanged(): void;
+export declare function onStorefrontFormsChanged(cb: Listener): () => void;
+export declare function emitStorefrontFormsChanged(): void;
+export {};

package/dist/lib/editor-events.js

@@ -0,0 +1 @@
+const n=new Set,t=new Set,o=new Set;function r(e){return n.add(e),()=>n.delete(e)}function a(){n.forEach(e=>e())}function d(e){return t.add(e),()=>t.delete(e)}function i(){t.forEach(e=>e())}function h(e){return o.add(e),()=>o.delete(e)}function C(){o.forEach(e=>e())}export{a as emitCollectionCategoriesChanged,i as emitHeaderMenusChanged,C as emitStorefrontFormsChanged,r as onCollectionCategoriesChanged,d as onHeaderMenusChanged,h as onStorefrontFormsChanged};

package/dist/lib/editor-failure.d.ts

@@ -0,0 +1,4 @@
+import { type EditLockFailure } from "efficient-easel/edit-lock";
+export declare const PAGE_CONFLICT_CODE = "page_changed_elsewhere";
+export declare function readEditorFailure(err: unknown): EditLockFailure | null;
+export declare function isExpiredSession(err: unknown): boolean;

package/dist/lib/editor-failure.js

@@ -0,0 +1 @@
+import{EDIT_LOCK_TAKEN as o}from"efficient-easel/edit-lock";import{STATUS_UNREACHABLE as d,isBackendError as c,readHostFailure as s}from"./web-backend.js";const i="page_changed_elsewhere",u={unauthorized:401,"changed-elsewhere":409,"lock-taken":409,"not-found":404,invalid:400,unavailable:d};function l(e){const n=s(e);if(n)return{status:n.status,data:n.data};if(!c(e))return null;const t=s(e.cause);if(t)return{status:t.status,data:t.data};const a=u[e.kind];return e.kind==="changed-elsewhere"?{status:a,data:{code:i,saved_by:e.conflict?.savedBy??"",saved_by_you:e.conflict?.savedByYou===!0,seconds_ago:e.conflict?.secondsAgo??0}}:e.kind==="lock-taken"?{status:a,data:{code:o,holder_name:e.holder?.name??"",seconds_since_seen:e.holder?.secondsSinceSeen??0,seconds_since_held:e.holder?.secondsSinceHeld??0}}:{status:a,data:null}}function f(e){return l(e)?.status===401}export{i as PAGE_CONFLICT_CODE,f as isExpiredSession,l as readEditorFailure};

package/dist/lib/editor-form-window.d.ts

@@ -0,0 +1,21 @@
+import type { EditorHost } from "./editor-host.js";
+export interface SavedForm {
+    id: string;
+    slug: string;
+}
+export type FormEditOutcome = {
+    status: "saved";
+    form: SavedForm;
+} | {
+    status: "closed";
+} | {
+    status: "timeout";
+};
+export declare const REPLY_TIMEOUT_MS = 900000;
+export declare function openFormBuilder(host: EditorHost, formId: string): void;
+export declare function requestFormEdit(host: EditorHost, opts: {
+    mode: "create" | "edit";
+    formId?: string;
+    timeoutMs?: number;
+}): Promise<FormEditOutcome>;
+export declare function resolveFormEdit(requestId: string, form: SavedForm | null): void;

package/dist/lib/editor-form-window.js

@@ -0,0 +1 @@
+const n=new Map,c=9e5;let r=0;function m(){return r+=1,`fe-${typeof crypto<"u"&&"randomUUID"in crypto?crypto.randomUUID():String(r)}`}function f(e,t){e.connected&&e.send("storefront-editor:open-form",{mode:"edit",formId:t})}function a(e,t){if(!e.connected)return Promise.resolve({status:"closed"});const o=m();return new Promise(s=>{const i=setTimeout(()=>d(o,{status:"timeout"}),t.timeoutMs??c);n.set(o,u=>{clearTimeout(i),s(u)}),e.send("storefront-editor:open-form",{requestId:o,mode:t.mode,...t.formId?{formId:t.formId}:{}})})}function d(e,t){const o=n.get(e);o&&(n.delete(e),o(t))}function l(e,t){d(e,t?{status:"saved",form:t}:{status:"closed"})}export{c as REPLY_TIMEOUT_MS,f as openFormBuilder,a as requestFormEdit,l as resolveFormEdit};

package/dist/lib/editor-host-inbound.d.ts

@@ -0,0 +1 @@
+export declare function routeSharedHostMessage(raw: unknown): boolean;

package/dist/lib/editor-host-inbound.js

@@ -0,0 +1 @@
+import{emitCollectionCategoriesChanged as d,emitHeaderMenusChanged as n,emitStorefrontFormsChanged as r}from"./editor-events.js";import{resolveFormEdit as o}from"./editor-form-window.js";import{resolveMediaPick as s}from"./editor-media-picker.js";function a(t){switch(t?.type){case"storefront-editor:category-updated":return d(),!0;case"storefront-editor:menus-updated":return n(),!0;case"storefront-editor:form-saved":{const e=t;return r(),e.requestId&&o(e.requestId,e.form??null),!0}case"storefront-editor:form-closed":{const e=t;return r(),e.requestId&&o(e.requestId,null),!0}case"storefront-editor:media-picked":{const e=t;return e.requestId&&s(e.requestId,e.media??null),!0}case"storefront-editor:media-pick-cancelled":{const e=t;return e.requestId&&s(e.requestId,null),!0}default:return!1}}export{a as routeSharedHostMessage};

package/dist/lib/editor-host.d.ts

@@ -0,0 +1,135 @@
+import { type ReactNode } from "react";
+import type { EditorTarget } from "../components/StorefrontDocumentContext.js";
+export interface HostPickedMedia {
+    id: string;
+    url: string;
+    kind: "image" | "video";
+}
+export type SectionEditorTarget = {
+    kind: "section";
+    id: string;
+    type?: string;
+    name?: string;
+};
+export type EditorToHostMessage = {
+    type: "storefront-editor:ready";
+} | {
+    type: "storefront-editor:auth-expired";
+} | {
+    type: "storefront-editor:dirty";
+} | {
+    type: "storefront-editor:saved";
+} | {
+    type: "storefront-editor:published";
+} | {
+    type: "storefront-editor:save-failed";
+} | {
+    type: "storefront-editor:navigated";
+    target: EditorTarget;
+} | {
+    type: "storefront-editor:open-media-picker";
+    requestId: string;
+    accept: string;
+    title: string;
+    file?: File;
+} | {
+    type: "storefront-editor:open-form";
+    requestId?: string;
+    mode: "create" | "edit";
+    formId?: string;
+} | {
+    type: "storefront-editor:open-category";
+    categoryId: string;
+    name?: string;
+} | {
+    type: "storefront-editor:open-product";
+    slug: string;
+    name?: string;
+} | {
+    type: "storefront-editor:open-post";
+    slug: string;
+    title?: string;
+} | {
+    type: "storefront-editor:open-menus";
+    menuId?: string | null;
+} | {
+    type: "storefront-editor:open-page";
+    slug: string;
+} | {
+    type: "storefront-editor:new-page";
+} | {
+    type: "storefront-editor:save-as-template";
+    siteId: string;
+    slug: string;
+};
+export type HostToEditorMessage = {
+    type: "storefront-editor:auth";
+    token: string;
+    siteId?: string;
+    brandId?: string;
+    theme?: string;
+    can?: {
+        canCreatePlatformTemplate?: boolean;
+    };
+} | {
+    type: "storefront-editor:navigate";
+    target: EditorTarget | SectionEditorTarget;
+} | {
+    type: "storefront-editor:category-updated";
+    categoryId?: string;
+} | {
+    type: "storefront-editor:menus-updated";
+} | {
+    type: "storefront-editor:form-saved";
+    requestId?: string;
+    form?: {
+        id: string;
+        slug: string;
+    };
+} | {
+    type: "storefront-editor:form-closed";
+    requestId?: string;
+} | {
+    type: "storefront-editor:media-picked";
+    requestId: string;
+    media: HostPickedMedia;
+} | {
+    type: "storefront-editor:media-pick-cancelled";
+    requestId: string;
+};
+export type EditorMessageType = EditorToHostMessage["type"];
+type PayloadOf<T extends EditorMessageType> = Omit<Extract<EditorToHostMessage, {
+    type: T;
+}>, "type">;
+export type SendToHost = <T extends EditorMessageType>(type: T, ...payload: Record<string, never> extends PayloadOf<T> ? [PayloadOf<T>?] : [PayloadOf<T>]) => void;
+export type InboundHostMessage = {
+    type: string;
+} & Record<string, unknown>;
+export interface EditorHostAddress {
+    search(): string;
+    show(target: EditorTarget | SectionEditorTarget): void;
+    load(target: EditorTarget): void;
+    reload(): void;
+}
+export interface EditorHost {
+    readonly connected: boolean;
+    readonly ownsDocument: boolean;
+    send: SendToHost;
+    subscribe(listener: (message: InboundHostMessage) => void): () => void;
+    readonly address: EditorHostAddress;
+}
+export declare const DETACHED_EDITOR_HOST: EditorHost;
+export declare const EditorHostContext: import("react").Context<EditorHost>;
+export declare function EditorHostProvider({ host, children }: {
+    host: EditorHost;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useEditorHost(): EditorHost;
+export declare function createEditorHost(options: {
+    onMessage: (message: EditorToHostMessage) => void;
+    address: EditorHostAddress;
+}): {
+    host: EditorHost;
+    deliver: (message: HostToEditorMessage) => void;
+};
+export {};

package/dist/lib/editor-host.js

@@ -0,0 +1 @@
+"use client";import{jsx as n}from"react/jsx-runtime";import{createContext as d,useContext as c}from"react";const i={connected:!1,ownsDocument:!0,send:()=>{},subscribe:()=>()=>{},address:{search:()=>"",show:()=>{},load:()=>{},reload:()=>{}}},s=d(i);function f({host:o,children:t}){return n(s.Provider,{value:o,children:t})}function E(){return c(s)}function m(o){const t=new Set;return{host:{connected:!0,ownsDocument:!1,send:((e,r)=>{o.onMessage({type:e,...r})}),subscribe(e){return t.add(e),()=>{t.delete(e)}},address:o.address},deliver:e=>{for(const r of[...t])r(e)}}}export{i as DETACHED_EDITOR_HOST,s as EditorHostContext,f as EditorHostProvider,m as createEditorHost,E as useEditorHost};

package/dist/lib/editor-key-scope.d.ts

@@ -0,0 +1,3 @@
+import { type RefObject } from "react";
+export declare function useEditorKeyTarget(rootRef: RefObject<HTMLElement | null>): EventTarget | null;
+export declare function useEditorUndoKeys(rootRef: RefObject<HTMLElement | null>): void;

package/dist/lib/editor-key-scope.js

@@ -0,0 +1 @@
+"use client";import{useEffect as r,useState as s}from"react";import{bindUndoKeys as i,useEaselApi as c}from"efficient-easel/easel";import{useEditorHost as u}from"./editor-host.js";function d(e){const o=u(),[n,t]=s(null);return r(()=>t(e.current),[e]),o.ownsDocument?typeof document>"u"?null:document:n}function l(e){const o=u(),n=c(),t=d(e);r(()=>{if(!(o.ownsDocument||!t))return i(t,n)},[o,n,t])}export{d as useEditorKeyTarget,l as useEditorUndoKeys};

package/dist/lib/editor-load-error.d.ts

@@ -0,0 +1,4 @@
+export declare function describeLoadFailure(e: unknown): string;
+export declare function hostLoadRefusal(e: unknown, document: {
+    slug: string;
+}): string | null;

package/dist/lib/editor-load-error.js

@@ -0,0 +1 @@
+import{STATUS_UNREACHABLE as a,hostLoadRefusalOf as n,hostUnreachableMessage as r,isBackendError as i,readHostFailure as s}from"./web-backend.js";const o={unauthorized:"the editor's sign-in was refused (unauthorized).","changed-elsewhere":"the page changed while it was being opened (changed-elsewhere).","lock-taken":"somebody else holds this page (lock-taken).","not-found":"this page no longer exists (not-found).",invalid:"the backend refused the request (invalid).",unavailable:"the backend could not be reached (unavailable)."};function u(t){if(i(t))return s(t.cause)?u(t.cause):`${o[t.kind]} ${t.message}`.trim();const e=s(t);return e?e.status===a?`${r()} (no response)`:e.status===401||e.status===403?`the editor's sign-in was refused (${e.status}). Reload the console and open the editor again; if it keeps happening the bridged token is not valid for this site.`:e.status===404?"this page no longer exists (404).":e.status>=500?`the server failed (${e.status}). ${e.message}`:`the server refused the request (${e.status}). ${e.message}`:t instanceof Error?`${t.name}: ${t.message}`:String(t)}function h(t,e){return n(t,e)}export{u as describeLoadFailure,h as hostLoadRefusal};

package/dist/lib/editor-media-panel.d.ts

@@ -0,0 +1,23 @@
+import { type ComponentType, type ReactNode } from "react";
+import type { HostPickedMedia } from "./editor-host.js";
+export interface MediaPickRequest {
+    requestId: string;
+    accept: string;
+    title: string;
+    file?: File | null;
+}
+export interface MediaPanelProps {
+    pick: MediaPickRequest | null;
+    onPick: (media: HostPickedMedia) => void;
+}
+export type MediaPanelComponent = ComponentType<MediaPanelProps>;
+export declare function MediaPanelProvider({ panel, children }: {
+    panel: MediaPanelComponent | null;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useMediaPanel(): MediaPanelComponent | null;
+export declare function hasMediaPanel(): boolean;
+export declare function requestPanelPick(request: MediaPickRequest): Promise<HostPickedMedia | null>;
+export declare function settlePanelPick(requestId: string, media: HostPickedMedia | null): void;
+export declare function cancelPanelPick(): void;
+export declare function usePanelPick(): MediaPickRequest | null;

package/dist/lib/editor-media-panel.js

@@ -0,0 +1 @@
+"use client";import{jsx as c}from"react/jsx-runtime";import{createContext as f,useContext as a,useEffect as d,useSyncExternalStore as P}from"react";const l=f(null);let r=null;function k({panel:e,children:n}){return r=e,d(()=>(r=e,()=>{r===e&&(r=null,i(t?.request.requestId??"",null))}),[e]),c(l.Provider,{value:e,children:n})}function M(){return a(l)}function h(){return r!==null}let t=null;const o=new Set,s=()=>{for(const e of[...o])e()};function C(e){return new Promise(n=>{const u=t;t={request:e,resolve:n},s(),u?.resolve(null)})}function i(e,n){if(!t||t.request.requestId!==e)return;const{resolve:u}=t;t=null,s(),u(n)}function I(){t&&i(t.request.requestId,null)}function x(e){return o.add(e),()=>{o.delete(e)}}const q=()=>t?.request??null,p=()=>null;function S(){return P(x,q,p)}export{k as MediaPanelProvider,I as cancelPanelPick,h as hasMediaPanel,C as requestPanelPick,i as settlePanelPick,M as useMediaPanel,S as usePanelPick};

package/dist/lib/editor-media-picker.d.ts

@@ -0,0 +1,12 @@
+import type { EditorHost } from "./editor-host.js";
+export interface PickedMedia {
+    id: string;
+    url: string;
+    kind: "image" | "video";
+}
+export declare function requestMediaPick(host: EditorHost, opts: {
+    accept: string;
+    title: string;
+    file?: File | null;
+}): Promise<PickedMedia | null>;
+export declare function resolveMediaPick(requestId: string, media: PickedMedia | null): void;

package/dist/lib/editor-media-picker.js

@@ -0,0 +1 @@
+import{hasMediaPanel as l,requestPanelPick as o}from"./editor-media-panel.js";const r=new Map;let i=0;function a(){return i+=1,`mp-${typeof crypto<"u"&&"randomUUID"in crypto?crypto.randomUUID():String(i)}`}function f(n,e){if(!n.connected)return Promise.resolve(null);const t=a();return l()?o({requestId:t,accept:e.accept,title:e.title,file:e.file??null}):new Promise(c=>{r.set(t,c),n.send("storefront-editor:open-media-picker",{requestId:t,accept:e.accept,title:e.title,...e.file?{file:e.file}:{}})})}function u(n,e){const t=r.get(n);t&&(r.delete(n),t(e))}export{f as requestMediaPick,u as resolveMediaPick};

package/dist/lib/editor-page-lock.d.ts

@@ -0,0 +1 @@
+export declare const pageEditLock: import("efficient-easel/edit-lock").EditLock;

package/dist/lib/editor-page-lock.js

@@ -0,0 +1 @@
+import{createEditLock as o}from"efficient-easel/edit-lock";import{PAGE_CONFLICT_CODE as r,readEditorFailure as e}from"./editor-failure.js";const a=o({readFailure:e,conflictCode:r});export{a as pageEditLock};