@storyblok/live-preview 0.1.6 → 0.2.0

package/dist/index.d.mts

@@ -1,10 +1,1184 @@
 import StoryblokBridge, { BridgeParams, BridgeParams as BridgeParams$1 } from "@storyblok/preview-bridge";
 
-//#region src/editable.d.ts
-interface Blok {
+//#region src/generated/capi/_internal.gen.d.ts
+type CapiStory = ({
+  version?: 'draft';
+} & DraftStory) | ({
+  version?: 'published';
+} & PublishedStory);
+type DraftStory = {
+  name: string;
+  /**
+   * Creation timestamp (format is ISO 8601 standard in UTC).
+   */
+  created_at: string;
+  /**
+   * Latest update timestamp (format is ISO 8601 standard in UTC).
+   */
+  updated_at?: string | null;
+  /**
+   * Latest publication timestamp (format is ISO 8601 standard in UTC).
+   */
+  published_at: string | null;
+  alternates: Array<StoryAlternate>;
+  id: number;
+  uuid: string;
+  /**
+   * Dynamic component data rendered by Storyblok, structure varies by component.
+   */
+  content: {
+    _uid?: string;
+    component?: string;
+    [key: string]: unknown | string | undefined;
+  };
+  slug: string;
+  full_slug: string;
+  default_full_slug: string | null;
+  sort_by_date: string | null;
+  position: number;
+  tag_list: Array<string>;
+  is_startpage: boolean;
+  parent_id: number;
+  /**
+   * Custom metadata for the story.
+   */
+  meta_data: {
+    [key: string]: unknown;
+  } | null;
+  group_id: string;
+  first_published_at: string | null;
+  release_id: number | null;
+  lang: string;
+  path: string | null;
+  translated_slugs: Array<{
+    path: string;
+    name: string | null;
+    lang: string;
+    published: string | null;
+  }> | null;
+};
+type PublishedStory = {
+  name: string;
+  /**
+   * Creation timestamp (format is ISO 8601 standard in UTC).
+   */
+  created_at: string;
+  /**
+   * Latest update timestamp (format is ISO 8601 standard in UTC).
+   */
+  updated_at?: string | null;
+  /**
+   * Latest publication timestamp (format is ISO 8601 standard in UTC).
+   */
+  published_at: string | null;
+  id: number;
+  uuid: string;
+  /**
+   * Dynamic component data rendered by Storyblok, structure varies by component.
+   */
+  content: {
+    _uid?: string;
+    component?: string;
+    [key: string]: unknown | string | undefined;
+  };
+  slug: string;
+  full_slug: string;
+  sort_by_date: string | null;
+  position: number;
+  tag_list: Array<string>;
+  is_startpage: boolean;
+  parent_id: number;
+  /**
+   * Custom metadata for the story.
+   */
+  meta_data: {
+    [key: string]: unknown;
+  } | null;
+  group_id: string;
+  first_published_at: string | null;
+  release_id?: number | null;
+  lang: string;
+  path: string | null;
+  alternates: Array<StoryAlternate>;
+  default_full_slug: string | null;
+  translated_slugs: Array<{
+    path: string;
+    name: string | null;
+    lang: string;
+    published: string | null;
+  }> | null;
+};
+type StoryAlternate = {
+  id: number;
+  name: string;
+  slug: string;
+  published: boolean | null;
+  full_slug: string;
+  is_folder: boolean;
+  parent_id: number;
+};
+//#endregion
+//#region src/generated/mapi/_internal.gen.d.ts
+type Component = {
+  /**
+   * Unique identifier for the component
+   */
+  readonly id: number;
+  /**
+   * Technical name of the component.
+   */
+  name: string;
+  /**
+   * Human-readable display name
+   */
+  display_name?: string | null;
+  /**
+   * Component description
+   */
+  description?: string | null;
+  /**
+   * Creation timestamp (format is ISO 8601 standard in UTC).
+   */
+  readonly created_at: string;
+  /**
+   * Latest update timestamp (format is ISO 8601 standard in UTC).
+   */
+  updated_at: string;
+  /**
+   * Component field schema definition
+   */
+  schema: {
+    [key: string]: {
+      type?: 'bloks' | 'text' | 'textarea' | 'richtext' | 'markdown' | 'number' | 'datetime' | 'boolean' | 'options' | 'option' | 'asset' | 'multiasset' | 'multilink' | 'table' | 'section' | 'commerce' | 'custom' | 'image' | 'file' | 'tab' | 'link' | 'group';
+      /**
+       * Field ID
+       */
+      id?: string;
+      [key: string]: unknown | 'bloks' | 'text' | 'textarea' | 'richtext' | 'markdown' | 'number' | 'datetime' | 'boolean' | 'options' | 'option' | 'asset' | 'multiasset' | 'multilink' | 'table' | 'section' | 'commerce' | 'custom' | 'image' | 'file' | 'tab' | 'link' | 'group' | string | undefined;
+    };
+  };
+  /**
+   * Component image URL
+   */
+  image?: string | null;
+  /**
+   * Field used for preview.
+   */
+  preview_field?: string | null;
+  /**
+   * Whether this component can be used as a root component.
+   */
+  is_root: boolean;
+  /**
+   * Preview template HTML.
+   */
+  preview_tmpl?: string | null;
+  /**
+   * Whether this component can be nested inside other components.
+   */
+  is_nestable: boolean;
+  /**
+   * All presets associated with this component.
+   */
+  all_presets?: Array<{
+    /**
+     * Preset ID
+     */
+    id?: number;
+    /**
+     * Preset name
+     */
+    name?: string;
+    /**
+     * Preset schema
+     */
+    preset?: {
+      [key: string]: unknown;
+    };
+    /**
+     * ID of the component this preset belongs to
+     */
+    component_id?: number;
+    /**
+     * Image URL for the preset preview
+     */
+    image?: string | null;
+    /**
+     * Icon name for the preset
+     */
+    icon?: string | null;
+    /**
+     * Color for the preset display
+     */
+    color?: string | null;
+    /**
+     * Description of the preset
+     */
+    description?: string | null;
+  }>;
+  /**
+   * Default preset ID.
+   */
+  preset_id?: number | null;
+  /**
+   * Display name if available, otherwise technical name.
+   */
+  real_name?: string;
+  /**
+   * UUID of the component group this component belongs to.
+   */
+  component_group_uuid?: string | null;
+  /**
+   * Component color for UI display
+   */
+  color?: string | null;
+  /**
+   * Component icon name
+   */
+  icon?: string | null;
+  internal_tags_list?: Array<{
+    /**
+     * ID
+     */
+    id?: number;
+    /**
+     * Name
+     */
+    name?: string;
+  }>;
+  /**
+   * List of internal tag IDs
+   */
+  internal_tag_ids?: Array<string>;
+  /**
+   * Content Type Asset preview.
+   */
+  content_type_asset_preview?: string | null;
+  /**
+   * Component metadata.
+   */
+  metadata?: {
+    [key: string]: unknown;
+  } | null;
+};
+//#endregion
+//#region src/generated/overlay/_internal.gen.d.ts
+/**
+ * A component schema field. Discriminated by the literal `type` enum on each variant.
+ */
+type Field = TextFieldRoot | TextareaFieldRoot | RichtextFieldRoot | MarkdownFieldRoot | NumberFieldRoot | DatetimeFieldRoot | BooleanFieldRoot | OptionFieldRoot | OptionsFieldRoot | AssetFieldRoot | MultiassetFieldRoot | MultilinkFieldRoot | BloksFieldRoot | TableFieldRoot | SectionFieldRoot | TabFieldRoot | CustomFieldRoot;
+type AssetFieldValue = AssetFieldValueRoot;
+type BlockContentBase = BlockContentRoot;
+type MultilinkFieldValue = MultilinkFieldValueRoot;
+type PluginFieldValue = PluginFieldValueRoot;
+type RichtextFieldValue = RichtextFieldValueRoot;
+type TableFieldValue = TableFieldValueRoot;
+type TextFieldRoot = BaseFieldRoot & ValueFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'text';
+  /**
+   * Maximum length of the input string
+   */
+  max_length?: number;
+  /**
+   * Maximum length for text fields (legacy alias for max_length)
+   */
+  maxlength?: number;
+  /**
+   * Minimum length for text fields
+   */
+  minlength?: number;
+  /**
+   * Field size (small, medium, large)
+   */
+  size?: string;
+  /**
+   * Whether to enable right-to-left text direction
+   */
+  rtl?: boolean;
+};
+type TextareaFieldRoot = BaseFieldRoot & ValueFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'textarea';
+  /**
+   * Maximum length of the input string
+   */
+  max_length?: number;
+  /**
+   * Maximum length for text fields (legacy alias for max_length)
+   */
+  maxlength?: number;
+  /**
+   * Minimum length for text fields
+   */
+  minlength?: number;
+  /**
+   * Field size (small, medium, large)
+   */
+  size?: string;
+  /**
+   * Whether to enable right-to-left text direction
+   */
+  rtl?: boolean;
+  /**
+   * Whether rich text is enabled
+   */
+  rich_text?: boolean;
+  /**
+   * Whether markdown is enabled
+   */
+  markdown?: boolean;
+};
+type RichtextFieldRoot = BaseFieldRoot & ValueFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'richtext';
+  /**
+   * Whether to allow toolbar customization
+   */
+  customize_toolbar?: boolean;
+  /**
+   * Array of enabled toolbar elements
+   */
+  toolbar?: Array<'ai-complete' | 'ai-shorten' | 'ai-extend' | 'ai-rephrase' | 'ai-summarize' | 'ai-simplify' | 'ai-tone' | 'ai-emoji' | 'ai-translate' | 'ai-tldr' | 'ai-spelling' | 'blok' | 'ltr' | 'rtl' | 'export' | 'import' | 'bold' | 'list' | 'inlinecode' | 'code' | 'color' | 'copy' | 'cut' | 'emoji' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'highlight' | 'unset' | 'hrule' | 'image' | 'italic' | 'link' | 'anchor' | 'olist' | 'paragraph' | 'paste-action' | 'paste' | 'quote' | 'redo' | 'strike' | 'subscript' | 'superscript' | 'underline' | 'undo' | 'align-left' | 'align-center' | 'align-right' | 'align-justify'>;
+  /**
+   * Custom CSS styles for the richtext field
+   */
+  style_options?: Array<{
+    _uid?: string;
+    name?: string;
+    value?: string;
+  }>;
+  /**
+   * Restriction type for component selection (groups, tags, or empty for specific blocks)
+   */
+  restrict_type?: string;
+  /**
+   * Whether to restrict which components can be inserted
+   */
+  restrict_components?: boolean;
+  /**
+   * List of allowed component names
+   */
+  component_whitelist?: Array<string>;
+  /**
+   * List of denied component names
+   */
+  component_denylist?: Array<string>;
+  /**
+   * List of allowed tag IDs for component filtering
+   */
+  component_tag_whitelist?: Array<number>;
+  /**
+   * List of denied tag IDs for component filtering
+   */
+  component_tag_denylist?: Array<number>;
+  /**
+   * List of allowed component group UUIDs
+   */
+  component_group_whitelist?: Array<string>;
+  /**
+   * List of denied component group UUIDs
+   */
+  component_group_denylist?: Array<string>;
+  /**
+   * Whether to allow links to open in a new tab
+   */
+  allow_target_blank?: boolean;
+  /**
+   * Whether to allow custom link attributes
+   */
+  allow_custom_attributes?: boolean;
+};
+type MarkdownFieldRoot = BaseFieldRoot & ValueFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'markdown';
+  /**
+   * Whether to display markdown as rich text
+   */
+  rich_markdown?: boolean;
+  /**
+   * Whether to enable right-to-left text direction
+   */
+  rtl?: boolean;
+  /**
+   * Whether to enable a customized toolbar
+   */
+  customize_toolbar?: boolean;
+  /**
+   * Array of enabled toolbar elements
+   */
+  toolbar?: Array<'bold' | 'italic' | 'inlinecode' | 'code' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'list' | 'olist' | 'quote' | 'hrule' | 'link' | 'image' | 'paragraph' | 'help' | 'toggle-richtext' | 'auto' | 'ltr' | 'rtl'>;
+  /**
+   * Whether to allow empty paragraphs
+   */
+  allow_multiline?: boolean;
+  /**
+   * Maximum length of the input string
+   */
+  max_length?: number;
+};
+type NumberFieldRoot = BaseFieldRoot & ValueFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'number';
+  /**
+   * Minimum value allowed
+   */
+  min_value?: number;
+  /**
+   * Maximum value allowed
+   */
+  max_value?: number;
+  /**
+   * Number of decimal places
+   */
+  decimals?: number;
+  /**
+   * Step size for the number input
+   */
+  steps?: number;
+};
+type DatetimeFieldRoot = BaseFieldRoot & ValueFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'datetime';
+  /**
+   * Whether to disable time selection (date-only mode)
+   */
+  disable_time?: boolean;
+};
+type BooleanFieldRoot = BaseFieldRoot & ValueFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'boolean';
+  /**
+   * Whether to display the label next to the toggle
+   */
+  inline_label?: boolean;
+};
+type OptionFieldRoot = BaseFieldRoot & ValueFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'option';
+  /**
+   * Array of selectable options
+   */
+  options?: Array<{
+    _uid?: string;
+    name?: string;
+    value?: string;
+  }>;
+  /**
+   * Source of the options (undefined=self, internal_stories, internal_languages, external, internal)
+   */
+  source?: string;
+  /**
+   * Datasource slug when source is internal
+   */
+  datasource_slug?: string;
+  /**
+   * External datasource JSON URL when source is external
+   */
+  external_datasource?: string;
+  /**
+   * Path of allowed stories folder when source is internal_stories
+   */
+  folder_slug?: string;
+  /**
+   * Allowed content type blocks when source is internal_stories
+   */
+  filter_content_type?: Array<string>;
+  /**
+   * Whether to exclude the empty option
+   */
+  exclude_empty_option?: boolean;
+  /**
+   * Whether to include an empty option
+   */
+  include_empty_option?: boolean;
+  /**
+   * Whether to use UUID for the option value
+   */
+  use_uuid?: boolean;
+  /**
+   * Display appearance (link or card) when source is internal_stories
+   */
+  entry_appearance?: string;
+  /**
+   * Whether to allow advanced search in a modal when source is internal_stories
+   */
+  allow_advanced_search?: boolean;
+  /**
+   * Maximum number of selectable options
+   */
+  max_options?: string;
+  /**
+   * Minimum number of selectable options
+   */
+  min_options?: string;
+  /**
+   * Whether multiple values are allowed
+   */
+  multiple?: boolean;
+};
+type OptionsFieldRoot = BaseFieldRoot & ValueFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'options';
+  /**
+   * Array of selectable options
+   */
+  options?: Array<{
+    _uid?: string;
+    name?: string;
+    value?: string;
+  }>;
+  /**
+   * Source of the options (undefined=self, internal_stories, internal_languages, external, internal)
+   */
+  source?: string;
+  /**
+   * Datasource slug when source is internal
+   */
+  datasource_slug?: string;
+  /**
+   * External datasource JSON URL when source is external
+   */
+  external_datasource?: string;
+  /**
+   * Path of allowed stories folder when source is internal_stories
+   */
+  folder_slug?: string;
+  /**
+   * Allowed content type blocks when source is internal_stories
+   */
+  filter_content_type?: Array<string>;
+  /**
+   * Whether to use UUID for the option values
+   */
+  use_uuid?: boolean;
+  /**
+   * Whether this Multi-Options field is a References field
+   */
+  is_reference_type?: boolean;
+  /**
+   * Display appearance (link or card) when source is internal_stories
+   */
+  entry_appearance?: string;
+  /**
+   * Whether to allow advanced search in a modal when source is internal_stories
+   */
+  allow_advanced_search?: boolean;
+  /**
+   * Maximum number of selectable options
+   */
+  max_options?: string;
+  /**
+   * Minimum number of selectable options
+   */
+  min_options?: string;
+  /**
+   * Whether multiple values are allowed
+   */
+  multiple?: boolean;
+};
+type AssetFieldRoot = BaseFieldRoot & ValueFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'asset';
+  /**
+   * Allowed file types (images, videos, audios, texts)
+   */
+  filetypes?: Array<string>;
+  /**
+   * Numeric ID of the allowed asset folder
+   */
+  asset_folder_id?: number;
+  /**
+   * Whether to allow external URLs
+   */
+  allow_external_url?: boolean;
+  /**
+   * Field height in pixels
+   */
+  height?: number;
+  /**
+   * Field width in pixels
+   */
+  width?: number;
+  /**
+   * Whether to restrict assets
+   */
+  restrict_assets?: boolean;
+  /**
+   * List of allowed asset types
+   */
+  asset_whitelist?: Array<string>;
+};
+type MultiassetFieldRoot = BaseFieldRoot & ValueFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'multiasset';
+  /**
+   * Allowed file types (images, videos, audios, texts)
+   */
+  filetypes?: Array<string>;
+  /**
+   * Numeric ID of the allowed asset folder
+   */
+  asset_folder_id?: number;
+  /**
+   * Whether to allow external URLs
+   */
+  allow_external_url?: boolean;
+  /**
+   * Field height in pixels
+   */
+  height?: number;
+  /**
+   * Field width in pixels
+   */
+  width?: number;
+  /**
+   * Whether to restrict assets
+   */
+  restrict_assets?: boolean;
+  /**
+   * List of allowed asset types
+   */
+  asset_whitelist?: Array<string>;
+  /**
+   * Maximum number of entries
+   */
+  maximum_entries?: number;
+  /**
+   * Minimum number of entries
+   */
+  minimum_entries?: number;
+};
+type MultilinkFieldRoot = BaseFieldRoot & ValueFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'multilink';
+  /**
+   * Whether to restrict linkable content types
+   */
+  restrict_content_types?: boolean;
+  /**
+   * List of allowed content type blocks for internal links
+   */
+  component_whitelist?: Array<string>;
+  /**
+   * Whether to allow opening links in a new tab
+   */
+  allow_target_blank?: boolean;
+  /**
+   * Whether to allow setting custom link attributes
+   */
+  allow_custom_attributes?: boolean;
+  /**
+   * Whether to restrict to a specific folder
+   */
+  force_link_scope?: boolean;
+  /**
+   * Path of the allowed folder when force_link_scope is true
+   */
+  link_scope?: string;
+  /**
+   * Whether to allow defining an anchor ID for internal links
+   */
+  show_anchor?: boolean;
+  /**
+   * Whether to allow specifying an email address
+   */
+  email_link_type?: boolean;
+  /**
+   * Whether to allow specifying an asset URL
+   */
+  asset_link_type?: boolean;
+};
+type BloksFieldRoot = BaseFieldRoot & ValueFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'bloks';
+  /**
+   * Restriction type for component selection (groups, tags, or empty for specific blocks)
+   */
+  restrict_type?: string;
+  /**
+   * Whether to restrict which components can be inserted
+   */
+  restrict_components?: boolean;
+  /**
+   * List of allowed component names
+   */
+  component_whitelist?: Array<string>;
+  /**
+   * List of denied component names
+   */
+  component_denylist?: Array<string>;
+  /**
+   * List of allowed tag IDs for component filtering
+   */
+  component_tag_whitelist?: Array<number>;
+  /**
+   * List of denied tag IDs for component filtering
+   */
+  component_tag_denylist?: Array<number>;
+  /**
+   * List of allowed component group UUIDs
+   */
+  component_group_whitelist?: Array<string>;
+  /**
+   * List of denied component group UUIDs
+   */
+  component_group_denylist?: Array<string>;
+  /**
+   * Minimum number of bloks
+   */
+  minimum?: number;
+  /**
+   * Maximum number of bloks
+   */
+  maximum?: number;
+  /**
+   * Maximum number of entries
+   */
+  maximum_entries?: number;
+  /**
+   * Minimum number of entries
+   */
+  minimum_entries?: number;
+};
+type TableFieldRoot = BaseFieldRoot & ValueFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'table';
+};
+type SectionFieldRoot = BaseFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'section';
+  /**
+   * Field keys that belong to this section
+   */
+  keys?: Array<string>;
+  /**
+   * Fieldset configuration
+   */
+  fieldset?: {
+    /**
+     * Fieldset title
+     */
+    title?: string;
+    /**
+     * Fieldset description
+     */
+    description?: string;
+    /**
+     * Whether the fieldset is collapsible
+     */
+    collapsible?: boolean;
+    /**
+     * Whether the fieldset is collapsed by default
+     */
+    collapsed?: boolean;
+  };
+};
+type TabFieldRoot = BaseFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'tab';
+  /**
+   * Field keys that belong to this tab
+   */
+  keys?: Array<string>;
+};
+type CustomFieldRoot = BaseFieldRoot & ValueFieldRoot & {
+  /**
+   * Field type discriminant
+   */
+  type: 'custom';
+  /**
+   * Technical name of the field plugin
+   */
+  field_type?: string;
+  /**
+   * Plugin-specific options
+   */
+  options?: Array<{
+    name?: string;
+    value?: string;
+  }>;
+  /**
+   * Comma-separated list of required field names in the plugin
+   */
+  required_fields?: string;
+  /**
+   * Source for plugin-provided options (`self` or `internal` for datasource)
+   */
+  source?: 'self' | 'internal';
+  /**
+   * Slug of the internal datasource when `source` is `internal`
+   */
+  datasource_slug?: string;
+  /**
+   * URL to an external datasource when `source` is set accordingly
+   */
+  external_datasource?: string;
+};
+/**
+ * Asset field type - single asset (image, video, audio, or document)
+ */
+type AssetFieldValueRoot = {
+  /**
+   * Identifies this as an asset field
+   */
+  fieldtype: 'asset';
+  /**
+   * Numeric ID of the asset
+   */
+  id: number | null;
+  /**
+   * Alternative text for the asset
+   */
+  alt: string | null;
+  /**
+   * Name of the asset
+   */
+  name?: string;
+  /**
+   * Focal point coordinates for cropping (format "123x456:789x1011")
+   */
+  focus?: string | null;
+  /**
+   * Title of the asset
+   */
+  title?: string | null;
+  /**
+   * Source attribution for the asset
+   */
+  source?: string | null;
+  /**
+   * URL to the asset file
+   */
+  filename: string;
+  /**
+   * Copyright information
+   */
+  copyright?: string | null;
+  /**
+   * Additional metadata for the asset
+   */
+  meta_data?: {
+    [key: string]: unknown;
+  };
+  /**
+   * Whether the asset is hosted externally
+   */
+  is_external_url?: boolean;
+};
+/**
+ * Content object representing a component instance. Contains a _uid, a component technical name, and dynamic fields whose values depend on the component's schema field types (text, textarea, richtext, markdown, number, datetime, boolean, option, options, asset, multiasset, multilink, bloks, table, section, custom/plugin).
+ */
+type BlockContentRoot = {
+  /**
+   * Unique identifier for this component instance
+   */
+  _uid: string;
+  /**
+   * Technical name of the component (content type or nestable block)
+   */
+  component: string;
+  /**
+   * Storyblok editor markup string for inline editing (present in draft/preview mode)
+   */
+  _editable?: string;
+  [key: string]: string | number | boolean | Array<string | AssetFieldValueRoot | BlockContentRoot> | AssetFieldValueRoot | MultilinkFieldValueRoot | TableFieldValueRoot | RichtextFieldValueRoot | PluginFieldValueRoot | string | undefined;
+};
+/**
+ * Multilink field type - link to internal stories, external URLs, emails, etc.
+ */
+type MultilinkFieldValueRoot = {
+  /**
+   * Identifies this as a multilink field
+   */
+  fieldtype: 'multilink';
+  /**
+   * UUID of the linked story (for internal links)
+   */
+  id: string;
+  /**
+   * URL for external links or email addresses
+   */
+  url: string;
+  /**
+   * Type of link
+   */
+  linktype: 'story' | 'url' | 'email' | 'asset';
+  /**
+   * Cached URL path for the linked story
+   */
+  cached_url: string;
+  /**
+   * Anchor/fragment identifier for the link
+   */
+  anchor?: string | null;
+  /**
+   * Link target attribute
+   */
+  target?: '_self' | '_blank' | null;
+};
+/**
+ * Plugin/Custom field type - field plugin with custom structure
+ */
+type PluginFieldValueRoot = {
+  /**
+   * Technical name of the field plugin
+   */
+  plugin: string;
+  /**
+   * Unique identifier for this plugin field instance
+   */
+  _uid?: string;
+  [key: string]: unknown | string | undefined;
+};
+/**
+ * Richtext field type - structured rich text document (ProseMirror format)
+ */
+type RichtextFieldValueRoot = {
+  /**
+   * Root node type for richtext documents
+   */
+  type: 'doc';
+  /**
+   * Array of richtext nodes (paragraphs, headings, lists, bloks, etc.)
+   */
+  content?: Array<{
+    [key: string]: unknown;
+  }>;
+};
+/**
+ * Table field type - structured table data
+ */
+type TableFieldValueRoot = {
+  /**
+   * Table header cells
+   */
+  thead: Array<{
+    _uid: string;
+    component: '_table_head';
+    /**
+     * Header cell content
+     */
+    value?: string;
+  }>;
+  /**
+   * Table body rows
+   */
+  tbody: Array<{
+    _uid: string;
+    component: '_table_row';
+    /**
+     * Cells in this row
+     */
+    body?: Array<{
+      _uid: string;
+      component: '_table_col';
+      /**
+       * Cell content
+       */
+      value?: string;
+    }>;
+  }>;
+};
+/**
+ * Universal identity and display properties shared by every field type
+ */
+type BaseFieldRoot = {
+  /**
+   * Field type discriminant
+   */
+  type?: string;
+  /**
+   * The ID of the field
+   */
+  id?: string;
+  /**
+   * Human-readable display name
+   */
+  display_name?: string;
+  /**
+   * Field description displayed in the editor
+   */
+  description?: string;
+  /**
+   * Whether to display the description as a tooltip
+   */
+  tooltip?: boolean;
+  /**
+   * Position of the field within the block
+   */
+  pos?: number;
+  /**
+   * Conditions set on the field for conditional visibility
+   */
+  conditional_settings?: Array<{
+    [key: string]: unknown;
+  }>;
+};
+/**
+ * Properties shared by content-bearing fields (i.e. fields that hold a value).
+ * Layout-only field types like `section` and `tab` do not include these.
+ *
+ */
+type ValueFieldRoot = {
+  /**
+   * Whether the field is required
+   */
+  required?: boolean;
+  /**
+   * Regular expression for validation
+   */
+  regex?: string;
+  /**
+   * Default value for the field (can be escaped JSON)
+   */
+  default_value?: string;
+  /**
+   * Whether the field is translatable
+   */
+  translatable?: boolean;
+  /**
+   * Exclude the field from translation exports
+   */
+  no_translate?: boolean;
+  /**
+   * Exclude the field from AI translations
+   */
+  exclude_from_ai_translation?: boolean;
+  /**
+   * Exclude the field when merging (Dimensions App)
+   */
+  exclude_from_merge?: boolean;
+  /**
+   * Exclude the field when overwriting (Dimensions App)
+   */
+  exclude_from_overwrite?: boolean;
+  /**
+   * Overwrite the field when merging (Dimensions App)
+   */
+  force_merge?: boolean;
+};
+//#endregion
+//#region src/generated/types/_utils.d.ts
+type Prettify<T> = { [K in keyof T]: T[K] } & {};
+/** Replaces the keys of `T` that also appear in `U` with the definitions from `U`. */
+type Override<T, U> = Prettify<Omit<T, keyof U> & U>;
+//#endregion
+//#region src/generated/types/block.d.ts
+/** Wire form: the MAPI object map keyed by field name. This is what `defineBlock` returns. */
+type BlockSchema = Record<string, Field & {
+  required?: boolean;
+}>;
+/** A Storyblok block. */
+type Block<TName extends string = string, TBlockSchema extends BlockSchema = BlockSchema, TIsRoot extends boolean = boolean, TIsNestable extends boolean = boolean, TComponentGroupUuid extends string | null = string | null> = Override<Component, {
+  name: TName;
+  schema: TBlockSchema;
+  is_root?: TIsRoot;
+  is_nestable?: TIsNestable;
+  component_group_uuid?: TComponentGroupUuid;
+}>;
+/**
+ * A root {@link Block} (`is_root: true`). Given a union of blocks, narrows to
+ * its root members; with no argument it is the generic root-block type.
+ */
+type RootBlock<T extends Block = Block & {
+  is_root: true;
+}> = Extract<T, {
+  is_root: true;
+}>;
+//#endregion
+//#region src/generated/types/field.d.ts
+/**
+ * Registry of all blocks in the space, used to resolve nested `bloks` fields.
+ * A `Block` union resolves nested content against the registry; `NoBlocks`
+ * (the default) leaves it loose (`BlockContentBase`).
+ */
+type NoBlocks$1 = false;
+/** True when `T` is the un-narrowed base `Block` (i.e. no specific block was supplied). */
+type IsBaseBlock<T> = [Block] extends [T] ? true : false;
+type RequiredFieldKeys<T> = { [K in keyof T]: T[K] extends {
+  required: true;
+} ? K : never }[keyof T];
+type OptionalFieldKeys<T> = Exclude<keyof T, RequiredFieldKeys<T>>;
+/**
+ * Content object for a single block instance as returned by the Storyblok
+ * Content Delivery API. Without a `TBlock` argument, this is the loose
+ * runtime shape (any block, `_editable` optional). With a schema-typed
+ * `TBlock`, fields are narrowed per the block's schema.
+ */
+type BlockContent<TBlock extends Block = Block, TBlocks = NoBlocks$1> = IsBaseBlock<TBlock> extends true ? BlockContentBase : TBlock extends any ? Prettify<{
+  _uid: string;
+  component: TBlock['name'];
   _editable?: string;
+} & { [K in RequiredFieldKeys<TBlock['schema']>]: FieldValue<NonNullable<TBlock['schema'][K]>, TBlocks> } & { [K in OptionalFieldKeys<TBlock['schema']>]?: FieldValue<NonNullable<TBlock['schema'][K]>, TBlocks> | null }> : never;
+interface FieldTypeValueMap {
+  text: string;
+  textarea: string;
+  richtext: RichtextFieldValue;
+  markdown: string;
+  number: number;
+  datetime: string;
+  boolean: boolean;
+  option: string;
+  options: string[];
+  asset: AssetFieldValue;
+  multiasset: AssetFieldValue[];
+  multilink: MultilinkFieldValue;
+  bloks: BlockContentBase[];
+  table: TableFieldValue;
+  section: never;
+  tab: never;
+  custom: PluginFieldValue;
 }
