efficient-storefront-blocks 0.60.0 → 0.62.0

package/dist/fitment.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The public types of `efficient-storefront-blocks/fitment` (published as
+ * dist/fitment.d.ts).
+ *
+ * Written out, like `consent.public.d.ts`, and kept honest the same way:
+ * `types.check.ts` pairs each declaration with the code it describes.
+ *
+ * Plain data and pure functions. It imports nothing.
+ */
+
+/** The unit a load is printed in. */
+export type LoadUnit = "kg" | "lbs";
+
+/** One size a wheel ships in, as a size table draws it. */
+export interface FitmentRow {
+  diameter: number;
+  width: number;
+  holes: number;
+  /** PCD in mm — usually a single value ("112") but can be a range ("112-114.3"). */
+  pcd: string;
+  /** ET (offset) in mm. */
+  et: number;
+  /** Centre bore in mm. */
+  cb: number;
+  cap: string;
+  boltPattern: string;
+  loadRating: string;
+}
+
+/** One column of the size table. */
+export interface FitmentColumn {
+  /** The catalogue field key an answer names. */
+  fieldKey: string;
+  header: string;
+  /** Drawn when no merchant has answered. A column OFF by default shows only
+   *  on an explicit `fitment: true`; one ON by default hides only on `false`. */
+  shownByDefault: boolean;
+  cell: (row: FitmentRow, unit: LoadUnit) => string | number;
+}
+
+/** Every column, in the default order: Size, Bolt pattern, Offset, Centre
+ *  bore, Cap, Load. */
+export const FITMENT_COLUMNS: readonly FitmentColumn[];
+
+/** Whether one column is drawn, given a site's answers. */
+export function fitmentColumnShown(
+  column: FitmentColumn,
+  answers: readonly { fieldKey: string; fitment?: boolean }[],
+): boolean;
+
+/** A free-text load rating ("880kg / 1,940 lbs") in ONE unit: "880 kg". */
+export function formatLoad(text: string, unit: LoadUnit): string;
+
+/** The market a page is drawn for (alpha-2, "" for none) → its load unit:
+ *  "lbs" for "US", "kg" for every other. */
+export function loadUnitFor(country: string): LoadUnit;

package/dist/fitment.js

@@ -0,0 +1 @@
+function p(e){return e.toUpperCase()==="US"?"lbs":"kg"}var d=.45359237,l=/\d[\d,]*(?:\.\d+)?/g,g=/(\d[\d,]*(?:\.\d+)?(?:\s*[–-]\s*\d[\d,]*(?:\.\d+)?)?)\s*(kgs?|lbs?)\b/gi,s=e=>Number(e.replace(/,/g,"")),a=e=>Math.round(e).toLocaleString("en-US");function f(e,n){let r={};for(let[,t,c]of e.matchAll(g)){let y=c.toLowerCase().startsWith("kg")?"kg":"lbs";r[y]??=t}let o=r[n];if(o!==void 0)return`${o.replace(l,t=>a(s(t))).replace(/\s*([–-])\s*/,"$1")} ${n}`;let i=r[n==="kg"?"lbs":"kg"];if(i===void 0)return e.trim();let u=n==="kg"?d:1/d;return`${i.replace(l,t=>a(s(t)*u)).replace(/\s*([–-])\s*/,"$1")} ${n}`}var m=e=>e>0?`+${e}`:e<0?`\u2212${-e}`:"0",h=e=>{let n=/^(\d+)\s*[×x]\s*\d/.exec(e.boltPattern)?.[1];return n!==void 0&&Number(n)===e.holes?e.boltPattern:e.holes>0&&e.pcd?`${e.holes}\xD7${e.pcd}`:e.boltPattern},b=[{fieldKey:"diameter",header:"Size",shownByDefault:!0,cell:e=>`${e.diameter} \xD7 ${e.width}`},{fieldKey:"bolt_pattern",header:"Bolt pattern",shownByDefault:!0,cell:h},{fieldKey:"et",header:"Offset",shownByDefault:!0,cell:e=>m(e.et)},{fieldKey:"center_bore",header:"Centre bore",shownByDefault:!1,cell:e=>e.cb},{fieldKey:"cap_code",header:"Cap",shownByDefault:!1,cell:e=>e.cap},{fieldKey:"load_rating",header:"Load",shownByDefault:!0,cell:(e,n)=>f(e.loadRating,n)}];function w(e,n){let r=n.find(o=>o.fieldKey===e.fieldKey)?.fitment;return e.shownByDefault?r!==!1:r===!0}export{b as FITMENT_COLUMNS,w as fitmentColumnShown,f as formatLoad,p as loadUnitFor};

package/dist/index.d.ts

