Skip to content

Vizel API / core/src

core/src

Classes

ClassDescription
VizelErrorStructured error class for Vizel operations.
VizelPluginManagerManages Vizel plugins: registration, lifecycle, extensions, and styles.

Interfaces

InterfaceDescription
CreateVizelEditorInstanceOptionsOptions for creating a Vizel editor instance. Extends VizelEditorOptions with additional framework-specific parameters.
CreateVizelEditorInstanceResultResult of creating a Vizel editor instance.
Editor-
SlashItemTextTitle and description for a slash menu item
VizelAdapterSymbolPublic symbol that an adapter exports for a feature.
VizelAriaContractAccessibility contract for a feature's root element.
VizelAutoSaveOptionsAuto-save configuration options
VizelAutoSaveStateAuto-save state
VizelBlockClipboardOptionsOptions for the block-aware clipboard extension.
VizelBlockMenuActionA single block menu action definition.
VizelBlockMenuFromCommandsOptionsOptions accepted by buildVizelBlockMenuSpecFromCommands.
VizelBlockMenuItemViewItem-data shape surfaced to the framework VizelBlockMenu component for each block action.
VizelBlockMenuOpenDetailEvent detail for block menu open requests. Dispatched when the drag handle is clicked (not dragged).
VizelBlockMenuSpecThe complete block-menu skeleton: main menu + submenu trigger + submenu.
VizelBlockMenuSubmenuTriggerSpecThe submenu trigger metadata. The trigger is a role="menuitem" button rendered after the action groups, opens the "Turn into" submenu, and advertises that via aria-haspopup + aria-expanded.
VizelBlockMenuTriggerControllerReturned by createVizelBlockMenuTriggerController.
VizelBlockMenuTriggerControllerOptionsOptions for createVizelBlockMenuTriggerController.
VizelBlockMenuTurnIntoItemViewItem-data shape surfaced for each "Turn into" submenu entry.
VizelBlockPathSegmentA single segment of a block path produced by getVizelBlockPath.
VizelBubbleMenuActionA single bubble-menu action definition.
VizelBubbleMenuEscapeControllerReturned by createVizelBubbleMenuEscapeController.
VizelBubbleMenuEscapeControllerOptionsOptions for createVizelBubbleMenuEscapeController.
VizelBubbleMenuSpecOptionsOptions accepted by buildVizelBubbleMenuSpec.
VizelCalloutOptionsOptions for the Callout extension.
VizelCharacterCountOptions-
VizelCharacterCountStorageCharacter count storage interface for accessing count values.
VizelCodeBlockLanguageLanguage definition for the code block language selector
VizelCodeBlockOptionsOptions for creating the code block lowlight extension
VizelCollaborationOptionsOptions for collaboration state management
VizelCollaborationProviderMinimal collaboration-provider interface.
VizelCollaborationStateCollaboration connection state
VizelCollaborationUserUser information for collaboration cursor display
VizelColorDefinitionColor definition for text color and highlight
VizelCommandUnified runtime-bearing command shared across editor surfaces.
VizelCommandShortcutsOptionsOptions accepted by createVizelCommandShortcutsExtension.
VizelCommandSpecActionable item shared across command surfaces.
VizelCommandSurfaceSetSet of surfaces a VizelCommand participates in.
VizelCommentA comment annotation on the document
VizelCommentMarkOptionsOptions for the comment mark extension
VizelCommentOptionsConfiguration options for comment management
VizelCommentPluginStatePlugin state for tracking the active comment
VizelCommentReplyA reply to a comment
VizelCommentStateComment state
VizelContentNodeJSON content type for Tiptap documents
VizelCreateEditorOptionsOptions for creating a Vizel editor instance with framework hooks/composables/runes. Extends VizelEditorOptions with ability to add custom Tiptap extensions.
VizelCreateUploadEventHandlerOptionsOptions for creating an image upload event handler.
VizelDetailsContentOptionsOptions for the VizelDetailsContent extension
VizelDetailsNodeOptionsOptions for the Details container extension
VizelDetailsOptionsCombined options for all VizelDetails extensions
VizelDetailsSummaryOptionsOptions for the VizelDetailsSummary extension
VizelDiagramOptionsOptions for the Diagram extension
VizelDragHandleOptions-
VizelEditorOptionsEditor configuration options
VizelEditorStateEditor state for external consumption
VizelEditorSubscriptionOptionsOptions for createVizelEditorSubscription.
VizelEditorTransactionStoreFramework-agnostic store that exposes editor transaction notifications.
VizelEmbedDataEmbed metadata returned from fetch
VizelEmbedOptionsEmbed extension options
VizelEmbedProvideroEmbed provider definition
VizelErrorOptionsOptions accepted by the VizelError constructor.
VizelExtensionsOptions-
VizelFeatureAdaptersPer-framework adapter declaration for a single feature.
VizelFeatureDefinitionSingle feature definition consumed by pnpm check:feature-parity.
VizelFeatureOptionsFeature configuration for Vizel editor.
VizelFileHandlerErrorFile handler error
VizelFileHandlerOptionsOptions for file handler extension
VizelFindMatchRepresents a single match in the document
VizelFindReplaceOptionsOptions for the Find & Replace extension
VizelFindReplaceSpecDerived display state for the VizelFindReplace panel. Each framework component recomputes this whenever the plugin state changes, then drives rendering off the boolean / string fields instead of duplicating the matchCount > 0 ? "${i}/${n}" : noResults ternary in three places.
VizelFindReplaceStateInternal state for the Find & Replace plugin
VizelFlavorConfigMarkdown flavor configuration consumed by extensions that need flavor-specific serialization tuning (callout output style, wiki-link bracket style).
VizelFormFieldAttrsARIA attributes for a single form field.
VizelFormFieldSpecSpec for a single form field.
VizelFormRootAttrsARIA attributes for the form root.
VizelFormSpecSpec for an inline input form.
VizelGridCellAttrsARIA attributes for a single grid cell.
VizelGridCellSpecSpec for a single cell inside a grid.
VizelGridRootAttrsARIA attributes for a grid root.
VizelGridSpecSpec for a two-dimensional grid (color picker, future emoji picker).
VizelHighlightOptionsOptions for the highlight extension.
VizelIconContextValueContext value for icon customization. Used by framework-specific icon providers.
VizelIconRendererOptionsIcon renderer options for customization.
VizelImageFeatureOptionsImage feature options.
VizelImageFileHandlerOptionsCreate file handler handlers for image upload integration.
VizelImageFileHandlers-
VizelImageOptions-
VizelImageResizeOptionsOptions for image resize functionality
VizelImageUploadOptionsOptions for image upload extension
VizelImageUploadPluginOptionsImage upload plugin options
VizelImageUploadWithFileHandlerOptionsOptions for image upload with file handler
VizelImageValidationErrorImage validation error
VizelKeyboardMapKeyboard bindings keyed by canonical command name.
VizelLinkEditorLabelsLocalized labels for the VizelLinkEditor form, resolved from a VizelLocale (with sensible English fallbacks).
VizelLinkEditorSpecDerived display state for the VizelLinkEditor form. The framework component recomputes this whenever url (or the editor selection) changes, then drives conditional rendering from the boolean flags.
VizelLinkOptions-
VizelLinkSubmitParamsParameters accepted by applyVizelLinkEdit.
VizelLocaleLocale definition for all Vizel UI strings.
VizelMarkdownEncodingOptionsPer-node encoding mode map.
VizelMarkdownFlavorFirst-class Markdown flavor plugin.
VizelMarkdownItInstanceMinimal subset of the markdown-it parser instance that flavor plugins interact with at registration time.
VizelMarkdownOptionsConfiguration options for the Vizel Markdown extension.
VizelMarkdownSyncHandlersCreate debounced markdown sync handlers. This is a framework-agnostic helper that frameworks can use to implement their own hooks.
VizelMarkdownSyncOptionsOptions for Markdown synchronization
VizelMarkdownSyncResultResult of Markdown synchronization.
VizelMathematicsOptionsOptions for the Mathematics extension
VizelMentionItemA single mention item for the suggestion list.
VizelMentionItemViewItem-data shape surfaced to the framework VizelMentionMenu component.
VizelMentionOptionsOptions for the mention extension.
VizelMenuItemAttrsARIA attributes accepted on each item element inside the menu.
VizelMenuItemSpecA single item slot in the menu spec.
VizelMenuRootAttrsARIA attributes accepted on the menu root element.
VizelMenuSectionSpecA group of items rendered together, optionally preceded by a header.
VizelMenuSpecThe complete menu spec: root container attrs + sections.
VizelMountPortalOptionsOptions for mounting portal content.
VizelMultiBlockSelectionOptionsOptions for the multi-block range selection extension.
VizelMultiBlockSelectionStatePublic plugin state for the multi-block range selection extension.
VizelNodeSelectorItemViewItem-data shape surfaced for each block-type option in the VizelNodeSelector popover.
VizelNodeSelectorSpecThe complete node-selector skeleton: trigger + popover.
VizelNodeSelectorTriggerSpecTrigger button metadata. The trigger displays the currently-active block type's icon + label, falls back to the locale-aware "Text" label when no node type matches, and advertises the popover as a listbox.
VizelNodeTypeOptionNode type option for the node selector dropdown
VizelOutlineItemSpecOne entry in a document outline tree.
VizelOutlineSpecFramework-neutral spec for the VizelOutline component.
VizelPluginPlugin interface for extending Vizel with third-party functionality.
VizelPopoverBodySpecARIA attributes for the floating body element of a popover.
VizelPopoverControllerReturned by createVizelPopoverController.
VizelPopoverControllerOptionsOptions for createVizelPopoverController.
VizelPopoverSpecSpec for an anchored popover.
VizelPopoverTriggerSpecARIA attributes for the trigger element of a popover.
VizelPresenceAwarenessMinimal awareness interface that Vizel's presence extension consumes.
VizelPresenceOptionsConfiguration for the presence extension.
VizelPresenceUserA collaborator's identity for presence rendering.
VizelPresenceUserStatePer-user awareness state shared with other collaborators.
VizelRelativeTimeTickerReturned by createVizelRelativeTimeTicker.
VizelRelativeTimeTickerOptionsOptions for createVizelRelativeTimeTicker.
VizelResizableImageOptionsConfiguration options for the VizelResizableImage extension. These are passed to VizelResizableImage.configure().
VizelResolveFeaturesOptionsOptions for resolving features with a custom slash menu renderer.
VizelRoundtripSampleA single Markdown round-trip sample.
VizelSaveIndicatorViewResolved view-model for the framework VizelSaveIndicator components.
VizelShortcutPlatform-specific keyboard shortcut.
VizelShortcutSpecPlatform-specific keyboard shortcut.
VizelSlashCommandExtensionOptions-
VizelSlashCommandOptionsSlash command feature options
VizelSlashCommandStorageReactive storage published to framework suggestion renderers.
VizelSlashMenuFromCommandsOptionsOptions accepted by buildVizelSlashMenuSpecFromCommands.
VizelSuggestionContainerA managed suggestion container with positioning support.
VizelSuggestionRendererOptionsOptions shared by every Tiptap suggestion renderer (slash menu, mention menu, future suggestion-driven surfaces).
VizelSystemThemeListenerReturned by createVizelSystemThemeListener.
VizelTableControlsUIOptionsOptions for table controls UI (column/row insert buttons, row handle menu).
VizelTableMenuItem-
VizelTableOfContentsOptionsOptions for the Table of Contents extension.
VizelTableOptions-
VizelTaskItemOptions-
VizelTaskListExtensionsOptions-
VizelTaskListOptions-
VizelTextColorOptionsOptions for text color extensions.
VizelTextSegmentA segment of text that may or may not be highlighted.
VizelThemeInitScriptOptionsOptions for vizelThemeInitScript.
VizelThemeProviderOptionsTheme provider options
VizelThemeStateTheme state returned by useTheme hooks
VizelTOCHeadingA heading entry in the Table of Contents.
VizelToolbarActionA single toolbar action definition.
VizelToolbarDropdownActionA dropdown toolbar action that groups multiple sub-actions. When clicked, displays a popover with the nested options.
VizelToolbarDropdownItemViewItem-data shape surfaced to the framework VizelToolbarDropdown component for each option in the popover listbox.
VizelToolbarDropdownSpecThe complete toolbar-dropdown skeleton: trigger + popover.
VizelToolbarDropdownTriggerSpecTrigger button metadata. The trigger advertises the popover as a listbox via aria-haspopup="listbox" and reflects the open state in aria-expanded. The visible icon + label follow the currently-active option (when getActiveOption is supplied) — for an unset state the dropdown's own icon + label are used.
VizelToolbarSpecOptionsOptions accepted by buildVizelToolbarSpec.
VizelVersionHistoryOptionsConfiguration options for version history
VizelVersionHistoryStateVersion history state
VizelVersionSnapshotA snapshot of the document at a point in time
VizelWikiLinkOptionsOptions for the Wiki Link extension
VizelWikiLinkSuggestionSuggestion item for wiki link autocomplete
VizelYjsAwarenessInterface matching the Yjs Awareness API. Compatible with y-protocols/awareness Awareness class.
VizelYjsProviderInterface matching Yjs WebSocket provider API. Compatible with y-websocket WebsocketProvider and similar providers that emit "status" and "sync" events.
WrapAsVizelErrorOptionsOptions for wrapping an unknown error as a VizelError.

