@fileverse-dev/ddoc 3.0.100 → 3.1.1

package/dist/package/extensions/custom-link/index.d.ts

@@ -0,0 +1,19 @@
+import { LinkOptions } from '@tiptap/extension-link';
+
+export interface CustomLinkOptions extends LinkOptions {
+    /**
+     * Called when the user pastes a heading link URL whose target
+     * heading does not exist in the current document — i.e. the link
+     * belongs to a different dDoc.
+     */
+    onForeignHeadingLink?: (message: string) => void;
+}
+/**
+ * Extends tiptap's Link with a paste-time hook that detects
+ * heading links pointing at headings from other dDocs and dispatches
+ * a warning. A dedicated ProseMirror `handlePaste` is used (instead
+ * of piggybacking on `shouldAutoLink`) because `shouldAutoLink` is
+ * also called by the autolink plugin on every transaction — which
+ * would re-fire the warning on unrelated keystrokes like Enter.
+ */
+export declare const CustomLink: import('@tiptap/core').Mark<CustomLinkOptions, any>;

package/dist/package/extensions/default-extension.d.ts

@@ -14,5 +14,5 @@ export declare const defaultExtensions: ({ ipfsImageFetchFn, onError, metadataPr
     onCopyHeadingLink?: (link: string) => void;
     fetchV1ImageFn?: (url: string) => Promise<ArrayBuffer | undefined>;
     onTocUpdate?: (data: ToCItemType[], isCreate?: boolean) => void;
-}) => (import('@tiptap/core').AnyExtension | import('@tiptap/core').Node<import('@tiptap/extension-horizontal-rule').HorizontalRuleOptions, any> | import('@tiptap/core').Extension<import('./multi-column').ColumnExtensionOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-heading').HeadingOptions, any> | import('@tiptap/core').Node<import('./iframe').IframeOptions, any> | import('@tiptap/core').Node<import('./twitter-embed').EmbeddedTweetOptions, any> | import('@tiptap/core').Node<import('./d-block').DBlockOptions, any> | import('@tiptap/core').Extension<import('./trailing-node').TrailingNodeOptions, any> | import('@tiptap/core').Node<import('./action-button').ActionButtonOptions, any> | import('@tiptap/core').Node<import('./resizable-media').MediaOptions, any> | import('@tiptap/core').Extension<import('./link-preview/link-preview').LinkPreviewOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-code-block-lowlight').CodeBlockLowlightOptions, any> | import('@tiptap/core').Mark<import('@tiptap/extension-text-style').TextStyleOptions, any> | import('@tiptap/core').Mark<import('@tiptap/extension-subscript').SubscriptExtensionOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extension-text-style').FontFamilyOptions, any> | import('@tiptap/core').Extension<import('@tiptap/starter-kit').StarterKitOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extension-table-of-contents').TableOfContentsOptions, import('@tiptap/extension-table-of-contents').TableOfContentsStorage> | import('@tiptap/core').Extension<import('@tiptap/extension-typography').TypographyOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extension-text-align').TextAlignOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extensions').PlaceholderOptions, any> | import('@tiptap/core').Mark<import('@tiptap/extension-highlight').HighlightOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').TaskListOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').TaskItemOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').BulletListOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').ListItemOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extensions').DropcursorOptions, any> | import('@tiptap/core').Extension<import('tiptap-markdown').MarkdownOptions, import('tiptap-markdown').MarkdownStorage> | import('@tiptap/core').Extension<import('@tiptap/extensions').CharacterCountOptions, import('@tiptap/extensions').CharacterCountStorage> | import('@tiptap/core').Extension<import('@aarkue/tiptap-math-extension').MathExtensionOption, any>)[];
+}) => (import('@tiptap/core').AnyExtension | import('@tiptap/core').Node<import('@tiptap/extension-horizontal-rule').HorizontalRuleOptions, any> | import('@tiptap/core').Extension<import('./multi-column').ColumnExtensionOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-heading').HeadingOptions, any> | import('@tiptap/core').Node<import('./iframe').IframeOptions, any> | import('@tiptap/core').Node<import('./twitter-embed').EmbeddedTweetOptions, any> | import('@tiptap/core').Node<import('./d-block').DBlockOptions, any> | import('@tiptap/core').Extension<import('./trailing-node').TrailingNodeOptions, any> | import('@tiptap/core').Node<import('./action-button').ActionButtonOptions, any> | import('@tiptap/core').Node<import('./resizable-media').MediaOptions, any> | import('@tiptap/core').Extension<import('./link-preview/link-preview').LinkPreviewOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-code-block-lowlight').CodeBlockLowlightOptions, any> | import('@tiptap/core').Mark<import('./custom-link').CustomLinkOptions, any> | import('@tiptap/core').Mark<import('@tiptap/extension-text-style').TextStyleOptions, any> | import('@tiptap/core').Mark<import('@tiptap/extension-subscript').SubscriptExtensionOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extension-text-style').FontFamilyOptions, any> | import('@tiptap/core').Extension<import('@tiptap/starter-kit').StarterKitOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extension-table-of-contents').TableOfContentsOptions, import('@tiptap/extension-table-of-contents').TableOfContentsStorage> | import('@tiptap/core').Extension<import('@tiptap/extension-typography').TypographyOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extension-text-align').TextAlignOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extensions').PlaceholderOptions, any> | import('@tiptap/core').Mark<import('@tiptap/extension-highlight').HighlightOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').TaskListOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').TaskItemOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').BulletListOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').ListItemOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extensions').DropcursorOptions, any> | import('@tiptap/core').Extension<import('tiptap-markdown').MarkdownOptions, import('tiptap-markdown').MarkdownStorage> | import('@tiptap/core').Extension<import('@tiptap/extensions').CharacterCountOptions, import('@tiptap/extensions').CharacterCountStorage> | import('@tiptap/core').Extension<import('@aarkue/tiptap-math-extension').MathExtensionOption, any>)[];
 export declare const createInputRule: (pattern: RegExp, data: string, type: NodeType) => InputRule;

