@appsoftwareltd/etherpk-extension-api 0.13.0 → 0.14.0

package/dist/context.d.ts

@@ -3,9 +3,10 @@
  *
  * Everything an extension adds through it sits under the extension's id and is removed when the
  * graph closes or the extension is switched off, so an extension never has to undo its own
- * registrations. It holds no document store, no keys and no sync: an extension reads documents
- * only through the index's answers and its own fences, and changes them only through its fences,
- * the blocks it puts at the caret and the Client's Commands.
+ * registrations. It holds no document store, no keys and no sync. An extension reads documents
+ * through the index's answers, `documents` (which leaves out every Protected Document) and its own
+ * fences, and changes them only through its fences, the blocks it puts at the caret, the images it
+ * keeps as assets and the Commands it may run.
  */
 import type { ExtensionAssets } from './assets';
 import type { ExtensionAuth } from './auth';
@@ -35,16 +36,12 @@ export interface ExtensionCommands {
     /** Add a Command, its id under the extension's id. Throws if the id is taken or outside it. */
     register(id: string, handler: CommandHandler): () => void;
     /**
-     * Run any Command, the Client's or an extension's. Rejects if no Command has the id.
-     *
-     * @beta
+     * Run a Command: the extension's own, another running extension's, or one of the Client's that
+     * {@link CLIENT_COMMANDS} names. Rejects if no Command has the id, or if it is one of the
+     * Client's that the list does not name. An extension that comes with EtherPK may run any.
      */
     execute(id: string, arg?: unknown): Promise<unknown>;
-    /**
-     * Whether any Command has the id.
-     *
-     * @beta
-     */
+    /** Whether a Command the extension may run has the id. */
     has(id: string): boolean;
 }
 /**
@@ -62,7 +59,7 @@ export interface ExtensionViews {
 /**
  * Adding Context Menu rows.
  *
- * @beta
+ * @public
  */
 export interface ExtensionContextMenu {
     /** Add a row, its id under the extension's id. */
@@ -81,7 +78,7 @@ export interface ExtensionCommandMenu {
  * Adding buttons to the Command Bar, the row of buttons across the bottom of a phone's screen:
  * after the editing buttons that scroll, or in the pinned group at its right end.
  *
- * @beta
+ * @public
  */
 export interface ExtensionCommandBar {
     /** Add a button, its id under the extension's id. */
@@ -99,7 +96,7 @@ export interface ExtensionGraphSidebar {
 /**
  * A key chord that runs a Command.
  *
- * @beta
+ * @public
  */
 export interface Keybinding {
     /** `Alt+M`, `Mod+Shift+K`: `Mod` is Cmd on Apple devices and Ctrl elsewhere. */
@@ -114,10 +111,15 @@ export interface Keybinding {
 /**
  * Adding key chords.
  *
- * @beta
+ * @public
  */
 export interface ExtensionKeybindings {
-    /** Add a chord. Throws if the Client or another extension already binds it. */
+    /**
+     * Add a chord for one of the extension's own Commands. Throws for another's Command. When the
+     * Client or another extension binds the chord already, the chord is left to them and this one
+     * does nothing: the call still succeeds, and the Client says so in the browser's console. So a
+     * shortcut the Client adds in a later release never stops an extension from starting.
+     */
     register(binding: Keybinding): () => void;
 }
 /**
@@ -136,9 +138,8 @@ export interface ExtensionLayout {
         beside?: string;
     }): void;
     /**
-     * Bring a Sidebar resident to the front of its expanded Sidebar.
-     *
-     * @beta
+     * Bring one of the extension's own Sidebar residents (a View kind its manifest declares with a
+     * `resident` side) to the front of its expanded Sidebar. Does nothing for any other kind.
      */
     reveal(kind: string): void;
     /**
@@ -153,9 +154,8 @@ export interface ExtensionLayout {
         beside?: string;
     }): void;
     /**
-     * The document the user is working in, or null.
-     *
-     * @beta
+     * The name of the document the person is working in, as its tab names it (a page's title, or a
+     * journal entry's day, `YYYY-MM-DD`), or null when no document's tab is in front.
      */
     activeDocument(): string | null;
     /** True while the desktop presenter is showing, 1024 pixels wide and more. */
@@ -164,8 +164,6 @@ export interface ExtensionLayout {
      * Draw something over the whole EtherPK window, with a heading and a close button the Client
      * draws, as a fence's widget opens over the window. One at a time: opening another closes the
      * one before. The close button, Escape and `close` all close it, and `onClose` is told once.
-     *
-     * @beta
      */
     openWindow(options: {
         /** The heading the Client draws beside the close button. */
@@ -184,10 +182,14 @@ export interface ExtensionLayout {
 /**
  * The rules for naming a concept, which every index answer follows.
  *
- * @beta
+ * @public
  */
 export interface ExtensionConcepts {
-    /** The case-insensitive key of a name. */
+    /**
+     * The key the Client tells two names apart by: two names with the same key are one concept.
+     * How it is made may change in a later release, so compare keys from this, and never make
+     * one another way.
+     */
     key(name: string): string;
     /** The name a concept resolves to: an alias's page, a page's own title, or the name itself. */
     canonicalName(name: string): string;
@@ -281,7 +283,7 @@ export interface ExtensionTheme {
  * it goes into the page as it is. A string built from it is a plain string again, which the
  * Client's default policy sanitizes.
  *
- * @beta
+ * @public
  */
 export interface IconMarkup {
     /** Never present at run time. It marks the type, so a plain string is not one. */
@@ -290,7 +292,7 @@ export interface IconMarkup {
 /**
  * Drawing the Client's icons and the extension's own.
  *
- * @beta
+ * @public
  */
 export interface ExtensionIcons {
     /**
@@ -333,26 +335,18 @@ export interface ExtensionContributions {
 export interface ExtensionContext {
     /**
      * The extension's id, from its manifest.
-     *
-     * @beta
      */
     readonly extensionId: string;
     /**
      * The open graph.
-     *
-     * @beta
      */
     readonly graphId: string;
     /**
      * The Client's version, `x.y.z`.
-     *
-     * @beta
      */
     readonly clientVersion: string;
     /**
      * True in a development build of the Client, where tests may reach in.
-     *
-     * @beta
      */
     readonly dev: boolean;
     /** Supplying the Views the manifest declares. */
@@ -361,8 +355,6 @@ export interface ExtensionContext {
     readonly commands: ExtensionCommands;
     /**
      * Adding Context Menu rows.
-     *
-     * @beta
      */
     readonly contextMenu: ExtensionContextMenu;
     /** Adding Command Menu rows. */
@@ -371,16 +363,12 @@ export interface ExtensionContext {
     readonly graphSidebar: ExtensionGraphSidebar;
     /**
      * Adding buttons to the phone's Command Bar.
-     *
-     * @beta
      */
     readonly commandBar: ExtensionCommandBar;
     /** Adding panels beneath each Journal Entry. */
     readonly journalPanels: ExtensionJournalPanels;
     /**
      * Adding key chords.
-     *
-     * @beta
      */
     readonly keybindings: ExtensionKeybindings;
     /**
@@ -393,34 +381,24 @@ export interface ExtensionContext {
     readonly events: ExtensionEvents;
     /**
      * Questions to the open graph's index.
-     *
-     * @beta
      */
     readonly index: ExtensionIndex;
     /**
      * Reading the open graph's documents, with every Protected Document left out, name and all.
-     *
-     * @beta
      */
     readonly documents: ExtensionDocuments;
     /**
      * The extension's records for the open graph, kept on this device only.
-     *
-     * @beta
      */
     readonly records: ExtensionGraphRecords;
     /**
      * Images kept as the open graph's assets.
-     *
-     * @beta
      */
     readonly assets: ExtensionAssets;
     /** Opening Views and documents. */
     readonly layout: ExtensionLayout;
     /**
      * The rules for naming a concept.
-     *
-     * @beta
      */
     readonly concepts: ExtensionConcepts;
     /** The extension's own storage on this device. */
@@ -435,8 +413,6 @@ export interface ExtensionContext {
     readonly theme: ExtensionTheme;
     /**
      * The Client's icons and the extension's own.
-     *
-     * @beta
      */
     readonly icons: ExtensionIcons;
     /** Widgets over the extension's own fences, and blocks put at the caret. */
@@ -461,10 +437,9 @@ export interface ExtensionModule {
      */
     activate(context: ExtensionContext): void | (() => void);
     /**
-     * Sections the extension adds to the Client's settings tabs, which the Client mounts while the
-     * extension is switched on, whether or not a graph is open.
-     *
-     * @beta
+     * Sections the extension adds to the Client's settings, which the Client mounts while the
+     * extension is switched on: in a graph's Settings and Extensions, and, for an extension that
+     * comes with EtherPK, on the Graphs page with no graph open (see {@link SettingsSection}).
      */
     settingsSections?: readonly SettingsSection[];
 }

package/dist/documents.d.ts

@@ -7,12 +7,15 @@
  * reads here may be sent to a model provider. A document whose text holds an encrypted fence
  * anywhere counts as protected here too.
  *
- * Every answer is bounded: a list is paged, and a document's text is cut at a cap and says so.
+ * Every answer is bounded: a list is paged, and a document's text is cut at a cap and says so. A
+ * page of a listing holds at most 200 documents or tasks, and a page of a search 50 results. A
+ * document's text is cut after 200,000 characters. The format guide's wording changes as the format
+ * does, so an extension passes it on and never reads meaning into its words.
  */
 /**
  * A document as a listing names it.
  *
- * @beta
+ * @public
  */
 export interface DocumentSummary {
     /** The document's name: a page's title, or a journal entry's day, `YYYY-MM-DD`. */
@@ -25,7 +28,7 @@ export interface DocumentSummary {
 /**
  * A document's text, as {@link ExtensionDocuments.read} answers.
  *
- * @beta
+ * @public
  */
 export interface DocumentText extends DocumentSummary {
     /** The body: the text after the frontmatter block, cut at the cap. */
@@ -36,7 +39,7 @@ export interface DocumentText extends DocumentSummary {
 /**
  * One document a search matched, with the lines that matched.
  *
- * @beta
+ * @public
  */
 export interface DocumentSearchResult extends Omit<DocumentSummary, 'aliases'> {
     /** How many lines matched. */
@@ -54,7 +57,7 @@ export interface DocumentSearchResult extends Omit<DocumentSummary, 'aliases'> {
 /**
  * One document whose text links to the concept asked about, with each place it does.
  *
- * @beta
+ * @public
  */
 export interface DocumentBacklink extends Omit<DocumentSummary, 'aliases'> {
     references: {
@@ -69,7 +72,7 @@ export interface DocumentBacklink extends Omit<DocumentSummary, 'aliases'> {
 /**
  * One task, as the Tasks View lists it.
  *
- * @beta
+ * @public
  */
 export interface DocumentTask extends Omit<DocumentSummary, 'aliases'> {
     /** The task's line in the document's text, from 0. */
@@ -89,7 +92,7 @@ export interface DocumentTask extends Omit<DocumentSummary, 'aliases'> {
 /**
  * Reading the open graph's documents.
  *
- * @beta
+ * @public
  */
 export interface ExtensionDocuments {
     /** Pages and journal entries, journals newest first and then pages by name, a page at a time. */

package/dist/documents.js

@@ -7,6 +7,9 @@
  * reads here may be sent to a model provider. A document whose text holds an encrypted fence
  * anywhere counts as protected here too.
  *
- * Every answer is bounded: a list is paged, and a document's text is cut at a cap and says so.
+ * Every answer is bounded: a list is paged, and a document's text is cut at a cap and says so. A
+ * page of a listing holds at most 200 documents or tasks, and a page of a search 50 results. A
+ * document's text is cut after 200,000 characters. The format guide's wording changes as the format
+ * does, so an extension passes it on and never reads meaning into its words.
  */
 export {};

package/dist/editor.d.ts

@@ -244,7 +244,7 @@ export interface FenceOptions {
  * the editor when the editor is rebuilt (a Draft becoming a document, say). It closes when the
  * person closes it, or when the document's editor closes for good: the panel lasts for the visit.
  *
- * @beta
+ * @public
  */
 export interface InlinePanel {
     /** The document the panel is in, by its concept. */
@@ -281,7 +281,7 @@ export interface InlinePanel {
 /**
  * What an inline panel is drawn with.
  *
- * @beta
+ * @public
  */
 export interface InlinePanelOptions {
     /**
@@ -337,8 +337,6 @@ export interface ExtensionEditor {
      * document (the editor has the keyboard, as a Command Bar button leaves it), else at the end: for
      * a button pressed from outside the text. Null where no panel can go: no editor, a Protected
      * Document, or a caret in the frontmatter, a fenced block or a table.
-     *
-     * @beta
      */
     openPanel(options: InlinePanelOptions & {
         at?: 'caret' | 'end' | 'caret-or-end';

package/dist/graph-index.d.ts

@@ -6,14 +6,14 @@
 /**
  * What kind of name a concept is.
  *
- * @beta
+ * @public
  */
 export type ConceptKind = 'page' | 'journal' | 'alias' | 'pageless';
 /**
  * One name the index knows: a page, a journal entry, an alias, or a Pageless Concept (a name
  * wikilinks use that has no page).
  *
- * @beta
+ * @public
  */
 export interface ConceptCandidate {
     /** The name as written. */
@@ -32,7 +32,7 @@ export interface ConceptCandidate {
 /**
  * One concept in the link graph.
  *
- * @beta
+ * @public
  */
 export interface LinkGraphConcept {
     /** The case-insensitive key every other answer uses. */
@@ -50,7 +50,7 @@ export interface LinkGraphConcept {
  * One line, from the document whose text holds the wikilinks to the concept they name. Both ends
  * are positions in {@link LinkGraph.concepts}.
  *
- * @beta
+ * @public
  */
 export interface LinkGraphLink {
     /** The document whose text holds the wikilinks, by its position in `concepts`. */
@@ -65,7 +65,7 @@ export interface LinkGraphLink {
 /**
  * Every concept and every line a wikilink draws between two of them.
  *
- * @beta
+ * @public
  */
 export interface LinkGraph {
     /** Sorted by key, so two answers over the same index are identical. */
@@ -76,7 +76,7 @@ export interface LinkGraph {
 /**
  * What changed in one update the index committed.
  *
- * @beta
+ * @public
  */
 export interface IndexUpdate {
     /** The whole index was read again, so anything may have changed. */
@@ -91,7 +91,7 @@ export interface IndexUpdate {
 /**
  * The questions an extension may ask the open graph's index.
  *
- * @beta
+ * @public
  */
 export interface ExtensionIndex {
     /** Every name the index knows, aliases and Pageless Concepts included. */

package/dist/index.d.ts

@@ -9,7 +9,8 @@
  *
  * A declaration, or a member of one, is Stable (`@public`) or Proposed (`@beta`). A Stable one never
  * breaks: it is deprecated and kept. A Proposed one may change in any release, and only the
- * extensions that come with EtherPK may use it. An extension from the Extension Directory uses the
+ * extensions that come with EtherPK may use it. Since 0.14.0 everything is Stable but
+ * `contributions`, the Client's own registries. An extension from the Extension Directory uses the
  * Stable part alone, which `etc/etherpk-extension-api.public.api.md` lists.
  *
  * @packageDocumentation
@@ -26,6 +27,7 @@ export type { ConceptCandidate, ConceptKind, ExtensionIndex, IndexUpdate, LinkGr
 export type { ExtensionJournalPanels, JournalPanel, JournalPanelProps, MountedJournalPanel } from './journal';
 export type { ExtensionIsolation, ExtensionManifest, ExtensionPackage, ReadExtensionPackageResult, SettingDeclaration, ViewDeclaration, ViewRegion, } from './manifest';
 export { readExtensionPackage } from './manifest';
+export { CLIENT_COMMANDS } from './client-commands';
 export type { CommandBarButton, CommandMenuContext, CommandMenuItem, ContextMenuItem, DocumentMenuTarget, ExtensionMenuTarget, GraphSidebarButton, MenuTarget, TabMenuTarget, WikilinkMenuTarget, } from './menus';
 export type { ExtensionGraphRecords } from './records';
 export type { MountedSettingsSection, SettingsSection, SettingsSectionContext, SettingsSectionTab } from './settings-sections';

package/dist/index.js

@@ -9,9 +9,11 @@
  *
  * A declaration, or a member of one, is Stable (`@public`) or Proposed (`@beta`). A Stable one never
  * breaks: it is deprecated and kept. A Proposed one may change in any release, and only the
- * extensions that come with EtherPK may use it. An extension from the Extension Directory uses the
+ * extensions that come with EtherPK may use it. Since 0.14.0 everything is Stable but
+ * `contributions`, the Client's own registries. An extension from the Extension Directory uses the
  * Stable part alone, which `etc/etherpk-extension-api.public.api.md` lists.
  *
  * @packageDocumentation
  */
 export { readExtensionPackage } from './manifest';
+export { CLIENT_COMMANDS } from './client-commands';

package/dist/manifest.d.ts

@@ -35,8 +35,6 @@ export interface ViewDeclaration {
     /**
      * The View lives in a Sidebar from the moment a graph opens, beside the Client's own residents,
      * and the Sidebar's toggle brings it back if it was closed. `desktopOnly` keeps it off a phone.
-     *
-     * @beta
      */
     resident?: {
         side: 'left' | 'right';
@@ -132,7 +130,7 @@ export interface ExtensionManifest {
  * An extension's package as the Client reads it: the standard package.json fields it uses and the
  * manifest.
  *
- * @beta
+ * @public
  */
 export interface ExtensionPackage {
     /** The npm package name. */
@@ -149,7 +147,7 @@ export interface ExtensionPackage {
 /**
  * The answer of {@link readExtensionPackage}: the package, or every way its manifest is wrong.
  *
- * @beta
+ * @public
  */
 export type ReadExtensionPackageResult = {
     ok: true;
@@ -164,6 +162,6 @@ export type ReadExtensionPackageResult = {
  * Checks what the Client depends on: names it uses as keys, paths it resolves, and declarations
  * it registers before any of the extension's code runs. It does not check that files exist.
  *
- * @beta
+ * @public
  */
 export declare function readExtensionPackage(packageJson: unknown): ReadExtensionPackageResult;

package/dist/manifest.js

@@ -14,7 +14,7 @@ const ICON_MARKUP_LIMIT = 4096;
  * Checks what the Client depends on: names it uses as keys, paths it resolves, and declarations
  * it registers before any of the extension's code runs. It does not check that files exist.
  *
- * @beta
+ * @public
  */
 export function readExtensionPackage(packageJson) {
     const errors = [];

package/dist/menus.d.ts

@@ -5,7 +5,7 @@
 /**
  * A document, reached from its tab, a Favourite, Recents or an All Documents row.
  *
- * @beta
+ * @public
  */
 export interface DocumentMenuTarget {
     /** Where the menu was raised: the document's tab, or a row naming it. */
@@ -20,7 +20,7 @@ export interface DocumentMenuTarget {
 /**
  * A tab that is not a document's.
  *
- * @beta
+ * @public
  */
 export interface TabMenuTarget {
     /** Any tab that is not a document's. */
@@ -33,7 +33,7 @@ export interface TabMenuTarget {
 /**
  * A wikilink in an editor.
  *
- * @beta
+ * @public
  */
 export interface WikilinkMenuTarget {
     /** A wikilink in an editor. */
@@ -47,7 +47,7 @@ export interface WikilinkMenuTarget {
  * A thing an extension raises a menu on, of a kind the extension names under its own id
  * (`kanban.card`). Only rows that check for that kind apply to it.
  *
- * @beta
+ * @public
  */
 export interface ExtensionMenuTarget {
     /** `<extension id>.<name>`. */
@@ -58,15 +58,16 @@ export interface ExtensionMenuTarget {
 /**
  * What a Context Menu can be raised on that an extension may add rows to. The Client also raises
  * menus on things this list does not name, an Asset or a misspelt word, so a row's `when` answers
- * false for any kind it does not check for.
+ * false for any kind it does not check for. Kinds are only ever added to the list: when the Client
+ * no longer raises a menu on one, its rows are simply not shown.
  *
- * @beta
+ * @public
  */
 export type MenuTarget = DocumentMenuTarget | TabMenuTarget | WikilinkMenuTarget | ExtensionMenuTarget;
 /**
  * One Context Menu row.
  *
- * @beta
+ * @public
  */
 export interface ContextMenuItem {
     /** Under the extension's id: `graph-view.showConcept`. */
@@ -81,6 +82,8 @@ export interface ContextMenuItem {
     icon?: string;
     /** A separator above the row. */
     separatorBefore?: boolean | ((target: MenuTarget) => boolean);
+    /** The row deletes or removes something for good, so it is drawn in the danger colour, as the Client's own Delete rows are. */
+    danger?: boolean;
     /** Whether the row applies to a target. Absent means every target. */
     when?: (target: MenuTarget) => boolean;
 }
@@ -94,8 +97,6 @@ export interface CommandMenuContext {
     inTable: boolean;
     /**
      * A table may be inserted at the caret.
-     *
-     * @beta
      */
     tableInsertable: boolean;
     /** The document's body may be written: false in a locked Protected Document. */
@@ -110,8 +111,6 @@ export interface CommandMenuContext {
      * caret line's links, the links above it in the outline, the document's own concept, then the
      * scopes in its name. Names are as written, an alias as the alias. Worked out only when a row
      * reads it. Absent reads as none.
-     *
-     * @beta
      */
     readonly conceptsAtCaret?: readonly string[];
 }
@@ -144,8 +143,6 @@ export interface CommandMenuItem {
     command: string;
     /**
      * What the Command is given.
-     *
-     * @beta
      */
     args?: unknown;
 }
@@ -154,7 +151,7 @@ export interface CommandMenuItem {
  * it runs `command` and leaves the keyboard where it was, so a Command can tell whether the caret
  * is in the document.
  *
- * @beta
+ * @public
  */
 export interface CommandBarButton {
     /** Under the extension's id. */

package/dist/records.d.ts

@@ -8,18 +8,20 @@
  * The extension's records for the open graph on this device.
  *
  * Each record is stored as the browser's structured clone of the value, so it may hold a `Blob`,
- * an `ArrayBuffer`, a `Date` or plain data, but no function. Records live in the browser's
+ * an `ArrayBuffer`, a `Date` or plain data, but no function. A record holds at most 4 MB: its text
+ * and the bytes of every `Blob` and buffer in it. A larger one is refused. Records live in the browser's
  * IndexedDB, which a private window or a full disk may refuse: a refused write rejects, and a
  * refused read answers as if there were nothing.
  *
- * @beta
+ * @public
  */
 export interface ExtensionGraphRecords {
     /** The record under `key`, or undefined when there is none. */
     get<T>(key: string): Promise<T | undefined>;
     /**
      * Keep a record under `key`: letters, digits, `.`, `_`, `:` and `-`, at most 200 of them.
-     * Rejects when the key is not one of those or the browser refuses the write.
+     * Rejects when the key is not one of those, the record is over 4 MB, or the browser refuses
+     * the write (a full disk, a private window).
      */
     set(key: string, value: unknown): Promise<void>;
     /** Remove the record under `key`. */

package/dist/settings-sections.d.ts

@@ -1,22 +1,28 @@
 /**
- * An extension's own section in one of the Client's settings tabs (ADR 0134, amended 2026-10-15),
- * which the Client mounts with or without a graph open: on the Graphs page, and in a graph's
- * settings. For settings that belong to the person and need more than the fields a manifest can
- * declare, such as a list of accounts with a button that connects one.
+ * An extension's own section in the Client's settings (ADR 0134, amended 2026-10-15 and
+ * 2026-10-17), for settings that belong to the person and need more than the fields a manifest
+ * can declare, such as a list of accounts with a button that connects one. The main module exports
+ * them as `settingsSections`.
+ *
+ * The Client draws an extension's sections in a graph's Settings and Extensions while the extension
+ * runs there. An extension that comes with EtherPK is loaded with the Client, so its sections are
+ * drawn on the Graphs page too, with no graph open. Any other extension's code is loaded only once
+ * a graph opens, so its sections are not drawn on the Graphs page.
  */
 import type { ExtensionAuth } from './auth';
 import type { ExtensionPersonStorage, ExtensionSettings, ExtensionTheme } from './context';
 /**
- * The tabs an extension's settings section can go in.
+ * Where an extension's settings section is drawn: `extension`, under the extension's own entry in
+ * the Extensions area, beside the settings its manifest declares; or `agents`, in the Agents tab.
  *
- * @beta
+ * @public
  */
-export type SettingsSectionTab = 'agents';
+export type SettingsSectionTab = 'extension' | 'agents';
 /**
  * What a settings section is mounted with: what belongs to the person, and nothing from a graph,
  * since there may be no graph open.
  *
- * @beta
+ * @public
  */
 export interface SettingsSectionContext {
     /** The extension's id, from its manifest. */
@@ -35,7 +41,7 @@ export interface SettingsSectionContext {
 /**
  * A section the section's host element shows, as the Client drives it.
  *
- * @beta
+ * @public
  */
 export interface MountedSettingsSection {
     /** The tab closed, or the extension was switched off. */
@@ -44,7 +50,7 @@ export interface MountedSettingsSection {
 /**
  * One settings section an extension adds.
  *
- * @beta
+ * @public
  */
 export interface SettingsSection {
     /** Unique within the extension. */