npm - @arbidocs/blocks - Versions diffs - 0.3.111 → 0.3.112 - Mend

@arbidocs/blocks 0.3.111 → 0.3.112

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/index.d.ts CHANGED Viewed

@@ -2,11 +2,11 @@ import { UseBoundStore, StoreApi } from 'zustand';
 import * as react from 'react';
 import react__default, { ReactNode } from 'react';
 import * as _arbidocs_react from '@arbidocs/react';
-import { AiRunOptions, useArbi } from '@arbidocs/react';
+import { AiRunOptions, useArbi, AiTaskStatus } from '@arbidocs/react';
 export { AiRunOptions, AiTaskStatus, ArtifactEvent, SearchChunk, Table, TableBody, TableCell, TableHead, TableHeader, TableRow, redlineStats, textToArtifact, toRedlineMarkdown } from '@arbidocs/react';
 import { ColDef, GridOptions, GridApi, CellValueChangedEvent, GridState } from 'ag-grid-community';
 import { LucideIcon } from 'lucide-react';
-import { Config, CustomField, Field, ComponentConfig } from '@measured/puck';
+import { Data, Config, CustomField, Field, ComponentConfig } from '@measured/puck';
 /**
  * The reusable AI-native law-firm prompt library.
@@ -37,7 +37,7 @@ declare function matterToContext(m: {
 }): MatterContext;
 /** Firm voice for the prompt library — everything firm-specific lives here. */
 interface PromptConfig {
-    /** The firm's name, e.g. "Clarum". */
+    /** The firm's name, e.g. "Acme Legal". */
     firmName: string;
     /** The legal system adjective used throughout, e.g. "English". */
     jurisdiction?: string;
@@ -127,20 +127,20 @@ declare function createPromptLibrary(config: PromptConfig): {
 };
 /**
- * The theme-token model for the legal vertical. Firm-agnostic: the token
- * *catalog*, default values and presets are supplied by the firm (via
- * {@link createThemeStore}); this module owns the shared types and the logic for
- * writing tokens onto the live document.
+ * The theme-token model. Firm-agnostic: the token *catalog*, default values and
+ * presets are supplied by the consuming app (via {@link createThemeStore}); this
+ * module owns the shared types and the logic for writing tokens onto the live
+ * document.
  *
- * There are two emit models, selected per-firm by {@link ThemeEmitMode}:
+ * There are two emit models, selected per-app by {@link ThemeEmitMode}:
  *
- * - `'flat'` (default — Clarum): each colour key is written as an inline
- *   `--color-<key>` custom property on `<html>`, plus `--font-*` / `--radius`.
- *   Inline styles override the compiled `@theme` defaults, so an edit previews
- *   live across the whole app (and the @arbidocs AI kit) and reverts cleanly.
- *   Firms whose CSS sets `--color-*` HEX directly (Clarum) rely on this.
+ * - `'flat'` (default): each colour key is written as an inline `--color-<key>`
+ *   custom property on `<html>`, plus `--font-*` / `--radius`. Inline styles
+ *   override the compiled `@theme` defaults, so an edit previews live across the
+ *   whole app (and the @arbidocs AI kit) and reverts cleanly. Apps whose CSS sets
+ *   `--color-*` HEX directly rely on this.
  *
- * - `'cssVars'` (the ARBI monolith): each colour key is written as a raw
+ * - `'cssVars'`: each colour key is written as a raw
  *   HSL-triplet custom property (`--<key>: <h s l>`) into an injected
  *   `<style id="arbi-theme-vars">` appended to `<head>`. The monolith's source
  *   of truth is HSL triplets wrapped as `hsl(var(--x))`, with a real `.dark`
@@ -176,7 +176,7 @@ interface ThemePreset {
 /** How a theme is written onto the document. See the module doc for the models. */
 type ThemeEmitMode = 'flat' | 'cssVars';
 interface ApplyThemeOptions {
-    /** Emit model. Defaults to `'flat'` (Clarum's behaviour). */
+    /** Emit model. Defaults to `'flat'`. */
     mode?: ThemeEmitMode;
     /**
      * `cssVars` mode only: dark-variant colour values keyed by token key. Emitted
@@ -250,9 +250,9 @@ interface ThemeStoreConfig {
     storageKey: string;
     /**
      * How edits are written onto the document. Defaults to `'flat'` (inline
-     * `--color-*`, Clarum). `'cssVars'` emits raw HSL-triplet vars into an injected
-     * `<style>` so the app's own `hsl(var(--x))` indirection + `.dark` variant
-     * survive (the ARBI monolith). See {@link applyThemeVars}.
+     * `--color-*`). `'cssVars'` emits raw HSL-triplet vars into an injected
+     * `<style>` so an app's own `hsl(var(--x))` indirection + `.dark` variant
+     * survive. See {@link applyThemeVars}.
      */
     mode?: ThemeEmitMode;
     /**
@@ -623,13 +623,15 @@ declare function PageHeader({ title, eyebrow, description, actions, className, t
 }): react.JSX.Element;
 /** Editorial heading block for marketing sections: eyebrow + title + lead. */
-declare function SectionHeading({ eyebrow, title, lead, align, className, invert, }: {
+declare function SectionHeading({ eyebrow, title, lead, align, className, invert, eyebrowClassName, }: {
     eyebrow?: string;
     title: string;
     lead?: string;
     align?: 'left' | 'center';
     className?: string;
     invert?: boolean;
+    /** Override the eyebrow styling (e.g. a firm brand accent). Default: token classes. */
+    eyebrowClassName?: string;
 }): react.JSX.Element;
 /** Search + filter bar used above every list view. */
@@ -653,8 +655,12 @@ interface MetricCardProps {
         direction: 'up' | 'down';
         good?: boolean;
     };
-    /** Icon accent, keyed to the firm's brand token contract. */
-    accent?: 'ink' | 'emerald' | 'brass';
+    /**
+     * Icon accent as a theme colour-token key (e.g. `primary`, `success`, or a
+     * firm's own brand token). Resolved to `var(--color-<accent>)` at render, so
+     * it themes with whatever firm consumes it. `'default'` inherits `foreground`.
+     */
+    accent?: string;
     testId?: string;
 }
 /** The one true KPI tile. Used across every dashboard and module header. */
@@ -667,6 +673,8 @@ interface BlockImageProps {
     alt?: string;
     aspect?: BlockImageAspect;
     rounded?: BlockImageRounded;
+    /** Editorial "photo frame" treatment: a matte border ring + soft shadow. */
+    framed?: boolean;
     className?: string;
     testId?: string;
 }
@@ -675,7 +683,7 @@ interface BlockImageProps {
  * token-clean gradient placeholder (no network needed) so the palette always looks
  * good in the editor and in demos. Token-only classes so it themes per firm.
  */
-declare function BlockImage({ src, alt, aspect, rounded, className, testId, }: BlockImageProps): react.JSX.Element;
+declare function BlockImage({ src, alt, aspect, rounded, framed, className, testId, }: BlockImageProps): react.JSX.Element;
 type HeroTone = 'default' | 'muted' | 'ink';
 type HeroAlign = 'left' | 'center';
@@ -686,16 +694,25 @@ interface HeroCta {
 interface HeroProps {
     eyebrow?: string;
     title: string;
+    /** A word/phrase within the title to accent (rendered in the primary colour). */
+    emphasis?: string;
     subtitle?: string;
     primaryCta?: HeroCta;
     secondaryCta?: HeroCta;
     align?: HeroAlign;
     tone?: HeroTone;
+    /** Side visual (ignored when `backgroundImage` is set). */
     imageUrl?: string;
+    /** Full-bleed background image URL/data-URI. Turns the hero into a cover band. */
+    backgroundImage?: string;
+    /** Darkening scrim over the background image, for legible copy. Default true. */
+    overlay?: boolean;
+    /** Override the eyebrow styling (e.g. a firm brand accent). Default: token classes. */
+    eyebrowClassName?: string;
     testId?: string;
 }
 /** Editorial marketing hero: eyebrow, headline, subtitle, two CTAs and a visual. */
-declare function Hero({ eyebrow, title, subtitle, primaryCta, secondaryCta, align, tone, imageUrl, testId, }: HeroProps): react.JSX.Element;
+declare function Hero({ eyebrow, title, emphasis, subtitle, primaryCta, secondaryCta, align, tone, imageUrl, backgroundImage, overlay, eyebrowClassName, testId, }: HeroProps): react.JSX.Element;
 interface FeatureItem {
     icon?: LucideIcon;
@@ -740,10 +757,14 @@ interface CTABannerProps {
         href?: string;
     };
     tone?: CTABannerTone;
+    /** Full-bleed background image URL/data-URI. Overrides the tone surface. */
+    backgroundImage?: string;
+    /** Darkening scrim over the background image. Default true. */
+    overlay?: boolean;
     testId?: string;
 }
 /** Full-width call-to-action banner. */
-declare function CTABanner({ title, subtitle, cta, tone, testId }: CTABannerProps): react.JSX.Element;
+declare function CTABanner({ title, subtitle, cta, tone, backgroundImage, overlay, testId, }: CTABannerProps): react.JSX.Element;
 interface LogoItem {
     label: string;
@@ -877,6 +898,170 @@ interface ContainerProps {
 /** Max-width wrapper that centres and pads a nested Puck slot. */
 declare function Container({ width, padding, children, testId }: ContainerProps): react.JSX.Element;
+interface PricingPlan {
+    name: string;
+    price: string;
+    period?: string;
+    description?: string;
+    features?: string[];
+    cta?: {
+        label?: string;
+        href?: string;
+    };
+    /** Highlight this plan as the recommended one. */
+    featured?: boolean;
+}
+interface PricingTableProps {
+    plans: PricingPlan[];
+    testId?: string;
+}
+/** A row of pricing plan cards with feature lists and a CTA per plan. */
+declare function PricingTable({ plans, testId }: PricingTableProps): react.JSX.Element;
+interface TabItem {
+    label: string;
+    content: string;
+}
+interface TabsProps {
+    items: TabItem[];
+    testId?: string;
+}
+/** A simple tabbed panel: a row of tab buttons over the active tab's content. */
+declare function Tabs({ items, testId }: TabsProps): react.JSX.Element;
+interface AccordionItem {
+    title: string;
+    content: string;
+}
+interface AccordionProps {
+    items: AccordionItem[];
+    /** Allow multiple panels open at once. Default false (single-open). */
+    allowMultiple?: boolean;
+    testId?: string;
+}
+/** A stack of collapsible title/content panels. */
+declare function Accordion({ items, allowMultiple, testId }: AccordionProps): react.JSX.Element;
+interface GalleryImage {
+    src?: string;
+    alt?: string;
+    caption?: string;
+}
+interface GalleryProps {
+    images: GalleryImage[];
+    columns?: '2' | '3' | '4';
+    aspect?: BlockImageProps['aspect'];
+    rounded?: BlockImageProps['rounded'];
+    testId?: string;
+}
+/** A responsive image grid. Each tile previews via BlockImage with a caption. */
+declare function Gallery({ images, columns, aspect, rounded, testId, }: GalleryProps): react.JSX.Element;
+type VideoAspect = '16:9' | '4:3' | '1:1';
+interface VideoEmbedProps {
+    /** A YouTube / Vimeo / Loom page URL, or a direct video file URL. */
+    url: string;
+    title?: string;
+    aspect?: VideoAspect;
+    rounded?: boolean;
+    testId?: string;
+}
+/**
+ * Resolve a shareable video URL to an embeddable iframe src. Supports YouTube,
+ * Vimeo and Loom; returns null for anything else (rendered as a `<video>`).
+ */
+declare function toEmbedUrl(url: string): string | null;
+/** Embed a video from a YouTube/Vimeo/Loom link or a direct file, in a set aspect. */
+declare function VideoEmbed({ url, title, aspect, rounded, testId, }: VideoEmbedProps): react.JSX.Element;
+interface ContactField {
+    name: string;
+    label: string;
+    type?: 'text' | 'email' | 'tel' | 'textarea';
+    required?: boolean;
+}
+interface ContactFormProps {
+    fields: ContactField[];
+    submitLabel?: string;
+    /** Optional POST endpoint. When set, the form submits natively to it. */
+    action?: string;
+    /** Message shown after a client-side (no-action) submit. */
+    successMessage?: string;
+    testId?: string;
+}
+/** A configurable lead/contact form. Posts to `action`, or confirms client-side. */
+declare function ContactForm({ fields, submitLabel, action, successMessage, testId, }: ContactFormProps): react.JSX.Element;
+type BannerTone = 'primary' | 'muted' | 'ink';
+interface BannerProps {
+    text: string;
+    cta?: {
+        label?: string;
+        href?: string;
+    };
+    tone?: BannerTone;
+    testId?: string;
+}
+/** A slim full-width announcement strip with optional inline CTA. */
+declare function Banner({ text, cta, tone, testId }: BannerProps): react.JSX.Element;
+interface MediaTextProps {
+    eyebrow?: string;
+    title: string;
+    body?: string;
+    imageUrl?: string;
+    /** Which side the media sits on (desktop). */
+    mediaSide?: 'left' | 'right';
+    cta?: {
+        label?: string;
+        href?: string;
+    };
+    testId?: string;
+}
+/** A split media-and-copy row: an image on one side, prose + CTA on the other. */
+declare function MediaText({ eyebrow, title, body, imageUrl, mediaSide, cta, testId, }: MediaTextProps): react.JSX.Element;
+interface TeamMember {
+    name: string;
+    role?: string;
+    bio?: string;
+    avatarUrl?: string;
+}
+interface TeamGridProps {
+    members: TeamMember[];
+    columns?: '2' | '3' | '4';
+    testId?: string;
+}
+/** A grid of people cards: avatar, name, role and an optional short bio. */
+declare function TeamGrid({ members, columns, testId }: TeamGridProps): react.JSX.Element;
+interface StepItem {
+    title: string;
+    description?: string;
+}
+interface StepsProps {
+    steps: StepItem[];
+    /** `timeline` draws a connected vertical rail; `numbered` is a horizontal grid. */
+    variant?: 'numbered' | 'timeline';
+    testId?: string;
+}
+/** A process / how-it-works sequence, as numbered cards or a vertical timeline. */
+declare function Steps({ steps, variant, testId }: StepsProps): react.JSX.Element;
+interface TestimonialItem {
+    quote: string;
+    author?: string;
+    role?: string;
+    avatarUrl?: string;
+}
+interface TestimonialGridProps {
+    items: TestimonialItem[];
+    columns?: '2' | '3';
+    testId?: string;
+}
+/** A grid of multiple pull-quote testimonials. */
+declare function TestimonialGrid({ items, columns, testId }: TestimonialGridProps): react.JSX.Element;
 /**
  * Navigation shapes shared by firm app shells. The concrete nav manifest (which
  * modules, in what order) is per-firm data the app supplies; these interfaces
@@ -918,8 +1103,16 @@ interface LoadResult<T> {
 }
 /** The save/load surface the studio + renderer consume. */
 interface StudioPersistence {
+    /** Persist the authoring layout for a slug (image values stay `asset:` refs). */
     savePage: (arbi: Arbi | null, live: boolean, slug: string, data: unknown) => Promise<PersistVia>;
     loadPage: <T>(arbi: Arbi | null, live: boolean, slug: string) => Promise<LoadResult<T>>;
+    /**
+     * Persist the **published** layout for a slug — a self-contained copy whose
+     * asset refs have been materialized to `data:` URIs, so the unauthenticated
+     * public renderer can paint it. The public renderer reads this, not savePage's.
+     */
+    savePublished: (arbi: Arbi | null, live: boolean, slug: string, data: unknown) => Promise<PersistVia>;
+    loadPublished: <T>(arbi: Arbi | null, live: boolean, slug: string) => Promise<LoadResult<T>>;
     saveTheme: (arbi: Arbi | null, live: boolean, theme: unknown) => Promise<PersistVia>;
     loadTheme: <T>(arbi: Arbi | null, live: boolean) => Promise<LoadResult<T>>;
 }
@@ -930,6 +1123,45 @@ type BuildPrompt = (a: {
     current: string;
 }) => string;
+/**
+ * Publish-time asset materialization.
+ *
+ * While authoring, an image is stored as a workspace **asset ref**
+ * (`asset:<docId>`) — resolvable only inside the authenticated Studio. The
+ * public marketing renderer has no auth token, so a published page must be
+ * **self-contained**: every asset ref is replaced with a directly-renderable
+ * source before the page is saved for the public.
+ *
+ * The default {@link createArbiMaterializer} downloads each asset once and
+ * inlines it as a `data:` URI — the bytes travel *inside* the published JSON,
+ * so nothing is fetched, served or auth-gated at render time (no backend). A
+ * consumer that prefers a CDN/static host can pass a `publishAsset` hook that
+ * uploads the bytes and returns a URL instead; that is purely a payload-size
+ * optimization and keeps this package firm- and backend-agnostic.
+ */
+/** Resolve a workspace document ext_id to a public-renderable src, or null. */
+type AssetMaterializer = (docId: string) => Promise<string | null>;
+interface MaterializeOptions {
+    /**
+     * Optional sink: given a doc id + its bytes, store them somewhere public and
+     * return the URL. When omitted, bytes are inlined as a `data:` URI (no backend).
+     */
+    publishAsset?: (docId: string, blob: Blob) => Promise<string>;
+}
+/**
+ * A materializer backed by the authenticated Arbi client: download the asset,
+ * then either hand it to `publishAsset` or inline it as a data URI. Any failure
+ * resolves to `null` so a single broken asset never fails the whole publish.
+ */
+declare function createArbiMaterializer(arbi: Arbi, opts?: MaterializeOptions): AssetMaterializer;
+/**
+ * Return a copy of `data` with every `asset:<docId>` ref replaced by its
+ * materialized source. Each distinct ref is resolved exactly once; a ref that
+ * fails to resolve is left untouched (it simply won't paint for the public).
+ */
+declare function materializePageData(data: Data, materialize: AssetMaterializer): Promise<Data>;
 interface StudioEditorProps {
     config: Config;
     pages: readonly StudioPageMeta[];
@@ -942,8 +1174,14 @@ interface StudioEditorProps {
     live: boolean;
     initialSlug?: string;
     testIdPrefix?: string;
+    /**
+     * Optional sink for published image bytes. When omitted, publishing inlines
+     * each asset as a `data:` URI (self-contained, no backend). Provide this to
+     * upload bytes to a CDN/static host and return a URL instead.
+     */
+    publishAsset?: MaterializeOptions['publishAsset'];
 }
-declare function StudioEditor({ config, pages, persistence, themeBundle, defaultTheme, brandLabel, backHref, backLabel, live, initialSlug, testIdPrefix, }: StudioEditorProps): react.JSX.Element;
+declare function StudioEditor({ config, pages, persistence, themeBundle, defaultTheme, brandLabel, backHref, backLabel, live, initialSlug, testIdPrefix, publishAsset, }: StudioEditorProps): react.JSX.Element;
 interface PageRendererProps {
     config: Config;
@@ -964,7 +1202,7 @@ interface StudioPersistenceConfig {
     workspaceId: string;
     /** Folder inside the workspace where studio artefacts live. */
     folder?: string;
-    /** Prefix for the localStorage mirror keys (e.g. "clarum-studio-"). */
+    /** Prefix for the localStorage mirror keys (e.g. "studio-"). */
     storagePrefix: string;
     /** localStorage key for the theme mirror (default `${storagePrefix}theme`). */
     themeStorageKey?: string;
@@ -972,6 +1210,8 @@ interface StudioPersistenceConfig {
     themeFileName?: string;
     /** File name for a page's persisted document (default `${slug}.json`). */
     pageFileName?: (slug: string) => string;
+    /** File name for a page's published document (default `${slug}.published.json`). */
+    publishedFileName?: (slug: string) => string;
 }
 declare function createStudioPersistence(cfg: StudioPersistenceConfig): StudioPersistence;
@@ -991,12 +1231,68 @@ interface AiFields {
 }
 declare function createAiFields(cfg: AiFieldsConfig): AiFields;
+interface ImageFieldConfig {
+    /** The workspace uploads/generations are saved to, and assets are picked from. */
+    workspaceId: string;
+    /** Folder for uploaded/authored assets. Default "assets". */
+    folder?: string;
+    /** Testid namespace. Default "studio". */
+    testIdPrefix?: string;
+}
+interface ImageFieldFactory {
+    imageField: (label: string) => CustomField<string>;
+}
+/** Build the image field, closing over the firm's workspace + testid prefix. */
+declare function createImageField(cfg: ImageFieldConfig): ImageFieldFactory;
+interface UseImageGen {
+    /** ext_id of the most recently generated image document (null until one exists). */
+    docExtId: string | null;
+    /** Underlying task status: 'idle' | 'running' | 'done' | 'error'. */
+    status: AiTaskStatus;
+    /** Human-readable failure message, or null. */
+    error: string | null;
+    /** True while a generation is in flight. */
+    isGenerating: boolean;
+    /**
+     * Generate an image from a prompt. Resolves with the new image document's
+     * ext_id, or null when the prompt is empty or no image was produced.
+     */
+    generate: (prompt: string) => Promise<string | null>;
+    /** Clear the current result and error. */
+    reset: () => void;
+}
+declare function useImageGen(): UseImageGen;
+/** Marks a stored image value as a workspace asset ref rather than a URL. */
+declare const ASSET_REF_PREFIX = "asset:";
+/** Wrap a workspace document ext_id as a storable asset ref. */
+declare function asAssetRef(docId: string): string;
+/** The workspace document ext_id behind an asset ref (`asset:doc-1` → `doc-1`). */
+declare function assetRefId(src: string): string;
+declare function AssetResolverProvider({ children }: {
+    children: ReactNode;
+}): react.JSX.Element;
+declare function useAssetResolverActive(): boolean;
+/**
+ * Is `src` a workspace asset ref (`asset:<docId>`) rather than an already-
+ * renderable URL / `data:` URI? Only prefixed refs need resolution.
+ */
+declare function isAssetRef(src: string | undefined): src is string;
+type SectionTone = 'default' | 'muted' | 'ink';
+type SectionPadding = 'none' | 'sm' | 'md' | 'lg';
+type SectionWidth = 'narrow' | 'default' | 'wide' | 'full';
 interface SectionProps {
     children: ReactNode;
-    tone?: 'default' | 'muted' | 'ink';
+    tone?: SectionTone;
+    padding?: SectionPadding;
+    maxWidth?: SectionWidth;
+    /** Subtle grain/texture overlay in the current text colour (editorial surfaces). */
+    texture?: boolean;
     className?: string;
 }
-declare function Section({ children, tone, className }: SectionProps): react.JSX.Element;
+declare function Section({ children, tone, padding, maxWidth, texture, className, }: SectionProps): react.JSX.Element;
 /**
  * Shared field helpers for the block registry. Every block config — the built-ins
@@ -1013,6 +1309,8 @@ interface BlockKit {
     textField: (label: string, placeholder?: string) => Field;
     /** Multi-line copy: AI-authorable when a firm supplies aiFields, else plain textarea. */
     textareaField: (label: string, placeholder?: string, kind?: string) => Field;
+    /** Image source: a workspace-asset picker when a firm supplies imageField, else a URL input. */
+    imageField: (label: string) => Field;
     /** A Yes/No radio. */
     boolRadio: (label: string) => Field;
     /** A `select` over {@link iconMap} names. */
@@ -1021,9 +1319,15 @@ interface BlockKit {
     resolveIcon: (name?: string) => LucideIcon | undefined;
     /** Stable, e2e-locatable testid derived from a block's Puck id. */
     blockTestId: (id: string) => string;
+    /**
+     * Optional firm override for the eyebrow style on heading-bearing blocks
+     * (Hero, Section heading). Lets a consumer render a brand accent (e.g. a brass
+     * eyebrow) without forking the blocks. Undefined → the default token classes.
+     */
+    eyebrowClassName?: string;
 }
-/** Build the shared field helpers, closing over the firm's optional AI fields. */
-declare function createBlockKit(ai?: AiFields): BlockKit;
+/** Build the shared field helpers, closing over the firm's optional AI + image fields. */
+declare function createBlockKit(ai?: AiFields, image?: (label: string) => Field, eyebrowClassName?: string): BlockKit;
 interface ArbiBlocksConfigOptions {
     /**
@@ -1031,6 +1335,28 @@ interface ArbiBlocksConfigOptions {
      * prop becomes an AI-authorable field; when absent, plain Puck text inputs.
      */
     aiFields?: AiFields;
+    /**
+     * Firm image field from {@link createImageField}. When present, image props
+     * become a workspace-asset picker (pick / upload / URL / generate); when absent,
+     * a plain URL text input.
+     */
+    imageField?: (label: string) => Field;
+    /**
+     * Page canvas overrides. The builder paints every page inside this root; a
+     * consumer sets e.g. a dark editorial canvas without forking the package.
+     * Defaults to `bg-background text-foreground font-sans` on a neutral wrapper.
+     */
+    root?: {
+        /** Extra classes appended to (and able to override) the default canvas classes. */
+        className?: string;
+        /** testid for the page root wrapper. Defaults to `arbi-blocks-page-root`. */
+        testId?: string;
+    };
+    /**
+     * Firm override for the eyebrow style on heading-bearing blocks (Hero, Section
+     * heading) — e.g. a brand accent like a brass eyebrow. Undefined → token default.
+     */
+    eyebrowClassName?: string;
 }
 declare function createArbiBlocksConfig(opts?: ArbiBlocksConfigOptions): Config;
@@ -1038,6 +1364,20 @@ declare function createArbiBlocksConfig(opts?: ArbiBlocksConfigOptions): Config;
 /** Build every website block, closing over the shared field {@link BlockKit}. */
 declare function createWebsiteBlocks(kit: BlockKit): Record<string, ComponentConfig>;
+/**
+ * The extended site-building block set — the richer vocabulary a builder needs to
+ * assemble arbitrary sites beyond the marketing basics: pricing, tabs, accordion,
+ * gallery, video, contact form, banner, split media, team, steps and a
+ * multi-testimonial grid.
+ *
+ * Same contract as {@link createWebsiteBlocks}: serializable-only props, semantic
+ * tokens (themes with the firm), a stable render-time `data-testid`, and sensible
+ * defaults so each block looks right the moment it is dropped. Copy props route
+ * through the shared {@link BlockKit} AI-or-plain fields.
+ */
+declare function createSiteBlocks(kit: BlockKit): Record<string, ComponentConfig>;
 /**
  * Module registry types — a typed model of a firm's back-office modules,
  * derived from its canonical nav. The builder toggles/reorders these; the
@@ -1210,4 +1550,4 @@ interface AgentsPanelProps {
 }
 declare function AgentsPanel({ store, testIdPrefix }: AgentsPanelProps): react.JSX.Element;
-export { type AgentSelectionStore, AgentsPanel, type AgentsPanelProps, type AiFields, type AiFieldsConfig, type AppNavItem, type AppNavSection, type ApplyThemeOptions, type ArbiBlocksConfigOptions, type ArbiMode, type ArbiUser, type AssistantCitation, type AssistantMessage, type AssistantStep, AvatarBlock, type AvatarBlockProps, BlockImage, type BlockImageProps, type BlockKit, type BuildPrompt, type BuilderModule, CTABanner, type CTABannerProps, Callout, type CalloutProps, type CalloutVariant, type ColorToken, type Column, Columns, type ColumnsProps, ConnectionProvider, type ConnectionStatus, Container, type ContainerProps, DataTable, DataTableBlock, type DataTableBlockColumn, type DataTableBlockProps, EmptyState, type ExportedModule, FAQ, type FAQProps, type FaqItem, FeatureGrid, type FeatureGridProps, type FeatureItem, type FirmArbiConfig, Footer, type FooterColumn, type FooterLink, type FooterProps, GridView, type GridViewEmptyState, type GridViewProps, type GridViewSelection, Hero, type HeroCta, type HeroProps, LegalArbiProvider, ListBlock, type ListBlockProps, type ListItem, type LoadResult, LogoCloud, type LogoCloudProps, type LogoItem, type MatterContext, MetricCard, type MetricCardProps, ModuleManager, type ModuleManagerProps, type ModuleRegistry, type ModuleStoreBundle, type NavLink, Navbar, type NavbarProps, PageHeader, PageRenderer, type PageRendererProps, type PersistVia, type PromptConfig, type PromptLibrary, type Prompts, type ResolvedModule, RichTextBlock, type RichTextBlockProps, Section, SectionHeading, type SectionProps, Spacer, type SpacerProps, StatGroup, type StatGroupProps, type StatItem, StudioEditor, type StudioEditorProps, type StudioPageMeta, type StudioPersistence, type StudioPersistenceConfig, THEME_STYLE_ID, Testimonial, type TestimonialProps, type ThemeBundle, ThemeEditor, type ThemeEditorProps, type ThemeEmitMode, type ThemeFonts, type ThemePreset, type ThemeState, type ThemeStoreConfig, type ThemeTokens, Toolbar, VerticalBuilder, type VerticalBuilderProps, type VerticalConfig, type VerticalExport, type VerticalExportConfig, applyStoredTheme, applyThemeVars, clearThemeVars, createAgentSelectionStore, createAiFields, createArbiBlocksConfig, createBlockKit, createModuleRegistry, createModuleStore, createPromptLibrary, createStudioPersistence, createThemeStore, createVerticalExport, createWebsiteBlocks, daysUntil, fmtDate, fmtDateTime, fromNow, gbp, hrs, iconMap, initials, isAuthenticated, matterToContext, pct, tid, toHslTriplet, useConnection, useFirmAiTask, useSemanticSearch, useWorkspaceDocs };
+export { ASSET_REF_PREFIX, Accordion, type AccordionItem, type AccordionProps, type AgentSelectionStore, AgentsPanel, type AgentsPanelProps, type AiFields, type AiFieldsConfig, type AppNavItem, type AppNavSection, type ApplyThemeOptions, type ArbiBlocksConfigOptions, type ArbiMode, type ArbiUser, type AssetMaterializer, AssetResolverProvider, type AssistantCitation, type AssistantMessage, type AssistantStep, AvatarBlock, type AvatarBlockProps, Banner, type BannerProps, type BannerTone, BlockImage, type BlockImageProps, type BlockKit, type BuildPrompt, type BuilderModule, CTABanner, type CTABannerProps, Callout, type CalloutProps, type CalloutVariant, type ColorToken, type Column, Columns, type ColumnsProps, ConnectionProvider, type ConnectionStatus, type ContactField, ContactForm, type ContactFormProps, Container, type ContainerProps, DataTable, DataTableBlock, type DataTableBlockColumn, type DataTableBlockProps, EmptyState, type ExportedModule, FAQ, type FAQProps, type FaqItem, FeatureGrid, type FeatureGridProps, type FeatureItem, type FirmArbiConfig, Footer, type FooterColumn, type FooterLink, type FooterProps, Gallery, type GalleryImage, type GalleryProps, GridView, type GridViewEmptyState, type GridViewProps, type GridViewSelection, Hero, type HeroCta, type HeroProps, type ImageFieldConfig, type ImageFieldFactory, LegalArbiProvider, ListBlock, type ListBlockProps, type ListItem, type LoadResult, LogoCloud, type LogoCloudProps, type LogoItem, type MaterializeOptions, type MatterContext, MediaText, type MediaTextProps, MetricCard, type MetricCardProps, ModuleManager, type ModuleManagerProps, type ModuleRegistry, type ModuleStoreBundle, type NavLink, Navbar, type NavbarProps, PageHeader, PageRenderer, type PageRendererProps, type PersistVia, type PricingPlan, PricingTable, type PricingTableProps, type PromptConfig, type PromptLibrary, type Prompts, type ResolvedModule, RichTextBlock, type RichTextBlockProps, Section, SectionHeading, type SectionProps, Spacer, type SpacerProps, StatGroup, type StatGroupProps, type StatItem, type StepItem, Steps, type StepsProps, StudioEditor, type StudioEditorProps, type StudioPageMeta, type StudioPersistence, type StudioPersistenceConfig, THEME_STYLE_ID, type TabItem, Tabs, type TabsProps, TeamGrid, type TeamGridProps, type TeamMember, Testimonial, TestimonialGrid, type TestimonialGridProps, type TestimonialItem, type TestimonialProps, type ThemeBundle, ThemeEditor, type ThemeEditorProps, type ThemeEmitMode, type ThemeFonts, type ThemePreset, type ThemeState, type ThemeStoreConfig, type ThemeTokens, Toolbar, type UseImageGen, VerticalBuilder, type VerticalBuilderProps, type VerticalConfig, type VerticalExport, type VerticalExportConfig, type VideoAspect, VideoEmbed, type VideoEmbedProps, applyStoredTheme, applyThemeVars, asAssetRef, assetRefId, clearThemeVars, createAgentSelectionStore, createAiFields, createArbiBlocksConfig, createArbiMaterializer, createBlockKit, createImageField, createModuleRegistry, createModuleStore, createPromptLibrary, createSiteBlocks, createStudioPersistence, createThemeStore, createVerticalExport, createWebsiteBlocks, daysUntil, fmtDate, fmtDateTime, fromNow, gbp, hrs, iconMap, initials, isAssetRef, isAuthenticated, materializePageData, matterToContext, pct, tid, toEmbedUrl, toHslTriplet, useAssetResolverActive, useConnection, useFirmAiTask, useImageGen, useSemanticSearch, useWorkspaceDocs };