@frontlit/page-builder 0.1.0-alpha.2 → 0.1.0-alpha.3

package/dist/components/index.d.ts

@@ -1,20 +1,45 @@
 import React__default from 'react';
-export { A as AspectRatio, I as Image, a as ImageObjectFit, V as VideoThumbnailProps, b as VideoWithPreview, r as roundedMap } from '../image-DAWVx1zQ.js';
+export { A as AspectRatio, I as Image, a as ImageAttributesInput, b as ImageAttributesResolver, c as ImageObjectFit, V as VideoThumbnailProps, d as VideoWithPreview, r as roundedMap, s as setImageAttributesResolver } from '../image-Bk8kPXwP.js';
 export { N as NavLink, P as PageBuilderLinkComponent, a as PageBuilderLinkProps, b as PageBuilderLinkProvider, u as usePageBuilderLinkComponent } from '../nav-link-BfxvQ1s6.js';
-import { T as ThemeStyle } from '../theme-style-Cbl7NM-T.js';
-import { B as ButtonProps } from '../button-Bzt1GDO-.js';
+import { T as ThemeStyle } from '../theme-style-BVd5tOsc.js';
+import { B as ButtonProps } from '../button-OLKN3wPf.js';
 import { R as ResolvedColorMode } from '../color-mode-DIEEt9WP.js';
-export { TextRenderer, truncateTextEditorContent } from '@frontlit/text-editor';
+export { TextRenderer } from '@frontlit/text-editor/renderer';
+export { truncateTextEditorContent } from '@frontlit/text-editor';
 import 'class-variance-authority/types';
 import 'class-variance-authority';
 
-interface SandboxedEmbedProps {
+interface InlineEmbedProps {
     content: string;
     className?: string;
     style?: React__default.CSSProperties;
-    id?: string;
 }
-declare const SandboxedEmbed: ({ content, className, style, id, }: SandboxedEmbedProps) => React__default.JSX.Element;
+/**
+ * Snippets are usually written as a standalone document (they used to live in
+ * an iframe). Recreate that inside the shadow root: the host plays `html` and
+ * is a size container, a wrapper plays `body`, and viewport units and width
+ * media queries are rewritten to measure the embed (as they measured the
+ * iframe) instead of the browser window. "Fill the frame" heights are dropped,
+ * as are scripts that only synced state with `window.parent`, which the shadow
+ * host handles itself.
+ */
+declare function prepareEmbed(content: string): {
+    links: string;
+    body: string;
+};
+/**
+ * Renders a raw HTML snippet inline, inside a declarative shadow root. The
+ * markup is part of the server-rendered page (so crawlers index it) while its
+ * styles stay isolated from the site's in both directions.
+ */
+declare const InlineEmbed: ({ content, className, style }: InlineEmbedProps) => React__default.JSX.Element;
+
+/** The FrontLit petal mark. Header and footer fall back to it, with the
+ * "FrontLit" name, until a site sets its own branding. */
+declare function FrontLitLogo({ className }: {
+    className?: string;
+}): React__default.JSX.Element;
+declare const FRONTLIT_NAME = "FrontLit";
 
 /**
  * Light / dark toggle. Public sites pass `theme` so the button uses
@@ -33,4 +58,4 @@ declare function ThemeModeSwitcher({ resolved, onToggle, theme, className, size,
     variant?: ButtonProps["variant"];
 }): React__default.JSX.Element;
 
-export { SandboxedEmbed, ThemeModeSwitcher };
+export { FRONTLIT_NAME, FrontLitLogo, InlineEmbed, ThemeModeSwitcher, prepareEmbed };

package/dist/components/index.js

@@ -1,6 +1,46 @@
 "use client";
-export { Image, NavLink, PageBuilderLinkProvider, SandboxedEmbed, TextRenderer, ThemeModeSwitcher, VideoWithPreview, roundedMap, truncateTextEditorContent, usePageBuilderLinkComponent } from '../chunk-H4P5MFJI.js';
-import '../chunk-SGNRWWG3.js';
+export { ThemeModeSwitcher } from '../chunk-BBI7UHOA.js';
+export { Image, InlineEmbed, NavLink, PageBuilderLinkProvider, TextRenderer, VideoWithPreview, prepareEmbed, roundedMap, setImageAttributesResolver, usePageBuilderLinkComponent } from '../chunk-36QHCIPM.js';
+import '../chunk-J7Z4UW45.js';
 import '../chunk-XU7ALPGQ.js';
+import { jsx } from 'react/jsx-runtime';
+export { truncateTextEditorContent } from '@frontlit/text-editor';
+
+function FrontLitLogo({ className }) {
+  return /* @__PURE__ */ jsx(
+    "svg",
+    {
+      xmlns: "http://www.w3.org/2000/svg",
+      viewBox: "0 0 64 64",
+      className,
+      "aria-hidden": true,
+      children: /* @__PURE__ */ jsx(
+        "g",
+        {
+          fill: "oklch(0.62 0.16 230 / 0.15)",
+          stroke: "oklch(0.62 0.16 230)",
+          strokeWidth: "2.4",
+          strokeLinejoin: "round",
+          children: [
+            [41.19, 22.81, 45],
+            [41.19, 41.19, 135],
+            [22.81, 41.19, 225],
+            [22.81, 22.81, 315]
+          ].map(([x, y, angle]) => /* @__PURE__ */ jsx(
+            "path",
+            {
+              d: "M0,-11 C5.5,-5.5 5.5,5.5 0,11 C-5.5,5.5 -5.5,-5.5 0,-11 Z",
+              transform: `translate(${x},${y}) rotate(${angle})`
+            },
+            angle
+          ))
+        }
+      )
+    }
+  );
+}
+var FRONTLIT_NAME = "FrontLit";
+
+export { FRONTLIT_NAME, FrontLitLogo };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"sources":["../../src/components/frontlit-logo.tsx"],"names":[],"mappings":";;;;;;;AAIO,SAAS,YAAA,CAAa,EAAE,SAAA,EAAU,EAA2B;AAClE,EAAA,uBACE,GAAA;AAAA,IAAC,KAAA;AAAA,IAAA;AAAA,MACC,KAAA,EAAM,4BAAA;AAAA,MACN,OAAA,EAAQ,WAAA;AAAA,MACR,SAAA;AAAA,MACA,aAAA,EAAW,IAAA;AAAA,MAEX,QAAA,kBAAA,GAAA;AAAA,QAAC,GAAA;AAAA,QAAA;AAAA,UACC,IAAA,EAAK,6BAAA;AAAA,UACL,MAAA,EAAO,sBAAA;AAAA,UACP,WAAA,EAAY,KAAA;AAAA,UACZ,cAAA,EAAe,OAAA;AAAA,UAEd,QAAA,EAAA;AAAA,YACC,CAAC,KAAA,EAAO,KAAA,EAAO,EAAE,CAAA;AAAA,YACjB,CAAC,KAAA,EAAO,KAAA,EAAO,GAAG,CAAA;AAAA,YAClB,CAAC,KAAA,EAAO,KAAA,EAAO,GAAG,CAAA;AAAA,YAClB,CAAC,KAAA,EAAO,KAAA,EAAO,GAAG;AAAA,YAClB,GAAA,CAAI,CAAC,CAAC,CAAA,EAAG,CAAA,EAAG,KAAK,CAAA,qBACjB,GAAA;AAAA,YAAC,MAAA;AAAA,YAAA;AAAA,cAEC,CAAA,EAAE,2DAAA;AAAA,cACF,WAAW,CAAA,UAAA,EAAa,CAAC,CAAA,CAAA,EAAI,CAAC,YAAY,KAAK,CAAA,CAAA;AAAA,aAAA;AAAA,YAF1C;AAAA,WAIR;AAAA;AAAA;AACH;AAAA,GACF;AAEJ;AAEO,IAAM,aAAA,GAAgB","file":"index.js","sourcesContent":["import React from \"react\";\n\n/** The FrontLit petal mark. Header and footer fall back to it, with the\n * \"FrontLit\" name, until a site sets its own branding. */\nexport function FrontLitLogo({ className }: { className?: string }) {\n  return (\n    <svg\n      xmlns=\"http://www.w3.org/2000/svg\"\n      viewBox=\"0 0 64 64\"\n      className={className}\n      aria-hidden\n    >\n      <g\n        fill=\"oklch(0.62 0.16 230 / 0.15)\"\n        stroke=\"oklch(0.62 0.16 230)\"\n        strokeWidth=\"2.4\"\n        strokeLinejoin=\"round\"\n      >\n        {[\n          [41.19, 22.81, 45],\n          [41.19, 41.19, 135],\n          [22.81, 41.19, 225],\n          [22.81, 22.81, 315],\n        ].map(([x, y, angle]) => (\n          <path\n            key={angle}\n            d=\"M0,-11 C5.5,-5.5 5.5,5.5 0,11 C-5.5,5.5 -5.5,-5.5 0,-11 Z\"\n            transform={`translate(${x},${y}) rotate(${angle})`}\n          />\n        ))}\n      </g>\n    </svg>\n  );\n}\n\nexport const FRONTLIT_NAME = \"FrontLit\";\n"]}

