@templatical/types 0.9.1 → 0.10.1

package/dist/index.d.ts

@@ -1,197 +1,191 @@
+//#region src/blocks.d.ts
 interface SpacingValue {
-    top: number;
-    right: number;
-    bottom: number;
-    left: number;
-}
-interface ResponsiveStyles {
-    tablet?: Partial<BlockStyles>;
-    mobile?: Partial<BlockStyles>;
+  top: number;
+  right: number;
+  bottom: number;
+  left: number;
 }
 interface BlockStyles {
-    padding: SpacingValue;
-    margin: SpacingValue;
-    backgroundColor?: string;
-    responsive?: ResponsiveStyles;
+  padding: SpacingValue;
+  backgroundColor?: string;
 }
 interface BlockVisibility {
-    desktop: boolean;
-    tablet: boolean;
-    mobile: boolean;
+  desktop: boolean;
+  mobile: boolean;
 }
 interface BaseBlock {
-    id: string;
-    type: string;
-    styles: BlockStyles;
-    customCss?: string;
-    visibility?: BlockVisibility;
-    displayCondition?: {
-        label: string;
-        before: string;
-        after: string;
-        group?: string;
-        description?: string;
-    };
+  id: string;
+  type: string;
+  styles: BlockStyles;
+  visibility?: BlockVisibility;
+  displayCondition?: {
+    label: string;
+    before: string;
+    after: string;
+    group?: string;
+    description?: string;
+  };
 }
 type ColumnLayout = "1" | "2" | "3" | "2-1" | "1-2";
 interface SectionBlock extends BaseBlock {
-    type: "section";
-    columns: ColumnLayout;
-    children: Block[][];
+  type: "section";
+  columns: ColumnLayout;
+  children: Block[][];
 }
 type HeadingLevel = 1 | 2 | 3 | 4;
 declare const HEADING_LEVEL_FONT_SIZE: Record<HeadingLevel, number>;
 interface TitleBlock extends BaseBlock {
-    type: "title";
-    content: string;
-    level: HeadingLevel;
-    color: string;
-    textAlign: "left" | "center" | "right";
-    fontFamily?: string;
+  type: "title";
+  content: string;
+  level: HeadingLevel;
+  color: string;
+  textAlign: "left" | "center" | "right";
+  fontFamily?: string;
 }
 interface ParagraphBlock extends BaseBlock {
-    type: "paragraph";
-    content: string;
+  type: "paragraph";
+  content: string;
 }
 interface ImageBlock extends BaseBlock {
-    type: "image";
-    src: string;
-    alt: string;
-    width: number | "full";
-    align: "left" | "center" | "right";
-    linkUrl?: string;
-    linkOpenInNewTab?: boolean;
-    placeholderUrl?: string;
-    decorative?: boolean;
+  type: "image";
+  src: string;
+  alt: string;
+  width: number | "full";
+  align: "left" | "center" | "right";
+  linkUrl?: string;
+  linkOpenInNewTab?: boolean;
+  placeholderUrl?: string;
+  decorative?: boolean;
 }
 interface ButtonBlock extends BaseBlock {
-    type: "button";
-    text: string;
-    url: string;
-    openInNewTab?: boolean;
-    backgroundColor: string;
-    textColor: string;
-    borderRadius: number;
-    fontSize: number;
-    buttonPadding: SpacingValue;
-    fontFamily?: string;
+  type: "button";
+  text: string;
+  url: string;
+  openInNewTab?: boolean;
+  backgroundColor: string;
+  textColor: string;
+  borderRadius: number;
+  fontSize: number;
+  buttonPadding: SpacingValue;
+  fontFamily?: string;
 }
 interface DividerBlock extends BaseBlock {
-    type: "divider";
-    lineStyle: "solid" | "dashed" | "dotted";
-    color: string;
-    thickness: number;
-    width: number | "full";
+  type: "divider";
+  lineStyle: "solid" | "dashed" | "dotted";
+  color: string;
+  thickness: number;
+  width: number | "full";
 }
 interface VideoBlock extends BaseBlock {
-    type: "video";
-    url: string;
-    openInNewTab?: boolean;
-    thumbnailUrl: string;
-    alt: string;
-    width: number | "full";
-    align: "left" | "center" | "right";
-    placeholderUrl?: string;
+  type: "video";
+  url: string;
+  openInNewTab?: boolean;
+  thumbnailUrl: string;
+  alt: string;
+  width: number | "full";
+  align: "left" | "center" | "right";
+  placeholderUrl?: string;
 }
 type SocialPlatform = "facebook" | "twitter" | "instagram" | "linkedin" | "youtube" | "tiktok" | "pinterest" | "email" | "whatsapp" | "telegram" | "discord" | "snapchat" | "reddit" | "github" | "dribbble" | "behance";
 type SocialIconStyle = "solid" | "outlined" | "rounded" | "square" | "circle";
 type SocialIconSize = "small" | "medium" | "large";
 interface SocialIcon {
-    id: string;
-    platform: SocialPlatform;
-    url: string;
+  id: string;
+  platform: SocialPlatform;
+  url: string;
 }
 interface SocialIconsBlock extends BaseBlock {
-    type: "social";
-    icons: SocialIcon[];
-    iconStyle: SocialIconStyle;
-    iconSize: SocialIconSize;
-    spacing: number;
-    align: "left" | "center" | "right";
+  type: "social";
+  icons: SocialIcon[];
+  iconStyle: SocialIconStyle;
+  iconSize: SocialIconSize;
+  spacing: number;
+  align: "left" | "center" | "right";
 }
 interface SpacerBlock extends BaseBlock {
-    type: "spacer";
-    height: number;
+  type: "spacer";
+  height: number;
 }
 interface HtmlBlock extends BaseBlock {
-    type: "html";
-    content: string;
+  type: "html";
+  content: string;
 }
 interface MenuItemData {
-    id: string;
-    text: string;
-    url: string;
-    openInNewTab: boolean;
-    bold: boolean;
-    underline: boolean;
-    color?: string;
+  id: string;
+  text: string;
+  url: string;
+  openInNewTab: boolean;
+  bold: boolean;
+  underline: boolean;
+  color?: string;
 }
 interface MenuBlock extends BaseBlock {
-    type: "menu";
-    items: MenuItemData[];
-    fontSize: number;
-    fontFamily?: string;
-    color: string;
-    linkColor?: string;
-    textAlign: "left" | "center" | "right";
-    separator: string;
-    separatorColor: string;
-    spacing: number;
+  type: "menu";
+  items: MenuItemData[];
+  fontSize: number;
+  fontFamily?: string;
+  color: string;
+  linkColor?: string;
+  textAlign: "left" | "center" | "right";
+  separator: string;
+  separatorColor: string;
+  spacing: number;
 }
 interface TableCellData {
-    id: string;
-    content: string;
+  id: string;
+  content: string;
 }
 interface TableRowData {
-    id: string;
-    cells: TableCellData[];
+  id: string;
+  cells: TableCellData[];
 }
 interface TableBlock extends BaseBlock {
-    type: "table";
-    rows: TableRowData[];
-    hasHeaderRow: boolean;
-    headerBackgroundColor?: string;
-    borderColor: string;
-    borderWidth: number;
-    cellPadding: number;
-    fontSize: number;
-    fontFamily?: string;
-    color: string;
-    textAlign: "left" | "center" | "right";
+  type: "table";
+  rows: TableRowData[];
+  hasHeaderRow: boolean;
+  headerBackgroundColor?: string;
+  borderColor: string;
+  borderWidth: number;
+  cellPadding: number;
+  fontSize: number;
+  fontFamily?: string;
+  color: string;
+  textAlign: "left" | "center" | "right";
 }
 interface CountdownBlock extends BaseBlock {
-    type: "countdown";
-    targetDate: string;
-    timezone: string;
-    showDays: boolean;
-    showHours: boolean;
-    showMinutes: boolean;
-    showSeconds: boolean;
-    separator: ":" | "-" | " ";
-    digitFontSize: number;
-    digitColor: string;
-    labelColor: string;
-    labelFontSize: number;
-    backgroundColor: string;
-    fontFamily?: string;
-    labelDays: string;
-    labelHours: string;
-    labelMinutes: string;
-    labelSeconds: string;
-    expiredMessage: string;
-    expiredImageUrl: string;
-    hideOnExpiry: boolean;
+  type: "countdown";
+  targetDate: string;
+  timezone: string;
+  showDays: boolean;
+  showHours: boolean;
+  showMinutes: boolean;
+  showSeconds: boolean;
+  separator: ":" | "-" | " ";
+  digitFontSize: number;
+  digitColor: string;
+  labelColor: string;
+  labelFontSize: number;
+  backgroundColor: string;
+  fontFamily?: string;
+  labelDays: string;
+  labelHours: string;
+  labelMinutes: string;
+  labelSeconds: string;
+  expiredMessage: string;
+  expiredImageUrl: string;
+  hideOnExpiry: boolean;
 }
 interface CustomBlock extends BaseBlock {
-    type: "custom";
-    customType: string;
-    fieldValues: Record<string, unknown>;
-    renderedHtml?: string;
-    dataSourceFetched?: boolean;
+  type: "custom";
+  customType: string;
+  fieldValues: Record<string, unknown>;
+  renderedHtml?: string;
+  dataSourceFetched?: boolean;
 }
 type Block = SectionBlock | TitleBlock | ParagraphBlock | ImageBlock | ButtonBlock | DividerBlock | VideoBlock | SocialIconsBlock | SpacerBlock | HtmlBlock | MenuBlock | TableBlock | CountdownBlock | CustomBlock;
 type BlockType = Block["type"];
