deepsky 2.41.11 → 2.42.2

package/dist/index.d.ts

@@ -1113,7 +1113,7 @@ declare class UiSidebar extends UiBase {
         get version(): number;
         get type(): IUi.Core;
     };
-    get width_min(): 300;
+    get width_min(): number;
     get width_max(): 1200;
     get visible(): boolean;
     get active(): IUiSidebar.Type;
@@ -1558,7 +1558,8 @@ declare class NoteCursor extends NoteBase {
     load(): void;
     export(): {};
     update_data(...args: any[]): object;
-    fake_selection_rects(rect_list?: DOMRect[]): void;
+    fake_cursor(): DOMRectList | undefined;
+    fake_selection_rects(rect_list?: DOMRect[], duration?: number): void;
     static get meta(): INote.CoreMeta;
 }
 
@@ -2076,6 +2077,13 @@ declare class Note {
     get metas(): Map<string, INote.CubeMeta>;
     init(): void;
     render(dom: HTMLElement): void;
+    /**
+     * Mounts a document root without the desktop editor chrome or interaction
+     * listeners. This is intended for trusted, host-owned read-only viewers.
+     */
+    render_readonly(dom: HTMLElement): void;
+    /** Releases the Vue tree created by [render_readonly]. */
+    unmount_readonly(): void;
     render_pdf(dom: HTMLElement): void;
     emit_event_after_render(): void;
     find_cube(type: INote.Cubes): any;
@@ -3580,6 +3588,7 @@ declare class CubeTip extends CubeChild<ITip.Data> {
     get box(): CubeBox;
     set box(value: CubeBox);
     get children(): CubeBox[];
+    get text(): string;
     protected build_child(data: ITip.Data): void;
     export(): ITip.Data;
     gc(): void;
@@ -4075,17 +4084,17 @@ declare class CubeStatusBase<T extends ICubeBase.Data> {
 }
 
 /**
- * Cube 实例级的快捷键语义控制器。
+ * Cube 实例级的交互语义控制器。
  *
- * 子类只维护同一份 ICubesHotkeys.Item 定义：它既用于绑定快捷键，也用于向右键菜单贡献菜单项。
- * DOM 绑定和视图生命周期由 HotkeyBinder / use_box_hotkeys 管理。
+ * 子类只维护同一份 ICubesInteraction.Item 定义：它既用于绑定交互，也用于向右键菜单贡献菜单项。
+ * DOM 绑定和视图生命周期由 InteractionBinder / use_box_interaction 管理。
  */
-declare class HotkeyBase<TCube extends CubeBase = CubeBase> {
+declare class InteractionBase<TCube extends CubeBase = CubeBase> {
     protected readonly cube: TCube;
     constructor(cube: TCube);
-    protected get items(): ICubesHotkeys.Item[];
+    protected get items(): ICubesInteraction.Item[];
     get menus(): ICubesMenu.MenuItem[];
-    get hotkeys(): readonly ICubesHotkeys.Item[];
+    get interactions(): readonly ICubesInteraction.Item[];
     execute(id: string, event: KeyboardEvent, hotkeyEvent: HotkeysEvent): boolean | void;
     protected execution(id: string, event: KeyboardEvent, hotkeyEvent: HotkeysEvent): boolean | void;
 }
@@ -4095,24 +4104,24 @@ interface RegisteredHandler {
     handler: KeyHandler;
 }
 /** 将快捷键语义控制器绑定到任意 DOM 节点，不包含任何 CubeBox 或 Vue 约定。 */
-declare class HotkeyBinder {
-    protected readonly hotkey: HotkeyBase;
+declare class InteractionBinder {
+    protected readonly interaction: InteractionBase;
     protected readonly handlers: Map<HTMLElement, RegisteredHandler[]>;
-    constructor(hotkey: HotkeyBase);
+    constructor(interaction: InteractionBase);
     bind(dom: HTMLElement): void;
     unbind(dom: HTMLElement): void;
     dispose(): void;
 }
 
-declare class HotkeyDetailList extends HotkeyBase<CubeDetailList> {
-    protected get items(): ICubesHotkeys.Item[];
+declare class InteractionDetailList extends InteractionBase<CubeDetailList> {
+    protected get items(): ICubesInteraction.Item[];
     protected execution(id: string, event: KeyboardEvent, hotkeyEvent: HotkeysEvent): boolean | void;
     private item;
     private add;
 }
 
-declare class HotkeyList extends HotkeyBase<CubeList> {
-    protected get items(): ICubesHotkeys.Item[];
+declare class InteractionList extends InteractionBase<CubeList> {
+    protected get items(): ICubesInteraction.Item[];
     protected execution(id: string, event: KeyboardEvent, hotkeyEvent: HotkeysEvent): boolean | void;
     private item;
     private add;
@@ -4121,8 +4130,8 @@ declare class HotkeyList extends HotkeyBase<CubeList> {
     private get_selected_items;
 }
 
-declare class HotkeyListOrdered extends HotkeyBase<CubeListOrdered> {
-    protected get items(): ICubesHotkeys.Item[];
+declare class InteractionListOrdered extends InteractionBase<CubeListOrdered> {
+    protected get items(): ICubesInteraction.Item[];
     protected execution(id: string, event: KeyboardEvent, hotkeyEvent: HotkeysEvent): boolean | void;
     private item;
     private add;
@@ -4131,8 +4140,8 @@ declare class HotkeyListOrdered extends HotkeyBase<CubeListOrdered> {
     private get_selected_items;
 }
 
-declare class HotkeyTodo extends HotkeyBase<CubeTodo> {
-    protected get items(): ICubesHotkeys.Item[];
+declare class InteractionTodo extends InteractionBase<CubeTodo> {
+    protected get items(): ICubesInteraction.Item[];
     protected execution(id: string, event: KeyboardEvent, hotkeyEvent: HotkeysEvent): boolean | void;
     private item;
     private add;
@@ -4142,8 +4151,8 @@ declare class HotkeyTodo extends HotkeyBase<CubeTodo> {
 }
 
 /** 表格的结构编辑命令：同一份定义同时用于快捷键和右键菜单。 */
-declare class HotkeyTable extends HotkeyBase<CubeTable> {
-    protected get items(): ICubesHotkeys.Item[];
+declare class InteractionTable extends InteractionBase<CubeTable> {
+    protected get items(): ICubesInteraction.Item[];
     protected execution(id: string, event: KeyboardEvent, hotkeyEvent: HotkeysEvent): boolean | void;
     private item;
     private run;
@@ -4163,27 +4172,27 @@ declare class HotkeyTable extends HotkeyBase<CubeTable> {
     private active_cell;
 }
 
-declare class HotkeysCubeRegistry {
-    protected readonly hotkeys: Map<INote.Cubes, ICubesHotkeys.Constructor>;
+declare class InteractionsCubeRegistry {
+    protected readonly interactions: Map<INote.Cubes, ICubesInteraction.Constructor>;
     constructor();
-    create(cube: CubeBase): HotkeyBase;
-    register(type: INote.Cubes, hotkey: ICubesHotkeys.Constructor): ICubesHotkeys.Constructor;
+    create(cube: CubeBase): InteractionBase;
+    register(type: INote.Cubes, interaction: ICubesInteraction.Constructor): ICubesInteraction.Constructor;
 }
-declare const HotkeysCube: HotkeysCubeRegistry;
+declare const InteractionsCube: InteractionsCubeRegistry;
 
 type BoxRef = (view: ComponentPublicInstance | null) => void;
 /**
- * 将一个清单元素的快捷键绑定到其动态创建的 CubeBox 视图。
+ * 将一个清单元素的交互绑定到其动态创建的 CubeBox 视图。
  *
  * Vue 在函数 ref 卸载时只传入 null，因此需要保留 box id 到旧 DOM 的映射以完成解绑。
  */
-declare function use_box_hotkeys(hotkey: HotkeyBase): {
+declare function use_box_interaction(interaction: InteractionBase): {
     box_ref: (box: CubeBox) => BoxRef;
 };
 
 declare abstract class CubeBase<T extends ICubeBase.Data = any> {
     protected _receiver: ReceiverBase;
-    protected _hotkey: HotkeyBase | undefined;
+    protected _operator: InteractionBase | undefined;
     protected _note: Note;
     abstract data: T;
     abstract get id(): string;
@@ -4194,7 +4203,7 @@ declare abstract class CubeBase<T extends ICubeBase.Data = any> {
     abstract get status(): CubeStatusBase<T>;
     abstract get adapter(): CubeAdapterBase;
     get receiver(): ReceiverBase;
-    get hotkey(): HotkeyBase;
+    get operator(): InteractionBase;
     protected create_receiver(): ReceiverBase;
     protected abstract build_child(data: T): any;
     constructor(note: Note);
@@ -6011,14 +6020,14 @@ declare namespace IMenuNode {
     }
 }
 
-declare namespace ICubesHotkeys {
+declare namespace ICubesInteraction {
     interface Item extends ICubesMenu.MenuItem {
         id: string;
         show?: boolean;
     }
     interface Controller {
         readonly menus: ICubesMenu.MenuItem[];
-        readonly hotkeys: readonly Item[];
+        readonly interactions: readonly Item[];
         execute(id: string, event: KeyboardEvent, hotkeyEvent: HotkeysEvent): boolean | void;
     }
     type Constructor = new (cube: any) => Controller;
@@ -6118,7 +6127,7 @@ declare namespace IUiConfig {
         dict_tip_keywords: boolean;
         dict_tip_association: boolean;
         sidebar_panel_width: number;
-        sidebar_min_width: 300;
+        sidebar_min_width: number;
         sidebar_max_width: 1200;
         toolbar_whitelist: IUiToolbar.Name[];
     }
@@ -6638,4 +6647,34 @@ declare class NoteTools {
     static check_mouse_key(e: MouseEvent, key: _PointKey): boolean;
 }
 
-export { AdapterApi, AdapterBaseUi, AdapterBox, AdapterBoxColumns, AdapterBoxFolder, AdapterBoxRoot, AdapterCode, AdapterCubes, AdapterDetailList, AdapterDoc, AdapterFormula, AdapterImg, AdapterLine, AdapterLinker, AdapterList, AdapterListOrdered, AdapterLost, AdapterMap, AdapterNode, AdapterPostil, AdapterRt, AdapterSubmap, AdapterTable, AdapterText, AdapterTextLink, AdapterTip, AdapterTodo, AdapterUi, AdapterUiAi, AdapterUiCatalogue, AdapterUiConfig, AdapterUiDialog, AdapterUiDialogCubeList, AdapterUiDict, AdapterUiFloat, AdapterUiMenubar, AdapterUiPreset, AdapterUiSearch, AdapterUiSidebar, AdapterUiStatusbar, AdapterUiTheme, AdapterUiTips, AdapterUiToolbar, ApiStatus, BoxFolderStatus, BoxRootStatus, BoxStatus, CodeStatus, CommandApi, CommandBoxFolder, CommandBoxRoot, CommandCode, CommandCube, CommandCursor, CommandDetailList, CommandFormula, CommandLinker, CommandList, CommandListOrdered, CommandMap, CommandNode, CommandRt, CommandTable, CommandText, CommandTextLink, CommandTodo, ConstColors, ConvertorMd, CubeAdapterBase, CubeApi, CubeBase, CubeBox, CubeBoxColumns, CubeBoxFolder, CubeBoxRoot, CubeChild, CubeCode, CubeDetailList, CubeDoc, CubeFormula, CubeImg, CubeLine, CubeLinker, CubeList, CubeListOrdered, CubeListenerBase, CubeLost, CubeMap, CubeNode, CubePostil, CubeRoot, CubeRt, CubeStatusBase, CubeStatusBaseRoot, CubeSubMap, CubeTable, CubeText, CubeTextLink, CubeTip, CubeTodo, DetailListStatus, DocStatus, EventBubble, FormulaStatus, HotkeyBase, HotkeyBinder, HotkeyDetailList, HotkeyList, HotkeyListOrdered, HotkeyTable, HotkeyTodo, HotkeysCube, HotkeysCubeRegistry, IApi, IBox, ICode, ICommandApi, ICommandCode, ICommandCube, ICommandCursor, ICommandDetailList, ICommandDoc, ICommandFormula, ICommandLinker, ICommandList, ICommandListOrdered, ICommandMap, ICommandNode, ICommandRt, ICommandTable, ICommandText, ICommandTextLink, ICommandTodo, ICubeBase, ICubeBaseChild, ICubeBoxColumns, ICubeBoxFolder, ICubeBoxRoot, ICubeHandler, ICubeRootBase, ICubesHotkeys, ICubesMenu, IDetailList, IDoc, IFormula, IImg, ILine, ILinker, IList, IListOrdered, ILost, IMap, IMapBase, IMapInteraction, IMapTools, IMenuNode, IMiniMap, IMisc, INode, INodeBase, INodeBaseEnv, INodeDrag, INote, INoteApi, INoteClipboard, INoteConvertor, INoteCourier, INoteCursor, INoteEvent, INoteFlag, INoteFloat, INoteHistory, INoteInteraction, INoteMod, INoteScope, INoteTools, IPostil, IRt, ISubMap, ITable, IText, ITextLink, ITip, ITodo, IUi, IUiAi, IUiCatalogue, IUiConfig, IUiDialog, IUiDialogCubeList, IUiDict, IUiFloat, IUiMenubar, IUiPreset, IUiSidebar, IUiStatusbar, IUiTheme, IUiTips, IUiToolbar, ImgStatus, LayoutChecker, LineStatus, LinkerLine, LinkerPoint, ListOrderedStatus, ListStatus, LostStatus, Map2D, MapCanvas, MapChild, MapHotkeys, MapInteraction, MapNodeBase, MapNodeLayoutEnv, MapStatus, MapTools, Matrix2D, MenuApi, MenuBase, MenuBox, MenuBoxColumns, MenuBoxFolder, MenuBoxRoot, MenuCode, MenuDetailList, MenuImg, MenuList, MenuListOrdered, MenuNode, MenuSubmap, MenuTable, MenuTip, MenuTodo, MenusCube, MenusCubeRegistry, NodeBase2D, NodeLayout, NodeLayoutInvert, NodeLayoutMeter, NodeLineStatus, NodeObserver, NodeShape, NodeStatus, NodeStatusBase, Note, NoteAction, NoteApi, NoteBase, NoteClipBoard, NoteConvertor, NoteCourier, NoteCubes, NoteCursor, NoteEvent, NoteEventListenerBase, NoteEventListeners, NoteFlag, NoteHistory, NoteHotkeyBase, NoteInteraction, NoteListener, NoteMod, NotePainter, NoteScope, NoteScopes, NoteTools, PostilStatus, ReceiverApi, ReceiverBase, ReceiverBox, ReceiverBoxColumns, ReceiverBoxFolder, ReceiverBoxRoot, ReceiverChild, ReceiverCode, ReceiverCubes, ReceiverDetailList, ReceiverDoc, ReceiverFormula, ReceiverImg, ReceiverLine, ReceiverLinker, ReceiverList, ReceiverListOrdered, ReceiverLost, ReceiverMap, ReceiverMapChild, ReceiverNode, ReceiverPostil, ReceiverRegistry, ReceiverRoot, ReceiverRt, ReceiverSubMap, ReceiverTable, ReceiverText, ReceiverTextLink, ReceiverTip, ReceiverTodo, Recorder, RtStatus, SubmapStatus, TableStatus, TextLinkStatus, TextStatus, TipStatus, TodoStatus, ToolBase, UI, 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, cube, cut_event_listener, define_cmd, get_cmds, get_cube_menu, get_menu_base, get_menu_code, get_receiver_type, has_pcube_menu, hotkey, menu_status, move_rect, node_observer, paste_event_listener, receiver, show_code_file_dialog, show_menu, use_box_hotkeys, waiter_map_svg };
+interface IMobileReadonlyViewerInput {
+    /** Parsed content from the archive's data.json. Only doc data is supported. */
+    document: IDoc.Data;
+    /** Parsed content from uidata.json. */
+    uidata?: IUi.Data;
+    /** Host-controlled base URL for the current note's extracted image assets. */
+    asset_base_url?: string;
+    /** The host decides how a user-activated external link should be opened. */
+    on_link?: (url: string) => void;
+}
+/**
+ * Minimal, host-owned entry point for a mobile read-only document viewer.
+ *
+ * It deliberately mounts the document root rather than Note.render(), which
+ * includes the desktop toolbars, menus and editing interaction layer.
+ */
+declare class MobileReadonlyViewer {
+    protected _note?: Note;
+    protected _container?: HTMLElement;
+    protected _on_link?: (url: string) => void;
+    mount(container: HTMLElement, input: IMobileReadonlyViewerInput): void;
+    dispose(): void;
+    protected normalize_base_url(value: string): string;
+    /** Blocks editor-specific DOM events before they reach Cube components. */
+    protected on_guard_event: (event: Event) => void;
+    protected install_input_guard(container: HTMLElement): void;
+    protected remove_input_guard(container: HTMLElement): void;
+    protected get guard_events(): string[];
+}
+
+export { AdapterApi, AdapterBaseUi, AdapterBox, AdapterBoxColumns, AdapterBoxFolder, AdapterBoxRoot, AdapterCode, AdapterCubes, AdapterDetailList, AdapterDoc, AdapterFormula, AdapterImg, AdapterLine, AdapterLinker, AdapterList, AdapterListOrdered, AdapterLost, AdapterMap, AdapterNode, AdapterPostil, AdapterRt, AdapterSubmap, AdapterTable, AdapterText, AdapterTextLink, AdapterTip, AdapterTodo, AdapterUi, AdapterUiAi, AdapterUiCatalogue, AdapterUiConfig, AdapterUiDialog, AdapterUiDialogCubeList, AdapterUiDict, AdapterUiFloat, AdapterUiMenubar, AdapterUiPreset, AdapterUiSearch, AdapterUiSidebar, AdapterUiStatusbar, AdapterUiTheme, AdapterUiTips, AdapterUiToolbar, ApiStatus, BoxFolderStatus, BoxRootStatus, BoxStatus, CodeStatus, CommandApi, CommandBoxFolder, CommandBoxRoot, CommandCode, CommandCube, CommandCursor, CommandDetailList, CommandFormula, CommandLinker, CommandList, CommandListOrdered, CommandMap, CommandNode, CommandRt, CommandTable, CommandText, CommandTextLink, CommandTodo, ConstColors, ConvertorMd, CubeAdapterBase, CubeApi, CubeBase, CubeBox, CubeBoxColumns, CubeBoxFolder, CubeBoxRoot, CubeChild, CubeCode, CubeDetailList, CubeDoc, CubeFormula, CubeImg, CubeLine, CubeLinker, CubeList, CubeListOrdered, CubeListenerBase, CubeLost, CubeMap, CubeNode, CubePostil, CubeRoot, CubeRt, CubeStatusBase, CubeStatusBaseRoot, CubeSubMap, CubeTable, CubeText, CubeTextLink, CubeTip, CubeTodo, DetailListStatus, DocStatus, EventBubble, FormulaStatus, IApi, IBox, ICode, ICommandApi, ICommandCode, ICommandCube, ICommandCursor, ICommandDetailList, ICommandDoc, ICommandFormula, ICommandLinker, ICommandList, ICommandListOrdered, ICommandMap, ICommandNode, ICommandRt, ICommandTable, ICommandText, ICommandTextLink, ICommandTodo, ICubeBase, ICubeBaseChild, ICubeBoxColumns, ICubeBoxFolder, ICubeBoxRoot, ICubeHandler, ICubeRootBase, ICubesInteraction, ICubesMenu, IDetailList, IDoc, IFormula, IImg, ILine, ILinker, IList, IListOrdered, ILost, IMap, IMapBase, IMapInteraction, IMapTools, IMenuNode, IMiniMap, IMisc, type IMobileReadonlyViewerInput, INode, INodeBase, INodeBaseEnv, INodeDrag, INote, INoteApi, INoteClipboard, INoteConvertor, INoteCourier, INoteCursor, INoteEvent, INoteFlag, INoteFloat, INoteHistory, INoteInteraction, INoteMod, INoteScope, INoteTools, IPostil, IRt, ISubMap, ITable, IText, ITextLink, ITip, ITodo, IUi, IUiAi, IUiCatalogue, IUiConfig, IUiDialog, IUiDialogCubeList, IUiDict, IUiFloat, IUiMenubar, IUiPreset, IUiSidebar, IUiStatusbar, IUiTheme, IUiTips, IUiToolbar, ImgStatus, InteractionBase, InteractionBinder, InteractionDetailList, InteractionList, InteractionListOrdered, InteractionTable, InteractionTodo, InteractionsCube, InteractionsCubeRegistry, LayoutChecker, LineStatus, LinkerLine, LinkerPoint, ListOrderedStatus, ListStatus, LostStatus, Map2D, MapCanvas, MapChild, MapHotkeys, MapInteraction, MapNodeBase, MapNodeLayoutEnv, MapStatus, MapTools, Matrix2D, MenuApi, MenuBase, MenuBox, MenuBoxColumns, MenuBoxFolder, MenuBoxRoot, MenuCode, MenuDetailList, MenuImg, MenuList, MenuListOrdered, MenuNode, MenuSubmap, MenuTable, MenuTip, MenuTodo, MenusCube, MenusCubeRegistry, MobileReadonlyViewer, NodeBase2D, NodeLayout, NodeLayoutInvert, NodeLayoutMeter, NodeLineStatus, NodeObserver, NodeShape, NodeStatus, NodeStatusBase, Note, NoteAction, NoteApi, NoteBase, NoteClipBoard, NoteConvertor, NoteCourier, NoteCubes, NoteCursor, NoteEvent, NoteEventListenerBase, NoteEventListeners, NoteFlag, NoteHistory, NoteHotkeyBase, NoteInteraction, NoteListener, NoteMod, NotePainter, NoteScope, NoteScopes, NoteTools, PostilStatus, ReceiverApi, ReceiverBase, ReceiverBox, ReceiverBoxColumns, ReceiverBoxFolder, ReceiverBoxRoot, ReceiverChild, ReceiverCode, ReceiverCubes, ReceiverDetailList, ReceiverDoc, ReceiverFormula, ReceiverImg, ReceiverLine, ReceiverLinker, ReceiverList, ReceiverListOrdered, ReceiverLost, ReceiverMap, ReceiverMapChild, ReceiverNode, ReceiverPostil, ReceiverRegistry, ReceiverRoot, ReceiverRt, ReceiverSubMap, ReceiverTable, ReceiverText, ReceiverTextLink, ReceiverTip, ReceiverTodo, Recorder, RtStatus, SubmapStatus, TableStatus, TextLinkStatus, TextStatus, TipStatus, TodoStatus, ToolBase, UI, 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, cube, cut_event_listener, define_cmd, get_cmds, get_cube_menu, get_menu_base, get_menu_code, get_receiver_type, has_pcube_menu, hotkey, menu_status, move_rect, node_observer, paste_event_listener, receiver, show_code_file_dialog, show_menu, use_box_interaction, waiter_map_svg };