obsidian-dev-utils 88.5.0 → 88.7.0

package/dist/lib/esm/obsidian/components/index.mjs

@@ -41,6 +41,7 @@ import * as plugin_settings_tab_component from "./plugin-settings-tab-component.
 import * as pointer_position_component from "./pointer-position-component.mjs";
 import * as registry_component from "./registry-component.mjs";
 import * as rename_delete_handler_component from "./rename-delete-handler-component.mjs";
+import * as syntax_highlighting_component from "./syntax-highlighting-component.mjs";
 export {
   abort_signal_component as "abort-signal-component",
   all_windows_event_component as "all-windows-event-component",
@@ -61,6 +62,7 @@ export {
   plugin_settings_tab_component as "plugin-settings-tab-component",
   pointer_position_component as "pointer-position-component",
   registry_component as "registry-component",
-  rename_delete_handler_component as "rename-delete-handler-component"
+  rename_delete_handler_component as "rename-delete-handler-component",
+  syntax_highlighting_component as "syntax-highlighting-component"
 };
-//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbXBvbmVudHMvaW5kZXgudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qIFRISVMgSVMgQSBHRU5FUkFURUQvQlVORExFRCBGSUxFIEJZIEJVSUxEIFNDUklQVCAqL1xuXG5leHBvcnQgKiBhcyAnYWJvcnQtc2lnbmFsLWNvbXBvbmVudCcgZnJvbSAnLi9hYm9ydC1zaWduYWwtY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzICdhbGwtd2luZG93cy1ldmVudC1jb21wb25lbnQnIGZyb20gJy4vYWxsLXdpbmRvd3MtZXZlbnQtY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzICdhc3luYy1lcnJvci1oYW5kbGVyLWNvbXBvbmVudCcgZnJvbSAnLi9hc3luYy1lcnJvci1oYW5kbGVyLWNvbXBvbmVudC50cyc7XG5leHBvcnQgKiBhcyAnYXN5bmMtZXZlbnRzLWNvbXBvbmVudCcgZnJvbSAnLi9hc3luYy1ldmVudHMtY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzICdjYXNlLWluc2Vuc2l0aXZlLWZpbGUtaW5kZXgtY29tcG9uZW50JyBmcm9tICcuL2Nhc2UtaW5zZW5zaXRpdmUtZmlsZS1pbmRleC1jb21wb25lbnQudHMnO1xuZXhwb3J0ICogYXMgJ2NvbXBvbmVudC1leCcgZnJvbSAnLi9jb21wb25lbnQtZXgudHMnO1xuZXhwb3J0ICogYXMgJ2NvbnNvbGUtZGVidWctY29tcG9uZW50JyBmcm9tICcuL2NvbnNvbGUtZGVidWctY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzICdkaXNwb3NhYmxlLWNvbXBvbmVudCcgZnJvbSAnLi9kaXNwb3NhYmxlLWNvbXBvbmVudC50cyc7XG5leHBvcnQgKiBhcyAnZW1iZWQtZXh0ZW5zaW9ucy1jb21wb25lbnQnIGZyb20gJy4vZW1iZWQtZXh0ZW5zaW9ucy1jb21wb25lbnQudHMnO1xuZXhwb3J0ICogYXMgJ2dlbmVyYXRlLW1hcmtkb3duLWxpbmstZGVmYXVsdC1wYXJhbXMtY29tcG9uZW50JyBmcm9tICcuL2dlbmVyYXRlLW1hcmtkb3duLWxpbmstZGVmYXVsdC1wYXJhbXMtY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzICdsYXlvdXQtcmVhZHktY29tcG9uZW50JyBmcm9tICcuL2xheW91dC1yZWFkeS1jb21wb25lbnQudHMnO1xuZXhwb3J0ICogYXMgJ21lbnUtZXZlbnQtcmVnaXN0cmFyLWNvbXBvbmVudCcgZnJvbSAnLi9tZW51LWV2ZW50LXJlZ2lzdHJhci1jb21wb25lbnQudHMnO1xuZXhwb3J0ICogYXMgJ21vbmtleS1hcm91bmQtY29tcG9uZW50JyBmcm9tICcuL21vbmtleS1hcm91bmQtY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzICdwbHVnaW4tY29udGV4dC1jb21wb25lbnQnIGZyb20gJy4vcGx1Z2luLWNvbnRleHQtY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzICdwbHVnaW4tbm90aWNlLWNvbXBvbmVudCcgZnJvbSAnLi9wbHVnaW4tbm90aWNlLWNvbXBvbmVudC50cyc7XG5leHBvcnQgKiBhcyAncGx1Z2luLXNldHRpbmdzLWNvbXBvbmVudCcgZnJvbSAnLi9wbHVnaW4tc2V0dGluZ3MtY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzICdwbHVnaW4tc2V0dGluZ3MtdGFiLWNvbXBvbmVudCcgZnJvbSAnLi9wbHVnaW4tc2V0dGluZ3MtdGFiLWNvbXBvbmVudC50cyc7XG5leHBvcnQgKiBhcyAncG9pbnRlci1wb3NpdGlvbi1jb21wb25lbnQnIGZyb20gJy4vcG9pbnRlci1wb3NpdGlvbi1jb21wb25lbnQudHMnO1xuZXhwb3J0ICogYXMgJ3JlZ2lzdHJ5LWNvbXBvbmVudCcgZnJvbSAnLi9yZWdpc3RyeS1jb21wb25lbnQudHMnO1xuZXhwb3J0ICogYXMgJ3JlbmFtZS1kZWxldGUtaGFuZGxlci1jb21wb25lbnQnIGZyb20gJy4vcmVuYW1lLWRlbGV0ZS1oYW5kbGVyLWNvbXBvbmVudC50cyc7XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUVBLFlBQVlBLDRCQUE4QjtBQUMxQyxZQUFZQyxpQ0FBbUM7QUFDL0MsWUFBWUMsbUNBQXFDO0FBQ2pELFlBQVlDLDRCQUE4QjtBQUMxQyxZQUFZQywyQ0FBNkM7QUFDekQsWUFBWUMsa0JBQW9CO0FBQ2hDLFlBQVlDLDZCQUErQjtBQUMzQyxZQUFZQywwQkFBNEI7QUFDeEMsWUFBWUMsZ0NBQWtDO0FBQzlDLFlBQVlDLHFEQUF1RDtBQUNuRSxZQUFZQyw0QkFBOEI7QUFDMUMsWUFBWUMsb0NBQXNDO0FBQ2xELFlBQVlDLDZCQUErQjtBQUMzQyxZQUFZQyw4QkFBZ0M7QUFDNUMsWUFBWUMsNkJBQStCO0FBQzNDLFlBQVlDLCtCQUFpQztBQUM3QyxZQUFZQyxtQ0FBcUM7QUFDakQsWUFBWUMsZ0NBQWtDO0FBQzlDLFlBQVlDLHdCQUEwQjtBQUN0QyxZQUFZQyxxQ0FBdUM7IiwKICAibmFtZXMiOiBbImFib3J0LXNpZ25hbC1jb21wb25lbnQiLCAiYWxsLXdpbmRvd3MtZXZlbnQtY29tcG9uZW50IiwgImFzeW5jLWVycm9yLWhhbmRsZXItY29tcG9uZW50IiwgImFzeW5jLWV2ZW50cy1jb21wb25lbnQiLCAiY2FzZS1pbnNlbnNpdGl2ZS1maWxlLWluZGV4LWNvbXBvbmVudCIsICJjb21wb25lbnQtZXgiLCAiY29uc29sZS1kZWJ1Zy1jb21wb25lbnQiLCAiZGlzcG9zYWJsZS1jb21wb25lbnQiLCAiZW1iZWQtZXh0ZW5zaW9ucy1jb21wb25lbnQiLCAiZ2VuZXJhdGUtbWFya2Rvd24tbGluay1kZWZhdWx0LXBhcmFtcy1jb21wb25lbnQiLCAibGF5b3V0LXJlYWR5LWNvbXBvbmVudCIsICJtZW51LWV2ZW50LXJlZ2lzdHJhci1jb21wb25lbnQiLCAibW9ua2V5LWFyb3VuZC1jb21wb25lbnQiLCAicGx1Z2luLWNvbnRleHQtY29tcG9uZW50IiwgInBsdWdpbi1ub3RpY2UtY29tcG9uZW50IiwgInBsdWdpbi1zZXR0aW5ncy1jb21wb25lbnQiLCAicGx1Z2luLXNldHRpbmdzLXRhYi1jb21wb25lbnQiLCAicG9pbnRlci1wb3NpdGlvbi1jb21wb25lbnQiLCAicmVnaXN0cnktY29tcG9uZW50IiwgInJlbmFtZS1kZWxldGUtaGFuZGxlci1jb21wb25lbnQiXQp9Cg==
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbXBvbmVudHMvaW5kZXgudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qIFRISVMgSVMgQSBHRU5FUkFURUQvQlVORExFRCBGSUxFIEJZIEJVSUxEIFNDUklQVCAqL1xuXG5leHBvcnQgKiBhcyAnYWJvcnQtc2lnbmFsLWNvbXBvbmVudCcgZnJvbSAnLi9hYm9ydC1zaWduYWwtY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzICdhbGwtd2luZG93cy1ldmVudC1jb21wb25lbnQnIGZyb20gJy4vYWxsLXdpbmRvd3MtZXZlbnQtY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzICdhc3luYy1lcnJvci1oYW5kbGVyLWNvbXBvbmVudCcgZnJvbSAnLi9hc3luYy1lcnJvci1oYW5kbGVyLWNvbXBvbmVudC50cyc7XG5leHBvcnQgKiBhcyAnYXN5bmMtZXZlbnRzLWNvbXBvbmVudCcgZnJvbSAnLi9hc3luYy1ldmVudHMtY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzICdjYXNlLWluc2Vuc2l0aXZlLWZpbGUtaW5kZXgtY29tcG9uZW50JyBmcm9tICcuL2Nhc2UtaW5zZW5zaXRpdmUtZmlsZS1pbmRleC1jb21wb25lbnQudHMnO1xuZXhwb3J0ICogYXMgJ2NvbXBvbmVudC1leCcgZnJvbSAnLi9jb21wb25lbnQtZXgudHMnO1xuZXhwb3J0ICogYXMgJ2NvbnNvbGUtZGVidWctY29tcG9uZW50JyBmcm9tICcuL2NvbnNvbGUtZGVidWctY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzICdkaXNwb3NhYmxlLWNvbXBvbmVudCcgZnJvbSAnLi9kaXNwb3NhYmxlLWNvbXBvbmVudC50cyc7XG5leHBvcnQgKiBhcyAnZW1iZWQtZXh0ZW5zaW9ucy1jb21wb25lbnQnIGZyb20gJy4vZW1iZWQtZXh0ZW5zaW9ucy1jb21wb25lbnQudHMnO1xuZXhwb3J0ICogYXMgJ2dlbmVyYXRlLW1hcmtkb3duLWxpbmstZGVmYXVsdC1wYXJhbXMtY29tcG9uZW50JyBmcm9tICcuL2dlbmVyYXRlLW1hcmtkb3duLWxpbmstZGVmYXVsdC1wYXJhbXMtY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzICdsYXlvdXQtcmVhZHktY29tcG9uZW50JyBmcm9tICcuL2xheW91dC1yZWFkeS1jb21wb25lbnQudHMnO1xuZXhwb3J0ICogYXMgJ21lbnUtZXZlbnQtcmVnaXN0cmFyLWNvbXBvbmVudCcgZnJvbSAnLi9tZW51LWV2ZW50LXJlZ2lzdHJhci1jb21wb25lbnQudHMnO1xuZXhwb3J0ICogYXMgJ21vbmtleS1hcm91bmQtY29tcG9uZW50JyBmcm9tICcuL21vbmtleS1hcm91bmQtY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzICdwbHVnaW4tY29udGV4dC1jb21wb25lbnQnIGZyb20gJy4vcGx1Z2luLWNvbnRleHQtY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzICdwbHVnaW4tbm90aWNlLWNvbXBvbmVudCcgZnJvbSAnLi9wbHVnaW4tbm90aWNlLWNvbXBvbmVudC50cyc7XG5leHBvcnQgKiBhcyAncGx1Z2luLXNldHRpbmdzLWNvbXBvbmVudCcgZnJvbSAnLi9wbHVnaW4tc2V0dGluZ3MtY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzICdwbHVnaW4tc2V0dGluZ3MtdGFiLWNvbXBvbmVudCcgZnJvbSAnLi9wbHVnaW4tc2V0dGluZ3MtdGFiLWNvbXBvbmVudC50cyc7XG5leHBvcnQgKiBhcyAncG9pbnRlci1wb3NpdGlvbi1jb21wb25lbnQnIGZyb20gJy4vcG9pbnRlci1wb3NpdGlvbi1jb21wb25lbnQudHMnO1xuZXhwb3J0ICogYXMgJ3JlZ2lzdHJ5LWNvbXBvbmVudCcgZnJvbSAnLi9yZWdpc3RyeS1jb21wb25lbnQudHMnO1xuZXhwb3J0ICogYXMgJ3JlbmFtZS1kZWxldGUtaGFuZGxlci1jb21wb25lbnQnIGZyb20gJy4vcmVuYW1lLWRlbGV0ZS1oYW5kbGVyLWNvbXBvbmVudC50cyc7XG5leHBvcnQgKiBhcyAnc3ludGF4LWhpZ2hsaWdodGluZy1jb21wb25lbnQnIGZyb20gJy4vc3ludGF4LWhpZ2hsaWdodGluZy1jb21wb25lbnQudHMnO1xuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFFQSxZQUFZQSw0QkFBOEI7QUFDMUMsWUFBWUMsaUNBQW1DO0FBQy9DLFlBQVlDLG1DQUFxQztBQUNqRCxZQUFZQyw0QkFBOEI7QUFDMUMsWUFBWUMsMkNBQTZDO0FBQ3pELFlBQVlDLGtCQUFvQjtBQUNoQyxZQUFZQyw2QkFBK0I7QUFDM0MsWUFBWUMsMEJBQTRCO0FBQ3hDLFlBQVlDLGdDQUFrQztBQUM5QyxZQUFZQyxxREFBdUQ7QUFDbkUsWUFBWUMsNEJBQThCO0FBQzFDLFlBQVlDLG9DQUFzQztBQUNsRCxZQUFZQyw2QkFBK0I7QUFDM0MsWUFBWUMsOEJBQWdDO0FBQzVDLFlBQVlDLDZCQUErQjtBQUMzQyxZQUFZQywrQkFBaUM7QUFDN0MsWUFBWUMsbUNBQXFDO0FBQ2pELFlBQVlDLGdDQUFrQztBQUM5QyxZQUFZQyx3QkFBMEI7QUFDdEMsWUFBWUMscUNBQXVDO0FBQ25ELFlBQVlDLG1DQUFxQzsiLAogICJuYW1lcyI6IFsiYWJvcnQtc2lnbmFsLWNvbXBvbmVudCIsICJhbGwtd2luZG93cy1ldmVudC1jb21wb25lbnQiLCAiYXN5bmMtZXJyb3ItaGFuZGxlci1jb21wb25lbnQiLCAiYXN5bmMtZXZlbnRzLWNvbXBvbmVudCIsICJjYXNlLWluc2Vuc2l0aXZlLWZpbGUtaW5kZXgtY29tcG9uZW50IiwgImNvbXBvbmVudC1leCIsICJjb25zb2xlLWRlYnVnLWNvbXBvbmVudCIsICJkaXNwb3NhYmxlLWNvbXBvbmVudCIsICJlbWJlZC1leHRlbnNpb25zLWNvbXBvbmVudCIsICJnZW5lcmF0ZS1tYXJrZG93bi1saW5rLWRlZmF1bHQtcGFyYW1zLWNvbXBvbmVudCIsICJsYXlvdXQtcmVhZHktY29tcG9uZW50IiwgIm1lbnUtZXZlbnQtcmVnaXN0cmFyLWNvbXBvbmVudCIsICJtb25rZXktYXJvdW5kLWNvbXBvbmVudCIsICJwbHVnaW4tY29udGV4dC1jb21wb25lbnQiLCAicGx1Z2luLW5vdGljZS1jb21wb25lbnQiLCAicGx1Z2luLXNldHRpbmdzLWNvbXBvbmVudCIsICJwbHVnaW4tc2V0dGluZ3MtdGFiLWNvbXBvbmVudCIsICJwb2ludGVyLXBvc2l0aW9uLWNvbXBvbmVudCIsICJyZWdpc3RyeS1jb21wb25lbnQiLCAicmVuYW1lLWRlbGV0ZS1oYW5kbGVyLWNvbXBvbmVudCIsICJzeW50YXgtaGlnaGxpZ2h0aW5nLWNvbXBvbmVudCJdCn0K

package/dist/lib/esm/obsidian/components/syntax-highlighting-component.d.mts

@@ -0,0 +1,149 @@
+/// <reference path="../../library.d.mts" />
+/**
+ * @file
+ *
+ * Contains class {@link SyntaxHighlightingComponent} that registers syntax highlighting languages.
+ *
+ * Obsidian highlights code in two independent places, through two separate registries, and a plugin adding
+ * its own language usually has to touch both:
+ *
+ * - **Prism** (`prism.languages[language]`) highlights code in reading view and in every `<pre><code>` the
+ *   library renders — including the {@link CodeHighlighterComponent} settings field.
+ * - **The CodeMirror 5 mode registry** (`window.CodeMirror.modes[language]`) highlights a fenced code block
+ *   inside the editor.
+ *
+ * The CodeMirror 5 half looks like legacy that should be migrated to CodeMirror 6. **It is not** — verified
+ * against the Obsidian 1.13.4 runtime:
+ *
+ * - Obsidian's own CodeMirror 6 editor language is a bridged CodeMirror 5 mode:
+ *   `StreamLanguage.define(CodeMirror.getMode({}, { name: 'hypermd' }))`.
+ * - Obsidian registers that `hypermd` mode through `window.CodeMirror.defineMode` with
+ *   `fencedCodeBlockHighlighting: true`, and that option resolves each fence's language through the
+ *   **CodeMirror 5 mode registry**.
+ * - There is no public or internal CodeMirror 6 language-registration API for fences.
+ *
+ * So `window.CodeMirror.defineMode` is the sanctioned extension point, not legacy debt. Do not reopen this
+ * as a migration.
+ *
+ * Teardown REMOVES the mode rather than redefining it to `null`. Plugins predating this component redefined
+ * the mode to `null` on unload, because it was unclear whether CodeMirror's `getMode` needs the entry to
+ * stay present. It does not — verified against a live Obsidian 1.13.4 by
+ * `syntax-highlighting-component.obsidian.integration.test.ts`: after the entry is deleted, the fence
+ * renders its text with no error and drops back to the exact token count it had before the language was
+ * ever registered.
+ */
+import type { Grammar, PrismModule } from '@obsidian-typings/obsidian-public-latest';
+import { ComponentEx } from './component-ex.mjs';
+/**
+ * The loaded Prism module, handed to a grammar factory.
+ */
+export interface SyntaxHighlightingComponentGrammarFactoryParams {
+    /**
+     * The loaded Prism module.
+     */
+    readonly prism: PrismModule;
+    /**
+     * Returns the grammar of an already registered Prism language, for nesting into the built grammar.
+     *
+     * @param language - The language to look up.
+     * @returns The grammar of the language.
+     * @throws An {@link Error} if the language is not registered.
+     */
+    requirePrismLanguage(language: string): Grammar;
+}
+/**
+ * A grammar, the name of an already registered language to alias, or a factory that builds the grammar from
+ * the loaded Prism module.
+ */
+export type SyntaxHighlightingComponentGrammarSource = ((params: SyntaxHighlightingComponentGrammarFactoryParams) => Grammar) | Grammar | string;
+/**
+ * Parameters for {@link SyntaxHighlightingComponent.registerCodeBlockLanguageAsync}.
+ */
+export interface SyntaxHighlightingComponentRegisterCodeBlockLanguageAsyncParams {
+    /**
+     * The CodeMirror 5 mode name or MIME type the editor highlights the fence as, e.g. `text/typescript`.
+     */
+    readonly editorMode: string;
+    /**
+     * The fence language, e.g. the `foo` in a ` ```foo ` code block.
+     */
+    readonly language: string;
+    /**
+     * The grammar highlighting the fence in reading view. Omit when the fence is replaced in reading view —
+     * e.g. a fence rendered as a button.
+     */
+    readonly prismGrammar?: SyntaxHighlightingComponentGrammarSource | undefined;
+}
+/**
+ * Parameters for {@link SyntaxHighlightingComponent.registerPrismLanguageAsync}.
+ */
+export interface SyntaxHighlightingComponentRegisterPrismLanguageAsyncParams {
+    /**
+     * The grammar to register.
+     */
+    readonly grammar: SyntaxHighlightingComponentGrammarSource;
+    /**
+     * The language to register the grammar as.
+     */
+    readonly language: string;
+}
+/**
+ * A component that registers and unregisters syntax highlighting languages.
+ *
+ * @remarks
+ * Every registration is undone when the component is unloaded: the previous entry is restored if the
+ * language was already registered, otherwise the entry is removed.
+ */
+export declare class SyntaxHighlightingComponent extends ComponentEx {
+    /**
+     * Registers a fenced code block language, highlighting it in the editor and, optionally, in reading view.
+     *
+     * @param params - The parameters for registering the language.
+     * @returns A {@link Promise} that resolves when the language is registered.
+     *
+     * @example
+     * ```ts
+     * await component.registerCodeBlockLanguageAsync({
+     *   editorMode: 'text/typescript',
+     *   language: 'my-language',
+     *   prismGrammar: 'typescript'
+     * });
+     * ```
+     */
+    registerCodeBlockLanguageAsync(params: SyntaxHighlightingComponentRegisterCodeBlockLanguageAsyncParams): Promise<void>;
+    /**
+     * Registers a Prism language, highlighting it everywhere Prism renders code — reading view and the
+     * {@link CodeHighlighterComponent} settings field.
+     *
+     * @param params - The parameters for registering the language.
+     * @returns A {@link Promise} that resolves when the language is registered.
+     *
+     * @example
+     * ```ts
+     * await component.registerPrismLanguageAsync({
+     *   grammar: {
+     *     keyword: /\bfoo\b/
+     *   },
+     *   language: 'my-language'
+     * });
+     * ```
+     */
+    registerPrismLanguageAsync(params: SyntaxHighlightingComponentRegisterPrismLanguageAsyncParams): Promise<void>;
+    /**
+     * Returns the grammar of an already registered Prism language.
+     *
+     * @param prism - The loaded Prism module.
+     * @param language - The language to look up.
+     * @returns The grammar of the language.
+     * @throws An {@link Error} if the language is not registered.
+     */
+    private requirePrismLanguage;
+    /**
+     * Resolves a grammar source into the grammar to register.
+     *
+     * @param prism - The loaded Prism module.
+     * @param grammarSource - The grammar source to resolve.
+     * @returns The resolved grammar.
+     */
+    private resolveGrammar;
+}

package/dist/lib/esm/obsidian/components/syntax-highlighting-component.mjs

@@ -0,0 +1,136 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function initEsm() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  if (globalThis.process) {
+    return;
+  }
+
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  globalThis.process = browserProcess;
+})();
+
+import { loadPrism } from "@obsidian-typings/obsidian-public-latest/implementations";
+import { throwExpression } from "../../error.mjs";
+import { ComponentEx } from "./component-ex.mjs";
+class SyntaxHighlightingComponent extends ComponentEx {
+  /**
+   * Registers a fenced code block language, highlighting it in the editor and, optionally, in reading view.
+   *
+   * @param params - The parameters for registering the language.
+   * @returns A {@link Promise} that resolves when the language is registered.
+   *
+   * @example
+   * ```ts
+   * await component.registerCodeBlockLanguageAsync({
+   *   editorMode: 'text/typescript',
+   *   language: 'my-language',
+   *   prismGrammar: 'typescript'
+   * });
+   * ```
+   */
+  async registerCodeBlockLanguageAsync(params) {
+    const {
+      editorMode,
+      language,
+      prismGrammar
+    } = params;
+    this.ensureLoaded();
+    if (prismGrammar !== void 0) {
+      await this.registerPrismLanguageAsync({
+        grammar: prismGrammar,
+        language
+      });
+    }
+    this.ensureLoaded();
+    const previousModeFactory = window.CodeMirror.modes[language];
+    window.CodeMirror.defineMode(language, (config) => window.CodeMirror.getMode(config, editorMode));
+    this.register(() => {
+      if (previousModeFactory !== void 0) {
+        window.CodeMirror.modes[language] = previousModeFactory;
+        return;
+      }
+      delete window.CodeMirror.modes[language];
+    });
+  }
+  /**
+   * Registers a Prism language, highlighting it everywhere Prism renders code — reading view and the
+   * {@link CodeHighlighterComponent} settings field.
+   *
+   * @param params - The parameters for registering the language.
+   * @returns A {@link Promise} that resolves when the language is registered.
+   *
+   * @example
+   * ```ts
+   * await component.registerPrismLanguageAsync({
+   *   grammar: {
+   *     keyword: /\bfoo\b/
+   *   },
+   *   language: 'my-language'
+   * });
+   * ```
+   */
+  async registerPrismLanguageAsync(params) {
+    const {
+      grammar,
+      language
+    } = params;
+    this.ensureLoaded();
+    const prism = await loadPrism();
+    this.ensureLoaded();
+    const previousGrammar = prism.languages[language];
+    prism.languages[language] = this.resolveGrammar(prism, grammar);
+    this.register(() => {
+      if (previousGrammar !== void 0) {
+        prism.languages[language] = previousGrammar;
+        return;
+      }
+      delete prism.languages[language];
+    });
+  }
+  /**
+   * Returns the grammar of an already registered Prism language.
+   *
+   * @param prism - The loaded Prism module.
+   * @param language - The language to look up.
+   * @returns The grammar of the language.
+   * @throws An {@link Error} if the language is not registered.
+   */
+  requirePrismLanguage(prism, language) {
+    return prism.languages[language] ?? throwExpression(new Error(`Prism language "${language}" is not registered.`));
+  }
+  /**
+   * Resolves a grammar source into the grammar to register.
+   *
+   * @param prism - The loaded Prism module.
+   * @param grammarSource - The grammar source to resolve.
+   * @returns The resolved grammar.
+   */
+  resolveGrammar(prism, grammarSource) {
+    if (typeof grammarSource === "string") {
+      return this.requirePrismLanguage(prism, grammarSource);
+    }
+    if (typeof grammarSource === "function") {
+      return grammarSource({
+        prism,
+        requirePrismLanguage: (language) => this.requirePrismLanguage(prism, language)
+      });
+    }
+    return grammarSource;
+  }
+}
+export {
+  SyntaxHighlightingComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbXBvbmVudHMvc3ludGF4LWhpZ2hsaWdodGluZy1jb21wb25lbnQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBDb250YWlucyBjbGFzcyB7QGxpbmsgU3ludGF4SGlnaGxpZ2h0aW5nQ29tcG9uZW50fSB0aGF0IHJlZ2lzdGVycyBzeW50YXggaGlnaGxpZ2h0aW5nIGxhbmd1YWdlcy5cbiAqXG4gKiBPYnNpZGlhbiBoaWdobGlnaHRzIGNvZGUgaW4gdHdvIGluZGVwZW5kZW50IHBsYWNlcywgdGhyb3VnaCB0d28gc2VwYXJhdGUgcmVnaXN0cmllcywgYW5kIGEgcGx1Z2luIGFkZGluZ1xuICogaXRzIG93biBsYW5ndWFnZSB1c3VhbGx5IGhhcyB0byB0b3VjaCBib3RoOlxuICpcbiAqIC0gKipQcmlzbSoqIChgcHJpc20ubGFuZ3VhZ2VzW2xhbmd1YWdlXWApIGhpZ2hsaWdodHMgY29kZSBpbiByZWFkaW5nIHZpZXcgYW5kIGluIGV2ZXJ5IGA8cHJlPjxjb2RlPmAgdGhlXG4gKiAgIGxpYnJhcnkgcmVuZGVycyBcdTIwMTQgaW5jbHVkaW5nIHRoZSB7QGxpbmsgQ29kZUhpZ2hsaWdodGVyQ29tcG9uZW50fSBzZXR0aW5ncyBmaWVsZC5cbiAqIC0gKipUaGUgQ29kZU1pcnJvciA1IG1vZGUgcmVnaXN0cnkqKiAoYHdpbmRvdy5Db2RlTWlycm9yLm1vZGVzW2xhbmd1YWdlXWApIGhpZ2hsaWdodHMgYSBmZW5jZWQgY29kZSBibG9ja1xuICogICBpbnNpZGUgdGhlIGVkaXRvci5cbiAqXG4gKiBUaGUgQ29kZU1pcnJvciA1IGhhbGYgbG9va3MgbGlrZSBsZWdhY3kgdGhhdCBzaG91bGQgYmUgbWlncmF0ZWQgdG8gQ29kZU1pcnJvciA2LiAqKkl0IGlzIG5vdCoqIFx1MjAxNCB2ZXJpZmllZFxuICogYWdhaW5zdCB0aGUgT2JzaWRpYW4gMS4xMy40IHJ1bnRpbWU6XG4gKlxuICogLSBPYnNpZGlhbidzIG93biBDb2RlTWlycm9yIDYgZWRpdG9yIGxhbmd1YWdlIGlzIGEgYnJpZGdlZCBDb2RlTWlycm9yIDUgbW9kZTpcbiAqICAgYFN0cmVhbUxhbmd1YWdlLmRlZmluZShDb2RlTWlycm9yLmdldE1vZGUoe30sIHsgbmFtZTogJ2h5cGVybWQnIH0pKWAuXG4gKiAtIE9ic2lkaWFuIHJlZ2lzdGVycyB0aGF0IGBoeXBlcm1kYCBtb2RlIHRocm91Z2ggYHdpbmRvdy5Db2RlTWlycm9yLmRlZmluZU1vZGVgIHdpdGhcbiAqICAgYGZlbmNlZENvZGVCbG9ja0hpZ2hsaWdodGluZzogdHJ1ZWAsIGFuZCB0aGF0IG9wdGlvbiByZXNvbHZlcyBlYWNoIGZlbmNlJ3MgbGFuZ3VhZ2UgdGhyb3VnaCB0aGVcbiAqICAgKipDb2RlTWlycm9yIDUgbW9kZSByZWdpc3RyeSoqLlxuICogLSBUaGVyZSBpcyBubyBwdWJsaWMgb3IgaW50ZXJuYWwgQ29kZU1pcnJvciA2IGxhbmd1YWdlLXJlZ2lzdHJhdGlvbiBBUEkgZm9yIGZlbmNlcy5cbiAqXG4gKiBTbyBgd2luZG93LkNvZGVNaXJyb3IuZGVmaW5lTW9kZWAgaXMgdGhlIHNhbmN0aW9uZWQgZXh0ZW5zaW9uIHBvaW50LCBub3QgbGVnYWN5IGRlYnQuIERvIG5vdCByZW9wZW4gdGhpc1xuICogYXMgYSBtaWdyYXRpb24uXG4gKlxuICogVGVhcmRvd24gUkVNT1ZFUyB0aGUgbW9kZSByYXRoZXIgdGhhbiByZWRlZmluaW5nIGl0IHRvIGBudWxsYC4gUGx1Z2lucyBwcmVkYXRpbmcgdGhpcyBjb21wb25lbnQgcmVkZWZpbmVkXG4gKiB0aGUgbW9kZSB0byBgbnVsbGAgb24gdW5sb2FkLCBiZWNhdXNlIGl0IHdhcyB1bmNsZWFyIHdoZXRoZXIgQ29kZU1pcnJvcidzIGBnZXRNb2RlYCBuZWVkcyB0aGUgZW50cnkgdG9cbiAqIHN0YXkgcHJlc2VudC4gSXQgZG9lcyBub3QgXHUyMDE0IHZlcmlmaWVkIGFnYWluc3QgYSBsaXZlIE9ic2lkaWFuIDEuMTMuNCBieVxuICogYHN5bnRheC1oaWdobGlnaHRpbmctY29tcG9uZW50Lm9ic2lkaWFuLmludGVncmF0aW9uLnRlc3QudHNgOiBhZnRlciB0aGUgZW50cnkgaXMgZGVsZXRlZCwgdGhlIGZlbmNlXG4gKiByZW5kZXJzIGl0cyB0ZXh0IHdpdGggbm8gZXJyb3IgYW5kIGRyb3BzIGJhY2sgdG8gdGhlIGV4YWN0IHRva2VuIGNvdW50IGl0IGhhZCBiZWZvcmUgdGhlIGxhbmd1YWdlIHdhc1xuICogZXZlciByZWdpc3RlcmVkLlxuICovXG5cbmltcG9ydCB0eXBlIHtcbiAgR3JhbW1hcixcbiAgUHJpc21Nb2R1bGVcbn0gZnJvbSAnQG9ic2lkaWFuLXR5cGluZ3Mvb2JzaWRpYW4tcHVibGljLWxhdGVzdCc7XG5cbmltcG9ydCB7IGxvYWRQcmlzbSB9IGZyb20gJ0BvYnNpZGlhbi10eXBpbmdzL29ic2lkaWFuLXB1YmxpYy1sYXRlc3QvaW1wbGVtZW50YXRpb25zJztcblxuLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9uby11bnVzZWQtdmFycyAtLSBXZSBuZWVkIHRvIGltcG9ydCBgQ29kZUhpZ2hsaWdodGVyQ29tcG9uZW50YCB0byB1c2UgaXQgaW4gdGhlIHRzZG9jcy5cbmltcG9ydCB0eXBlIHsgQ29kZUhpZ2hsaWdodGVyQ29tcG9uZW50IH0gZnJvbSAnLi4vc2V0dGluZy1jb21wb25lbnRzL2NvZGUtaGlnaGxpZ2h0ZXItY29tcG9uZW50LnRzJztcblxuaW1wb3J0IHsgdGhyb3dFeHByZXNzaW9uIH0gZnJvbSAnLi4vLi4vZXJyb3IudHMnO1xuaW1wb3J0IHsgQ29tcG9uZW50RXggfSBmcm9tICcuL2NvbXBvbmVudC1leC50cyc7XG5cbi8qKlxuICogVGhlIGxvYWRlZCBQcmlzbSBtb2R1bGUsIGhhbmRlZCB0byBhIGdyYW1tYXIgZmFjdG9yeS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBTeW50YXhIaWdobGlnaHRpbmdDb21wb25lbnRHcmFtbWFyRmFjdG9yeVBhcmFtcyB7XG4gIC8qKlxuICAgKiBUaGUgbG9hZGVkIFByaXNtIG1vZHVsZS5cbiAgICovXG4gIHJlYWRvbmx5IHByaXNtOiBQcmlzbU1vZHVsZTtcblxuICAvKipcbiAgICogUmV0dXJucyB0aGUgZ3JhbW1hciBvZiBhbiBhbHJlYWR5IHJlZ2lzdGVyZWQgUHJpc20gbGFuZ3VhZ2UsIGZvciBuZXN0aW5nIGludG8gdGhlIGJ1aWx0IGdyYW1tYXIuXG4gICAqXG4gICAqIEBwYXJhbSBsYW5ndWFnZSAtIFRoZSBsYW5ndWFnZSB0byBsb29rIHVwLlxuICAgKiBAcmV0dXJucyBUaGUgZ3JhbW1hciBvZiB0aGUgbGFuZ3VhZ2UuXG4gICAqIEB0aHJvd3MgQW4ge0BsaW5rIEVycm9yfSBpZiB0aGUgbGFuZ3VhZ2UgaXMgbm90IHJlZ2lzdGVyZWQuXG4gICAqL1xuICByZXF1aXJlUHJpc21MYW5ndWFnZShsYW5ndWFnZTogc3RyaW5nKTogR3JhbW1hcjtcbn1cblxuLyoqXG4gKiBBIGdyYW1tYXIsIHRoZSBuYW1lIG9mIGFuIGFscmVhZHkgcmVnaXN0ZXJlZCBsYW5ndWFnZSB0byBhbGlhcywgb3IgYSBmYWN0b3J5IHRoYXQgYnVpbGRzIHRoZSBncmFtbWFyIGZyb21cbiAqIHRoZSBsb2FkZWQgUHJpc20gbW9kdWxlLlxuICovXG5leHBvcnQgdHlwZSBTeW50YXhIaWdobGlnaHRpbmdDb21wb25lbnRHcmFtbWFyU291cmNlID0gKChwYXJhbXM6IFN5bnRheEhpZ2hsaWdodGluZ0NvbXBvbmVudEdyYW1tYXJGYWN0b3J5UGFyYW1zKSA9PiBHcmFtbWFyKSB8IEdyYW1tYXIgfCBzdHJpbmc7XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIFN5bnRheEhpZ2hsaWdodGluZ0NvbXBvbmVudC5yZWdpc3RlckNvZGVCbG9ja0xhbmd1YWdlQXN5bmN9LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFN5bnRheEhpZ2hsaWdodGluZ0NvbXBvbmVudFJlZ2lzdGVyQ29kZUJsb2NrTGFuZ3VhZ2VBc3luY1BhcmFtcyB7XG4gIC8qKlxuICAgKiBUaGUgQ29kZU1pcnJvciA1IG1vZGUgbmFtZSBvciBNSU1FIHR5cGUgdGhlIGVkaXRvciBoaWdobGlnaHRzIHRoZSBmZW5jZSBhcywgZS5nLiBgdGV4dC90eXBlc2NyaXB0YC5cbiAgICovXG4gIHJlYWRvbmx5IGVkaXRvck1vZGU6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIGZlbmNlIGxhbmd1YWdlLCBlLmcuIHRoZSBgZm9vYCBpbiBhIGAgYGBgZm9vIGAgY29kZSBibG9jay5cbiAgICovXG4gIHJlYWRvbmx5IGxhbmd1YWdlOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBncmFtbWFyIGhpZ2hsaWdodGluZyB0aGUgZmVuY2UgaW4gcmVhZGluZyB2aWV3LiBPbWl0IHdoZW4gdGhlIGZlbmNlIGlzIHJlcGxhY2VkIGluIHJlYWRpbmcgdmlldyBcdTIwMTRcbiAgICogZS5nLiBhIGZlbmNlIHJlbmRlcmVkIGFzIGEgYnV0dG9uLlxuICAgKi9cbiAgcmVhZG9ubHkgcHJpc21HcmFtbWFyPzogU3ludGF4SGlnaGxpZ2h0aW5nQ29tcG9uZW50R3JhbW1hclNvdXJjZSB8IHVuZGVmaW5lZDtcbn1cblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgU3ludGF4SGlnaGxpZ2h0aW5nQ29tcG9uZW50LnJlZ2lzdGVyUHJpc21MYW5ndWFnZUFzeW5jfS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBTeW50YXhIaWdobGlnaHRpbmdDb21wb25lbnRSZWdpc3RlclByaXNtTGFuZ3VhZ2VBc3luY1BhcmFtcyB7XG4gIC8qKlxuICAgKiBUaGUgZ3JhbW1hciB0byByZWdpc3Rlci5cbiAgICovXG4gIHJlYWRvbmx5IGdyYW1tYXI6IFN5bnRheEhpZ2hsaWdodGluZ0NvbXBvbmVudEdyYW1tYXJTb3VyY2U7XG5cbiAgLyoqXG4gICAqIFRoZSBsYW5ndWFnZSB0byByZWdpc3RlciB0aGUgZ3JhbW1hciBhcy5cbiAgICovXG4gIHJlYWRvbmx5IGxhbmd1YWdlOiBzdHJpbmc7XG59XG5cbi8qKlxuICogQSBjb21wb25lbnQgdGhhdCByZWdpc3RlcnMgYW5kIHVucmVnaXN0ZXJzIHN5bnRheCBoaWdobGlnaHRpbmcgbGFuZ3VhZ2VzLlxuICpcbiAqIEByZW1hcmtzXG4gKiBFdmVyeSByZWdpc3RyYXRpb24gaXMgdW5kb25lIHdoZW4gdGhlIGNvbXBvbmVudCBpcyB1bmxvYWRlZDogdGhlIHByZXZpb3VzIGVudHJ5IGlzIHJlc3RvcmVkIGlmIHRoZVxuICogbGFuZ3VhZ2Ugd2FzIGFscmVhZHkgcmVnaXN0ZXJlZCwgb3RoZXJ3aXNlIHRoZSBlbnRyeSBpcyByZW1vdmVkLlxuICovXG5leHBvcnQgY2xhc3MgU3ludGF4SGlnaGxpZ2h0aW5nQ29tcG9uZW50IGV4dGVuZHMgQ29tcG9uZW50RXgge1xuICAvKipcbiAgICogUmVnaXN0ZXJzIGEgZmVuY2VkIGNvZGUgYmxvY2sgbGFuZ3VhZ2UsIGhpZ2hsaWdodGluZyBpdCBpbiB0aGUgZWRpdG9yIGFuZCwgb3B0aW9uYWxseSwgaW4gcmVhZGluZyB2aWV3LlxuICAgKlxuICAgKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBhcmFtZXRlcnMgZm9yIHJlZ2lzdGVyaW5nIHRoZSBsYW5ndWFnZS5cbiAgICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyB3aGVuIHRoZSBsYW5ndWFnZSBpcyByZWdpc3RlcmVkLlxuICAgKlxuICAgKiBAZXhhbXBsZVxuICAgKiBgYGB0c1xuICAgKiBhd2FpdCBjb21wb25lbnQucmVnaXN0ZXJDb2RlQmxvY2tMYW5ndWFnZUFzeW5jKHtcbiAgICogICBlZGl0b3JNb2RlOiAndGV4dC90eXBlc2NyaXB0JyxcbiAgICogICBsYW5ndWFnZTogJ215LWxhbmd1YWdlJyxcbiAgICogICBwcmlzbUdyYW1tYXI6ICd0eXBlc2NyaXB0J1xuICAgKiB9KTtcbiAgICogYGBgXG4gICAqL1xuICBwdWJsaWMgYXN5bmMgcmVnaXN0ZXJDb2RlQmxvY2tMYW5ndWFnZUFzeW5jKHBhcmFtczogU3ludGF4SGlnaGxpZ2h0aW5nQ29tcG9uZW50UmVnaXN0ZXJDb2RlQmxvY2tMYW5ndWFnZUFzeW5jUGFyYW1zKTogUHJvbWlzZTx2b2lkPiB7XG4gICAgY29uc3Qge1xuICAgICAgZWRpdG9yTW9kZSxcbiAgICAgIGxhbmd1YWdlLFxuICAgICAgcHJpc21HcmFtbWFyXG4gICAgfSA9IHBhcmFtcztcblxuICAgIHRoaXMuZW5zdXJlTG9hZGVkKCk7XG5cbiAgICBpZiAocHJpc21HcmFtbWFyICE9PSB1bmRlZmluZWQpIHtcbiAgICAgIGF3YWl0IHRoaXMucmVnaXN0ZXJQcmlzbUxhbmd1YWdlQXN5bmMoe1xuICAgICAgICBncmFtbWFyOiBwcmlzbUdyYW1tYXIsXG4gICAgICAgIGxhbmd1YWdlXG4gICAgICB9KTtcbiAgICB9XG5cbiAgICB0aGlzLmVuc3VyZUxvYWRlZCgpO1xuXG4gICAgY29uc3QgcHJldmlvdXNNb2RlRmFjdG9yeSA9IHdpbmRvdy5Db2RlTWlycm9yLm1vZGVzW2xhbmd1YWdlXTtcbiAgICB3aW5kb3cuQ29kZU1pcnJvci5kZWZpbmVNb2RlKGxhbmd1YWdlLCAoY29uZmlnKSA9PiB3aW5kb3cuQ29kZU1pcnJvci5nZXRNb2RlKGNvbmZpZywgZWRpdG9yTW9kZSkpO1xuXG4gICAgdGhpcy5yZWdpc3RlcigoKSA9PiB7XG4gICAgICBpZiAocHJldmlvdXNNb2RlRmFjdG9yeSAhPT0gdW5kZWZpbmVkKSB7XG4gICAgICAgIHdpbmRvdy5Db2RlTWlycm9yLm1vZGVzW2xhbmd1YWdlXSA9IHByZXZpb3VzTW9kZUZhY3Rvcnk7XG4gICAgICAgIHJldHVybjtcbiAgICAgIH1cblxuICAgICAgLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9uby1keW5hbWljLWRlbGV0ZSAtLSBUaGUgbGFuZ3VhZ2UgaXMgb25seSBrbm93biBhdCBydW50aW1lLlxuICAgICAgZGVsZXRlIHdpbmRvdy5Db2RlTWlycm9yLm1vZGVzW2xhbmd1YWdlXTtcbiAgICB9KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgYSBQcmlzbSBsYW5ndWFnZSwgaGlnaGxpZ2h0aW5nIGl0IGV2ZXJ5d2hlcmUgUHJpc20gcmVuZGVycyBjb2RlIFx1MjAxNCByZWFkaW5nIHZpZXcgYW5kIHRoZVxuICAgKiB7QGxpbmsgQ29kZUhpZ2hsaWdodGVyQ29tcG9uZW50fSBzZXR0aW5ncyBmaWVsZC5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIGZvciByZWdpc3RlcmluZyB0aGUgbGFuZ3VhZ2UuXG4gICAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgd2hlbiB0aGUgbGFuZ3VhZ2UgaXMgcmVnaXN0ZXJlZC5cbiAgICpcbiAgICogQGV4YW1wbGVcbiAgICogYGBgdHNcbiAgICogYXdhaXQgY29tcG9uZW50LnJlZ2lzdGVyUHJpc21MYW5ndWFnZUFzeW5jKHtcbiAgICogICBncmFtbWFyOiB7XG4gICAqICAgICBrZXl3b3JkOiAvXFxiZm9vXFxiL1xuICAgKiAgIH0sXG4gICAqICAgbGFuZ3VhZ2U6ICdteS1sYW5ndWFnZSdcbiAgICogfSk7XG4gICAqIGBgYFxuICAgKi9cbiAgcHVibGljIGFzeW5jIHJlZ2lzdGVyUHJpc21MYW5ndWFnZUFzeW5jKHBhcmFtczogU3ludGF4SGlnaGxpZ2h0aW5nQ29tcG9uZW50UmVnaXN0ZXJQcmlzbUxhbmd1YWdlQXN5bmNQYXJhbXMpOiBQcm9taXNlPHZvaWQ+IHtcbiAgICBjb25zdCB7XG4gICAgICBncmFtbWFyLFxuICAgICAgbGFuZ3VhZ2VcbiAgICB9ID0gcGFyYW1zO1xuXG4gICAgdGhpcy5lbnN1cmVMb2FkZWQoKTtcblxuICAgIGNvbnN0IHByaXNtID0gYXdhaXQgbG9hZFByaXNtKCk7XG5cbiAgICAvLyBUaGUgY29tcG9uZW50IG1pZ2h0IGhhdmUgYmVlbiB1bmxvYWRlZCB3aGlsZSBQcmlzbSB3YXMgbG9hZGluZy5cbiAgICB0aGlzLmVuc3VyZUxvYWRlZCgpO1xuXG4gICAgY29uc3QgcHJldmlvdXNHcmFtbWFyID0gcHJpc20ubGFuZ3VhZ2VzW2xhbmd1YWdlXTtcbiAgICBwcmlzbS5sYW5ndWFnZXNbbGFuZ3VhZ2VdID0gdGhpcy5yZXNvbHZlR3JhbW1hcihwcmlzbSwgZ3JhbW1hcik7XG5cbiAgICB0aGlzLnJlZ2lzdGVyKCgpID0+IHtcbiAgICAgIGlmIChwcmV2aW91c0dyYW1tYXIgIT09IHVuZGVmaW5lZCkge1xuICAgICAgICBwcmlzbS5sYW5ndWFnZXNbbGFuZ3VhZ2VdID0gcHJldmlvdXNHcmFtbWFyO1xuICAgICAgICByZXR1cm47XG4gICAgICB9XG5cbiAgICAgIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBAdHlwZXNjcmlwdC1lc2xpbnQvbm8tZHluYW1pYy1kZWxldGUgLS0gVGhlIGxhbmd1YWdlIGlzIG9ubHkga25vd24gYXQgcnVudGltZS5cbiAgICAgIGRlbGV0ZSBwcmlzbS5sYW5ndWFnZXNbbGFuZ3VhZ2VdO1xuICAgIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIFJldHVybnMgdGhlIGdyYW1tYXIgb2YgYW4gYWxyZWFkeSByZWdpc3RlcmVkIFByaXNtIGxhbmd1YWdlLlxuICAgKlxuICAgKiBAcGFyYW0gcHJpc20gLSBUaGUgbG9hZGVkIFByaXNtIG1vZHVsZS5cbiAgICogQHBhcmFtIGxhbmd1YWdlIC0gVGhlIGxhbmd1YWdlIHRvIGxvb2sgdXAuXG4gICAqIEByZXR1cm5zIFRoZSBncmFtbWFyIG9mIHRoZSBsYW5ndWFnZS5cbiAgICogQHRocm93cyBBbiB7QGxpbmsgRXJyb3J9IGlmIHRoZSBsYW5ndWFnZSBpcyBub3QgcmVnaXN0ZXJlZC5cbiAgICovXG4gIHByaXZhdGUgcmVxdWlyZVByaXNtTGFuZ3VhZ2UocHJpc206IFByaXNtTW9kdWxlLCBsYW5ndWFnZTogc3RyaW5nKTogR3JhbW1hciB7XG4gICAgcmV0dXJuIHByaXNtLmxhbmd1YWdlc1tsYW5ndWFnZV0gPz8gdGhyb3dFeHByZXNzaW9uKG5ldyBFcnJvcihgUHJpc20gbGFuZ3VhZ2UgXCIke2xhbmd1YWdlfVwiIGlzIG5vdCByZWdpc3RlcmVkLmApKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZXNvbHZlcyBhIGdyYW1tYXIgc291cmNlIGludG8gdGhlIGdyYW1tYXIgdG8gcmVnaXN0ZXIuXG4gICAqXG4gICAqIEBwYXJhbSBwcmlzbSAtIFRoZSBsb2FkZWQgUHJpc20gbW9kdWxlLlxuICAgKiBAcGFyYW0gZ3JhbW1hclNvdXJjZSAtIFRoZSBncmFtbWFyIHNvdXJjZSB0byByZXNvbHZlLlxuICAgKiBAcmV0dXJucyBUaGUgcmVzb2x2ZWQgZ3JhbW1hci5cbiAgICovXG4gIHByaXZhdGUgcmVzb2x2ZUdyYW1tYXIocHJpc206IFByaXNtTW9kdWxlLCBncmFtbWFyU291cmNlOiBTeW50YXhIaWdobGlnaHRpbmdDb21wb25lbnRHcmFtbWFyU291cmNlKTogR3JhbW1hciB7XG4gICAgaWYgKHR5cGVvZiBncmFtbWFyU291cmNlID09PSAnc3RyaW5nJykge1xuICAgICAgcmV0dXJuIHRoaXMucmVxdWlyZVByaXNtTGFuZ3VhZ2UocHJpc20sIGdyYW1tYXJTb3VyY2UpO1xuICAgIH1cblxuICAgIGlmICh0eXBlb2YgZ3JhbW1hclNvdXJjZSA9PT0gJ2Z1bmN0aW9uJykge1xuICAgICAgcmV0dXJuIGdyYW1tYXJTb3VyY2Uoe1xuICAgICAgICBwcmlzbSxcbiAgICAgICAgcmVxdWlyZVByaXNtTGFuZ3VhZ2U6IChsYW5ndWFnZSkgPT4gdGhpcy5yZXF1aXJlUHJpc21MYW5ndWFnZShwcmlzbSwgbGFuZ3VhZ2UpXG4gICAgICB9KTtcbiAgICB9XG5cbiAgICByZXR1cm4gZ3JhbW1hclNvdXJjZTtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUF1Q0EsU0FBUyxpQkFBaUI7QUFLMUIsU0FBUyx1QkFBdUI7QUFDaEMsU0FBUyxtQkFBbUI7QUFzRXJCLE1BQU0sb0NBQW9DLFlBQVk7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQWdCM0QsTUFBYSwrQkFBK0IsUUFBd0Y7QUFDbEksVUFBTTtBQUFBLE1BQ0o7QUFBQSxNQUNBO0FBQUEsTUFDQTtBQUFBLElBQ0YsSUFBSTtBQUVKLFNBQUssYUFBYTtBQUVsQixRQUFJLGlCQUFpQixRQUFXO0FBQzlCLFlBQU0sS0FBSywyQkFBMkI7QUFBQSxRQUNwQyxTQUFTO0FBQUEsUUFDVDtBQUFBLE1BQ0YsQ0FBQztBQUFBLElBQ0g7QUFFQSxTQUFLLGFBQWE7QUFFbEIsVUFBTSxzQkFBc0IsT0FBTyxXQUFXLE1BQU0sUUFBUTtBQUM1RCxXQUFPLFdBQVcsV0FBVyxVQUFVLENBQUMsV0FBVyxPQUFPLFdBQVcsUUFBUSxRQUFRLFVBQVUsQ0FBQztBQUVoRyxTQUFLLFNBQVMsTUFBTTtBQUNsQixVQUFJLHdCQUF3QixRQUFXO0FBQ3JDLGVBQU8sV0FBVyxNQUFNLFFBQVEsSUFBSTtBQUNwQztBQUFBLE1BQ0Y7QUFHQSxhQUFPLE9BQU8sV0FBVyxNQUFNLFFBQVE7QUFBQSxJQUN6QyxDQUFDO0FBQUEsRUFDSDtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQW1CQSxNQUFhLDJCQUEyQixRQUFvRjtBQUMxSCxVQUFNO0FBQUEsTUFDSjtBQUFBLE1BQ0E7QUFBQSxJQUNGLElBQUk7QUFFSixTQUFLLGFBQWE7QUFFbEIsVUFBTSxRQUFRLE1BQU0sVUFBVTtBQUc5QixTQUFLLGFBQWE7QUFFbEIsVUFBTSxrQkFBa0IsTUFBTSxVQUFVLFFBQVE7QUFDaEQsVUFBTSxVQUFVLFFBQVEsSUFBSSxLQUFLLGVBQWUsT0FBTyxPQUFPO0FBRTlELFNBQUssU0FBUyxNQUFNO0FBQ2xCLFVBQUksb0JBQW9CLFFBQVc7QUFDakMsY0FBTSxVQUFVLFFBQVEsSUFBSTtBQUM1QjtBQUFBLE1BQ0Y7QUFHQSxhQUFPLE1BQU0sVUFBVSxRQUFRO0FBQUEsSUFDakMsQ0FBQztBQUFBLEVBQ0g7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFVUSxxQkFBcUIsT0FBb0IsVUFBMkI7QUFDMUUsV0FBTyxNQUFNLFVBQVUsUUFBUSxLQUFLLGdCQUFnQixJQUFJLE1BQU0sbUJBQW1CLFFBQVEsc0JBQXNCLENBQUM7QUFBQSxFQUNsSDtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFTUSxlQUFlLE9BQW9CLGVBQWtFO0FBQzNHLFFBQUksT0FBTyxrQkFBa0IsVUFBVTtBQUNyQyxhQUFPLEtBQUsscUJBQXFCLE9BQU8sYUFBYTtBQUFBLElBQ3ZEO0FBRUEsUUFBSSxPQUFPLGtCQUFrQixZQUFZO0FBQ3ZDLGFBQU8sY0FBYztBQUFBLFFBQ25CO0FBQUEsUUFDQSxzQkFBc0IsQ0FBQyxhQUFhLEtBQUsscUJBQXFCLE9BQU8sUUFBUTtBQUFBLE1BQy9FLENBQUM7QUFBQSxJQUNIO0FBRUEsV0FBTztBQUFBLEVBQ1Q7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/obsidian/plugin/plugin-settings-tab.d.mts

@@ -5,12 +5,13 @@
  * This module defines a base class for creating plugin setting tabs in Obsidian.
  * It provides a utility method to bind value components to plugin settings and handle changes.
  */
-import type { Plugin } from 'obsidian';
-import type { ConditionalKeys, Promisable, ReadonlyDeep } from 'type-fest';
+import type { Plugin, SettingDefinitionGroup, SettingDefinitionItem, SettingDefinitionRender, SettingGroup } from 'obsidian';
+import type { ConditionalKeys, Except, Promisable, ReadonlyDeep } from 'type-fest';
 import { PluginSettingTab } from 'obsidian';
 import type { StringKeys } from '../../type.mjs';
 import type { PluginSettingsComponentBase, ReadonlyPluginSettingsState } from '../components/plugin-settings-component.mjs';
 import type { ValueComponentWithChangeTracking } from '../setting-components/value-component-with-change-tracking.mjs';
+import type { SettingEx } from '../setting-ex.mjs';
 import type { ValidationMessageHolder } from '../validation.mjs';
 /**
  * A context passed to the {@link PluginSettingsComponentBase.saveToFile} method.
@@ -120,6 +121,60 @@ export interface PluginSettingsTabBaseConstructorParams<PluginSettings extends o
      */
     readonly pluginSettingsComponent: PluginSettingsComponentBase<PluginSettings>;
 }