-declare function storyblokEditable(blok?: Blok): {
+type IsNestable<T> = T extends {
+  is_nestable: false;
+} ? false : T extends {
+  is_nestable: true;
+} ? true : true;
+type ApplyWhitelist<TField, TBlocks> = TField extends {
+  component_whitelist: ReadonlyArray<infer TWhitelisted extends string>;
+} ? Extract<TBlocks, {
+  name: TWhitelisted;
+}> : TBlocks extends any ? IsNestable<TBlocks> extends true ? TBlocks : never : never;
+/** Resolves a field definition to its runtime content value type (read). */
+type FieldValue<TField extends Field = Field, TBlocks = NoBlocks$1> = Prettify<TField extends {
+  type: 'bloks';
+} ? [TBlocks] extends [never] ? BlockContentBase[] : [TBlocks] extends [Block] ? BlockContent<ApplyWhitelist<TField, TBlocks>, TBlocks>[] : BlockContentBase[] : FieldTypeValueMap[TField['type']]>;
+//#endregion
+//#region src/editable.d.ts
+declare function storyblokEditable(block?: Pick<BlockContent, '_editable'>): {
   'data-blok-c'?: undefined;
   'data-blok-uid'?: undefined;
 } | {
@@ -12,6 +1186,18 @@ declare function storyblokEditable(blok?: Blok): {
   'data-blok-uid': string;
 };
 //#endregion
+//#region src/generated/types/story.d.ts
+/**
+ * Registry of all blocks, threaded through to resolve nested `bloks` fields.
+ * `NoBlocks` (the default) leaves nested content loose (`BlockContentBase`).
+ */
+type NoBlocks = false;
+type CapiStoryWithSchemaContent<TBlock extends RootBlock = RootBlock, TBlocks = NoBlocks> = Override<CapiStory, {
+  content: BlockContent<TBlock, TBlocks>;
+}>;
+/** A Storyblok CDN (CAPI) story. */
+type Story<TBlockOrBlocks extends RootBlock | Block = RootBlock, TBlocks = NoBlocks> = Prettify<[TBlockOrBlocks] extends [RootBlock] ? CapiStoryWithSchemaContent<TBlockOrBlocks, TBlocks> : TBlocks extends NoBlocks ? CapiStoryWithSchemaContent<Extract<TBlockOrBlocks, RootBlock>, TBlockOrBlocks> : never>;
+//#endregion
 //#region src/loadStoryblokBridge.d.ts
 /**
  * Get or create a StoryblokBridge instance.
@@ -21,115 +1207,21 @@ declare function storyblokEditable(blok?: Blok): {
  */
 declare function loadStoryblokBridge(config?: BridgeParams$1): Promise<StoryblokBridge>;
 //#endregion
-//#region ../js-client/dist/index.d.mts
-interface ISbComponentType<T extends string> {
-  _uid?: string;
-  component?: T;
-  _editable?: string;
-}
-interface PreviewToken {
-  token: string;
-  timestamp: string;
-}
-interface LocalizedPath {
-  path: string;
-  name: string | null;
-  lang: string;
-  published: boolean;
-}
-interface ISbStoryData<Content = ISbComponentType<string> & {
-  [index: string]: any;
-}> extends ISbMultipleStoriesData {
-  alternates: ISbAlternateObject[];
-  breadcrumbs?: ISbLinkURLObject[];
-  content: Content;
-  created_at: string;
-  deleted_at?: string;
-  default_full_slug?: string | null;
-  default_root?: string;
-  disable_fe_editor?: boolean;
-  favourite_for_user_ids?: number[] | null;
-  first_published_at?: string | null;
-  full_slug: string;
-  group_id: string;
-  id: number;
-  imported_at?: string;
-  is_folder?: boolean;
-  is_startpage?: boolean;
-  lang: string;
-  last_author?: {
-    id: number;
-    userid: string;
-  };
-  last_author_id?: number;
-  localized_paths?: LocalizedPath[] | null;
-  meta_data: any;
-  name: string;
-  parent?: ISbStoryData;
-  parent_id: number | null;
-  path?: string;
-  pinned?: '1' | boolean;
-  position: number;
-  preview_token?: PreviewToken;
-  published?: boolean;
-  published_at: string | null;
-  release_id?: number | null;
-  scheduled_date?: string | null;
-  slug: string;
-  sort_by_date: string | null;
-  tag_list: string[];
-  translated_slugs?: {
-    path: string;
-    name: string | null;
-    lang: ISbStoryData['lang'];
-    published: boolean;
-  }[] | null;
-  unpublished_changes?: boolean;
-  updated_at?: string;
-  uuid: string;
-}
-interface ISbMultipleStoriesData {
-  by_ids?: string;
-  by_uuids?: string;
-  contain_component?: string;
-  excluding_ids?: string;
-  filter_query?: any;
-  folder_only?: boolean;
-  full_slug?: string;
-  in_release?: string;
-  in_trash?: boolean;
-  is_published?: boolean;
-  in_workflow_stages?: string;
-  page?: number;
-  pinned?: '1' | boolean;
-  search?: string;
-  sort_by?: string;
-  starts_with?: string;
-  story_only?: boolean;
-  text_search?: string;
-  with_parent?: number;
-  with_slug?: string;
-  with_tag?: string;
-}
-interface ISbAlternateObject {
-  id: number;
-  name: string;
-  slug: string;
-  published: boolean;
-  full_slug: string;
-  is_folder: boolean;
-  parent_id: number;
-}
-interface ISbLinkURLObject {
-  id: number;
-  name: string;
-  slug: string;
-  full_slug: string;
-  url: string;
-  uuid: string;
-}
-//#endregion
 //#region src/onStoryblokEditorEvent.d.ts
+/**
+ * The story payload delivered by the Visual Editor `input` event.
+ *
+ * The Preview Bridge streams a story whose full runtime shape is not
+ * guaranteed to match the CDN API. Only `id`, `uuid`, and `content` are
+ * relied upon here — their types are sourced from the supplied {@link Story}
+ * generic — while every other field is left as `unknown` rather than
+ * over-promising a fully typed CDN story.
+ *
+ * @typeParam TStory - The schema-aware {@link Story} to source field types from.
+ */
+type LivePreviewStory<TStory extends Story = Story> = Prettify<Pick<TStory, 'id'> & Partial<Pick<TStory, 'uuid' | 'content'>> & {
+  [key: string]: unknown;
+}>;
 /**
  * Registers a callback for Storyblok Visual Editor live preview updates.
  *
@@ -144,7 +1236,7 @@ interface ISbLinkURLObject {
  * Multiple listeners can be registered simultaneously. Each call returns
  * a cleanup function that removes the registered listener.
  *
- * @typeParam T - The Storyblok component schema type.
+ * @typeParam TStory - The schema-aware {@link Story} type to type the payload against.
  *
  * @param callback
  * Callback executed when the Visual Editor sends an `input` event.
@@ -166,7 +1258,7 @@ interface ISbLinkURLObject {
  * cleanup()
  * ```
  */
-declare function onStoryblokEditorEvent<T extends ISbComponentType<string> = ISbComponentType<string>>(callback: (story: ISbStoryData<T>) => void, bridgeOptions?: BridgeParams$1): Promise<() => void>;
+declare function onStoryblokEditorEvent<TStory extends Story = Story>(callback: (story: LivePreviewStory<TStory>) => void, bridgeOptions?: BridgeParams$1): Promise<() => void>;
 //#endregion
 //#region src/utils/isInEditor.d.ts
 /**
@@ -210,5 +1302,5 @@ interface StoryblokValidationOptions {
  */
 declare function isInEditor(url: URL, options?: StoryblokValidationOptions): boolean;
 //#endregion
-export { type BridgeParams, type ISbComponentType, type ISbStoryData, isInEditor, loadStoryblokBridge, onStoryblokEditorEvent, storyblokEditable };
+export { type Block, type BlockContent, type BridgeParams, type LivePreviewStory, type Story, isInEditor, loadStoryblokBridge, onStoryblokEditorEvent, storyblokEditable };
 //# sourceMappingURL=index.d.mts.map