efficient-web-builder 32.1.0 → 32.2.0

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## Unreleased
 
+## 32.2.0 - 2026-10-22
+
+### Added
+
+- **A new site starts on the Box header** (plan 2026-10-10 step B3; card [SWITCH] Every Site To The Box Header). A new site already started on the Box footer: its site-footer document is laid down empty, and the seed fills it. That same new site now also gets the header group, pinned first, built by the HOST from the site's own header row. A site on the old footer, or on the Box footer only, keeps its header: it switches by its own choice ("Switch to Box header"). No live site changes.
+- `EditorBlocks.seeds` (`lib/editor-blocks`, with `EditorSeeds` and `EditorSeedContext`): `siteHeader({ make, id, siteId, token })` resolves the `SiteHeader` group, or null. Optional: a host without it keeps a new site on the old header, as before.
+- A TEMPLATE's site-footer page gets no old Footer or Header seeded (`components/usePinnedChromeSeed`). A site made from the template takes that page as its site-footer document, so it stays empty and the new site's seed lays down both Box groups.
+- `lib/puck/new-site-header-seed` (`seedNewSiteHeader`): asks the host, then writes the group only when the same document is still open, no header group arrived meanwhile, and the answer is a header group. `inPlaceSeedPlan` gains `seedSiteHeader`.
+
+### Changed
+
+- The comments that said nothing creates a group (`components/usePinnedChromeSeed`, `lib/puck/section-groups`) say the two ways a group is created now. The stale notes on the footer focus's seams and `panels.chromePage` are gone (`components/SectionEditor`, `components/WebsiteScreenParts`).
+
+### Guards
+
+- `scripts/test-new-site-box-header.ts` (red first): which sites get the header group, the write and each case that writes nothing, the seed's call, and the template's empty site-footer page.
+
 ## 32.1.0 - 2026-10-21
 
 ### Added

package/dist/editor/components/usePinnedChromeSeed.js

