efficient-web-builder 0.9.0 → 1.0.0

package/dist/lib/puck/section-catalog.js

@@ -0,0 +1 @@
+const p=["general","commerce","service"],o=[{key:"openers",title:"Hero & intros",defaultExpanded:!0,templateable:!0,sections:[{type:"Hero",label:"Hero Slideshow",set:"general"},{type:"HeroSingle",label:"Hero",set:"general"},{type:"IntroBleed",label:"Scroll-Over Text",set:"general"}]},{key:"shop",title:"Shop & galleries",templateable:!0,sections:[{type:"Collections",label:"Collections",set:"commerce"},{type:"BrandStrip",label:"Brand Strip",set:"commerce"},{type:"AlloyWheelsListing",label:"List",set:"commerce"},{type:"CatalogFilterBar",label:"Catalog Filter Bar",set:"commerce"},{type:"ProductGrid",label:"Product Grid",set:"commerce"},{type:"FitmentFinder",label:"Fitment Form",set:"commerce"},{type:"Gallery",label:"Tabbed Gallery",set:"commerce"},{type:"GalleryB",label:"Customer Photo Grid",set:"commerce"},{type:"SpecStrip",label:"Spec Strip",set:"general"}]},{key:"product",title:"Product page",templateable:!0,sections:[{type:"ProductHero",label:"Product Hero",set:"commerce"},{type:"SpecTable",label:"Spec Table",set:"commerce"},{type:"ProcessSteps",label:"Image & Text Columns",set:"general"},{type:"DetailRows",label:"Feature Rows",set:"commerce"},{type:"FitmentTable",label:"Fitment Table",set:"commerce"},{type:"TyreSizes",label:"Tyre Sizes",set:"commerce"},{type:"TyreFitment",label:"Tyre Fitment Form",set:"commerce"},{type:"EuTyreLabel",label:"EU Tyre Label",set:"commerce"},{type:"RelatedProducts",label:"Related Products",set:"commerce"},{type:"BundleOffer",label:"Bundle Products",set:"commerce"}]},{key:"checkout",title:"Checkout & ordering",templateable:!0,sections:[{type:"OrderSummary",label:"Order Table",set:"general"},{type:"DeliveryOptions",label:"Delivery Options",set:"commerce"},{type:"PaymentBadges",label:"Payment Methods",set:"general"},{type:"CheckoutCTA",label:"Ready-to-Order Banner",set:"commerce"}]},{key:"about",title:"About & brand story",templateable:!0,sections:[{type:"Manifesto",label:"Brand Text",set:"general"},{type:"Timeline",label:"Story Timeline",set:"general"},{type:"TimelineTrack",label:"Milestone Timeline",set:"general"},{type:"Footprint",label:"Locations Map",set:"general"}]},{key:"content",title:"Text & content",templateable:!0,sections:[{type:"Prose",label:"Editorial Text",set:"general"},{type:"ParagraphsA",label:"Lead Text",set:"general"},{type:"Split",label:"Image & Text Split",set:"general"},{type:"Cards",label:"Cards",set:"general"},{type:"KeyFeatures",label:"Key Features",set:"general"}]},{key:"proof",title:"Stats & social proof",templateable:!0,sections:[{type:"Stats",label:"Stats",set:"general"},{type:"StatsParagraph",label:"Stats with Text",set:"general"},{type:"Chart",label:"Chart",set:"general"},{type:"Mockup",label:"Mockup Card",set:"general"},{type:"Testimonials",label:"Testimonials",set:"general"},{type:"Reviews",label:"Reviews",set:"service"},{type:"Logos",label:"Logos",set:"general"}]},{key:"promo",title:"Promotions & sign-ups",templateable:!0,sections:[{type:"Banner",label:"Banner",set:"general"},{type:"TitleWithButtons",label:"Call-to-Action Heading",set:"general"},{type:"Ticker",label:"Scrolling Bar",set:"general"},{type:"Subscribe",label:"Signup Form",set:"service"}]},{key:"blog",title:"Blog & journal",templateable:!0,sections:[{type:"Masthead",label:"Issue Header",set:"general"},{type:"FeaturedCover",label:"Feature Banner",set:"general"},{type:"LongRead",label:"Article Text",set:"general"},{type:"Series",label:"Recurring Columns",set:"general"},{type:"Events",label:"Latest Posts",set:"service"}]},{key:"navigation",title:"Navigation & wayfinding",templateable:!0,sections:[{type:"Breadcrumb",label:"Breadcrumb",set:"general"},{type:"CategoryBar",label:"Category Bar",set:"general"},{type:"DocTabs",label:"Document Tabs",set:"general"}]},{key:"legal",title:"Legal & documents",templateable:!0,sections:[{type:"DocMasthead",label:"Document Header",set:"general"},{type:"DocBody",label:"Document Text",set:"general"},{type:"DocMetaCards",label:"Document Detail Cards",set:"general"}]},{key:"contact",title:"Contact, FAQ & forms",templateable:!0,sections:[{type:"FAQ",label:"Q&A",set:"general"},{type:"ContactRouting",label:"Contact Form",set:"service"},{type:"ContactLocations",label:"Contact / Locations",set:"general"},{type:"SubmitBuild",label:"Photo Submission Form",set:"service"},{type:"ReviewForm",label:"Review Form",set:"service"},{type:"Form",label:"Form",set:"service"},{type:"AppointmentBooking",label:"Booking Form",set:"service"}]},{key:"structure",title:"Layout, structure & embeds",templateable:!1,sections:[{type:"SectionHeader",label:"Section Header",set:"general"},{type:"Flex",label:"Box",set:"general"},{type:"Spacer",label:"Spacer",set:"general"},{type:"Divider",label:"Divider",set:"general"},{type:"CustomHTML",label:"Custom HTML",set:"general"}]}];function h(){return Object.fromEntries(o.map(e=>[e.key,{title:e.title,components:e.sections.map(t=>t.type),...e.defaultExpanded?{defaultExpanded:!0}:{}}]))}const l={Grid:'Lewis, 2026-09-14: Box and Grid duplicate each other and it feels confusing. 2026-09-15 he chose the order: give Box uneven widths FIRST, then merge Grid into Box. Shown three ways to pick the widths (mockup "Uneven Box Widths"), he chose A \u2014 shape pictures on the Box\'s `Block widths` row, the same "a row is a shape, pick a picture of it" rule he set for the photo wall on 2026-09-07.\n\nWHAT REPLACES IT: a Box set to One row, with `Block widths` at Equal or a shape (Big left, Big right, Bigger left, Bigger right) and its own `Columns on phone`. Measured on PRODUCTION 2026-09-16 ~09:28 AEST (database `efficient-system`, all 10 tenant schemas, 128 storefront pages, both `layout` and `published_layout` \u2014 256 documents): 2 Grid nodes, and they are ONE Grid counted twice \u2014 the 9DIEM homepage on 9diem.com (`xtreme_mudder` schema), once as draft and once as published. It is top-level, holds three `ImageBlock`s at `columns` 3 \u2014 equal thirds \u2014 and NO block sets `Positions`. A Box draws that with `Block widths` at Equal.\n\n\u26A0\uFE0F THE COUNT MOVES; THE RULE MUST NOT DEPEND ON IT. This entry has already carried three different readings. A local-clone snapshot said no Grid used `Positions`. A PRODUCTION reading on 2026-09-15 ~13:15 AEST found 6 nodes on two sites, 4 of them spanned \u2014 hartesmetal.com.au homepage and about, 4 columns, spans 1 + 3. That one was TRUE when it was taken and stopped being true the same day: those two pages were rebuilt on Box (`Block widths: Bigger right`), and on 2026-09-16 they hold zero Grid nodes and are built from `Flex`. \u26D4 So the rule is NOT "there are still N spanned Grids". NEVER delete the Grid component or its `gridSpan` handling, whatever a census says \u2014 Grid still renders, still edits, still drags, and a merchant may rebuild a page either way on any day. Re-run the census on production before anyone PROPOSES deleting either, and read any number written here as the reading of its own day, not as the state of the world.\n\nWHAT A MERCHANT LOSES: a new Grid, and with it a fixed "N per row" that wraps by itself past three across, and the per-block `Positions` number. Box wraps with `Wrap`, but by content width, not by a fixed count.\n\nTHE TYPE KEY STAYS AND SO DOES THE COMPONENT. Every page holding a Grid still renders through it and can still be edited, dragged and added to; no document is rewritten and NO MIGRATION RUNS \u2014 the owner redoes live sections himself.\n\n\u26A0\uFE0F AND IT STAYS DROPPABLE WHERE IT LIVES. The drop rule in lib/puck/config.tsx read the nestable containers off the catalogue\'s `structure` row, so leaving the catalogue would have made every open slot \u2014 a Box included \u2014 refuse a Grid already stored inside one. `scripts/test-retired-grid-stays-editable.tsx` \xA73 pins it.',CompatibleTyres:'Lewis, 2026-09-09: "Do not bother counting. Delete Compatible Tyres and use the new one. The new one needs complete settings \u2014 it must have every setting our cards have." Shown three ways to finish it, he chose C: retire from the menu now, and take styling the card text as its own card.\n\nWHAT REPLACES IT: `RelatedProducts` with its `Show` dropdown set to "Tyres that fit this product". That block is the GENERIC relationship section from card 1128 \u2014 it knows nothing about wheels or tyres, it asks the registry for a relationship by name. The two have rendered through the SAME renderer (`DynamicRelatedProducts`) since that card; this one is the pre-registry one-off that was never removed.\n\n\u26A0\uFE0F THE SWAP WAS NOT SAFE UNTIL #1305, AND SAYING SO IS THE POINT. The first old-versus-new table put in front of the owner was WRONG. `DynamicRelatedProducts` returns EARLY on a tyre answer and draws this component, so the seven card settings, the head split and the Width control all stopped at that call \u2014 nine settings, measured NO EFFECT, on precisely the relationship that replaces this block. #1283 gave the new block the card settings, #1299 the head split and its own Width, #1305 carried all of it onto the tyre branch. Only then was the claim true.\n\nWHAT WAS MEASURED BEFORE RETIRING, four ways, because the premise decides the card:\n  \u2022 settable text kinds (SECTION_TEXT_KINDS): both blocks ABSENT \u2014 the map holds only TimelineTrack and Footprint, both AUTHORED lists\n  \u2022 read-only text regions: neither `components/CompatibleTyres` nor `components/TyreCard` stamps one\n  \u2022 panel rows through resolveFields: this block 31, `RelatedProducts` 42. This block\'s only style-ish key is `_sStyle`, the bucket HEADER, not a control\n  \u2022 head text (num/title/description) is authored on both, so `_partStyles` reaches it identically\nSo on the CARD runs the two are zero against zero \u2014 neither can style them \u2014 and everywhere else the new block is ahead. Styling those runs needs a section-level prop family and a paint path for DERIVED text, which no section has yet: a part is anchored by matching an AUTHORED prop\'s string against the DOM, and `lib/puck/source-bound-parts` keeps hydrated copy unreachable on purpose so a merchant cannot type into a copy of a product name and lose it at the next sync. That is its own card, and `lib/sections/text-regions` is the read-only half that already ships.\n\nTHE TYPE KEY STAYS AND SO DOES THE COMPONENT, the same contract Subscribe, Split and SubscribeBlogs have. Every page holding a `CompatibleTyres` still renders through it, no published document is rewritten, and NO MIGRATION RUNS \u2014 the owner\'s standing ruling of 2026-09-05: he redoes live sections himself and deletes the old ones when he does. He also said explicitly not to count them first.\n\n\u26A0\uFE0F AND THIS COMPONENT IS LOAD-BEARING FOR ITS OWN REPLACEMENT: `DynamicRelatedProducts` draws it for EVERY tyre answer. Deleting it would blank the block that replaces it, not just the pages still holding this one.',SubscribeBlogs:"card 66396 \u2014 folded into `Subscribe`, which now chooses its rail's content with a `Type` control (the newsletter's own issues, or live blog posts). The two shared 21 of their fields and rendered THE SAME BYTES from equivalent rows, so offering both asked a merchant to choose between two names for one section. The type key stays because it is stored on published pages, and the component stays because those pages still render through it."},m=["Grid"],y=Array.from(new Set([...o.flatMap(e=>e.sections.map(t=>t.type)),...Object.keys(l)])),u=Object.fromEntries(o.flatMap(e=>e.sections.map(t=>[t.type,t.label]))),i={Heading:"general",Text:"general",Eyebrow:"general",ImageBlock:"general",LogoBlock:"general",ButtonBlock:"general",PostCard:"general",HeroSlide:"general",HeroGroup:"general",Integrations:"general",Grid:"general",CollectionCard:"commerce",GalleryItem:"commerce",ProductRef:"commerce",CompatibleTyres:"commerce",Header:"commerce",SearchBlock:"commerce",CartBlock:"commerce",CountrySwitchBlock:"commerce",SubmitBox:"service",BookingBox:"service",SubscribeBlogs:"service",Footer:"service",FooterLogo:"service",FooterMenu:"service",FooterDivider:"service",FooterGroup:"service",FooterText:"service",FooterEmailSignup:"service",FooterSocial:"service",MenuBlock:"service",EmailFormBlock:"service",SocialLogosBlock:"service",LegalLineBlock:"service",SiteHeader:"service",SiteFooter:"service"},a={...i,...Object.fromEntries(o.flatMap(e=>e.sections.map(t=>[t.type,t.set])))};function b(e){return Object.prototype.hasOwnProperty.call(a,e)?a[e]:void 0}function r(e){return Object.keys(a).filter(t=>a[t]===e).sort()}const g=r("general"),T=r("commerce"),S=r("service"),c="Flex",s="Box",E=`${s}es`;function d(e){return e==="section"?"Blank section":s}function w(e,t,n){return e===c?d(t):n}export{y as ALL_SECTION_TYPES,p as BLOCK_SETS,s as BOX_LABEL,E as BOX_LABEL_PLURAL,T as COMMERCE_BLOCKS,g as GENERAL_BLOCKS,c as LEVEL_NAMED_TYPE,m as RETIRED_NESTABLE_SECTIONS,l as RETIRED_SECTIONS,o as SECTION_CATALOG,u as SECTION_LABELS,S as SERVICE_BLOCKS,i as UNLISTED_BLOCK_SETS,b as blockSetOf,r as blocksInSet,h as buildPuckCategories,w as labelAtLevel,d as labelForFlex};

