deepsky 2.56.2 → 2.56.23

package/dist/index.d.ts

@@ -33,7 +33,7 @@ declare namespace IText {
 }
 
 declare namespace ICommandCube {
-    type Names = "cube:reset" | "cube:delete" | "cube:insert" | "cube:insert-child" | "cube:delete-child" | "cube:delete-adjacent" | "cube:delete-edge" | "cube:degradation" | "cube:set-selection-css" | "cube:partition" | "cube:reorder" | "cube:set-css" | "cube:set-attr" | "cube:move" | "cube:merge" | "cube:postil-add" | "cube:postil-remove" | "code:change-lang" | "code:change-active" | "code:change-theme" | "code:update" | "code:add" | "code:remove" | "code:rename" | "detail-list:insert-row" | "detail-list:remove-row" | "detail-list:change-width-col1" | "formula:update" | "datetime:update" | "datetime:set-format" | "badge:select" | "rating:select" | "rating:update" | "checkbox:set" | "checkbox:set-appearance" | "counter:set" | "counter:update" | "timeline:insert" | "timeline:remove" | "timeline:move" | "timeline:update-item" | "timeline:update" | "timeline:reorder" | "key:update" | "linker:update" | "list:add" | "list:remove" | "list:move" | "list:indent" | "list:reset" | "list:transform" | "list-ordered:add" | "list-ordered:remove" | "list-ordered:move" | "list-ordered:indent" | "list-ordered:reset" | "rt:reset" | "table:add-title" | "table:remove-title" | "table:add-cell" | "table:remove-cell" | "table:add-row" | "table:remove-row" | "table:add-col" | "table:remove-col" | "table:add-grid-col" | "table:remove-grid-col" | "table:add-grid-row" | "table:remove-grid-row" | "table:merge" | "table:moveto" | "table:update-area" | "table:reorder" | "table:col-resize" | "text:reset" | "text:break" | "link:update" | "text-link:update" | "todo:add" | "todo:remove" | "todo:move" | "todo:indent" | "todo:status" | "todo:reset" | "node:layout-update" | "node:append-child" | "map:node-add" | "map:node-remove" | "map:node-remove-only" | "map:node-wrap-siblings" | "map:linker-add" | "map:linker-remove" | "map:update-attrs" | "map:node-drag" | "map:sibling-reorder" | "cursor:in-head" | "cursor:in-tail" | "cursor:loc" | (string & {});
+    type Names = "cube:reset" | "cube:delete" | "cube:insert" | "cube:insert-child" | "cube:delete-child" | "cube:delete-adjacent" | "cube:delete-edge" | "cube:degradation" | "cube:set-selection-css" | "cube:partition" | "cube:reorder" | "cube:set-css" | "cube:set-attr" | "cube:move" | "cube:merge" | "cube:postil-add" | "cube:postil-remove" | "code:change-lang" | "code:change-active" | "code:change-theme" | "code:update" | "code:add" | "code:remove" | "code:rename" | "detail-list:insert-row" | "detail-list:remove-row" | "detail-list:change-width-col1" | "formula:update" | "datetime:update" | "datetime:set-format" | "badge:select" | "rating:select" | "rating:update" | "checkbox:set" | "checkbox:set-appearance" | "counter:set" | "counter:update" | "timeline:insert" | "timeline:remove" | "timeline:move" | "timeline:update-item" | "timeline:update" | "timeline:reorder" | "gallery:reset" | "gallery:insert" | "gallery:remove" | "gallery:move" | "gallery:reorder" | "gallery:update" | "gallery:update-item" | "key:update" | "linker:update" | "list:add" | "list:remove" | "list:move" | "list:indent" | "list:reset" | "list:transform" | "list-ordered:add" | "list-ordered:remove" | "list-ordered:move" | "list-ordered:indent" | "list-ordered:reset" | "rt:reset" | "table:add-title" | "table:remove-title" | "table:add-cell" | "table:remove-cell" | "table:add-row" | "table:remove-row" | "table:add-col" | "table:remove-col" | "table:add-grid-col" | "table:remove-grid-col" | "table:add-grid-row" | "table:remove-grid-row" | "table:merge" | "table:moveto" | "table:update-area" | "table:reorder" | "table:col-resize" | "text:reset" | "text:break" | "link:update" | "text-link:update" | "todo:add" | "todo:remove" | "todo:move" | "todo:indent" | "todo:status" | "todo:reset" | "node:layout-update" | "node:append-child" | "map:node-add" | "map:node-remove" | "map:node-remove-only" | "map:node-wrap-siblings" | "map:linker-add" | "map:linker-remove" | "map:update-attrs" | "map:node-drag" | "map:sibling-reorder" | "cursor:in-head" | "cursor:in-tail" | "cursor:loc" | (string & {});
     type DeleteDir = "forward" | "backward";
     type CursorFrom = "left" | "right" | "none";
     interface BaseCommand {
@@ -242,8 +242,9 @@ declare abstract class CubeAdapterBase {
 declare class AdapterCubeImg extends CubeAdapterBase {
     get meta(): INote.CubeMeta;
     replace_id(versions: INote.CubesVersion, data: IImg.Data, map?: Record<string, string>): ICubeBase.ReplaceIdResult<IImg.Data>;
-    get_data(src?: string, css?: Record<string, any>, attrs?: Record<string, any>): IImg.Data;
+    get_data(src?: string, css?: Record<string, any>, attrs?: Partial<IImg.Attrs>): IImg.Data;
     update_data(versions: INote.CubesVersion, data: IImg.Data): ICubeBase.CubeUpdateResult;
+    protected normalize_attrs(attrs?: Partial<IImg.Attrs>): IImg.Attrs;
 }
 
 declare abstract class NoteBase {
@@ -334,7 +335,10 @@ declare class DialogBadge extends DialogBase {
     /** Opens the picker before a badge exists; selection creates the badge at the saved cursor. */
     open_insert(cursor_info: INoteCursor.CursorInfo, on_insert: (value: IBadge.Value) => void): void;
     select(value?: IBadge.Value | IBadge.PresetItem): void;
-    create_custom(label: string, color: string): Function | undefined;
+    /** Creates a self-contained custom value and optionally adds it to the saved candidates. */
+    create_custom(label: string, color: string, save?: boolean): Function | 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. */
     update_layout(layout: BadgeLayoutItem[]): void;
     move_active(direction: "left" | "right" | "up" | "down"): void;
@@ -565,6 +569,18 @@ declare class DialogConfirm extends DialogBase {
     protected settle(confirmed: boolean, return_cursor: boolean): void;
 }
 
+declare class DialogImgComment extends DialogBase {
+    protected _cube: Ref<CubeImg | null>;
+    protected _comment: Ref<string, string>;
+    constructor(note: Note);
+    get cube(): CubeImg | null;
+    get comment(): string;
+    set comment(comment: string);
+    edit(cube: CubeImg): void;
+    save(): void;
+    close(return_cursor?: boolean): void;
+}
+
 declare class UIDialog extends UiBase {
     protected _dialog_catalogue: DialogCatalogue;
     protected _badge: DialogBadge;
@@ -580,6 +596,7 @@ declare class UIDialog extends UiBase {
     protected _timeline: DialogTimeline;
     protected _datetime: DialogDatetime;
     protected _confirm: DialogConfirm;
+    protected _img_comment: DialogImgComment;
     constructor(note: Note);
     get adapter(): {
         get data(): {
@@ -607,6 +624,7 @@ declare class UIDialog extends UiBase {
     get timeline(): DialogTimeline;
     get datetime(): DialogDatetime;
     get confirm(): DialogConfirm;
+    get img_comment(): DialogImgComment;
     export(): IUiDialog.Data;
 }
 
@@ -686,6 +704,15 @@ declare const AdapterUiTheme: {
     get type(): IUi.Core;
 };
 
+declare const AdapterUiAccent: {
+    get data(): IUiAccent.Data;
+    get v1(): IUiAccent.Data;
+    get meta(): IUi.Meta;
+    update_data(_versions: IUi.Versions, data?: Partial<IUiAccent.Data>): IUiAccent.Data;
+    get version(): number;
+    get type(): IUi.Core;
+};
+
 declare const AdapterUiSearch: {
     get data(): {};
     get meta(): IUi.Meta;
@@ -819,6 +846,14 @@ declare const AdapterUi: {
         get version(): number;
         get type(): IUi.Core;
     };
+    get accent(): {
+        get data(): IUiAccent.Data;
+        get v1(): IUiAccent.Data;
+        get meta(): IUi.Meta;
+        update_data(_versions: IUi.Versions, data?: Partial<IUiAccent.Data>): IUiAccent.Data;
+        get version(): number;
+        get type(): IUi.Core;
+    };
     get catalogue(): {
         get data(): IUiCatalogue.Data;
         get v1(): IUiCatalogue.V1;
@@ -898,6 +933,7 @@ declare abstract class UiBase extends NoteBase {
     get tips(): UiTips;
     get catalogue(): UICatalogue;
     get theme(): UITheme;
+    get accent(): UIAccent;
     get config(): UiConfig;
     get dict(): UIDict;
     get dialog(): UIDialog;
@@ -1452,6 +1488,58 @@ declare class UITheme extends UiBase {
     clear(type: "all" | "link" | "style" | "background"): void;
 }
 
+/**
+ * 可注册点缀效果的 SDK 基类。
+ *
+ * 效果实例只描述模块能力，不能保存某篇笔记的配置；配置由 UIAccent 按笔记维护，
+ * 并在保存时回调 export() 生成可持久化的纯数据。
+ */
+declare abstract class AccentEffect<TConfig extends Record<string, unknown>> {
+    abstract get id(): IUiAccent.Id;
+    abstract get name(): string;
+    abstract get description(): string;
+    abstract get component(): Component;
+    abstract get setting(): Component | undefined;
+    /** 用于场景推荐与筛选；未声明的第三方效果默认视为全场景环境效果。 */
+    get tags(): IUiAccent.Tags;
+    /** 仅需要感知编辑器事件的效果才接收 Note 运行时，避免污染普通视觉组件。 */
+    get needs_note(): boolean;
+    get item(): IUiAccent.Item;
+    /** 将外部持久化数据规范化为该效果的运行时配置。 */
+    abstract init(data: unknown): TConfig;
+    /** 将运行时配置转为可保存的 JSON 数据。 */
+    abstract export(config: TConfig): unknown;
+}
+
+/** 独立的点缀运行时：持有每篇笔记的数据，并接收内置或第三方效果注册。 */
+declare class UIAccent extends UiBase {
+    protected _data: IUiAccent.Data;
+    protected _effects: vue.Reactive<Map<string, AccentEffect<any>>>;
+    protected _configs: Record<string, Record<string, unknown>>;
+    constructor(note: Note);
+    get adapter(): {
+        get data(): IUiAccent.Data;
+        get v1(): IUiAccent.Data;
+        get meta(): IUi.Meta;
+        update_data(_versions: IUi.Versions, data?: Partial<IUiAccent.Data>): IUiAccent.Data;
+        get version(): number;
+        get type(): IUi.Core;
+    };
+    get active_id(): string;
+    get items(): IUiAccent.Item[];
+    get active_effect(): AccentEffect<any> | undefined;
+    get active_config(): Record<string, unknown> | undefined;
+    get_effect(id: IUiAccent.Id): AccentEffect<any> | undefined;
+    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;
+    export(): IUiAccent.Data;
+}
+
+/** 内置效果也通过与第三方一致的注册协议进入 UIAccent。 */
+declare function create_builtin_accents(): AccentEffect<any>[];
+
 declare class UiTips extends UiBase {
     protected _list: Set<IUiTips.TipItem>;
     constructor(note: Note);
@@ -1542,6 +1630,7 @@ declare class UI extends NoteBase {
     protected _ai: UiAi;
     protected _catalogue: UICatalogue;
     protected _theme: UITheme;
+    protected _accent: UIAccent;
     protected _search: UISearch;
     protected _preset: UiPreset;
     protected _dict: UIDict;
@@ -1561,6 +1650,7 @@ declare class UI extends NoteBase {
     get sidebar(): UiSidebar;
     get ai(): UiAi;
     get theme(): UITheme;
+    get accent(): UIAccent;
     get catalogue(): UICatalogue;
     get config(): UiConfig;
     get tips(): UiTips;
@@ -2389,6 +2479,7 @@ declare class CubeImg extends CubeChild<IImg.Data> {
     constructor(note: Note, data: IImg.Data, pcube: CubeChild);
     get adapter(): AdapterCubeImg;
     get status(): ImgStatus;
+    get attrs(): IImg.Attrs;
     get is_empty(): boolean;
     get meta(): INote.CubeMeta<INote.Cubes>;
     get component(): any;
@@ -2400,6 +2491,66 @@ declare class CubeImg extends CubeChild<IImg.Data> {
     export(): IImg.Data;
 }
 
+declare class AdapterCubeGallery extends CubeAdapterBase {
+    get meta(): INote.CubeMeta;
+    get_data(info?: IImg.Data[], css?: Record<string, string>, attrs?: Partial<IGallery.Attrs>): IGallery.Data;
+    normalize_attrs(attrs?: Partial<IGallery.Attrs>): IGallery.Attrs;
+    replace_id(versions: INote.CubesVersion, data: IGallery.Data, map?: Record<string, string>): ICubeBase.ReplaceIdResult<IGallery.Data>;
+    update_data(versions: INote.CubesVersion, data: IGallery.Data): ICubeBase.CubeUpdateResult<IGallery.Data>;
+}
+
+declare class GalleryStatus extends CubeStatusBase<IGallery.Data> {
+    protected _images: vue.ShallowReactive<CubeImg[]>;
+    protected _active_id: vue.Ref<string, string>;
+    get cube(): CubeGallery;
+    get attrs(): IGallery.Attrs;
+    get images(): CubeImg[];
+    get active_id(): string;
+    get active_image(): CubeImg | undefined;
+    init(): void;
+    update_images(images?: CubeImg[], preferred?: string): void;
+    set_active(id: string): void;
+}
+
+declare class ReceiverGallery extends ReceiverChild<CubeGallery> {
+    protected reset(command: ICommandGallery.Reset): Recorder;
+    protected insert_images(command: ICommandGallery.Insert): Recorder | undefined;
+    protected remove(command: ICommandGallery.Remove): Recorder | undefined;
+    protected move(command: ICommandGallery.Move): Recorder | undefined;
+    protected reorder(command: ICommandGallery.Reorder): Recorder | undefined;
+    protected update(command: ICommandGallery.Update): Recorder | undefined;
+    protected update_item(command: ICommandGallery.UpdateItem): Recorder | undefined;
+    protected delete_child(command: ICommandCube.DeleteChild): Recorder | undefined;
+}
+
+declare class CubeGallery extends CubeChild<IGallery.Data> {
+    protected _status: GalleryStatus;
+    protected _images: CubeImg[];
+    constructor(note: Note, data: IGallery.Data, pcube: CubeChild);
+    get adapter(): AdapterCubeGallery;
+    get status(): GalleryStatus;
+    get component(): any;
+    get attrs(): IGallery.Attrs;
+    get images(): CubeImg[];
+    get children(): CubeImg[];
+    get is_empty(): boolean;
+    get text(): string;
+    protected get atomic_child(): readonly string[];
+    protected build_child(data: IGallery.Data): void;
+    create(data: IImg.Data[]): CubeImg[];
+    find_image(id: string): CubeImg | undefined;
+    find_image_index(id: string): number;
+    get_valid_image_index(pos: number): number;
+    export_images(): IImg.Data[];
+    splice_images(index: number, delete_count: number, ...insert: CubeImg[]): ICubeBase.CubeSpliceResult<CubeImg, IImg.Data>;
+    reset_images(images: CubeImg[]): void;
+    remove_images(ids: Set<string>): IImg.Data[];
+    move_image(from: number, to: number): boolean;
+    set_image_order(order: string[]): boolean;
+    export(): IGallery.Data;
+    gc(): void;
+}
+
 declare class AdapterCubeBadge extends CubeAdapterBase {
     get supports_inline_scale(): boolean;
     get meta(): INote.CubeMeta;
@@ -3210,6 +3361,7 @@ declare class CubeMap extends CubeRoot<IMap.Data> implements IMapBase.Api {
     protected _line_delete_selected: Set<MapNodeBase | CubeLinker>;
     protected _nodes_dragging: Set<MapNodeBase>;
     protected _view_nodes: Set<MapNodeBase>;
+    protected _pending_view_nodes: Set<MapNodeBase>;
     protected _view_linkers: Set<CubeLinker>;
     protected _view_rect: IMath.Rect;
     constructor(note: Note, data: IMap.Data);
@@ -3241,6 +3393,7 @@ declare class CubeMap extends CubeRoot<IMap.Data> implements IMapBase.Api {
     get children(): INote.NoteChild[];
     get view_rect(): IMath.Rect;
     wait_nodes_render(nodes: MapNodeBase[]): Promise<any>;
+    index_pending_nodes(nodes: Iterable<MapNodeBase>): Promise<void>;
     find_cube(id: string): INote.NoteCube | undefined;
     filter(func: ICubeBase.CubeFilterFunc): INote.NoteChild[];
     each(func: ICubeBase.CubeEachFunc): void;
@@ -4251,6 +4404,7 @@ declare class CubeSubMap extends CubeChild<ISubMap.Data> implements IMapBase.Api
     protected _line_delete_selected: Set<MapNodeBase | CubeLinker>;
     protected _nodes_dragging: Set<MapNodeBase>;
     protected _view_nodes: Set<MapNodeBase>;
+    protected _pending_view_nodes: Set<MapNodeBase>;
     protected _view_linkers: Set<CubeLinker>;
     protected _view_rect: Reactive<IMath.Rect>;
     constructor(note: Note, data: ISubMap.Data, pcube: CubeChild);
@@ -4286,6 +4440,7 @@ declare class CubeSubMap extends CubeChild<ISubMap.Data> implements IMapBase.Api
     get component(): any;
     find_layout_root(nodes: Iterable<MapNodeBase>): Set<MapNodeBase>;
     wait_nodes_render(nodes: Iterable<MapNodeBase>): Promise<any>;
+    index_pending_nodes(nodes: Iterable<MapNodeBase>): Promise<void>;
     find_cube(id: string): INote.NoteChild | undefined;
     filter(func: ICubeBase.CubeFilterFunc): INote.NoteChild[];
     each(func: ICubeBase.CubeEachFunc): void;
@@ -4657,6 +4812,7 @@ declare const AdapterDatetime: AdapterCubeDatetime;
 declare const AdapterDoc: AdapterCubeDoc;
 declare const AdapterFormula: AdapterCubeFormula;
 declare const AdapterImg: AdapterCubeImg;
+declare const AdapterGallery: AdapterCubeGallery;
 declare const AdapterKey: AdapterCubeKey;
 declare const AdapterLine: AdapterCubeLine;
 declare const AdapterLinker: AdapterCubeLinker;
@@ -5409,6 +5565,7 @@ declare namespace IMapBase {
         get_upstream_sum_scale(): _FigScale;
         find_layout_root(nodes: MapNodeBase[]): Set<MapNodeBase>;
         wait_nodes_render(nodes: MapNodeBase[]): Promise<boolean>;
+        index_pending_nodes(nodes: Iterable<MapNodeBase>): Promise<void>;
         layout(): any;
         layout_throttle(): any;
         check_show(): any;
@@ -5683,9 +5840,74 @@ declare namespace ILine {
 }
 
 declare namespace IImg {
+    interface Attrs extends ICubeBase.Attrs {
+        /** 图片名称，可用于在图片左上角显示。 */
+        title?: string;
+        /** 图片的纯文本注释。 */
+        comment?: string;
+        /** 是否在图片底部显示注释。 */
+        show_comment?: boolean;
+    }
     interface Data extends ICubeBase.Data {
         type: 'img';
         info: string;
+        attrs: Attrs;
+    }
+}
+
+declare namespace IGallery {
+    type AspectRatio = "source" | "1:1" | "4:3" | "16:9";
+    interface Attrs extends ICubeBase.Attrs {
+        height: number;
+        aspect_ratio: AspectRatio;
+        radius: number;
+        visible_count: number;
+        overlap: number;
+        loop: boolean;
+    }
+    interface Data extends ICubeBase.Data {
+        type: "gallery";
+        info: IImg.Data[];
+        attrs: Attrs;
+    }
+    interface ItemPatch {
+        title?: string;
+        description?: string;
+        alt?: string;
+    }
+}
+
+declare namespace ICommandGallery {
+    interface Reset extends ICommandCube.BaseCommand {
+        name: "gallery:reset";
+        data: IImg.Data[];
+    }
+    interface Insert extends ICommandCube.BaseCommand {
+        name: "gallery:insert";
+        data: IImg.Data[];
+        pos: number;
+    }
+    interface Remove extends ICommandCube.BaseCommand {
+        name: "gallery:remove";
+        item_ids: string[];
+    }
+    interface Move extends ICommandCube.BaseCommand {
+        name: "gallery:move";
+        from: number;
+        to: number;
+    }
+    interface Reorder extends ICommandCube.BaseCommand {
+        name: "gallery:reorder";
+        order: string[];
+    }
+    interface Update extends ICommandCube.BaseCommand {
+        name: "gallery:update";
+        attrs: IGallery.Attrs;
+    }
+    interface UpdateItem extends ICommandCube.BaseCommand {
+        name: "gallery:update-item";
+        item_id: string;
+        patch: IGallery.ItemPatch;
     }
 }
 
@@ -6595,7 +6817,7 @@ declare namespace INoteInteraction {
         generic?: string;
     }
     type Shortcut = string | PlatformShortcut;
-    type Hotkeys = "应用格式刷" | "复制格式刷" | "撤销" | "重做" | "缩进" | "反向缩进" | "光标导航" | "光标复选" | "换行" | "清空块选区" | "添加块选区" | "删除块选区" | "向后添加根级块" | "向前添加根级块" | "分裂根级块" | "添加批注" | "斜体" | "加粗" | "下划线" | "左对齐" | "居中对齐" | "右对齐" | "分裂文本块" | "增加字号" | "减小字号" | "文本块换行" | "重置样式" | "折叠所在块" | "添加书签" | "搜索" | "公式面板" | "元素面板" | "粘贴markdown" | "编辑节点" | "节点选中导航" | "删除节点" | "新建子节点" | "新建同级节点" | "输入制表符";
+    type Hotkeys = "应用格式刷" | "复制格式刷" | "撤销" | "重做" | "缩进" | "反向缩进" | "光标导航" | "光标复选" | "换行" | "清空块选区" | "添加块选区" | "删除块选区" | "向后添加根级块" | "向前添加根级块" | "分裂根级块" | "添加批注" | "斜体" | "加粗" | "下划线" | "左对齐" | "居中对齐" | "右对齐" | "分裂文本块" | "增加字号" | "减小字号" | "文本块换行" | "重置样式" | "折叠所在块" | "添加书签" | "搜索" | "公式面板" | "元素面板" | '徽章面板' | "粘贴markdown" | "编辑节点" | "节点选中导航" | "删除节点" | "新建子节点" | "新建同级节点" | "输入制表符";
     type Group = "核心" | "通用" | "文本块" | "块" | "块选区" | "字典" | "书签" | "搜索" | "样式" | "面板" | "节点" | "其他";
     type Groups = Group;
     interface Data {
@@ -6657,7 +6879,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" | "formula" | "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" | "formula" | "gallery" | "img" | "key" | "lost" | "line" | "list" | "list-ordered" | "linker" | "link" | "map" | "submap" | "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>;
@@ -7075,6 +7297,29 @@ declare namespace INoteMod {
     }
 }
 
+declare namespace IUiAccent {
+    /** 注册表 ID。内置效果使用 deepsky.*，第三方应使用自身命名空间。 */
+    type Id = string;
+    interface Data {
+        active: Id | "";
+        configs: Record<Id, unknown>;
+    }
+    type ThemeSuitability = "light" | "dark" | "both";
+    type NoteSuitability = "doc" | "map" | "both";
+    type Behavior = "ambient" | "interactive";
+    interface Tags {
+        theme: ThemeSuitability;
+        note: NoteSuitability;
+        behavior: Behavior;
+    }
+    interface Item {
+        id: Id;
+        name: string;
+        description: string;
+        tags: Tags;
+    }
+}
+
 declare namespace IUiCatalogue {
     type Type = "group" | "bookmark";
     type Data = V1;
@@ -7231,7 +7476,7 @@ declare namespace IUiDialog {
 }
 
 declare namespace IUi {
-    type Core = "config" | "catalogue" | "tips" | "theme" | "ai" | "sidebar" | "search" | "preset" | "toolbar" | "dict" | "float" | "menubar" | "statusbar" | "dialog" | (string & {});
+    type Core = "config" | "catalogue" | "tips" | "theme" | "accent" | "ai" | "sidebar" | "search" | "preset" | "toolbar" | "dict" | "float" | "menubar" | "statusbar" | "dialog" | (string & {});
     interface Meta<T extends string = Core> {
         type: T;
         version: number;
@@ -7242,6 +7487,7 @@ declare namespace IUi {
         config: IUiConfig.Data;
         catalogue: IUiCatalogue.Data;
         theme: IUiTheme.Data;
+        accent?: IUiAccent.Data;
         dict: IUiDict.Data;
         preset: IUiPreset.Data;
         float: IUiFloat.Data;
@@ -7514,6 +7760,16 @@ declare class CommandTimeline {
     static reorder(id: ICubeBase.CubeId, order: string[]): ICommandTimeline.Reorder;
 }
 
+declare class CommandGallery {
+    static reset(id: string, data: IImg.Data[]): ICommandGallery.Reset;
+    static insert(id: string, data: IImg.Data[], pos: number): ICommandGallery.Insert;
+    static remove(id: string, item_ids: string[]): ICommandGallery.Remove;
+    static move(id: string, from: number, to: number): ICommandGallery.Move;
+    static reorder(id: string, order: string[]): ICommandGallery.Reorder;
+    static update(id: string, attrs: IGallery.Attrs): ICommandGallery.Update;
+    static update_item(id: string, item_id: string, patch: IGallery.ItemPatch): ICommandGallery.UpdateItem;
+}
+
 type ReceiverConstructor = new (cube: CubeBase) => ReceiverBase;
 declare class ReceiverRegistry {
     create(cube: CubeBase, fallback?: new (cube: any) => ReceiverBase): ReceiverBase;
@@ -7686,6 +7942,12 @@ declare class MenuTimeline extends MenuBase<CubeTimeline> {
 
 declare function get_menu_timeline(cube: CubeTimeline): ICubesMenu.NoteMenu;
 
+declare class MenuGallery extends MenuBase<CubeGallery> {
+    get_menus(cube: CubeGallery): ICubesMenu.NoteMenu;
+}
+
+declare function get_menu_gallery(cube: CubeGallery): ICubesMenu.NoteMenu;
+
 declare class LayoutChecker {
     static check_allow(upstream: MapNodeBase | undefined, downstream_layout_type: INodeBase.Layout, nullable?: boolean): boolean;
     static get left(): INodeBase.Layout[];
@@ -7827,4 +8089,4 @@ declare class MobileReadonlyViewer {
     protected get guard_events(): string[];
 }
 
-export { AdapterApi, AdapterBadge, AdapterBaseUi, AdapterBox, AdapterBoxColumns, AdapterBoxFolder, AdapterBoxRoot, AdapterCheckbox, AdapterCode, AdapterCounter, AdapterCubes, AdapterDatetime, AdapterDetailList, AdapterDoc, AdapterFormula, AdapterImg, AdapterKey, AdapterLine, AdapterLink, AdapterLinker, AdapterList, AdapterListOrdered, AdapterLost, AdapterMap, AdapterNode, AdapterPostil, AdapterRating, AdapterRt, AdapterSubmap, AdapterTable, AdapterText, AdapterTimeline, AdapterTip, AdapterTodo, AdapterUi, 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, 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, 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, type HotkeyPlatform, IApi, IBadge, IBox, ICheckbox, ICode, ICommandApi, ICommandBadge, ICommandCheckbox, ICommandCode, ICommandCounter, ICommandCube, ICommandCursor, ICommandDateTime, ICommandDetailList, ICommandDoc, ICommandFormula, 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, 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, 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, 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, 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, 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, detect_hotkey_platform, get_cmds, get_cube_menu, get_menu_base, get_menu_code, get_menu_counter, 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, 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 };