package/dist/data-slots.d.ts

@@ -1,7 +1,7 @@
 import { ReactNode } from 'react';
-import { c as WidgetInstance, P as PageData } from './widget-B_RoG6se.js';
-import './section-background-MsdE40Rk.js';
-import './theme-style-Cbl7NM-T.js';
+import { c as WidgetInstance, P as PageData } from './widget-CpE2HdgU.js';
+import './section-background-6V_LCi5e.js';
+import './theme-style-BVd5tOsc.js';
 
 /** Context supplied to a host application's data-slot loader. */
 interface DataSlotLoadRequest {

package/dist/heading-DQCxQt38.d.ts

@@ -0,0 +1,20 @@
+type HorizontalAlignment = "center" | "left" | "right";
+type VerticalAlignment = "top" | "bottom";
+type Alignment = HorizontalAlignment | VerticalAlignment;
+
+/** Heading element a block renders its title as. */
+type HeadingLevel = "h1" | "h2" | "h3";
+/** Per-breakpoint text size in px; unset breakpoints keep the theme size. */
+interface ResponsiveTextSize {
+    mobile?: number;
+    tablet?: number;
+    desktop?: number;
+}
+/** Title options shared by every block with a title. */
+interface TitleSettings {
+    /** Defaults to H1 for the Hero and H2 everywhere else. */
+    titleLevel?: HeadingLevel;
+    titleSize?: ResponsiveTextSize;
+}
+
+export type { Alignment as A, HeadingLevel as H, ResponsiveTextSize as R, TitleSettings as T, VerticalAlignment as V, HorizontalAlignment as a };

package/dist/image-Bk8kPXwP.d.ts

@@ -0,0 +1,52 @@
+import * as React from 'react';
+import React__default from 'react';
+
+type AspectRatio = "16/9" | "4/3" | "1/1" | "21/9" | "9/16" | "2/1" | "3/2" | string;
+interface VideoThumbnailProps {
+    title?: string;
+    thumbnailUrl?: string;
+    videoUrl: string;
+    aspectRatio?: AspectRatio;
+    modal?: boolean;
+}
+declare function VideoWithPreview({ title, thumbnailUrl, videoUrl, aspectRatio, modal, }: VideoThumbnailProps): React.JSX.Element;
+
+interface ImageAttributesInput {
+    src: string;
+    alt: string;
+    sizes?: string;
+    /** Above-the-fold image (e.g. LCP): fetched eagerly at high priority. */
+    priority: boolean;
+}
+/**
+ * Lets a host swap an image's `src`/`srcSet` for its own optimizer's URLs
+ * (e.g. Next.js's `getImageProps`) without this package depending on the
+ * host framework. Return `null` to keep the original URL.
+ */
+type ImageAttributesResolver = (input: ImageAttributesInput) => React__default.ImgHTMLAttributes<HTMLImageElement> | null;
+/**
+ * Registers the host's resolver. Call once at server start-up; renders that
+ * run without one emit the original URL.
+ */
+declare function setImageAttributesResolver(resolver: ImageAttributesResolver | null): void;
+type ImageObjectFit = "cover" | "contain" | "fill" | "none" | "scale-down";
+declare const roundedMap: Record<number, string>;
+interface ImgProps {
+    src: string;
+    classes?: string;
+    alt?: string;
+    defaultImage?: string;
+    loading?: "eager" | "lazy";
+    /** Marks the image as likely LCP: eager load with high fetch priority. */
+    priority?: boolean;
+    height?: string;
+    sizes?: string;
+    width?: string;
+    borderRadius?: number | string;
+    noDefaultImage?: boolean;
+    className?: string;
+    objectFit?: ImageObjectFit;
+}
+declare const Image: (props: ImgProps) => React__default.JSX.Element;
+
+export { type AspectRatio as A, Image as I, type VideoThumbnailProps as V, type ImageAttributesInput as a, type ImageAttributesResolver as b, type ImageObjectFit as c, VideoWithPreview as d, roundedMap as r, setImageAttributesResolver as s };

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-import { T as Theme } from './section-background-MsdE40Rk.js';
-export { B as BackgroundAttachment, a as BackgroundRepeat, b as BlendMode, S as SectionBackground, c as SectionBackgroundOverlay } from './section-background-MsdE40Rk.js';
-export { B as Border, C as Colors, a as CustomStyle, D as DisabledStyle, M as MenuItemStyle, b as MenuStyle, P as Padding, S as Shadow, c as SurfaceStyle, T as ThemeStyle, d as Typography } from './theme-style-Cbl7NM-T.js';
-import { W as Widget, c as WidgetInstance } from './widget-B_RoG6se.js';
-export { B as BlockLayout, P as PageData, a as WidgetDefaultSettings, b as WidgetEditorProps, d as WidgetMetadata, e as WidgetProps } from './widget-B_RoG6se.js';
+import { T as Theme } from './section-background-6V_LCi5e.js';
+export { B as BackgroundAttachment, a as BackgroundRepeat, b as BlendMode, S as SectionBackground, c as SectionBackgroundOverlay } from './section-background-6V_LCi5e.js';
+export { B as Border, C as Colors, a as CustomStyle, D as DisabledStyle, M as MenuItemStyle, b as MenuStyle, P as Padding, S as Shadow, c as SurfaceStyle, T as ThemeStyle, d as Typography } from './theme-style-BVd5tOsc.js';
+import { W as Widget, c as WidgetInstance } from './widget-CpE2HdgU.js';
+export { B as BlockLayout, P as PageData, a as WidgetDefaultSettings, b as WidgetEditorProps, d as WidgetMetadata, e as WidgetProps } from './widget-CpE2HdgU.js';
 export { M as Media, g as getMediaAlt, a as getMediaUrl } from './media-CnLImjVC.js';
-export { P as Page, a as PageSeo } from './page-W3hQga4w.js';
-export { A as Alignment, H as HorizontalAlignment, V as VerticalAlignment } from './alignment-dZDzN96G.js';
+export { P as Page, a as PageSeo } from './page-B5Gmm-Ys.js';
+export { A as Alignment, H as HeadingLevel, a as HorizontalAlignment, R as ResponsiveTextSize, T as TitleSettings, V as VerticalAlignment } from './heading-DQCxQt38.js';
 export { TextEditorContent } from '@frontlit/text-editor';
-export { EditableBlock, EditableBlockProps, PageRenderer, PageRendererProps, generateThemeStyles } from './renderer/index.js';
+export { EditableBlock, EditableBlockProps, PageRenderer, PageRendererProps, generateThemeStyles, resolveThemeColor } from './renderer/index.js';
 export { P as PageBuilderLinkComponent, a as PageBuilderLinkProps, b as PageBuilderLinkProvider } from './nav-link-BfxvQ1s6.js';
 export { BlockPicker, BuilderTopBar, ColorSelector, ContentPaddingSelector, MaxWidthSelector, PATTERN_PRESETS, PageBuilder, PageBuilderPropertyHeader, PageBuilderProps, PageBuilderSlider, PageBuilderState, PatternPreset, PatternPresetCategory, PreviewDevice, SectionBackgroundPanel, SeoEditor, SettingsPanel, ThemeEditor, ThemeEditorProps, VerticalPaddingSelector, getMaxWidthTWClass, getVerticalPaddingTWClass } from './builder/index.js';
 export { DataSlotLoadRequest, DataSlotLoader, DataSlotLoaders, loadDataSlots } from './data-slots.js';
@@ -15,13 +15,16 @@ import 'react';
 import 'lucide-react';
 import './color-mode-DIEEt9WP.js';
 
+/** Blocks placed outside the normal flow by the renderer. */
+declare const LAYOUT_BLOCK_NAMES: string[];
+
 /**
  * Every block available to the page builder, keyed by its
  * `metadata.name`. `header` and `footer` are singleton, layout-level
  * blocks placed outside the normal flow by the renderer.
  */
 declare const blockRegistry: Record<string, Widget<any>>;
-declare const LAYOUT_BLOCK_NAMES: string[];
+
 declare const NON_ADDABLE_BLOCK_NAMES: string[];
 /**
  * Adds a host application's block to the shared renderer and builder
@@ -42,6 +45,10 @@ declare function getAddableBlocks(): Widget<any>[];
  * block's default settings.
  */
 declare function createWidgetInstance(name: string, overrides?: Record<string, unknown>): WidgetInstance;
+/** Fills each block's unset settings with its defaults. Saved layouts omit
+ * settings equal to a default (the renderer merges them back), so the
+ * builder's panels need them filled in to show what's on the canvas. */
+declare function withDefaultSettings(layout: WidgetInstance[]): WidgetInstance[];
 /** Ensures a builder layout always has one locked header and footer.
  * API validation remains the hard boundary; this repair keeps legacy/empty
  * initial layouts usable and prevents the UI from ever presenting a page
@@ -56,4 +63,4 @@ declare function getDefaultTheme(): Theme;
  */
 declare function createDefaultLayout(): WidgetInstance[];
 
-export { LAYOUT_BLOCK_NAMES, NON_ADDABLE_BLOCK_NAMES, Theme, Widget, WidgetInstance, blockRegistry, createDefaultLayout, createWidgetInstance, ensureRequiredSharedWidgets, getAddableBlocks, getDefaultTheme, getWidget, registerBlock };
+export { LAYOUT_BLOCK_NAMES, NON_ADDABLE_BLOCK_NAMES, Theme, Widget, WidgetInstance, blockRegistry, createDefaultLayout, createWidgetInstance, ensureRequiredSharedWidgets, getAddableBlocks, getDefaultTheme, getWidget, registerBlock, withDefaultSettings };

package/dist/index.js

@@ -1,10 +1,11 @@
 "use client";
-import './chunk-RUYOL7JZ.js';
-export { BlockPicker, BuilderTopBar, ColorSelector, ContentPaddingSelector, MaxWidthSelector, PATTERN_PRESETS, PageBuilder, PageBuilderPropertyHeader, PageBuilderSlider, SectionBackgroundPanel, SeoEditor, SettingsPanel, ThemeEditor, VerticalPaddingSelector, createDefaultLayout, createWidgetInstance, ensureRequiredSharedWidgets, getDefaultTheme, getMaxWidthTWClass, getVerticalPaddingTWClass } from './chunk-KQKSLI3L.js';
-export { EditableBlock, LAYOUT_BLOCK_NAMES, NON_ADDABLE_BLOCK_NAMES, PageRenderer, blockRegistry, generateThemeStyles, getAddableBlocks, getWidget, registerBlock } from './chunk-HDINUNI2.js';
-import './chunk-UO7XGBGM.js';
-export { PageBuilderLinkProvider } from './chunk-H4P5MFJI.js';
-import './chunk-SGNRWWG3.js';
+import './chunk-HWOVSHIW.js';
+export { BlockPicker, BuilderTopBar, ColorSelector, ContentPaddingSelector, MaxWidthSelector, PATTERN_PRESETS, PageBuilder, PageBuilderPropertyHeader, PageBuilderSlider, SectionBackgroundPanel, SeoEditor, SettingsPanel, ThemeEditor, VerticalPaddingSelector, createDefaultLayout, createWidgetInstance, ensureRequiredSharedWidgets, getDefaultTheme, getMaxWidthTWClass, getVerticalPaddingTWClass, withDefaultSettings } from './chunk-GIKTOAQS.js';
+export { EditableBlock, LAYOUT_BLOCK_NAMES, NON_ADDABLE_BLOCK_NAMES, PageRenderer, blockRegistry, generateThemeStyles, getAddableBlocks, getWidget, registerBlock, resolveThemeColor } from './chunk-IU4KATI2.js';
+import './chunk-BBI7UHOA.js';
+import './chunk-K4WCLHMS.js';
+export { PageBuilderLinkProvider } from './chunk-36QHCIPM.js';
+import './chunk-J7Z4UW45.js';
 export { getMediaAlt, getMediaUrl } from './chunk-XU7ALPGQ.js';
 export { loadDataSlots } from './chunk-ATNM5JHI.js';
 //# sourceMappingURL=index.js.map

package/dist/models/index.d.ts

@@ -1,8 +1,8 @@
-export { B as BackgroundAttachment, a as BackgroundRepeat, b as BlendMode, S as SectionBackground, c as SectionBackgroundOverlay, T as Theme } from '../section-background-MsdE40Rk.js';
-export { B as Border, C as Colors, a as CustomStyle, D as DisabledStyle, M as MenuItemStyle, b as MenuStyle, P as Padding, S as Shadow, c as SurfaceStyle, T as ThemeStyle, d as Typography } from '../theme-style-Cbl7NM-T.js';
-export { B as BlockLayout, P as PageData, W as Widget, a as WidgetDefaultSettings, b as WidgetEditorProps, c as WidgetInstance, d as WidgetMetadata, e as WidgetProps } from '../widget-B_RoG6se.js';
+export { B as BackgroundAttachment, a as BackgroundRepeat, b as BlendMode, S as SectionBackground, c as SectionBackgroundOverlay, T as Theme } from '../section-background-6V_LCi5e.js';
+export { B as Border, C as Colors, a as CustomStyle, D as DisabledStyle, M as MenuItemStyle, b as MenuStyle, P as Padding, S as Shadow, c as SurfaceStyle, T as ThemeStyle, d as Typography } from '../theme-style-BVd5tOsc.js';
+export { B as BlockLayout, P as PageData, W as Widget, a as WidgetDefaultSettings, b as WidgetEditorProps, c as WidgetInstance, d as WidgetMetadata, e as WidgetProps } from '../widget-CpE2HdgU.js';
 export { M as Media, g as getMediaAlt, a as getMediaUrl } from '../media-CnLImjVC.js';
-export { P as Page, a as PageSeo } from '../page-W3hQga4w.js';
-export { A as Alignment, H as HorizontalAlignment, V as VerticalAlignment } from '../alignment-dZDzN96G.js';
+export { P as Page, a as PageSeo } from '../page-B5Gmm-Ys.js';
+export { A as Alignment, H as HeadingLevel, a as HorizontalAlignment, R as ResponsiveTextSize, T as TitleSettings, V as VerticalAlignment } from '../heading-DQCxQt38.js';
 export { TextEditorContent } from '@frontlit/text-editor';
 import 'react';

package/dist/models/index.js

@@ -1,5 +1,5 @@
 "use client";
-import '../chunk-RUYOL7JZ.js';
+import '../chunk-HWOVSHIW.js';
 export { getMediaAlt, getMediaUrl } from '../chunk-XU7ALPGQ.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{page-W3hQga4w.d.ts → page-B5Gmm-Ys.d.ts}

@@ -1,4 +1,4 @@
-import { c as WidgetInstance } from './widget-B_RoG6se.js';
+import { c as WidgetInstance } from './widget-CpE2HdgU.js';
 import { M as Media } from './media-CnLImjVC.js';
 
 /** Page-level SEO settings, editable from the builder's SEO panel. */

package/dist/primitives/index.d.ts

@@ -1,17 +1,17 @@
 import * as AlertDialogPrimitive from '@radix-ui/react-alert-dialog';
 import * as React$1 from 'react';
 import React__default, { ReactNode } from 'react';
-import { T as ThemeStyle } from '../theme-style-Cbl7NM-T.js';
+import { T as ThemeStyle, d as Typography } from '../theme-style-BVd5tOsc.js';
 import * as AvatarPrimitive from '@radix-ui/react-avatar';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
-export { a as Button, B as ButtonProps } from '../button-Bzt1GDO-.js';
+export { a as Button, B as ButtonProps } from '../button-OLKN3wPf.js';
 import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
 import * as PopoverPrimitive from '@radix-ui/react-popover';
 import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
-import { S as SectionBackground, T as Theme } from '../section-background-MsdE40Rk.js';
+import { S as SectionBackground, T as Theme } from '../section-background-6V_LCi5e.js';
 import * as SelectPrimitive from '@radix-ui/react-select';
 import * as SeparatorPrimitive from '@radix-ui/react-separator';
 import * as SwitchPrimitives from '@radix-ui/react-switch';
@@ -185,13 +185,49 @@ interface DropdownMenuSubContentProps extends React$1.ComponentPropsWithoutRef<t
 declare const DropdownMenuSubContent: React$1.ForwardRefExoticComponent<DropdownMenuSubContentProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const DropdownMenuArrow: React$1.ForwardRefExoticComponent<DropdownMenuPrimitive.DropdownMenuArrowProps & React$1.RefAttributes<SVGSVGElement>>;
 
-declare const Header1: React__default.FC<TypographyProps>;
+interface CodeSnippetProps {
+    code: string;
+    /** Prefix shown before the first line, e.g. "$". Not copied. */
+    prompt?: string;
+    theme?: ThemeStyle;
+    className?: string;
+}
+/**
+ * A command or short code sample in a bordered monospace box with a copy
+ * button — the `curl … | sh` install box of developer-tool landing pages.
+ */
+declare function CodeSnippet({ code, prompt, theme, className }: CodeSnippetProps): React__default.JSX.Element;
+
+type HeadingTag = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "p" | "span" | "div";
+interface HeadingProps extends TypographyProps {
+    /** Element to render. Lets a block pick its heading level independently of its look. */
+    as?: HeadingTag;
+    /**
+     * Font-size classes that override the theme size. Kept apart from
+     * `className` so they are merged before the theme's line-height, which
+     * tailwind-merge would otherwise drop.
+     */
+    sizeClassName?: string;
+}
+/** px size of each Tailwind text size class. */
+declare const TAILWIND_TEXT_PX: Record<string, number>;
+/** CSS `clamp()` growing from `min` px on a phone to `max` px on a desktop. */
+declare function fluidFontSize({ min, max }: {
+    min: number;
+    max: number;
+}): string;
+declare function createHeading(displayName: string, defaultTag: HeadingTag, baseClasses: string, getTypography: (theme?: ThemeStyle) => Typography | undefined): React__default.FC<HeadingProps>;
+
+/** Hero-sized headline, styled separately from section H1s. */
+declare const Display: React$1.FC<HeadingProps>;
+
+declare const Header1: React$1.FC<HeadingProps>;
 
-declare const Header2: React__default.FC<TypographyProps>;
+declare const Header2: React$1.FC<HeadingProps>;
 
-declare const Header3: React__default.FC<TypographyProps>;
+declare const Header3: React$1.FC<HeadingProps>;
 
-declare const Header4: React__default.FC<TypographyProps>;
+declare const Header4: React$1.FC<HeadingProps>;
 
 interface ImageProps extends React__default.ImgHTMLAttributes<HTMLImageElement> {
     src: string;
@@ -252,7 +288,6 @@ interface SectionProps extends React__default.HTMLAttributes<HTMLElement> {
     theme?: ThemeStyle;
     component?: "header" | "footer" | "section";
     background?: SectionBackground;
-    nextTheme?: "dark" | "light";
 }
 declare const Section: React__default.FC<SectionProps>;
 
@@ -328,4 +363,4 @@ interface TooltipContentProps extends React$1.ComponentPropsWithoutRef<typeof To
 }
 declare const TooltipContent: React$1.ForwardRefExoticComponent<TooltipContentProps & React$1.RefAttributes<HTMLDivElement>>;
 
-export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, type AlertDialogContentProps, AlertDialogDescription, type AlertDialogDescriptionProps, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, type AlertDialogProps, AlertDialogTitle, type AlertDialogTitleProps, AlertDialogTrigger, Avatar, AvatarFallback, AvatarImage, type AvatarProps, Badge, type BadgeProps, Caption, Checkbox, type CheckboxProps, Dialog, DialogClose, DialogContent, type DialogContentProps, DialogDescription, type DialogDescriptionProps, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, type DialogProps, DialogTitle, type DialogTitleProps, DialogTrigger, Drawer, DropdownMenu, DropdownMenuArrow, DropdownMenuCheckboxItem, type DropdownMenuCheckboxItemProps, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, DropdownMenuPortal, type DropdownMenuProps, DropdownMenuRadioGroup, DropdownMenuRadioItem, type DropdownMenuRadioItemProps, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, type DropdownMenuSubContentProps, DropdownMenuSubTrigger, DropdownMenuTrigger, Header1, Header2, Header3, Header4, Image, type ImageProps, Input, type InputProps, Label, type LabelProps, Link, type LinkProps, PageCard, PageCardContent, type PageCardContentProps, PageCardHeader, type PageCardHeaderProps, PageCardImage, type PageCardImageProps, type PageCardProps, Popover, PopoverAnchor, PopoverClose, PopoverContent, type PopoverContentProps, PopoverPortal, type PopoverProps, PopoverTrigger, Preheader, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, Section, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, type SelectItemProps, SelectLabel, type SelectProps, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, type SeparatorProps, Subheader1, Subheader2, Switch, type SwitchProps, Text1, Text2, Textarea, type TextareaProps, Tooltip, TooltipContent, type TooltipContentProps, TooltipPortal, type TooltipProps, TooltipProvider, type TooltipProviderProps, TooltipTrigger, themes };
+export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, type AlertDialogContentProps, AlertDialogDescription, type AlertDialogDescriptionProps, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, type AlertDialogProps, AlertDialogTitle, type AlertDialogTitleProps, AlertDialogTrigger, Avatar, AvatarFallback, AvatarImage, type AvatarProps, Badge, type BadgeProps, Caption, Checkbox, type CheckboxProps, CodeSnippet, type CodeSnippetProps, Dialog, DialogClose, DialogContent, type DialogContentProps, DialogDescription, type DialogDescriptionProps, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, type DialogProps, DialogTitle, type DialogTitleProps, DialogTrigger, Display, Drawer, DropdownMenu, DropdownMenuArrow, DropdownMenuCheckboxItem, type DropdownMenuCheckboxItemProps, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, DropdownMenuPortal, type DropdownMenuProps, DropdownMenuRadioGroup, DropdownMenuRadioItem, type DropdownMenuRadioItemProps, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, type DropdownMenuSubContentProps, DropdownMenuSubTrigger, DropdownMenuTrigger, Header1, Header2, Header3, Header4, type HeadingProps, type HeadingTag, Image, type ImageProps, Input, type InputProps, Label, type LabelProps, Link, type LinkProps, PageCard, PageCardContent, type PageCardContentProps, PageCardHeader, type PageCardHeaderProps, PageCardImage, type PageCardImageProps, type PageCardProps, Popover, PopoverAnchor, PopoverClose, PopoverContent, type PopoverContentProps, PopoverPortal, type PopoverProps, PopoverTrigger, Preheader, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, Section, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, type SelectItemProps, SelectLabel, type SelectProps, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, type SeparatorProps, Subheader1, Subheader2, Switch, type SwitchProps, TAILWIND_TEXT_PX, Text1, Text2, Textarea, type TextareaProps, Tooltip, TooltipContent, type TooltipContentProps, TooltipPortal, type TooltipProps, TooltipProvider, type TooltipProviderProps, TooltipTrigger, createHeading, fluidFontSize, themes };

