deepsky 2.56.23 → 2.56.28

package/dist/index.d.ts

@@ -256,6 +256,7 @@ declare abstract class NoteBase {
     get isdev(): boolean;
     get convertor(): typeof NoteConvertor;
     get note(): Note;
+    get clock(): INoteClock.Api;
     get api(): typeof NoteApi;
     get courier(): NoteCourier;
     get history(): NoteHistory;
@@ -2365,6 +2366,7 @@ declare class Note {
     get isdev(): boolean;
     get root(): CubeRoot<any>;
     get ui(): UI;
+    get clock(): INoteClock.Api;
     get convertor(): typeof NoteConvertor;
     get cubes(): NoteCubes;
     get api(): typeof NoteApi;
@@ -3012,8 +3014,9 @@ declare class DatetimeStatus extends CubeStatusBase<IDateTime.Data> {
     protected _text: vue.ComputedRef<string>;
     get cube(): CubeDatetime;
     get text(): string;
-    format_timestamp(timestamp: number, format: IDateTime.Format): string;
-    protected format_relative(timestamp: number): string;
+    format_timestamp(timestamp: number, format: IDateTime.Format, now?: number): string;
+    get_next_update_time(now: number): number | undefined;
+    protected format_relative(timestamp: number, now: number): string;
 }
 
 declare class ReceiverDatetime extends ReceiverChild<CubeDatetime> {
@@ -7179,6 +7182,19 @@ declare namespace INoteApi {
     type SaveNote = (data: INote.Data) => Promise<boolean>;
 }
 
+declare namespace INoteClock {
+    type NextUpdateTime = number | undefined;
+    interface Registration {
+        update(next_update_time: NextUpdateTime): void;
+        dispose(): void;
+    }
+    interface Api {
+        readonly now: number;
+        register(): Registration;
+        refresh(): void;
+    }
+}
+
 declare namespace ICubesMenu {
     interface MenuStatus {
         point: IMath.Point;
@@ -8030,6 +8046,15 @@ declare class MapTools {
     static get_rect_area(from: IMath.Point, to: IMath.Point, radius?: number): string;
 }
 
+/** Shared runtime clock for all Note instances in this browser context. */
+declare const NoteClock: INoteClock.Api;
+
+/**
+ * Registers a component's next required refresh with NoteClock for the
+ * lifetime of the current Vue effect scope.
+ */
+declare function use_clock_wakeup(get_next_update_time: (now: number) => INoteClock.NextUpdateTime): void;
+
 declare class NoteTools {
     /**
      * 将 WheelEvent 的不同单位统一为像素。
@@ -8089,4 +8114,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, 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, 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, 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, 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, IFormula, IGallery, IImg, IKey, ILine, ILink, 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, 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, MapHotkeys, MapInteraction, MapNodeBase, MapNodeLayoutEnv, MapStatus, MapTools, Matrix2D, MenuApi, MenuBadge, MenuBase, MenuBox, MenuBoxColumns, MenuBoxFolder, MenuBoxRoot, MenuCheckbox, MenuCode, MenuCounter, MenuDatetime, MenuDetailList, 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, NoteBase, NoteClipBoard, 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, 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_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_list_item_drag, waiter_map_svg };
+export { AccentEffect, AdapterApi, AdapterBadge, AdapterBaseUi, AdapterBox, AdapterBoxColumns, AdapterBoxFolder, AdapterBoxRoot, AdapterCheckbox, AdapterCode, AdapterCounter, AdapterCubes, AdapterDatetime, AdapterDetailList, AdapterDoc, 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, 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, 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, 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, IFormula, IGallery, IImg, IKey, ILine, ILink, ILinker, IList, IListOrdered, ILost, IMap, IMapBase, IMapInteraction, IMapTools, IMenuNode, IMiniMap, IMisc, type IMobileReadonlyViewerInput, INode, INodeBase, INodeBaseEnv, INodeDrag, INote, INoteApi, 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, MapHotkeys, MapInteraction, MapNodeBase, MapNodeLayoutEnv, MapStatus, MapTools, Matrix2D, MenuApi, MenuBadge, MenuBase, MenuBox, MenuBoxColumns, MenuBoxFolder, MenuBoxRoot, MenuCheckbox, MenuCode, MenuCounter, MenuDatetime, MenuDetailList, 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, 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, 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_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 };