package/dist/lib/puck/section-descriptions.d.ts

@@ -0,0 +1 @@
+export declare const SECTION_DESCRIPTIONS: Record<string, string>;

package/dist/lib/puck/section-descriptions.js

@@ -0,0 +1 @@
+const e={Hero:"Full-screen opener with rotating slides.",HeroSingle:"Full-screen image or video with a headline.",IntroBleed:"Full-bleed intro image the next section scrolls over.",Collections:"Product collections in a tidy grid.",AlloyWheelsListing:"A full product-listing page: filter rail, sortable card grid and pagination, from the live catalog. Choose which product types it shows.",CatalogFilterBar:"Filters the collection grids below it \u2014 a sticky row of Pills (the default), or Columns, one per filter you switch on.",ProductGrid:"Hand-picked products in a tidy grid.",FitmentFinder:"A vehicle picker \u2014 make, model, year and trim resolve the OEM stock fitment live.",Gallery:"Two image galleries with tabs and filters.",GalleryB:"Customer photos in a card grid with a click-to-open lightbox.",SpecStrip:"A thin one-line spec strip \u2014 small-caps items spread across the width, as a dark band or a bare hairline row.",ProductHero:"A product hero \u2014 image beside price, bullets and a buy button.",SpecTable:"A spec sheet \u2014 labeled rows of product specifications.",ProcessSteps:"A heading over columns of image, title, blurb and specs.",DetailRows:"Repeating full-width rows \u2014 eyebrow, title and copy beside a numbered close-up image, alternating sides each row.",FitmentTable:"A fitment table \u2014 per-size bolt patterns, offsets and load ratings, filterable by diameter.",CompatibleTyres:"The current product's compatible tyres \u2014 image, size, key specs and price per tyre, with an inquiry link. Display only.",RelatedProducts:"The current product's related items in a tidy row \u2014 the product page's built-in 'Pair with' cross-sell.",OrderSummary:"A display order-summary panel \u2014 items, totals and a note.",DeliveryOptions:"Delivery tiers as cards \u2014 name, window and price, one highlighted.",PaymentBadges:"A payment-methods trust strip with reassurance lines.",CheckoutCTA:"A centered 'ready to order?' headline with the checkout button.",Manifesto:"A bold brand statement beside a full-height image, with a stat strip.",ParagraphsA:"An editorial text panel with a stat strip and founders' note.",StatsParagraph:"An editorial heading and paragraph over a row of theme-color-accented stat cards.",Chart:"A titled chart \u2014 bars, line or donut \u2014 drawn from your own labeled data points.",Mockup:"A headline beside a stylized product-UI mockup card \u2014 spec sheet, fitment, portal, kanban and more.",Prose:"A plain editorial text section \u2014 eyebrow, heading and body copy.",Timeline:"An editorial aside beside a rail-marked timeline of dated entries.",TimelineTrack:"A horizontal year track of milestones \u2014 company history or roadmap.",Footprint:"A world map of your locations with a legend \u2014 designed here, sold worldwide.",TitleWithButtons:"A big headline beside a stack of call-to-action buttons.",Split:"Side-by-side image and text in two columns.",Cards:"A heading over a grid of free-text title-and-blurb cards.",FAQ:"A frequently-asked-questions accordion with a header.",Testimonials:"Customer quotes in a grid \u2014 the quote, a name and a role.",Masthead:"A journal issue header with a lead statement and contents.",Breadcrumb:"A slim trail showing where the reader is (Home / Journal\u2026).",CategoryBar:"A sticky row of category tabs with counts and links.",FeaturedCover:"A featured article \u2014 big cover image beside a headline and dek.",LongRead:"A long-form article spread with a pull-quote and cover image.",Series:"A section heading over a grid of column cards.",Subscribe:"A newsletter signup beside a list of recent issues.",SubscribeBlogs:"A newsletter signup beside your latest blog posts, pulled live.",Events:"Latest journal posts in a three-card row.",DocMasthead:"A document header \u2014 headline, metadata and standfirst.",DocTabs:"A sticky tab bar to switch between documents.",DocBody:"Long-form document body with an 'On this page' contents list.",DocMetaCards:"A three-up meta strip for the foot of a document.",Banner:"Wide promo strip with background image.",Stats:"Highlight key numbers \u2014 years, designs.",KeyFeatures:"A theme-color chip and heading over a grid of short feature labels.",Logos:"A row of partner or brand logos.",Ticker:"A scrolling marquee of short phrases, full width.",Reviews:"Approved customer reviews in a star-rated card grid, pulled live.",SubmitBuild:"A 'Show us yours.' headline with a photo-submission form.",ReviewForm:"A write-a-review form \u2014 submissions wait for your approval before they show.",ContactRouting:"Pick who to reach, then a form that routes the message.",ContactLocations:"Your locations as a city gallery plus address and map cards.",SectionHeader:"A numbered section title with optional link.",Grid:"Multi-column container for blocks.",Flex:"An empty section. Add whatever you want inside.",Spacer:"Vertical breathing room between sections.",Divider:"A thin horizontal rule between sections.",CustomHTML:"Drop in your own sanitized HTML.",Heading:"A single heading line.",Text:"A paragraph of body copy.",ImageBlock:"A standalone image, at the width you set.",ButtonBlock:"A call-to-action button."};export{e as SECTION_DESCRIPTIONS};

