@mnaoumov/obsidian-lib 10.10.0 → 10.12.0

package/dist/lib/cjs/__merged.d.cts

@@ -9,7 +9,8 @@ export { getIndexedBacklinksForFile, iterateReferencesAffectedByRename } from '.
 export { renderBacklinksTable, renderDelayedBacklinks, renderDelayedBacklinksForFolder } from './backlink.cjs';
 export { PluginBasesViewRegistrar } from './bases-view-registrar.cjs';
 export { BrokenLinkCandidateFinder, BrokenLinkEvidenceKind, getParentPath, getPathMapping } from './broken-link-candidates.cjs';
-export { BUG_REPORT_ISSUE_FORM_TEMPLATE, BugReportIssueFormFieldId, formatBugReportEnvironment, getBugReportEnvironment, getBugReportIssueFormUrl, getGitHubIssueFormUrl } from './bug-report.cjs';
+export { BugReportLogBuffer, createSettingsDiagnosticSection, DEFAULT_BUG_REPORT_LOG_MAX_ENTRIES, DEFAULT_BUG_REPORT_LOG_MAX_ENTRY_LENGTH, formatBugReportDiagnostics, getMarkdownFence, REDACTED_VALUE, redactSettings } from './bug-report-diagnostics.cjs';
+export { BUG_REPORT_ISSUE_FORM_TEMPLATE, BUG_REPORT_PASTE_INSTRUCTIONS, BugReportIssueFormFieldId, buildBugReportIssueFormLink, DEFAULT_BUG_REPORT_MAX_URL_LENGTH, formatBugReportEnvironment, getBugReportEnvironment, getBugReportIssueFormUrl, getGitHubIssueFormUrl } from './bug-report.cjs';
 export { BULK_OPERATION_HOLD_INTERVAL_IN_MILLISECONDS, holdBulkOperationWhile, registerBulkOperationProgressListener, reportBulkOperationProgress } from './bulk-operation-progress.cjs';
 export { buildBeforeOperationCommitSubject, buildOperationCommitMessage, BULK_OPERATION_LOCK_FILE_NAME, BULK_OPERATION_LOCK_STALE_AFTER_IN_MILLISECONDS, formatOperationId, getNextOperationId, isBulkOperationLock, isBulkOperationLockStale, OPERATION_TRAILER_KEY, parseBulkOperationCommit, parseOperationNumber, PLUGIN_TRAILER_KEY } from './bulk-operation.cjs';
 export { CalloutMode, renderCallout, wrapForCallout } from './callout.cjs';
@@ -42,6 +43,7 @@ export { PluginCommandRegistrar } from './command-registrar.cjs';
 export { configureCommunityPlugin, ConfigureCommunityPluginResult, disableCommunityPlugin, enableCommunityPlugin, getCommunityPluginRepo, getLatestReleaseVersion, installCommunityPlugin, installConfigureEnableCommunityPlugin, PluginEnableRefusedError, searchCommunityPlugins, toggleEnableCommunityPlugin, toggleInstallCommunityPlugin, uninstallCommunityPlugin, updateCommunityPlugin, UpdateCommunityPluginResult } from './community-plugins.cjs';
 export { AbortSignalComponent } from './components/abort-signal-component.cjs';
 export { AllWindowsEventComponent, forEachWindow, registerBodyClass } from './components/all-windows-event-component.cjs';
+export { AllWindowsStatusBarItemComponent, getPluginStatusBarItemCssClass, registerAllWindowsStatusBarItem, WINDOW_STATUS_BAR_CSS_CLASS } from './components/all-windows-status-bar-item-component.cjs';
 export { AsyncErrorHandlerComponent } from './components/async-error-handler-component.cjs';
 export { registerAsyncEvent } from './components/async-events-component.cjs';
 export { BulkOperationCommitComponent } from './components/bulk-operation-commit-component.cjs';
@@ -73,12 +75,14 @@ export { EmptyFolderBehavior, RenameDeleteHandlerComponent } from './components/
 export { NOT_EMPTY_DIRECTORY_ERROR_CODE, RmdirGuardComponent } from './components/rmdir-guard-component.cjs';
 export { SettingsFacetComponent } from './components/settings-facet-component.cjs';
 export { SettingsMigrationComponent } from './components/settings-migration-component.cjs';
+export { SharedComponentPoolComponent } from './components/shared-component-pool-component.cjs';
 export { registerStyle, StyleSheetComponent } from './components/style-sheet-component.cjs';
 export { SyntaxHighlightingComponent } from './components/syntax-highlighting-component.cjs';
 export { TemplatesLanguageComponent } from './components/templates-language-component.cjs';
+export { parseWorkspaceLayoutStateRecord, serializeWorkspaceLayoutStateRecord, WORKSPACE_LAYOUT_STATE_LAYOUT_KEY, WorkspaceLayoutStateComponent } from './components/workspace-layout-state-component.cjs';
 export { getDomEventsHandlersConstructor } from './constructors/get-dom-events-handlers-constructor.cjs';
 export { CssClass } from './css-class.cjs';
-export { PluginDataHandler } from './data-handler.cjs';
+export { DEFAULT_PLUGIN_DATA_MAX_SIZE_IN_BYTES, PluginDataHandler, PluginDataOperation, PluginDataSizeLimitExceededError } from './data-handler.cjs';
 export { DataStoreLocations } from './data-stores/data-store-locations.cjs';
 export { DataStoreReplica, isDataStoreJsonValue, isDataStoreOperation } from './data-stores/data-store-replica.cjs';
 export { DataStoreSeeds, validateDataStoreSeed } from './data-stores/data-store-seeds.cjs';
@@ -132,7 +136,7 @@ export { loop } from './loop.cjs';
 export { PluginMarkdownCodeBlockProcessorRegistrar } from './markdown-code-block-processor-registrar.cjs';
 export { getCodeBlockMarkdownInfo, insertAfterCodeBlock, insertBeforeCodeBlock, removeCodeBlock, replaceCodeBlock } from './markdown-code-block-processor.cjs';
 export { PluginMarkdownPostProcessorRegistrar } from './markdown-post-processor-registrar.cjs';