+/**
+ * Params for {@link PluginSettingsTabBase.settingEx}.
+ */
+export interface PluginSettingsTabBaseSettingExParams {
+    /**
+     * Additional search terms for the setting.
+     */
+    readonly aliases?: string[];
+    /**
+     * The description of the setting. Used for rendering; the text content of a fragment is used for search.
+     */
+    readonly desc?: DocumentFragment | string;
+    /**
+     * Whether the setting row is disabled.
+     *
+     * A function form is re-evaluated on every render AND on every {@link PluginSettingsTabBase.refreshDomState}
+     * call, so it can reflect runtime state. Obsidian applies it with `Setting.setDisabled`, which disables the
+     * row and every component registered on it.
+     */
+    readonly disabled?: (() => boolean) | boolean;
+    /**
+     * The display name of the setting. Used for rendering and search.
+     */
+    readonly name: string;
+    /**
+     * Renders the setting row imperatively, typically via the {@link SettingEx} adders and
+     * {@link PluginSettingsTabBase.bind}.
+     *
+     * The setting Obsidian creates for the row is adopted into a {@link SettingEx} before it is handed over, so
+     * an imperative row body carries over unchanged. May return a cleanup function, invoked before the row is
+     * torn down or re-rendered.
+     *
+     * @param setting - The setting to render into.
+     * @param group - The group the setting belongs to.
+     * @returns An optional cleanup function.
+     */
+    render(setting: SettingEx, group: SettingGroup): (() => void) | void;
+    /**
+     * Controls whether the setting is included in the settings search. Defaults to `true`.
+     */
+    readonly searchable?: (() => boolean) | boolean;
+    /**
+     * Controls whether the setting row is rendered. A function form is re-evaluated on every render and on
+     * every {@link PluginSettingsTabBase.refreshDomState} call. Defaults to `true`.
+     */
+    readonly visible?: (() => boolean) | boolean;
+}
+/**
+ * Params for {@link PluginSettingsTabBase.settingGroupEx}.
+ *
+ * Every member of {@link SettingDefinitionGroup} except its discriminator, which
+ * {@link PluginSettingsTabBase.settingGroupEx} sets.
+ */
+export type PluginSettingsTabBaseSettingGroupExParams = Except<SettingDefinitionGroup, 'type'>;
 interface PluginSettingsTabBaseEventMap {
     validationMessageChanged: [propertyName: string, validationMessage: string];
 }
