noteloom 0.4.0 → 0.6.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,10 @@ 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;
   children?: ReactNode;
 }
 
@@ -804,6 +812,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;
@@ -815,7 +825,8 @@ export function useBlockClassName(
   block: Block,
 ): string | undefined;
 
-export function injectDefaultStyles(): void;
+/** Inject the default theme `<style>` tag once. The explicit alternative to letting `<EditorProvider>` auto-inject (which a future major will stop doing) — or `import 'noteloom/theme'`. */
+export function injectDefaultStyles(options?: { auto?: boolean }): void;
 
 export function useBlock(id: string): Block | undefined;
 export function useRun(id: string): Run | undefined;
@@ -872,6 +883,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>>;
@@ -1007,6 +1019,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>;
@@ -1150,6 +1164,12 @@ 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;
+  /** 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;
 }
 
@@ -1235,6 +1255,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
 // ---------------------------------------------------------------------------