@blockslides/core 0.3.2 → 0.4.0

package/dist/index.d.mts

@@ -3016,6 +3016,27 @@ declare module '@blockslides/core' {
 }
 declare const unsetMark: RawCommands['unsetMark'];
 
+declare module '@blockslides/core' {
+    interface Commands<ReturnType> {
+        updateAssetUrls: {
+            /**
+             * Update asset URLs across the entire document in a single transaction.
+             * The map keys can be either an `assetId` (preferred for imageBlock nodes)
+             * or the current URL (used as a fallback, and for nodes without an assetId
+             * such as slide/columnGroup backgrounds and video embeds).
+             *
+             * @example
+             * editor.commands.updateAssetUrls({
+             *   'asset-123': 'https://cdn.example.com/fresh-url.jpg',
+             *   'https://old.example.com/bg.jpg': 'https://cdn.example.com/fresh-bg.jpg',
+             * })
+             */
+            updateAssetUrls: (urlMap: Record<string, string>) => ReturnType;
+        };
+    }
+}
+declare const updateAssetUrls: RawCommands['updateAssetUrls'];
+
 declare module '@blockslides/core' {
     interface Commands<ReturnType> {
         updateAttributes: {
@@ -3127,11 +3148,12 @@ declare const index$2_toggleWrap: typeof toggleWrap;
 declare const index$2_undoInputRule: typeof undoInputRule;
 declare const index$2_unsetAllMarks: typeof unsetAllMarks;
 declare const index$2_unsetMark: typeof unsetMark;
+declare const index$2_updateAssetUrls: typeof updateAssetUrls;
 declare const index$2_updateAttributes: typeof updateAttributes;
 declare const index$2_wrapIn: typeof wrapIn;
 declare const index$2_wrapInList: typeof wrapInList;
 declare namespace index$2 {
-  export { type index$2_InsertContentAtOptions as InsertContentAtOptions, type index$2_InsertContentOptions as InsertContentOptions, type index$2_SetContentOptions as SetContentOptions, index$2_blur as blur, index$2_clearContent as clearContent, index$2_clearNodes as clearNodes, index$2_command as command, index$2_createParagraphNear as createParagraphNear, index$2_cut as cut, index$2_deleteCurrentNode as deleteCurrentNode, index$2_deleteNode as deleteNode, index$2_deleteRange as deleteRange, index$2_deleteSelection as deleteSelection, index$2_enter as enter, index$2_exitCode as exitCode, index$2_extendMarkRange as extendMarkRange, index$2_first as first, index$2_focus as focus, index$2_forEach as forEach, index$2_insertContent as insertContent, index$2_insertContentAt as insertContentAt, index$2_joinBackward as joinBackward, index$2_joinDown as joinDown, index$2_joinForward as joinForward, index$2_joinItemBackward as joinItemBackward, index$2_joinItemForward as joinItemForward, index$2_joinTextblockBackward as joinTextblockBackward, index$2_joinTextblockForward as joinTextblockForward, index$2_joinUp as joinUp, index$2_keyboardShortcut as keyboardShortcut, index$2_lift as lift, index$2_liftEmptyBlock as liftEmptyBlock, index$2_liftListItem as liftListItem, index$2_newlineInCode as newlineInCode, index$2_resetAttributes as resetAttributes, index$2_scrollIntoView as scrollIntoView, index$2_selectAll as selectAll, index$2_selectNodeBackward as selectNodeBackward, index$2_selectNodeForward as selectNodeForward, index$2_selectParentNode as selectParentNode, index$2_selectTextblockEnd as selectTextblockEnd, index$2_selectTextblockStart as selectTextblockStart, index$2_setContent as setContent, index$2_setMark as setMark, index$2_setMeta as setMeta, index$2_setNode as setNode, index$2_setNodeSelection as setNodeSelection, index$2_setTextSelection as setTextSelection, index$2_sinkListItem as sinkListItem, index$2_splitBlock as splitBlock, index$2_splitListItem as splitListItem, index$2_toggleList as toggleList, index$2_toggleMark as toggleMark, index$2_toggleNode as toggleNode, index$2_toggleWrap as toggleWrap, index$2_undoInputRule as undoInputRule, index$2_unsetAllMarks as unsetAllMarks, index$2_unsetMark as unsetMark, index$2_updateAttributes as updateAttributes, index$2_wrapIn as wrapIn, index$2_wrapInList as wrapInList };
+  export { type index$2_InsertContentAtOptions as InsertContentAtOptions, type index$2_InsertContentOptions as InsertContentOptions, type index$2_SetContentOptions as SetContentOptions, index$2_blur as blur, index$2_clearContent as clearContent, index$2_clearNodes as clearNodes, index$2_command as command, index$2_createParagraphNear as createParagraphNear, index$2_cut as cut, index$2_deleteCurrentNode as deleteCurrentNode, index$2_deleteNode as deleteNode, index$2_deleteRange as deleteRange, index$2_deleteSelection as deleteSelection, index$2_enter as enter, index$2_exitCode as exitCode, index$2_extendMarkRange as extendMarkRange, index$2_first as first, index$2_focus as focus, index$2_forEach as forEach, index$2_insertContent as insertContent, index$2_insertContentAt as insertContentAt, index$2_joinBackward as joinBackward, index$2_joinDown as joinDown, index$2_joinForward as joinForward, index$2_joinItemBackward as joinItemBackward, index$2_joinItemForward as joinItemForward, index$2_joinTextblockBackward as joinTextblockBackward, index$2_joinTextblockForward as joinTextblockForward, index$2_joinUp as joinUp, index$2_keyboardShortcut as keyboardShortcut, index$2_lift as lift, index$2_liftEmptyBlock as liftEmptyBlock, index$2_liftListItem as liftListItem, index$2_newlineInCode as newlineInCode, index$2_resetAttributes as resetAttributes, index$2_scrollIntoView as scrollIntoView, index$2_selectAll as selectAll, index$2_selectNodeBackward as selectNodeBackward, index$2_selectNodeForward as selectNodeForward, index$2_selectParentNode as selectParentNode, index$2_selectTextblockEnd as selectTextblockEnd, index$2_selectTextblockStart as selectTextblockStart, index$2_setContent as setContent, index$2_setMark as setMark, index$2_setMeta as setMeta, index$2_setNode as setNode, index$2_setNodeSelection as setNodeSelection, index$2_setTextSelection as setTextSelection, index$2_sinkListItem as sinkListItem, index$2_splitBlock as splitBlock, index$2_splitListItem as splitListItem, index$2_toggleList as toggleList, index$2_toggleMark as toggleMark, index$2_toggleNode as toggleNode, index$2_toggleWrap as toggleWrap, index$2_undoInputRule as undoInputRule, index$2_unsetAllMarks as unsetAllMarks, index$2_unsetMark as unsetMark, index$2_updateAssetUrls as updateAssetUrls, index$2_updateAttributes as updateAttributes, index$2_wrapIn as wrapIn, index$2_wrapInList as wrapInList };
 }
 
 declare const Commands$1: Extension<any, any>;
@@ -4066,6 +4088,86 @@ declare function objectIncludes(object1: Record<string, any>, object2: Record<st
     strict: boolean;
 }): boolean;
 
+/**
+ * The node types that can carry asset URLs.
+ */
+type AssetNodeType = 'imageBlock' | 'slide' | 'columnGroup' | 'video';
+/**
+ * A reference to an asset found in the document.
+ *
+ * - `assetId` is the stable identifier set by the application when the asset
+ *   was inserted (only available on `imageBlock` nodes). Use it as the key when
+ *   building the URL map for `updateAssetUrls` or `refreshAssets`.
+ * - `currentUrl` is the URL currently stored in the document. Use it as the
+ *   key for nodes that have no `assetId` (slides, columnGroups, videos).
+ * - `nodeType` lets you filter by content type if needed.
+ */
+interface AssetRef {
+    assetId: string | null;
+    currentUrl: string;
+    nodeType: AssetNodeType;
+}
+/**
+ * A map of lookup key → fresh URL passed to `updateAssetUrls` or returned
+ * from an `AssetResolver`. Keys may be either `assetId` values or raw URLs.
+ */
+type AssetUrlMap = Record<string, string>;
+/**
+ * An async function that receives the current assets and returns a map of
+ * fresh URLs. This is the integration point with your storage provider
+ * (S3, Supabase, Cloudflare R2, your own CDN, etc.).
+ *
+ * @example
+ * const resolver: AssetResolver = async (assets) => {
+ *   const ids = assets.map(a => a.assetId).filter(Boolean)
+ *   const fresh = await myApi.refreshSignedUrls(ids)
+ *   return Object.fromEntries(
+ *     assets.map(a => [a.assetId ?? a.currentUrl, fresh[a.assetId ?? '']])
+ *   )
+ * }
+ */
+type AssetResolver = (assets: AssetRef[]) => Promise<AssetUrlMap>;
+/**
+ * Collect all asset references from the editor document.
+ *
+ * Traverses every node and returns one `AssetRef` per URL-bearing node:
+ * - `imageBlock` nodes (src + optional assetId)
+ * - `slide` nodes with a backgroundImage
+ * - `columnGroup` nodes with a backgroundImage
+ * - `video` nodes (src)
+ *
+ * @example
+ * const assets = getEditorAssets(editor)
+ * // → [{ assetId: 'abc', currentUrl: 'https://...', nodeType: 'imageBlock' }, ...]
+ */
+declare function getEditorAssets(editor: SlideEditor): AssetRef[];
+/**
+ * Refresh all asset URLs in the editor document.
+ *
+ * Collects every asset reference, passes the list to your `resolver` function,
+ * then applies the returned URL map in a single ProseMirror transaction.
+ *
+ * The resolver is where you integrate with your storage provider — fetch
+ * presigned URLs from S3, generate Supabase tokens, call your own API, etc.
+ * Blockslides only handles the document traversal and patching.
+ *
+ * @param editor - The SlideEditor instance.
+ * @param resolver - Async function that receives the asset list and returns
+ *   a map of `{ assetId | currentUrl → freshUrl }`.
+ *
+ * @example
+ * import { refreshAssets } from '@blockslides/core'
+ *
+ * await refreshAssets(editor, async (assets) => {
+ *   const ids = assets.map(a => a.assetId).filter(Boolean)
+ *   const fresh = await myStorage.getSignedUrls(ids)
+ *   return Object.fromEntries(
+ *     assets.map(a => [a.assetId ?? a.currentUrl, fresh[a.assetId ?? '']])
+ *   )
+ * })
+ */
+declare function refreshAssets(editor: SlideEditor, resolver: AssetResolver): Promise<void>;
+
 /**
  * Removes duplicated values within an array.
  * Supports numbers, strings and objects.
@@ -4130,4 +4232,4 @@ interface Commands<ReturnType = any> {
 interface Storage {
 }
 
-export { type AnyCommands, type AnyConfig, type AnyExtension, type AtomBlockMarkdownSpecOptions, type Attribute, type Attributes$1 as Attributes, type BlockMarkdownSpecOptions, type BlockParserConfig, type CanCommands, type ChainedCommands, type ChangedRange, type Command, CommandManager, type CommandProps, type CommandSpec, type Commands, type Content, type CreateNodeFromContentOptions, type DOMNode, type DOMOutputSpecArray$1 as DOMOutputSpecArray, type DecorationType, type DecorationWithType, type Diff, type Dispatch, type DocumentType, SlideEditor as Editor, type EditorEvents, type EditorOptions, type EnableRules, Extendable, type ExtendableConfig, type ExtendedRegExpMatchArray, Extension, type ExtensionAttribute, type ExtensionConfig, type Extensions, type FocusPosition, Fragment, type FullMarkdownHelpers, type GlobalAttributes, type HTMLContent, type InlineMarkdownSpecOptions, InputRule, type InputRuleFinder, type InputRuleMatch, type InsertContentAtOptions, type InsertContentOptions, type JSONContent, type KeyboardShortcutCommand, type KeysWithTypeOf, Mark, type MarkConfig, type MarkRange, type MarkType, MarkView, type MarkViewProps, type MarkViewRenderer, type MarkViewRendererOptions, type MarkViewRendererProps, type MarkdownExtensionSpec, type MarkdownHelpers, type MarkdownLexerConfiguration, type MarkdownParseHelpers, type MarkdownParseResult, type MarkdownRendererHelpers, type MarkdownToken, type MarkdownTokenizer, type MaybeReturnType, type MaybeThisParameterType, Node, type NodeConfig, NodePos, type NodeRange, type NodeType, NodeView, type NodeViewProps, type NodeViewRenderer, type NodeViewRendererOptions, type NodeViewRendererProps, type NodeWithPos, type Overwrite, type ParentConfig, type ParsedBlock, type PartialTheme, PasteRule, type PasteRuleFinder, type PasteRuleMatch, type PickValue, type Predicate, type Primitive, type Range, type RawCommands, type RemoveThis, type RenderContext, type ResolvedTheme, type SetContentOptions, type SingleCommands, SlideEditor, type Storage, type TextSerializer, type TextType, type Theme, type ThemeConfig, type ThemeInput, type TiptapEditorHTMLElement, Tracker, type TrackerResult, type UnionCommands, type UnionToIntersection, type ValuesOf, applyAllLayouts, applyLayoutToColumnGroup, applyLayoutToRow, applyTheme, blur, callOrReturn, canInsertNode, clearContent, clearNodes, combineTransactionSteps, command, index$2 as commands, createAtomBlockMarkdownSpec, createBlockMarkdownSpec, createChainableState, createDocument, h as createElement, createInlineMarkdownSpec, createNodeFromContent, createParagraphNear, createStyleTag, cut, darkTheme, defaultBlockAt, deleteCurrentNode, deleteNode, deleteProps, deleteRange, deleteSelection, elementFromString, enter, escapeForRegEx, exitCode, extendMarkRange, index$1 as extensions, findChildren, findChildrenInRange, findDuplicates, findParentNode, findParentNodeClosestToPos, first, flattenExtensions, focus, forEach, fromString, generateHTML, generateJSON, generateText, getAttributes, getAttributesFromExtensions, getChangedRanges, getDebugJSON, getExtensionField, getHTMLFromFragment, getMarkAttributes, getMarkRange, getMarkType, getMarksBetween, getNodeAtPosition, getNodeAttributes, getNodeType, getRenderedAttributes, getSchema, getSchemaByResolvedExtensions, getSchemaTypeByName, getSchemaTypeNameByName, getSplittedAttributes, getText, getTextBetween, getTextContentFromNodes, getTextSerializersFromSchema, getTheme, getThemeNames, h, injectExtensionAttributesToParseRule, inputRulesPlugin, insertContent, insertContentAt, isActive, isAndroid, isAtEndOfNode, isAtStartOfNode, isEmptyObject, isExtensionRulesEnabled, isFunction, isList, isMacOS, isMarkActive, isNodeActive, isNodeEmpty, isNodeSelection, isNumber, isPlainObject, isRegExp, isString, isTextSelection, isiOS, joinBackward, joinDown, joinForward, joinItemBackward, joinItemForward, joinTextblockBackward, joinTextblockForward, joinUp, keyboardShortcut, lift, liftEmptyBlock, liftListItem, lightTheme, markInputRule, markPasteRule, index as markdown, mergeAttributes, mergeDeep, minMax, newlineInCode, nodeInputRule, nodePasteRule, objectIncludes, parseAttributes, parseIndentedBlocks, parseLayout, pasteRulesPlugin, posToDOMRect, registerTheme, removeDuplicates, renderNestedMarkdownContent, resetAttributes, resolveExtensions, resolveFocusPosition, resolveTheme, rewriteUnknownContent, scrollIntoView, selectAll, selectNodeBackward, selectNodeForward, selectParentNode, selectTextblockEnd, selectTextblockStart, selectionToInsertionEnd, serializeAttributes, setContent, setMark, setMeta, setNode, setNodeSelection, setTextSelection, sinkListItem, sortExtensions, splitBlock, splitExtensions, splitListItem, textInputRule, textPasteRule, textblockTypeInputRule, toggleList, toggleMark, toggleNode, toggleWrap, undoInputRule, unsetAllMarks, unsetMark, updateAttributes, updateMarkViewAttributes, wrapIn, wrapInList, wrappingInputRule };
+export { type AnyCommands, type AnyConfig, type AnyExtension, type AssetNodeType, type AssetRef, type AssetResolver, type AssetUrlMap, type AtomBlockMarkdownSpecOptions, type Attribute, type Attributes$1 as Attributes, type BlockMarkdownSpecOptions, type BlockParserConfig, type CanCommands, type ChainedCommands, type ChangedRange, type Command, CommandManager, type CommandProps, type CommandSpec, type Commands, type Content, type CreateNodeFromContentOptions, type DOMNode, type DOMOutputSpecArray$1 as DOMOutputSpecArray, type DecorationType, type DecorationWithType, type Diff, type Dispatch, type DocumentType, SlideEditor as Editor, type EditorEvents, type EditorOptions, type EnableRules, Extendable, type ExtendableConfig, type ExtendedRegExpMatchArray, Extension, type ExtensionAttribute, type ExtensionConfig, type Extensions, type FocusPosition, Fragment, type FullMarkdownHelpers, type GlobalAttributes, type HTMLContent, type InlineMarkdownSpecOptions, InputRule, type InputRuleFinder, type InputRuleMatch, type InsertContentAtOptions, type InsertContentOptions, type JSONContent, type KeyboardShortcutCommand, type KeysWithTypeOf, Mark, type MarkConfig, type MarkRange, type MarkType, MarkView, type MarkViewProps, type MarkViewRenderer, type MarkViewRendererOptions, type MarkViewRendererProps, type MarkdownExtensionSpec, type MarkdownHelpers, type MarkdownLexerConfiguration, type MarkdownParseHelpers, type MarkdownParseResult, type MarkdownRendererHelpers, type MarkdownToken, type MarkdownTokenizer, type MaybeReturnType, type MaybeThisParameterType, Node, type NodeConfig, NodePos, type NodeRange, type NodeType, NodeView, type NodeViewProps, type NodeViewRenderer, type NodeViewRendererOptions, type NodeViewRendererProps, type NodeWithPos, type Overwrite, type ParentConfig, type ParsedBlock, type PartialTheme, PasteRule, type PasteRuleFinder, type PasteRuleMatch, type PickValue, type Predicate, type Primitive, type Range, type RawCommands, type RemoveThis, type RenderContext, type ResolvedTheme, type SetContentOptions, type SingleCommands, SlideEditor, type Storage, type TextSerializer, type TextType, type Theme, type ThemeConfig, type ThemeInput, type TiptapEditorHTMLElement, Tracker, type TrackerResult, type UnionCommands, type UnionToIntersection, type ValuesOf, applyAllLayouts, applyLayoutToColumnGroup, applyLayoutToRow, applyTheme, blur, callOrReturn, canInsertNode, clearContent, clearNodes, combineTransactionSteps, command, index$2 as commands, createAtomBlockMarkdownSpec, createBlockMarkdownSpec, createChainableState, createDocument, h as createElement, createInlineMarkdownSpec, createNodeFromContent, createParagraphNear, createStyleTag, cut, darkTheme, defaultBlockAt, deleteCurrentNode, deleteNode, deleteProps, deleteRange, deleteSelection, elementFromString, enter, escapeForRegEx, exitCode, extendMarkRange, index$1 as extensions, findChildren, findChildrenInRange, findDuplicates, findParentNode, findParentNodeClosestToPos, first, flattenExtensions, focus, forEach, fromString, generateHTML, generateJSON, generateText, getAttributes, getAttributesFromExtensions, getChangedRanges, getDebugJSON, getEditorAssets, getExtensionField, getHTMLFromFragment, getMarkAttributes, getMarkRange, getMarkType, getMarksBetween, getNodeAtPosition, getNodeAttributes, getNodeType, getRenderedAttributes, getSchema, getSchemaByResolvedExtensions, getSchemaTypeByName, getSchemaTypeNameByName, getSplittedAttributes, getText, getTextBetween, getTextContentFromNodes, getTextSerializersFromSchema, getTheme, getThemeNames, h, injectExtensionAttributesToParseRule, inputRulesPlugin, insertContent, insertContentAt, isActive, isAndroid, isAtEndOfNode, isAtStartOfNode, isEmptyObject, isExtensionRulesEnabled, isFunction, isList, isMacOS, isMarkActive, isNodeActive, isNodeEmpty, isNodeSelection, isNumber, isPlainObject, isRegExp, isString, isTextSelection, isiOS, joinBackward, joinDown, joinForward, joinItemBackward, joinItemForward, joinTextblockBackward, joinTextblockForward, joinUp, keyboardShortcut, lift, liftEmptyBlock, liftListItem, lightTheme, markInputRule, markPasteRule, index as markdown, mergeAttributes, mergeDeep, minMax, newlineInCode, nodeInputRule, nodePasteRule, objectIncludes, parseAttributes, parseIndentedBlocks, parseLayout, pasteRulesPlugin, posToDOMRect, refreshAssets, registerTheme, removeDuplicates, renderNestedMarkdownContent, resetAttributes, resolveExtensions, resolveFocusPosition, resolveTheme, rewriteUnknownContent, scrollIntoView, selectAll, selectNodeBackward, selectNodeForward, selectParentNode, selectTextblockEnd, selectTextblockStart, selectionToInsertionEnd, serializeAttributes, setContent, setMark, setMeta, setNode, setNodeSelection, setTextSelection, sinkListItem, sortExtensions, splitBlock, splitExtensions, splitListItem, textInputRule, textPasteRule, textblockTypeInputRule, toggleList, toggleMark, toggleNode, toggleWrap, undoInputRule, unsetAllMarks, unsetMark, updateAssetUrls, updateAttributes, updateMarkViewAttributes, wrapIn, wrapInList, wrappingInputRule };

package/dist/index.d.ts

@@ -3016,6 +3016,27 @@ declare module '@blockslides/core' {
 }
 declare const unsetMark: RawCommands['unsetMark'];
 
+declare module '@blockslides/core' {
+    interface Commands<ReturnType> {
+        updateAssetUrls: {
+            /**
+             * Update asset URLs across the entire document in a single transaction.
+             * The map keys can be either an `assetId` (preferred for imageBlock nodes)
+             * or the current URL (used as a fallback, and for nodes without an assetId
+             * such as slide/columnGroup backgrounds and video embeds).
+             *
+             * @example
+             * editor.commands.updateAssetUrls({
+             *   'asset-123': 'https://cdn.example.com/fresh-url.jpg',
+             *   'https://old.example.com/bg.jpg': 'https://cdn.example.com/fresh-bg.jpg',
+             * })
+             */
+            updateAssetUrls: (urlMap: Record<string, string>) => ReturnType;
+        };
+    }
+}
+declare const updateAssetUrls: RawCommands['updateAssetUrls'];
+
 declare module '@blockslides/core' {
     interface Commands<ReturnType> {
         updateAttributes: {
@@ -3127,11 +3148,12 @@ declare const index$2_toggleWrap: typeof toggleWrap;
 declare const index$2_undoInputRule: typeof undoInputRule;
 declare const index$2_unsetAllMarks: typeof unsetAllMarks;
 declare const index$2_unsetMark: typeof unsetMark;
+declare const index$2_updateAssetUrls: typeof updateAssetUrls;
 declare const index$2_updateAttributes: typeof updateAttributes;
 declare const index$2_wrapIn: typeof wrapIn;
 declare const index$2_wrapInList: typeof wrapInList;
 declare namespace index$2 {
-  export { type index$2_InsertContentAtOptions as InsertContentAtOptions, type index$2_InsertContentOptions as InsertContentOptions, type index$2_SetContentOptions as SetContentOptions, index$2_blur as blur, index$2_clearContent as clearContent, index$2_clearNodes as clearNodes, index$2_command as command, index$2_createParagraphNear as createParagraphNear, index$2_cut as cut, index$2_deleteCurrentNode as deleteCurrentNode, index$2_deleteNode as deleteNode, index$2_deleteRange as deleteRange, index$2_deleteSelection as deleteSelection, index$2_enter as enter, index$2_exitCode as exitCode, index$2_extendMarkRange as extendMarkRange, index$2_first as first, index$2_focus as focus, index$2_forEach as forEach, index$2_insertContent as insertContent, index$2_insertContentAt as insertContentAt, index$2_joinBackward as joinBackward, index$2_joinDown as joinDown, index$2_joinForward as joinForward, index$2_joinItemBackward as joinItemBackward, index$2_joinItemForward as joinItemForward, index$2_joinTextblockBackward as joinTextblockBackward, index$2_joinTextblockForward as joinTextblockForward, index$2_joinUp as joinUp, index$2_keyboardShortcut as keyboardShortcut, index$2_lift as lift, index$2_liftEmptyBlock as liftEmptyBlock, index$2_liftListItem as liftListItem, index$2_newlineInCode as newlineInCode, index$2_resetAttributes as resetAttributes, index$2_scrollIntoView as scrollIntoView, index$2_selectAll as selectAll, index$2_selectNodeBackward as selectNodeBackward, index$2_selectNodeForward as selectNodeForward, index$2_selectParentNode as selectParentNode, index$2_selectTextblockEnd as selectTextblockEnd, index$2_selectTextblockStart as selectTextblockStart, index$2_setContent as setContent, index$2_setMark as setMark, index$2_setMeta as setMeta, index$2_setNode as setNode, index$2_setNodeSelection as setNodeSelection, index$2_setTextSelection as setTextSelection, index$2_sinkListItem as sinkListItem, index$2_splitBlock as splitBlock, index$2_splitListItem as splitListItem, index$2_toggleList as toggleList, index$2_toggleMark as toggleMark, index$2_toggleNode as toggleNode, index$2_toggleWrap as toggleWrap, index$2_undoInputRule as undoInputRule, index$2_unsetAllMarks as unsetAllMarks, index$2_unsetMark as unsetMark, index$2_updateAttributes as updateAttributes, index$2_wrapIn as wrapIn, index$2_wrapInList as wrapInList };
+  export { type index$2_InsertContentAtOptions as InsertContentAtOptions, type index$2_InsertContentOptions as InsertContentOptions, type index$2_SetContentOptions as SetContentOptions, index$2_blur as blur, index$2_clearContent as clearContent, index$2_clearNodes as clearNodes, index$2_command as command, index$2_createParagraphNear as createParagraphNear, index$2_cut as cut, index$2_deleteCurrentNode as deleteCurrentNode, index$2_deleteNode as deleteNode, index$2_deleteRange as deleteRange, index$2_deleteSelection as deleteSelection, index$2_enter as enter, index$2_exitCode as exitCode, index$2_extendMarkRange as extendMarkRange, index$2_first as first, index$2_focus as focus, index$2_forEach as forEach, index$2_insertContent as insertContent, index$2_insertContentAt as insertContentAt, index$2_joinBackward as joinBackward, index$2_joinDown as joinDown, index$2_joinForward as joinForward, index$2_joinItemBackward as joinItemBackward, index$2_joinItemForward as joinItemForward, index$2_joinTextblockBackward as joinTextblockBackward, index$2_joinTextblockForward as joinTextblockForward, index$2_joinUp as joinUp, index$2_keyboardShortcut as keyboardShortcut, index$2_lift as lift, index$2_liftEmptyBlock as liftEmptyBlock, index$2_liftListItem as liftListItem, index$2_newlineInCode as newlineInCode, index$2_resetAttributes as resetAttributes, index$2_scrollIntoView as scrollIntoView, index$2_selectAll as selectAll, index$2_selectNodeBackward as selectNodeBackward, index$2_selectNodeForward as selectNodeForward, index$2_selectParentNode as selectParentNode, index$2_selectTextblockEnd as selectTextblockEnd, index$2_selectTextblockStart as selectTextblockStart, index$2_setContent as setContent, index$2_setMark as setMark, index$2_setMeta as setMeta, index$2_setNode as setNode, index$2_setNodeSelection as setNodeSelection, index$2_setTextSelection as setTextSelection, index$2_sinkListItem as sinkListItem, index$2_splitBlock as splitBlock, index$2_splitListItem as splitListItem, index$2_toggleList as toggleList, index$2_toggleMark as toggleMark, index$2_toggleNode as toggleNode, index$2_toggleWrap as toggleWrap, index$2_undoInputRule as undoInputRule, index$2_unsetAllMarks as unsetAllMarks, index$2_unsetMark as unsetMark, index$2_updateAssetUrls as updateAssetUrls, index$2_updateAttributes as updateAttributes, index$2_wrapIn as wrapIn, index$2_wrapInList as wrapInList };
 }
 
 declare const Commands$1: Extension<any, any>;
@@ -4066,6 +4088,86 @@ declare function objectIncludes(object1: Record<string, any>, object2: Record<st
     strict: boolean;
 }): boolean;
 
+/**
+ * The node types that can carry asset URLs.
+ */
+type AssetNodeType = 'imageBlock' | 'slide' | 'columnGroup' | 'video';
+/**
+ * A reference to an asset found in the document.
+ *
+ * - `assetId` is the stable identifier set by the application when the asset
+ *   was inserted (only available on `imageBlock` nodes). Use it as the key when
+ *   building the URL map for `updateAssetUrls` or `refreshAssets`.
+ * - `currentUrl` is the URL currently stored in the document. Use it as the
+ *   key for nodes that have no `assetId` (slides, columnGroups, videos).
+ * - `nodeType` lets you filter by content type if needed.
+ */
+interface AssetRef {
+    assetId: string | null;
+    currentUrl: string;
+    nodeType: AssetNodeType;
+}
+/**
+ * A map of lookup key → fresh URL passed to `updateAssetUrls` or returned
+ * from an `AssetResolver`. Keys may be either `assetId` values or raw URLs.
+ */
+type AssetUrlMap = Record<string, string>;
+/**
+ * An async function that receives the current assets and returns a map of
+ * fresh URLs. This is the integration point with your storage provider
+ * (S3, Supabase, Cloudflare R2, your own CDN, etc.).
+ *
+ * @example
+ * const resolver: AssetResolver = async (assets) => {
+ *   const ids = assets.map(a => a.assetId).filter(Boolean)
+ *   const fresh = await myApi.refreshSignedUrls(ids)
+ *   return Object.fromEntries(
+ *     assets.map(a => [a.assetId ?? a.currentUrl, fresh[a.assetId ?? '']])
+ *   )
+ * }
+ */
+type AssetResolver = (assets: AssetRef[]) => Promise<AssetUrlMap>;
+/**
+ * Collect all asset references from the editor document.
+ *
+ * Traverses every node and returns one `AssetRef` per URL-bearing node:
+ * - `imageBlock` nodes (src + optional assetId)
+ * - `slide` nodes with a backgroundImage
+ * - `columnGroup` nodes with a backgroundImage
+ * - `video` nodes (src)
+ *
+ * @example
+ * const assets = getEditorAssets(editor)
+ * // → [{ assetId: 'abc', currentUrl: 'https://...', nodeType: 'imageBlock' }, ...]
+ */
+declare function getEditorAssets(editor: SlideEditor): AssetRef[];
+/**
+ * Refresh all asset URLs in the editor document.
+ *
+ * Collects every asset reference, passes the list to your `resolver` function,
+ * then applies the returned URL map in a single ProseMirror transaction.
+ *
+ * The resolver is where you integrate with your storage provider — fetch
+ * presigned URLs from S3, generate Supabase tokens, call your own API, etc.
+ * Blockslides only handles the document traversal and patching.
+ *
+ * @param editor - The SlideEditor instance.
+ * @param resolver - Async function that receives the asset list and returns
+ *   a map of `{ assetId | currentUrl → freshUrl }`.
+ *
+ * @example
+ * import { refreshAssets } from '@blockslides/core'
+ *
+ * await refreshAssets(editor, async (assets) => {
+ *   const ids = assets.map(a => a.assetId).filter(Boolean)
+ *   const fresh = await myStorage.getSignedUrls(ids)
+ *   return Object.fromEntries(
+ *     assets.map(a => [a.assetId ?? a.currentUrl, fresh[a.assetId ?? '']])
+ *   )
+ * })
+ */
+declare function refreshAssets(editor: SlideEditor, resolver: AssetResolver): Promise<void>;
+
 /**
  * Removes duplicated values within an array.
  * Supports numbers, strings and objects.
@@ -4130,4 +4232,4 @@ interface Commands<ReturnType = any> {
 interface Storage {
 }
 
-export { type AnyCommands, type AnyConfig, type AnyExtension, type AtomBlockMarkdownSpecOptions, type Attribute, type Attributes$1 as Attributes, type BlockMarkdownSpecOptions, type BlockParserConfig, type CanCommands, type ChainedCommands, type ChangedRange, type Command, CommandManager, type CommandProps, type CommandSpec, type Commands, type Content, type CreateNodeFromContentOptions, type DOMNode, type DOMOutputSpecArray$1 as DOMOutputSpecArray, type DecorationType, type DecorationWithType, type Diff, type Dispatch, type DocumentType, SlideEditor as Editor, type EditorEvents, type EditorOptions, type EnableRules, Extendable, type ExtendableConfig, type ExtendedRegExpMatchArray, Extension, type ExtensionAttribute, type ExtensionConfig, type Extensions, type FocusPosition, Fragment, type FullMarkdownHelpers, type GlobalAttributes, type HTMLContent, type InlineMarkdownSpecOptions, InputRule, type InputRuleFinder, type InputRuleMatch, type InsertContentAtOptions, type InsertContentOptions, type JSONContent, type KeyboardShortcutCommand, type KeysWithTypeOf, Mark, type MarkConfig, type MarkRange, type MarkType, MarkView, type MarkViewProps, type MarkViewRenderer, type MarkViewRendererOptions, type MarkViewRendererProps, type MarkdownExtensionSpec, type MarkdownHelpers, type MarkdownLexerConfiguration, type MarkdownParseHelpers, type MarkdownParseResult, type MarkdownRendererHelpers, type MarkdownToken, type MarkdownTokenizer, type MaybeReturnType, type MaybeThisParameterType, Node, type NodeConfig, NodePos, type NodeRange, type NodeType, NodeView, type NodeViewProps, type NodeViewRenderer, type NodeViewRendererOptions, type NodeViewRendererProps, type NodeWithPos, type Overwrite, type ParentConfig, type ParsedBlock, type PartialTheme, PasteRule, type PasteRuleFinder, type PasteRuleMatch, type PickValue, type Predicate, type Primitive, type Range, type RawCommands, type RemoveThis, type RenderContext, type ResolvedTheme, type SetContentOptions, type SingleCommands, SlideEditor, type Storage, type TextSerializer, type TextType, type Theme, type ThemeConfig, type ThemeInput, type TiptapEditorHTMLElement, Tracker, type TrackerResult, type UnionCommands, type UnionToIntersection, type ValuesOf, applyAllLayouts, applyLayoutToColumnGroup, applyLayoutToRow, applyTheme, blur, callOrReturn, canInsertNode, clearContent, clearNodes, combineTransactionSteps, command, index$2 as commands, createAtomBlockMarkdownSpec, createBlockMarkdownSpec, createChainableState, createDocument, h as createElement, createInlineMarkdownSpec, createNodeFromContent, createParagraphNear, createStyleTag, cut, darkTheme, defaultBlockAt, deleteCurrentNode, deleteNode, deleteProps, deleteRange, deleteSelection, elementFromString, enter, escapeForRegEx, exitCode, extendMarkRange, index$1 as extensions, findChildren, findChildrenInRange, findDuplicates, findParentNode, findParentNodeClosestToPos, first, flattenExtensions, focus, forEach, fromString, generateHTML, generateJSON, generateText, getAttributes, getAttributesFromExtensions, getChangedRanges, getDebugJSON, getExtensionField, getHTMLFromFragment, getMarkAttributes, getMarkRange, getMarkType, getMarksBetween, getNodeAtPosition, getNodeAttributes, getNodeType, getRenderedAttributes, getSchema, getSchemaByResolvedExtensions, getSchemaTypeByName, getSchemaTypeNameByName, getSplittedAttributes, getText, getTextBetween, getTextContentFromNodes, getTextSerializersFromSchema, getTheme, getThemeNames, h, injectExtensionAttributesToParseRule, inputRulesPlugin, insertContent, insertContentAt, isActive, isAndroid, isAtEndOfNode, isAtStartOfNode, isEmptyObject, isExtensionRulesEnabled, isFunction, isList, isMacOS, isMarkActive, isNodeActive, isNodeEmpty, isNodeSelection, isNumber, isPlainObject, isRegExp, isString, isTextSelection, isiOS, joinBackward, joinDown, joinForward, joinItemBackward, joinItemForward, joinTextblockBackward, joinTextblockForward, joinUp, keyboardShortcut, lift, liftEmptyBlock, liftListItem, lightTheme, markInputRule, markPasteRule, index as markdown, mergeAttributes, mergeDeep, minMax, newlineInCode, nodeInputRule, nodePasteRule, objectIncludes, parseAttributes, parseIndentedBlocks, parseLayout, pasteRulesPlugin, posToDOMRect, registerTheme, removeDuplicates, renderNestedMarkdownContent, resetAttributes, resolveExtensions, resolveFocusPosition, resolveTheme, rewriteUnknownContent, scrollIntoView, selectAll, selectNodeBackward, selectNodeForward, selectParentNode, selectTextblockEnd, selectTextblockStart, selectionToInsertionEnd, serializeAttributes, setContent, setMark, setMeta, setNode, setNodeSelection, setTextSelection, sinkListItem, sortExtensions, splitBlock, splitExtensions, splitListItem, textInputRule, textPasteRule, textblockTypeInputRule, toggleList, toggleMark, toggleNode, toggleWrap, undoInputRule, unsetAllMarks, unsetMark, updateAttributes, updateMarkViewAttributes, wrapIn, wrapInList, wrappingInputRule };
+export { type AnyCommands, type AnyConfig, type AnyExtension, type AssetNodeType, type AssetRef, type AssetResolver, type AssetUrlMap, type AtomBlockMarkdownSpecOptions, type Attribute, type Attributes$1 as Attributes, type BlockMarkdownSpecOptions, type BlockParserConfig, type CanCommands, type ChainedCommands, type ChangedRange, type Command, CommandManager, type CommandProps, type CommandSpec, type Commands, type Content, type CreateNodeFromContentOptions, type DOMNode, type DOMOutputSpecArray$1 as DOMOutputSpecArray, type DecorationType, type DecorationWithType, type Diff, type Dispatch, type DocumentType, SlideEditor as Editor, type EditorEvents, type EditorOptions, type EnableRules, Extendable, type ExtendableConfig, type ExtendedRegExpMatchArray, Extension, type ExtensionAttribute, type ExtensionConfig, type Extensions, type FocusPosition, Fragment, type FullMarkdownHelpers, type GlobalAttributes, type HTMLContent, type InlineMarkdownSpecOptions, InputRule, type InputRuleFinder, type InputRuleMatch, type InsertContentAtOptions, type InsertContentOptions, type JSONContent, type KeyboardShortcutCommand, type KeysWithTypeOf, Mark, type MarkConfig, type MarkRange, type MarkType, MarkView, type MarkViewProps, type MarkViewRenderer, type MarkViewRendererOptions, type MarkViewRendererProps, type MarkdownExtensionSpec, type MarkdownHelpers, type MarkdownLexerConfiguration, type MarkdownParseHelpers, type MarkdownParseResult, type MarkdownRendererHelpers, type MarkdownToken, type MarkdownTokenizer, type MaybeReturnType, type MaybeThisParameterType, Node, type NodeConfig, NodePos, type NodeRange, type NodeType, NodeView, type NodeViewProps, type NodeViewRenderer, type NodeViewRendererOptions, type NodeViewRendererProps, type NodeWithPos, type Overwrite, type ParentConfig, type ParsedBlock, type PartialTheme, PasteRule, type PasteRuleFinder, type PasteRuleMatch, type PickValue, type Predicate, type Primitive, type Range, type RawCommands, type RemoveThis, type RenderContext, type ResolvedTheme, type SetContentOptions, type SingleCommands, SlideEditor, type Storage, type TextSerializer, type TextType, type Theme, type ThemeConfig, type ThemeInput, type TiptapEditorHTMLElement, Tracker, type TrackerResult, type UnionCommands, type UnionToIntersection, type ValuesOf, applyAllLayouts, applyLayoutToColumnGroup, applyLayoutToRow, applyTheme, blur, callOrReturn, canInsertNode, clearContent, clearNodes, combineTransactionSteps, command, index$2 as commands, createAtomBlockMarkdownSpec, createBlockMarkdownSpec, createChainableState, createDocument, h as createElement, createInlineMarkdownSpec, createNodeFromContent, createParagraphNear, createStyleTag, cut, darkTheme, defaultBlockAt, deleteCurrentNode, deleteNode, deleteProps, deleteRange, deleteSelection, elementFromString, enter, escapeForRegEx, exitCode, extendMarkRange, index$1 as extensions, findChildren, findChildrenInRange, findDuplicates, findParentNode, findParentNodeClosestToPos, first, flattenExtensions, focus, forEach, fromString, generateHTML, generateJSON, generateText, getAttributes, getAttributesFromExtensions, getChangedRanges, getDebugJSON, getEditorAssets, getExtensionField, getHTMLFromFragment, getMarkAttributes, getMarkRange, getMarkType, getMarksBetween, getNodeAtPosition, getNodeAttributes, getNodeType, getRenderedAttributes, getSchema, getSchemaByResolvedExtensions, getSchemaTypeByName, getSchemaTypeNameByName, getSplittedAttributes, getText, getTextBetween, getTextContentFromNodes, getTextSerializersFromSchema, getTheme, getThemeNames, h, injectExtensionAttributesToParseRule, inputRulesPlugin, insertContent, insertContentAt, isActive, isAndroid, isAtEndOfNode, isAtStartOfNode, isEmptyObject, isExtensionRulesEnabled, isFunction, isList, isMacOS, isMarkActive, isNodeActive, isNodeEmpty, isNodeSelection, isNumber, isPlainObject, isRegExp, isString, isTextSelection, isiOS, joinBackward, joinDown, joinForward, joinItemBackward, joinItemForward, joinTextblockBackward, joinTextblockForward, joinUp, keyboardShortcut, lift, liftEmptyBlock, liftListItem, lightTheme, markInputRule, markPasteRule, index as markdown, mergeAttributes, mergeDeep, minMax, newlineInCode, nodeInputRule, nodePasteRule, objectIncludes, parseAttributes, parseIndentedBlocks, parseLayout, pasteRulesPlugin, posToDOMRect, refreshAssets, registerTheme, removeDuplicates, renderNestedMarkdownContent, resetAttributes, resolveExtensions, resolveFocusPosition, resolveTheme, rewriteUnknownContent, scrollIntoView, selectAll, selectNodeBackward, selectNodeForward, selectParentNode, selectTextblockEnd, selectTextblockStart, selectionToInsertionEnd, serializeAttributes, setContent, setMark, setMeta, setNode, setNodeSelection, setTextSelection, sinkListItem, sortExtensions, splitBlock, splitExtensions, splitListItem, textInputRule, textPasteRule, textblockTypeInputRule, toggleList, toggleMark, toggleNode, toggleWrap, undoInputRule, unsetAllMarks, unsetMark, updateAssetUrls, updateAttributes, updateMarkViewAttributes, wrapIn, wrapInList, wrappingInputRule };

package/dist/index.js

@@ -70,6 +70,7 @@ __export(index_exports, {
   getAttributesFromExtensions: () => getAttributesFromExtensions,
   getChangedRanges: () => getChangedRanges,
   getDebugJSON: () => getDebugJSON,
+  getEditorAssets: () => getEditorAssets,
   getExtensionField: () => getExtensionField,
   getHTMLFromFragment: () => getHTMLFromFragment,
   getMarkAttributes: () => getMarkAttributes,
@@ -128,6 +129,7 @@ __export(index_exports, {
   parseLayout: () => parseLayout,
   pasteRulesPlugin: () => pasteRulesPlugin,
   posToDOMRect: () => posToDOMRect,
+  refreshAssets: () => refreshAssets,
   registerTheme: () => registerTheme,
   removeDuplicates: () => removeDuplicates,
   renderNestedMarkdownContent: () => renderNestedMarkdownContent,
@@ -346,6 +348,7 @@ __export(commands_exports, {
   undoInputRule: () => undoInputRule,
   unsetAllMarks: () => unsetAllMarks,
   unsetMark: () => unsetMark,
+  updateAssetUrls: () => updateAssetUrls,
   updateAttributes: () => updateAttributes,
   wrapIn: () => wrapIn,
   wrapInList: () => wrapInList
@@ -2831,6 +2834,37 @@ var unsetMark = (typeOrName, options = {}) => ({ tr, state, dispatch }) => {
   return true;
 };
 
+// src/commands/updateAssetUrls.ts
+var updateAssetUrls = (urlMap) => ({ tr, state, dispatch }) => {
+  if (dispatch) {
+    state.doc.descendants((node, pos) => {
+      if (node.type.name === "imageBlock" && node.attrs.src) {
+        const key = node.attrs.assetId && urlMap[node.attrs.assetId] ? node.attrs.assetId : node.attrs.src;
+        const newUrl = urlMap[key];
+        if (newUrl) {
+          tr.setNodeMarkup(pos, void 0, { ...node.attrs, src: newUrl });
+        }
+      }
+      if ((node.type.name === "slide" || node.type.name === "columnGroup") && node.attrs.backgroundImage) {
+        const newUrl = urlMap[node.attrs.backgroundImage];
+        if (newUrl) {
+          tr.setNodeMarkup(pos, void 0, {
+            ...node.attrs,
+            backgroundImage: newUrl
+          });
+        }
+      }
+      if (node.type.name === "video" && node.attrs.src) {
+        const newUrl = urlMap[node.attrs.src];
+        if (newUrl) {
+          tr.setNodeMarkup(pos, void 0, { ...node.attrs, src: newUrl });
+        }
+      }
+    });
+  }
+  return true;
+};
+
 // src/commands/updateAttributes.ts
 var updateAttributes = (typeOrName, attributes = {}) => ({ tr, state, dispatch }) => {
   let nodeType = null;
@@ -2950,6 +2984,7 @@ var EventEmitter = class {
     this.callbacks = {};
   }
   on(event, fn) {
+    if (!fn) return this;
     if (!this.callbacks[event]) {
       this.callbacks[event] = [];
     }
@@ -6072,6 +6107,49 @@ function renderNestedMarkdownContent(node, h2, prefixOrGenerator, ctx) {
   return output.join("\n");
 }
 
+// src/utilities/assetRefresh.ts
+function getEditorAssets(editor) {
+  const assets = [];
+  editor.state.doc.descendants((node) => {
+    var _a;
+    if (node.type.name === "imageBlock" && node.attrs.src) {
+      assets.push({
+        assetId: (_a = node.attrs.assetId) != null ? _a : null,
+        currentUrl: node.attrs.src,
+        nodeType: "imageBlock"
+      });
+    }
+    if (node.type.name === "slide" && node.attrs.backgroundImage) {
+      assets.push({
+        assetId: null,
+        currentUrl: node.attrs.backgroundImage,
+        nodeType: "slide"
+      });
+    }
+    if (node.type.name === "columnGroup" && node.attrs.backgroundImage) {
+      assets.push({
+        assetId: null,
+        currentUrl: node.attrs.backgroundImage,
+        nodeType: "columnGroup"
+      });
+    }
+    if (node.type.name === "video" && node.attrs.src) {
+      assets.push({
+        assetId: null,
+        currentUrl: node.attrs.src,
+        nodeType: "video"
+      });
+    }
+  });
+  return assets;
+}
+async function refreshAssets(editor, resolver) {
+  const assets = getEditorAssets(editor);
+  if (assets.length === 0) return;
+  const urlMap = await resolver(assets);
+  editor.commands.updateAssetUrls(urlMap);
+}
+
 // src/MarkView.ts
 function updateMarkViewAttributes(checkMark, editor, attrs = {}) {
   const { state } = editor;
@@ -6553,6 +6631,7 @@ var Tracker = class {
   getAttributesFromExtensions,
   getChangedRanges,
   getDebugJSON,
+  getEditorAssets,
   getExtensionField,
   getHTMLFromFragment,
   getMarkAttributes,
@@ -6611,6 +6690,7 @@ var Tracker = class {
   parseLayout,
   pasteRulesPlugin,
   posToDOMRect,
+  refreshAssets,
   registerTheme,
   removeDuplicates,
   renderNestedMarkdownContent,