Type Aliases

Type AliasDescription
CustomIconMapCustom icon mappings to override default Iconify icon IDs. Keys are semantic icon names, values are Iconify icon IDs.
GraphvizEngineGraphViz layout engine options
VizelBlockMenuIconNameIcon names used in Block Menu.
VizelBubbleMenuIconNameIcon names used in BubbleMenu toolbar.
VizelCalloutMarkdownFormatCallout / admonition output format for Markdown serialization.
VizelCalloutTypeAvailable callout types
VizelCommentStorageStorage backend for comments.
VizelDiagramTypeSupported diagram types
VizelDOMRectGetterA function that returns a DOMRect or null. Used by Tiptap's suggestion system for positioning.
VizelEditorEventNameEditor event names that createVizelEditorSubscription can attach to.
VizelEmbedTypeEmbed type based on available metadata
VizelEmbedViewModelDiscriminated view-model for the framework VizelEmbedView components.
VizelErrorCodeError codes for Vizel operations.
VizelErrorSeveritySeverity of a VizelError.
VizelFeatureCategoryCategory that groups features by their UI role.
VizelFeatureIdStable identifier for every advertised Vizel feature.
VizelFetchEmbedDataFnFunction to fetch embed data from URL This should be provided by the user to handle CORS
VizelFileHandlerErrorTypeFile handler error types
VizelIconNameAll icon names used in Vizel.
VizelIconRendererIcon renderer function type. Framework packages inject their implementation to render icons as SVG strings.
VizelIconRendererWithOptionsExtended icon renderer function type with options support.
VizelImageValidationErrorTypeImage validation error types
VizelInternalIconNameIcon names used internally in NodeView rendering (drag handle, table controls). These icons are rendered via the injected VizelIconRenderer from framework packages.
VizelLocalePartial-
VizelMarkdownLossyEncodingModeEncoding mode for nodes that lack a clean markdown representation.
VizelMarkSerializerSerializer hook for a Tiptap mark type.
VizelNodeSerializerSerializer hook for a Tiptap node type.
VizelNodeTypeIconNameIcon names used in node type selector.
VizelPopoverPlacementSide the body prefers to sit on relative to the anchor.
VizelPortalLayerPortal layer type
VizelResolvedThemeResolved theme (actual applied theme)
VizelSaveStatusSave status type
VizelSlashCommandIconNameIcon names used in slash commands and menus. These are semantic names that map to actual icons in framework packages.
VizelStorageBackendStorage backend abstraction shared by auto-save, comment, and version-history features.
VizelTableCellAlignmentText alignment options for table cells.
VizelTableControlsOptionsCombined options for table with controls - extends Table's options with UI controls.
VizelTableIconNameIcon names used in table controls.
VizelThemeAvailable theme options
VizelToolbarActionItemUnion type for any toolbar item — either a simple action or a dropdown.
VizelToolbarIconNameIcon names used in Toolbar.
VizelTypographyOptionsOptions for the typography extension.
VizelUIIconNameIcon names used in UI components (SaveIndicator, etc.).
VizelUploadImageFnImage upload function type
VizelVersionStorageStorage backend for version history.