package/dist/lib/puck/section-doc.d.ts

@@ -0,0 +1,5 @@
+import type { Data } from "efficient-easel/blocks";
+import { type TreeItem } from "./content-tree.js";
+export declare function nodeToDoc(node: TreeItem): Data;
+export declare function docToNode(data: Data): TreeItem | null;
+export declare function cloneNodeWithFreshIds(node: TreeItem): TreeItem;

package/dist/lib/puck/section-doc.js

@@ -0,0 +1 @@
+import{newNodeId as r}from"./content-tree.js";function i(o){return{root:{props:{}},content:[o],zones:{}}}function y(o){return(o.content??[])[0]??null}function p(o){return Array.isArray(o)&&o.length>0&&o.every(t=>!!t&&typeof t=="object"&&typeof t.type=="string"&&typeof t.props=="object")}function c(o){const t={...o.props,id:r(o.type)};for(const[n,e]of Object.entries(t))p(e)&&(t[n]=e.map(c));return{type:o.type,props:t}}export{c as cloneNodeWithFreshIds,y as docToNode,i as nodeToDoc};

package/dist/lib/puck/section-groups.d.ts

@@ -0,0 +1,21 @@
+export declare const SITE_HEADER_TYPE = "SiteHeader";
+export declare const SITE_FOOTER_TYPE = "SiteFooter";
+export declare const SECTION_GROUP_SLOT = "sections";
+export declare const SECTION_GROUP_TYPES: readonly ["SiteHeader", "SiteFooter"];
+export type SectionGroupType = (typeof SECTION_GROUP_TYPES)[number];
+export declare const isSectionGroupType: (type: string | undefined) => type is SectionGroupType;
+type Node = {
+    type?: string;
+    props?: Record<string, unknown>;
+};
+export declare const sectionGroupZone: (groupId: string) => string;
+export declare function buildSectionGroup(type: SectionGroupType, id: string, sections?: Node[]): {
+    type: "SiteHeader" | "SiteFooter";
+    props: {
+        id: string;
+        sections: Node[];
+    };
+};
+export declare function siteFooterDocChrome<T extends Node>(content: readonly T[]): readonly T[];
+export declare function withSectionGroup<T extends Node>(content: readonly T[], group: T): readonly T[];
+export {};

package/dist/lib/puck/section-groups.js

@@ -0,0 +1 @@
+const n="SiteHeader",s="SiteFooter",i="sections",S=[n,s],E=e=>e===n||e===s,f=e=>`${e}:${i}`;function T(e,t,r=[]){return{type:e,props:{id:t,[i]:r}}}const c=new Set(["Footer",n,s]);function a(e){const t=new Set;let r=!1;const p=e.filter(u=>{const o=u?.type??"";return o==="Header"?(r=!0,!1):c.has(o)?t.has(o)?(r=!0,!1):(t.add(o),!0):!0});return r?p:e}function x(e,t){return e.some(r=>r?.type===t.type)?e:t.type===n?[t,...e]:[...e,t]}export{i as SECTION_GROUP_SLOT,S as SECTION_GROUP_TYPES,s as SITE_FOOTER_TYPE,n as SITE_HEADER_TYPE,T as buildSectionGroup,E as isSectionGroupType,f as sectionGroupZone,a as siteFooterDocChrome,x as withSectionGroup};