-
+//#endregion
+//#region src/guards.d.ts
 declare function isSection(block: Block): block is SectionBlock;
 declare function isTitle(block: Block): block is TitleBlock;
 declare function isParagraph(block: Block): block is ParagraphBlock;
@@ -206,22 +200,23 @@ declare function isMenu(block: Block): block is MenuBlock;
 declare function isTable(block: Block): block is TableBlock;
 declare function isCountdown(block: Block): block is CountdownBlock;
 declare function isCustomBlock(block: Block): block is CustomBlock;
-
+//#endregion
+//#region src/defaults.d.ts
 type BlockDefaultsFor<T> = Partial<Omit<T, "id" | "type">>;
 interface BlockDefaults {
-    title?: BlockDefaultsFor<TitleBlock>;
-    paragraph?: BlockDefaultsFor<ParagraphBlock>;
-    image?: BlockDefaultsFor<ImageBlock>;
-    button?: BlockDefaultsFor<ButtonBlock>;
-    divider?: BlockDefaultsFor<DividerBlock>;
-    section?: BlockDefaultsFor<SectionBlock>;
-    video?: BlockDefaultsFor<VideoBlock>;
-    social?: BlockDefaultsFor<SocialIconsBlock>;
-    spacer?: BlockDefaultsFor<SpacerBlock>;
-    html?: BlockDefaultsFor<HtmlBlock>;
-    menu?: BlockDefaultsFor<MenuBlock>;
-    table?: BlockDefaultsFor<TableBlock>;
-    countdown?: BlockDefaultsFor<CountdownBlock>;
+  title?: BlockDefaultsFor<TitleBlock>;
+  paragraph?: BlockDefaultsFor<ParagraphBlock>;
+  image?: BlockDefaultsFor<ImageBlock>;
+  button?: BlockDefaultsFor<ButtonBlock>;
+  divider?: BlockDefaultsFor<DividerBlock>;
+  section?: BlockDefaultsFor<SectionBlock>;
+  video?: BlockDefaultsFor<VideoBlock>;
+  social?: BlockDefaultsFor<SocialIconsBlock>;
+  spacer?: BlockDefaultsFor<SpacerBlock>;
+  html?: BlockDefaultsFor<HtmlBlock>;
+  menu?: BlockDefaultsFor<MenuBlock>;
+  table?: BlockDefaultsFor<TableBlock>;
+  countdown?: BlockDefaultsFor<CountdownBlock>;
 }
 type TemplateDefaults = Partial<TemplateSettings>;
 declare const TITLE_BLOCK_DEFAULTS: BlockDefaultsFor<TitleBlock>;
@@ -240,95 +235,129 @@ declare const COUNTDOWN_BLOCK_DEFAULTS: BlockDefaultsFor<CountdownBlock>;
 declare const DEFAULT_BLOCK_DEFAULTS: Required<BlockDefaults>;
 declare const DEFAULT_TEMPLATE_DEFAULTS: TemplateDefaults;
 declare function deepMergeDefaults<T extends object>(base: T, overrides: Partial<T>): T;