@@ -1 +1 @@
-"use client";import{useEffect as G,useRef as L}from"react";import{createNode as x,newId as z}from"efficient-easel/data";import{useEaselApi as U}from"efficient-easel/easel";import{useScreenDocument as Z}from"efficient-easel/screen/components/ScreenDocumentContext";import{SITE_FOOTER_SLUG as H}from"../../format/lib/content/footer.js";import{boxFooterFromFooter as B}from"../../format/lib/puck/box-footer.js";import{ROOT_ZONE as l,missingPinnedTypes as j,pinnedDuplicateIds as D}from"efficient-easel/draw";import{FOOTER_TYPE as c,HEADER_TYPE as p,buildDefaultFooterBlocks as P,buildDefaultHeaderNode as E}from"../lib/puck/footer-blocks.js";import{canSeedPinnedChrome as q}from"../../format/lib/puck/pinned-seed-gate.js";import{siteFooterDocChrome as J,SITE_FOOTER_TYPE as f}from"../../format/lib/puck/section-groups.js";import{inPlaceSeedPlan as K}from"../lib/puck/pinned-in-place-seed.js";function se(t,F){const{adapter:k,capabilities:T,currentSlug:O,docId:u,data:y,saveStatus:I}=Z(),{hasSiteSettings:N,hasPinnedChrome:b}=T,C=!!T.editsPinnedInPlace&&O!==H,R=O===H,_=U().getState,v=L(null);G(()=>{if(!q({docId:u,saveStatus:I,seededDocId:v.current})||(v.current=u,!b))return;const m=_().appState.data,o=m.content,a=y?.content??[],d=(e,n)=>e.some(r=>r?.type===n);if(!N){const e=new Set(D(o)),n=e.size?o.filter(s=>!e.has(s.props.id)):o;e.size&&t.setDocument({...m,content:n});const r=j(n,a);if(r.includes(c)){const s=n.length,i=t.insertSection(c,s);t.replaceComponent(l,s,{type:c,props:{id:i,blocks:P()}})}r.includes(p)&&t.insertNode(l,0,E());return}if(R){const e=J(o);if(e!==o&&t.setDocument({...m,content:[...e]}),!e.find(r=>r.type===c)&&!d(a,c)&&!d(e,f)&&!d(a,f)){const r=(i,g)=>x(F,i,g),s={type:c,props:{blocks:P()}};t.insertNode(l,e.length,B(s,r,z(f)))}return}if(C){const e=!!k?.pinnedChrome?.state().docId,n=K(o,{hasChromeDoc:e}),r=new Set([...n.remove,...D(o.filter(i=>!n.remove.includes(String(i.props.id))))]),s=r.size?o.filter(i=>!r.has(String(i.props.id))):o;if(s.length!==o.length&&t.setDocument({...m,content:s}),n.seedFooter&&!d(a,c)&&!d(a,f)){const i=(Y,A)=>x(F,Y,A),g={type:c,props:{blocks:P()}};t.insertNode(l,s.length,B(g,i,z(f)))}if(n.seedHeader&&!d(a,p)){const i=s[0]?.type==="SiteHeader"?1:0;t.insertNode(l,i,E())}return}const h=o.filter(e=>e.type!==c),w=new Set(D(h)),S=w.size?h.filter(e=>!w.has(e.props.id)):h;S.length!==o.length&&t.setDocument({...m,content:S}),!d(S,p)&&!d(a,p)&&t.insertNode(l,0,E())},[u,I,y,_,t,N,b,R,C,k])}export{se as usePinnedChromeSeed};
+"use client";import{useEffect as j,useRef as q}from"react";import{createNode as T,newId as I}from"efficient-easel/data";import{useEaselApi as J}from"efficient-easel/easel";import{useScreenDocument as K}from"efficient-easel/screen/components/ScreenDocumentContext";import{useEaselSession as M}from"efficient-easel/screen/lib/session-context";import{SITE_FOOTER_SLUG as L}from"../../format/lib/content/footer.js";import{boxFooterFromFooter as U}from"../../format/lib/puck/box-footer.js";import{ROOT_ZONE as l,missingPinnedTypes as Q,pinnedDuplicateIds as O}from"efficient-easel/draw";import{FOOTER_TYPE as a,HEADER_TYPE as E,buildDefaultFooterBlocks as b,buildDefaultHeaderNode as N}from"../lib/puck/footer-blocks.js";import{canSeedPinnedChrome as V}from"../../format/lib/puck/pinned-seed-gate.js";import{siteFooterDocChrome as W,SITE_FOOTER_TYPE as f}from"../../format/lib/puck/section-groups.js";import{inPlaceSeedPlan as X}from"../lib/puck/pinned-in-place-seed.js";import{seedNewSiteHeader as $}from"../../format/lib/puck/new-site-header-seed.js";import{SITE_HEADER_TYPE as R}from"../../format/lib/puck/section-groups.js";import{blocksOf as ee}from"../lib/website-session.js";function he(t,D){const{adapter:_,capabilities:y,currentSlug:w,docId:S,data:C,saveStatus:H,siteId:v,tokenRef:x}=K(),z=M(),{hasSiteSettings:Y,hasPinnedChrome:A}=y,B=!!y.editsPinnedInPlace&&w!==L,g=w===L,h=J().getState,k=q(null);j(()=>{if(!V({docId:S,saveStatus:H,seededDocId:k.current})||(k.current=S,!A))return;const p=h().appState.data,n=p.content,d=C?.content??[],r=(e,s)=>e.some(i=>i?.type===s);if(!Y){const e=new Set(O(n)),s=e.size?n.filter(c=>!e.has(c.props.id)):n;if(e.size&&t.setDocument({...p,content:s}),g)return;const i=Q(s,d);if(i.includes(a)){const c=s.length,o=t.insertSection(a,c);t.replaceComponent(l,c,{type:a,props:{id:o,blocks:b()}})}i.includes(E)&&t.insertNode(l,0,N());return}if(g){const e=W(n);if(e!==n&&t.setDocument({...p,content:[...e]}),!e.find(i=>i.type===a)&&!r(d,a)&&!r(e,f)&&!r(d,f)){const i=(o,m)=>T(D,o,m),c={type:a,props:{blocks:b()}};t.insertNode(l,e.length,U(c,i,I(f)))}return}if(B){const e=!!_?.pinnedChrome?.state().docId,s=X(n,{hasChromeDoc:e}),i=new Set([...s.remove,...O(n.filter(o=>!s.remove.includes(String(o.props.id))))]),c=i.size?n.filter(o=>!i.has(String(o.props.id))):n;if(c.length!==n.length&&t.setDocument({...p,content:c}),s.seedFooter&&!r(d,a)&&!r(d,f)){const o=(u,Z)=>T(D,u,Z),m={type:a,props:{blocks:b()}};t.insertNode(l,c.length,U(m,o,I(f)))}if(s.seedHeader&&!r(d,E)){const o=c[0]?.type===R?1:0;t.insertNode(l,o,N())}if(s.seedSiteHeader&&!r(d,R)&&!r(d,a)&&!r(d,f)){const o=S;$({blocks:ee(z),make:(m,u)=>T(D,m,u),id:I(R),siteId:v??null,token:x.current,latest:()=>h().appState.data.content,stillOpen:()=>k.current===o,write:m=>{const u=h().appState.data;t.setDocument({...u,content:[...m]})}})}return}const P=n.filter(e=>e.type!==a),G=new Set(O(P)),F=G.size?P.filter(e=>!G.has(e.props.id)):P;F.length!==n.length&&t.setDocument({...p,content:F}),!r(F,E)&&!r(d,E)&&t.insertNode(l,0,N())},[S,H,C,h,t,Y,A,g,B,_,z,v,x])}export{he as usePinnedChromeSeed};

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

