@inpageedit/core 0.13.1 → 0.14.1

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { Context, Events as Events$1, ForkScope, Inject, Inject as Inject$1, Service } from "@cordisjs/core";
+import { Context, CordisError, EffectScope, Events as Events$1, ForkScope, ForkScope as ForkScope$1, Inject, Inject as Inject$1, Lifecycle, MainScope, Plugin, Registry, ScopeStatus, Service, symbols as CordisSymbols } from "@cordisjs/core";
 import * as _inpageedit_logger0 from "@inpageedit/logger";
 import { Logger } from "@inpageedit/logger";
-import * as wiki_saikou1 from "wiki-saikou";
+import * as wiki_saikou0 from "wiki-saikou";
 import { FexiosConfigs, MwApiParams } from "wiki-saikou";
 import { FexiosFinalContext, MediaWikiApi, MwApi, MwApiParams as MwApiParams$1, MwApiResponse } from "wiki-saikou/browser";
 import { IPEModal, IPEModalEvent, IPEModalOptions } from "@inpageedit/modal";
@@ -9,7 +9,7 @@ import "@inpageedit/modal/style.css";
 import { IDBPlus } from "idb-plus";
 import "@/styles/index.scss";
 import Schema, { default as Schema$1 } from "schemastery";
-import * as jsx_dom1 from "jsx-dom";
+import * as jsx_dom0 from "jsx-dom";
 import { JSX, ReactElement, ReactNode } from "jsx-dom";
 import { JSX as JSX$1 } from "jsx-dom/jsx-runtime";
 import { JSX as JSX$2 } from "vue/jsx-runtime";
@@ -337,10 +337,10 @@ declare class LocalStorageManager<T = unknown> implements AbstractIPEStorageMana
   dbName?: string | undefined;
   readonly storeName?: string | undefined;
   ttl: number;
-  version?: number | undefined;
+  version?: number | string | undefined;
   engine: 'localStorage' | 'sessionStorage' | 'memory';
   private db;
-  constructor(dbName?: string | undefined, storeName?: string | undefined, ttl?: number, version?: number | undefined, engine?: 'localStorage' | 'sessionStorage' | 'memory');
+  constructor(dbName?: string | undefined, storeName?: string | undefined, ttl?: number, version?: number | string | undefined, engine?: 'localStorage' | 'sessionStorage' | 'memory');
   private makeKey;
   private load;
   private getRaw;
@@ -365,12 +365,12 @@ declare class IDBStorageManager<T = unknown> implements AbstractIPEStorageManage
   readonly dbName: string;
   readonly storeName: string;
   ttl: number;
-  version?: number | undefined;
+  version?: number | string | undefined;
   readonly db: IDBPlus<string, TypedStorageEntry<T>>;
   keys: () => AsyncIterable<string>;
   values: () => AsyncIterable<TypedStorageEntry<T>>;
   entries: () => AsyncIterable<[string, TypedStorageEntry<T>]>;
-  constructor(dbName: string, storeName: string, ttl?: number, version?: number | undefined);
+  constructor(dbName: string, storeName: string, ttl?: number, version?: number | string | undefined);
   private _clearExpiredEntries;
   get(key: string, ttl?: number, setter?: () => Promise<T> | T): Promise<T | null>;
   set(key: string, value: null | undefined): Promise<void>;