Variables

VariableDescription
VIZEL_BLOCK_MENU_EVENTCustom event name for block menu open requests
VIZEL_DEFAULT_AUTO_SAVE_OPTIONSDefault auto-save options
VIZEL_DEFAULT_COLLABORATION_OPTIONSDefault collaboration options
VIZEL_DEFAULT_COMMENT_OPTIONSDefault comment options
VIZEL_DEFAULT_FILE_MIME_TYPESDefault allowed MIME types (images only)
VIZEL_DEFAULT_FLAVORDefault Markdown flavor (GitHub Flavored Markdown).
VIZEL_DEFAULT_IMAGE_MAX_FILE_SIZEDefault maximum file size for images (20MB)
VIZEL_DEFAULT_MARKDOWN_DEBOUNCE_MSDefault debounce delay for markdown export in milliseconds.
VIZEL_DEFAULT_THEMEDefault theme configuration
VIZEL_DEFAULT_THEME_STORAGE_KEYDefault storage key for persisting theme preference
VIZEL_DEFAULT_VERSION_HISTORY_OPTIONSDefault version history options
VIZEL_FEATURE_MANIFESTThe authoritative feature catalogue. Add, modify, and remove entries here together with the corresponding adapter and scenario changes; the parity check fails the build when an adapter omits a declared symbol.
VIZEL_HIGHLIGHT_COLORSExtended highlight color palette (lighter/pastel colors)
VIZEL_PORTAL_IDPortal container ID
VIZEL_PORTAL_Z_INDEXPortal layer z-index values
VIZEL_SUGGESTION_Z_INDEXDefault z-index for suggestion containers.
VIZEL_TABLE_MENU_ITEMSCombined menu items (legacy, for reference)
VIZEL_TEXT_COLORSExtended text color palette with gradient-like arrangement
VIZEL_THEME_DATA_ATTRIBUTEData attribute used for theme application
VIZEL_UPLOAD_IMAGE_EVENTThe custom event name for image uploads from slash commands.
vizelBlockClipboardPluginKeyPlugin key for the block-aware clipboard plugin. The plugin holds no persistent state — the key exists so consumers can detect that the plugin is installed.
vizelBlockCommandsBlock-level commands that change the current block's node type (headings, lists, quote, code block, divider, details, callout).
VizelBlockMoveKeymapExtension for keyboard shortcuts to move blocks up/down. Alt+ArrowUp moves block up, Alt+ArrowDown moves block down. Supports moving list items within their parent list.
vizelBlockOperationCommandsBuilt-in block-operation commands.
VizelCalloutThe Callout node extension.
VizelCommentMarkComment mark extension for highlighting annotated text.
vizelCommentPluginKeyPlugin key for accessing comment plugin state
vizelCommonMarkFlavorCommonMark flavor — the lowest-common-denominator spec.
vizelDefaultBlockMenuActionsDefault block menu actions providing common block operations.
vizelDefaultBubbleMenuActionsDefault bubble-menu actions, locale-resolved.
vizelDefaultCommandsConcatenation of the four built-in command registries.
vizelDefaultEditorPropsDefault editor props for Vizel editors.
vizelDefaultEmbedProvidersDefault oEmbed providers.
vizelDefaultIconIdsDefault Iconify icon IDs for each icon name. Uses Lucide icons as the default set. Users can override these by providing their own icon mappings.
vizelDefaultNodeTypesDefault node types available in the node selector
vizelDefaultSlashMenuCommandsDefault slash command list: the subset of vizelDefaultCommands that opts into the slash menu surface.
vizelDefaultToolbarActionsDefault toolbar actions providing common formatting operations.
VizelDiagramDiagram extension for block diagrams
vizelDocusaurusFlavorDocusaurus / VitePress / Zenn / Qiita flavor.
VizelEmbedEmbed node extension
vizelEmbedPastePluginKeyPlugin key for embed paste handler
vizelEnLocaleDefault English locale for Vizel editor.
vizelFindReplacePluginKeyPlugin key for accessing Find & Replace state
vizelFormatCommandsMark-level format commands (bold, italic, strike, etc.).
vizelGfmFlavorGitHub Flavored Markdown.
VizelImageResizeResizableImage Extension
vizelInsertCommandsInsert commands that create new nodes (table, image, embed, math, diagram, table of contents).
VizelMarkdownPre-configured Markdown extension with default settings.
VizelMathBlockMathematics extension for block math expressions
VizelMathInlineMathematics extension for inline math expressions
vizelMultiBlockSelectionPluginKeyPlugin key for the multi-block range selection extension. Use vizelMultiBlockSelectionPluginKey.getState(state) to read the current block range from a Tiptap or ProseMirror editor state.
vizelObsidianFlavorObsidian-style Markdown.
vizelPandocFlavorPandoc-flavored Markdown.
vizelPresencePluginKey-
VizelSlashCommand-
VizelTableExtended Table with Markdown serialization support.
VizelTableCellExtended TableCell with textAlign attribute support.
VizelTableHeaderExtended TableHeader with textAlign attribute support.
VizelTableWithControlsVizelTableWithControls - Table extension with interactive controls
VizelWikiLinkWiki Link mark extension for Vizel editor.
vizelWikiLinkPluginKeyPlugin key for accessing Wiki Link plugin state