@@ -7,6 +7,21 @@ export interface EditorBlockCategory {
     components: string[];
     before?: string;
 }
+export interface EditorSeedContext {
+    make: (type: string, props?: Record<string, unknown>) => {
+        type: string;
+        props: Record<string, unknown>;
+    };
+    id: string;
+    siteId: string | null;
+    token: string | null;
+}
+export interface EditorSeeds {
+    siteHeader?: (ctx: EditorSeedContext) => Promise<{
+        type: string;
+        props: Record<string, unknown>;
+    } | null>;
+}
 export interface EditorBlocks {
     sets?: readonly BlockSet[];
     allow?: readonly string[];
@@ -14,6 +29,7 @@ export interface EditorBlocks {
     host?: Record<string, ComponentConfig>;
     categories?: EditorBlockCategory[];
     metadata?: Record<string, unknown>;
+    seeds?: EditorSeeds;
 }
 export type OfferedSets = Readonly<Record<BlockSet, boolean>>;
 export declare function offeredSets(blocks: EditorBlocks | SessionBlocks | null | undefined): OfferedSets;

package/dist/editor/lib/puck/pinned-in-place-seed.d.ts

@@ -8,6 +8,7 @@ export type InPlaceSeedPlan = {
     remove: string[];
     seedHeader: boolean;
     seedFooter: boolean;
+    seedSiteHeader: boolean;
 };
 export declare function inPlaceSeedPlan(live: readonly Node[], opts: {
     hasChromeDoc: boolean;

package/dist/editor/lib/puck/pinned-in-place-seed.js

@@ -1 +1 @@
-import{FOOTER_TYPE as n,HEADER_TYPE as m}from"./footer-blocks.js";import{SITE_FOOTER_TYPE as a}from"../../../format/lib/puck/section-groups.js";function d(o,p){const t=o.some(e=>e?.type===a),r=o[o.length-1],s=!t&&r?.type===n?r:null;return{remove:o.filter(e=>e?.type===n&&e!==s).map(e=>String(e.props?.id??"")).filter(Boolean),seedHeader:!o.some(e=>e?.type===m),seedFooter:p.hasChromeDoc&&!t&&!s}}export{d as inPlaceSeedPlan};
+import{FOOTER_TYPE as p,HEADER_TYPE as a}from"./footer-blocks.js";import{SITE_FOOTER_TYPE as c,SITE_HEADER_TYPE as T}from"../../../format/lib/puck/section-groups.js";function _(o,E){const t=o.some(e=>e?.type===c),r=o[o.length-1],s=!t&&r?.type===p?r:null,m=o.filter(e=>e?.type===p&&e!==s).map(e=>String(e.props?.id??"")).filter(Boolean),n=E.hasChromeDoc&&!t&&!s;return{remove:m,seedHeader:!o.some(e=>e?.type===a),seedFooter:n,seedSiteHeader:n&&!o.some(e=>e?.type===T)}}export{_ as inPlaceSeedPlan};

package/dist/format/lib/puck/new-site-header-seed.d.ts

@@ -0,0 +1,17 @@
+import type { EditorBlocks, EditorSeedContext } from "../../../editor/lib/editor-blocks.js";
+type Node = {
+    type: string;
+    props: Record<string, unknown>;
+};
+export interface NewSiteHeaderSeed {
+    blocks: EditorBlocks | null | undefined;
+    make: EditorSeedContext["make"];
+    id: string;
+    siteId: string | null;
+    token: string | null;
+    latest: () => readonly Node[];
+    stillOpen: () => boolean;
+    write: (content: readonly Node[]) => void;
+}
+export declare function seedNewSiteHeader(seed: NewSiteHeaderSeed): Promise<boolean>;
+export {};

package/dist/format/lib/puck/new-site-header-seed.js

@@ -0,0 +1 @@
+import{SITE_HEADER_TYPE as n,withSectionGroup as o}from"./section-groups.js";async function l(t){const r=t.blocks?.seeds?.siteHeader;if(!r)return!1;let e;try{e=await r({make:t.make,id:t.id,siteId:t.siteId,token:t.token})}catch{return!1}if(!e||e.type!==n||!t.stillOpen())return!1;const i=t.latest();return i.some(a=>a?.type===n)?!1:(t.write(o(i,e)),!0)}export{l as seedNewSiteHeader};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "efficient-web-builder",
-  "version": "32.1.0",
+  "version": "32.2.0",
   "description": "The EFFICIENT website builder: the website editor, the general sections and the renderer that draws them, compiled. Hostable by any EFFICIENT product; nothing here imports a host.",
   "license": "UNLICENSED",
   "author": "Efficient Pty Ltd",