@fileverse-dev/ddoc 3.5.1 → 3.5.2-font-1

package/dist/package/components/editor-toolbar.d.ts

@@ -1,10 +1,10 @@
 import { default as React } from 'react';
 import { Editor } from '@tiptap/react';
-import { IpfsImageFetchPayload, IpfsImageUploadResponse } from '../types';
+import { FontDescriptor, IpfsImageFetchPayload, IpfsImageUploadResponse } from '../types';
 import { Tab } from './tabs/utils/tab-utils';
 
 import * as Y from 'yjs';
-declare const MemoizedTiptapToolBar: React.MemoExoticComponent<({ editor, onError, isPresentationMode, setIsPresentationMode, enableCollaboration, zoomLevel, setZoomLevel, isNavbarVisible, setIsNavbarVisible, ipfsImageUploadFn, onMarkdownExport, onMarkdownImport, onPdfExport, onHtmlExport, onTxtExport, onOdtExport, onDocxImport, isLoading, ipfsImageFetchFn, fetchV1ImageFn, isConnected, tabs, ydoc, onRegisterExportTrigger, toggleFocusMode, }: {
+declare const MemoizedTiptapToolBar: React.MemoExoticComponent<({ editor, onError, isPresentationMode, setIsPresentationMode, enableCollaboration, zoomLevel, setZoomLevel, isNavbarVisible, setIsNavbarVisible, ipfsImageUploadFn, onMarkdownExport, onMarkdownImport, onPdfExport, onHtmlExport, onTxtExport, onOdtExport, onDocxImport, isLoading, ipfsImageFetchFn, fetchV1ImageFn, isConnected, tabs, ydoc, onRegisterExportTrigger, toggleFocusMode, fonts: consumerFonts, }: {
     editor: Editor | null;
     onError?: (errorString: string) => void;
     isPresentationMode?: boolean;
@@ -33,5 +33,6 @@ declare const MemoizedTiptapToolBar: React.MemoExoticComponent<({ editor, onErro
     ydoc: Y.Doc;
     toggleFocusMode?: () => void;
     onRegisterExportTrigger?: ((trigger: ((format?: string, name?: string) => void) | null) => void) | undefined;
+    fonts?: FontDescriptor[];
 }) => import("react/jsx-runtime").JSX.Element>;
 export default MemoizedTiptapToolBar;

package/dist/package/components/editor-utils.d.ts

@@ -1,7 +1,7 @@
 import { default as React, Dispatch, SetStateAction } from 'react';
+import { FontDescriptor, IpfsImageFetchPayload, IpfsImageUploadResponse } from '../types';
 import { IEditorTool } from '../hooks/use-visibility';
 import { Editor } from '@tiptap/react';
-import { IpfsImageFetchPayload, IpfsImageUploadResponse } from '../types';
 
 export interface IEditorToolElement {
     icon: any;
@@ -14,11 +14,16 @@ export interface IEditorToolElement {
     notVisible?: number;
     disabled?: boolean;
 }
-export declare const fonts: {
+type PickerEntry = {
     title: string;
     value: string;
     command: (editor: Editor) => void;
-}[];
+    preview?: React.ReactNode;
+};
+export declare const baselineFonts: PickerEntry[];
+/** @deprecated kept for backward import paths; prefer baselineFonts + consumer catalog */
+export declare const fonts: PickerEntry[];
+export declare function buildPickerEntries(consumerFonts: FontDescriptor[]): PickerEntry[];
 export declare const FONT_SIZES: readonly [8, 9, 10, 11, 12, 14, 16, 18, 24, 30, 32, 36, 48, 60, 72, 96];
 export declare const getFontSizeOptions: (editor?: Editor) => {
     title: string;
@@ -96,10 +101,11 @@ export declare const TextHighlighter: ({ editor, setVisibility, elementRef, }: {
     elementRef: React.RefObject<HTMLDivElement>;
     setVisibility: Dispatch<SetStateAction<IEditorTool>>;
 }) => import("react/jsx-runtime").JSX.Element;
-export declare const EditorFontFamily: ({ elementRef, editor, setToolVisibility, }: {
+export declare const EditorFontFamily: ({ elementRef, editor, setToolVisibility, fonts: consumerFonts, }: {
     elementRef: React.RefObject<HTMLDivElement>;
     editor: Editor;
     setToolVisibility: Dispatch<SetStateAction<IEditorTool>>;
+    fonts?: FontDescriptor[];
 }) => import("react/jsx-runtime").JSX.Element;
 export declare const EditorAlignment: ({ elementRef, editor, setToolVisibility, }: {
     elementRef: React.RefObject<HTMLDivElement>;
@@ -182,3 +188,4 @@ export declare const checkActiveListsAndDBlocks: (editor: Editor) => {
     state: import('prosemirror-state').EditorState;
     hasMultipleLists: boolean;
 };
+export {};

package/dist/package/types.d.ts

@@ -105,6 +105,13 @@ export interface DocumentStyling {
     orientation?: 'portrait' | 'landscape';
 }
 export interface DdocProps extends CommentAccountProps {
+    /**
+     * Optional catalog of fonts available to the editor in addition to the
+     * package baseline (system fonts only). Each entry is loaded lazily via the
+     * CSS Font Loading API when first selected in the picker or when a document
+     * references its family.
+     */
+    fonts?: FontDescriptor[];
     tabConfig?: {
         onCopyTabLink?: (tabId: string) => void;
         defaultTabId?: string;
@@ -247,3 +254,21 @@ export interface IpfsImageFetchPayload {
     mimeType: string;
     authTag: string;
 }
+export type FontDescriptor = {
+    /** Display name in the picker, e.g. "Poppins" */
+    name: string;
+    /** CSS font-family stack stored in textStyle marks, e.g. "Poppins, sans-serif" */
+    family: string;
+    /**
+     * woff2 source(s).
+     *   - string: single file covering all weights (variable font).
+     *   - Record<number, string>: per-weight map, e.g. { 400: '/p-400.woff2', 700: '/p-700.woff2' }.
+     *   - omitted: pure system font, no loading.
+     */
+    url?: string | Record<number, string>;
+    /**
+     * SVG preview rendered in the picker. Any React node that renders an <svg>.
+     * Falls back to the font name in the default font when absent.
+     */
+    preview?: React.ReactNode;
+};

package/dist/package/use-ddoc-editor.d.ts

@@ -2,7 +2,7 @@ import { DdocProps } from './types';
 import { Editor } from '@tiptap/react';
 import { DBlockRuntimeState } from './extensions/d-block/dblock-runtime';
 
-export declare const useDdocEditor: ({ isPreviewMode, viewerMode, initialContent, versionHistoryState, collaboration, onChange, onCollaboratorChange, onCommentInteraction, onError, setCharacterCount, setWordCount, setPageCount, ipfsImageUploadFn, ddocId, enableIndexeddbSync, unFocused, isFocusMode, theme, zoomLevel, onInvalidContentError, ignoreCorruptedData, isPresentationMode, metadataProxyUrl, extensions: externalExtensions, onCopyHeadingLink, ipfsImageFetchFn, fetchV1ImageFn, isConnected, activeModel, maxTokens, isAIAgentEnabled, onIndexedDbError, disableInlineComment, initialCommentAnchors, isPreviewEditor, ...rest }: Partial<DdocProps> & {
+export declare const useDdocEditor: ({ isPreviewMode, viewerMode, initialContent, versionHistoryState, collaboration, onChange, onCollaboratorChange, onCommentInteraction, onError, setCharacterCount, setWordCount, setPageCount, ipfsImageUploadFn, ddocId, enableIndexeddbSync, unFocused, isFocusMode, theme, zoomLevel, onInvalidContentError, ignoreCorruptedData, isPresentationMode, metadataProxyUrl, extensions: externalExtensions, onCopyHeadingLink, ipfsImageFetchFn, fetchV1ImageFn, isConnected, activeModel, maxTokens, isAIAgentEnabled, onIndexedDbError, disableInlineComment, initialCommentAnchors, isPreviewEditor, fonts, ...rest }: Partial<DdocProps> & {
     isFocusMode?: boolean;
     isPreviewEditor?: boolean;
 }) => {

package/dist/package/utils/font-loader.d.ts

@@ -0,0 +1,7 @@
+import { FontDescriptor } from '../types';
+
+/** "Poppins, sans-serif" -> "Poppins"; "'Times New Roman', serif" -> "Times New Roman" */
+export declare function primaryToken(family: string): string;
+export declare function registerFonts(fonts: FontDescriptor[]): void;
+export declare function isLoaded(family: string): boolean;
+export declare function ensureLoaded(family: string): Promise<void>;