-export { getFullContentHtml } from './markdown-view.cjs';
+export { getFullContentHtml, rerenderPreviews } from './markdown-view.cjs';
 export { fullRender, markdownToHtml, registerLinkHandlers, renderExternalLink, renderInternalLink } from './markdown.cjs';
 export { addSingleChoiceMenuItems } from './menu.cjs';
 export { ADVANCED_METADATA_CACHE_PLUGIN_ID, BACKLINK_CACHE_PLUGIN_ID, CachedMetadataExFeature, ensureMetadataCacheReady, getBacklinksForFileOrPath, getBacklinksForFileSafe, getCacheSafe, getFrontmatterSafe, getReferences, hasBacklinkCachePlugin, isCachedMetadataEx, parseMetadata, registerFileCacheForNonExistingFile, registerFiles, unregisterFileCacheForNonExistingFile, unregisterFiles } from './metadata-cache.cjs';
@@ -140,10 +144,12 @@ export { getMobileAppInfo } from './mobile-app-info.cjs';
 export { alert } from './modals/alert.cjs';
 export { formatCodeBlock, showCodeBlockBuilder } from './modals/code-block-builder.cjs';
 export { confirm } from './modals/confirm.cjs';
+export { copyTextManually } from './modals/copy-text-manually.cjs';
 export { MinimizableModal } from './modals/minimizable-modal.cjs';
 export { ModalCommandBuilder, ModalCommandsRenderMode } from './modals/modal-command-builder.cjs';
 export { ModalBase, showModal } from './modals/modal.cjs';
 export { prompt } from './modals/prompt.cjs';
+export { reviewBugReportDiagnostics } from './modals/review-bug-report-diagnostics.cjs';
 export { selectItem } from './modals/select-item.cjs';
 export { selectOption } from './modals/select-option.cjs';
 export { SuggestModalCommandBuilder } from './modals/suggest-modal-command-builder.cjs';