-
+//#endregion
+//#region src/template.d.ts
 interface TemplateSettings {
-    width: number;
-    backgroundColor: string;
-    fontFamily: string;
-    preheaderText?: string;
-    /**
-     * BCP-47 language code for the rendered email's `<html lang>`. Drives
-     * screen-reader pronunciation. Default `'en'` via `DEFAULT_TEMPLATE_DEFAULTS`.
-     */
-    locale: string;
+  width: number;
+  backgroundColor: string;
+  fontFamily: string;
+  preheaderText?: string;
+  /**
+   * BCP-47 language code for the rendered email's `<html lang>`. Drives
+   * screen-reader pronunciation. Default `'en'` via `DEFAULT_TEMPLATE_DEFAULTS`.
+   */
+  locale: string;
 }
 interface TemplateContent {
-    blocks: Block[];
-    settings: TemplateSettings;
+  blocks: Block[];
+  settings: TemplateSettings;
 }
 declare function createDefaultTemplateContent(defaultFontFamily?: string, templateDefaults?: TemplateDefaults): TemplateContent;
-
-/** @see https://templatical.com/docs/v1/custom-blocks */
+//#endregion
+//#region src/custom-blocks.d.ts
 type CustomBlockFieldType = "text" | "textarea" | "image" | "color" | "number" | "select" | "boolean" | "repeatable";
 interface CustomBlockFieldBase {
-    key: string;
-    label: string;
-    required?: boolean;
-    placeholder?: string;
-    readOnly?: boolean;
+  key: string;
+  label: string;
+  required?: boolean;
+  placeholder?: string;
+  readOnly?: boolean;
 }
 interface CustomBlockTextField extends CustomBlockFieldBase {
-    type: "text";
-    default?: string;
+  type: "text";
+  default?: string;
 }
 interface CustomBlockTextareaField extends CustomBlockFieldBase {
-    type: "textarea";
-    default?: string;
+  type: "textarea";
+  default?: string;
 }
 interface CustomBlockImageField extends CustomBlockFieldBase {
-    type: "image";
-    default?: string;
+  type: "image";
+  default?: string;
 }
 interface CustomBlockColorField extends CustomBlockFieldBase {
-    type: "color";
-    default?: string;
+  type: "color";
+  default?: string;
 }
 interface CustomBlockNumberField extends CustomBlockFieldBase {
-    type: "number";
-    default?: number;
-    min?: number;
-    max?: number;
-    step?: number;
+  type: "number";
+  default?: number;
+  min?: number;
+  max?: number;
+  step?: number;
 }
 interface SelectOption {
-    label: string;
-    value: string;
+  label: string;
+  value: string;
 }
 interface CustomBlockSelectField extends CustomBlockFieldBase {
-    type: "select";
-    options: SelectOption[];
-    default?: string;
+  type: "select";
+  options: SelectOption[];
+  default?: string;
 }
 interface CustomBlockBooleanField extends CustomBlockFieldBase {
-    type: "boolean";
-    default?: boolean;
+  type: "boolean";
+  default?: boolean;
 }
 interface CustomBlockRepeatableField extends CustomBlockFieldBase {
-    type: "repeatable";
-    fields: Exclude<CustomBlockField, CustomBlockRepeatableField>[];
-    default?: Record<string, unknown>[];
-    minItems?: number;
-    maxItems?: number;
+  type: "repeatable";
+  fields: Exclude<CustomBlockField, CustomBlockRepeatableField>[];
+  default?: Record<string, unknown>[];
+  minItems?: number;
+  maxItems?: number;
 }
 type CustomBlockField = CustomBlockTextField | CustomBlockTextareaField | CustomBlockImageField | CustomBlockColorField | CustomBlockNumberField | CustomBlockSelectField | CustomBlockBooleanField | CustomBlockRepeatableField;
 interface CustomBlockDefinition {
-    type: string;
-    name: string;
-    icon?: string;
-    description?: string;
-    fields: CustomBlockField[];
-    template: string;
-    dataSource?: DataSourceConfig;
+  type: string;
+  name: string;
+  icon?: string;
+  description?: string;
+  fields: CustomBlockField[];
+  template: string;
+  dataSource?: DataSourceConfig;
+  /**
+   * Default block styles applied when a new instance of this custom block is
+   * created. Deep-merged over the built-in defaults — only specify the fields
+   * you want to override. Controls both the editor canvas wrapper and the
+   * rendered MJML/email output.
+   *
+   * @example
+   * defaultStyles: {
+   *   padding: { top: 0, right: 0, bottom: 0, left: 0 },
+   * }
+   */
+  defaultStyles?: Partial<BlockStyles>;
+  /**
+   * Optional CSS rules attached to this custom block definition. Emitted once
+   * (deduped across instances) into `<mj-head><mj-style>…</mj-style></mj-head>`
+   * in the rendered MJML, and adopted into the editor canvas (shadow root or
+   * light-DOM mount) so authored responsive/hover/font behavior previews
+   * inside the editor.
+   *
+   * Use this for media queries, hover states, or any CSS that should apply
+   * once per definition rather than per block instance. Class names are not
+   * scoped by the SDK — namespace them yourself (e.g. `.tplc-<type>-<el>`) to
+   * avoid collisions with other definitions or built-in editor styles.
+   *
+   * @example
+   * stylesheet: `
+   *   @media (max-width: 480px) {
+   *     .tplc-image-text-cell { display: block !important; width: 100% !important; }
+   *   }
+   * `
+   */
+  stylesheet?: string;
 }
 interface DataSourceFetchContext {
-    fieldValues: Record<string, unknown>;
-    blockId: string;
+  fieldValues: Record<string, unknown>;
+  blockId: string;
 }
 interface DataSourceConfig {
-    label: string;
-    onFetch: (context: DataSourceFetchContext) => Promise<Record<string, unknown> | null>;
+  label: string;
+  onFetch: (context: DataSourceFetchContext) => Promise<Record<string, unknown> | null>;
 }
-
+//#endregion
+//#region src/factory.d.ts
 declare function generateId(): string;
 declare function createTitleBlock(partial?: Partial<TitleBlock>): TitleBlock;
 declare function createParagraphBlock(partial?: Partial<ParagraphBlock>): ParagraphBlock;
