deepsky 2.60.0 → 2.63.0

package/dist/index.d.ts

@@ -707,6 +707,9 @@ declare abstract class CubeChild<T extends ICubeBase.Data = any> extends CubeBas
     postil: CubePostil | null;
     constructor(note: Note, data: T, pcube: INote.NoteCube);
     get pcube(): INote.NoteCube;
+    /** Containers can restrict editing to their active content without persisting view state. */
+    allows_child_editing(_child: CubeChild): boolean;
+    get is_content_editable(): boolean;
     protected create_receiver(): ReceiverChild;
     get text(): string;
     get boxroot(): CubeBoxRoot;
@@ -986,9 +989,45 @@ declare abstract class NoteHotkeyBase extends NoteBase {
     export(): INoteInteraction.HotkeyConfig;
 }
 
+declare abstract class NoteEventListenerBase<E extends Event = Event> {
+    /** 装饰器创建的监听器是单例，因此按笔记保存实际注册的宿主和回调。 */
+    protected records: WeakMap<Note, {
+        host: HTMLElement;
+        handler: EventListener;
+    }>;
+    abstract get type(): string;
+    protected abstract get_host(note: Note, dom: HTMLElement): HTMLElement;
+    protected abstract handle(note: Note, e: E, dom: HTMLElement): any;
+    protected target_inside(dom: HTMLElement, e: Event): boolean;
+    protected target_is_editable(e: Event): boolean;
+    protected can_handle_scope(note: Note, e: Event, dom: HTMLElement): boolean;
+    register(note: Note, dom: HTMLElement): void;
+    unregister(note: Note): void;
+}
+
+declare class PasteEventListener extends NoteEventListenerBase<ClipboardEvent> {
+    get type(): string;
+    protected get_host(note: Note, dom: HTMLElement): HTMLElement;
+    protected handle(note: Note, e: ClipboardEvent, dom: HTMLElement): Promise<void>;
+}
+
+declare class CopyEventListener extends NoteEventListenerBase<ClipboardEvent> {
+    get type(): string;
+    protected get_host(note: Note, dom: HTMLElement): HTMLElement;
+    protected handle(note: Note, e: ClipboardEvent, dom: HTMLElement): void;
+}
+
+declare class CutEventListener extends NoteEventListenerBase<ClipboardEvent> {
+    get type(): string;
+    protected get_host(note: Note, dom: HTMLElement): HTMLElement;
+    protected handle(note: Note, e: ClipboardEvent, dom: HTMLElement): void;
+}
+
 declare class NoteInteraction extends NoteBase {
     protected _hotkeys: Map<string, NoteHotkeyBase>;
     protected _inited: boolean;
+    protected _listening_dom?: HTMLElement;
+    protected _pointerdown_handler?: EventListener;
     /**
      * 当前持有“暂停笔记快捷键”资格的弹窗令牌。scope 是全局状态，因此必须等
      * 最后一个弹窗释放令牌后才能恢复，避免嵌套弹窗的内层关闭时提前恢复。
@@ -1014,6 +1053,8 @@ declare class NoteInteraction extends NoteBase {
     resume_hotkey(token: symbol): void;
     set_scope(scope: INoteInteraction.Scope): void;
     listen(dom: HTMLElement): void;
+    protected unlisten(): void;
+    dispose(): void;
     init(config?: Partial<INoteInteraction.Data>, options?: INoteInteraction.HotkeyInitOptions): void;
     register(hotkey: NoteHotkeyBase, config?: INoteInteraction.HotkeyConfig): void;
     protected init_hotkey(hotkey: NoteHotkeyBase, config?: INoteInteraction.HotkeyConfig): void;
@@ -1042,42 +1083,11 @@ declare function resolve_hotkey_shortcut(shortcut: INoteInteraction.Shortcut, pl
 /** 将旧字符串规范成可持久化的平台快捷键表。 */
 declare function to_platform_shortcut(shortcut: INoteInteraction.Shortcut): INoteInteraction.PlatformShortcut;
 
-declare abstract class NoteEventListenerBase<E extends Event = Event> {
-    protected records: WeakMap<Note, {
-        host: HTMLElement;
-        handler: EventListener;
-    }>;
-    abstract get type(): string;
-    protected abstract get_host(note: Note, dom: HTMLElement): HTMLElement;
-    protected abstract handle(note: Note, e: E): any;
-    register(note: Note, dom: HTMLElement): void;
-}
-
-declare class PasteEventListener extends NoteEventListenerBase<ClipboardEvent> {
-    get type(): string;
-    protected get_host(note: Note, dom: HTMLElement): HTMLElement;
-    protected handle(note: Note, e: ClipboardEvent): Promise<void>;
-}
-declare const paste_event_listener: PasteEventListener;
-
-declare class CopyEventListener extends NoteEventListenerBase<ClipboardEvent> {
-    get type(): string;
-    protected get_host(note: Note, dom: HTMLElement): HTMLElement;
-    protected handle(note: Note, e: ClipboardEvent): void;
-}
-declare const copy_event_listener: CopyEventListener;
-
-declare class CutEventListener extends NoteEventListenerBase<ClipboardEvent> {
-    get type(): string;
-    protected get_host(note: Note, dom: HTMLElement): HTMLElement;
-    protected handle(note: Note, e: ClipboardEvent): void;
-}
-declare const cut_event_listener: CutEventListener;
-
-declare const NoteEventListeners: NoteEventListenerBase[];
-
 declare const MapHotkeys: Map<string, NoteHotkeyBase>;
 declare function hotkey(cls: typeof NoteHotkeyBase): void;
+/** 收集浏览器事件监听器，由 NoteInteraction.listen() 为每个笔记统一注册。 */
+declare const MapEventListeners: Map<string, NoteEventListenerBase>;
+declare function event_listener<T extends new () => NoteEventListenerBase<any>>(cls: T): void;
 
 declare class Waiter {
     protected _promise: Promise<any>;
@@ -3085,6 +3095,7 @@ declare class Note {
     protected _root: CubeRoot;
     protected _ui: UI;
     protected _app: any;
+    protected _dom?: HTMLElement;
     protected _isdev: boolean;
     protected _uidata: IUi.Data;
     protected _cubes: NoteCubes;
@@ -3104,6 +3115,10 @@ declare class Note {
     constructor(notedata: IDoc.Data | IMap.Data, uidata?: IUi.Data);
     get uidata(): IUi.Data;
     get id(): string;
+    get dom(): HTMLElement | undefined;
+    get is_active(): boolean;
+    /** 将当前笔记设为文档级事件的目标，不改变 DOM 焦点或文本光标。 */
+    activate(): boolean;
     get version_cubes(): INote.CubesVersion;
     get version_data(): INote.CubesVersion;
     get isdev(): boolean;
@@ -3356,6 +3371,163 @@ declare class CubeFiles extends CubeChild<IFiles.Data> {
     gc(): void;
 }
 
+declare class AdapterCubeFlashCard extends CubeAdapterBase {
+    get meta(): INote.CubeMeta;
+    normalize_attrs(attrs?: Partial<IFlashCard.Attrs>): IFlashCard.Attrs;
+    get_data(info?: Partial<IFlashCard.Info>, css?: Record<string, any>, attrs?: Partial<IFlashCard.Attrs>): IFlashCard.Data;
+    update_data(versions: INote.CubesVersion, data: IFlashCard.Data): ICubeBase.CubeUpdateResult<IFlashCard.Data>;
+    replace_id(versions: INote.CubesVersion, data: IFlashCard.Data, map?: Record<string, string>): ICubeBase.ReplaceIdResult<IFlashCard.Data>;
+}
+
+declare class AdapterCubeBox extends CubeAdapterBase {
+    get meta(): INote.CubeMeta;
+    get_data(content?: ICubeBase.Data[], css?: Record<string, any>, attrs?: Record<string, any>): IBox.Data;
+    replace_id(versions: INote.CubesVersion, data: IBox.Data, map?: Record<string, string>): ICubeBase.ReplaceIdResult<IBox.Data>;
+    update_data(versions: INote.CubesVersion, data: IBox.Data): ICubeBase.CubeUpdateResult;
+}
+
+declare class BoxStatus extends CubeStatusBase<IBox.Data> {
+    constructor(cube: CubeBox);
+}
+
+declare class ReceiverBox extends ReceiverChild<CubeBox> {
+    on_merge(command: ICommandCube.Merge): Recorder | void;
+    on_box_order(command: ICommandCube.Reorder): Recorder | void;
+    on_insert_child(command: ICommandCube.InsertChild): Recorder | void;
+    on_delete_child(command: ICommandCube.DeleteChild): Recorder | void;
+    on_box_reset(command: ICommandCube.Reset): Recorder | void;
+    on_cube_delete_adjacent(command: ICommandCube.DeleteAdjacent): Recorder;
+}
+
+declare class CubeBox extends CubeChild<IBox.Data> {
+    protected _status: BoxStatus;
+    constructor(note: Note, data: IBox.Data, pcube: CubeChild);
+    get adapter(): AdapterCubeBox;
+    get status(): BoxStatus;
+    get children(): CubeChild[];
+    get component(): any;
+    get can_merge(): boolean;
+    get attrs(): IBox.Attrs;
+    get meta(): INote.CubeMeta<INote.Cubes>;
+    get is_empty(): boolean;
+    build_child(data: IBox.Data): void;
+    export(): IBox.Data;
+    gc(): void;
+    get_valid_index(pos: number | INote.CubeSide): number;
+}
+
+declare class FlashCardStatus extends CubeStatusBase<IFlashCard.Data> {
+    private _face;
+    private _editing;
+    private _fill_target;
+    get face(): IFlashCard.Face;
+    set face(value: IFlashCard.Face);
+    get editing(): boolean;
+    set editing(value: boolean);
+    get fill_target(): IFlashCard.Face | null;
+    set fill_target(value: IFlashCard.Face | null);
+    get css(): {
+        width: string;
+        height: string;
+    };
+}
+
+declare class ReceiverFlashCard extends ReceiverChild<CubeFlashCard> {
+    protected cursor_in_head(_command: ICommandCursor.InHead): Recorder;
+    protected cursor_in_tail(_command: ICommandCursor.InTail): Recorder;
+    protected delete_edge(_command: ICommandCube.DeleteEdge): Recorder;
+    protected delete_faces(command: ICommandCube.DeleteChild): Recorder;
+}
+
+declare class CubeFlashCard extends CubeChild<IFlashCard.Data> {
+    protected _status: FlashCardStatus;
+    private remove_fill_tip?;
+    private remove_escape_listener?;
+    constructor(note: Note, data: IFlashCard.Data, pcube: INote.NoteCube);
+    get adapter(): AdapterCubeFlashCard;
+    get component(): any;
+    get status(): FlashCardStatus;
+    get attrs(): IFlashCard.Attrs;
+    get question(): CubeBox;
+    get answer(): CubeBox;
+    get current_box(): CubeBox;
+    get visible_tail_cube(): CubeChild;
+    find_next_cube(_id: string): undefined;
+    find_prev_cube(_id: string): undefined;
+    get is_empty(): boolean;
+    get can_degradation(): boolean;
+    get is_delete_edge_boundary(): boolean;
+    protected get atomic_child(): string[];
+    allows_child_editing(child: CubeChild): boolean;
+    protected build_child(data: IFlashCard.Data): void;
+    export(): IFlashCard.Data;
+    private clear_cursor;
+    focus_face(): Promise<void>;
+    set_editing(editing: boolean): void;
+    flip(): void;
+    start_fill(): void;
+    cancel_fill(): void;
+    confirm_fill(): void | IUiTips.RemoveItemFunc;
+    gc(): void;
+}
+
+declare class AdapterCubeFlashCardDeck extends CubeAdapterBase {
+    get meta(): INote.CubeMeta;
+    normalize_attrs(attrs?: Partial<IFlashCardDeck.Attrs>): IFlashCardDeck.Attrs;
+    get_data(info?: IFlashCard.Data[], css?: Record<string, any>, attrs?: Partial<IFlashCardDeck.Attrs>): IFlashCardDeck.Data;
+    update_data(versions: INote.CubesVersion, data: IFlashCardDeck.Data): ICubeBase.CubeUpdateResult<IFlashCardDeck.Data>;
+    replace_id(versions: INote.CubesVersion, data: IFlashCardDeck.Data, map?: Record<string, string>): ICubeBase.ReplaceIdResult<IFlashCardDeck.Data>;
+}
+
+declare class FlashCardDeckStatus extends CubeStatusBase<IFlashCardDeck.Data> {
+    private _cards;
+    private _active_id;
+    get cards(): CubeFlashCard[];
+    get attrs(): IFlashCardDeck.Attrs;
+    get active_id(): string | null;
+    get active_card(): CubeFlashCard | undefined;
+    init(): void;
+    update_cards(preferred?: string | null): void;
+    set_active(id: string | null): void;
+}
+
+declare class ReceiverFlashCardDeck extends ReceiverChild<CubeFlashCardDeck> {
+    private cards;
+    protected insert_cards(command: ICommandCube.InsertChild): Recorder | undefined;
+    protected delete_cards(command: ICommandCube.DeleteChild): Recorder | undefined;
+    protected reset_cards(command: ICommandCube.Reset): Recorder;
+    protected reorder_card(command: ICommandCube.Reorder): Recorder | undefined;
+    protected cursor_in_head(_command: ICommandCursor.InHead): Recorder;
+    protected cursor_in_tail(_command: ICommandCursor.InTail): Recorder;
+    protected delete_edge(_command: ICommandCube.DeleteEdge): Recorder;
+    protected delete_adjacent(command: ICommandCube.DeleteAdjacent): Recorder;
+}
+
+declare class CubeFlashCardDeck extends CubeChild<IFlashCardDeck.Data> {
+    protected _status: FlashCardDeckStatus;
+    constructor(note: Note, data: IFlashCardDeck.Data, pcube: INote.NoteCube);
+    get adapter(): AdapterCubeFlashCardDeck;
+    get component(): any;
+    get status(): FlashCardDeckStatus;
+    get cards(): CubeFlashCard[];
+    get can_degradation(): boolean;
+    get is_delete_edge_boundary(): boolean;
+    protected get atomic_child(): string[];
+    get visible_tail_cube(): CubeChild;
+    find_next_cube(_id: string): undefined;
+    find_prev_cube(_id: string): undefined;
+    allows_child_editing(child: CubeChild): boolean;
+    protected build_child(data: IFlashCardDeck.Data): void;
+    export(): IFlashCardDeck.Data;
+    /** Copying a selected child produces a standalone card at the displayed deck size. */
+    copy(left: number, right: number): IFlashCard.Data[];
+    splice_cards(index: number, count: number, data?: IFlashCard.Data[]): void;
+    reorder_card(id: string, index: number): void;
+    add_card(): void;
+    step(delta: number): void;
+    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;
@@ -3521,6 +3693,157 @@ declare class CubeMusic extends CubeChild<IMusic.Data> {
     gc(): void;
 }
 
+declare class AdapterCubeVideo extends CubeAdapterBase {
+    get meta(): INote.CubeMeta;
+    normalize_resource(value: unknown): IVideo.Resource | undefined;
+    normalize_info(info?: Partial<IVideo.Info>): IVideo.Info;
+    normalize_attrs(attrs?: Partial<IVideo.Attrs>): IVideo.Attrs;
+    get_data(info?: Partial<IVideo.Info>, css?: Record<string, any>, attrs?: Partial<IVideo.Attrs>): IVideo.Data;
+    update_data(versions: INote.CubesVersion, data: IVideo.Data): ICubeBase.CubeUpdateResult<IVideo.Data>;
+    replace_id(_versions: INote.CubesVersion, data: IVideo.Data, map?: Record<string, string>): ICubeBase.ReplaceIdResult<IVideo.Data>;
+}
+
+declare class VideoStatus extends CubeStatusBase<IVideo.Data> {
+    readonly player: {
+        playing: boolean;
+        loading: boolean;
+        error: string;
+        current_time: number;
+        duration: number;
+        video_width: number;
+        video_height: number;
+        volume: number;
+        muted: boolean;
+        rate: number;
+        buffered: [number, number][];
+    };
+    private _importing;
+    private _import_error;
+    get attrs(): IVideo.Attrs;
+    get source(): {
+        kind: "file";
+        file: {
+            key: string;
+            name: string;
+            size: number;
+            mime?: string | undefined;
+        };
+    } | null;
+    get poster(): {
+        key: string;
+        name: string;
+        size: number;
+        mime?: string | undefined;
+    } | undefined;
+    get importing(): boolean;
+    set importing(value: boolean);
+    get import_error(): string;
+    set import_error(value: string);
+    update_video(info: IVideo.Info): void;
+    reset_playback(): void;
+}
+
+/** Owns one native media element; controls and playback state are supplied by the SDK. */
+declare class VideoPlayer {
+    private cube;
+    private element?;
+    private removers;
+    private generation;
+    constructor(cube: CubeVideo);
+    attach(element: HTMLVideoElement): void;
+    refresh(): Promise<void>;
+    toggle(): Promise<void>;
+    pause(): void;
+    seek(time: number): void;
+    volume(value: number): void;
+    mute(): void;
+    rate(value: number): void;
+    detach(): void;
+}
+
+declare class ReceiverVideo extends ReceiverChild<CubeVideo> {
+    protected replace(command: IVideo.Replace): Recorder;
+}
+
+declare class CubeVideo extends CubeChild<IVideo.Data> {
+    protected _status: VideoStatus;
+    readonly player: VideoPlayer;
+    assets_ready: Promise<boolean>;
+    private copy_from?;
+    import_generation: number;
+    disposed: boolean;
+    constructor(note: Note, data: IVideo.Data, pcube: INote.NoteCube);
+    get adapter(): AdapterCubeVideo;
+    get component(): any;
+    get status(): VideoStatus;
+    get attrs(): IVideo.Attrs;
+    get is_empty(): boolean;
+    get text(): string;
+    get can_degradation(): boolean;
+    build_child(): void;
+    private copy_assets;
+    retry_load(): Promise<void>;
+    private retain;
+    private release;
+    replace_video(info: IVideo.Info): void;
+    export(): IVideo.Data;
+    gc(): void;
+}
+
+declare const is_video_file: (file: File) => boolean;
+declare function import_video_file(cube: CubeVideo, file: File): Promise<void>;
+declare function add_video_file(cube: CubeVideo): Promise<void>;
+
+declare class AdapterCubeHabitTracker extends CubeAdapterBase {
+    get meta(): INote.CubeMeta;
+    normalize_info(info?: Partial<IHabitTracker.Info>): IHabitTracker.Info;
+    normalize_attrs(attrs?: Partial<IHabitTracker.Attrs>): IHabitTracker.Attrs;
+    get_data(info?: Partial<IHabitTracker.Info>, css?: Record<string, any>, attrs?: Partial<IHabitTracker.Attrs>): IHabitTracker.Data;
+    update_data(versions: INote.CubesVersion, data: IHabitTracker.Data): ICubeBase.CubeUpdateResult<IHabitTracker.Data>;
+    replace_id(_versions: INote.CubesVersion, data: IHabitTracker.Data, map?: Record<string, string>): ICubeBase.ReplaceIdResult<IHabitTracker.Data>;
+}
+
+declare class HabitStatus extends CubeStatusBase<IHabitTracker.Data> {
+    readonly anchor: _vue_reactivity.Ref<string | undefined, string | undefined>;
+    readonly temporary_view: _vue_reactivity.Ref<IHabitTracker.View | undefined, IHabitTracker.View | undefined>;
+    readonly editing: _vue_reactivity.Ref<boolean, boolean>;
+    get attrs(): IHabitTracker.Attrs;
+    get today(): string;
+    get date(): string;
+    get view(): IHabitTracker.View;
+    update_details(): void;
+    update_date(date: string, checked: boolean): void;
+}
+
+declare class ReceiverHabitTracker extends ReceiverChild<CubeHabitTracker> {
+    protected set_date(command: IHabitTracker.SetDate): Recorder | undefined;
+    protected configure(command: IHabitTracker.Configure): Recorder | undefined;
+}
+
+declare class CubeHabitTracker extends CubeChild<IHabitTracker.Data> {
+    protected _status: HabitStatus;
+    context_date?: string;
+    disposed: boolean;
+    constructor(note: Note, data: IHabitTracker.Data, pcube: INote.NoteCube);
+    get adapter(): AdapterCubeHabitTracker;
+    get component(): any;
+    get status(): HabitStatus;
+    get attrs(): IHabitTracker.Attrs;
+    get is_empty(): boolean;
+    get text(): string;
+    get can_degradation(): boolean;
+    get editable(): boolean;
+    build_child(): void;
+    apply_date(date: string, checked: boolean): void;
+    toggle_date(date?: string): void;
+    configure(title: string, description: string): void;
+    set_view(view: IHabitTracker.View): void;
+    navigate(delta: number): void;
+    edit(): void;
+    export(): IHabitTracker.Data;
+    gc(): void;
+}
+
 declare class AdapterCubeBadge extends CubeAdapterBase {
     get supports_inline_scale(): boolean;
     get meta(): INote.CubeMeta;
@@ -3852,43 +4175,6 @@ declare class CubeBoxRoot extends CubeChild<ICubeBoxRoot.Data> {
     get_valid_index(pos: number | INote.CubeSide): number;
 }
 
-declare class AdapterCubeBox extends CubeAdapterBase {
-    get meta(): INote.CubeMeta;
-    get_data(content?: ICubeBase.Data[], css?: Record<string, any>, attrs?: Record<string, any>): IBox.Data;
-    replace_id(versions: INote.CubesVersion, data: IBox.Data, map?: Record<string, string>): ICubeBase.ReplaceIdResult<IBox.Data>;
-    update_data(versions: INote.CubesVersion, data: IBox.Data): ICubeBase.CubeUpdateResult;
-}
-
-declare class BoxStatus extends CubeStatusBase<IBox.Data> {
-    constructor(cube: CubeBox);
-}
-
-declare class ReceiverBox extends ReceiverChild<CubeBox> {
-    on_merge(command: ICommandCube.Merge): Recorder | void;
-    on_box_order(command: ICommandCube.Reorder): Recorder | void;
-    on_insert_child(command: ICommandCube.InsertChild): Recorder | void;
-    on_delete_child(command: ICommandCube.DeleteChild): Recorder | void;
-    on_box_reset(command: ICommandCube.Reset): Recorder | void;
-    on_cube_delete_adjacent(command: ICommandCube.DeleteAdjacent): Recorder;
-}
-
-declare class CubeBox extends CubeChild<IBox.Data> {
-    protected _status: BoxStatus;
-    constructor(note: Note, data: IBox.Data, pcube: CubeChild);
-    get adapter(): AdapterCubeBox;
-    get status(): BoxStatus;
-    get children(): CubeChild[];
-    get component(): any;
-    get can_merge(): boolean;
-    get attrs(): IBox.Attrs;
-    get meta(): INote.CubeMeta<INote.Cubes>;
-    get is_empty(): boolean;
-    build_child(data: IBox.Data): void;
-    export(): IBox.Data;
-    gc(): void;
-    get_valid_index(pos: number | INote.CubeSide): number;
-}
-
 declare class AdapterCubeBoxFolder extends CubeAdapterBase {
     get meta(): INote.CubeMeta;
     filter_out_empty(cubes: ICubeBase.Data[]): ICubeBase.Data[];
@@ -5362,7 +5648,11 @@ declare const AdapterFormula: AdapterCubeFormula;
 declare const AdapterImg: AdapterCubeImg;
 declare const AdapterGallery: AdapterCubeGallery;
 declare const AdapterFiles: AdapterCubeFiles;
+declare const AdapterFlashCard: AdapterCubeFlashCard;
+declare const AdapterFlashCardDeck: AdapterCubeFlashCardDeck;
 declare const AdapterMusic: AdapterCubeMusic;
+declare const AdapterVideo: AdapterCubeVideo;
+declare const AdapterHabitTracker: AdapterCubeHabitTracker;
 declare const AdapterKey: AdapterCubeKey;
 declare const AdapterLine: AdapterCubeLine;
 declare const AdapterLinker: AdapterCubeLinker;
@@ -6573,6 +6863,67 @@ declare namespace ICommandMusic {
     }
 }
 
+declare namespace IVideo {
+    type Data = V1;
+    interface V1 extends ICubeBase.Data<"video"> {
+        info: Info;
+        attrs: Attrs;
+    }
+    interface Resource {
+        key: string;
+        name: string;
+        size: number;
+        mime?: string;
+    }
+    interface FileSource {
+        kind: "file";
+        file: Resource;
+    }
+    interface Info {
+        source: FileSource | null;
+        poster?: Resource;
+    }
+    interface Attrs extends ICubeBase.Attrs {
+        title?: string;
+        /** Video viewport dimensions, excluding the custom control bar. */
+        width: number;
+        height: number;
+    }
+    interface Replace extends ICommandCube.BaseCommand {
+        name: "video:replace";
+        info: Info;
+    }
+}
+
+declare namespace IHabitTracker {
+    type Data = V1;
+    interface V1 extends ICubeBase.Data<"habit-tracker"> {
+        info: Info;
+        attrs: Attrs;
+    }
+    interface Info {
+        name: string;
+        description?: string;
+        /** Sorted, unique local calendar dates (YYYY-MM-DD), never UTC timestamps. */
+        records: string[];
+    }
+    type View = "week" | "month";
+    interface Attrs extends ICubeBase.Attrs {
+        view: View;
+        width: number;
+    }
+    interface SetDate extends ICommandCube.BaseCommand {
+        name: "habit-tracker:set-date";
+        date: string;
+        checked: boolean;
+    }
+    interface Configure extends ICommandCube.BaseCommand {
+        name: "habit-tracker:configure";
+        title: string;
+        description: string;
+    }
+}
+
 declare namespace INoteTools {
     interface CubePick {
         head: ICubeBase.Data[];
@@ -7334,6 +7685,37 @@ declare namespace ICommandRt {
     }
 }
 
+declare namespace IFlashCard {
+    type Data = V1;
+    interface V1 extends ICubeBase.Data<"flash-card"> {
+        info: Info;
+        attrs: Attrs;
+    }
+    interface Info {
+        question: IBox.Data;
+        answer: IBox.Data;
+    }
+    interface Attrs extends ICubeBase.Attrs {
+        /** Shared outer dimensions of both faces, in CSS pixels. */
+        width: number;
+        height: number;
+    }
+    type Face = "question" | "answer";
+}
+
+declare namespace IFlashCardDeck {
+    type Data = V1;
+    interface V1 extends ICubeBase.Data<"flash-cards"> {
+        info: IFlashCard.Data[];
+        attrs: Attrs;
+    }
+    interface Attrs extends ICubeBase.Attrs {
+        /** Dimensions of each card, excluding the rotated stack's extra bounds. */
+        width: number;
+        height: number;
+    }
+}
+
 declare namespace ICubeBase {
     type CubeId = string;
     type DeleteEdgeStrategy = "remove-self" | "merge" | "cursor-transfer" | "degradation" | "bubble" | "stop";
@@ -7534,8 +7916,8 @@ declare enum _PlayStatus {
 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" | "music" | "node" | "postil" | "rating" | "rt" | "text" | "tip" | "timeline" | "todo" | "table";
+    type AssetType = "image" | "audio" | "video" | "attach";
+    type Cubes = (string & {}) | "api" | "annotation" | "badge" | "box" | "box-root" | "box-folder" | "box-columns" | "checkbox" | "code" | "counter" | "doc" | "datetime" | "detail-list" | "files" | "flash-card" | "flash-cards" | "formula" | "gallery" | "img" | "key" | "lost" | "line" | "list" | "list-ordered" | "linker" | "link" | "map" | "submap" | "music" | "video" | "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>;
@@ -7585,6 +7967,7 @@ declare namespace INote {
     interface AssetMap {
         images: Record<string, number>;
         audio?: Record<string, number>;
+        video?: Record<string, number>;
         attach?: Record<string, number>;
     }
     type ArchiveNoteType = "note" | "mapnote" | (string & {});
@@ -8511,6 +8894,15 @@ declare class CommandMusic {
     static update_attrs(id: string, attrs: ICommandMusic.UpdateAttrs["attrs"]): ICommandMusic.UpdateAttrs;
 }
 
+declare class CommandVideo {
+    static replace(id: string, info: IVideo.Info): IVideo.Replace;
+}
+
+declare class CommandHabitTracker {
+    static set_date(id: string, date: string, checked: boolean): IHabitTracker.SetDate;
+    static configure(id: string, title: string, description?: string): IHabitTracker.Configure;
+}
+
 type ReceiverConstructor = new (cube: CubeBase) => ReceiverBase;
 declare class ReceiverRegistry {
     create(cube: CubeBase, fallback?: new (cube: any) => ReceiverBase): ReceiverBase;
@@ -8783,6 +9175,31 @@ declare class MapTools {
     static get_rect_area(from: IMath.Point, to: IMath.Point, radius?: number): string;
 }
 
+/**
+ * 管理当前页面中的交互式笔记及其文档级状态。
+ *
+ * 所有 DOM 激活入口统一监听在 documentElement 的捕获阶段，因此不会受到
+ * Cube 内部 stopPropagation() 的影响，也不需要各个组件重复维护监听器。
+ */
+declare class NoteManagerGlobal {
+    protected _active_note?: Note;
+    protected _notes: Set<Note>;
+    protected _listening: boolean;
+    protected _activate_from_event: EventListener;
+    get active_note(): Note | undefined;
+    get notes(): Set<Note>;
+    is_active(note: Note): boolean;
+    activate(note: Note): boolean;
+    register(note: Note): void;
+    unregister(note: Note): void;
+    protected listen(): void;
+    protected unlisten(): void;
+    /** 按事件传播路径由内向外匹配 Note，自然支持笔记容器嵌套。 */
+    protected find_note(event: Event): Note | undefined;
+}
+/** 当前页面唯一的 Note 管理器。 */
+declare const NoteManager: NoteManagerGlobal;
+
 /** Shared runtime clock for all Note instances in this browser context. */
 declare const NoteClock: INoteClock.Api;
 
@@ -8851,4 +9268,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, 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, IUiDialogCss, 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, ToolItemBase, ToolbarPanel, type ToolbarPanelItem, type ToolbarPanelLevel, 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, create_paint_items, 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 };
+export { AccentEffect, AdapterApi, AdapterBadge, AdapterBaseUi, AdapterBox, AdapterBoxColumns, AdapterBoxFolder, AdapterBoxRoot, AdapterCheckbox, AdapterCode, AdapterCounter, AdapterCubes, AdapterDatetime, AdapterDetailList, AdapterDoc, AdapterFiles, AdapterFlashCard, AdapterFlashCardDeck, AdapterFormula, AdapterGallery, AdapterHabitTracker, 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, AdapterVideo, ApiStatus, BadgeStatus, BoxFolderStatus, BoxRootStatus, BoxStatus, CheckboxStatus, CodeStatus, CommandApi, CommandBadge, CommandBoxFolder, CommandBoxRoot, CommandCheckbox, CommandCode, CommandCounter, CommandCube, CommandCursor, CommandDateTime, CommandDetailList, CommandFiles, CommandFormula, CommandGallery, CommandHabitTracker, CommandKey, CommandLink, CommandLinker, CommandList, CommandListOrdered, CommandMap, CommandMusic, CommandNode, CommandRating, CommandRt, CommandTable, CommandText, CommandTimeline, CommandTodo, CommandVideo, ConstColors, ConvertorMd, CopyEventListener, CubeAdapterBase, CubeApi, CubeBadge, CubeBase, CubeBox, CubeBoxColumns, CubeBoxFolder, CubeBoxRoot, CubeCheckbox, CubeChild, CubeCode, CubeCounter, CubeDatetime, CubeDetailList, CubeDoc, CubeFiles, CubeFlashCard, CubeFlashCardDeck, CubeFormula, CubeGallery, CubeHabitTracker, CubeImg, CubeKey, CubeLine, CubeLink, CubeLinker, CubeList, CubeListOrdered, CubeListenerBase, CubeLost, CubeMap, CubeMusic, CubeNode, CubePostil, CubeRating, CubeRoot, CubeRt, CubeStatusBase, CubeStatusBaseRoot, CubeSubMap, CubeTable, CubeText, CubeTimeline, CubeTip, CubeTodo, CubeVideo, CutEventListener, DatetimeStatus, DetailListStatus, DocStatus, EventBubble, FlashCardDeckStatus, FlashCardStatus, 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, IFlashCard, IFlashCardDeck, IFormula, IGallery, IHabitTracker, 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, IUiDialogCss, IUiDialogCubeList, IUiDict, IUiFloat, IUiMenubar, IUiPreset, IUiSidebar, IUiStatusbar, IUiTheme, IUiTips, IUiToolbar, IVideo, 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, MapEventListeners, 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, NoteFlag, NoteHistory, NoteHotkeyBase, NoteInteraction, NoteListener, NoteManager, NoteManagerGlobal, NoteMod, NotePainter, NoteScope, NoteScopes, NoteTools, PasteEventListener, PostilStatus, RatingStatus, ReceiverApi, ReceiverBadge, ReceiverBase, ReceiverBox, ReceiverBoxColumns, ReceiverBoxFolder, ReceiverBoxRoot, ReceiverCheckbox, ReceiverChild, ReceiverCode, ReceiverCounter, ReceiverCubes, ReceiverDatetime, ReceiverDetailList, ReceiverDoc, ReceiverFiles, ReceiverFlashCard, ReceiverFlashCardDeck, ReceiverFormula, ReceiverGallery, ReceiverHabitTracker, ReceiverImg, ReceiverKey, ReceiverLine, ReceiverLink, ReceiverLinker, ReceiverList, ReceiverListOrdered, ReceiverLost, ReceiverMap, ReceiverMapChild, ReceiverMusic, ReceiverNode, ReceiverPostil, ReceiverRating, ReceiverRegistry, ReceiverRoot, ReceiverRt, ReceiverSubMap, ReceiverTable, ReceiverText, ReceiverTimeline, ReceiverTip, ReceiverTodo, ReceiverVideo, Recorder, RtStatus, StatusItemBase, type StatusItemComponentProps, type StatusItemPlacement, SubmapStatus, TableStatus, TextStatus, type TimelineItem, TipStatus, TodoStatus, ToolBase, ToolItemBase, ToolbarPanel, type ToolbarPanelItem, type ToolbarPanelLevel, UI, UIAccent, UICatalogue, UIDict, UISearch, UIStatusbar, UITheme, UIToolbar, UiBase, UiConfig, UiFloat, UiMenubar, UiPreset, UiSidebar, UiTips, VideoStatus, 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, add_video_file, cmd, create_builtin_accents, create_paint_items, cube, define_cmd, detect_hotkey_platform, event_listener, 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, import_video_file, is_platform_shortcut, is_video_file, menu_status, move_rect, node_observer, normalize_platform, 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 };