noteloom 0.5.0 → 0.7.0

package/dist/index.d.ts

@@ -322,6 +322,10 @@ export class CollabSession {
   setLocalPresence(data: Record<string, unknown>): void;
   getPresence(): Map<string, Record<string, unknown>>;
   onPresenceChange(callback: (presence: Map<string, Record<string, unknown>>) => void): () => void;
+  sendCustom(channel: string, payload: unknown, remotePeerId?: string | null): void;
+  onCustomMessage(
+    callback: (channel: string, payload: unknown, remotePeerId: string) => void,
+  ): () => void;
 }
 
 export function createWebSocketSignaling(options: {
@@ -782,6 +786,12 @@ export interface EditorProviderProps {
   ) => Promise<{ src: string; name?: string; mimeType?: string }>;
   /** Byte cap for the in-document data: URL fallback ONLY (no effect once uploadFile is configured) -- an oversized file is rejected with a clear error instead of bloating the document. */
   maxFileSize?: number;
+  /** Turns block.props.src into whatever's actually loadable on this device right now, before EmbedBlock hands it to an img/video/audio -- see useFileUpload's own doc comment. May be a real React hook (called unconditionally on every EmbedBlock render) if it needs to be reactive. Identity when not configured. */
+  resolveEmbedSrc?: (src: string) => string;
+  /** Called once if the resolved src actually fails to load (the element's native error event) -- see useFileUpload's own doc comment. Never called for oembed/file kinds. */
+  onEmbedError?: (src: string) => void;
+  /** Syntax-colors CodeBlock's text -- returns trusted HTML, rendered via dangerouslySetInnerHTML in a read-only overlay behind the real editable text. No highlighter ships with this package (zero-runtime-dependency); wire in Prism/Shiki/highlight.js/etc. here. Plain monochrome text when not configured. See useHighlightCode's own doc comment. */
+  highlightCode?: (code: string, language: string) => string;
   children?: ReactNode;
 }
 
@@ -797,6 +807,8 @@ export function usePreviewMode(): [boolean, (value: boolean) => void];
 export function useCommentAuthorId(): string | undefined;
 /** Whether CodeBlock should render its line-number gutter -- see EditorProviderProps.showLineNumbers. */
 export function useShowLineNumbers(): boolean;
+/** `highlightCode` from EditorProvider, or undefined if not configured -- see EditorProviderProps.highlightCode. */
+export function useHighlightCode(): ((code: string, language: string) => string) | undefined;
 /** `{ uploadFile, maxFileSize }` from EditorProvider -- see EditorProviderProps and useFileUpload's own doc comment for the full contract. */
 export function useFileUpload(): {
   uploadFile?: (
@@ -804,6 +816,8 @@ export function useFileUpload(): {
     ctx: { kind: 'image' | 'video' | 'audio' | 'file' },
   ) => Promise<{ src: string; name?: string; mimeType?: string }>;
   maxFileSize?: number;
+  resolveEmbedSrc: (src: string) => string;
+  onEmbedError?: (src: string) => void;
 };
 export function useFieldTypeEditor(): {
   editingFieldTypeId: string | null;
@@ -873,6 +887,7 @@ export const BlockGutterRow: ComponentType<Record<string, unknown>>;
 export const BlockRangeActionMenu: ComponentType<Record<string, unknown>>;
 export function useBlockRangeDrag(containerRef: RefObject<HTMLElement | null>): void;
 export function useCoarsePointer(): boolean;
+export function useTouchOnlyDevice(): boolean;
 export function useVirtualKeyboardInset(): number;
 export const MobileActionBar: ComponentType<{ containerRef: RefObject<HTMLElement | null> }>;
 export const MobileBlockPickerSheet: ComponentType<Record<string, unknown>>;
@@ -1008,6 +1023,8 @@ export interface FloatingToolbarProps {
   onComment?: (range: CommentRange) => void;
   /** Adds a Comment button using a built-in inline composer (addComment(store, range, {authorId: commentAuthorId, text})) instead of onComment -- see NoteloomEditorProps.commentAuthorId. */
   commentAuthorId?: string;
+  /** Surfaces a mic start/stop button when given and voice.isSupported is true -- pass the object useVoiceTyping({ store: editor.store }) (from the separate `noteloom/voice` entry point) returns; the explicit `store` is required here since this call site sits outside the <EditorProvider> the toolbar itself renders inside of. Omit to keep SpeechRecognition-related code out of your bundle entirely. */
+  voice?: Record<string, unknown>;
 }
 
 export const FloatingToolbar: ComponentType<FloatingToolbarProps>;
@@ -1151,6 +1168,14 @@ export interface NoteloomEditorProps {
   ) => Promise<{ src: string; name?: string; mimeType?: string }>;
   /** Byte cap for the in-document data: URL fallback ONLY (no effect once uploadFile is configured). */
   maxFileSize?: number;
+  /** Turns block.props.src into whatever's actually loadable on this device right now -- see EditorProviderProps.resolveEmbedSrc / useFileUpload's own doc comment. */
+  resolveEmbedSrc?: (src: string) => string;
+  /** Called once if the resolved src actually fails to load -- see EditorProviderProps.onEmbedError. */
+  onEmbedError?: (src: string) => void;
+  /** Syntax-colors CodeBlock's text -- see EditorProviderProps.highlightCode / useHighlightCode's own doc comment. */
+  highlightCode?: (code: string, language: string) => string;
+  /** Surfaces a mic start/stop button in the floating format toolbar -- pass the object useVoiceTyping({ store: editor.store }) (from the separate `noteloom/voice` entry point) returns; see FloatingToolbarProps.voice for why the explicit `store` is required here. Omit to keep SpeechRecognition-related code out of your bundle entirely. */
+  voice?: Record<string, unknown>;
   children?: ReactNode;
 }
 
@@ -1236,6 +1261,14 @@ export function removePerson(store: EditorStore | History, id: string): void;
 /** Reactive view of the document's `people` collection. */
 export function usePeople(): Person[];
 
+// ---------------------------------------------------------------------------
+// title/title.js, react/useTitle.js — a document's own title
+// ---------------------------------------------------------------------------
+
+export function setTitle(store: EditorStore | History, title: string): void;
+/** Reactive view of the document's own title (see EditorStore.getTitle). */
+export function useTitle(): string;
+
 // ---------------------------------------------------------------------------
 // react/useSmartQuotes.js, react/useAutoPairBrackets.js — optional typing behaviors
 // ---------------------------------------------------------------------------