@mnaoumov/obsidian-dev-toolkit 3.2.1 → 3.4.0

package/dist/lib/cjs/demo-vault-coverage.d.cts

@@ -61,6 +61,20 @@
  * or a misspelled directive all fail: an exemption nobody can justify, that nothing needs any more, or that
  * silently does nothing is worse than no exemption at all.
  *
+ * They also check that every `Try it` section — a heading of any level starting `Try it`, up to the next
+ * heading of the same or a higher level — holds a `code-button` that performs its setup, because a reader
+ * asked to configure things by hand is a reader the demo lost. A section whose steps really cannot be
+ * scripted says so with the same directive, naming the `demo-vault-validation/try-it-code-button` rule on
+ * the heading, and with the same checks on the directive itself:
+ *
+ * ```markdown
+ * <!-- obsidian-dev-utils-disable-next-line demo-vault-validation/try-it-code-button -- Dragging a file in from outside Obsidian cannot be scripted. -->
+ * ## Try it
+ * ```
+ *
+ * That check fails the suite by default; {@link DemoVaultAuthoringSpec.tryItCodeButtons} set to `'warn'`
+ * prints the sections instead, for a vault still being brought up to it.
+ *
  * Two layers are exposed:
  * - {@link DemoVaultCoverageChecker} — a framework-agnostic core that reads the corpus, parses interface /
  *   class / enum members and exported functions, and returns diagnostic arrays (what is undemonstrated / stale
@@ -83,7 +97,17 @@ export interface DemoVaultAuthoringSpec {
      * `00 Start.md`.
      */
     readonly startNote?: string;
+    /**
+     * How a `Try it` section with no `code-button` and no directive explaining why is reported: `'warn'`
+     * prints the sections and passes, `'error'` fails the suite. Defaults to `'error'`.
+     */
+    readonly tryItCodeButtons?: DemoVaultCheckSeverity;
 }
+/**
+ * How a check that is being introduced gradually reports what it finds: `'warn'` prints it and passes,
+ * `'error'` fails.
+ */
+export type DemoVaultCheckSeverity = 'error' | 'warn';
 /**
  * Reflects a config interface whose options are demonstrated by their bare name.
  */
@@ -268,6 +292,46 @@ export interface DemoVaultNote {
      */
     readonly relativePath: string;
 }
+/**
+ * What a note's inline `obsidian-dev-utils-disable…` directives allow, rule by rule, and what is wrong with
+ * them.
+ */
+export interface DirectiveScan {
+    /**
+     * For each rule, the zero-based line numbers a directive exempts from it.
+     */
+    readonly allowedLineIndexesByRule: ReadonlyMap<string, ReadonlySet<number>>;
+    /**
+     * The directive mistakes found, each phrased for a failing assertion.
+     */
+    readonly problems: string[];
+}
+/**
+ * The running state of a directive scan, threaded through the per-line helpers.
+ */
+export interface DirectiveScanState {
+    /**
+     * For each rule, the lines a directive has exempted from it so far.
+     */
+    readonly allowedLineIndexesByRule: Map<string, Set<number>>;
+    /**
+     * For each rule, the region currently open, and whether it has covered a target yet.
+     */
+    readonly openRegionsByRule: Map<string, OpenDirectiveRegion>;
+    /**
+     * For each rule, the line a `disable-next-line` was read on, while it still waits for the line it covers.
+     */
+    readonly pendingNextLineIndexesByRule: Map<string, number>;
+    /**
+     * The directive mistakes found so far.
+     */
+    readonly problems: string[];
+    /**
+     * For each rule, the lines of the note that break it — the lines a directive for it has to cover to be
+     * doing any work.
+     */
+    readonly targetLineIndexesByRule: ReadonlyMap<string, ReadonlySet<number>>;
+}
 /**
  * The parsed members of a source interface, class, or enum.
  */
@@ -302,6 +366,22 @@ export interface NoteLine {
 /**
  * A `disable` region that has been opened and not yet enabled again.
  */
+export interface OpenDirectiveRegion {
+    /**
+     * Whether the region has covered a line breaking its rule, which is what stops it being reported as
+     * pointless.
+     */
+    isUsed: boolean;
+    /**
+     * The line the region was opened on.
+     */
+    readonly lineIndex: number;
+}
+/**
+ * A `disable` region that has been opened and not yet enabled again.
+ *
+ * @deprecated Use {@link OpenDirectiveRegion}: the directives now serve more than the wikilink rule.
+ */
 export interface OpenWikilinkDirectiveRegion {
     /**
      * Whether the region has covered a wikilink, which is what stops it being reported as pointless.
@@ -351,6 +431,8 @@ export interface RegisterDemoVaultCoverageSuiteParams {
 }
 /**
  * What a note's inline `obsidian-dev-utils-disable…` directives allow, and what is wrong with them.
+ *
+ * @deprecated Use {@link DirectiveScan}: the directives now serve more than the wikilink rule.
  */
 export interface WikilinkDirectiveScan {
     /**
@@ -364,6 +446,8 @@ export interface WikilinkDirectiveScan {
 }
 /**
  * The running state of a directive scan, threaded through the per-line helpers.
+ *
+ * @deprecated Use {@link DirectiveScanState}: the directives now serve more than the wikilink rule.
  */
 export interface WikilinkDirectiveScanState {
     /**
@@ -373,7 +457,7 @@ export interface WikilinkDirectiveScanState {
     /**
      * The region currently open, and whether it has covered a wikilink yet.
      */
-    openRegion: null | OpenWikilinkDirectiveRegion;
+    openRegion: null | OpenDirectiveRegion;
     /**
      * The line a `disable-next-line` was read on, while it still waits for the line it covers.
      */
@@ -448,11 +532,12 @@ export declare class DemoVaultCoverageChecker {
      */
     findNotesWithoutIntroProse(): string[];
     /**
-     * Finds notes whose wikilink allowance is not doing any work — declared without a reason, or on a note
-     * that carries no wikilink at all. Both are drift: an exemption nobody can justify, and one nothing needs
-     * any more, which would go on hiding the next wikilink somebody adds by accident.
+     * Finds notes whose exemptions are not doing any work — a wikilink allowance or an inline directive for
+     * any rule declared without a reason, misspelled, or covering nothing that breaks its rule. All of them
+     * are drift: an exemption nobody can justify, and one nothing needs any more, which would go on hiding
+     * the next mistake somebody makes by accident.
      *
-     * @returns The relative paths of the offending notes.
+     * @returns One `<note>: <problem>` entry per problem found.
      */
     findNotesWithUnjustifiedWikilinkAllowance(): string[];
     /**
@@ -471,6 +556,16 @@ export declare class DemoVaultCoverageChecker {
      * @returns The distinct stale member names referenced in the demo corpus.
      */
     findStaleReferences(params: DemoVaultCoverageCheckerFindStaleReferencesParams): string[];
+    /**
+     * Finds `Try it` sections with no `code-button` in them. A `Try it` section is a heading of any level
+     * starting `Try it`, up to the next heading of the same or a higher level; the setup it asks for is
+     * what a button is for, so a section that leaves the reader to do it by hand is the shape this check
+     * rejects. A section whose heading a `demo-vault-validation/try-it-code-button` directive covers has
+     * stated why it cannot be scripted, and is skipped — see the file overview.
+     *
+     * @returns One `<note>: line <n>` entry per offending section, naming the line of its heading.
+     */
+    findTryItSectionsWithoutCodeButton(): string[];
     /**
      * Finds members that are not demonstrated anywhere in the demo corpus.
      *

package/dist/lib/cjs/index.cjs

@@ -36,9 +36,7 @@ __export(index_exports, {
   bundlers: () => bundlers,
   "demo-vault": () => demo_vault,
   "demo-vault-app-json": () => demo_vault_app_json,
-  "demo-vault-buttons": () => demo_vault_buttons,
   "demo-vault-cli": () => demo_vault_cli,
-  "demo-vault-coverage": () => demo_vault_coverage,
   "docs-site": () => docs_site,
   formatters: () => formatters,
   linters: () => linters,
@@ -50,9 +48,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 var bundlers = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./bundlers/index.cjs')), 1);
 var demo_vault_app_json = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./demo-vault-app-json.cjs')), 1);
-var demo_vault_buttons = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./demo-vault-buttons.cjs')), 1);
 var demo_vault_cli = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./demo-vault-cli.cjs')), 1);
-var demo_vault_coverage = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./demo-vault-coverage.cjs')), 1);
 var demo_vault = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./demo-vault.cjs')), 1);
 var docs_site = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./docs-site/index.cjs')), 1);
 var formatters = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./formatters/index.cjs')), 1);
@@ -66,9 +62,7 @@ var version = __toESM(((module) => module && module.__esModule && 'default' in m
   bundlers,
   "demo-vault": null,
   "demo-vault-app-json": null,
-  "demo-vault-buttons": null,
   "demo-vault-cli": null,
-  "demo-vault-coverage": null,
   "docs-site": null,
   formatters,
   linters,
@@ -77,4 +71,4 @@ var version = __toESM(((module) => module && module.__esModule && 'default' in m
   "test-runners": null,
   version
 });
-//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2luZGV4LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKiBUSElTIElTIEEgR0VORVJBVEVEL0JVTkRMRUQgRklMRSBCWSBCVUlMRCBTQ1JJUFQgKi9cblxuZXhwb3J0ICogYXMgJ2J1bmRsZXJzJyBmcm9tICcuL2J1bmRsZXJzL2luZGV4LnRzJztcbmV4cG9ydCAqIGFzICdkZW1vLXZhdWx0LWFwcC1qc29uJyBmcm9tICcuL2RlbW8tdmF1bHQtYXBwLWpzb24udHMnO1xuZXhwb3J0ICogYXMgJ2RlbW8tdmF1bHQtYnV0dG9ucycgZnJvbSAnLi9kZW1vLXZhdWx0LWJ1dHRvbnMudHMnO1xuZXhwb3J0ICogYXMgJ2RlbW8tdmF1bHQtY2xpJyBmcm9tICcuL2RlbW8tdmF1bHQtY2xpLnRzJztcbmV4cG9ydCAqIGFzICdkZW1vLXZhdWx0LWNvdmVyYWdlJyBmcm9tICcuL2RlbW8tdmF1bHQtY292ZXJhZ2UudHMnO1xuZXhwb3J0ICogYXMgJ2RlbW8tdmF1bHQnIGZyb20gJy4vZGVtby12YXVsdC50cyc7XG5leHBvcnQgKiBhcyAnZG9jcy1zaXRlJyBmcm9tICcuL2RvY3Mtc2l0ZS9pbmRleC50cyc7XG5leHBvcnQgKiBhcyAnZm9ybWF0dGVycycgZnJvbSAnLi9mb3JtYXR0ZXJzL2luZGV4LnRzJztcbmV4cG9ydCAqIGFzICdsaW50ZXJzJyBmcm9tICcuL2xpbnRlcnMvaW5kZXgudHMnO1xuZXhwb3J0ICogYXMgJ29ic2lkaWFuLXBsdWdpbi1yZXBvLXBhdGhzJyBmcm9tICcuL29ic2lkaWFuLXBsdWdpbi1yZXBvLXBhdGhzLnRzJztcbmV4cG9ydCAqIGFzICd0ZW1wbGF0ZXMnIGZyb20gJy4vdGVtcGxhdGVzLnRzJztcbmV4cG9ydCAqIGFzICd0ZXN0LXJ1bm5lcnMnIGZyb20gJy4vdGVzdC1ydW5uZXJzL2luZGV4LnRzJztcbmV4cG9ydCAqIGFzICd2ZXJzaW9uJyBmcm9tICcuL3ZlcnNpb24udHMnO1xuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUEsc0JBQUFBO0FBQUEsRUFBQSw2QkFBQUM7QUFBQSxFQUFBLDRCQUFBQztBQUFBLEVBQUEsd0JBQUFDO0FBQUEsRUFBQSw2QkFBQUM7QUFBQSxFQUFBLG1CQUFBQztBQUFBLEVBQUE7QUFBQTtBQUFBLHNDQUFBQztBQUFBLEVBQUE7QUFBQSx3QkFBQUM7QUFBQSxFQUFBO0FBQUE7QUFBQTtBQUVBLGVBQTRCO0FBQzVCLElBQUFOLHNCQUF1QztBQUN2QyxJQUFBQyxxQkFBc0M7QUFDdEMsSUFBQUMsaUJBQWtDO0FBQ2xDLElBQUFDLHNCQUF1QztBQUN2QyxJQUFBSixhQUE4QjtBQUM5QixJQUFBSyxZQUE2QjtBQUM3QixpQkFBOEI7QUFDOUIsY0FBMkI7QUFDM0IsSUFBQUMsNkJBQThDO0FBQzlDLGdCQUE2QjtBQUM3QixJQUFBQyxlQUFnQztBQUNoQyxjQUEyQjsiLAogICJuYW1lcyI6IFsiZGVtby12YXVsdCIsICJkZW1vLXZhdWx0LWFwcC1qc29uIiwgImRlbW8tdmF1bHQtYnV0dG9ucyIsICJkZW1vLXZhdWx0LWNsaSIsICJkZW1vLXZhdWx0LWNvdmVyYWdlIiwgImRvY3Mtc2l0ZSIsICJvYnNpZGlhbi1wbHVnaW4tcmVwby1wYXRocyIsICJ0ZXN0LXJ1bm5lcnMiXQp9Cg==
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2luZGV4LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKiBUSElTIElTIEEgR0VORVJBVEVEL0JVTkRMRUQgRklMRSBCWSBCVUlMRCBTQ1JJUFQgKi9cblxuZXhwb3J0ICogYXMgJ2J1bmRsZXJzJyBmcm9tICcuL2J1bmRsZXJzL2luZGV4LnRzJztcbmV4cG9ydCAqIGFzICdkZW1vLXZhdWx0LWFwcC1qc29uJyBmcm9tICcuL2RlbW8tdmF1bHQtYXBwLWpzb24udHMnO1xuZXhwb3J0ICogYXMgJ2RlbW8tdmF1bHQtY2xpJyBmcm9tICcuL2RlbW8tdmF1bHQtY2xpLnRzJztcbmV4cG9ydCAqIGFzICdkZW1vLXZhdWx0JyBmcm9tICcuL2RlbW8tdmF1bHQudHMnO1xuZXhwb3J0ICogYXMgJ2RvY3Mtc2l0ZScgZnJvbSAnLi9kb2NzLXNpdGUvaW5kZXgudHMnO1xuZXhwb3J0ICogYXMgJ2Zvcm1hdHRlcnMnIGZyb20gJy4vZm9ybWF0dGVycy9pbmRleC50cyc7XG5leHBvcnQgKiBhcyAnbGludGVycycgZnJvbSAnLi9saW50ZXJzL2luZGV4LnRzJztcbmV4cG9ydCAqIGFzICdvYnNpZGlhbi1wbHVnaW4tcmVwby1wYXRocycgZnJvbSAnLi9vYnNpZGlhbi1wbHVnaW4tcmVwby1wYXRocy50cyc7XG5leHBvcnQgKiBhcyAndGVtcGxhdGVzJyBmcm9tICcuL3RlbXBsYXRlcy50cyc7XG5leHBvcnQgKiBhcyAndGVzdC1ydW5uZXJzJyBmcm9tICcuL3Rlc3QtcnVubmVycy9pbmRleC50cyc7XG5leHBvcnQgKiBhcyAndmVyc2lvbicgZnJvbSAnLi92ZXJzaW9uLnRzJztcbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBLHNCQUFBQTtBQUFBLEVBQUEsNkJBQUFDO0FBQUEsRUFBQSx3QkFBQUM7QUFBQSxFQUFBLG1CQUFBQztBQUFBLEVBQUE7QUFBQTtBQUFBLHNDQUFBQztBQUFBLEVBQUE7QUFBQSx3QkFBQUM7QUFBQSxFQUFBO0FBQUE7QUFBQTtBQUVBLGVBQTRCO0FBQzVCLElBQUFKLHNCQUF1QztBQUN2QyxJQUFBQyxpQkFBa0M7QUFDbEMsSUFBQUYsYUFBOEI7QUFDOUIsSUFBQUcsWUFBNkI7QUFDN0IsaUJBQThCO0FBQzlCLGNBQTJCO0FBQzNCLElBQUFDLDZCQUE4QztBQUM5QyxnQkFBNkI7QUFDN0IsSUFBQUMsZUFBZ0M7QUFDaEMsY0FBMkI7IiwKICAibmFtZXMiOiBbImRlbW8tdmF1bHQiLCAiZGVtby12YXVsdC1hcHAtanNvbiIsICJkZW1vLXZhdWx0LWNsaSIsICJkb2NzLXNpdGUiLCAib2JzaWRpYW4tcGx1Z2luLXJlcG8tcGF0aHMiLCAidGVzdC1ydW5uZXJzIl0KfQo=

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

@@ -5,9 +5,7 @@
 /// <reference types="node" />
 export * as 'bundlers' from './bundlers/index.cjs';
 export * as 'demo-vault-app-json' from './demo-vault-app-json.cjs';
-export * as 'demo-vault-buttons' from './demo-vault-buttons.cjs';
 export * as 'demo-vault-cli' from './demo-vault-cli.cjs';
-export * as 'demo-vault-coverage' from './demo-vault-coverage.cjs';
 export * as 'demo-vault' from './demo-vault.cjs';
 export * as 'docs-site' from './docs-site/index.cjs';
 export * as 'formatters' from './formatters/index.cjs';

package/dist/lib/cjs/test-runners/index.cjs

@@ -36,7 +36,6 @@ __export(test_runners_exports, {
   "coverage-badge": () => coverage_badge,
   "coverage-badge-cli": () => coverage_badge_cli,
   "e2e-runner-support": () => e2e_runner_support,
-  "integration-test-plugin": () => integration_test_plugin,
   "jest-config": () => jest_config,
   "obsidian-test-runner": () => obsidian_test_runner,
   "performance-eval-cap": () => performance_eval_cap,
@@ -47,7 +46,6 @@ module.exports = __toCommonJS(test_runners_exports);
 var coverage_badge_cli = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./coverage-badge-cli.cjs')), 1);
 var coverage_badge = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./coverage-badge.cjs')), 1);
 var e2e_runner_support = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./e2e-runner-support.cjs')), 1);
-var integration_test_plugin = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./integration-test-plugin.cjs')), 1);
 var jest_config = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./jest-config.cjs')), 1);
 var obsidian_test_runner = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./obsidian-test-runner.cjs')), 1);
 var performance_eval_cap = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./performance-eval-cap.cjs')), 1);
@@ -58,11 +56,10 @@ var wdio_obsidian = __toESM(((module) => module && module.__esModule && 'default
   "coverage-badge": null,
   "coverage-badge-cli": null,
   "e2e-runner-support": null,
-  "integration-test-plugin": null,
   "jest-config": null,
   "obsidian-test-runner": null,
   "performance-eval-cap": null,
   "vitest-config": null,
   "wdio-obsidian": null
 });
-//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3Rlc3QtcnVubmVycy9pbmRleC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyogVEhJUyBJUyBBIEdFTkVSQVRFRC9CVU5ETEVEIEZJTEUgQlkgQlVJTEQgU0NSSVBUICovXG5cbmV4cG9ydCAqIGFzICdjb3ZlcmFnZS1iYWRnZS1jbGknIGZyb20gJy4vY292ZXJhZ2UtYmFkZ2UtY2xpLnRzJztcbmV4cG9ydCAqIGFzICdjb3ZlcmFnZS1iYWRnZScgZnJvbSAnLi9jb3ZlcmFnZS1iYWRnZS50cyc7XG5leHBvcnQgKiBhcyAnZTJlLXJ1bm5lci1zdXBwb3J0JyBmcm9tICcuL2UyZS1ydW5uZXItc3VwcG9ydC50cyc7XG5leHBvcnQgKiBhcyAnaW50ZWdyYXRpb24tdGVzdC1wbHVnaW4nIGZyb20gJy4vaW50ZWdyYXRpb24tdGVzdC1wbHVnaW4udHMnO1xuZXhwb3J0ICogYXMgJ2plc3QtY29uZmlnJyBmcm9tICcuL2plc3QtY29uZmlnLnRzJztcbmV4cG9ydCAqIGFzICdvYnNpZGlhbi10ZXN0LXJ1bm5lcicgZnJvbSAnLi9vYnNpZGlhbi10ZXN0LXJ1bm5lci50cyc7XG5leHBvcnQgKiBhcyAncGVyZm9ybWFuY2UtZXZhbC1jYXAnIGZyb20gJy4vcGVyZm9ybWFuY2UtZXZhbC1jYXAudHMnO1xuZXhwb3J0ICogYXMgJ3ZpdGVzdC1jb25maWcnIGZyb20gJy4vdml0ZXN0LWNvbmZpZy50cyc7XG5leHBvcnQgKiBhcyAnd2Rpby1vYnNpZGlhbicgZnJvbSAnLi93ZGlvLW9ic2lkaWFuLnRzJztcbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQSwwQkFBQUE7QUFBQSxFQUFBLDRCQUFBQztBQUFBLEVBQUEsNEJBQUFDO0FBQUEsRUFBQSxpQ0FBQUM7QUFBQSxFQUFBLHFCQUFBQztBQUFBLEVBQUEsOEJBQUFDO0FBQUEsRUFBQSw4QkFBQUM7QUFBQSxFQUFBLHVCQUFBQztBQUFBLEVBQUEsdUJBQUFDO0FBQUE7QUFBQTtBQUVBLElBQUFQLHFCQUFzQztBQUN0QyxJQUFBRCxpQkFBa0M7QUFDbEMsSUFBQUUscUJBQXNDO0FBQ3RDLElBQUFDLDBCQUEyQztBQUMzQyxJQUFBQyxjQUErQjtBQUMvQixJQUFBQyx1QkFBd0M7QUFDeEMsSUFBQUMsdUJBQXdDO0FBQ3hDLElBQUFDLGdCQUFpQztBQUNqQyxJQUFBQyxnQkFBaUM7IiwKICAibmFtZXMiOiBbImNvdmVyYWdlLWJhZGdlIiwgImNvdmVyYWdlLWJhZGdlLWNsaSIsICJlMmUtcnVubmVyLXN1cHBvcnQiLCAiaW50ZWdyYXRpb24tdGVzdC1wbHVnaW4iLCAiamVzdC1jb25maWciLCAib2JzaWRpYW4tdGVzdC1ydW5uZXIiLCAicGVyZm9ybWFuY2UtZXZhbC1jYXAiLCAidml0ZXN0LWNvbmZpZyIsICJ3ZGlvLW9ic2lkaWFuIl0KfQo=
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3Rlc3QtcnVubmVycy9pbmRleC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyogVEhJUyBJUyBBIEdFTkVSQVRFRC9CVU5ETEVEIEZJTEUgQlkgQlVJTEQgU0NSSVBUICovXG5cbmV4cG9ydCAqIGFzICdjb3ZlcmFnZS1iYWRnZS1jbGknIGZyb20gJy4vY292ZXJhZ2UtYmFkZ2UtY2xpLnRzJztcbmV4cG9ydCAqIGFzICdjb3ZlcmFnZS1iYWRnZScgZnJvbSAnLi9jb3ZlcmFnZS1iYWRnZS50cyc7XG5leHBvcnQgKiBhcyAnZTJlLXJ1bm5lci1zdXBwb3J0JyBmcm9tICcuL2UyZS1ydW5uZXItc3VwcG9ydC50cyc7XG5leHBvcnQgKiBhcyAnamVzdC1jb25maWcnIGZyb20gJy4vamVzdC1jb25maWcudHMnO1xuZXhwb3J0ICogYXMgJ29ic2lkaWFuLXRlc3QtcnVubmVyJyBmcm9tICcuL29ic2lkaWFuLXRlc3QtcnVubmVyLnRzJztcbmV4cG9ydCAqIGFzICdwZXJmb3JtYW5jZS1ldmFsLWNhcCcgZnJvbSAnLi9wZXJmb3JtYW5jZS1ldmFsLWNhcC50cyc7XG5leHBvcnQgKiBhcyAndml0ZXN0LWNvbmZpZycgZnJvbSAnLi92aXRlc3QtY29uZmlnLnRzJztcbmV4cG9ydCAqIGFzICd3ZGlvLW9ic2lkaWFuJyBmcm9tICcuL3dkaW8tb2JzaWRpYW4udHMnO1xuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBLDBCQUFBQTtBQUFBLEVBQUEsNEJBQUFDO0FBQUEsRUFBQSw0QkFBQUM7QUFBQSxFQUFBLHFCQUFBQztBQUFBLEVBQUEsOEJBQUFDO0FBQUEsRUFBQSw4QkFBQUM7QUFBQSxFQUFBLHVCQUFBQztBQUFBLEVBQUEsdUJBQUFDO0FBQUE7QUFBQTtBQUVBLElBQUFOLHFCQUFzQztBQUN0QyxJQUFBRCxpQkFBa0M7QUFDbEMsSUFBQUUscUJBQXNDO0FBQ3RDLElBQUFDLGNBQStCO0FBQy9CLElBQUFDLHVCQUF3QztBQUN4QyxJQUFBQyx1QkFBd0M7QUFDeEMsSUFBQUMsZ0JBQWlDO0FBQ2pDLElBQUFDLGdCQUFpQzsiLAogICJuYW1lcyI6IFsiY292ZXJhZ2UtYmFkZ2UiLCAiY292ZXJhZ2UtYmFkZ2UtY2xpIiwgImUyZS1ydW5uZXItc3VwcG9ydCIsICJqZXN0LWNvbmZpZyIsICJvYnNpZGlhbi10ZXN0LXJ1bm5lciIsICJwZXJmb3JtYW5jZS1ldmFsLWNhcCIsICJ2aXRlc3QtY29uZmlnIiwgIndkaW8tb2JzaWRpYW4iXQp9Cg==

package/dist/lib/cjs/test-runners/index.d.cts

@@ -2,7 +2,6 @@
 export * as 'coverage-badge-cli' from './coverage-badge-cli.cjs';
 export * as 'coverage-badge' from './coverage-badge.cjs';
 export * as 'e2e-runner-support' from './e2e-runner-support.cjs';
-export * as 'integration-test-plugin' from './integration-test-plugin.cjs';
 export * as 'jest-config' from './jest-config.cjs';
 export * as 'obsidian-test-runner' from './obsidian-test-runner.cjs';
 export * as 'performance-eval-cap' from './performance-eval-cap.cjs';

package/dist/lib/esm/demo-vault-coverage.d.mts

@@ -61,6 +61,20 @@
  * or a misspelled directive all fail: an exemption nobody can justify, that nothing needs any more, or that
  * silently does nothing is worse than no exemption at all.
  *
+ * They also check that every `Try it` section — a heading of any level starting `Try it`, up to the next
+ * heading of the same or a higher level — holds a `code-button` that performs its setup, because a reader
+ * asked to configure things by hand is a reader the demo lost. A section whose steps really cannot be
+ * scripted says so with the same directive, naming the `demo-vault-validation/try-it-code-button` rule on
+ * the heading, and with the same checks on the directive itself:
+ *
+ * ```markdown
+ * <!-- obsidian-dev-utils-disable-next-line demo-vault-validation/try-it-code-button -- Dragging a file in from outside Obsidian cannot be scripted. -->
+ * ## Try it
+ * ```
+ *
+ * That check fails the suite by default; {@link DemoVaultAuthoringSpec.tryItCodeButtons} set to `'warn'`
+ * prints the sections instead, for a vault still being brought up to it.
+ *
  * Two layers are exposed:
  * - {@link DemoVaultCoverageChecker} — a framework-agnostic core that reads the corpus, parses interface /
  *   class / enum members and exported functions, and returns diagnostic arrays (what is undemonstrated / stale
@@ -83,7 +97,17 @@ export interface DemoVaultAuthoringSpec {
      * `00 Start.md`.
      */
     readonly startNote?: string;
+    /**
+     * How a `Try it` section with no `code-button` and no directive explaining why is reported: `'warn'`
+     * prints the sections and passes, `'error'` fails the suite. Defaults to `'error'`.
+     */
+    readonly tryItCodeButtons?: DemoVaultCheckSeverity;
 }
+/**
+ * How a check that is being introduced gradually reports what it finds: `'warn'` prints it and passes,
+ * `'error'` fails.
+ */
+export type DemoVaultCheckSeverity = 'error' | 'warn';
 /**
  * Reflects a config interface whose options are demonstrated by their bare name.
  */
@@ -268,6 +292,46 @@ export interface DemoVaultNote {
      */
     readonly relativePath: string;
 }
+/**
+ * What a note's inline `obsidian-dev-utils-disable…` directives allow, rule by rule, and what is wrong with
+ * them.
+ */
+export interface DirectiveScan {
+    /**
+     * For each rule, the zero-based line numbers a directive exempts from it.
+     */
+    readonly allowedLineIndexesByRule: ReadonlyMap<string, ReadonlySet<number>>;
+    /**
+     * The directive mistakes found, each phrased for a failing assertion.
+     */
+    readonly problems: string[];
+}
+/**
+ * The running state of a directive scan, threaded through the per-line helpers.
+ */
+export interface DirectiveScanState {
+    /**
+     * For each rule, the lines a directive has exempted from it so far.
+     */
+    readonly allowedLineIndexesByRule: Map<string, Set<number>>;
+    /**
+     * For each rule, the region currently open, and whether it has covered a target yet.
+     */
+    readonly openRegionsByRule: Map<string, OpenDirectiveRegion>;
+    /**
+     * For each rule, the line a `disable-next-line` was read on, while it still waits for the line it covers.
+     */
+    readonly pendingNextLineIndexesByRule: Map<string, number>;
+    /**
+     * The directive mistakes found so far.
+     */
+    readonly problems: string[];
+    /**
+     * For each rule, the lines of the note that break it — the lines a directive for it has to cover to be
+     * doing any work.
+     */
+    readonly targetLineIndexesByRule: ReadonlyMap<string, ReadonlySet<number>>;
+}
 /**
  * The parsed members of a source interface, class, or enum.
  */
@@ -302,6 +366,22 @@ export interface NoteLine {
 /**
  * A `disable` region that has been opened and not yet enabled again.
  */
+export interface OpenDirectiveRegion {
+    /**
+     * Whether the region has covered a line breaking its rule, which is what stops it being reported as
+     * pointless.
+     */
+    isUsed: boolean;
+    /**
+     * The line the region was opened on.
+     */
+    readonly lineIndex: number;
+}
+/**
+ * A `disable` region that has been opened and not yet enabled again.
+ *
+ * @deprecated Use {@link OpenDirectiveRegion}: the directives now serve more than the wikilink rule.
+ */
 export interface OpenWikilinkDirectiveRegion {
     /**
      * Whether the region has covered a wikilink, which is what stops it being reported as pointless.
@@ -351,6 +431,8 @@ export interface RegisterDemoVaultCoverageSuiteParams {
 }
 /**
  * What a note's inline `obsidian-dev-utils-disable…` directives allow, and what is wrong with them.
+ *
+ * @deprecated Use {@link DirectiveScan}: the directives now serve more than the wikilink rule.
  */
 export interface WikilinkDirectiveScan {
     /**
@@ -364,6 +446,8 @@ export interface WikilinkDirectiveScan {
 }
 /**
  * The running state of a directive scan, threaded through the per-line helpers.
+ *
+ * @deprecated Use {@link DirectiveScanState}: the directives now serve more than the wikilink rule.
  */
 export interface WikilinkDirectiveScanState {
     /**
@@ -373,7 +457,7 @@ export interface WikilinkDirectiveScanState {
     /**
      * The region currently open, and whether it has covered a wikilink yet.
      */
-    openRegion: null | OpenWikilinkDirectiveRegion;
+    openRegion: null | OpenDirectiveRegion;
     /**
      * The line a `disable-next-line` was read on, while it still waits for the line it covers.
      */
@@ -448,11 +532,12 @@ export declare class DemoVaultCoverageChecker {
      */
     findNotesWithoutIntroProse(): string[];
     /**
-     * Finds notes whose wikilink allowance is not doing any work — declared without a reason, or on a note
-     * that carries no wikilink at all. Both are drift: an exemption nobody can justify, and one nothing needs
-     * any more, which would go on hiding the next wikilink somebody adds by accident.
+     * Finds notes whose exemptions are not doing any work — a wikilink allowance or an inline directive for
+     * any rule declared without a reason, misspelled, or covering nothing that breaks its rule. All of them
+     * are drift: an exemption nobody can justify, and one nothing needs any more, which would go on hiding
+     * the next mistake somebody makes by accident.
      *
-     * @returns The relative paths of the offending notes.
+     * @returns One `<note>: <problem>` entry per problem found.
      */
     findNotesWithUnjustifiedWikilinkAllowance(): string[];
     /**
@@ -471,6 +556,16 @@ export declare class DemoVaultCoverageChecker {
      * @returns The distinct stale member names referenced in the demo corpus.
      */
     findStaleReferences(params: DemoVaultCoverageCheckerFindStaleReferencesParams): string[];
+    /**
+     * Finds `Try it` sections with no `code-button` in them. A `Try it` section is a heading of any level
+     * starting `Try it`, up to the next heading of the same or a higher level; the setup it asks for is
+     * what a button is for, so a section that leaves the reader to do it by hand is the shape this check
+     * rejects. A section whose heading a `demo-vault-validation/try-it-code-button` directive covers has
+     * stated why it cannot be scripted, and is skipped — see the file overview.
+     *
+     * @returns One `<note>: line <n>` entry per offending section, naming the line of its heading.
+     */
+    findTryItSectionsWithoutCodeButton(): string[];
     /**
      * Finds members that are not demonstrated anywhere in the demo corpus.
      *