Functions

FunctionDescription
addVizelRecentColorAdd a color to recent colors
applyVizelColorToEditorApply a color to the current selection.
applyVizelLinkEditApply the link-editor submission to the editor.
applyVizelThemeApply theme to target element
assertMarkdownRoundtripAssert that every sample round-trips losslessly through the given flavor.
buildVizelBlockMenuSpecBuild a VizelBlockMenuSpec for the block context menu.
buildVizelBlockMenuSpecFromCommandsBuild the block-menu action list from a VizelCommand array.
buildVizelBubbleMenuSpecBuild the bubble-menu spec from a VizelCommand array.
buildVizelFindReplaceSpecCompute the find-replace panel display state.
buildVizelFindReplaceSpecFromLocaleConvenience overload that resolves the noResults label from a full locale. Equivalent to calling buildVizelFindReplaceSpec(state, locale?.findReplace?.noResults ?? "No matches").
buildVizelLinkEditorSpecCompute the link-editor display state from the live editor + URL input.
buildVizelMentionMenuSpecBuild a VizelMenuSpec for the mention autocomplete menu.
buildVizelNodeSelectorSpecBuild a VizelNodeSelectorSpec for the node-type selector.
buildVizelOutlineSpecBuild the outline spec from an editor's current document.
buildVizelSlashMenuSpecFromCommandsBuild a VizelMenuSpec for the slash menu from a VizelCommand array.
buildVizelToolbarDropdownSpecBuild a VizelToolbarDropdownSpec for the toolbar dropdown.
buildVizelToolbarSpecBuild the toolbar spec from a VizelCommand array.
composeVizelMarkdownFlavorsCombine multiple flavors into a single derived flavor.
convertVizelCodeBlocksToDiagramsConvert all diagram code blocks in a document to diagram nodes. This command should be called after importing markdown content. Supports mermaid, dot, and graphviz code blocks.
createLazyLoaderCreates a lazy loader for an optional dependency. Caches the loaded module to avoid repeated dynamic imports.
createVizelAutoSaveHandlersCreates auto-save handlers for an editor
createVizelBlockClipboardExtensionCreate the block-aware clipboard extension. The extension is part of the always-on core and is wired into createBaseExtensions.
createVizelBlockMenuActionsCreate block menu actions with locale-specific labels.
createVizelBlockMenuTriggerControllerBuild a controller that subscribes to VIZEL_BLOCK_MENU_EVENT.
createVizelBubbleMenuActionsCreate bubble-menu actions with locale-specific labels.
createVizelBubbleMenuEscapeControllerBuild a controller that collapses the editor's selection when the user presses Escape while the bubble menu is open.
createVizelCalloutExtensionCreate a configured Callout extension.
createVizelCharacterCountExtensionCreates the character count extension for tracking content statistics.
createVizelCodeBlockExtensionCreate the CodeBlockLowlight extension with syntax highlighting.
createVizelCollaborationHandlersCreate collaboration handlers for tracking provider state and managing lifecycle.
createVizelCommandShortcutsExtensionCreate a Tiptap extension that binds the keyboard shortcuts declared by a VizelCommand array.
createVizelCommentExtensionCreate the comment mark extension with configured options
createVizelCommentHandlersCreates comment handlers for an editor.
createVizelDefaultFetchEmbedDataCreate default fetchEmbedData function that works client-side
createVizelDetailsExtensionsCreates details extensions for collapsible content blocks.
createVizelDiagramExtensionCreate the Diagram extension
createVizelDragHandleExtensionCreates a DragHandle extension with default styling. The drag handle appears on the left side of blocks when hovering. Clicking (not dragging) the handle opens the block menu.
createVizelDragHandleExtensionsCreates the complete drag handle extension set including: - Visual drag handle on block hover - Keyboard shortcuts for block movement (Alt+Up/Down)
createVizelEditorInstanceCreate a configured Vizel editor instance.
createVizelEditorSubscriptionAttach an editor event listener with a clean disposer.
createVizelEditorTransactionStoreCreate a VizelEditorTransactionStore that observes whichever editor getEditor currently returns. The factory is framework-agnostic; each framework wraps the store in its native reactivity primitive.
createVizelEmbedExtensionCreate embed extension with options
createVizelErrorCreate a VizelError instance. Convenience wrapper around new VizelError(...).
createVizelExtensionsCreate the default set of extensions for Vizel editor. All features are enabled by default. Set any feature to false to disable it.
createVizelFileHandlerExtensionCreate a file handler extension with unified drop/paste handling.
createVizelFindReplaceExtensionCreate the Find & Replace extension
createVizelHighlightExtensionCreate the highlight mark extension.
createVizelImageExtensionCreate a configured Image extension for Vizel editor.
createVizelImageFileHandlers-
createVizelImageUploaderCreate an image uploader function
createVizelImageUploadExtensionsCreate Image extension with upload support (drag-and-drop, paste, file picker).
createVizelImageUploadPluginCreate an image upload plugin with decoration-based placeholders
createVizelImageUploadWithFileHandlerCreate Image extension with upload support using @tiptap/extension-file-handler.
createVizelLinkExtensionCreate a link extension for Vizel editor.
createVizelLocaleCreate a complete locale by deep-merging partial translations with the default English locale. Supports overriding individual strings at any nesting depth.
createVizelMarkdownExtensionCreate a configured Markdown extension.
createVizelMarkdownSyncHandlersCreate markdown sync handlers for framework implementations.
createVizelMathematicsExtensionsCreate the Mathematics extensions
createVizelMentionExtensionCreate the Vizel mention extension.
createVizelMultiBlockSelectionExtensionCreate the multi-block range selection extension. The extension is part of the always-on core and carries no opt-in feature flag.
createVizelNodeTypesCreate node type options with locale-specific labels.
createVizelPopoverControllerBuild a controller for an anchored popover.
createVizelPortalElementCreate a portal element with proper styling.
createVizelPresenceExtensionCreate the presence extension.
createVizelRelativeTimeTickerBuild a relative-time interval ticker.
createVizelSuggestionContainerCreate a positioned container for suggestion popups.
createVizelSystemThemeListenerBuild a controller for system theme (prefers-color-scheme) changes.
createVizelTableExtensionsCreate table extensions for Vizel editor. Returns an array of extensions: Table, TableRow, TableHeader, TableCell.
createVizelTableOfContentsExtensionCreate the Vizel Table of Contents extension.
createVizelTaskListExtensionsCreates task list extensions for checkbox/todo functionality.
createVizelTextColorExtensionsCreate text color mark extensions (TextStyle + Color).
createVizelToolbarActionsCreate toolbar actions with locale-specific labels.
createVizelTypographyExtensionCreate the typography extension.
createVizelUploadEventHandlerCreates an event handler for the vizel:upload-image custom event. This handler is used by the slash command to trigger image uploads.
createVizelVersionHistoryHandlersCreates version history handlers for an editor.
createVizelWikiLinkExtensionCreate a configured Wiki Link extension for Vizel editor.
deriveVizelCommandSpecDerive a VizelCommandSpec for a single editor instance.
detectVizelEmbedProviderDetect provider from URL
emitVizelErrorEmit a VizelError through the consumer-supplied onError callback, falling back to console.error when no callback is set and the severity is "error". Warnings without a callback stay silent.
filterVizelBubbleMenuActionsFilter bubble-menu actions down to the ones whose requiresExtension precondition is satisfied by the supplied editor. Returns the original list when no actions declare a precondition.
filterVizelFilesByMimeTypeFilter files by allowed MIME types
findVizelLanguageFind a language by ID. Returns undefined if the code block extension has not been initialized yet.
formatRelativeTimeWithLocaleFormat a relative time string using locale templates. Replaces {n} placeholder with the numeric value.
formatVizelRelativeTimeFormat relative time for display.
formatVizelShortcutFormat a keyboard shortcut for the current platform.
formatVizelTooltipFormat a tooltip string with an optional keyboard shortcut.
getAllVizelLanguageIdsGet all language IDs. Returns an empty array if the code block extension has not been initialized yet.
getNextVizelSlashMenuGroupIndexCompute the next-group jump target for Tab-key navigation.
getStoredVizelThemeGet stored theme from storage
getVizelActiveNodeTypeGet the currently active node type
getVizelBlockPathWalk from the document root to the cursor block and return the path.
getVizelCommentPluginStateGet the current comment plugin state from the editor
getVizelCommentStorageBackend-
getVizelEditorStateExtracts the current editor state from an editor instance. This provides a snapshot of common editor state values including focus, empty status, undo/redo availability, and character/word counts.
getVizelFindReplaceStateGet the current Find & Replace state from the editor
getVizelIconIdGet the Iconify icon ID for a given icon name.
getVizelImageUploadPluginKeyGet the image upload plugin key (for external access)
getVizelMarkdownGet markdown content from the editor.
getVizelMultiBlockSelectionStateRead the current multi-block range from an editor state. Returns null when the selection spans zero or one top-level block.
getVizelPortalContainerGet or create the portal container element.
getVizelRecentColorsGet recent colors from localStorage
getVizelRegisteredLanguagesGet the list of all registered languages (sorted alphabetically). Returns an empty array if the code block extension has not been initialized yet.
getVizelSlashCommandLocaleReturn the locale the slash-command extension resolved at creation time.
getVizelStorageBackendResolve the auto-save storage backend for a document.
getVizelSystemThemeGet the system theme preference
getVizelThemeInitScriptInitialize theme on page load (for SSR/hydration)
getVizelTurnIntoOptionsGet the "Turn into" node type options, filtering out the currently active type.
getVizelVersionStorageBackend-
groupVizelBlockMenuActionsGroup block menu actions by their group identifier.
groupVizelBubbleMenuActionsGroup bubble-menu actions by their group identifier for visual separation.
groupVizelToolbarActionsGet toolbar actions grouped by their group identifier. Supports both simple actions and dropdown actions.
handleVizelImageDropHandle image drop from drag-and-drop
handleVizelImagePasteHandle image paste from clipboard
handleVizelSuggestionEscapeHandle the Escape key for suggestion popups.
hasVizelPortalContainerCheck if the portal container exists.
initializeVizelMarkdownContentInitialize editor with markdown content. This should be called in onCreate callback when using initialMarkdown.
initVizelIconRendererInitialize the Vizel icon renderer with the default Lucide implementation. Call this once when your framework package is loaded.
isVizelErrorType guard to check if a value is a VizelError.
isVizelMacPlatformDetect if the current platform is macOS. Returns false during SSR (no navigator).
isVizelToolbarDropdownActionType guard to check if a toolbar item is a dropdown action.
isVizelValidHexColorValidate if a string is a valid hex color.
loadVizelEmbedScriptsRe-parent any <script> tags inside an oEmbed container so the browser actually executes them (innerHTML-inserted scripts are inert).
mountToVizelPortalMount an element to the portal container.
mountVizelEditorViewMount a Tiptap editor's view.dom into a container element and return a disposer that removes it.
normalizeVizelHexColorNormalize a hex color string to standard format (#RRGGBB uppercase). Handles shorthand (#RGB) conversion and adds # prefix if missing.
parseVizelMarkdownParse markdown to JSON content.
registerVizelUploadEventHandlerRegisters the image upload event handler. Returns a cleanup function to remove the event listener.
removeVizelPortalContainerRemove the portal container from the document.
renderVizelIconRender an internal icon as an SVG string. Uses the injected renderer from framework packages.
renderVizelIconSvgRender an Iconify icon as an SVG string using Lucide icons. This is the default implementation used by framework packages.
resolveVizelEmbedViewResolve an VizelEmbedData into the variant-shaped view-model.
resolveVizelFeaturesResolves feature options with a default slash menu renderer. If interaction.slashMenu is enabled but no suggestion renderer is provided, attaches the supplied default.
resolveVizelFindReplaceLabelsResolve FindReplace locale labels with English defaults.
resolveVizelFlavorConfigResolve the VizelFlavorConfig carried inside a flavor's config field.
resolveVizelLinkEditorLabelsResolve the link-editor labels from a locale (or fall back to English).
resolveVizelPluginDependenciesResolves plugin dependencies via topological sort. Throws if a circular dependency or missing dependency is detected.
resolveVizelSaveIndicatorViewResolve the icon, text, and timestamp visibility for a VizelSaveStatus.
resolveVizelThemeResolve theme to actual applied theme
setVizelIconRendererSet the icon renderer function. Called by framework packages (react, vue, svelte) to inject their Iconify-based implementation.
setVizelMarkdownSet markdown content to the editor.
shallowEqualArrayReturn true when two arrays carry identical references in the same order and the same length.
shallowEqualObjectReturn true when two plain objects share the same own enumerable string keys and identical references for every value.
shouldFlipSubmenuDetermines whether a submenu should open to the left instead of the right.
splitVizelTextByMatchesSplit text into segments based on match indices from fuzzy search.
storeVizelThemeStore theme to storage
transformVizelDiagramCodeBlocksTransform content to convert diagram code blocks to diagram nodes. This is useful when importing markdown content that contains diagrams. Supports mermaid, dot, and graphviz code blocks.
unmountFromVizelPortalUnmount an element from the portal container.
validateVizelImageFileValidate an image file
validateVizelPluginValidate a plugin's required fields and format.
vizelCancelAnimationFrameCancel a previously scheduled animation-frame callback. Becomes a no-op when the underlying API is unavailable or when the handle is the sentinel 0 returned by the SSR fallback path.
vizelCommandsFromNodeTypesDerive a VizelCommand array from a VizelNodeTypeOption array.
vizelDefaultBase64UploadDefault base64 image uploader (converts file to data URL). Use this as the default onUpload handler when no custom uploader is provided.
vizelDefaultFeaturesCurated VizelFeatureOptions value that enables every opt-in feature Vizel ships with reasonable defaults. Use this when you want the full Notion-like surface without enumerating each toggle yourself.
vizelRequestAnimationFrameSchedule callback for the next animation frame, or — when the environment does not implement rAF — for the next microtask. Returns a numeric handle that vizelCancelAnimationFrame accepts.
vizelThemeInitScriptBuild a synchronous theme-initialization script for embedding in the document <head>.
wrapAsVizelErrorWrap an unknown error as a VizelError.

References

VizelResizableImage

Renames and re-exports VizelImageResize

Released under the MIT License.