deepsky 2.56.32 → 2.56.36

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as vue from 'vue';
 import { Ref, Reactive, ShallowReactive, Component, ShallowRef, ComponentPublicInstance, ComputedRef } from 'vue';
-import { HotkeysEvent, KeyHandler } from 'hotkeys-js';
 import { IMath, DragList } from 'cook-web';
+import { HotkeysEvent, KeyHandler } from 'hotkeys-js';
 import { KatexOptions } from 'katex';
 import { Token, Tokens, Marked, TokensList } from 'marked';
 import { Highlighter } from 'shiki';
@@ -307,7 +307,7 @@ declare class DialogCatalogue extends DialogBase {
     set dialog_cube(v: CubeText | null);
     get dialog_tagname(): string;
     set dialog_tagname(v: string);
-    open(): Function | undefined;
+    open(): IUiTips.RemoveItemFunc | undefined;
     close(): void;
     dialog_add_bookmark(): NodeJS.Timeout | undefined;
 }
@@ -338,7 +338,7 @@ declare class DialogBadge extends DialogBase {
     open_insert(cursor_info: INoteCursor.CursorInfo, on_insert: (value: IBadge.Value) => void): void;
     select(value?: IBadge.Value | IBadge.PresetItem): void;
     /** Creates a self-contained custom value and optionally adds it to the saved candidates. */
-    create_custom(label: string, color: string, save?: boolean): Function | undefined;
+    create_custom(label: string, color: string, save?: boolean): IUiTips.RemoveItemFunc | undefined;
     /** Removes only the saved candidate; badges already inserted in the note keep their own value. */
     remove_custom(id: IBadge.BadgeId): void;
     /** Updated by the Vue view after layout changes; key navigation only reads this cache. */
@@ -355,7 +355,7 @@ declare class DialogBadge extends DialogBase {
 
 declare class DialogPreset extends DialogBase {
     constructor(note: Note);
-    open(): void | Function;
+    open(): void | IUiTips.RemoveItemFunc;
     add_scope(name: string, type: string, global?: boolean): Promise<boolean>;
 }
 
@@ -364,7 +364,7 @@ declare class DialogCss extends DialogBase {
     constructor(note: Note);
     get select_scope(): INoteScope.Info[];
     get select_cubes(): INote.NoteChild[];
-    open(): Function | undefined;
+    open(): IUiTips.RemoveItemFunc | undefined;
     close(): void;
 }
 
@@ -428,8 +428,8 @@ declare class DialogFormula extends DialogBase {
     set size(size: IFormula.Size);
     open(): void;
     edit_formula(cube: CubeFormula): void;
-    convert_latex_text(): Function | undefined;
-    send(): Function | undefined;
+    convert_latex_text(): IUiTips.RemoveItemFunc | undefined;
+    send(): IUiTips.RemoveItemFunc | undefined;
 }
 
 declare class DialogTable extends DialogBase {
@@ -456,9 +456,9 @@ declare class DialogLink extends DialogBase {
     set title(value: string);
     get url(): string;
     set url(value: string);
-    open(cursor_info?: INoteCursor.CursorInfo, on_confirm?: () => void): Function | undefined;
+    open(cursor_info?: INoteCursor.CursorInfo, on_confirm?: () => void): IUiTips.RemoveItemFunc | undefined;
     close(return_cursor?: boolean): void;
-    confirm(): Function | undefined;
+    confirm(): IUiTips.RemoveItemFunc | undefined;
 }
 
 declare class DialogRating extends DialogBase {
@@ -711,6 +711,7 @@ declare abstract class CubeChild<T extends ICubeBase.Data = any> extends CubeBas
     get can_merge(): boolean;
     get can_degradation(): boolean;
     is_atomic_child(child: INote.NoteChild): boolean;
+    is_boundary_child(child: INote.NoteChild, dir: ICommandCube.DeleteDir): boolean;
     get is_delete_edge_boundary(): boolean;
     get_delete_edge_strategy(dir: ICommandCube.DeleteDir): ICubeBase.DeleteEdgeStrategy;
     reveal_ancestors(recorder: Recorder): Recorder;
@@ -1782,7 +1783,7 @@ declare class UiAi extends UiBase {
     get dialogs(): IUiAi.DialogItem[];
     get going(): boolean;
     set going(v: boolean);
-    ask(question: string): Function | undefined;
+    ask(question: string): IUiTips.RemoveItemFunc | undefined;
     get separators(): string[];
     export(): {};
 }
@@ -1802,9 +1803,9 @@ declare class UICatalogue extends UiBase {
     listen(): void;
     add_group(group: IUiCatalogue.Group): void;
     update_anchor(map: Record<string, string>): void;
-    locate(id: string, scroll?: boolean): Promise<Function | undefined>;
-    delete_bookmark(bookmark: IUiCatalogue.Item, group: IUiCatalogue.Group): Function | undefined;
-    delete_group(group: IUiCatalogue.Group): Function | undefined;
+    locate(id: string, scroll?: boolean): Promise<IUiTips.RemoveItemFunc | undefined>;
+    delete_bookmark(bookmark: IUiCatalogue.Item, group: IUiCatalogue.Group): IUiTips.RemoveItemFunc | undefined;
+    delete_group(group: IUiCatalogue.Group): IUiTips.RemoveItemFunc | undefined;
     click(bookmark: IUiCatalogue.Item | IUiCatalogue.Group, group: IUiCatalogue.Group): void;
     export(): IUiCatalogue.Data;
 }
@@ -1882,8 +1883,8 @@ declare class UIDict extends UiBase {
     get keywords(): Map<string, IUiDict.KeywordItem[]>;
     get maps(): Map<string, IUiDict.AssociateItem[]>;
     get count(): number;
-    parse_keyword(word: string): Promise<string | Function>;
-    parse_associations(text: string): Promise<Function | string[]>;
+    parse_keyword(word: string): Promise<string | IUiTips.RemoveItemFunc>;
+    parse_associations(text: string): Promise<string[] | IUiTips.RemoveItemFunc>;
     get_candidate(input: string): IUiDict.WordBase[];
     load(data: IUiDict.Data): void;
     export(): IUiDict.Data;
@@ -1986,7 +1987,7 @@ declare class FloatRt extends FloatBase {
     };
     get cube(): CubeRt | null;
     set cube(cube: CubeRt | null);
-    open(): Function | undefined;
+    open(): IUiTips.RemoveItemFunc | undefined;
     edit_rt(cube: CubeRt): void;
 }
 
@@ -2104,7 +2105,7 @@ declare class UiMenubar extends UiBase {
     protected init(): void;
     register(item: IUiMenubar.Item, index?: number): void;
     note_import_markdown(): void;
-    note_record(): Function | undefined;
+    note_record(): IUiTips.RemoveItemFunc | undefined;
 }
 
 declare class UiPreset extends UiBase {
@@ -2302,10 +2303,10 @@ declare class UITheme extends UiBase {
     is_background_mode_active(mode: IUiTheme.BackgroundMode): boolean;
     load_themes(themes: IUiTheme.ThemeItem[]): void;
     load_background(backgrounds: IUiTheme.BackgroundItem[]): void;
-    fresh_themes(): Function | undefined;
-    fresh_backgrounds(): Function | undefined;
-    use_theme(key: string): Function | undefined;
-    use_background(key: string, mode?: IUiTheme.BackgroundMode): Function | undefined;
+    fresh_themes(): IUiTips.RemoveItemFunc | undefined;
+    fresh_backgrounds(): IUiTips.RemoveItemFunc | undefined;
+    use_theme(key: string): IUiTips.RemoveItemFunc | undefined;
+    use_background(key: string, mode?: IUiTheme.BackgroundMode): IUiTips.RemoveItemFunc | undefined;
     export(): IUiTheme.Data;
     get_background_mode_label(mode: IUiTheme.BackgroundMode): string;
     clear_background(mode?: IUiTheme.BackgroundMode): void;
@@ -2357,7 +2358,7 @@ declare class UIAccent extends UiBase {
     get_config<T extends Record<string, unknown>>(id: IUiAccent.Id): T | undefined;
     /** 可由第三方模组在笔记构建后调用。 */
     register<T extends Record<string, unknown>>(effect: AccentEffect<T>): AccentEffect<T>;
-    use(id: IUiAccent.Id | ""): Function | undefined;
+    use(id: IUiAccent.Id | ""): IUiTips.RemoveItemFunc | undefined;
     export(): IUiAccent.Data;
 }
 
@@ -2437,12 +2438,12 @@ declare class UIToolbar extends UiBase {
     export(): void;
     update_data(): void;
     register(item: ToolBase): void;
-    add_annotation(): Function | Recorder | undefined;
+    add_annotation(): Recorder | IUiTips.RemoveItemFunc | undefined;
     get_local_fonts(): Promise<IUi.FontItem[]>;
-    first_letter_lower(): Function | undefined;
-    first_line_indent(): Function | undefined;
+    first_letter_lower(): IUiTips.RemoveItemFunc | undefined;
+    first_line_indent(): IUiTips.RemoveItemFunc | undefined;
     fontsize_change(dir: "up" | "down"): void;
-    set_inline_scale(scale: number): Function | undefined;
+    set_inline_scale(scale: number): IUiTips.RemoveItemFunc | undefined;
     paste_md(): Promise<Recorder | undefined>;
     protected find_next_fontsize(fontsize: string, dir: "up" | "down"): string | undefined;
 }
@@ -2873,7 +2874,7 @@ declare class NoteAnchor extends NoteBase {
     get selecting(): boolean;
     start(source: CubeText): void;
     cancel(): void;
-    confirm(): Function | undefined;
+    confirm(): IUiTips.RemoveItemFunc | undefined;
     navigate(source: CubeText): Promise<void>;
     protected highlight(target: CubeChild): void;
 }
@@ -3058,8 +3059,8 @@ declare class NoteHistory extends NoteBase {
     get len_redo(): number;
     constructor(note: Note);
     protected execute_command_group(cmds: ICommandCube.BaseCommand[]): void;
-    undo(): Function | undefined;
-    redo(): Function | undefined;
+    undo(): IUiTips.RemoveItemFunc | undefined;
+    redo(): IUiTips.RemoveItemFunc | undefined;
     record(recorder: Recorder | undefined | void | null): void;
     export(index?: number): INoteHistory.Stack;
     download(filename?: string): void;
@@ -3216,6 +3217,158 @@ declare class CubeFiles extends CubeChild<IFiles.Data> {
     gc(): void;
 }
 
+declare class AdapterCubeMusic extends CubeAdapterBase {
+    get meta(): INote.CubeMeta;
+    get_data(info?: IMusic.Track[], css?: Record<string, string>, attrs?: Partial<IMusic.Attrs>): IMusic.Data;
+    normalize_resource(value: unknown): IMusic.Resource | undefined;
+    normalize_tracks(value: unknown): IMusic.Track[];
+    normalize_attrs(attrs?: Partial<IMusic.Attrs>): IMusic.Attrs;
+    replace_id(versions: INote.CubesVersion, data: IMusic.Data, map?: Record<string, string>): ICubeBase.ReplaceIdResult<IMusic.Data>;
+    update_data(versions: INote.CubesVersion, data: IMusic.Data): ICubeBase.CubeUpdateResult<IMusic.Data>;
+}
+
+type LyricFormat = "lrc" | "enhanced-lrc" | "srt" | "vtt" | "plain" | "unknown";
+interface LyricWord {
+    text: string;
+    startMs: number;
+    endMs: number;
+}
+interface LyricLine {
+    role: "main" | "translation" | "romanization" | "background";
+    text: string;
+    words?: LyricWord[];
+}
+interface LyricCue {
+    id: string;
+    startMs: number | null;
+    endMs: number | null;
+    lines: LyricLine[];
+}
+interface LyricDiagnostic {
+    level: "warning" | "error";
+    message: string;
+    line?: number;
+}
+interface LyricDocument {
+    version: 1;
+    source: {
+        key: string;
+        format: LyricFormat;
+        encoding?: string;
+    };
+    meta: {
+        title?: string;
+        artist?: string;
+        album?: string;
+        offsetMs: number;
+    };
+    synced: boolean;
+    cues: LyricCue[];
+    diagnostics: LyricDiagnostic[];
+}
+declare function finalize_lyrics(source: LyricDocument["source"], cues: LyricCue[], diagnostics?: LyricDiagnostic[], offsetMs?: number): LyricDocument;
+declare function find_active_cue(document: LyricDocument | undefined, timeMs: number): LyricCue | undefined;
+
+declare class MusicStatus extends CubeStatusBase<IMusic.Data> {
+    protected _tracks: vue.ShallowReactive<IMusic.Track[]>;
+    protected _lyrics: vue.Ref<LyricDocument | undefined, LyricDocument | undefined>;
+    protected _playlist_open: vue.Ref<boolean, boolean>;
+    readonly active_cue: vue.ComputedRef<LyricCue | undefined>;
+    get cube(): CubeMusic;
+    get tracks(): IMusic.Track[];
+    get lyrics(): LyricDocument | undefined;
+    get playlist_open(): boolean;
+    get player(): {
+        cubeId: string;
+        trackKey: string;
+        playing: boolean;
+        currentTime: number;
+        duration: number;
+        error: string;
+    };
+    get current_track(): IMusic.Track;
+    get is_current_player(): boolean;
+    init(): void;
+    update_tracks(tracks?: IMusic.Track[]): void;
+    toggle_playlist(): void;
+    load_current_lyrics(track?: IMusic.Track): Promise<void>;
+    select(track: IMusic.Track, play?: boolean): void;
+}
+
+declare class ReceiverMusic extends ReceiverChild<CubeMusic> {
+    protected reset(command: ICommandMusic.Reset): Recorder;
+    protected insert_music(command: ICommandMusic.Insert): Recorder | undefined;
+    protected remove(command: ICommandMusic.Remove): Recorder | undefined;
+    protected reorder(command: ICommandMusic.Reorder): Recorder | undefined;
+    protected update_track(command: ICommandMusic.UpdateTrack): Recorder | undefined;
+    protected update_attrs(command: ICommandMusic.UpdateAttrs): Recorder;
+}
+
+declare class CubeMusic extends CubeChild<IMusic.Data> {
+    protected _status: MusicStatus;
+    constructor(note: Note, data: IMusic.Data, pcube: CubeChild);
+    get adapter(): AdapterCubeMusic;
+    get status(): MusicStatus;
+    get component(): any;
+    get attrs(): IMusic.Attrs;
+    get tracks(): IMusic.Track[];
+    get is_empty(): boolean;
+    get text(): string;
+    build_child(): void;
+    protected lyric_asset_type(lyric: IMusic.Resource): IMusic.LyricAssetType;
+    protected retain_tracks(tracks: IMusic.Track[]): void;
+    protected release_tracks(tracks: IMusic.Track[]): void;
+    get_valid_index(pos: number): number;
+    insert_tracks(index: number, tracks: IMusic.Track[]): IMusic.Track[];
+    reset_tracks(tracks: IMusic.Track[]): void;
+    remove_tracks(keys: Set<string>): IMusic.Track[];
+    reorder_tracks(order: string[]): boolean;
+    update_track(key: string, patch: {
+        lyric?: IMusic.Resource | null;
+    }): IMusic.Track | undefined;
+    set_play_id(key?: string): void;
+    update_attrs(attrs: Partial<IMusic.Attrs>): IMusic.Attrs;
+    export_tracks(): IMusic.Track[];
+    export(): IMusic.Data;
+    gc(): void;
+}
+
+interface MusicPlaybackState {
+    cubeId: string;
+    trackKey: string;
+    playing: boolean;
+    currentTime: number;
+    duration: number;
+    error: string;
+}
+declare class MusicPlayer {
+    readonly state: {
+        cubeId: string;
+        trackKey: string;
+        playing: boolean;
+        currentTime: number;
+        duration: number;
+        error: string;
+    };
+    protected audio?: HTMLAudioElement;
+    protected cube?: CubeMusic;
+    protected track?: IMusic.Track;
+    protected remove_playing_tip?: () => boolean;
+    protected clear_playing_tip(): void;
+    protected show_playing_tip(): void;
+    protected ensure_audio(): HTMLAudioElement | undefined;
+    play(cube: CubeMusic, track: IMusic.Track): Promise<void>;
+    pause(): void;
+    stop(): void;
+    toggle(cube: CubeMusic, track: IMusic.Track): Promise<void>;
+    seek(timeMs: number): void;
+    previous(): void;
+    next(): void;
+    protected switch_track(direction: -1 | 1): void;
+    stop_for(cube: CubeMusic): void;
+}
+declare const MusicPlayerGlobal: MusicPlayer;
+
 declare class AdapterCubeBadge extends CubeAdapterBase {
     get supports_inline_scale(): boolean;
     get meta(): INote.CubeMeta;
@@ -3794,7 +3947,9 @@ declare class CubeApi extends CubeChild<IApi.Data> {
     set exceptions(val: CubeList | undefined);
     get component(): any;
     get children(): CubeList[];
+    get is_empty(): boolean;
     protected get atomic_child(): readonly string[];
+    get_delete_edge_strategy(dir: ICommandCube.DeleteDir): ICubeBase.DeleteEdgeStrategy;
     add_arguments(): void;
     add_exceptions(): void;
     build_child(data: IApi.Data): void;
@@ -4339,7 +4494,7 @@ declare class CubeCode extends CubeChild<ICode.Data> {
     private bg_to_rgba;
     update_code_html(): void;
     create_tab(lang: ICode.Langs, name: string, theme?: string): ICode.TabItem;
-    copy_code(): Function | undefined;
+    copy_code(): IUiTips.RemoveItemFunc | undefined;
 }
 
 declare class AdapterCubeFormula extends CubeAdapterBase {
@@ -4410,7 +4565,7 @@ declare class ReceiverTable extends ReceiverChild<CubeTable> {
     add_row(cmd: ICommandTable.AddRow): Recorder;
     remove_row(cmd: ICommandTable.RemoveRow): Recorder;
     add_col(cmd: ICommandTable.AddCol): Recorder;
-    remove_col(cmd: ICommandTable.RemoveCol): Function | Recorder | undefined;
+    remove_col(cmd: ICommandTable.RemoveCol): Recorder | IUiTips.RemoveItemFunc | undefined;
     moveto(cmd: ICommandTable.CellMoveTo): Recorder | undefined;
     protected update_area(cmd: ICommandTable.CellUpdateArea): Recorder | undefined;
     merge_cell(cmd: ICommandTable.Merge): Recorder | undefined;
@@ -4934,7 +5089,7 @@ declare class NoteScopes extends NoteBase {
     get freeze(): Set<NoteScope>;
     clear(): void;
     add_by_cube(cube: CubeChild): void;
-    add_scope(using_cursor?: boolean): Function | undefined;
+    add_scope(using_cursor?: boolean): IUiTips.RemoveItemFunc | undefined;
     remove_scope(scope: string | NoteScope): void;
     clear_scope(filter?: boolean): void;
     freeze_scopes(): void;
@@ -5042,6 +5197,7 @@ declare const AdapterFormula: AdapterCubeFormula;
 declare const AdapterImg: AdapterCubeImg;
 declare const AdapterGallery: AdapterCubeGallery;
 declare const AdapterFiles: AdapterCubeFiles;
+declare const AdapterMusic: AdapterCubeMusic;
 declare const AdapterKey: AdapterCubeKey;
 declare const AdapterLine: AdapterCubeLine;
 declare const AdapterLinker: AdapterCubeLinker;
@@ -6189,6 +6345,69 @@ declare namespace ICommandFiles {
     }
 }
 
+declare namespace IMusic {
+    type PlayOrder = "sequence" | "list-loop" | "single-loop" | "shuffle";
+    /** Legacy lyrics may still live in the generic attachment directory. */
+    type LyricAssetType = "audio" | "attach";
+    /** A binary resource stored by the note asset service. */
+    interface Resource {
+        key: string;
+        name: string;
+        mime?: string;
+        size: number;
+        /** Only used by lyric resources; absent values are treated as legacy attachments. */
+        asset_type?: LyricAssetType;
+    }
+    /** One ordered playlist entry. Its identity is audio.key. */
+    interface Track {
+        audio: Resource;
+        lyric?: Resource;
+    }
+    interface Attrs extends ICubeBase.Attrs {
+        play_id?: string;
+        play_order: PlayOrder;
+        show_lyrics: boolean;
+        width: number;
+        height: number;
+    }
+    interface Data extends ICubeBase.Data {
+        type: "music";
+        info: Track[];
+        attrs: Attrs;
+    }
+}
+
+declare namespace ICommandMusic {
+    interface Reset extends ICommandCube.BaseCommand {
+        name: "music:reset";
+        data: IMusic.Track[];
+    }
+    interface Insert extends ICommandCube.BaseCommand {
+        name: "music:insert";
+        data: IMusic.Track[];
+        pos: number;
+    }
+    interface Remove extends ICommandCube.BaseCommand {
+        name: "music:remove";
+        keys: string[];
+    }
+    interface Reorder extends ICommandCube.BaseCommand {
+        name: "music:reorder";
+        order: string[];
+    }
+    interface UpdateTrack extends ICommandCube.BaseCommand {
+        name: "music:update-track";
+        key: string;
+        patch: {
+            lyric?: IMusic.Resource | null;
+        };
+    }
+    interface UpdateAttrs extends ICommandCube.BaseCommand {
+        name: "music:update-attrs";
+        attrs: Partial<Pick<IMusic.Attrs, "play_id" | "play_order" | "show_lyrics" | "width" | "height">>;
+    }
+}
+
 declare namespace INoteTools {
     interface CubePick {
         head: ICubeBase.Data[];
@@ -7157,7 +7376,7 @@ declare namespace INoteCourier { }
 
 declare namespace INote {
     type AssetType = "image" | "audio" | "attach";
-    type Cubes = (string & {}) | "api" | "annotation" | "badge" | "box" | "box-root" | "box-folder" | "box-columns" | "checkbox" | "code" | "counter" | "doc" | "datetime" | "detail-list" | "files" | "formula" | "gallery" | "img" | "key" | "lost" | "line" | "list" | "list-ordered" | "linker" | "link" | "map" | "submap" | "node" | "postil" | "rating" | "rt" | "text" | "tip" | "timeline" | "todo" | "table";
+    type Cubes = (string & {}) | "api" | "annotation" | "badge" | "box" | "box-root" | "box-folder" | "box-columns" | "checkbox" | "code" | "counter" | "doc" | "datetime" | "detail-list" | "files" | "formula" | "gallery" | "img" | "key" | "lost" | "line" | "list" | "list-ordered" | "linker" | "link" | "map" | "submap" | "music" | "node" | "postil" | "rating" | "rt" | "text" | "tip" | "timeline" | "todo" | "table";
     type Cores = "courier" | "cursor" | "config" | "cubes" | "clipboard" | "event" | "formula" | "float" | "painter" | "player" | "hotkeys" | "history" | "scope" | "flag";
     type Mode = "read" | "edit" | "export";
     type ModeNames = Record<Mode, string>;
@@ -7845,7 +8064,7 @@ declare namespace IUiTips {
         click?: ItemClick;
     }
     type ItemClick = (e: MouseEvent) => any;
-    type RemoveItemFunc = Function;
+    type RemoveItemFunc = () => boolean;
 }
 
 declare namespace IUiToolbar {
@@ -8092,6 +8311,15 @@ declare class CommandFiles {
     static replace(id: string, key: string, data: IFiles.Item): ICommandFiles.Replace;
 }
 
+declare class CommandMusic {
+    static reset(id: string, data: IMusic.Track[]): ICommandMusic.Reset;
+    static insert(id: string, data: IMusic.Track[], pos: number): ICommandMusic.Insert;
+    static remove(id: string, keys: string[]): ICommandMusic.Remove;
+    static reorder(id: string, order: string[]): ICommandMusic.Reorder;
+    static update_track(id: string, key: string, patch: ICommandMusic.UpdateTrack["patch"]): ICommandMusic.UpdateTrack;
+    static update_attrs(id: string, attrs: ICommandMusic.UpdateAttrs["attrs"]): ICommandMusic.UpdateAttrs;
+}
+
 type ReceiverConstructor = new (cube: CubeBase) => ReceiverBase;
 declare class ReceiverRegistry {
     create(cube: CubeBase, fallback?: new (cube: any) => ReceiverBase): ReceiverBase;
@@ -8276,6 +8504,12 @@ declare class MenuFiles extends MenuBase<CubeFiles> {
 
 declare function get_menu_files(cube: CubeFiles): ICubesMenu.NoteMenu;
 
+declare class MenuMusic extends MenuBase<CubeMusic> {
+    get_menus(cube: CubeMusic): ICubesMenu.NoteMenu;
+}
+
+declare function get_menu_music(cube: CubeMusic): ICubesMenu.NoteMenu;
+
 declare class LayoutChecker {
     static check_allow(upstream: MapNodeBase | undefined, downstream_layout_type: INodeBase.Layout, nullable?: boolean): boolean;
     static get left(): INodeBase.Layout[];
@@ -8387,7 +8621,7 @@ declare class NoteTools {
     static sleep(time?: number): Promise<unknown>;
     static is_same_style(css1: Record<string, string>, css2: Record<string, string>): boolean;
     static is_same_attrs(attrs1: Record<string, any>, attrs2: Record<string, any>): boolean;
-    locate(doc: CubeDoc, id: string, scroll?: boolean): Promise<Function | undefined>;
+    locate(doc: CubeDoc, id: string, scroll?: boolean): Promise<IUiTips.RemoveItemFunc | undefined>;
     static exports(cubes: CubeChild[]): ICubeBase.Data[];
     static get_client_rects(id: ICubeBase.CubeId): DOMRectList | undefined;
     static find_line(cube: INote.NoteChild, order?: "first" | "last"): CubeLine | undefined;
@@ -8426,4 +8660,4 @@ declare class MobileReadonlyViewer {
     protected get guard_events(): string[];
 }
 
-export { AccentEffect, AdapterApi, AdapterBadge, AdapterBaseUi, AdapterBox, AdapterBoxColumns, AdapterBoxFolder, AdapterBoxRoot, AdapterCheckbox, AdapterCode, AdapterCounter, AdapterCubes, AdapterDatetime, AdapterDetailList, AdapterDoc, AdapterFiles, AdapterFormula, AdapterGallery, AdapterImg, AdapterKey, AdapterLine, AdapterLink, AdapterLinker, AdapterList, AdapterListOrdered, AdapterLost, AdapterMap, AdapterNode, AdapterPostil, AdapterRating, AdapterRt, AdapterSubmap, AdapterTable, AdapterText, AdapterTimeline, AdapterTip, AdapterTodo, AdapterUi, AdapterUiAccent, AdapterUiAi, AdapterUiCatalogue, AdapterUiConfig, AdapterUiDialog, AdapterUiDialogCubeList, AdapterUiDict, AdapterUiFloat, AdapterUiMenubar, AdapterUiPreset, AdapterUiSearch, AdapterUiSidebar, AdapterUiStatusbar, AdapterUiTheme, AdapterUiTips, AdapterUiToolbar, ApiStatus, BadgeStatus, BoxFolderStatus, BoxRootStatus, BoxStatus, CheckboxStatus, CodeStatus, CommandApi, CommandBadge, CommandBoxFolder, CommandBoxRoot, CommandCheckbox, CommandCode, CommandCounter, CommandCube, CommandCursor, CommandDateTime, CommandDetailList, CommandFiles, CommandFormula, CommandGallery, CommandKey, CommandLink, CommandLinker, CommandList, CommandListOrdered, CommandMap, CommandNode, CommandRating, CommandRt, CommandTable, CommandText, CommandTimeline, CommandTodo, ConstColors, ConvertorMd, CubeAdapterBase, CubeApi, CubeBadge, CubeBase, CubeBox, CubeBoxColumns, CubeBoxFolder, CubeBoxRoot, CubeCheckbox, CubeChild, CubeCode, CubeCounter, CubeDatetime, CubeDetailList, CubeDoc, CubeFiles, CubeFormula, CubeGallery, CubeImg, CubeKey, CubeLine, CubeLink, CubeLinker, CubeList, CubeListOrdered, CubeListenerBase, CubeLost, CubeMap, CubeNode, CubePostil, CubeRating, CubeRoot, CubeRt, CubeStatusBase, CubeStatusBaseRoot, CubeSubMap, CubeTable, CubeText, CubeTimeline, CubeTip, CubeTodo, DatetimeStatus, DetailListStatus, DocStatus, EventBubble, FormulaStatus, GalleryStatus, type HotkeyPlatform, IApi, IBadge, IBox, ICheckbox, ICode, ICommandApi, ICommandBadge, ICommandCheckbox, ICommandCode, ICommandCounter, ICommandCube, ICommandCursor, ICommandDateTime, ICommandDetailList, ICommandDoc, ICommandFiles, ICommandFormula, ICommandGallery, ICommandKey, ICommandLink, ICommandLinker, ICommandList, ICommandListOrdered, ICommandMap, ICommandNode, ICommandRating, ICommandRt, ICommandTable, ICommandText, ICommandTimeline, ICommandTodo, ICounter, ICubeBase, ICubeBaseChild, ICubeBoxColumns, ICubeBoxFolder, ICubeBoxRoot, ICubeHandler, ICubeRootBase, ICubesInteraction, ICubesMenu, IDateTime, IDetailList, IDoc, IFiles, IFormula, IGallery, IImg, IKey, ILine, ILink, ILinker, IList, IListOrdered, ILost, IMap, IMapBase, IMapExport, IMapInteraction, IMapTools, IMenuNode, IMiniMap, IMisc, type IMobileReadonlyViewerInput, INode, INodeBase, INodeBaseEnv, INodeDrag, INote, INoteApi, INoteAssets, INoteClipboard, INoteClock, INoteConvertor, INoteCourier, INoteCursor, INoteEvent, INoteFlag, INoteFloat, INoteHistory, INoteInteraction, INoteMod, INoteScope, INoteTools, IPostil, IRating, IRt, ISubMap, ITable, IText, ITimeline, ITip, ITodo, IUi, IUiAccent, IUiAi, IUiCatalogue, IUiConfig, IUiDialog, IUiDialogCubeList, IUiDict, IUiFloat, IUiMenubar, IUiPreset, IUiSidebar, IUiStatusbar, IUiTheme, IUiTips, IUiToolbar, ImgStatus, InteractionBase, InteractionBinder, InteractionDetailList, InteractionList, InteractionListOrdered, InteractionTable, InteractionTodo, InteractionsCube, InteractionsCubeRegistry, KeyStatus, LayoutChecker, LineStatus, LinkStatus, LinkerLine, LinkerPoint, ListOrderedStatus, ListStatus, LostStatus, Map2D, MapCanvas, MapChild, MapExportDefaults, MapExporter, MapHotkeys, MapInteraction, MapNodeBase, MapNodeLayoutEnv, MapStatus, MapTools, Matrix2D, MenuApi, MenuBadge, MenuBase, MenuBox, MenuBoxColumns, MenuBoxFolder, MenuBoxRoot, MenuCheckbox, MenuCode, MenuCounter, MenuDatetime, MenuDetailList, MenuFiles, MenuGallery, MenuImg, MenuKey, MenuLink, MenuList, MenuListOrdered, MenuNode, MenuRating, MenuSubmap, MenuTable, MenuTimeline, MenuTip, MenuTodo, MenusCube, MenusCubeRegistry, MobileReadonlyViewer, NodeBase2D, NodeLayout, NodeLayoutInvert, NodeLayoutMeter, NodeLineStatus, NodeObserver, NodeShape, NodeStatus, NodeStatusBase, Note, NoteAction, NoteAnchor, NoteApi, NoteAssets, NoteBase, NoteClipBoard, NoteClock, NoteConvertor, NoteCourier, NoteCubes, NoteCursor, NoteEvent, NoteEventListenerBase, NoteEventListeners, NoteFlag, NoteHistory, NoteHotkeyBase, NoteInteraction, NoteListener, NoteMod, NotePainter, NoteScope, NoteScopes, NoteTools, PostilStatus, RatingStatus, ReceiverApi, ReceiverBadge, ReceiverBase, ReceiverBox, ReceiverBoxColumns, ReceiverBoxFolder, ReceiverBoxRoot, ReceiverCheckbox, ReceiverChild, ReceiverCode, ReceiverCounter, ReceiverCubes, ReceiverDatetime, ReceiverDetailList, ReceiverDoc, ReceiverFiles, ReceiverFormula, ReceiverGallery, ReceiverImg, ReceiverKey, ReceiverLine, ReceiverLink, ReceiverLinker, ReceiverList, ReceiverListOrdered, ReceiverLost, ReceiverMap, ReceiverMapChild, ReceiverNode, ReceiverPostil, ReceiverRating, ReceiverRegistry, ReceiverRoot, ReceiverRt, ReceiverSubMap, ReceiverTable, ReceiverText, ReceiverTimeline, ReceiverTip, ReceiverTodo, Recorder, RtStatus, StatusItemBase, type StatusItemComponentProps, type StatusItemPlacement, SubmapStatus, TableStatus, TextStatus, type TimelineItem, TipStatus, TodoStatus, ToolBase, UI, UIAccent, UICatalogue, UIDict, UISearch, UIStatusbar, UITheme, UIToolbar, UiBase, UiConfig, UiFloat, UiMenubar, UiPreset, UiSidebar, UiTips, Waiter, type _CubeTextAnnotation, type _CubeTodoItem, type _CubeTodoItemData, type _FigScale, type _Map, type _MapCubes, _MapGroup, type _MapPlaceholderLinker, _PlayStatus, type _PointFig, type _PointKey, type _PointView, type _SDKMeta, cmd, copy_event_listener, create_builtin_accents, cube, cut_event_listener, define_cmd, detect_hotkey_platform, get_cmds, get_cube_menu, get_menu_base, get_menu_code, get_menu_counter, get_menu_files, get_menu_gallery, get_menu_inline_scale, get_menu_timeline, get_receiver_type, has_pcube_menu, hotkey, is_platform_shortcut, menu_status, move_rect, node_observer, normalize_platform, paste_event_listener, receiver, resolve_hotkey_shortcut, set_inline_scale, show_code_file_dialog, show_menu, supports_inline_scale, to_platform_shortcut, use_box_interaction, use_clock_wakeup, use_list_item_drag, waiter_map_svg };
+export { AccentEffect, AdapterApi, AdapterBadge, AdapterBaseUi, AdapterBox, AdapterBoxColumns, AdapterBoxFolder, AdapterBoxRoot, AdapterCheckbox, AdapterCode, AdapterCounter, AdapterCubes, AdapterDatetime, AdapterDetailList, AdapterDoc, AdapterFiles, AdapterFormula, AdapterGallery, AdapterImg, AdapterKey, AdapterLine, AdapterLink, AdapterLinker, AdapterList, AdapterListOrdered, AdapterLost, AdapterMap, AdapterMusic, AdapterNode, AdapterPostil, AdapterRating, AdapterRt, AdapterSubmap, AdapterTable, AdapterText, AdapterTimeline, AdapterTip, AdapterTodo, AdapterUi, AdapterUiAccent, AdapterUiAi, AdapterUiCatalogue, AdapterUiConfig, AdapterUiDialog, AdapterUiDialogCubeList, AdapterUiDict, AdapterUiFloat, AdapterUiMenubar, AdapterUiPreset, AdapterUiSearch, AdapterUiSidebar, AdapterUiStatusbar, AdapterUiTheme, AdapterUiTips, AdapterUiToolbar, ApiStatus, BadgeStatus, BoxFolderStatus, BoxRootStatus, BoxStatus, CheckboxStatus, CodeStatus, CommandApi, CommandBadge, CommandBoxFolder, CommandBoxRoot, CommandCheckbox, CommandCode, CommandCounter, CommandCube, CommandCursor, CommandDateTime, CommandDetailList, CommandFiles, CommandFormula, CommandGallery, CommandKey, CommandLink, CommandLinker, CommandList, CommandListOrdered, CommandMap, CommandMusic, CommandNode, CommandRating, CommandRt, CommandTable, CommandText, CommandTimeline, CommandTodo, ConstColors, ConvertorMd, CubeAdapterBase, CubeApi, CubeBadge, CubeBase, CubeBox, CubeBoxColumns, CubeBoxFolder, CubeBoxRoot, CubeCheckbox, CubeChild, CubeCode, CubeCounter, CubeDatetime, CubeDetailList, CubeDoc, CubeFiles, CubeFormula, CubeGallery, CubeImg, CubeKey, CubeLine, CubeLink, CubeLinker, CubeList, CubeListOrdered, CubeListenerBase, CubeLost, CubeMap, CubeMusic, CubeNode, CubePostil, CubeRating, CubeRoot, CubeRt, CubeStatusBase, CubeStatusBaseRoot, CubeSubMap, CubeTable, CubeText, CubeTimeline, CubeTip, CubeTodo, DatetimeStatus, DetailListStatus, DocStatus, EventBubble, FormulaStatus, GalleryStatus, type HotkeyPlatform, IApi, IBadge, IBox, ICheckbox, ICode, ICommandApi, ICommandBadge, ICommandCheckbox, ICommandCode, ICommandCounter, ICommandCube, ICommandCursor, ICommandDateTime, ICommandDetailList, ICommandDoc, ICommandFiles, ICommandFormula, ICommandGallery, ICommandKey, ICommandLink, ICommandLinker, ICommandList, ICommandListOrdered, ICommandMap, ICommandMusic, ICommandNode, ICommandRating, ICommandRt, ICommandTable, ICommandText, ICommandTimeline, ICommandTodo, ICounter, ICubeBase, ICubeBaseChild, ICubeBoxColumns, ICubeBoxFolder, ICubeBoxRoot, ICubeHandler, ICubeRootBase, ICubesInteraction, ICubesMenu, IDateTime, IDetailList, IDoc, IFiles, IFormula, IGallery, IImg, IKey, ILine, ILink, ILinker, IList, IListOrdered, ILost, IMap, IMapBase, IMapExport, IMapInteraction, IMapTools, IMenuNode, IMiniMap, IMisc, type IMobileReadonlyViewerInput, IMusic, INode, INodeBase, INodeBaseEnv, INodeDrag, INote, INoteApi, INoteAssets, INoteClipboard, INoteClock, INoteConvertor, INoteCourier, INoteCursor, INoteEvent, INoteFlag, INoteFloat, INoteHistory, INoteInteraction, INoteMod, INoteScope, INoteTools, IPostil, IRating, IRt, ISubMap, ITable, IText, ITimeline, ITip, ITodo, IUi, IUiAccent, IUiAi, IUiCatalogue, IUiConfig, IUiDialog, IUiDialogCubeList, IUiDict, IUiFloat, IUiMenubar, IUiPreset, IUiSidebar, IUiStatusbar, IUiTheme, IUiTips, IUiToolbar, ImgStatus, InteractionBase, InteractionBinder, InteractionDetailList, InteractionList, InteractionListOrdered, InteractionTable, InteractionTodo, InteractionsCube, InteractionsCubeRegistry, KeyStatus, LayoutChecker, LineStatus, LinkStatus, LinkerLine, LinkerPoint, ListOrderedStatus, ListStatus, LostStatus, type LyricCue, type LyricDiagnostic, type LyricDocument, type LyricFormat, type LyricLine, type LyricWord, Map2D, MapCanvas, MapChild, MapExportDefaults, MapExporter, MapHotkeys, MapInteraction, MapNodeBase, MapNodeLayoutEnv, MapStatus, MapTools, Matrix2D, MenuApi, MenuBadge, MenuBase, MenuBox, MenuBoxColumns, MenuBoxFolder, MenuBoxRoot, MenuCheckbox, MenuCode, MenuCounter, MenuDatetime, MenuDetailList, MenuFiles, MenuGallery, MenuImg, MenuKey, MenuLink, MenuList, MenuListOrdered, MenuMusic, MenuNode, MenuRating, MenuSubmap, MenuTable, MenuTimeline, MenuTip, MenuTodo, MenusCube, MenusCubeRegistry, MobileReadonlyViewer, type MusicPlaybackState, MusicPlayer, MusicPlayerGlobal, NodeBase2D, NodeLayout, NodeLayoutInvert, NodeLayoutMeter, NodeLineStatus, NodeObserver, NodeShape, NodeStatus, NodeStatusBase, Note, NoteAction, NoteAnchor, NoteApi, NoteAssets, NoteBase, NoteClipBoard, NoteClock, NoteConvertor, NoteCourier, NoteCubes, NoteCursor, NoteEvent, NoteEventListenerBase, NoteEventListeners, NoteFlag, NoteHistory, NoteHotkeyBase, NoteInteraction, NoteListener, NoteMod, NotePainter, NoteScope, NoteScopes, NoteTools, PostilStatus, RatingStatus, ReceiverApi, ReceiverBadge, ReceiverBase, ReceiverBox, ReceiverBoxColumns, ReceiverBoxFolder, ReceiverBoxRoot, ReceiverCheckbox, ReceiverChild, ReceiverCode, ReceiverCounter, ReceiverCubes, ReceiverDatetime, ReceiverDetailList, ReceiverDoc, ReceiverFiles, ReceiverFormula, ReceiverGallery, ReceiverImg, ReceiverKey, ReceiverLine, ReceiverLink, ReceiverLinker, ReceiverList, ReceiverListOrdered, ReceiverLost, ReceiverMap, ReceiverMapChild, ReceiverMusic, ReceiverNode, ReceiverPostil, ReceiverRating, ReceiverRegistry, ReceiverRoot, ReceiverRt, ReceiverSubMap, ReceiverTable, ReceiverText, ReceiverTimeline, ReceiverTip, ReceiverTodo, Recorder, RtStatus, StatusItemBase, type StatusItemComponentProps, type StatusItemPlacement, SubmapStatus, TableStatus, TextStatus, type TimelineItem, TipStatus, TodoStatus, ToolBase, UI, UIAccent, UICatalogue, UIDict, UISearch, UIStatusbar, UITheme, UIToolbar, UiBase, UiConfig, UiFloat, UiMenubar, UiPreset, UiSidebar, UiTips, Waiter, type _CubeTextAnnotation, type _CubeTodoItem, type _CubeTodoItemData, type _FigScale, type _Map, type _MapCubes, _MapGroup, type _MapPlaceholderLinker, _PlayStatus, type _PointFig, type _PointKey, type _PointView, type _SDKMeta, cmd, copy_event_listener, create_builtin_accents, cube, cut_event_listener, define_cmd, detect_hotkey_platform, finalize_lyrics, find_active_cue, get_cmds, get_cube_menu, get_menu_base, get_menu_code, get_menu_counter, get_menu_files, get_menu_gallery, get_menu_inline_scale, get_menu_music, get_menu_timeline, get_receiver_type, has_pcube_menu, hotkey, is_platform_shortcut, menu_status, move_rect, node_observer, normalize_platform, paste_event_listener, receiver, resolve_hotkey_shortcut, set_inline_scale, show_code_file_dialog, show_menu, supports_inline_scale, to_platform_shortcut, use_box_interaction, use_clock_wakeup, use_list_item_drag, waiter_map_svg };