@@ -149,6 +204,7 @@ export declare abstract class PluginSettingsTabBase<PluginSettings extends objec
     protected get saveSettingsDebounceTimeoutInMilliseconds(): number;
     private _isOpen;
     private readonly component;
+    private currentRenderComponent;
     private readonly saveSettingsDebounced;
     private get pluginSettings();
     /**
@@ -181,11 +237,33 @@ export declare abstract class PluginSettingsTabBase<PluginSettings extends objec
      */
     display(): void;
     /**
-     * Legacy way to render the plugin settings tab.
+     * Legacy way to render the plugin settings tab imperatively.
      *
-     * Temporary workaround to avoid dealing with `@deprecated`.
+     * The pre-declarative fallback: Obsidian only calls it when {@link getSettingDefinitions} returns an empty
+     * array, i.e. when the consumer has not overridden {@link getSettingDefinitionItems}. Such a consumer
+     * overrides this method and builds the UI with {@link SettingEx} and {@link bind}.
      */
     displayLegacy(): void;
+    /**
+     * Reads the value backing a native `control` setting definition.
+     *
+     * Obsidian calls it on every render of a `control`-type definition. The inherited implementation reads
+     * `plugin.settings`, which a plugin built on {@link PluginSettingsComponentBase} never populates, so it is
+     * routed to the settings component instead.
+     *
+     * @param key - The settings property name.
+     * @returns The current value.
+     */
+    getControlValue(key: string): unknown;
+    /**
+     * Returns the declarative setting definitions rendered by Obsidian 1.13+.
+     *
+     * Delegates to {@link getSettingDefinitionItems}. When a consumer has not overridden that hook it returns
+     * an empty array, and Obsidian falls back to the imperative {@link displayLegacy} path.
+     *
+     * @returns The setting definitions.
+     */
+    getSettingDefinitions(): SettingDefinitionItem[];
     /**
      * Hides the plugin settings tab.
      */