@@ -346,114 +375,117 @@ declare function createCountdownBlock(partial?: Partial<CountdownBlock>): Countd
 declare function createCustomBlock(definition: CustomBlockDefinition): CustomBlock;
 declare function createBlock(type: BlockType, blockDefaults?: BlockDefaults): Block;
 declare function cloneBlock(block: Block): Block;
-
+//#endregion
+//#region src/events.d.ts
 declare class EventEmitter<TEvents extends Record<string, unknown> = Record<string, unknown>> {
-    private handlers;
-    on<K extends keyof TEvents>(event: K, handler: (data: TEvents[K]) => void): () => void;
-    off<K extends keyof TEvents>(event: K, handler: (data: TEvents[K]) => void): void;
-    emit<K extends keyof TEvents>(event: K, data: TEvents[K]): void;
-    removeAllListeners(event?: keyof TEvents): void;
-    listenerCount(event: keyof TEvents): number;
-}
-
-type ViewportSize = "desktop" | "tablet" | "mobile";
+  private handlers;
+  on<K extends keyof TEvents>(event: K, handler: (data: TEvents[K]) => void): () => void;
+  off<K extends keyof TEvents>(event: K, handler: (data: TEvents[K]) => void): void;
+  emit<K extends keyof TEvents>(event: K, data: TEvents[K]): void;
+  removeAllListeners(event?: keyof TEvents): void;
+  listenerCount(event: keyof TEvents): number;
+}
+//#endregion
+//#region src/config.d.ts
+type ViewportSize = "desktop" | "mobile";
 type UiTheme = "light" | "dark" | "auto";
 interface CustomFont {
-    name: string;
-    url: string;
-    fallback?: string;
+  name: string;
+  url: string;
+  fallback?: string;
 }
 interface FontsConfig {
-    defaultFallback?: string;
-    defaultFont?: string;
-    customFonts?: CustomFont[];
+  defaultFallback?: string;
+  defaultFont?: string;
+  customFonts?: CustomFont[];
 }
 interface ExportResult {
-    html: string;
-    mjml: string;
+  html: string;
+  mjml: string;
 }
 interface MergeTag {
-    label: string;
-    value: string;
-    /**
-     * Optional grouping label used by the built-in merge tag picker to
-     * section the list. When no tag in the configured array carries
-     * `group`, the picker renders a plain flat list with no headers.
-     * Ignored by the renderer and by typing-autocomplete.
-     */
-    group?: string;
-    /**
-     * Optional helper text shown beneath the tag in the built-in merge
-     * tag picker. Not rendered anywhere else (toolbar, autocomplete,
-     * MJML output) and not stored on the inserted document node.
-     */
-    description?: string;
+  label: string;
+  value: string;
+  /**
+   * Optional grouping label used by the built-in merge tag picker to
+   * section the list. When no tag in the configured array carries
+   * `group`, the picker renders a plain flat list with no headers.
+   * Ignored by the renderer and by typing-autocomplete.
+   */
+  group?: string;
+  /**
+   * Optional helper text shown beneath the tag in the built-in merge
+   * tag picker. Not rendered anywhere else (toolbar, autocomplete,
+   * MJML output) and not stored on the inserted document node.
+   */
+  description?: string;
 }
 interface MediaResult {
-    url: string;
-    alt?: string;
+  url: string;
+  alt?: string;
 }
 interface MergeTagsConfig {
-    syntax?: SyntaxPresetName | SyntaxPreset;
-    tags?: MergeTag[];
-    onRequest?: () => Promise<MergeTag | null>;
-    /**
-     * Enables typing-based autocomplete in rich text fields. When the user
-     * types the syntax opener (e.g. `{{`), a popup lists matching `tags`.
-     *
-     * Defaults to `true`. Effective only when `tags` is non-empty AND
-     * `syntax` matches a built-in preset (custom regex syntaxes cannot be
-     * mapped to a trigger string and silently disable autocomplete).
-     */
-    autocomplete?: boolean;
+  syntax?: SyntaxPresetName | SyntaxPreset;
+  tags?: MergeTag[];
+  onRequest?: () => Promise<MergeTag | null>;
+  /**
+   * Enables typing-based autocomplete in rich text fields. When the user
+   * types the syntax opener (e.g. `{{`), a popup lists matching `tags`.
+   *
+   * Defaults to `true`. Effective only when `tags` is non-empty AND
+   * `syntax` matches a built-in preset (custom regex syntaxes cannot be
+   * mapped to a trigger string and silently disable autocomplete).
+   */
+  autocomplete?: boolean;
 }
 interface DisplayCondition {
-    label: string;
-    before: string;
-    after: string;
-    group?: string;
-    description?: string;
+  label: string;
+  before: string;
+  after: string;
+  group?: string;
+  description?: string;
 }
 interface DisplayConditionsConfig {
-    conditions: DisplayCondition[];
-    allowCustom?: boolean;
+  conditions: DisplayCondition[];
+  allowCustom?: boolean;
 }
 interface ThemeOverrides {
-    bg?: string;
-    bgElevated?: string;
-    bgHover?: string;
-    bgActive?: string;
-    border?: string;
-    borderLight?: string;
-    text?: string;
-    textMuted?: string;
-    textDim?: string;
-    primary?: string;
-    primaryHover?: string;
-    primaryLight?: string;
-    secondary?: string;
-    secondaryHover?: string;
-    secondaryLight?: string;
-    success?: string;
-    successLight?: string;
-    warning?: string;
-    warningLight?: string;
-    danger?: string;
-    dangerLight?: string;
-    canvasBg?: string;
-    dark?: Omit<ThemeOverrides, "dark">;
+  bg?: string;
+  bgElevated?: string;
+  bgHover?: string;
+  bgActive?: string;
+  border?: string;
+  borderLight?: string;
+  text?: string;
+  textMuted?: string;
+  textDim?: string;
+  primary?: string;
+  primaryHover?: string;
+  primaryLight?: string;
+  secondary?: string;
+  secondaryHover?: string;
+  secondaryLight?: string;
+  success?: string;
+  successLight?: string;
+  warning?: string;
+  warningLight?: string;
+  danger?: string;
+  dangerLight?: string;
+  canvasBg?: string;
+  dark?: Omit<ThemeOverrides, "dark">;
 }
 declare class SdkError extends Error {
-    readonly statusCode?: number | undefined;
-    constructor(message: string, statusCode?: number | undefined);
-    get isNotFound(): boolean;
-    get isUnauthorized(): boolean;
-    get isServerError(): boolean;
-}
-
+  readonly statusCode?: number | undefined;
+  constructor(message: string, statusCode?: number | undefined);
+  get isNotFound(): boolean;
+  get isUnauthorized(): boolean;
+  get isServerError(): boolean;
+}
+//#endregion
+//#region src/merge-tags.d.ts
 interface SyntaxPreset {
-    value: RegExp;
-    logic: RegExp;
+  value: RegExp;
+  logic: RegExp;
 }
 type SyntaxPresetName = "liquid" | "handlebars" | "mailchimp" | "ampscript";
 declare const SYNTAX_PRESETS: Record<SyntaxPresetName, SyntaxPreset>;