package/dist/primitives/index.js

@@ -1,5 +1,5 @@
 "use client";
-export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, Avatar, AvatarFallback, AvatarImage, Badge, Button2 as Button, Caption, Checkbox, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DropdownMenu, DropdownMenuArrow, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Header1, Header2, Header3, Header4, Image, Input, Label, Link, PageCard, PageCardContent, PageCardHeader, PageCardImage, Popover, PopoverAnchor, PopoverClose, PopoverContent, PopoverPortal, PopoverTrigger, Preheader, RadioGroup, RadioGroupItem, Section, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Subheader1, Subheader2, Switch2 as Switch, Text1, Text2, Textarea, Tooltip, TooltipContent, TooltipPortal, TooltipProvider, TooltipTrigger, themes } from '../chunk-SGNRWWG3.js';
+export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, Avatar, AvatarFallback, AvatarImage, Badge, Button2 as Button, Caption, Checkbox, CodeSnippet, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Display, Drawer, DropdownMenu, DropdownMenuArrow, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Header1, Header2, Header3, Header4, Image, Input, Label, Link, PageCard, PageCardContent, PageCardHeader, PageCardImage, Popover, PopoverAnchor, PopoverClose, PopoverContent, PopoverPortal, PopoverTrigger, Preheader, RadioGroup, RadioGroupItem, Section, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Subheader1, Subheader2, Switch2 as Switch, TAILWIND_TEXT_PX, Text1, Text2, Textarea, Tooltip, TooltipContent, TooltipPortal, TooltipProvider, TooltipTrigger, createHeading, fluidFontSize, themes } from '../chunk-J7Z4UW45.js';
 import '../chunk-XU7ALPGQ.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/renderer/index.d.ts