@@ -196,10 +274,50 @@ export declare abstract class PluginSettingsTabBase<PluginSettings extends objec
      * @returns A {@link Promise} that resolves when the settings tab is hidden.
      */
     hideAsync(): Promise<void>;
+    /**
+     * Re-renders the settings tab after the underlying state changed.
+     *
+     * Rebuilds the definitions and re-renders, which covers both paths: Obsidian renders the declarative
+     * definitions when {@link getSettingDefinitionItems} provides them, and falls back to
+     * {@link displayLegacy} when it does not. Nothing is rendered while the tab is not the one on screen.
+     *
+     * Use it only for changes that alter the STRUCTURE of the tab — rows added or removed. When only a
+     * {@link PluginSettingsTabBaseSettingExParams.disabled} / {@link PluginSettingsTabBaseSettingExParams.visible}
+     * predicate has to be re-evaluated, call the much cheaper {@link refreshDomState} instead, which toggles the
+     * rendered DOM in place.
+     */
+    refresh(): void;
+    /**
+     * Persists the value of a native `control` setting definition.
+     *
+     * The counterpart of {@link getControlValue}: it routes the write to the settings component instead of the
+     * inherited `plugin.saveData` path, so validation, transformers and the debounced save all apply as they do
+     * for a {@link bind}-ed component.
+     *
+     * @param key - The settings property name.
+     * @param value - The value to persist.
+     * @returns A {@link Promise} that resolves when the value is set.
+     */
+    setControlValue(key: string, value: unknown): Promise<void>;
     /**
      * Shows the plugin settings tab.
      */
     show(): void;