@@ -161,7 +167,8 @@ export { findPluginApi, getValidatePluginApiPayloadsDebugSwitch, PluginApiPayloa
 export { DEFAULT_PLUGIN_ASYNC_CLEANUP_TIMEOUT_IN_MILLISECONDS, didPluginAsyncCleanupsSettle, hasPendingPluginAsyncCleanups, PLUGIN_ASYNC_CLEANUPS_STATE_KEY, registerPluginAsyncCleanup, trackPluginAsyncCleanup } from './plugin/plugin-async-cleanup.cjs';
 export { addPluginCssClasses, initDebugController, initPluginContext } from './plugin/plugin-context.cjs';
 export { PluginEventSourceImpl } from './plugin/plugin-event-source.cjs';
-export { getInstalledPluginState, getInstalledPluginVersion, installAndEnablePlugin, InstalledPluginState, updatePlugin } from './plugin/plugin-install-state.cjs';
+export { comparePluginVersionWithMinimum, getInstalledPluginState, getInstalledPluginVersion, installAndEnablePlugin, InstalledPluginState, PluginVersionComparison, updatePlugin } from './plugin/plugin-install-state.cjs';
+export { getLoadedPlugin, getPluginAvailability, PluginAvailability, PluginInstanceUnavailableError, requirePlugin, waitForPlugin } from './plugin/plugin-instance.cjs';
 export { PLUGIN_LOADED_EVENT_NAME, PLUGIN_UNLOADED_EVENT_NAME, triggerPluginLifecycleEvent } from './plugin/plugin-lifecycle-events.cjs';
 export { PluginSettingsTabBase, SAVE_TO_FILE_CONTEXT } from './plugin/plugin-settings-tab.cjs';
 export { PluginBase, reloadPlugin, showErrorAndDisablePlugin } from './plugin/plugin.cjs';
@@ -173,7 +180,9 @@ export { isPositionInOffsetRange, isPositionInside, isPositionInsideSome } from
 export { checkPropertyEntryMatches, isPropertyEntry, PROPERTY_ENTRY_PREFIX } from './property-entry.cjs';
 export { addToQueue, addToQueueAndWait, flushQueue } from './queue.cjs';
 export { AppContext, useApp } from './react/app-context.cjs';
+export { referenceDefinitionToFileChange } from './reference-definition.cjs';
 export { getReferenceLinkText, isCanvasFileNodeReference, isCanvasReference, isCanvasTextNodeReference, isReferenceInHeading, isReferenceInOffsetRange, referenceToFileChange, sortReferences } from './reference.cjs';
+export { computeSha256, ensureReleaseAsset, formatByteSize, getGitHubReleaseAssetUrl, ReleaseAssetChecksumError } from './release-asset.cjs';
 export { isOwnedByRenderedMarkdown, registerFoldHandlers, registerFootnoteLinkHandler } from './rendered-markdown.cjs';
 export { createRequestUrlFetch, encodeRequestUrlRequest, RequestUrlError, requestUrlEx, requestUrlStream } from './request-url.cjs';
 export { isResourceLockedForPath, isResourceLockedForPathByAncestor, lockResourceForPath, requestResourceUnlockForPath, ResourceLockComponent, ResourceLockedError, unlockResourceForPath } from './resource-lock.cjs';

package/dist/lib/cjs/bug-report-diagnostics.cjs

@@ -0,0 +1,222 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+(function patchObsidianRequire() {
+  const originalRequire = require;
+  if (!originalRequire || originalRequire.__isPatched) {
+    return;
+  }
+  require = Object.assign(
+    (id) => requirePatched(id),
+    originalRequire,
+    {
+      __isPatched: true
+    }
+  );
+  function extractDefault($module) {
+    return $module && $module.__esModule && "default" in $module ? $module.default : $module;
+  }
+  const OBSIDIAN_BUILT_IN_MODULE_NAMES = /* @__PURE__ */ new Set([
+    "@codemirror/autocomplete",
+    "@codemirror/collab",
+    "@codemirror/commands",
+    "@codemirror/language",
+    "@codemirror/lint",
+    "@codemirror/search",
+    "@codemirror/state",
+    "@codemirror/text",
+    "@codemirror/view",
+    "@lezer/common",
+    "@lezer/highlight",
+    "@lezer/lr",
+    "obsidian"
+  ]);
+  const DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES = /* @__PURE__ */ new Set([
+    "@codemirror/closebrackets",
+    "@codemirror/comment",
+    "@codemirror/fold",
+    "@codemirror/gutter",
+    "@codemirror/highlight",
+    "@codemirror/history",
+    "@codemirror/matchbrackets",
+    "@codemirror/panel",
+    "@codemirror/rangeset",
+    "@codemirror/rectangular-selection",
+    "@codemirror/stream-parser",
+    "@codemirror/tooltip"
+  ]);
+  function requirePatched(id) {
+    if (OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id) || DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id)) {
+      return originalRequire?.(id);
+    }
+    const app = globalThis.app;
+    if (app?.isMobile) {
+      if (id === "process" || id === "node:process") {
+        console.debug(`The most likely you can safely ignore this error. Module not found: ${id}. Fake process object is returned instead.`);
+        return process;
+      }
+    } else {
+      const $module = originalRequire?.(id);
+      if ($module) {
+        return extractDefault($module);
+      }
+    }
+    console.debug(`The most likely you can safely ignore this error. Module not found: ${id}. Empty object is returned instead.`);
+    return {};
+  }
+})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var bug_report_diagnostics_exports = {};
+__export(bug_report_diagnostics_exports, {
+  BugReportLogBuffer: () => BugReportLogBuffer,
+  DEFAULT_BUG_REPORT_LOG_MAX_ENTRIES: () => DEFAULT_BUG_REPORT_LOG_MAX_ENTRIES,
+  DEFAULT_BUG_REPORT_LOG_MAX_ENTRY_LENGTH: () => DEFAULT_BUG_REPORT_LOG_MAX_ENTRY_LENGTH,
+  REDACTED_VALUE: () => REDACTED_VALUE,
+  createSettingsDiagnosticSection: () => createSettingsDiagnosticSection,
+  formatBugReportDiagnostics: () => formatBugReportDiagnostics,
+  getMarkdownFence: () => getMarkdownFence,
+  redactSettings: () => redactSettings
+});
+module.exports = __toCommonJS(bug_report_diagnostics_exports);
+const REDACTED_VALUE = "[redacted]";
+const DEFAULT_BUG_REPORT_LOG_MAX_ENTRIES = 200;
+const DEFAULT_BUG_REPORT_LOG_MAX_ENTRY_LENGTH = 2e3;
+const JSON_INDENT = 2;
+const MIN_FENCE_LENGTH = 3;
+const TRUNCATION_MARKER = " [truncated]";
+class BugReportLogBuffer {
+  entries = [];
+  maxEntries;
+  maxEntryLength;
+  now;
+  /**
+   * Constructs a new instance.
+   *
+   * @param options - Constructor options.
+   */
+  constructor(options = {}) {
+    this.maxEntries = Math.max(1, Math.floor(options.maxEntries ?? DEFAULT_BUG_REPORT_LOG_MAX_ENTRIES));
+    this.maxEntryLength = Math.max(1, Math.floor(options.maxEntryLength ?? DEFAULT_BUG_REPORT_LOG_MAX_ENTRY_LENGTH));
+    this.now = options.now ?? (() => /* @__PURE__ */ new Date());
+  }
+  /**
+   * Adds an entry, stamped with the current time.
+   *
+   * @param message - The entry's text.
+   */
+  add(message) {
+    const text = message.length > this.maxEntryLength ? message.slice(0, this.maxEntryLength) + TRUNCATION_MARKER : message;
+    this.entries.push(`${this.now().toISOString()} ${text}`);
+    if (this.entries.length > this.maxEntries) {
+      this.entries.splice(0, this.entries.length - this.maxEntries);
+    }
+  }
+  /**
+   * Removes every entry.
+   */
+  clear() {
+    this.entries.length = 0;
+  }
+  /**
+   * Gets the entries, oldest first.
+   *
+   * @returns The entries.
+   */
+  getEntries() {
+    return [...this.entries];
+  }
+  /**
+   * Builds a potentially private diagnostic section holding the entries.
+   *
+   * @param options - The options.
+   * @returns The section.
+   */
+  toSection(options = {}) {
+    return {
+      content: this.entries.length === 0 ? "(no log entries)" : this.entries.join("\n"),
+      id: options.id ?? "logs",
+      isPotentiallyPrivate: true,
+      title: options.title ?? "Logs"
+    };
+  }
+}
+function createSettingsDiagnosticSection(params) {
+  return {
+    content: JSON.stringify(redactSettings(params.settings, params.secretKeys ?? []), null, JSON_INDENT) ?? "undefined",
+    id: params.id ?? "settings",
+    isPotentiallyPrivate: true,
+    title: params.title ?? "Plugin settings"
+  };
+}
+function formatBugReportDiagnostics(sections) {
+  return sections.map((section) => {
+    const fence = getMarkdownFence(section.content);
+    return `### ${section.title}
+
+${fence}
+${section.content}
+${fence}`;
+  }).join("\n\n");
+}
+function getMarkdownFence(content) {
+  let longestRun = 0;
+  for (const match of content.matchAll(/`+/g)) {
+    longestRun = Math.max(longestRun, match[0].length);
+  }
+  return "`".repeat(Math.max(MIN_FENCE_LENGTH, longestRun + 1));
+}
+function redactSettings(settings, secretKeys) {
+  const lowerCaseSecretKeys = new Set(secretKeys.map((key) => key.toLowerCase()));
+  return redactValue(settings, lowerCaseSecretKeys, /* @__PURE__ */ new WeakSet());
+}
+function redactValue(value, lowerCaseSecretKeys, seen) {
+  if (typeof value !== "object" || value === null) {
+    return value;
+  }
+  if (seen.has(value)) {
+    return "[circular]";
+  }
+  seen.add(value);
+  if (Array.isArray(value)) {
+    const result2 = value.map((item) => redactValue(item, lowerCaseSecretKeys, seen));
+    seen.delete(value);
+    return result2;
+  }
+  const result = {};
+  for (const [key, child] of Object.entries(value)) {
+    result[key] = lowerCaseSecretKeys.has(key.toLowerCase()) ? REDACTED_VALUE : redactValue(child, lowerCaseSecretKeys, seen);
+  }
+  seen.delete(value);
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BugReportLogBuffer,
+  DEFAULT_BUG_REPORT_LOG_MAX_ENTRIES,
+  DEFAULT_BUG_REPORT_LOG_MAX_ENTRY_LENGTH,
+  REDACTED_VALUE,
+  createSettingsDiagnosticSection,
+  formatBugReportDiagnostics,
+  getMarkdownFence,
+  redactSettings
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9idWctcmVwb3J0LWRpYWdub3N0aWNzLnRzIl0sInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBPcHRpb25hbCBkaWFnbm9zdGljcyBhIHBsdWdpbiBjYW4gYXR0YWNoIHRvIGEgYnVnIHJlcG9ydDogc2VjdGlvbnMgb2YgdGV4dCB0aGUgdXNlciByZXZpZXdzIGJlZm9yZVxuICogYW55dGhpbmcgbGVhdmVzIE9ic2lkaWFuLCBhIGJvdW5kZWQgbG9nIGJ1ZmZlciwgYW5kIHJlZGFjdGlvbiBvZiBhIHBsdWdpbidzIG93biBzZXR0aW5ncy5cbiAqXG4gKiBOb3RoaW5nIGhlcmUgcmVhZHMgbG9ncyBvciBzZXR0aW5ncyBieSBpdHNlbGYuIEEgbG9nIGJ1ZmZlciBob2xkcyBvbmx5IHdoYXQgdGhlIHBsdWdpbiB3cm90ZSB0byBpdCBzaW5jZVxuICogdGhlIGJ1ZmZlciB3YXMgY3JlYXRlZCwgbmV2ZXIgdGhlIGNvbnNvbGUncyBoaXN0b3J5LCBhbmQgYSBzZXR0aW5ncyBzZWN0aW9uIGhvbGRzIG9ubHkgdGhlIG9iamVjdCB0aGVcbiAqIHBsdWdpbiBoYW5kcyBvdmVyLiBSZWRhY3Rpb24gcmVwbGFjZXMgdGhlIHZhbHVlcyBvZiBjYWxsZXItZGVjbGFyZWQga2V5czsgaXQgaXMgbm90IGEgcHJvbWlzZSB0byBmaW5kXG4gKiBldmVyeSBzZWNyZXQsIHdoaWNoIGlzIHdoeSBldmVyeSBzZWN0aW9uIGlzIHNob3duIHRvIHRoZSB1c2VyLCBhbmQgYSBwb3RlbnRpYWxseSBwcml2YXRlIG9uZSBpcyBsZWZ0XG4gKiBvdXQgdW5sZXNzIHRoZSB1c2VyIGluY2x1ZGVzIGl0LlxuICovXG5cbi8qKlxuICogQSBzZWN0aW9uIG9mIGRpYWdub3N0aWNzIGZvciBhIGJ1ZyByZXBvcnQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQnVnUmVwb3J0RGlhZ25vc3RpY1NlY3Rpb24ge1xuICAvKipcbiAgICogVGhlIHNlY3Rpb24ncyB0ZXh0LCBzaG93biB0byB0aGUgdXNlciBhbmQgc2VudCBhcyB3cml0dGVuLlxuICAgKi9cbiAgcmVhZG9ubHkgY29udGVudDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBBIHN0YWJsZSBpZCwgdW5pcXVlIGFtb25nIHRoZSBzZWN0aW9ucyBvZiBvbmUgcmVwb3J0LlxuICAgKi9cbiAgcmVhZG9ubHkgaWQ6IHN0cmluZztcblxuICAvKipcbiAgICogV2hldGhlciB0aGUgc2VjdGlvbiBjYW4gaG9sZCBwcml2YXRlIGRhdGEsIHN1Y2ggYXMgbG9ncyBvciBzZXR0aW5ncy4gQSBwb3RlbnRpYWxseSBwcml2YXRlIHNlY3Rpb24gaXNcbiAgICogbGVmdCBvdXQgb2YgdGhlIHJlcG9ydCB1bmxlc3MgdGhlIHVzZXIgaW5jbHVkZXMgaXQuXG4gICAqXG4gICAqIEBkZWZhdWx0IGBmYWxzZWBcbiAgICovXG4gIHJlYWRvbmx5IGlzUG90ZW50aWFsbHlQcml2YXRlPzogYm9vbGVhbjtcblxuICAvKipcbiAgICogVGhlIHNlY3Rpb24ncyB0aXRsZS5cbiAgICovXG4gIHJlYWRvbmx5IHRpdGxlOiBzdHJpbmc7XG59XG5cbi8qKlxuICogQ29uc3RydWN0b3IgcGFyYW1ldGVycyBmb3Ige0BsaW5rIEJ1Z1JlcG9ydExvZ0J1ZmZlcn0uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQnVnUmVwb3J0TG9nQnVmZmVyQ29uc3RydWN0b3JPcHRpb25zIHtcbiAgLyoqXG4gICAqIFRoZSBtb3N0IGVudHJpZXMga2VwdC4gT2xkZXIgZW50cmllcyBhcmUgZHJvcHBlZCBmaXJzdC5cbiAgICpcbiAgICogQGRlZmF1bHQge0BsaW5rIERFRkFVTFRfQlVHX1JFUE9SVF9MT0dfTUFYX0VOVFJJRVN9XG4gICAqL1xuICByZWFkb25seSBtYXhFbnRyaWVzPzogbnVtYmVyO1xuXG4gIC8qKlxuICAgKiBUaGUgbW9zdCBjaGFyYWN0ZXJzIGtlcHQgb2Ygb25lIGVudHJ5LiBBIGxvbmdlciBlbnRyeSBpcyBjdXQsIGFuZCBzYXlzIHNvLlxuICAgKlxuICAgKiBAZGVmYXVsdCB7QGxpbmsgREVGQVVMVF9CVUdfUkVQT1JUX0xPR19NQVhfRU5UUllfTEVOR1RIfVxuICAgKi9cbiAgcmVhZG9ubHkgbWF4RW50cnlMZW5ndGg/OiBudW1iZXI7XG5cbiAgLyoqXG4gICAqIEdldHMgdGhlIGN1cnJlbnQgdGltZS4gRm9yIHRlc3RzLlxuICAgKlxuICAgKiBAZGVmYXVsdCBgKCkgPT4gbmV3IERhdGUoKWBcbiAgICovXG4gIHJlYWRvbmx5IG5vdz86ICgpID0+IERhdGU7XG59XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIEJ1Z1JlcG9ydExvZ0J1ZmZlci50b1NlY3Rpb259LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEJ1Z1JlcG9ydExvZ0J1ZmZlclRvU2VjdGlvbk9wdGlvbnMge1xuICAvKipcbiAgICogVGhlIHNlY3Rpb24ncyBpZC5cbiAgICpcbiAgICogQGRlZmF1bHQgYCdsb2dzJ2BcbiAgICovXG4gIHJlYWRvbmx5IGlkPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgc2VjdGlvbidzIHRpdGxlLlxuICAgKlxuICAgKiBAZGVmYXVsdCBgJ0xvZ3MnYFxuICAgKi9cbiAgcmVhZG9ubHkgdGl0bGU/OiBzdHJpbmc7XG59XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIGNyZWF0ZVNldHRpbmdzRGlhZ25vc3RpY1NlY3Rpb259LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIENyZWF0ZVNldHRpbmdzRGlhZ25vc3RpY1NlY3Rpb25QYXJhbXMge1xuICAvKipcbiAgICogVGhlIHNlY3Rpb24ncyBpZC5cbiAgICpcbiAgICogQGRlZmF1bHQgYCdzZXR0aW5ncydgXG4gICAqL1xuICByZWFkb25seSBpZD86IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIGtleXMgd2hvc2UgdmFsdWVzIGFyZSByZXBsYWNlZCB3aXRoIHtAbGluayBSRURBQ1RFRF9WQUxVRX0sIGF0IGFueSBkZXB0aCwgY29tcGFyZWQgd2l0aG91dCBjYXNlLlxuICAgKi9cbiAgcmVhZG9ubHkgc2VjcmV0S2V5cz86IHJlYWRvbmx5IHN0cmluZ1tdO1xuXG4gIC8qKlxuICAgKiBUaGUgcmVwb3J0aW5nIHBsdWdpbidzIG93biBzZXR0aW5ncywgc3VjaCBhcyBpdHMgYGRhdGEuanNvbmAuXG4gICAqL1xuICByZWFkb25seSBzZXR0aW5nczogdW5rbm93bjtcblxuICAvKipcbiAgICogVGhlIHNlY3Rpb24ncyB0aXRsZS5cbiAgICpcbiAgICogQGRlZmF1bHQgYCdQbHVnaW4gc2V0dGluZ3MnYFxuICAgKi9cbiAgcmVhZG9ubHkgdGl0bGU/OiBzdHJpbmc7XG59XG5cbi8qKlxuICogVGhlIHZhbHVlIHRoYXQgcmVwbGFjZXMgYSByZWRhY3RlZCBzZXR0aW5nLlxuICovXG5leHBvcnQgY29uc3QgUkVEQUNURURfVkFMVUUgPSAnW3JlZGFjdGVkXSc7XG5cbi8qKlxuICogVGhlIGRlZmF1bHQgbnVtYmVyIG9mIGVudHJpZXMgYSB7QGxpbmsgQnVnUmVwb3J0TG9nQnVmZmVyfSBrZWVwcy5cbiAqL1xuZXhwb3J0IGNvbnN0IERFRkFVTFRfQlVHX1JFUE9SVF9MT0dfTUFYX0VOVFJJRVMgPSAyMDA7XG5cbi8qKlxuICogVGhlIGRlZmF1bHQgbnVtYmVyIG9mIGNoYXJhY3RlcnMgYSB7QGxpbmsgQnVnUmVwb3J0TG9nQnVmZmVyfSBrZWVwcyBvZiBvbmUgZW50cnkuXG4gKi9cbmV4cG9ydCBjb25zdCBERUZBVUxUX0JVR19SRVBPUlRfTE9HX01BWF9FTlRSWV9MRU5HVEggPSAyMDAwO1xuXG5jb25zdCBKU09OX0lOREVOVCA9IDI7XG5jb25zdCBNSU5fRkVOQ0VfTEVOR1RIID0gMztcbmNvbnN0IFRSVU5DQVRJT05fTUFSS0VSID0gJyBbdHJ1bmNhdGVkXSc7XG5cbi8qKlxuICogQSBib3VuZGVkIGJ1ZmZlciBvZiBsb2cgZW50cmllcyBhIHBsdWdpbiB3cml0ZXMgZm9yIGl0cyBidWcgcmVwb3J0cy4gSXQga2VlcHMgb25seSB3aGF0IHRoZSBwbHVnaW4gYWRkc1xuICogYWZ0ZXIgY3JlYXRpbmcgaXQsIGF0IG1vc3Qge0BsaW5rIEJ1Z1JlcG9ydExvZ0J1ZmZlckNvbnN0cnVjdG9yT3B0aW9ucy5tYXhFbnRyaWVzfSBlbnRyaWVzLCBlYWNoIGN1dCB0b1xuICoge0BsaW5rIEJ1Z1JlcG9ydExvZ0J1ZmZlckNvbnN0cnVjdG9yT3B0aW9ucy5tYXhFbnRyeUxlbmd0aH0gY2hhcmFjdGVycy5cbiAqL1xuZXhwb3J0IGNsYXNzIEJ1Z1JlcG9ydExvZ0J1ZmZlciB7XG4gIHByaXZhdGUgcmVhZG9ubHkgZW50cmllczogc3RyaW5nW10gPSBbXTtcbiAgcHJpdmF0ZSByZWFkb25seSBtYXhFbnRyaWVzOiBudW1iZXI7XG4gIHByaXZhdGUgcmVhZG9ubHkgbWF4RW50cnlMZW5ndGg6IG51bWJlcjtcbiAgcHJpdmF0ZSByZWFkb25seSBub3c6ICgpID0+IERhdGU7XG5cbiAgLyoqXG4gICAqIENvbnN0cnVjdHMgYSBuZXcgaW5zdGFuY2UuXG4gICAqXG4gICAqIEBwYXJhbSBvcHRpb25zIC0gQ29uc3RydWN0b3Igb3B0aW9ucy5cbiAgICovXG4gIHB1YmxpYyBjb25zdHJ1Y3RvcihvcHRpb25zOiBCdWdSZXBvcnRMb2dCdWZmZXJDb25zdHJ1Y3Rvck9wdGlvbnMgPSB7fSkge1xuICAgIHRoaXMubWF4RW50cmllcyA9IE1hdGgubWF4KDEsIE1hdGguZmxvb3Iob3B0aW9ucy5tYXhFbnRyaWVzID8/IERFRkFVTFRfQlVHX1JFUE9SVF9MT0dfTUFYX0VOVFJJRVMpKTtcbiAgICB0aGlzLm1heEVudHJ5TGVuZ3RoID0gTWF0aC5tYXgoMSwgTWF0aC5mbG9vcihvcHRpb25zLm1heEVudHJ5TGVuZ3RoID8/IERFRkFVTFRfQlVHX1JFUE9SVF9MT0dfTUFYX0VOVFJZX0xFTkdUSCkpO1xuICAgIHRoaXMubm93ID0gb3B0aW9ucy5ub3cgPz8gKCgpOiBEYXRlID0+IG5ldyBEYXRlKCkpO1xuICB9XG5cbiAgLyoqXG4gICAqIEFkZHMgYW4gZW50cnksIHN0YW1wZWQgd2l0aCB0aGUgY3VycmVudCB0aW1lLlxuICAgKlxuICAgKiBAcGFyYW0gbWVzc2FnZSAtIFRoZSBlbnRyeSdzIHRleHQuXG4gICAqL1xuICBwdWJsaWMgYWRkKG1lc3NhZ2U6IHN0cmluZyk6IHZvaWQge1xuICAgIGNvbnN0IHRleHQgPSBtZXNzYWdlLmxlbmd0aCA+IHRoaXMubWF4RW50cnlMZW5ndGhcbiAgICAgID8gbWVzc2FnZS5zbGljZSgwLCB0aGlzLm1heEVudHJ5TGVuZ3RoKSArIFRSVU5DQVRJT05fTUFSS0VSXG4gICAgICA6IG1lc3NhZ2U7XG4gICAgdGhpcy5lbnRyaWVzLnB1c2goYCR7dGhpcy5ub3coKS50b0lTT1N0cmluZygpfSAke3RleHR9YCk7XG4gICAgaWYgKHRoaXMuZW50cmllcy5sZW5ndGggPiB0aGlzLm1heEVudHJpZXMpIHtcbiAgICAgIHRoaXMuZW50cmllcy5zcGxpY2UoMCwgdGhpcy5lbnRyaWVzLmxlbmd0aCAtIHRoaXMubWF4RW50cmllcyk7XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIFJlbW92ZXMgZXZlcnkgZW50cnkuXG4gICAqL1xuICBwdWJsaWMgY2xlYXIoKTogdm9pZCB7XG4gICAgdGhpcy5lbnRyaWVzLmxlbmd0aCA9IDA7XG4gIH1cblxuICAvKipcbiAgICogR2V0cyB0aGUgZW50cmllcywgb2xkZXN0IGZpcnN0LlxuICAgKlxuICAgKiBAcmV0dXJucyBUaGUgZW50cmllcy5cbiAgICovXG4gIHB1YmxpYyBnZXRFbnRyaWVzKCk6IHJlYWRvbmx5IHN0cmluZ1tdIHtcbiAgICByZXR1cm4gWy4uLnRoaXMuZW50cmllc107XG4gIH1cblxuICAvKipcbiAgICogQnVpbGRzIGEgcG90ZW50aWFsbHkgcHJpdmF0ZSBkaWFnbm9zdGljIHNlY3Rpb24gaG9sZGluZyB0aGUgZW50cmllcy5cbiAgICpcbiAgICogQHBhcmFtIG9wdGlvbnMgLSBUaGUgb3B0aW9ucy5cbiAgICogQHJldHVybnMgVGhlIHNlY3Rpb24uXG4gICAqL1xuICBwdWJsaWMgdG9TZWN0aW9uKG9wdGlvbnM6IEJ1Z1JlcG9ydExvZ0J1ZmZlclRvU2VjdGlvbk9wdGlvbnMgPSB7fSk6IEJ1Z1JlcG9ydERpYWdub3N0aWNTZWN0aW9uIHtcbiAgICByZXR1cm4ge1xuICAgICAgY29udGVudDogdGhpcy5lbnRyaWVzLmxlbmd0aCA9PT0gMCA/ICcobm8gbG9nIGVudHJpZXMpJyA6IHRoaXMuZW50cmllcy5qb2luKCdcXG4nKSxcbiAgICAgIGlkOiBvcHRpb25zLmlkID8/ICdsb2dzJyxcbiAgICAgIGlzUG90ZW50aWFsbHlQcml2YXRlOiB0cnVlLFxuICAgICAgdGl0bGU6IG9wdGlvbnMudGl0bGUgPz8gJ0xvZ3MnXG4gICAgfTtcbiAgfVxufVxuXG4vKipcbiAqIEJ1aWxkcyBhIHBvdGVudGlhbGx5IHByaXZhdGUgZGlhZ25vc3RpYyBzZWN0aW9uIGhvbGRpbmcgdGhlIHBsdWdpbidzIHNldHRpbmdzIGFzIEpTT04sIHdpdGggdGhlIHZhbHVlc1xuICogb2Yge0BsaW5rIENyZWF0ZVNldHRpbmdzRGlhZ25vc3RpY1NlY3Rpb25QYXJhbXMuc2VjcmV0S2V5c30gcmVkYWN0ZWQuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzLlxuICogQHJldHVybnMgVGhlIHNlY3Rpb24uXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBjcmVhdGVTZXR0aW5nc0RpYWdub3N0aWNTZWN0aW9uKHBhcmFtczogQ3JlYXRlU2V0dGluZ3NEaWFnbm9zdGljU2VjdGlvblBhcmFtcyk6IEJ1Z1JlcG9ydERpYWdub3N0aWNTZWN0aW9uIHtcbiAgcmV0dXJuIHtcbiAgICBjb250ZW50OiBKU09OLnN0cmluZ2lmeShyZWRhY3RTZXR0aW5ncyhwYXJhbXMuc2V0dGluZ3MsIHBhcmFtcy5zZWNyZXRLZXlzID8/IFtdKSwgbnVsbCwgSlNPTl9JTkRFTlQpID8/ICd1bmRlZmluZWQnLFxuICAgIGlkOiBwYXJhbXMuaWQgPz8gJ3NldHRpbmdzJyxcbiAgICBpc1BvdGVudGlhbGx5UHJpdmF0ZTogdHJ1ZSxcbiAgICB0aXRsZTogcGFyYW1zLnRpdGxlID8/ICdQbHVnaW4gc2V0dGluZ3MnXG4gIH07XG59XG5cbi8qKlxuICogUmVuZGVycyBkaWFnbm9zdGljIHNlY3Rpb25zIGFzIE1hcmtkb3duOiBhIGxldmVsLTMgaGVhZGluZyBhbmQgYSBmZW5jZWQgY29kZSBibG9jayBwZXIgc2VjdGlvbi4gVGhlXG4gKiBmZW5jZSBpcyBsb25nZXIgdGhhbiBhbnkgcnVuIG9mIGJhY2t0aWNrcyBpbiB0aGUgY29udGVudCwgc28gbm8gY29udGVudCBjYW4gY2xvc2UgaXQuXG4gKlxuICogQHBhcmFtIHNlY3Rpb25zIC0gVGhlIHNlY3Rpb25zLlxuICogQHJldHVybnMgVGhlIE1hcmtkb3duLCBvciBhbiBlbXB0eSBzdHJpbmcgd2hlbiB0aGVyZSBhcmUgbm8gc2VjdGlvbnMuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBmb3JtYXRCdWdSZXBvcnREaWFnbm9zdGljcyhzZWN0aW9uczogcmVhZG9ubHkgQnVnUmVwb3J0RGlhZ25vc3RpY1NlY3Rpb25bXSk6IHN0cmluZyB7XG4gIHJldHVybiBzZWN0aW9ucy5tYXAoKHNlY3Rpb24pID0+IHtcbiAgICBjb25zdCBmZW5jZSA9IGdldE1hcmtkb3duRmVuY2Uoc2VjdGlvbi5jb250ZW50KTtcbiAgICByZXR1cm4gYCMjIyAke3NlY3Rpb24udGl0bGV9XFxuXFxuJHtmZW5jZX1cXG4ke3NlY3Rpb24uY29udGVudH1cXG4ke2ZlbmNlfWA7XG4gIH0pLmpvaW4oJ1xcblxcbicpO1xufVxuXG4vKipcbiAqIEdldHMgYSBNYXJrZG93biBjb2RlIGZlbmNlIHRoYXQgdGhlIGdpdmVuIGNvbnRlbnQgY2Fubm90IGNsb3NlLlxuICpcbiAqIEBwYXJhbSBjb250ZW50IC0gVGhlIGNvbnRlbnQgdG8gZmVuY2UuXG4gKiBAcmV0dXJucyBBIHJ1biBvZiBiYWNrdGlja3MgbG9uZ2VyIHRoYW4gdGhlIGxvbmdlc3QgcnVuIGluIHRoZSBjb250ZW50LCBhbmQgYXQgbGVhc3QgdGhyZWUgbG9uZy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldE1hcmtkb3duRmVuY2UoY29udGVudDogc3RyaW5nKTogc3RyaW5nIHtcbiAgbGV0IGxvbmdlc3RSdW4gPSAwO1xuICBmb3IgKGNvbnN0IG1hdGNoIG9mIGNvbnRlbnQubWF0Y2hBbGwoL2ArL2cpKSB7XG4gICAgbG9uZ2VzdFJ1biA9IE1hdGgubWF4KGxvbmdlc3RSdW4sIG1hdGNoWzBdLmxlbmd0aCk7XG4gIH1cbiAgcmV0dXJuICdgJy5yZXBlYXQoTWF0aC5tYXgoTUlOX0ZFTkNFX0xFTkdUSCwgbG9uZ2VzdFJ1biArIDEpKTtcbn1cblxuLyoqXG4gKiBDb3BpZXMgc2V0dGluZ3MsIHJlcGxhY2luZyB0aGUgdmFsdWUgb2YgZXZlcnkga2V5IGluIGBzZWNyZXRLZXlzYCwgYXQgYW55IGRlcHRoIGFuZCBjb21wYXJlZCB3aXRob3V0XG4gKiBjYXNlLCB3aXRoIHtAbGluayBSRURBQ1RFRF9WQUxVRX0uIFRoZSBvcmlnaW5hbCBpcyBub3QgY2hhbmdlZC5cbiAqXG4gKiBAcGFyYW0gc2V0dGluZ3MgLSBUaGUgc2V0dGluZ3MuXG4gKiBAcGFyYW0gc2VjcmV0S2V5cyAtIFRoZSBrZXlzIHRvIHJlZGFjdC5cbiAqIEByZXR1cm5zIFRoZSByZWRhY3RlZCBjb3B5LlxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVkYWN0U2V0dGluZ3Moc2V0dGluZ3M6IHVua25vd24sIHNlY3JldEtleXM6IHJlYWRvbmx5IHN0cmluZ1tdKTogdW5rbm93biB7XG4gIGNvbnN0IGxvd2VyQ2FzZVNlY3JldEtleXMgPSBuZXcgU2V0KHNlY3JldEtleXMubWFwKChrZXkpID0+IGtleS50b0xvd2VyQ2FzZSgpKSk7XG4gIHJldHVybiByZWRhY3RWYWx1ZShzZXR0aW5ncywgbG93ZXJDYXNlU2VjcmV0S2V5cywgbmV3IFdlYWtTZXQoKSk7XG59XG5cbmZ1bmN0aW9uIHJlZGFjdFZhbHVlKHZhbHVlOiB1bmtub3duLCBsb3dlckNhc2VTZWNyZXRLZXlzOiBSZWFkb25seVNldDxzdHJpbmc+LCBzZWVuOiBXZWFrU2V0PG9iamVjdD4pOiB1bmtub3duIHtcbiAgaWYgKHR5cGVvZiB2YWx1ZSAhPT0gJ29iamVjdCcgfHwgdmFsdWUgPT09IG51bGwpIHtcbiAgICByZXR1cm4gdmFsdWU7XG4gIH1cblxuICBpZiAoc2Vlbi5oYXModmFsdWUpKSB7XG4gICAgcmV0dXJuICdbY2lyY3VsYXJdJztcbiAgfVxuICBzZWVuLmFkZCh2YWx1ZSk7XG5cbiAgaWYgKEFycmF5LmlzQXJyYXkodmFsdWUpKSB7XG4gICAgY29uc3QgcmVzdWx0ID0gdmFsdWUubWFwKChpdGVtOiB1bmtub3duKSA9PiByZWRhY3RWYWx1ZShpdGVtLCBsb3dlckNhc2VTZWNyZXRLZXlzLCBzZWVuKSk7XG4gICAgc2Vlbi5kZWxldGUodmFsdWUpO1xuICAgIHJldHVybiByZXN1bHQ7XG4gIH1cblxuICBjb25zdCByZXN1bHQ6IFJlY29yZDxzdHJpbmcsIHVua25vd24+ID0ge307XG4gIGZvciAoY29uc3QgW2tleSwgY2hpbGRdIG9mIE9iamVjdC5lbnRyaWVzKHZhbHVlKSkge1xuICAgIHJlc3VsdFtrZXldID0gbG93ZXJDYXNlU2VjcmV0S2V5cy5oYXMoa2V5LnRvTG93ZXJDYXNlKCkpID8gUkVEQUNURURfVkFMVUUgOiByZWRhY3RWYWx1ZShjaGlsZCwgbG93ZXJDYXNlU2VjcmV0S2V5cywgc2Vlbik7XG4gIH1cbiAgc2Vlbi5kZWxldGUodmFsdWUpO1xuICByZXR1cm4gcmVzdWx0O1xufVxuIl0sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFzSE8sTUFBTSxpQkFBaUI7QUFLdkIsTUFBTSxxQ0FBcUM7QUFLM0MsTUFBTSwwQ0FBMEM7QUFFdkQsTUFBTSxjQUFjO0FBQ3BCLE1BQU0sbUJBQW1CO0FB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

package/dist/lib/cjs/bug-report-diagnostics.d.cts

@@ -0,0 +1,186 @@
+/// <reference path="./library-references.d.cts" />
+/**
+ * @file
+ *
+ * Optional diagnostics a plugin can attach to a bug report: sections of text the user reviews before
+ * anything leaves Obsidian, a bounded log buffer, and redaction of a plugin's own settings.
+ *
+ * Nothing here reads logs or settings by itself. A log buffer holds only what the plugin wrote to it since
+ * the buffer was created, never the console's history, and a settings section holds only the object the
+ * plugin hands over. Redaction replaces the values of caller-declared keys; it is not a promise to find
+ * every secret, which is why every section is shown to the user, and a potentially private one is left
+ * out unless the user includes it.
+ */
+/**
+ * A section of diagnostics for a bug report.
+ */
+export interface BugReportDiagnosticSection {
+    /**
+     * The section's text, shown to the user and sent as written.
+     */
+    readonly content: string;
+    /**
+     * A stable id, unique among the sections of one report.
+     */
+    readonly id: string;
+    /**
+     * Whether the section can hold private data, such as logs or settings. A potentially private section is
+     * left out of the report unless the user includes it.
+     *
+     * @default `false`
+     */
+    readonly isPotentiallyPrivate?: boolean;
+    /**
+     * The section's title.
+     */
+    readonly title: string;
+}
+/**
+ * Constructor parameters for {@link BugReportLogBuffer}.
+ */
+export interface BugReportLogBufferConstructorOptions {
+    /**
+     * The most entries kept. Older entries are dropped first.
+     *
+     * @default {@link DEFAULT_BUG_REPORT_LOG_MAX_ENTRIES}
+     */
+    readonly maxEntries?: number;
+    /**
+     * The most characters kept of one entry. A longer entry is cut, and says so.
+     *
+     * @default {@link DEFAULT_BUG_REPORT_LOG_MAX_ENTRY_LENGTH}
+     */
+    readonly maxEntryLength?: number;
+    /**
+     * Gets the current time. For tests.
+     *
+     * @default `() => new Date()`
+     */
+    readonly now?: () => Date;
+}
+/**
+ * Parameters for {@link BugReportLogBuffer.toSection}.
+ */
+export interface BugReportLogBufferToSectionOptions {
+    /**
+     * The section's id.
+     *
+     * @default `'logs'`
+     */
+    readonly id?: string;
+    /**
+     * The section's title.
+     *
+     * @default `'Logs'`
+     */
+    readonly title?: string;
+}
+/**
+ * Parameters for {@link createSettingsDiagnosticSection}.
+ */
+export interface CreateSettingsDiagnosticSectionParams {
+    /**
+     * The section's id.
+     *
+     * @default `'settings'`
+     */
+    readonly id?: string;
+    /**
+     * The keys whose values are replaced with {@link REDACTED_VALUE}, at any depth, compared without case.
+     */
+    readonly secretKeys?: readonly string[];
+    /**
+     * The reporting plugin's own settings, such as its `data.json`.
+     */
+    readonly settings: unknown;
+    /**
+     * The section's title.
+     *
+     * @default `'Plugin settings'`
+     */
+    readonly title?: string;
+}
+/**
+ * The value that replaces a redacted setting.
+ */
+export declare const REDACTED_VALUE = "[redacted]";
+/**
+ * The default number of entries a {@link BugReportLogBuffer} keeps.
+ */
+export declare const DEFAULT_BUG_REPORT_LOG_MAX_ENTRIES = 200;
+/**
+ * The default number of characters a {@link BugReportLogBuffer} keeps of one entry.
+ */
+export declare const DEFAULT_BUG_REPORT_LOG_MAX_ENTRY_LENGTH = 2000;
+/**
+ * A bounded buffer of log entries a plugin writes for its bug reports. It keeps only what the plugin adds
+ * after creating it, at most {@link BugReportLogBufferConstructorOptions.maxEntries} entries, each cut to
+ * {@link BugReportLogBufferConstructorOptions.maxEntryLength} characters.
+ */
+export declare class BugReportLogBuffer {
+    private readonly entries;
+    private readonly maxEntries;
+    private readonly maxEntryLength;
+    private readonly now;
+    /**
+     * Constructs a new instance.
+     *
+     * @param options - Constructor options.
+     */
+    constructor(options?: BugReportLogBufferConstructorOptions);
+    /**
+     * Adds an entry, stamped with the current time.
+     *
+     * @param message - The entry's text.
+     */
+    add(message: string): void;
+    /**
+     * Removes every entry.
+     */
+    clear(): void;
+    /**
+     * Gets the entries, oldest first.
+     *
+     * @returns The entries.
+     */
+    getEntries(): readonly string[];
+    /**
+     * Builds a potentially private diagnostic section holding the entries.
+     *
+     * @param options - The options.
+     * @returns The section.
+     */
+    toSection(options?: BugReportLogBufferToSectionOptions): BugReportDiagnosticSection;
+}
+/**
+ * Builds a potentially private diagnostic section holding the plugin's settings as JSON, with the values
+ * of {@link CreateSettingsDiagnosticSectionParams.secretKeys} redacted.
+ *
+ * @param params - The parameters.
+ * @returns The section.
+ */
+export declare function createSettingsDiagnosticSection(params: CreateSettingsDiagnosticSectionParams): BugReportDiagnosticSection;
+/**
+ * Renders diagnostic sections as Markdown: a level-3 heading and a fenced code block per section. The
+ * fence is longer than any run of backticks in the content, so no content can close it.
+ *
+ * @param sections - The sections.
+ * @returns The Markdown, or an empty string when there are no sections.
+ */
+export declare function formatBugReportDiagnostics(sections: readonly BugReportDiagnosticSection[]): string;
+/**
+ * Gets a Markdown code fence that the given content cannot close.
+ *
+ * @param content - The content to fence.
+ * @returns A run of backticks longer than the longest run in the content, and at least three long.
+ */
+export declare function getMarkdownFence(content: string): string;
+/**
+ * Copies settings, replacing the value of every key in `secretKeys`, at any depth and compared without
+ * case, with {@link REDACTED_VALUE}. The original is not changed.
+ *
+ * @param settings - The settings.
+ * @param secretKeys - The keys to redact.
+ * @returns The redacted copy.
+ */
+export declare function redactSettings(settings: unknown, secretKeys: readonly string[]): unknown;