deepsky 2.41.12 → 2.42.3

package/dist/index.d.ts

@@ -426,6 +426,8 @@ declare const AdapterUiConfig: {
     get data(): IUiConfig.Data;
     get v7(): IUiConfig.V7;
     get v8(): IUiConfig.V8;
+    get v9(): IUiConfig.V9;
+    get v10(): IUiConfig.V10;
     get meta(): IUi.Meta;
     get sidebar_max_width(): number;
     get sidebar_min_width(): number;
@@ -559,6 +561,8 @@ declare const AdapterUi: {
         get data(): IUiConfig.Data;
         get v7(): IUiConfig.V7;
         get v8(): IUiConfig.V8;
+        get v9(): IUiConfig.V9;
+        get v10(): IUiConfig.V10;
         get meta(): IUi.Meta;
         get sidebar_max_width(): number;
         get sidebar_min_width(): number;
@@ -744,6 +748,8 @@ declare class UiConfig extends UiBase {
         get data(): IUiConfig.Data;
         get v7(): IUiConfig.V7;
         get v8(): IUiConfig.V8;
+        get v9(): IUiConfig.V9;
+        get v10(): IUiConfig.V10;
         get meta(): IUi.Meta;
         get sidebar_max_width(): number;
         get sidebar_min_width(): number;
@@ -751,7 +757,7 @@ declare class UiConfig extends UiBase {
         get version(): number;
         get type(): IUi.Core;
     };
-    get data_raw(): IUiConfig.V8;
+    get data_raw(): IUiConfig.V10;
     get sidebar_max_width(): number;
     get sidebar_min_width(): number;
     get css_vars(): {
@@ -1113,7 +1119,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 +1564,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 +2083,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 +3594,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;
@@ -6088,7 +6103,7 @@ declare namespace IUiCatalogue {
 }
 
 declare namespace IUiConfig {
-    type Data = V8;
+    type Data = V10;
     interface V7 {
         text_transition: boolean;
         text_family: string;
@@ -6110,7 +6125,6 @@ declare namespace IUiConfig {
         map_linker_anchor_in: ILinker.Anchor;
         map_linker_anchor_out: ILinker.Anchor;
         line_indent: number;
-        scroll_distance: number;
         revert_scope: boolean;
         input_quick_prefix: string;
         dict_candidate_open: boolean;
@@ -6118,13 +6132,19 @@ 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[];
     }
     interface V8 extends V7 {
         map_node_show_boundary: boolean;
     }
+    interface V9 extends V8 {
+        scroll_sensitivity: number;
+    }
+    interface V10 extends V9 {
+        map_scale_sensitivity: number;
+    }
 }
 
 declare namespace IUiPreset {
@@ -6624,6 +6644,20 @@ declare class MapTools {
 }
 
 declare class NoteTools {
+    /**
+     * 将 WheelEvent 的不同单位统一为像素。
+     *
+     * wheel 不提供可靠的设备类型：鼠标滚轮和触控板都可能产生它。真正可用的
+     * 信息是连续的 deltaX / deltaY，以及 deltaMode 所声明的单位。保留 delta
+     * 的幅度即可同时兼容离散鼠标滚轮与触控板的连续位移和惯性，不能只取正负号。
+     *
+     * DOM_DELTA_LINE 没有固定像素定义；16px 是常用的行高近似值。页面单位则
+     * 由调用方提供当前可视高度，使一次“页滚动”与所在滚动容器的尺寸一致。
+     */
+    static get_wheel_delta(e: Pick<WheelEvent, "deltaMode" | "deltaX" | "deltaY">, page_height?: number): {
+        x: number;
+        y: number;
+    };
     static get_id(): string;
     static get_char_zws(): string;
     static sleep(time?: number): Promise<unknown>;
@@ -6638,4 +6672,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, 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, 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, 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 };
+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 };