package/dist/lib/puck/section-text-suppress.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from "react";
+export declare function SectionTextSuppressProvider({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useSectionTextSuppressed(): boolean;
+export declare function SuppressibleText({ name, children }: {
+    name?: string;
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/lib/puck/section-text-suppress.js

@@ -0,0 +1 @@
+"use client";import{jsx as r,Fragment as s}from"react/jsx-runtime";import{createContext as n,useContext as p}from"react";import{isStructuralTextProp as u}from"./neutralization-contracts.js";import{NoControlMark as i}from"./panel-no-control-mark.js";const t=n(!1);function l({children:e}){return r(t.Provider,{value:!0,children:e})}function c(){return p(t)}function S({name:e,children:o}){return!c()||!e||u(e)?r(s,{children:o}):r(i,{})}export{l as SectionTextSuppressProvider,S as SuppressibleText,c as useSectionTextSuppressed};

package/dist/lib/puck/site-gap-fields.d.ts

@@ -0,0 +1,2 @@
+import type { Config } from "efficient-easel/blocks";
+export declare function withSiteBlockGapFields(config: Config, siteGap: number | null): Config;

package/dist/lib/puck/site-gap-fields.js

@@ -0,0 +1 @@
+import{GAP_FIELD_CONTAINER as u}from"../content/container-gap.js";function f(t){return!!t&&typeof t=="object"&&typeof t[u]=="string"}function p(t,c){if(!t)return t;let e=null;for(const[o,n]of Object.entries(t))f(n)&&(e??={...t},e[o]={...n,siteGap:c});return e??t}function a(t,c){const e=t;let o=!1;const n={};for(const[s,r]of Object.entries(e.components)){const i=p(r.fields,c);if(i===r.fields){n[s]=r;continue}o=!0,n[s]={...r,fields:i}}return o?{...t,components:n}:t}export{a as withSiteBlockGapFields};

package/dist/lib/puck/slider-typing.d.ts

@@ -0,0 +1,9 @@
+export type TypedNumberOutcome = {
+    handled: boolean;
+    editing: boolean;
+    commit: number | null;
+};
+export declare const TYPED_NUMBER_COMMIT = "Enter";
+export declare const TYPED_NUMBER_CANCEL = "Escape";
+export declare function typedNumberValue(text: string, min: number, max: number, step: number): number | null;
+export declare function typedNumberKey(key: string, draft: string, min: number, max: number, step: number): TypedNumberOutcome;

package/dist/lib/puck/slider-typing.js

@@ -0,0 +1 @@
+const l="Enter",c="Escape",s=/^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/,m=/(px|%)$/i;function p(n,e,r,t){const u=n.trim().replace(/\s+/g,"").replace(m,"");if(!s.test(u))return null;const i=Number(u);if(!Number.isFinite(i))return null;const a=Math.min(r,Math.max(e,i));if(!(t>0))return a;const d=e+Math.round((a-e)/t)*t,o=Math.min(r,Math.max(e,d));return Number(o.toFixed(4))}function f(n,e,r,t,u){return n===l?{handled:!0,editing:!1,commit:p(e,r,t,u)}:n===c?{handled:!0,editing:!1,commit:null}:{handled:!1,editing:!0,commit:null}}export{c as TYPED_NUMBER_CANCEL,l as TYPED_NUMBER_COMMIT,f as typedNumberKey,p as typedNumberValue};

package/dist/lib/puck/slot-child-name.d.ts

@@ -0,0 +1,8 @@
+export type SlotChild = {
+    type: string;
+    props: Record<string, unknown>;
+};
+export declare function slotChildName(child: SlotChild, wheelName?: (code: string) => string | undefined): string;
+export declare function slotChildRowName(child: SlotChild, compLabel: (type: string) => string, wheelName?: (code: string) => string | undefined): string;
+export declare function slotChildRenameProp(fields: Record<string, unknown> | undefined): "name" | "altName" | null;
+export declare function rootRowName(node: SlotChild, fallback: string): string;

package/dist/lib/puck/slot-child-name.js

@@ -0,0 +1 @@
+import{stripMarkup as s}from"../markup.js";import{hidableText as n,textFieldIdentifier as a}from"./controls.js";function m(t,r){const o=n(t.props.name);if(o)return o;const p=n(t.props.altName);if(p)return p;const i=t.props.collection?.name;if(i)return i;const u=t.props.source?.title;if(u)return u;const e=t.props.code;return e?r?.(e)??e:""}function c(t,r,o){return s(m(t,o))||r(t.type)}function x(t){if(!t)return null;for(const r of["name","altName"])if(a(t[r]))return r;return null}function N(t,r){return n(t.props?.name).trim()||r}export{N as rootRowName,m as slotChildName,x as slotChildRenameProp,c as slotChildRowName};

package/dist/lib/puck/slot-heal.d.ts

@@ -0,0 +1,2 @@
+import type { TreeItem } from "./content-tree.js";
+export declare function dedupeSlotChildren(item: TreeItem, slots: string[]): TreeItem["props"] | null;

package/dist/lib/puck/slot-heal.js

@@ -0,0 +1 @@
+function u(r,l){let t=!1;const o={...r.props};for(const e of l){const s=Array.isArray(r.props[e])?r.props[e]:[],p=new Set,d=s.filter(c=>{const n=c?.props?.id;return!n||p.has(n)?!1:(p.add(n),!0)});d.length!==s.length&&(o[e]=d,t=!0)}return t?o:null}export{u as dedupeSlotChildren};

package/dist/lib/puck/slot-specs.d.ts

@@ -0,0 +1,20 @@
+import { type TreeItem } from "./content-tree.js";
+export type NodeDefaults = (type: string) => Record<string, unknown>;
+export interface SlotSectionSpec {
+    slot: string;
+    childType: string;
+    addLabel: string;
+    fixed?: boolean;
+    slider?: boolean;
+    seeds: (defaultsFor?: NodeDefaults) => Record<string, unknown>[];
+    legacy?: (props: Record<string, unknown>) => Record<string, unknown>[];
+    addBlocked?: (children: readonly unknown[], incoming?: unknown) => string | null;
+    skipSeed?: (props: Record<string, unknown>) => boolean;
+    notice?: (children: readonly unknown[]) => string | null;
+}
+export declare const SLOT_SECTION_SPECS: Record<string, SlotSectionSpec>;
+export declare function registerSlotSectionSpecs(specs: Record<string, SlotSectionSpec>): void;
+export declare function buildSlotSeedChildren(type: string, defaultsFor?: NodeDefaults): {
+    slot: string;
+    children: TreeItem[];
+} | null;

package/dist/lib/puck/slot-specs.js

@@ -0,0 +1 @@
+import{HERO_SLIDE_SEEDS as a}from"../../components/HeroSlide.js";import{heroGroupAddBlocked as l,heroGroupOverCapNotice as c}from"../hero-group-placement.js";import{newNodeId as p}from"./content-tree.js";import{BOX_TYPE as t,CONTAINER_BLOCKS_SLOT as n}from"./container-blocks.js";import{BOX_LABEL as i}from"./section-catalog.js";const m="ImageBlock",E=3,d=(e,r,o={})=>({type:e,props:{...r?.(e)??{},id:p(e),...o}}),T=e=>({...e?.(t)??{},direction:"column",[n]:[d(m,e),d(t,e,{direction:"column",[n]:[d("Heading",e),d("Text",e)]})]}),s={Hero:{slot:"slides",childType:"HeroSlide",addLabel:"Add slide",slider:!0,seeds:()=>a.map(e=>({...e}))},HeroSlide:{slot:"groups",childType:"HeroGroup",addLabel:`Add ${i.toLowerCase()}`,seeds:()=>[],addBlocked:l,notice:c},HeroSingle:{slot:"boxes",childType:"HeroGroup",addLabel:`Add ${i.toLowerCase()}`,seeds:()=>[],addBlocked:l,notice:c},ProcessSteps:{slot:"boxes",childType:t,addLabel:`Add ${i.toLowerCase()}`,seeds:e=>Array.from({length:E},()=>T(e)),skipSeed:e=>Array.isArray(e.steps)&&e.steps.length>0}};function u(e){for(const[r,o]of Object.entries(e)){if(r in s&&s[r]!==o)throw new Error(`lib/puck/slot-specs: "${r}" already has a slot spec`);s[r]=o}}function A(e,r){const o=s[e];return o?{slot:o.slot,children:o.seeds(r).map(S=>({type:o.childType,props:{id:p(o.childType),...S}}))}:null}export{s as SLOT_SECTION_SPECS,A as buildSlotSeedChildren,u as registerSlotSectionSpecs};

package/dist/lib/puck/snapshot-contracts.d.ts

@@ -0,0 +1,4 @@
+export declare const SNAPSHOT_OBJECTS: Record<string, Record<string, {
+    keep: string[];
+}>>;
+export declare const HYDRATED_LISTS: Record<string, string[]>;

package/dist/lib/puck/snapshot-contracts.js

@@ -0,0 +1 @@
+const e={ProductGrid:{source:{keep:["slug"]}},GalleryItem:{product:{keep:["code","finish"]}},FeaturedCover:{source:{keep:["slug"]}},LongRead:{source:{keep:["slug"]}}},s={Events:["posts"],SubscribeBlogs:["posts"]};export{s as HYDRATED_LISTS,e as SNAPSHOT_OBJECTS};

package/dist/lib/puck/source-bound-parts.d.ts

@@ -0,0 +1,12 @@
+export type PartSource = "product" | "blog" | "menu";
+export declare function sourceBoundBlocks(): string[];
+export declare function hydratedPropsOf(block: string): string[];
+export declare const PART_SOURCES: Record<string, PartSource>;
+export declare const SOURCE_LINES: Record<PartSource, string>;
+export declare const SOURCE_ACTION_LABEL = "Open";
+export declare const SOURCE_ACTIONS: Record<PartSource, {
+    type: "storefront-editor:open-product" | "storefront-editor:open-post" | "storefront-editor:open-menus";
+    needsSlug: boolean;
+}>;
+export declare function sourceSlugOf(props: unknown): string | undefined;
+export declare function partSourceOf(nodeType: string): PartSource | null;

package/dist/lib/puck/source-bound-parts.js

@@ -0,0 +1 @@
+import{CUSTOM_FIELD_VALUES as n}from"./neutralization-contracts.js";import{HYDRATED_LISTS as s,SNAPSHOT_OBJECTS as u}from"./snapshot-contracts.js";function l(){const e=new Set([...Object.keys(u),...Object.keys(s)]);for(const[t,o]of Object.entries(n))for(const r of Object.values(o))r.verb==="snapshot"&&e.add(t);return[...e].sort()}function f(e){const t=new Set([...Object.keys(u[e]??{}),...s[e]??[]]);for(const[o,r]of Object.entries(n[e]??{}))r.verb==="snapshot"&&t.add(o);return[...t].sort()}const c={CollectionCard:"product",FooterMenu:"menu",Gallery:"product",GalleryItem:"product",ProductGrid:"product",ProductHero:"product",SpecTable:"product",Events:"blog",FeaturedCover:"blog",LongRead:"blog",SubscribeBlogs:"blog"},S={product:"Synced from the product.",blog:"Synced from the blog post.",menu:"Synced from the site menu."},i="Open",O={product:{type:"storefront-editor:open-product",needsSlug:!0},blog:{type:"storefront-editor:open-post",needsSlug:!0},menu:{type:"storefront-editor:open-menus",needsSlug:!1}};function b(e){const o=e?.source?.slug;return typeof o=="string"&&o.length>0?o:void 0}function g(e){return c[e]??null}export{c as PART_SOURCES,O as SOURCE_ACTIONS,i as SOURCE_ACTION_LABEL,S as SOURCE_LINES,f as hydratedPropsOf,g as partSourceOf,l as sourceBoundBlocks,b as sourceSlugOf};

package/dist/lib/puck/style-clipboard.d.ts

@@ -0,0 +1,19 @@
+import { type StyleRow } from "efficient-easel/style-clipboard";
+import { panelFieldsOf } from "./panel-fields.js";
+type Props = Record<string, unknown>;
+type NodeLike = {
+    type: string;
+    props: Props;
+};
+type ConfigLike = Parameters<typeof panelFieldsOf>[0];
+export declare function siteStyleScope(siteId: string | null | undefined): string;
+export declare function shopFieldKind(field: unknown): string | null;
+export declare function nodeStyleRows(config: ConfigLike, node: NodeLike): StyleRow[];
+export declare function copyNodeStyle(config: ConfigLike, scope: string, node: NodeLike, label: string): void;
+export declare function planNodePaste(config: ConfigLike, scope: string, node: NodeLike, label: string): {
+    props: Props;
+    changed: boolean;
+    pasted: number;
+    message: string;
+} | null;
+export {};

package/dist/lib/puck/style-clipboard.js

@@ -0,0 +1 @@
+import{fieldKind as l,STYLE_KIND as p,copyStyle as f,heldStyle as y,pasteMessage as E,planPaste as S}from"efficient-easel/style-clipboard";import{anchorFields as m,foldMetaOf as _,LINK_FIELD_MARKER as h,MEDIA_FIELD_MARKER as K,TEXT_FIELD_MARKER as R}from"./controls.js";import{deviceMetaOf as A,withoutDeviceGate as a}from"./device-fields.js";import{BUCKET_KEY as c}from"./field-groups.js";import{panelFieldsOf as L}from"./panel-fields.js";const O=new Set([c.Style,c.Layout]),w=new Set(Object.values(c)),d=new Set(Object.keys(m())),D=new Set(["focal","imageFocal"]),M=[K,R,h];function v(t){return`site:${t??""}`}function b(t){if(!t||typeof t!="object")return null;const n=t,e=a(t)??t,o=n[p]??e[p];if(typeof o=="string")return o;const r=n.options??e.options;return Array.isArray(r)?`choice:${r.map(i=>String(i?.value)).sort().join("|")}`:l(e)}function F(t){const n=t,e=a(t);return M.some(o=>o in n||e&&o in e)}function u(t,n){const e=L(t,n)??{},o=[];let r=!1;for(const[s,i]of Object.entries(e)){if(w.has(s)){r=O.has(s);continue}!r||!i||typeof i!="object"||s.startsWith("_")||_(i)||d.has(s)||D.has(s)||F(i)||i.type!=="slot"&&o.push({path:[s],kind:b(i),counted:A(i)?.tier!=="mobile"})}return o}function x(t,n,e,o){f({scope:n,type:e.type,label:o,rows:u(t,e),props:e.props})}function C(t,n,e,o){const r=y(n);if(!r)return null;const s=S(r,{type:e.type,rows:u(t,e),props:e.props});return{...s,message:E(s,r.sourceLabel,o)}}export{x as copyNodeStyle,u as nodeStyleRows,C as planNodePaste,b as shopFieldKind,v as siteStyleScope};

package/dist/lib/puck/templateFields.d.ts

@@ -0,0 +1,2 @@
+import type { Config } from "efficient-easel/blocks";
+export declare function withTemplateMediaPlaceholders(config: Config, placeholderFrames: boolean): Config;

package/dist/lib/puck/templateFields.js

@@ -0,0 +1 @@
+import c from"./media-manifest.json";const p=c.mediaFields,u=c.snapshotObjects,y=c.hydratedLists;function h(r){return typeof r=="string"?"":Array.isArray(r)?[]:r&&typeof r=="object"?null:r}function a(r,o){if(o.length===0)return h(r);const[n,...e]=o,t=n.endsWith("[]"),s=t?n.slice(0,-2):n;if(!r||typeof r!="object"||Array.isArray(r))return r;const i=r;if(!(s in i))return r;const f=i[s];return t?Array.isArray(f)?{...i,[s]:f.map(A=>a(A,e.length?e:[]))}:r:{...i,[s]:a(f,e)}}function d(r,o){if(Array.isArray(r))return r.map(t=>d(t,o));if(!r||typeof r!="object")return r;const n=r,e={};for(const t of o)t in n&&(e[t]=n[t]);return e}function m(r,o){let n=o;for(const t of p[r]??[])n=a(n,t.split("."));const e=u[r];if(e)for(const[t,s]of Object.entries(e))t in n&&(n={...n,[t]:d(n[t],s.keep)});for(const t of y[r]??[])Array.isArray(n[t])&&(n={...n,[t]:[]});return n}function b(r,o){return typeof o!="function"?o:n=>o(m(r,n))}function S(r,o){if(!o)return r;const n=r,e={};for(const[t,s]of Object.entries(n.components)){const i=(p[t]?.length??0)>0||u[t]||y[t];e[t]=i&&s.render?{...s,render:b(t,s.render)}:s}return{...n,components:e}}export{S as withTemplateMediaPlaceholders};

package/dist/lib/puck/text-control-kinds.d.ts

@@ -0,0 +1,13 @@
+export declare const TEXT_CONTROL_KINDS: {
+    readonly text: "scalar";
+    readonly textarea: "scalar";
+    readonly plainText: "scalar";
+    readonly copyText: "scalar";
+    readonly plainTextarea: "scalar";
+    readonly textList: "list";
+};
+export type TextControlKind = keyof typeof TEXT_CONTROL_KINDS;
+export type ScalarTextControlKind = {
+    [K in TextControlKind]: (typeof TEXT_CONTROL_KINDS)[K] extends "scalar" ? K : never;
+}[TextControlKind];
+export declare const SCALAR_TEXT_CONTROLS: readonly ScalarTextControlKind[];

package/dist/lib/puck/text-control-kinds.js

@@ -0,0 +1 @@
+const t={text:"scalar",textarea:"scalar",plainText:"scalar",copyText:"scalar",plainTextarea:"scalar",textList:"list"},e=Object.entries(t).filter(([,a])=>a==="scalar").map(([a])=>a);export{e as SCALAR_TEXT_CONTROLS,t as TEXT_CONTROL_KINDS};

package/dist/lib/puck/text-parts.d.ts

@@ -0,0 +1,33 @@
+import { type TextFieldMeta } from "./field-markers.js";
+import { type PartRow } from "./part-rows.js";
+export declare const PART_ATTR = "data-sf-part";
+export declare const PART_SELECTED_ATTR = "data-sf-part-selected";
+export declare const PART_KIND_ATTR = "data-sf-part-kind";
+export type PartNeedle = {
+    key: string;
+    label: string;
+    texts: string[];
+    row?: PartRow;
+};
+export declare function encodePartId(nodeId: string, propKey: string | null): string;
+export declare function decodePartId(partId: string): {
+    nodeId: string;
+    propKey: string | null;
+} | null;
+export declare function partOpenOn(selectedPartId: string | null, nodeId: string): boolean;
+export declare function normalizePartText(value: string): string;
+export declare function holdsAuthoredText(field: unknown): boolean;
+export declare function partLabel(field: Record<string, unknown>, key: string): string;
+export declare function partHeadLabel(label: string): string;
+export declare function partNeedles(fields: Record<string, unknown> | undefined, props: Record<string, unknown> | undefined): PartNeedle[];
+export type SectionTextPart = {
+    key: string;
+    label: string;
+    preview: string;
+    offPage: boolean;
+    identifier: boolean;
+    hidden: boolean;
+};
+export declare function entryPartMetaOf(key: string, field: unknown): TextFieldMeta | null;
+export declare function fieldDrawsEntryRow(key: string, field: unknown): boolean;
+export declare function sectionTextParts(fields: Record<string, unknown> | undefined, props: Record<string, unknown> | undefined): SectionTextPart[];

package/dist/lib/puck/text-parts.js

@@ -0,0 +1 @@
+import{stripMarkup as y}from"../markup.js";import{LINK_FIELD_MARKER as h,SCAFFOLD_FIELD_MARKER as R,TEXT_FIELD_MARKER as u}from"./field-markers.js";import{readHidable as b}from"./hidable.js";import{SCALAR_TEXT_CONTROLS as P}from"./text-control-kinds.js";import{isStructuralTextProp as A}from"./neutralization-contracts.js";import{partRowTexts as g}from"./part-rows.js";const C="data-sf-part",k="data-sf-part-selected",z="data-sf-part-kind",T="::",_=2;function X(t,e){return`${t}${T}${e??""}`}function L(t){const e=t.indexOf(T);return e<=0?null:{nodeId:t.slice(0,e),propKey:t.slice(e+T.length)||null}}function $(t,e){if(!t)return!1;const r=L(t);return!!r?.propKey&&r.nodeId===e}function E(t){return y(t).replace(/\s+/gu,"")}function l(t,e,r){const n=t[u];if(n){if(n.control==="textList"){const o=n.itemKey??"text";if(!Array.isArray(e))return;for(const c of e){const i=c?.[o];typeof i=="string"&&r.push(i)}return}const{text:s}=b(e);s?r.push(s):n.placeholder&&r.push(n.placeholder);return}if(!t[h]){if(t.type==="text"||t.type==="textarea"){typeof e=="string"&&e&&r.push(e);return}if(t.arrayFields&&Array.isArray(e)){for(const s of e)for(const[o,c]of Object.entries(t.arrayFields))l(c,s?.[o],r);return}if(t.objectFields&&e&&typeof e=="object")for(const[s,o]of Object.entries(t.objectFields))l(o,e[s],r)}}function H(t){if(!t||typeof t!="object")return!1;const e=t;return e[h]?!1:!!e[u]||e.type==="text"||e.type==="textarea"}function O(t,e){const r=t[u];return r?.label?r.label:typeof t.label=="string"?t.label:e}function j(t){const e=t.indexOf(" (");return(e>0?t.slice(0,e):t).trim()}function B(t,e){if(!t)return[];const r=[];for(const[n,s]of Object.entries(t)){if(!s||typeof s!="object"||A(n))continue;const o=s,c=[];l(o,e?.[n],c),!c.length&&o[R]!==void 0&&l(o,o[R],c);const i=O(o,n),a=new Set;for(const{row:d,text:f}of g(o,e?.[n])){const m=E(f);m.length<_||(a.add(m),r.push({key:n,label:i,texts:[m],row:d}))}const p=new Set(a),x=[];for(const d of c){const f=E(d);f.length<_||p.has(f)||(p.add(f),x.push(f))}x.length&&r.push({key:n,label:i,texts:x})}return r}const F=P;function w(t,e){if(!e||typeof e!="object"||A(t))return null;const r=e[u];return!r||!F.includes(r.control)?null:r}function Y(t,e){const r=w(t,e);return r!==null&&r.identifier!==!0}function q(t,e){if(!t)return[];const r=[];for(const[n,s]of Object.entries(t)){const o=w(n,s);if(!o)continue;const{text:c,hidden:i}=b(e?.[n]),a=c||o.placeholder||"",p=y(a).replace(/\s+/gu," ").trim();r.push({key:n,label:j(O(s,n)),preview:p,offPage:o.offPage===!0,identifier:o.identifier===!0,hidden:!!i})}return r}export{C as PART_ATTR,z as PART_KIND_ATTR,k as PART_SELECTED_ATTR,L as decodePartId,X as encodePartId,w as entryPartMetaOf,Y as fieldDrawsEntryRow,H as holdsAuthoredText,E as normalizePartText,j as partHeadLabel,O as partLabel,B as partNeedles,$ as partOpenOn,q as sectionTextParts};

package/dist/lib/puck/theme-swatches.d.ts

@@ -0,0 +1,3 @@
+import type { ThemeColour } from "efficient-easel/pick";
+import { type ThemeValue } from "../theme.js";
+export declare function themeSwatches(value?: ThemeValue | null): ThemeColour[];

package/dist/lib/puck/theme-swatches.js

@@ -0,0 +1 @@
+import{typedHex as f}from"efficient-easel/pick";import{normalizeTheme as h}from"../theme.js";function l(a){const n=new Set,r=[];return h(a).themes.forEach((o,t)=>{const m=[[`Theme ${t+1} main color`,o.accent],[`Theme ${t+1} text color`,o.text],[`Theme ${t+1} background`,o.background]];for(const[s,c]of m){const e=c?f(c):null;!e||n.has(e)||(n.add(e),r.push({name:s,value:e}))}}),r}export{l as themeSwatches};

package/dist/lib/puck/tree-reveal.d.ts

@@ -0,0 +1,11 @@
+type Selector = {
+    index: number;
+    zone?: string;
+} | null;
+export declare function sameSelector(a: Selector, b: Selector, rootZone: string): boolean;
+export declare function revealSelectedTreeRow(doc?: Document | undefined): boolean;
+export declare function markedTreeNodeId(mode: {
+    kind: string;
+    nodeId?: string;
+}, selectedId: string | null | undefined): string | null;
+export {};

package/dist/lib/puck/tree-reveal.js

@@ -0,0 +1 @@
+const o=".es-tree",i=".es-tree-row.is-selected";function l(e,n,t){return!e||!n?!1:e.index===n.index&&(e.zone??t)===(n.zone??t)}function u(e,n){if(typeof e.getBoundingClientRect!="function"||typeof n.getBoundingClientRect!="function")return!1;const t=e.getBoundingClientRect(),r=n.getBoundingClientRect();return!t.height||!r.height?!1:r.top>=t.top&&r.bottom<=t.bottom}function c(e=typeof document>"u"?void 0:document){const n=e?.querySelector(o),t=n?.querySelector(i);return t?(u(n,t)||t.scrollIntoView({block:"center",inline:"nearest"}),!0):!1}function f(e,n){return e.kind==="part"?e.nodeId??null:e.kind!=="puck"||n==null?null:String(n)}export{f as markedTreeNodeId,c as revealSelectedTreeRow,l as sameSelector};

package/dist/lib/puck/use-section-ops.d.ts

@@ -0,0 +1,25 @@
+import type { Data } from "efficient-easel/blocks";
+import { type TreeItem } from "./content-tree.js";
+export type NodeSelector = {
+    index: number;
+    zone?: string;
+} | null;
+type ComponentData = TreeItem;
+export type SectionOps = {
+    insertComponent: (zone: string, type: string, index: number) => string;
+    insertSection: (type: string, index: number) => string;
+    replaceComponent: (zone: string, index: number, data: ComponentData) => void;
+    seedChild: (zone: string, index: number, childType: string, props: Record<string, unknown>) => void;
+    insertNode: (zone: string, index: number, node: TreeItem) => string;
+    removeComponent: (zone: string, index: number) => void;
+    reorderComponent: (zone: string, sourceIndex: number, destinationIndex: number) => void;
+    duplicateComponent: (zone: string, index: number) => void;
+    select: (selector: NodeSelector) => void;
+    setDocument: (data: Data) => void;
+    commitDocument: (data: Data) => void;
+};
+export type SectionOpsOptions = {
+    readOnly?: boolean;
+};
+export declare function useSectionOps(options?: SectionOpsOptions): SectionOps;
+export {};

package/dist/lib/puck/use-section-ops.js

@@ -0,0 +1 @@
+"use client";import{useMemo as d}from"react";import{useEasel as m}from"efficient-easel/easel";import{ROOT_ZONE as a,newNodeId as y}from"./content-tree.js";function O(u={}){const{dispatch:n}=m(s=>s),o=u.readOnly===!0;return d(()=>{const s=(e,t,r)=>{const i=y(t);return o||n({type:"insert",componentType:t,destinationZone:e,destinationIndex:r,id:i}),i},p=(e,t,r)=>{o||n({type:"replace",destinationZone:e,destinationIndex:t,data:r})};return{insertComponent:s,insertSection:(e,t)=>s(a,e,t),replaceComponent:p,seedChild:(e,t,r,i)=>{const c=s(e,r,t);p(e,t,{type:r,props:{id:c,...i}})},insertNode:(e,t,r)=>{const i=s(e,r.type,t);return p(e,t,{type:r.type,props:{...r.props,id:i}}),i},removeComponent:(e,t)=>{o||n({type:"remove",index:t,zone:e})},reorderComponent:(e,t,r)=>{o||n({type:"reorder",sourceIndex:t,destinationIndex:r,destinationZone:e})},duplicateComponent:(e,t)=>{o||n({type:"duplicate",sourceIndex:t,sourceZone:e})},select:e=>n({type:"setUi",ui:{itemSelector:e}}),setDocument:e=>{o||n({type:"setData",data:e})},commitDocument:e=>{o||n({type:"setData",data:()=>e,recordHistory:!0})}}},[n,o])}export{O as useSectionOps};

package/dist/lib/reel.d.ts

@@ -0,0 +1,33 @@
+import { type HeroGroupPlacement } from "./hero-group-placement.js";
+export declare const REEL_PLACEMENTS: readonly ["top-left", "top-center", "top-right", "left", "center", "right", "bottom-left", "bottom-center", "bottom-right"];
+export type ReelPlacement = HeroGroupPlacement;
+export declare const REEL_PLACEMENT_LABELS: Readonly<Record<"left" | "right" | "top-left" | "top-center" | "top-right" | "center" | "bottom-left" | "bottom-center" | "bottom-right", string>>;
+export declare const REEL_PLACEMENT_DEFAULT: ReelPlacement;
+export declare const REEL_SHAPES: readonly ["cards", "dots", "numbers", "bar", "tabs"];
+export type ReelShape = (typeof REEL_SHAPES)[number];
+export declare const HERO_REEL_SHAPES: readonly ["cards", "dots", "numbers", "bar"];
+export type HeroReelShape = (typeof HERO_REEL_SHAPES)[number];
+export declare const REEL_SHAPE_DEFAULT: HeroReelShape;
+export declare const REEL_SHAPE_LABELS: Readonly<Record<ReelShape, string>>;
+export declare const REEL_SHOWN_DEFAULT = true;
+export declare function normaliseReelShape(value: unknown): ReelShape;
+export declare function normaliseHeroReelShape(value: unknown): HeroReelShape;
+export declare function normaliseReelPlacement(value: unknown): ReelPlacement;
+export declare function reelRailClass(shape: unknown, placement: unknown): string;
+export declare function reelSurfaceRailClass(shape: unknown): string;
+export declare function reelShown(o: {
+    shown?: unknown;
+    count?: number;
+}): boolean;
+export type ReelItem = {
+    name: string;
+    process: string;
+    video: boolean;
+};
+export type ReelSlideSource = {
+    dataset: {
+        [key: string]: string | undefined;
+    };
+};
+export declare function sameReel(a: readonly ReelItem[], b: readonly ReelItem[]): boolean;
+export declare function nextReel(prev: readonly ReelItem[], slides: Iterable<ReelSlideSource>): ReelItem[];

package/dist/lib/reel.js

@@ -0,0 +1 @@
+import{HERO_GROUP_PLACEMENTS as E,HERO_GROUP_PLACEMENT_LABELS as c}from"./hero-group-placement.js";import{heroOverlayRailClass as l}from"./hero-overlay-anchor.js";const u=E,_=c,i="top-right",d=["cards","dots","numbers","bar","tabs"],p=["cards","dots","numbers","bar"],s="cards",A={cards:"Cards",dots:"Dots",numbers:"Numbers",bar:"Bar",tabs:"Tabs"},S=!0;function n(e){return d.includes(e)?e:s}function P(e){return p.includes(e)?e:s}function f(e){return u.includes(e)?e:i}const a={cards:"flex-col gap-2.5",dots:"flex-row items-center gap-2",numbers:"flex-col gap-2",bar:"h-0.5 w-[34%] max-w-[420px] gap-px overflow-hidden rounded-full",tabs:"flex-row items-stretch w-full overflow-x-auto"};function h(e,r){return l(f(r),a[n(e)])}function H(e){return`flex ${a[n(e)]}`}function b(e){return e.shown!==!1&&(e.count??0)>1}function x(e){return{name:e.dataset.slideName||"",process:e.dataset.slideProcess||"",video:e.dataset.slideMedia==="video"}}function m(e,r){return e===r?!0:e.length!==r.length?!1:e.every((t,o)=>t.name===r[o].name&&t.process===r[o].process&&t.video===r[o].video)}function w(e,r){const t=Array.from(r,x);return m(e,t)?e:t}export{p as HERO_REEL_SHAPES,u as REEL_PLACEMENTS,i as REEL_PLACEMENT_DEFAULT,_ as REEL_PLACEMENT_LABELS,d as REEL_SHAPES,s as REEL_SHAPE_DEFAULT,A as REEL_SHAPE_LABELS,S as REEL_SHOWN_DEFAULT,w as nextReel,P as normaliseHeroReelShape,f as normaliseReelPlacement,n as normaliseReelShape,h as reelRailClass,b as reelShown,H as reelSurfaceRailClass,m as sameReel};

package/dist/lib/safe-storage.d.ts

@@ -0,0 +1,10 @@
+export interface StorageLike {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+export declare function createSafeStorage(getStorage: () => StorageLike | null): StorageLike;
+export declare function canPersist(storage: StorageLike): boolean;
+export declare const safeLocalStorage: StorageLike;
+export declare const safeSessionStorage: StorageLike;
+export declare function safeLocalStorageFor(doc: Document): StorageLike;

package/dist/lib/safe-storage.js

@@ -0,0 +1 @@
+function n(e){return{getItem(t){try{return e()?.getItem(t)??null}catch{return null}},setItem(t,r){try{e()?.setItem(t,r)}catch{}},removeItem(t){try{e()?.removeItem(t)}catch{}}}}const o="__storefront_probe__";function c(e){try{e.setItem(o,o);const t=e.getItem(o)===o;return e.removeItem(o),t}catch{return!1}}const a=n(()=>typeof window>"u"?null:window.localStorage),l=n(()=>typeof window>"u"?null:window.sessionStorage);function s(e){return n(()=>e.defaultView?.localStorage??null)}export{c as canPersist,n as createSafeStorage,a as safeLocalStorage,s as safeLocalStorageFor,l as safeSessionStorage};

package/dist/lib/save-as-template-action.d.ts

@@ -0,0 +1,29 @@
+export type SaveAsTemplateHidden = "no-console" | "not-operator" | "not-a-site-page" | "no-site";
+export type SaveAsTemplateAction = {
+    visible: false;
+    hiddenReason: SaveAsTemplateHidden;
+} | {
+    visible: true;
+    enabled: true;
+} | {
+    visible: true;
+    enabled: false;
+    disabledReason: string;
+};
+export declare const UNSAVED_REASON = "Save your page changes first";
+export declare function resolveSaveAsTemplateAction(input: {
+    hasTrustedConsole: boolean;
+    canCreatePlatformTemplate: boolean;
+    capabilities: {
+        canPublish: boolean;
+        hasSiteSettings: boolean;
+    };
+    siteId: string | null | undefined;
+    hasUnsavedEdits: boolean;
+}): SaveAsTemplateAction;
+export declare const SAVE_AS_TEMPLATE_EVENT: "storefront-editor:save-as-template";
+export type SaveAsTemplateRequest = {
+    type: typeof SAVE_AS_TEMPLATE_EVENT;
+    siteId: string;
+    slug: string;
+};

package/dist/lib/save-as-template-action.js

@@ -0,0 +1 @@
+const s="Save your page changes first";function a(e){return e.hasTrustedConsole?e.canCreatePlatformTemplate?!e.capabilities.canPublish||!e.capabilities.hasSiteSettings?{visible:!1,hiddenReason:"not-a-site-page"}:e.siteId?e.hasUnsavedEdits?{visible:!0,enabled:!1,disabledReason:s}:{visible:!0,enabled:!0}:{visible:!1,hiddenReason:"no-site"}:{visible:!1,hiddenReason:"not-operator"}:{visible:!1,hiddenReason:"no-console"}}const i="storefront-editor:save-as-template";export{i as SAVE_AS_TEMPLATE_EVENT,s as UNSAVED_REASON,a as resolveSaveAsTemplateAction};

package/dist/lib/section-template-types.d.ts

@@ -0,0 +1,21 @@
+import type { TreeItem } from "./puck/content-tree.js";
+export interface SectionTemplateRecord {
+    id: string;
+    name: string;
+    component_type: string;
+    node: TreeItem | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface SectionTemplate extends SectionTemplateRecord {
+    node: TreeItem;
+}
+export interface SectionTemplateStore {
+    list(): Promise<SectionTemplate[]>;
+    get(id: string): Promise<SectionTemplateRecord | null>;
+    ensure(id: string, name: string, node: TreeItem): Promise<SectionTemplate>;
+    save(name: string, node: TreeItem): Promise<SectionTemplate>;
+    update(id: string, node: TreeItem): Promise<SectionTemplate>;
+    rename(id: string, name: string): Promise<SectionTemplateRecord>;
+    remove(id: string): Promise<void>;
+}

package/dist/lib/sections/card-cover-index.d.ts

@@ -0,0 +1,7 @@
+export declare const COVER_INDEX_MIN = 1;
+export declare const COVER_INDEX_MAX = 5;
+export declare const DEFAULT_COVER_INDEX = 1;
+export declare const COVER_INDEX_OPTIONS: readonly {
+    value: string;
+    label: string;
+}[];

package/dist/lib/sections/card-cover-index.js

@@ -0,0 +1 @@
+const e=1,l=5,n=1,r=[{value:"1",label:"1st rendering"},{value:"2",label:"2nd rendering"},{value:"3",label:"3rd rendering"},{value:"4",label:"4th rendering"},{value:"5",label:"5th rendering"}];export{l as COVER_INDEX_MAX,e as COVER_INDEX_MIN,r as COVER_INDEX_OPTIONS,n as DEFAULT_COVER_INDEX};

package/dist/lib/sections/collection-card-text-regions.d.ts

@@ -0,0 +1,4 @@
+import type { TextRegions } from "./text-regions.js";
+export type CollectionCardRegionKey = "tag" | "name" | "body" | "price" | "link";
+export declare const COLLECTION_CARD_REGIONS: Readonly<Record<CollectionCardRegionKey, TextRegions[string]>>;
+export declare const COLLECTION_CARD_TEXT_REGIONS: TextRegions;

package/dist/lib/sections/collection-card-text-regions.js

@@ -0,0 +1 @@
+const l={tag:{label:"Tag",follows:"Labels",builtIn:"13px",writable:!0},name:{label:"Name",follows:"Heading 2",builtIn:"48px",writable:!0},body:{label:"Body",follows:"Body",builtIn:"14px",writable:!0},price:{label:"Price",follows:"Labels",builtIn:"15px",writable:!0},link:{label:"Link",follows:"Labels",builtIn:"14px",writable:!0}},e=l;export{l as COLLECTION_CARD_REGIONS,e as COLLECTION_CARD_TEXT_REGIONS};

package/dist/lib/sections/divider-style.d.ts

@@ -0,0 +1,12 @@
+export type DividerStyle = "line" | "stripes-fine" | "stripes-medium" | "stripes-bold";
+export declare const DEFAULT_DIVIDER_STYLE: DividerStyle;
+export declare const DIVIDER_STYLE_OPTIONS: readonly {
+    label: string;
+    value: DividerStyle;
+}[];
+export declare const STRIPE_BAND_HEIGHT_PX = 28;
+export declare const STRIPE_ANGLE = "-45deg";
+export declare const STRIPE_INK = "color-mix(in oklab, var(--accent) 50%, var(--bg))";
+export declare function isStriped(style: DividerStyle): style is Exclude<DividerStyle, "line">;
+export declare function parseDividerStyle(value: unknown): DividerStyle;
+export declare function stripeBackground(style: DividerStyle): string | null;

package/dist/lib/sections/divider-style.js

@@ -0,0 +1 @@
+import{parseOption as t}from"../parse-option.js";const n="line",o=[{label:"Line",value:"line"},{label:"Stripes \xB7 fine",value:"stripes-fine"},{label:"Stripes \xB7 medium",value:"stripes-medium"},{label:"Stripes \xB7 bold",value:"stripes-bold"}],p={"stripes-fine":{ink:4,period:12},"stripes-medium":{ink:8,period:18},"stripes-bold":{ink:14,period:28}},d=28,s="-45deg",l="color-mix(in oklab, var(--accent) 50%, var(--bg))";function a(e){return e!=="line"}function c(e){return t(o,n,e)}function E(e){if(!a(e))return null;const{ink:r,period:i}=p[e];return`repeating-linear-gradient(${s}, ${l} 0 ${r}px, transparent ${r}px ${i}px)`}export{n as DEFAULT_DIVIDER_STYLE,o as DIVIDER_STYLE_OPTIONS,s as STRIPE_ANGLE,d as STRIPE_BAND_HEIGHT_PX,l as STRIPE_INK,a as isStriped,c as parseDividerStyle,E as stripeBackground};

package/dist/lib/sections/faq-text-regions.d.ts

@@ -0,0 +1,4 @@
+import type { TextRegions } from "./text-regions.js";
+export type FaqRegionKey = "number" | "question" | "answer";
+export declare const FAQ_REGIONS: Readonly<Record<FaqRegionKey, TextRegions[string]>>;
+export declare const FAQ_TEXT_REGIONS: TextRegions;

package/dist/lib/sections/faq-text-regions.js

@@ -0,0 +1 @@
+const l={number:{label:"Number",follows:"Labels",builtIn:"14px",writable:!0},question:{label:"Question",follows:"Body",builtIn:"18px",writable:!0},answer:{label:"Answer",follows:"Body",builtIn:"15px",writable:!0}},e=l;export{l as FAQ_REGIONS,e as FAQ_TEXT_REGIONS};

package/dist/lib/sections/hero-overlay.d.ts

@@ -0,0 +1,10 @@
+export type OverlayPosition = "top" | "right" | "bottom" | "left";
+export declare const DEFAULT_OVERLAY_POSITION: OverlayPosition;
+export declare const DEFAULT_OVERLAY_COLOR = "#0A0A0A";
+export declare const OVERLAY_POSITION_OPTIONS: readonly {
+    label: string;
+    value: OverlayPosition;
+    cell: OverlayPosition;
+}[];
+export declare function parseOverlayPosition(value: unknown): OverlayPosition;
+export declare function overlayGradient(color?: string, at?: unknown): string;

package/dist/lib/sections/hero-overlay.js

@@ -0,0 +1 @@
+import{parseOption as i}from"../parse-option.js";const r="bottom",a="#0A0A0A",p=[{label:"Bottom",value:"bottom",cell:"bottom"},{label:"Top",value:"top",cell:"top"},{label:"Left",value:"left",cell:"left"},{label:"Right",value:"right",cell:"right"}],O={bottom:180,top:0,left:270,right:90},u=[[.55,0],[.15,18],[null,35],[null,55],[.85,100]],b=[[null,33],[.6,67],[.94,100]];function A(t,n){const o=/^#[0-9a-f]{6}$/i.test(t)?t:a,e=parseInt(o.slice(1),16);return`rgba(${e>>16&255},${e>>8&255},${e&255},${n})`}function L(t){return i(p,r,t)}function m(t=a,n=r){const o=L(n),s=(o==="top"||o==="bottom"?u:b).map(([l,c])=>`${l===null?"transparent":A(t,l)} ${c}%`);return`linear-gradient(${O[o]}deg, ${s.join(", ")})`}export{a as DEFAULT_OVERLAY_COLOR,r as DEFAULT_OVERLAY_POSITION,p as OVERLAY_POSITION_OPTIONS,m as overlayGradient,L as parseOverlayPosition};

package/dist/lib/sections/intro-bleed-layout.d.ts

@@ -0,0 +1,15 @@
+export type IntroBleedLayout = "overlay" | "stacked";
+export declare const DEFAULT_INTRO_BLEED_LAYOUT: IntroBleedLayout;
+export declare const INTRO_BLEED_LAYOUT_OPTIONS: readonly {
+    label: string;
+    value: IntroBleedLayout;
+}[];
+export declare function parseIntroBleedLayout(value: unknown): IntroBleedLayout;
+export declare const INTRO_BLEED_COPY_SHARE: {
+    readonly desktop: 40;
+    readonly mobile: 45;
+    readonly min: 20;
+    readonly max: 80;
+    readonly step: 5;
+};
+export declare function resolveCopyShare(stored: number | undefined, builtIn: number): string;

package/dist/lib/sections/intro-bleed-layout.js

@@ -0,0 +1 @@
+import{parseOption as r}from"../parse-option.js";const t="overlay",a=[{label:"Copy over image",value:"overlay"},{label:"Copy above image",value:"stacked"}];function n(e){return r(a,t,e)}const l={desktop:40,mobile:45,min:20,max:80,step:5};function O(e,o){return`${typeof e=="number"?e:o}%`}export{t as DEFAULT_INTRO_BLEED_LAYOUT,l as INTRO_BLEED_COPY_SHARE,a as INTRO_BLEED_LAYOUT_OPTIONS,n as parseIntroBleedLayout,O as resolveCopyShare};

package/dist/lib/sections/product-card-style.d.ts

@@ -0,0 +1,18 @@
+export type CardIndexFormat = "off" | "plain" | "padded" | "numero";
+export type CardOutline = "none" | "hairline";
+export declare const DEFAULT_CARD_INDEX_FORMAT: CardIndexFormat;
+export declare const DEFAULT_CARD_OUTLINE: CardOutline;
+export declare const CARD_INDEX_OPTIONS: readonly {
+    label: string;
+    value: CardIndexFormat;
+}[];
+export declare const CARD_OUTLINE_OPTIONS: readonly {
+    label: string;
+    value: CardOutline;
+}[];
+export declare function parseCardIndexFormat(value: unknown): CardIndexFormat;
+export declare function parseCardOutline(value: unknown): CardOutline;
+export declare const CARD_INDEX_CLASS = "sf-card-index";
+export declare const CARD_INDEX_BADGE_CLASS = "pointer-events-none absolute left-[18px] top-[18px] z-10 border border-line bg-bg/70 px-2 py-1 font-mono text-[length:var(--size-label,10px)] uppercase tracking-[0.16em] text-fg-dim";
+export declare function cardIndexCss(scopeClass: string, format: CardIndexFormat): string;
+export declare function cardOutlineClass(outline: CardOutline): string;

package/dist/lib/sections/product-card-style.js

@@ -0,0 +1 @@
+import{parseOption as o}from"../parse-option.js";const a="off",l="none",i=[{label:"None",value:"off"},{label:"1, 2, 3",value:"plain"},{label:"01, 02, 03",value:"padded"},{label:"N\xB001, N\xB002",value:"numero"}],c=[{label:"None",value:"none"},{label:"Hairline",value:"hairline"}];function u(e){return o(i,a,e)}function x(e){return o(c,l,e)}const t="sf-card-index",n="sf-card-index",N="pointer-events-none absolute left-[18px] top-[18px] z-10 border border-line bg-bg/70 px-2 py-1 font-mono text-[length:var(--size-label,10px)] uppercase tracking-[0.16em] text-fg-dim",d={plain:`counter(${n})`,padded:`counter(${n}, decimal-leading-zero)`,numero:`"N\xB0" counter(${n}, decimal-leading-zero)`};function f(e,r){return r==="off"?"":`.${e}{counter-reset:${n}}.${e} .${t}{counter-increment:${n}}.${e} .${t}::before{content:${d[r]}}`}function _(e){return e==="hairline"?"border border-line hover:border-accent":""}export{N as CARD_INDEX_BADGE_CLASS,t as CARD_INDEX_CLASS,i as CARD_INDEX_OPTIONS,c as CARD_OUTLINE_OPTIONS,a as DEFAULT_CARD_INDEX_FORMAT,l as DEFAULT_CARD_OUTLINE,f as cardIndexCss,_ as cardOutlineClass,u as parseCardIndexFormat,x as parseCardOutline};