@@ -1,22 +1,20 @@
 import React__default from 'react';
-import { T as Theme } from '../section-background-MsdE40Rk.js';
-import { c as WidgetInstance, P as PageData } from '../widget-B_RoG6se.js';
+import { T as Theme } from '../section-background-6V_LCi5e.js';
+import { c as WidgetInstance, P as PageData } from '../widget-CpE2HdgU.js';
 import { P as PageBuilderLinkComponent } from '../nav-link-BfxvQ1s6.js';
 export { a as PageBuilderLinkProps, b as PageBuilderLinkProvider } from '../nav-link-BfxvQ1s6.js';
-import '../theme-style-Cbl7NM-T.js';
+import '../theme-style-BVd5tOsc.js';
 
 interface PageRendererProps {
     layout: WidgetInstance[];
     theme: Theme;
-    pageData?: PageData;
+    pageData: PageData;
     /** Optional content rendered between the shared header and footer. */
     children?: React__default.ReactNode;
     /** Host-resolved data keyed by a generic data-slot's configured name. */
     dataSlots?: Record<string, React__default.ReactNode>;
     /** Resolved palette currently painted (`system` is already applied). */
     nextTheme?: "light" | "dark";
-    /** Visitor or preview preference, including follow-the-OS. */
-    themeMode?: "light" | "dark" | "system";
     onThemeModeChange?: (mode: "light" | "dark" | "system") => void;
     /** When true, renders hover controls (edit/move/delete/add) for use inside the builder canvas. */
     editing?: boolean;
@@ -43,7 +41,7 @@ interface PageRendererProps {
  * plain (non-editable) display and, with `editing`, as the live canvas
  * inside the page builder.
  */
-declare function PageRenderer({ layout, theme, pageData, children, dataSlots, nextTheme, themeMode, onThemeModeChange, editing, selectedWidgetId, highlightedWidgetId, onSelectWidget, onMoveWidgetUp, onMoveWidgetDown, onDeleteWidget, onAddWidgetBelow, injectThemeStyles, linkComponent, className, }: PageRendererProps): React__default.JSX.Element;
+declare function PageRenderer({ layout, theme, pageData, children, dataSlots, nextTheme, onThemeModeChange, editing, selectedWidgetId, highlightedWidgetId, onSelectWidget, onMoveWidgetUp, onMoveWidgetDown, onDeleteWidget, onAddWidgetBelow, injectThemeStyles, linkComponent, className, }: PageRendererProps): React__default.JSX.Element;
 
 interface EditableBlockProps {
     children: React__default.ReactNode;
@@ -67,6 +65,12 @@ interface EditableBlockProps {
  */
 declare function EditableBlock({ children, editing, containerRef, selected, highlighted, label, onSelect, onMoveUp, onMoveDown, onDelete, onAddBelow, }: EditableBlockProps): React__default.JSX.Element;
 
+/**
+ * Turns a theme colour into a CSS colour value, or "" when it isn't a
+ * colour we can use. Hex (the stored format) is converted to hsl();
+ * modern CSS colour functions such as `oklch(...)` are passed through.
+ */
+declare function resolveThemeColor(value?: string): string;
 /**
  * Generates full CSS color values for the custom properties every primitive
  * reads. Full colors (rather than bare HSL channels) let the renderer coexist
@@ -78,4 +82,4 @@ declare function EditableBlock({ children, editing, containerRef, selected, high
  */
 declare function generateThemeStyles(theme: Theme, selector?: string): string;
 
-export { EditableBlock, type EditableBlockProps, PageBuilderLinkComponent, PageRenderer, type PageRendererProps, generateThemeStyles };
+export { EditableBlock, type EditableBlockProps, PageBuilderLinkComponent, PageRenderer, type PageRendererProps, generateThemeStyles, resolveThemeColor };

package/dist/renderer/index.js

@@ -1,8 +1,9 @@
 "use client";
-export { EditableBlock, PageRenderer, generateThemeStyles } from '../chunk-HDINUNI2.js';
-import '../chunk-UO7XGBGM.js';
-export { PageBuilderLinkProvider } from '../chunk-H4P5MFJI.js';
-import '../chunk-SGNRWWG3.js';
+export { EditableBlock, PageRenderer, generateThemeStyles, resolveThemeColor } from '../chunk-IU4KATI2.js';
+import '../chunk-BBI7UHOA.js';
+import '../chunk-K4WCLHMS.js';
+export { PageBuilderLinkProvider } from '../chunk-36QHCIPM.js';
+import '../chunk-J7Z4UW45.js';
 import '../chunk-XU7ALPGQ.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{section-background-MsdE40Rk.d.ts → section-background-6V_LCi5e.d.ts}

@@ -1,4 +1,4 @@
-import { T as ThemeStyle } from './theme-style-Cbl7NM-T.js';
+import { T as ThemeStyle } from './theme-style-BVd5tOsc.js';
 
 interface Theme {
     id: string;

package/dist/server/index.d.ts

@@ -0,0 +1,103 @@
+import * as React from 'react';
+import React__default, { ReactNode } from 'react';
+import { T as Theme } from './theme-CF3fIKvw.js';
+import './theme-style-BPaMwk88.js';
+
+/**
+ * A single block placed on a page, as persisted in a page's layout.
+ */
+interface WidgetInstance {
+    widgetId: string;
+    name: string;
+    /** Whether the instance can be removed from its page. */
+    deletable: boolean;
+    /** Whether the instance can be repositioned within its page. */
+    moveable: boolean;
+    shared: boolean;
+    settings?: Record<string, unknown>;
+}
+interface PageData extends Record<string, unknown> {
+    pageType?: string;
+    /** Branding from site settings. Required so a host can't silently drop
+     * it; pass `null` for an unset one. Hosts build these with
+     * `toSiteBranding` from `@frontlit/api-contract`. */
+    siteTitle: string | null;
+    siteSubtitle: string | null;
+    siteLogoUrl: string | null;
+    siteLogoAlt: string | null;
+    /** The page's team (public id) and slug, plus the base URL of FrontLit's
+     * public API — threaded through so blocks that make unauthenticated
+     * public calls (e.g. the email-form block's lead capture, architecture.md
+     * §10.2) know where to send them. Left unset in contexts with no live
+     * backend (e.g. a bare component-library preview), in which case those
+     * blocks degrade to a local-only success state. */
+    teamId?: string;
+    pageSlug?: string;
+    publicApiBaseUrl?: string;
+}
+
+interface ServerPageRendererProps {
+    layout: WidgetInstance[];
+    theme: Theme;
+    pageData: PageData;
+    /** Content rendered between the shared header and footer. */
+    children?: ReactNode;
+    /** Host-resolved data keyed by a generic data-slot's configured name. */
+    dataSlots?: Record<string, ReactNode>;
+    /** Light/dark control for the footer; a client component owned by the host. */
+    themeSwitcher?: ReactNode;
+    /** Extra content inside the themed root (e.g. a fixed "Preview" badge),
+     * so it can use the theme's colours. */
+    overlay?: ReactNode;
+    className?: string;
+}
+/**
+ * Server-component counterpart of `PageRenderer`. Static blocks render on
+ * the server and ship no JavaScript; only the interactive parts (mobile menu,
+ * marquee, forms, copy buttons, links) are client islands.
+ *
+ * Everything crossing into an island must be serialisable, so unlike
+ * `PageRenderer` this takes no callbacks. Dark-mode styling is CSS-driven
+ * (the `dark` class on an ancestor), so no resolved colour mode is needed.
+ */
+declare function ServerPageRenderer({ layout, theme, pageData, children, dataSlots, themeSwitcher, overlay, className, }: ServerPageRendererProps): React.JSX.Element;
+
+interface ImageAttributesInput {
+    src: string;
+    alt: string;
+    sizes?: string;
+    /** Above-the-fold image (e.g. LCP): fetched eagerly at high priority. */
+    priority: boolean;
+}
+/**
+ * Lets a host swap an image's `src`/`srcSet` for its own optimizer's URLs
+ * (e.g. Next.js's `getImageProps`) without this package depending on the
+ * host framework. Return `null` to keep the original URL.
+ */
+type ImageAttributesResolver = (input: ImageAttributesInput) => React__default.ImgHTMLAttributes<HTMLImageElement> | null;
+/**
+ * Registers the host's resolver. Call once at server start-up; renders that
+ * run without one emit the original URL.
+ */
+declare function setImageAttributesResolver(resolver: ImageAttributesResolver | null): void;
+
+/** Context supplied to a host application's data-slot loader. */
+interface DataSlotLoadRequest {
+    /** The slot identifier declared in `instance.settings.slot`. */
+    slot: string;
+    /** The full persisted block configuration. */
+    instance: WidgetInstance;
+    /** Page context supplied by the host renderer. */
+    pageData: PageData;
+}
+/** A host-owned resolver for one named data slot. */
+type DataSlotLoader = (request: DataSlotLoadRequest) => ReactNode | Promise<ReactNode>;
+type DataSlotLoaders = Readonly<Record<string, DataSlotLoader>>;
+/**
+ * Resolves generic data-slot blocks before passing their output to
+ * `PageRenderer`. The page-builder package deliberately does not fetch data
+ * or understand a host application's domain model.
+ */
+declare function loadDataSlots(layout: readonly WidgetInstance[], loaders: DataSlotLoaders, pageData: PageData): Promise<Record<string, ReactNode>>;
+
+export { type DataSlotLoadRequest, type DataSlotLoader, type DataSlotLoaders, type ImageAttributesInput, type ImageAttributesResolver, ServerPageRenderer, type ServerPageRendererProps, loadDataSlots, setImageAttributesResolver };