@@ -23,6 +23,7 @@ export type EditorTarget =
 import type {
   EaselHost as EditorHost,
   EaselHostAddress as EditorHostAddress,
+  EaselHostPanels as EditorHostPanels,
   EaselToHostMessage as EditorToHostMessage,
   HostPickedMedia,
   HostToEaselMessage as HostToEditorMessage,
@@ -30,6 +31,7 @@ import type {
 export type {
   EaselHost as EditorHost,
   EaselHostAddress as EditorHostAddress,
+  EaselHostPanels as EditorHostPanels,
   EaselMessageType as EditorMessageType,
   EaselToHostMessage as EditorToHostMessage,
   HostPickedMedia,
@@ -56,7 +58,8 @@ export interface MediaPickRequest {
   options?: Record<string, unknown>;
 }
 
-/** The props the host's media panel is drawn with. */
+/** The props the host's media popup is drawn with. It is drawn always; it is
+ *  OPEN while `pick` or `browsing` is set. */
 export interface MediaPanelProps {
   /** The field choosing right now, or null. Wins over `browsing`. */
   pick: MediaPickRequest | null;
@@ -73,10 +76,28 @@ export interface MediaPanelProps {
  *  19). The names still say "panel": hosts import them. */
 export type MediaPanelComponent = ComponentType<MediaPanelProps>;
 
+/** A file dragged out of the host's popup onto the canvas. */
+export interface MediaPlacedFile {
+  id: string;
+  url: string;
+  kind: "image" | "video";
+  name: string;
+}
+
+/** What a file dropped on the canvas becomes on this host before the editor
+ *  places it (its pick path). Null: it cannot be used here, nothing is placed. */
+export type MediaPlace = (file: MediaPlacedFile) => Promise<HostPickedMedia | null>;
+
 /** A host for an editor mounted in the embedder's own page. One per editor. */
 export function createEditorHost(options: {
   onMessage: (message: EditorToHostMessage) => void;
   address: EditorHostAddress;
+  /** How the editor takes Escape before the embedder's window does. */
+  claimEscape?: (handler: (e: KeyboardEvent) => boolean) => () => void;
+  /** What the host puts in the editor's chrome (0.62.0): a button first in the
+   *  top bar's right cluster, and a panel that stands in the inspector's place
+   *  while `useRight` returns something (the admin portal's JARVIS). */
+  panels?: EditorHostPanels;
 }): { host: EditorHost; deliver: (message: HostToEditorMessage) => void };
 
 // ── The backend (0.4.0) ──────────────────────────────────────────────────────
@@ -266,18 +287,22 @@ export interface SiteRecord {
   name: string;
   /** Its public slug, where it has one. */
   slug?: string | null;
-  /** The site-wide Google Maps browser key the canvas's map blocks draw with. */
+  /** The site-wide Google Maps browser key the canvas's map blocks drew with.
+   *  @deprecated Every website map is efficient-shell's since efficient-web-builder 34 and needs no Google key, so nothing reads or writes it (Victor Mau, 2026-10-23: remove them). Removed in the next major. */
   mapsApiKey?: string | null;
-  /** The site-wide Google Maps cloud style. */
+  /** The site-wide Google Maps cloud style.
+   *  @deprecated Every website map is efficient-shell's since efficient-web-builder 34 and needs no Google key, so nothing reads or writes it (Victor Mau, 2026-10-23: remove them). Removed in the next major. */
   mapsMapId?: string | null;
 }
 
-/** The part of the site record the editor writes. */
+/** The part of the site record the editor writes.
+ *  @deprecated Only the Maps key, which nothing writes any more. Every website map is efficient-shell's since efficient-web-builder 34 and needs no Google key, so nothing reads or writes it (Victor Mau, 2026-10-23: remove them). Removed in the next major. */
 export type SiteRecordPatch = { mapsApiKey?: string };
 
 export interface WebsiteSite {
   get(scope?: SiteScope): Promise<SiteRecord>;
-  /** Save the site-wide Maps key. Without it that field is read-only. */
+  /** Save the site-wide Maps key. Without it that field is read-only.
+   *  @deprecated Every website map is efficient-shell's since efficient-web-builder 34 and needs no Google key, so nothing reads or writes it (Victor Mau, 2026-10-23: remove them). Removed in the next major. */
   update?(patch: SiteRecordPatch, scope?: SiteScope): Promise<SiteRecord>;
   /** RESERVED for the multilingual overlay: the languages the website is
    *  written in. 0.4.0 does not call it. */
@@ -738,9 +763,12 @@ export function WebsiteEditor(props: {
   host: EditorHost;
   target: EditorTarget;
   site: WebsiteEditorSite | null;
-  /** The host's media library, drawn in the editor's left panel. Without one,
+  /** The host's media library, drawn as the editor's one popup. Without one,
    *  fields ask the host to open its picker window (`open-media-picker`). */
   mediaPanel?: MediaPanelComponent | null;
+  /** What a picture dropped from that popup becomes on this host first (its
+   *  pick path). Without one, the file as it came. */
+  mediaPlace?: MediaPlace | null;
   /** The server the editor talks to. Without one it is EFFICIENT's
    *  (`createEfficientBackend`). Read once, when the editor mounts. */
   backend?: WebsiteBackend | null;
@@ -765,6 +793,8 @@ export function WebsiteSectionEditor(props: {
   site: WebsiteEditorSite | null;
   /** The host's media library — see `WebsiteEditor`. */
   mediaPanel?: MediaPanelComponent | null;
+  /** A dropped picture's pick path — see `WebsiteEditor`. */
+  mediaPlace?: MediaPlace | null;
   /** The server the editor talks to — see `WebsiteEditor`. Needs
    *  `sectionTemplates`. */
   backend?: WebsiteBackend | null;