@@ -404,7 +404,7 @@ declare class StorageService extends Service<StorageServiceConfig> {
   readonly simpleKV: LocalStorageManager<any>;
   readonly memoryKV: LocalStorageManager<any>;
   constructor(ctx: InPageEdit, config: StorageServiceConfig);
-  createDatabase<T = any>(storeName: string, ttl?: number, version?: number, engine?: 'indexedDB' | 'localStorage' | 'sessionStorage' | 'memory'): AbstractIPEStorageManager<T>;
+  createDatabase<T = any>(storeName: string, ttl?: number, version?: number | string, engine?: 'indexedDB' | 'localStorage' | 'sessionStorage' | 'memory'): AbstractIPEStorageManager<T>;
 }
 interface TypedStorageEntry<T = any> {
   /** last update time */
@@ -412,7 +412,7 @@ interface TypedStorageEntry<T = any> {
   /** stored value */
   value: T;
   /** version */
-  version?: number;
+  version?: number | string;
 }
 interface AbstractIPEStorageManager<T = unknown> {
   get(key: string, ttl?: number, setter?: () => Promise<any> | any): Promise<T | null>;
@@ -437,6 +437,13 @@ declare module '.' {
     getSciprtUrl: WikiMetadataService['getSciprtUrl'];
     getMainpageUrl: WikiMetadataService['getMainpageUrl'];
   }
+  interface Events {
+    /**
+     * Application requires to clear caches and reload the page
+     * If returns true, the page will not be reloaded
+     */
+    'clear-cache'(): AwaitAble<boolean | void>;
+  }
 }
 interface WikiMetadataKindMap {
   siteinfo: WikiSiteInfo;
@@ -464,6 +471,7 @@ declare class WikiMetadataService extends Service {
   fetchFromCache<T extends keyof WikiMetadataKindMap>(kind: T): Promise<WikiMetadataKindMap[T] | null>;
   saveToCache<T extends keyof WikiMetadataKindMap>(kind: T, data: WikiMetadataKindMap[T]): Promise<TypedStorageEntry<WikiSiteInfo | WikiUserInfo>>;
   invalidateCache<T extends keyof WikiMetadataKindMap>(kind: T): Promise<void>;
+  private onClearCache;
   get _raw(): WikiMetadataKindMap;
   get siteInfo(): WikiSiteInfo;
   get general(): WikiSiteGeneralInfo;
@@ -789,6 +797,7 @@ declare class WikiTitleService extends Service {
 //#endregion
 //#region src/utils/computeable.d.ts
 type ComputeAble<T> = (() => T | Promise<T>) | T;
+type ComputeAbleSync<T> = (() => T) | T;
 //#endregion
 //#region src/services/PreferencesService.d.ts
 //              ↓ '@/InPageEdit'
@@ -881,6 +890,307 @@ declare class PreferencesService extends Service {
   private _migrageFromLegacyMasterDB;
 }
 //#endregion
+//#region src/services/i18n/interpolate.d.ts
+/**
+ * 创建带有“全局可用函数/变量”的插值函数。
+ * - 传入的 globals 会作为模板可用的全局，只在上下文未提供同名键时生效（上下文优先）。
+ * - 返回的函数与 interpolate 具有相同签名。
+ *
+ * 示例：
+ * ```ts
+ * const interpolate = createInterpolate({ getUrl })
+ * interpolate('url is: {{ getUrl(title) }}', { title: 'foo' })
+ * ```
+ */
+type Interpolator = {
+  (template: string): string;
+  (template: string, context: Record<string, unknown>): string;
+  (template: string, ...numricContext: string[]): string;
+  (template: string, numricContext: string[]): string;
+};
+//#endregion
+//#region src/services/i18n/I18nManager.d.ts
+declare class I18nManager {
+  private languages;
+  private currentLanguage;
+  private missingKeys;
+  private usedKeys;
+  interpolate: Interpolator;
+  constructor(init?: Record<string, any>, options?: {
+    language?: string;
+    globals?: Record<string, unknown>;
+  });
+  setGlobals(globals: Record<string, unknown>): this;
+  /**
+   * ```
+   * { foo: 'foo', bar: { baz: 'qux' } }
+   * ```
+   * will be merged into
+   * ```
+   * { foo: 'foo', 'bar.baz': 'qux' }
+   * ```
+   */
+  set(key: string, value: string): this;
+  set(data: Record<string, any>): this;
+  setLanguageData(language: string, data: Record<string, any>): this;
+  setLanguage(language: string): this;
+  getLanguage(): string;
+  hasLanguage(language: string): boolean | undefined;
+  private toStringRecord;
+  has(key: string): boolean;
+  get(key: string): string | undefined;
+  /**
+   * [payload as template] Interpolate a message with optional arguments
+   * @example
+   * ```
+   * i18n.msg('Hello, {{ name }}', 'dragon')
+   * // good:    "你好，dragon"
+   * // missing: "Hello, dragon"
+   * ```
+   */
+  translate(msg: string): string;
+  translate(msg: string, context: Record<string, unknown>): string;
+  translate(msg: string, ...numricContext: string[]): string;
+  translate(msg: string, numricContext: string[]): string;
+  /**
+   * $ => translate
+   * @example
+   * ```
+   * $`hello, world` // "你好，世界"
+   * $('dragon')`hello, {{ $1 }}` // "你好，dragon"
+   */
+  $(context: Record<string, unknown>): (strings: TemplateStringsArray, ...values: unknown[]) => string;
+  $(...numricContext: string[]): (strings: TemplateStringsArray, ...values: unknown[]) => string;
+  $(strings: TemplateStringsArray, ...values: unknown[]): string;
+  /**
+   * [payload as template] Return the raw message without interpolation
+   * @example
+   * ```
+   * i18n.rawMsg('Hello, {{ name }}')
+   * // good:    "你好，{{ name }}"
+   * // missing: "Hello, {{ name }}"
+   * ```
+   */
+  translateRaw(msg: string): string;
+  /**
+   * $raw => translateRaw
+   * @example
+   * ```
+   * $raw`hello, {{ $1 }}`
+   * // good:    "你好，{{ $1 }}"
+   * // missing: "hello, {{ $1 }}"
+   * ```
+   */
+  $raw(_context: Record<string, unknown>): (strings: TemplateStringsArray, ...values: unknown[]) => string;
+  $raw(..._numricContext: string[]): (strings: TemplateStringsArray, ...values: unknown[]) => string;
+  $raw(strings: TemplateStringsArray, ...values: unknown[]): string;
+  /**
+   * [payload as key] Interpolate a message by key with optional arguments
+   * @example
+   * ```
+   * i18n.strictMsg('greeting', 'dragon')
+   * // good:    "你好，dragon"
+   * // missing: "(greeting)"
+   * ```
+   */
+  message(key: string): string;
+  message(key: string, context: Record<string, unknown>): string;
+  message(key: string, ...numricContext: string[]): string;
+  message(key: string, numricContext: string[]): string;
+  /**
+   * $$ => message
+   * @example
+   * ```
+   * $$`hello`
+   * // good:    "你好"
+   * // missing: "(hello)"
+   * $$('dragon')`greeting`
+   * // good:    "你好，dragon"
+   * // missing: "(greeting)"
+   * ```
+   */
+  $$(context: Record<string, unknown>): (strings: TemplateStringsArray, ...values: unknown[]) => string;
+  $$(...numricContext: string[]): (strings: TemplateStringsArray, ...values: unknown[]) => string;
+  $$(strings: TemplateStringsArray, ...values: unknown[]): string;
+  /**
+   * [payload as key] Return the raw message without interpolation
+   * @example
+   * ```
+   * i18n.rawMsg('greeting')
+   * // good:    "你好，{{ name }}"
+   * // missing: "(greeting)"
+   * ```
+   */
+  messageRaw(key: string): string;
+  /**
+   * $$raw => messageRaw
+   * @example
+   * ```
+   * $$raw`greeting`
+   * // good:    "你好，{{ name }}"
+   * // missing: "(greeting)"
+   * ```
+   */
+  $$raw(_context: Record<string, unknown>): (strings: TemplateStringsArray, ...values: unknown[]) => string;
+  $$raw(..._numricContext: string[]): (strings: TemplateStringsArray, ...values: unknown[]) => string;
+  $$raw(strings: TemplateStringsArray, ...values: unknown[]): string;
+  getAvailableLanguages(): string[];
+  private ensureLanguageMap;
+  private resolveLanguageOrder;
+  /**
+   * 获取缺失键报告：
+   * { foo: ['zh', 'zh-hans', 'en'] }
+   */
+  getMissingReport(): {
+    [k: string]: string[];
+  };
+  /**
+   * 清空缺失键记录
+   */
+  clearMissingReport(): void;
+  private recordMissing;
+  private recordUsedKey;
+  private getUsedKeys;
+  private generateBlankKeyRecord;
+}
+//#endregion
+//#region src/services/i18n/index.d.ts
+interface I18nIndexV1 {
+  manifest_version: 1;
+  base_language: string;
+  last_modified: string;
+  languages: Record<string, I18nIndexLanguage>;
+}
+interface I18nIndexLanguage {
+  file: string;
+  iso_name?: string;
+  endonym?: string;
+  fallback?: string;
+  data?: I18nStringRecord;
+}
+interface I18nStringRecord {
+  [key: string]: string | I18nStringRecord;
+}
+//              ↓ '@/InPageEdit'
+declare module '.' {
+  interface InPageEdit {
+    i18n: I18nService;
+    /**
+     * $ => translate [payload as template]
+     * @example
+     * ```
+     * $`hello, world`
+     * // good:    "你好，世界"
+     * // missing: "hello, world"
+     * $('dragon')`hello, {{ $1 }}`
+     * // good:    "你好，dragon"
+     * // missing: "hello, dragon"
+     * ```
+     */
+    $: I18nManager['$'];
+    /**
+     * $raw => translateRaw [payload as template]
+     * @example
+     * ```
+     * $raw`hello, {{ $1 }}`
+     * // good:    "你好，{{ $1 }}"
+     * // missing: "hello, {{ $1 }}"
+     * ```
+     */
+    $raw: I18nManager['$raw'];
+    /**
+     * $$ => message [payload as key]
+     * @example
+     * ```
+     * $$`hello`
+     * // good:    "你好"
+     * // missing: "(hello)"
+     * $$('dragon')`greeting`
+     * // good:    "你好，dragon"
+     * // missing: "(greeting)"
+     * ```
+     */
+    $$: I18nManager['$$'];
+    /**
+     * $$raw => messageRaw [payload as key]
+     * @example
+     * ```
+     * $$raw`greeting`
+     * // good:    "你好，{{ name }}"
+     * // missing: "(greeting)"
+     * ```
+     */
+    $$raw: I18nManager['$$raw'];
+  }
+  interface PreferencesMap {
+    language: string;
+    'i18n.index_url': string;
+  }
+  interface Events {
+    'i18n/changed'(payload: {
+      ctx: InPageEdit;
+      language: string;
+    }): void;
+  }
+}
+declare class I18nService extends Service {
+  readonly ctx: InPageEdit;
+  private readonly logger;
+  private _indexUrl;
+  private _indexCache;
+  readonly manager: I18nManager;
+  private i18nIndexDB;
+  private i18nDataDB;
+  $: I18nManager['$'];
+  $raw: I18nManager['$raw'];
+  $$: I18nManager['$$'];
+  $$raw: I18nManager['$$raw'];
+  constructor(ctx: InPageEdit);
+  protected start(): Promise<void>;
+  private setupShortcuts;
+  private normalizeLanguageCode;
+  get language(): string;
+  /**
+   * 主动设置偏好值（会触发 preferences/changed，从而热切换）
+   */
+  setLanguagePreference(value: '@user' | '@site' | string): Promise<void>;
+  /**
+   * 直接切换到具体语言（不修改偏好值）
+   */
+  switchLanguage(language: string): Promise<void>;
+  /**
+   * 为指定语言注册（或合并）消息。
+   * - 推荐加命名空间避免冲突：{ myPlugin: { key: 'value' } }
+   * - 若 language 为当前语言，将立即可用；必要时你可以手动触发 UI 刷新或监听 i18n/changed。
+   */
+  registerMessages(language: string, data: Record<string, any>, options?: {
+    namespace?: string;
+  }): Promise<void>;
+  /**
+   * 列出可用语言与文件（来源于 index.json）
+   */
+  getAvailableLanguageCodes(): (I18nIndexLanguage & {
+    code: string;
+  })[];
+  private findLanguageMeta;
+  getI18nIndex(url: string, noCache?: boolean): Promise<I18nIndexV1>;
+  private fetchI18nIndex;
+  private ensureLanguageLoaded;
+  getLanguageData(language: string, noCache?: boolean): Promise<Record<string, string>>;
+  /**
+   * 获取缺失键报告，形如：
+   * { foo: ['zh', 'zh-hans', 'en'] }
+   */
+  getMissingReport(): {
+    [k: string]: string[];
+  };
+  /**
+   * 清空缺失键记录
+   */
+  clearMissingReport(): void;
+  private onClearCache;
+}
+//#endregion
 //#region src/InPageEdit.d.ts
 interface InPageEditCoreConfig {
   apiConfigs: Partial<FexiosConfigs>;
@@ -913,6 +1223,8 @@ declare class InPageEdit extends Context {
 }
 interface PreferencesMap {}
 interface Events<C extends InPageEdit = InPageEdit> extends Events$1<C> {}
+type IPEPlugin<C = any> = Plugin<InPageEdit, C>;
+type IPERegistry = Registry<InPageEdit>;
 interface InPageEdit {
   [InPageEdit.events]: Events<this>;
 }
@@ -922,9 +1234,13 @@ declare enum Endpoints {
   ANALYTICS_API_BASE = "https://analytics.ipe.wiki/api/v6",
   ANALYTICS_DASH_URL = "https://analytics.ipe.wiki",
   GITHUB_URL = "https://github.com/inpageedit/inpageedit-next",
+  GITHUB_OWNER = "inpageedit",
+  GITHUB_REPO = "inpageedit-next",
   HOME_URL = "https://www.ipe.wiki/",
   UPDATE_LOGS_URL = "https://www.ipe.wiki/changelogs/",
   PLUGIN_REGISTRY_URL = "https://registry.ipe.wiki/registry.v1.json",
+  I18N_INDEX_URL = "https://registry.ipe.wiki/i18n/index.json",
+  QQ_GROUP_ID = "1026023666",
 }
 //#endregion
 //#region src/plugins/BasePlugin.d.ts
@@ -964,10 +1280,7 @@ type PreferenceAugmented<D, C extends AnyConstructor> = C & {
  * @RegisterPreferences(
  *   Schema.object({
  *     foo: Schema.string().description('Foo description'),
- *   }),
- *   {
- *     foo: 'default foo value',
- *   }
+ *   })
  * )
  * class Foo {}
  * ```
@@ -979,9 +1292,6 @@ type PreferenceAugmented<D, C extends AnyConstructor> = C & {
  *    static ConfigSchema = Schema.object({
  *      foo: Schema.string().description('Foo description')
  *    })
- *    static ConfigDefaults = {
- *      foo: 'default foo value'
- *    }
  * }
  * ```
  */
@@ -1022,21 +1332,21 @@ declare function TabView({
     content: ReactNode;
   })[];
   defaultActiveIndex?: number;
-}): jsx_dom1.ReactElement;
+}): jsx_dom0.ReactElement;
 declare function TabLabel({
   name,
   children
 }: {
   name: string;
   children: ReactNode;
-}): jsx_dom1.ReactElement;
+}): jsx_dom0.ReactElement;
 declare function TabContent({
   name,
   children
 }: {
   name: string;
   children: ReactNode;
-}): jsx_dom1.ReactElement;
+}): jsx_dom0.ReactElement;
 //#endregion
 //#region src/components/TwinSwapInput/index.d.ts
 type TwinSwapInputProps = {
@@ -1081,7 +1391,7 @@ type CheckBoxProps = {
   inputProps?: JSX.IntrinsicElements['input'];
   labelProps?: JSX.IntrinsicElements['span'];
 } & JSX.IntrinsicElements['label'];
-declare const CheckBox: (props: CheckBoxProps) => jsx_dom1.ReactElement;
+declare const CheckBox: (props: CheckBoxProps) => jsx_dom0.ReactElement;
 //#endregion
 //#region src/components/InputBox.d.ts
 type InputBoxProps = {
@@ -1093,7 +1403,7 @@ type InputBoxProps = {
   labelProps?: JSX.IntrinsicElements['label'];
   inputProps?: JSX.IntrinsicElements['input'];
 } & JSX.IntrinsicElements['div'];
-declare const InputBox: (props: InputBoxProps) => jsx_dom1.ReactElement;
+declare const InputBox: (props: InputBoxProps) => jsx_dom0.ReactElement;
 //#endregion
 //#region src/components/RadioBox.d.ts
 type RadioBoxProps = {
@@ -1104,7 +1414,7 @@ type RadioBoxProps = {
   inputProps?: JSX.IntrinsicElements['input'];
   labelProps?: JSX.IntrinsicElements['span'];
 } & JSX.IntrinsicElements['label'];
-declare const RadioBox: (props: RadioBoxProps) => jsx_dom1.ReactElement;
+declare const RadioBox: (props: RadioBoxProps) => jsx_dom0.ReactElement;
 //#endregion
 //#region src/models/MemoryStorage.d.ts
 declare class MemoryStorage implements Storage {
@@ -1278,11 +1588,11 @@ declare class PluginPluginStore extends BasePlugin {
   private _injectPreferenceUI;
   showModal(): Promise<CustomIPEModal>;
   private _installedPlugins;
-  install(registry: string, id: string, source?: PluginStoreRegistrySource): Promise<ForkScope<InPageEdit> | null>;
+  install(registry: string, id: string, source?: PluginStoreRegistrySource): Promise<ForkScope$1<InPageEdit> | null>;
   uninstall(registry: string, id: string): Promise<boolean>;
   addToPreferences(registry: string, id: string): Promise<boolean>;
   removeFromPreferences(registry: string, id: string): Promise<boolean>;
-  installAndSetPreference(registry: string, id: string): Promise<ForkScope<InPageEdit> | null>;
+  installAndSetPreference(registry: string, id: string): Promise<ForkScope$1<InPageEdit> | null>;
   uninstallAndRemovePreference(registry: string, id: string): Promise<boolean>;
   private _installOneByRegistryInfo;
   validateRegistry(data: any): PluginStoreRegistry;
@@ -1507,7 +1817,7 @@ declare class PluginQuickEdit extends BasePlugin {
   constructor(ctx: InPageEdit);
   protected start(): Promise<void> | void;
   showModal(payload?: string | Partial<QuickEditOptions>): Promise<void>;
-  handleSubmit(payload: QuickEditSubmitPayload): Promise<Required<wiki_saikou1.FexiosContext<wiki_saikou1.MwApiResponse<{
+  handleSubmit(payload: QuickEditSubmitPayload): Promise<Required<wiki_saikou0.FexiosContext<wiki_saikou0.MwApiResponse<{
     success: boolean;
   }>>>>;
   static readonly BUILT_IN_FONT_OPTIONS: string[];
@@ -1563,7 +1873,7 @@ declare class PluginQuickMove extends BasePlugin {
   protected start(): Promise<void> | void;
   private injectToolbox;
   showModal(options?: Partial<QuickMoveOptions>): Promise<CustomIPEModal>;
-  movePage(options: MovePageOptions): Promise<Required<wiki_saikou1.FexiosContext<wiki_saikou1.MwApiResponse<{
+  movePage(options: MovePageOptions): Promise<Required<wiki_saikou0.FexiosContext<wiki_saikou0.MwApiResponse<{
     success: boolean;
   }>>>>;
 }
@@ -1644,7 +1954,7 @@ declare class PluginQuickRedirect extends BasePlugin {
   protected start(): Promise<void> | void;
   protected stop(): Promise<void> | void;
   showModal(options?: Partial<QuickRedirectOptions>): Promise<CustomIPEModal>;
-  redirectPage(options: RedirectPageOptions): Promise<Required<wiki_saikou1.FexiosContext<wiki_saikou1.MwApiResponse<{
+  redirectPage(options: RedirectPageOptions): Promise<Required<wiki_saikou0.FexiosContext<wiki_saikou0.MwApiResponse<{
     success: boolean;
   }>>>>;
 }
@@ -1658,16 +1968,16 @@ declare module '.' {
   interface Events {
     'toolbox/button-added'(payload: {
       ctx: InPageEdit;
-      button: HTMLElement;
+      payload: ToolboxButton;
     }): void;
     'toolbox/button-removed'(payload: {
       ctx: InPageEdit;
-      id: string;
+      payload: ToolboxButton;
     }): void;
     'toolbox/button-clicked'(payload: {
       ctx: InPageEdit;
-      button: HTMLElement;
-      id: string;
+      event: MouseEvent;
+      payload: ToolboxButton;
     }): void;
     'toolbox/toggle'(payload: {
       ctx: InPageEdit;
@@ -1678,9 +1988,22 @@ declare module '.' {
     toolboxAlwaysShow: boolean;
   }
 }
+interface ToolboxButton {
+  id: string;
+  group?: 'auto' | 'group1' | 'group2';
+  icon: ComputeAbleSync<string | HTMLElement | SVGElement | ReactElement>;
+  tooltip?: ComputeAbleSync<string | HTMLElement>;
+  itemProps?: JSX.IntrinsicElements['li'];
+  buttonProps?: JSX.IntrinsicElements['button'];
+  onClick?: (event: MouseEvent) => void;
+  index?: number;
+}
 declare class PluginToolbox extends Service {
   ctx: InPageEdit;
   container: HTMLElement;
+  private buttons;
+  private seqCounter;
+  private seqMap;
   constructor(ctx: InPageEdit);
   protected start(): Promise<void>;
   protected stop(): void | Promise<void>;
@@ -1699,17 +2022,13 @@ declare class PluginToolbox extends Service {
   private updateButtonDelays;
   private createToolbox;
   private normalizeButtonId;
-  addButton(payload: {
-    id: string;
-    group?: 'auto' | 'group1' | 'group2';
-    icon: string | HTMLElement | SVGElement | ReactElement;
-    tooltip?: string | HTMLElement;
-    itemProps?: JSX.IntrinsicElements['li'];
-    buttonProps?: JSX.IntrinsicElements['button'];
-    onClick?: (event: MouseEvent) => void;
-    index?: number;
-  }): HTMLElement;
+  private chooseAutoGroup;
+  private orderKey;
+  private compareButtons;
+  addButton(payload: ToolboxButton): void;
   removeButton(id: string): void;
+  private renderButton;
+  private renderAll;
   getContainer(): HTMLElement;
   get isOpened(): boolean;
   toggle(force?: boolean): void;
@@ -1718,7 +2037,7 @@ declare namespace index_d_exports$1 {
   export { AbstractIPEStorageManager, ApiService, ApiServiceOptions, CurrentPageService, CustomIPEModal, InPageEditPreferenceUICategory, InPageEditPreferenceUIRegistryItem, ModalService, PreferencesService, ResourceLoaderService, StorageService, StorageServiceConfig, TypedStorageEntry, WikiLinkMetadata, WikiMetadataService, WikiPageService, WikiTitleService };
 }
 declare namespace index_d_exports {
-  export { AbstractIPEStorageManager, ActionButton, ActionButtonProps, ApiService, ApiServiceOptions, BasePlugin, CheckBox, CheckBoxProps, CompareApiRequestOptions, CompareApiResponse, ContentModelMap, CurrentPageService, CustomIPEModal, Endpoints, Events, IPEBeaconPayload, IPEBeaconUsage, IWikiPage, IWikiTitle, InArticleWikiAnchorMetadata, InPageEdit, InPageEditCoreConfig, InPageEditPreferenceUICategory, InPageEditPreferenceUIRegistryItem, Inject, InputBox, InputBoxProps, MBox, MBoxElement, MBoxProps, MemoryStorage, ModalService, MovePageOptions, PageInfo, PageParseData, PluginAnalytics, PluginInArticleLinks, PluginPluginStore, PluginPreferencesUI, PluginQuickDiff, PluginQuickEdit, PluginQuickMove, PluginQuickPreview, PluginQuickRedirect, PluginStoreRegistrySource, PluginToolbox, PreferencesMap, PreferencesService, ProgressBar, QuickEditEventPayload, QuickEditOptions, QuickEditSubmitPayload, QuickMoveOptions, QuickRedirectOptions, RadioBox, RadioBoxProps, RedirectPageOptions, RegisterPreferences, ResourceLoaderService, Schema, Service, StorageService, StorageServiceConfig, TabContent, TabLabel, TabView, TabViewLabelOptions, TwinSwapElement, TwinSwapInput, TwinSwapInputInput, TwinSwapInputProps, TypedStorageEntry, WatchlistAction, WikiLinkMetadata, WikiMagicWord, WikiMetadataService, WikiNameSpaceAlias, WikiNamespace, WikiPageConstructor, WikiPageEditPayload, WikiPageService, WikiSiteGeneralInfo, WikiSiteInfo, WikiSpecialPageAlias, WikiTitleConstructor, WikiTitleService, WikiUserBlockInfo, WikiUserInfo, WikiUserOptions, createWikiPageModel, createWikiTitleModel, useMemoryStorage };
+  export { AbstractIPEStorageManager, ActionButton, ActionButtonProps, ApiService, ApiServiceOptions, BasePlugin, CheckBox, CheckBoxProps, CompareApiRequestOptions, CompareApiResponse, ContentModelMap, CordisError, CordisSymbols, CurrentPageService, CustomIPEModal, EffectScope, Endpoints, Events, ForkScope, IPEBeaconPayload, IPEBeaconUsage, IPEPlugin, IPERegistry, IWikiPage, IWikiTitle, InArticleWikiAnchorMetadata, InPageEdit, InPageEditCoreConfig, InPageEditPreferenceUICategory, InPageEditPreferenceUIRegistryItem, Inject, InputBox, InputBoxProps, Lifecycle, MBox, MBoxElement, MBoxProps, MainScope, MemoryStorage, ModalService, MovePageOptions, PageInfo, PageParseData, PluginAnalytics, PluginInArticleLinks, PluginPluginStore, PluginPreferencesUI, PluginQuickDiff, PluginQuickEdit, PluginQuickMove, PluginQuickPreview, PluginQuickRedirect, PluginStoreRegistrySource, PluginToolbox, PreferencesMap, PreferencesService, ProgressBar, QuickEditEventPayload, QuickEditOptions, QuickEditSubmitPayload, QuickMoveOptions, QuickRedirectOptions, RadioBox, RadioBoxProps, RedirectPageOptions, RegisterPreferences, ResourceLoaderService, Schema, ScopeStatus, Service, StorageService, StorageServiceConfig, TabContent, TabLabel, TabView, TabViewLabelOptions, TwinSwapElement, TwinSwapInput, TwinSwapInputInput, TwinSwapInputProps, TypedStorageEntry, WatchlistAction, WikiLinkMetadata, WikiMagicWord, WikiMetadataService, WikiNameSpaceAlias, WikiNamespace, WikiPageConstructor, WikiPageEditPayload, WikiPageService, WikiSiteGeneralInfo, WikiSiteInfo, WikiSpecialPageAlias, WikiTitleConstructor, WikiTitleService, WikiUserBlockInfo, WikiUserInfo, WikiUserOptions, createWikiPageModel, createWikiTitleModel, useMemoryStorage };
 }
 declare global {
   const ipe: InPageEdit;
@@ -1754,4 +2073,4 @@ declare global {
   }
 }
 //#endregion
-export { AbstractIPEStorageManager, ActionButton, ActionButtonProps, ApiService, ApiServiceOptions, BasePlugin, CheckBox, CheckBoxProps, CompareApiRequestOptions, CompareApiResponse, ContentModelMap, CurrentPageService, CustomIPEModal, Endpoints, Events, IPEBeaconPayload, IPEBeaconUsage, IWikiPage, IWikiTitle, InArticleWikiAnchorMetadata, InPageEdit, InPageEditCoreConfig, InPageEditPreferenceUICategory, InPageEditPreferenceUIRegistryItem, Inject, InputBox, InputBoxProps, MBox, MBoxElement, MBoxProps, MemoryStorage, ModalService, MovePageOptions, PageInfo, PageParseData, PluginAnalytics, PluginInArticleLinks, PluginPluginStore, PluginPreferencesUI, PluginQuickDiff, PluginQuickEdit, PluginQuickMove, PluginQuickPreview, PluginQuickRedirect, PluginStoreRegistrySource, PluginToolbox, PreferencesMap, PreferencesService, ProgressBar, QuickEditEventPayload, QuickEditOptions, QuickEditSubmitPayload, QuickMoveOptions, QuickRedirectOptions, RadioBox, RadioBoxProps, RedirectPageOptions, RegisterPreferences, ResourceLoaderService, Schema, Service, StorageService, StorageServiceConfig, TabContent, TabLabel, TabView, TabViewLabelOptions, TwinSwapElement, TwinSwapInput, TwinSwapInputInput, TwinSwapInputProps, TypedStorageEntry, WatchlistAction, WikiLinkMetadata, WikiMagicWord, WikiMetadataService, WikiNameSpaceAlias, WikiNamespace, WikiPageConstructor, WikiPageEditPayload, WikiPageService, WikiSiteGeneralInfo, WikiSiteInfo, WikiSpecialPageAlias, WikiTitleConstructor, WikiTitleService, WikiUserBlockInfo, WikiUserInfo, WikiUserOptions, createWikiPageModel, createWikiTitleModel, useMemoryStorage };
+export { AbstractIPEStorageManager, ActionButton, ActionButtonProps, ApiService, ApiServiceOptions, BasePlugin, CheckBox, CheckBoxProps, CompareApiRequestOptions, CompareApiResponse, ContentModelMap, CordisError, CordisSymbols, CurrentPageService, CustomIPEModal, EffectScope, Endpoints, Events, ForkScope, IPEBeaconPayload, IPEBeaconUsage, IPEPlugin, IPERegistry, IWikiPage, IWikiTitle, InArticleWikiAnchorMetadata, InPageEdit, InPageEditCoreConfig, InPageEditPreferenceUICategory, InPageEditPreferenceUIRegistryItem, Inject, InputBox, InputBoxProps, Lifecycle, MBox, MBoxElement, MBoxProps, MainScope, MemoryStorage, ModalService, MovePageOptions, PageInfo, PageParseData, PluginAnalytics, PluginInArticleLinks, PluginPluginStore, PluginPreferencesUI, PluginQuickDiff, PluginQuickEdit, PluginQuickMove, PluginQuickPreview, PluginQuickRedirect, PluginStoreRegistrySource, PluginToolbox, PreferencesMap, PreferencesService, ProgressBar, QuickEditEventPayload, QuickEditOptions, QuickEditSubmitPayload, QuickMoveOptions, QuickRedirectOptions, RadioBox, RadioBoxProps, RedirectPageOptions, RegisterPreferences, ResourceLoaderService, Schema, ScopeStatus, Service, StorageService, StorageServiceConfig, TabContent, TabLabel, TabView, TabViewLabelOptions, TwinSwapElement, TwinSwapInput, TwinSwapInputInput, TwinSwapInputProps, TypedStorageEntry, WatchlistAction, WikiLinkMetadata, WikiMagicWord, WikiMetadataService, WikiNameSpaceAlias, WikiNamespace, WikiPageConstructor, WikiPageEditPayload, WikiPageService, WikiSiteGeneralInfo, WikiSiteInfo, WikiSpecialPageAlias, WikiTitleConstructor, WikiTitleService, WikiUserBlockInfo, WikiUserInfo, WikiUserOptions, createWikiPageModel, createWikiTitleModel, useMemoryStorage };