+    /**
+     * The declarative setting definitions for the tab (Obsidian 1.13+).
+     *
+     * Consumers override this, typically building each row with {@link settingEx} and {@link bind} and grouping
+     * them with `settingGroupEx`. Returning an empty array — the default — makes Obsidian fall back to the
+     * imperative {@link displayLegacy} path.
+     *
+     * MUST be a pure builder. Obsidian calls it when the tab is registered (`addSettingTab`), long before the
+     * tab is ever opened, in order to index the settings for search. Anything with a side effect belongs inside
+     * a row's {@link PluginSettingsTabBaseSettingExParams.render} callback, which runs only when the row is
+     * actually rendered.
+     *
+     * @returns The setting definitions.
+     */
+    protected getSettingDefinitionItems(): SettingDefinitionItem[];
     /**
      * Called when the plugin settings are loaded.
      *
@@ -214,8 +332,37 @@ export declare abstract class PluginSettingsTabBase<PluginSettings extends objec
      * @returns A {@link Promise} that resolves when the settings are revalidated.
      */
     protected revalidate(): Promise<void>;
+    /**
+     * Builds a search-indexable declarative row that is rendered imperatively.
+     *
+     * The bridge between the declarative API and ODU's imperative building blocks: Obsidian owns the row (so it
+     * indexes it for search and evaluates its {@link PluginSettingsTabBaseSettingExParams.visible} /
+     * {@link PluginSettingsTabBaseSettingExParams.disabled} predicates on every
+     * {@link refreshDomState}), while {@link PluginSettingsTabBaseSettingExParams.render} fills it in with
+     * {@link SettingEx} adders and {@link bind} exactly as an imperative tab would.
+     *
+     * @param params - The row params.
+     * @returns The setting definition.
+     */
+    protected settingEx(params: PluginSettingsTabBaseSettingExParams): SettingDefinitionRender;
+    /**
+     * Builds a declarative heading group.
+     *
+     * The declarative counterpart of `SettingGroupEx`: where that class appends a group to a container
+     * imperatively, this returns the definition Obsidian renders, so a group-structured tab keeps its shape
+     * after the migration.
+     *
+     * @param params - The group params.
+     * @returns The group definition.
+     */
+    protected settingGroupEx(params: PluginSettingsTabBaseSettingGroupExParams): SettingDefinitionGroup;
+    private beginRenderCycle;
+    private createRenderComponent;
+    private endRenderCycle;
     private getPluginSettingsProperty;
+    private getRenderComponent;
     private onSaveSettings;
+    private renderSettingEx;
     private updateValidations;
 }
 export {};