@@ -472,331 +504,334 @@ declare function restoreMergeTagMarkup(html: string, mergeTags: MergeTag[], synt
 declare function isLogicMergeTagValue(value: string, syntax: SyntaxPreset): boolean;
 declare function getLogicMergeTagKeyword(value: string, syntax: SyntaxPreset): string;
 declare function resolveHtmlLogicMergeTagLabels(html: string, syntax: SyntaxPreset): string;
-
+//#endregion
+//#region ../media-library/src/types.d.ts
 type MediaCategory = "images" | "documents" | "videos" | "audio";
 interface MediaItem {
-    id: string;
-    filename: string;
-    mime_type: string;
-    size: number;
-    url: string;
-    small_url: string | null;
-    medium_url: string | null;
-    large_url: string | null;
-    folder_id: string | null;
-    conversions_generated: boolean;
-    width: number | null;
-    height: number | null;
-    alt_text: string;
-    created_at: string;
-    updated_at: string;
+  id: string;
+  filename: string;
+  mime_type: string;
+  size: number;
+  url: string;
+  small_url: string | null;
+  medium_url: string | null;
+  large_url: string | null;
+  folder_id: string | null;
+  conversions_generated: boolean;
+  width: number | null;
+  height: number | null;
+  alt_text: string;
+  created_at: string;
+  updated_at: string;
 }
 interface MediaRequestContext {
-    accept?: MediaCategory[];
+  accept?: MediaCategory[];
 }
 interface StorageInfo {
-    used_bytes: number;
-    limit_bytes: number;
+  used_bytes: number;
+  limit_bytes: number;
 }
 interface MediaCategoryData {
-    mime_types: string[];
-    extensions: string[];
+  mime_types: string[];
+  extensions: string[];
 }
 interface MediaConfig {
-    use_media_library: boolean;
-    categories: Record<string, MediaCategoryData>;
-    max_file_size: number;
+  use_media_library: boolean;
+  categories: Record<string, MediaCategoryData>;
+  max_file_size: number;
 }
-
+//#endregion
+//#region src/cloud.d.ts
 interface Template {
-    id: string;
-    content: TemplateContent;
+  id: string;
+  content: TemplateContent;
 }
 interface TemplateSnapshot {
-    id: string;
-    template_id: string;
-    content: TemplateContent;
-    is_autosave: boolean;
-    created_at: string;
+  id: string;
+  template_id: string;
+  content: TemplateContent;
+  is_autosave: boolean;
+  created_at: string;
 }
 interface Comment {
-    id: string;
-    template_id: string;
-    block_id: string | null;
-    parent_id: string | null;
-    body: string;
-    author_identifier: string;
-    author_name: string;
-    resolved_at: string | null;
-    resolved_by_identifier: string | null;
-    resolved_by_name: string | null;
-    created_at: string;
-    updated_at: string;
-    replies: Comment[];
+  id: string;
+  template_id: string;
+  block_id: string | null;
+  parent_id: string | null;
+  body: string;
+  author_identifier: string;
+  author_name: string;
+  resolved_at: string | null;
+  resolved_by_identifier: string | null;
+  resolved_by_name: string | null;
+  created_at: string;
+  updated_at: string;
+  replies: Comment[];
 }
 type CommentThread = Comment;
 type CommentEventType = "created" | "updated" | "deleted" | "resolved" | "unresolved";
 interface CommentEvent {
-    type: CommentEventType;
-    comment: Comment;
+  type: CommentEventType;
+  comment: Comment;
 }
 interface SavedModule {
-    id: string;
-    name: string;
-    content: Block[];
-    created_at: string;
-    updated_at: string;
+  id: string;
+  name: string;
+  content: Block[];
+  created_at: string;
+  updated_at: string;
 }
 type FindingSeverity = "high" | "medium" | "low";
 type ScoringCategory = "spam" | "readability" | "accessibility" | "bestPractices";
 interface ScoringFinding {
-    id: string;
-    severity: FindingSeverity;
-    message: string;
-    blockId: string | null;
-    category: ScoringCategory;
-    suggestion: string;
+  id: string;
+  severity: FindingSeverity;
+  message: string;
+  blockId: string | null;
+  category: ScoringCategory;
+  suggestion: string;
 }
 interface CategoryScore {
-    score: number;
-    findings: ScoringFinding[];
+  score: number;
+  findings: ScoringFinding[];
 }
 interface ScoringResult {
-    score: number;
-    categories: Record<ScoringCategory, CategoryScore>;
+  score: number;
+  categories: Record<ScoringCategory, CategoryScore>;
 }
 interface HealthCheckResult {
-    api: {
-        ok: boolean;
-        latency: number;
-    };
-    websocket: {
-        ok: boolean;
-        error?: string;
-    };
-    auth: {
-        ok: boolean;
-        error?: string;
-    };
-    overall: boolean;
+  api: {
+    ok: boolean;
+    latency: number;
+  };
+  websocket: {
+    ok: boolean;
+    error?: string;
+  };
+  auth: {
+    ok: boolean;
+    error?: string;
+  };
+  overall: boolean;
 }
 interface TokenData {
-    token: string;
-    expires_at: number;
-    project_id: string;
-    tenant: string;
-    test_email?: {
-        allowed_emails: string[];
-        signature: string;
-    };
-    user?: {
-        id: string;
-        name: string;
-        signature: string;
-    };
+  token: string;
+  expires_at: number;
+  project_id: string;
+  tenant: string;
+  test_email?: {
+    allowed_emails: string[];
+    signature: string;
+  };
+  user?: {
+    id: string;
+    name: string;
+    signature: string;
+  };
 }
 interface AuthRequestOptions {
-    method?: "GET" | "POST";
-    headers?: Record<string, string>;
-    body?: Record<string, unknown>;
-    credentials?: RequestCredentials;
+  method?: "GET" | "POST";
+  headers?: Record<string, string>;
+  body?: Record<string, unknown>;
+  credentials?: RequestCredentials;
 }
 interface AuthConfig {
-    url: string;
-    baseUrl?: string;
-    requestOptions?: AuthRequestOptions;
-    onError?: (error: Error) => void;
+  url: string;
+  baseUrl?: string;
+  requestOptions?: AuthRequestOptions;
+  onError?: (error: Error) => void;
 }
 interface TestEmailConfig {
-    allowedEmails: string[];
-    signature: string;
+  allowedEmails: string[];
+  signature: string;
 }
 interface UserConfig {
-    id: string;
-    name: string;
-    signature: string;
+  id: string;
+  name: string;
+  signature: string;
 }
 interface DirectAuthConfig {
-    mode: "direct";
-    clientId: string;
-    clientSecret: string;
-    tenant: string;
-    baseUrl?: string;
+  mode: "direct";
+  clientId: string;
+  clientSecret: string;
+  tenant: string;
+  baseUrl?: string;
 }
 interface ProxyAuthConfig {
-    mode: "proxy";
-    url: string;
-    baseUrl?: string;
-    requestOptions?: AuthRequestOptions;
+  mode: "proxy";
+  url: string;
+  baseUrl?: string;
+  requestOptions?: AuthRequestOptions;
 }
 type SdkAuthConfig = DirectAuthConfig | ProxyAuthConfig;
 interface Collaborator {
-    id: string;
-    name: string;
-    color: string;
-    selectedBlockId: string | null;
+  id: string;
+  name: string;
+  color: string;
+  selectedBlockId: string | null;
 }
 type McpOperation = "add_block" | "update_block" | "delete_block" | "move_block" | "update_settings" | "set_content" | "update_block_style";
 interface McpOperationPayload {
-    operation: McpOperation;
-    data: Record<string, unknown>;
-    timestamp: number;
+  operation: McpOperation;
+  data: Record<string, unknown>;
+  timestamp: number;
 }
 interface SaveResult {
-    templateId: string;
-    html: string;
-    mjml: string;
-    content: TemplateContent;
+  templateId: string;
+  html: string;
+  mjml: string;
+  content: TemplateContent;
 }
 interface AiConfig {
-    chat?: boolean;
-    scoring?: boolean;
-    designToTemplate?: boolean;
-    rewrite?: boolean;
+  chat?: boolean;
+  scoring?: boolean;
+  designToTemplate?: boolean;
+  rewrite?: boolean;
 }
 interface McpConfig {
-    enabled: boolean;
-    onOperation?: (payload: McpOperationPayload) => void;
+  enabled: boolean;
+  onOperation?: (payload: McpOperationPayload) => void;
 }
 interface CollaborationConfig {
-    enabled: boolean;
-    onCollaboratorJoined?: (collaborator: Collaborator) => void;
-    onCollaboratorLeft?: (collaborator: Collaborator) => void;
-    onBlockLocked?: (event: {
-        blockId: string;
-        collaborator: Collaborator;
-    }) => void;
-    onBlockUnlocked?: (event: {
-        blockId: string;
-        collaborator: Collaborator;
-    }) => void;
+  enabled: boolean;
+  onCollaboratorJoined?: (collaborator: Collaborator) => void;
+  onCollaboratorLeft?: (collaborator: Collaborator) => void;
+  onBlockLocked?: (event: {
+    blockId: string;
+    collaborator: Collaborator;
+  }) => void;
+  onBlockUnlocked?: (event: {
+    blockId: string;
+    collaborator: Collaborator;
+  }) => void;
 }
 interface WebSocketServerConfig {
-    host: string;
-    port: number;
-    app_key: string;
+  host: string;
+  port: number;
+  app_key: string;
 }
 interface TemplaticalConfig {
-    container: string | HTMLElement;
-    auth: Omit<AuthConfig, "onError">;
-    baseUrl?: string;
-    theme?: ThemeOverrides;
-    locale?: string;
-    ai?: AiConfig | false;
-    onCreate?: (template: Template) => void;
-    onLoad?: (template: Template) => void;
-    onSave?: (result: SaveResult) => void;
-    onError?: (error: Error) => void;
-    onUnmount?: () => void;
-    mergeTags?: MergeTagsConfig;
-    onRequestMedia?: (context: MediaRequestContext) => Promise<MediaItem | null>;
-    displayConditions?: DisplayConditionsConfig;
-    fonts?: FontsConfig;
-    autoSave?: boolean;
-    autoSaveDebounce?: number;
-    onBeforeTestEmail?: (html: string) => string | Promise<string>;
-    customBlocks?: CustomBlockDefinition[];
-    commenting?: boolean;
-    onComment?: (event: CommentEvent) => void;
-    mcp?: McpConfig;
-    collaboration?: CollaborationConfig;
-    modules?: boolean;
+  container: string | HTMLElement;
+  auth: Omit<AuthConfig, "onError">;
+  baseUrl?: string;
+  theme?: ThemeOverrides;
+  locale?: string;
+  ai?: AiConfig | false;
+  onCreate?: (template: Template) => void;
+  onLoad?: (template: Template) => void;
+  onSave?: (result: SaveResult) => void;
+  onError?: (error: Error) => void;
+  onUnmount?: () => void;
+  mergeTags?: MergeTagsConfig;
+  onRequestMedia?: (context: MediaRequestContext) => Promise<MediaItem | null>;
+  displayConditions?: DisplayConditionsConfig;
+  fonts?: FontsConfig;
+  autoSave?: boolean;
+  autoSaveDebounce?: number;
+  onBeforeTestEmail?: (html: string) => string | Promise<string>;
+  customBlocks?: CustomBlockDefinition[];
+  commenting?: boolean;
+  onComment?: (event: CommentEvent) => void;
+  mcp?: McpConfig;
+  collaboration?: CollaborationConfig;
+  modules?: boolean;
 }
 interface TemplaticalInstance {
-    setTheme(theme: ThemeOverrides): void;
-    create(content?: TemplateContent): Promise<Template>;
-    load(templateId: string): Promise<Template>;
-    save(): Promise<SaveResult>;
-    unmount(): void;
+  setTheme(theme: ThemeOverrides): void;
+  create(content?: TemplateContent): Promise<Template>;
+  load(templateId: string): Promise<Template>;
+  save(): Promise<SaveResult>;
+  unmount(): void;
 }
 interface EditorState {
-    template: Template | null;
-    content: TemplateContent;
-    selectedBlockId: string | null;
-    viewport: ViewportSize;
-    darkMode: boolean;
-    previewMode: boolean;
-    isDirty: boolean;
-    isSaving: boolean;
-    isLoading: boolean;
-    uiTheme: UiTheme;
+  template: Template | null;
+  content: TemplateContent;
+  selectedBlockId: string | null;
+  viewport: ViewportSize;
+  darkMode: boolean;
+  previewMode: boolean;
+  isDirty: boolean;
+  isSaving: boolean;
+  isLoading: boolean;
+  uiTheme: UiTheme;
 }
 interface ApiResponse<T> {
-    data: T;
+  data: T;
 }
 interface ApiError {
-    message: string;
-    errors?: Record<string, string[]>;
+  message: string;
+  errors?: Record<string, string[]>;
 }
 interface PlanFeatures {
-    media_folders: boolean;
-    import_from_url: boolean;
-    auto_save: boolean;
-    custom_fonts: boolean;
-    theme_customization: boolean;
-    html_block: boolean;
-    export_mjml: boolean;
-    white_label: boolean;
-    test_email: boolean;
-    ai_generation: boolean;
-    custom_blocks: boolean;
-    commenting: boolean;
-    collaboration: boolean;
-    saved_modules: boolean;
-    headless_sdk: boolean;
-    pluggable_media: boolean;
+  media_folders: boolean;
+  import_from_url: boolean;
+  auto_save: boolean;
+  custom_fonts: boolean;
+  theme_customization: boolean;
+  html_block: boolean;
+  export_mjml: boolean;
+  white_label: boolean;
+  test_email: boolean;
+  ai_generation: boolean;
+  custom_blocks: boolean;
+  commenting: boolean;
+  collaboration: boolean;
+  saved_modules: boolean;
+  headless_sdk: boolean;
+  pluggable_media: boolean;
 }
 interface PlanLimits {
-    max_file_size_mb: number;
-    max_templates: number | null;
-    media_categories: string[];
-    storage_limit_bytes: number;
+  max_file_size_mb: number;
+  max_templates: number | null;
+  media_categories: string[];
+  storage_limit_bytes: number;
 }
 interface PlanConfig {
-    features: PlanFeatures;
-    limits: PlanLimits;
-    template_count: number;
-    plan: string;
-    media: MediaConfig;
-    storage: StorageInfo;
-    websocket: WebSocketServerConfig;
-    accessibility?: {
-        blockOnError?: boolean;
-    };
+  features: PlanFeatures;
+  limits: PlanLimits;
+  template_count: number;
+  plan: string;
+  media: MediaConfig;
+  storage: StorageInfo;
+  websocket: WebSocketServerConfig;
+  accessibility?: {
+    blockOnError?: boolean;
+  };
 }
 interface AiChatMessage {
-    id: string;
-    role: "user" | "assistant";
-    content: string;
-    timestamp: number;
+  id: string;
+  role: "user" | "assistant";
+  content: string;
+  timestamp: number;
 }
 interface CreateCommentData {
-    body: string;
-    blockId?: string;
-    parentId?: string;
-    authorIdentifier: string;
-    authorName: string;
+  body: string;
+  blockId?: string;
+  parentId?: string;
+  authorIdentifier: string;
+  authorName: string;
 }
 interface UpdateCommentData {
-    body: string;
+  body: string;
 }
 interface AiGenerateOptions {
-    conversationId?: string;
+  conversationId?: string;
 }
 interface AiStreamEvent {
-    type: "text" | "done" | "error";
-    text?: string;
-    content?: TemplateContent;
-    conversationId?: string;
-    error?: string;
+  type: "text" | "done" | "error";
+  text?: string;
+  content?: TemplateContent;
+  conversationId?: string;
+  error?: string;
 }
 interface RewriteData {
-    text: string;
-    instruction: string;
-    blockId: string;
+  text: string;
+  instruction: string;
+  blockId: string;
 }
 interface AiScoreOptions {
-    fixFindingId?: string;
+  fixFindingId?: string;
 }
-
-export { type AiChatMessage, type AiConfig, type AiGenerateOptions, type AiScoreOptions, type AiStreamEvent, type ApiError, type ApiResponse, type AuthConfig, type AuthRequestOptions, BUTTON_BLOCK_DEFAULTS, type BaseBlock, type Block, type BlockDefaults, type BlockStyles, type BlockType, type BlockVisibility, type ButtonBlock, COUNTDOWN_BLOCK_DEFAULTS, type CategoryScore, type CollaborationConfig, type Collaborator, type ColumnLayout, type Comment, type CommentEvent, type CommentEventType, type CommentThread, type CountdownBlock, type CreateCommentData, type CustomBlock, type CustomBlockBooleanField, type CustomBlockColorField, type CustomBlockDefinition, type CustomBlockField, type CustomBlockFieldBase, type CustomBlockFieldType, type CustomBlockImageField, type CustomBlockNumberField, type CustomBlockRepeatableField, type CustomBlockSelectField, type CustomBlockTextField, type CustomBlockTextareaField, type CustomFont, DEFAULT_BLOCK_DEFAULTS, DEFAULT_TEMPLATE_DEFAULTS, DIVIDER_BLOCK_DEFAULTS, type DataSourceConfig, type DataSourceFetchContext, type DirectAuthConfig, type DisplayCondition, type DisplayConditionsConfig, type DividerBlock, type EditorState, EventEmitter, type ExportResult, type FindingSeverity, type FontsConfig, HEADING_LEVEL_FONT_SIZE, HTML_BLOCK_DEFAULTS, type HeadingLevel, type HealthCheckResult, type HtmlBlock, IMAGE_BLOCK_DEFAULTS, type ImageBlock, MENU_BLOCK_DEFAULTS, type McpConfig, type McpOperation, type McpOperationPayload, type MediaResult, type MenuBlock, type MenuItemData, type MergeTag, type MergeTagsConfig, PARAGRAPH_BLOCK_DEFAULTS, type ParagraphBlock, type PlanConfig, type PlanFeatures, type PlanLimits, type ProxyAuthConfig, type ResponsiveStyles, type RewriteData, SECTION_BLOCK_DEFAULTS, SOCIAL_ICONS_BLOCK_DEFAULTS, SPACER_BLOCK_DEFAULTS, SYNTAX_PRESETS, type SaveResult, type SavedModule, type ScoringCategory, type ScoringFinding, type ScoringResult, type SdkAuthConfig, SdkError, type SectionBlock, type SelectOption, type SocialIcon, type SocialIconSize, type SocialIconStyle, type SocialIconsBlock, type SocialPlatform, type SpacerBlock, type SpacingValue, type SyntaxPreset, type SyntaxPresetName, TABLE_BLOCK_DEFAULTS, TITLE_BLOCK_DEFAULTS, type TableBlock, type TableCellData, type TableRowData, type Template, type TemplateContent, type TemplateDefaults, type TemplateSettings, type TemplateSnapshot, type TemplaticalConfig, type TemplaticalInstance, type TestEmailConfig, type ThemeOverrides, type TitleBlock, type TokenData, type UiTheme, type UpdateCommentData, type UserConfig, VIDEO_BLOCK_DEFAULTS, type VideoBlock, type ViewportSize, type WebSocketServerConfig, cloneBlock, containsMergeTag, createBlock, createButtonBlock, createCountdownBlock, createCustomBlock, createDefaultTemplateContent, createDividerBlock, createHtmlBlock, createImageBlock, createMenuBlock, createParagraphBlock, createSectionBlock, createSocialIconsBlock, createSpacerBlock, createTableBlock, createTitleBlock, createVideoBlock, deepMergeDefaults, generateId, getLogicMergeTagKeyword, getMergeTagLabel, getSyntaxTriggerChar, isButton, isCountdown, isCustomBlock, isDivider, isHtml, isImage, isLogicMergeTagValue, isMenu, isMergeTagValue, isParagraph, isSection, isSocialIcons, isSpacer, isTable, isTitle, isVideo, resolveHtmlLogicMergeTagLabels, resolveHtmlMergeTagLabels, resolveSyntax, restoreMergeTagMarkup };
+//#endregion
+export { type AiChatMessage, type AiConfig, type AiGenerateOptions, type AiScoreOptions, type AiStreamEvent, type ApiError, type ApiResponse, type AuthConfig, type AuthRequestOptions, BUTTON_BLOCK_DEFAULTS, type BaseBlock, type Block, type BlockDefaults, type BlockStyles, type BlockType, type BlockVisibility, type ButtonBlock, COUNTDOWN_BLOCK_DEFAULTS, type CategoryScore, type CollaborationConfig, type Collaborator, type ColumnLayout, type Comment, type CommentEvent, type CommentEventType, type CommentThread, type CountdownBlock, type CreateCommentData, type CustomBlock, type CustomBlockBooleanField, type CustomBlockColorField, type CustomBlockDefinition, type CustomBlockField, type CustomBlockFieldBase, type CustomBlockFieldType, type CustomBlockImageField, type CustomBlockNumberField, type CustomBlockRepeatableField, type CustomBlockSelectField, type CustomBlockTextField, type CustomBlockTextareaField, type CustomFont, DEFAULT_BLOCK_DEFAULTS, DEFAULT_TEMPLATE_DEFAULTS, DIVIDER_BLOCK_DEFAULTS, type DataSourceConfig, type DataSourceFetchContext, type DirectAuthConfig, type DisplayCondition, type DisplayConditionsConfig, type DividerBlock, type EditorState, EventEmitter, type ExportResult, type FindingSeverity, type FontsConfig, HEADING_LEVEL_FONT_SIZE, HTML_BLOCK_DEFAULTS, type HeadingLevel, type HealthCheckResult, type HtmlBlock, IMAGE_BLOCK_DEFAULTS, type ImageBlock, MENU_BLOCK_DEFAULTS, type McpConfig, type McpOperation, type McpOperationPayload, type MediaResult, type MenuBlock, type MenuItemData, type MergeTag, type MergeTagsConfig, PARAGRAPH_BLOCK_DEFAULTS, type ParagraphBlock, type PlanConfig, type PlanFeatures, type PlanLimits, type ProxyAuthConfig, type RewriteData, SECTION_BLOCK_DEFAULTS, SOCIAL_ICONS_BLOCK_DEFAULTS, SPACER_BLOCK_DEFAULTS, SYNTAX_PRESETS, type SaveResult, type SavedModule, type ScoringCategory, type ScoringFinding, type ScoringResult, type SdkAuthConfig, SdkError, type SectionBlock, type SelectOption, type SocialIcon, type SocialIconSize, type SocialIconStyle, type SocialIconsBlock, type SocialPlatform, type SpacerBlock, type SpacingValue, type SyntaxPreset, type SyntaxPresetName, TABLE_BLOCK_DEFAULTS, TITLE_BLOCK_DEFAULTS, type TableBlock, type TableCellData, type TableRowData, type Template, type TemplateContent, type TemplateDefaults, type TemplateSettings, type TemplateSnapshot, type TemplaticalConfig, type TemplaticalInstance, type TestEmailConfig, type ThemeOverrides, type TitleBlock, type TokenData, type UiTheme, type UpdateCommentData, type UserConfig, VIDEO_BLOCK_DEFAULTS, type VideoBlock, type ViewportSize, type WebSocketServerConfig, cloneBlock, containsMergeTag, createBlock, createButtonBlock, createCountdownBlock, createCustomBlock, createDefaultTemplateContent, createDividerBlock, createHtmlBlock, createImageBlock, createMenuBlock, createParagraphBlock, createSectionBlock, createSocialIconsBlock, createSpacerBlock, createTableBlock, createTitleBlock, createVideoBlock, deepMergeDefaults, generateId, getLogicMergeTagKeyword, getMergeTagLabel, getSyntaxTriggerChar, isButton, isCountdown, isCustomBlock, isDivider, isHtml, isImage, isLogicMergeTagValue, isMenu, isMergeTagValue, isParagraph, isSection, isSocialIcons, isSpacer, isTable, isTitle, isVideo, resolveHtmlLogicMergeTagLabels, resolveHtmlMergeTagLabels, resolveSyntax, restoreMergeTagMarkup };
+//# sourceMappingURL=index.d.ts.map