package/dist/package/extensions/mardown-paste-handler/index.d.ts

@@ -22,7 +22,7 @@ declare module '@tiptap/core' {
 declare const MarkdownPasteHandler: (ipfsImageUploadFn?: (file: File) => Promise<IpfsImageUploadResponse>, ipfsImageFetchFn?: (_data: IpfsImageFetchPayload) => Promise<{
     url: string;
     file: File;
-}>, fetchV1ImageFn?: (url: string) => Promise<ArrayBuffer | undefined>, onError?: (error: string) => void) => Extension<any, any>;
+}>, fetchV1ImageFn?: (url: string) => Promise<ArrayBuffer | undefined>) => Extension<any, any>;
 export declare const stripFrontmatter: (markdown: string) => string;
 export declare function handleMarkdownContent(view: any, content: string, ipfsImageUploadFn?: (file: File) => Promise<IpfsImageUploadResponse>): Promise<void>;
 export default MarkdownPasteHandler;

package/dist/package/utils/heading-link.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Heading links have the form `<origin>/<path>#heading=<slug>-<uuid8>`.
+ * They're created by the copy-heading-link button in the TOC and the
+ * block handle menu. Consumers of a dDoc paste these URLs expecting
+ * same-page scroll behavior; but the same URL shape is also used for
+ * cross-document heading links, which we need to detect and warn about.
+ */
+export interface ParsedHeadingLink {
+    /** The raw `heading` hash param value (e.g. `my-heading-a1b2c3d4`). */
+    headingParam: string;
+    /** The short id suffix used to locate the heading in the DOM. */
+    id: string;
+    /** The heading element in the current document, if present. */
+    headingEl: HTMLHeadingElement | undefined;
+}
+/**
+ * Parses a URL and, if it's a heading link pointing at the current origin,
+ * returns the heading param, id, and the matching DOM element (if any).
+ *
+ * Returns `null` when the URL is not parseable, is cross-origin, has no
+ * hash, or does not carry a `heading=` param.
+ */
+export declare const parseHeadingLink: (rawUrl: string) => ParsedHeadingLink | null;