@hawkeyexl/manni 4.12.4 → 4.13.0

package/dist/{chunk-QWE3WLV4.js → chunk-OBXCJZ6R.js}

@@ -19,22 +19,22 @@ import {
 } from "./chunk-SE4JN5XN.js";
 import {
   declaredAt
-} from "./chunk-VXU75N5R.js";
+} from "./chunk-HIEGOW7X.js";
 import {
   metaProvenanceEntries
-} from "./chunk-DTXLFSAB.js";
+} from "./chunk-OUAH7XF2.js";
 import {
   familyMarks,
   loadExternalMetadata,
   memberOf,
   mergeWithMarks,
   provenanceEntries
-} from "./chunk-EBZ4QKKX.js";
+} from "./chunk-LNGSE7V2.js";
 import {
   __default,
   classifyRef,
   extractFrontmatter
-} from "./chunk-Y4TDIUG6.js";
+} from "./chunk-HY6ROJTH.js";
 import {
   findConfigFileSync,
   ownsKey,
@@ -2960,4 +2960,4 @@ export {
   applySelection,
   runEvals
 };
-//# sourceMappingURL=chunk-QWE3WLV4.js.map
+//# sourceMappingURL=chunk-OBXCJZ6R.js.map

package/dist/{chunk-VFL3ERMI.js → chunk-OREHJQNN.js}

@@ -8,7 +8,7 @@ import {
   resolvePages,
   runConfigOptions,
   withExternalMetadata
-} from "./chunk-QWE3WLV4.js";
+} from "./chunk-OBXCJZ6R.js";
 import {
   SUMMARY_FORMATS,
   parseFormat
@@ -93,4 +93,4 @@ export {
   runList,
   renderList
 };
-//# sourceMappingURL=chunk-VFL3ERMI.js.map
+//# sourceMappingURL=chunk-OREHJQNN.js.map

package/dist/{chunk-DTXLFSAB.js → chunk-OUAH7XF2.js}

@@ -5,7 +5,7 @@ import {
   offerPrompt,
   planRelocation,
   relocationOffers
-} from "./chunk-EBZ4QKKX.js";
+} from "./chunk-LNGSE7V2.js";
 
 // src/meta/core/location-writes.ts
 import { LineCounter, isMap, isNode, isScalar, parseDocument } from "yaml";
@@ -161,4 +161,4 @@ export {
   mergeMetaProvenance,
   metaProvenanceEntries
 };
-//# sourceMappingURL=chunk-DTXLFSAB.js.map
+//# sourceMappingURL=chunk-OUAH7XF2.js.map

package/dist/{chunk-ZCJUSQM7.js → chunk-OYIWF3B2.js}

@@ -16,7 +16,7 @@ import {
   spliceEntryField,
   unifiedDiff,
   withClaimLines
-} from "./chunk-U4SY2TJS.js";
+} from "./chunk-YZ4TJLZQ.js";
 import {
   CITATIONS_KEY,
   CITE_SECTION,
@@ -54,10 +54,10 @@ import {
   stripMarkers,
   twoManifestsRefusal,
   urlManifestRefusal
-} from "./chunk-5OKSFNUV.js";
+} from "./chunk-DQOM3DEU.js";
 import {
   renderCheckGithub
-} from "./chunk-KQRYW4DN.js";
+} from "./chunk-VNYXK7TM.js";
 import {
   refusalLine,
   removalLine,
@@ -65,7 +65,7 @@ import {
   renderRemovePretty,
   renderUpdatePretty,
   rewriteLine
-} from "./chunk-7JUIJ7Q5.js";
+} from "./chunk-GWI6JPTT.js";
 import {
   blockMatches,
   claimEnd,
@@ -94,7 +94,7 @@ import {
   toValidationResult,
   unitAt,
   unitText
-} from "./chunk-4TGIGVFO.js";
+} from "./chunk-WVXCN5DS.js";
 import {
   CITE_RULES,
   CiteError,
@@ -134,7 +134,7 @@ import {
   spellSource,
   statementForms,
   validateEntry
-} from "./chunk-J67EOBN3.js";
+} from "./chunk-X4MPUD4B.js";
 import {
   renderCheckJson,
   renderRemoveJson,
@@ -143,7 +143,7 @@ import {
 import {
   reencryptData,
   reencryptMetadata
-} from "./chunk-VXU75N5R.js";
+} from "./chunk-HIEGOW7X.js";
 import {
   ENCRYPTION_KEY_ENV,
   MAX_RANGE_LINES,
@@ -170,7 +170,7 @@ import {
   toBodyLines,
   toFileLines,
   writeEncryptionKey
-} from "./chunk-EBZ4QKKX.js";
+} from "./chunk-LNGSE7V2.js";
 import {
   LEGACY_CONFIG_NAMES,
   STDIN_TOKEN,
@@ -181,7 +181,7 @@ import {
   resolveTargetSet,
   supportedExtensions,
   writeFileAtomic
-} from "./chunk-Y4TDIUG6.js";
+} from "./chunk-HY6ROJTH.js";
 import {
   findConfigFile,
   findFamilyConfigFile,
@@ -931,4 +931,4 @@ export {
   runKeyRotate,
   runKeySet
 };
-//# sourceMappingURL=chunk-ZCJUSQM7.js.map
+//# sourceMappingURL=chunk-OYIWF3B2.js.map

package/dist/{chunk-HP43LH7E.js → chunk-PA7CMQGD.js}

@@ -7,7 +7,7 @@ import {
   isMultilingual,
   languageOf,
   plural
-} from "./chunk-3QUCVYNX.js";
+} from "./chunk-3XGTNN3M.js";
 import {
   palette
 } from "./chunk-RNVYGWIC.js";
@@ -336,4 +336,4 @@ export {
   renderValeWiring,
   renderFormatsPretty
 };
-//# sourceMappingURL=chunk-HP43LH7E.js.map
+//# sourceMappingURL=chunk-PA7CMQGD.js.map

package/dist/{chunk-5NNPEPVM.js → chunk-PCGBXHSE.js}

@@ -10,7 +10,7 @@ import {
   listInTree,
   resolveArtifacts,
   safeRead
-} from "./chunk-QUG53QGZ.js";
+} from "./chunk-E6BVUDGY.js";
 import {
   makeRedactor
 } from "./chunk-CU57HT2E.js";
@@ -19,7 +19,7 @@ import {
 } from "./chunk-4TSWU2SU.js";
 import {
   extractFrontmatter
-} from "./chunk-Y4TDIUG6.js";
+} from "./chunk-HY6ROJTH.js";
 
 // src/tracevals/rules/turn.ts
 var INJECTED = /<(system-reminder|task-notification|ci-monitor-event|local-command-stdout|local-command-stderr|local-command-caveat)>[\s\S]*?<\/\1>/g;
@@ -671,4 +671,4 @@ export {
   resolveTurnSources,
   pathKey
 };
-//# sourceMappingURL=chunk-5NNPEPVM.js.map
+//# sourceMappingURL=chunk-PCGBXHSE.js.map

package/dist/{chunk-TR2XFZPR.js → chunk-QKT67PFE.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   discoverArtifacts
-} from "./chunk-LWMB7JRE.js";
+} from "./chunk-3O6U4ICM.js";
 import {
   parseHookPayload,
   readStdin
@@ -12,7 +12,7 @@ import {
   relPosix,
   sha256Hex,
   writeManifest
-} from "./chunk-QUG53QGZ.js";
+} from "./chunk-E6BVUDGY.js";
 import {
   loadConfig
 } from "./chunk-OKMTUAWO.js";
@@ -212,4 +212,4 @@ export {
   runCapture,
   renderCapture
 };
-//# sourceMappingURL=chunk-TR2XFZPR.js.map
+//# sourceMappingURL=chunk-QKT67PFE.js.map

package/dist/{chunk-YGFIQ6Y5.js → chunk-SCLXVTFZ.js}

@@ -14,4 +14,4 @@ var LintError = class extends ToolError {
 export {
   LintError
 };
-//# sourceMappingURL=chunk-YGFIQ6Y5.js.map
+//# sourceMappingURL=chunk-SCLXVTFZ.js.map

package/dist/{chunk-YGFIQ6Y5.js.map → chunk-SCLXVTFZ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/lint/types.ts"],"sourcesContent":["/**\n * The contract every other module is written against.\n *\n * Two shapes matter. `DocumentTree` is what a parser owes the rest of the tool:\n * a nested section tree with real source positions, in a vocabulary that has\n * nothing to do with Markdown. `Finding` is what the tool owes its caller.\n * Everything between the two - matching, rules, reporting - touches neither\n * mdast nor Asciidoctor nor parse5, which is what lets a new input format be\n * one file plus a line in the parser registry.\n */\n\nimport { ToolError } from \"../shared/errors.js\";\nimport type { Severity } from \"../shared/severity.js\";\n\n/**\n * Operational/usage failure. Exits 2; never used for lint findings.\n *\n * Extends the umbrella's `ToolError`, which is what the shared bin runner\n * matches on; the subclass stays so this tool's tests and library callers can\n * match on it by name. Named for its domain, as `A11yError`, `CiteError` and\n * `KeyError` are.\n */\nexport class LintError extends ToolError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"LintError\";\n  }\n}\n\n/** A point in a source file. Line and column are 1-based, offset 0-based. */\nexport interface Point {\n  line: number;\n  column: number;\n  offset: number;\n}\n\n/** A half-open source span, `start` inclusive and `end` exclusive. */\nexport interface Position {\n  start: Point;\n  end: Point;\n}\n\n/**\n * Content kinds a section can hold, named generically so a rule written once\n * works on every format. Each parser maps its own AST onto these: mdast\n * `paragraph`/`code`/`list`, Asciidoctor `paragraph`/`listing`/`ulist`|`olist`,\n * HTML `<p>`/`<pre>`/`<ul>` - all three onto `paragraph`/`codeBlock`/`list`.\n *\n * The vocabulary is wider than any one parser emits today. `table`,\n * `admonition`, `image`, `blockquote`, `definitionList`, and `element` are\n * declared here, and in each `DocumentParser.kinds`, only once a parser\n * actually produces them - see `src/lint/parsers/index.ts`.\n */\nexport type ContentKind =\n  | \"paragraph\"\n  | \"codeBlock\"\n  | \"list\"\n  | \"listItem\"\n  | \"table\"\n  | \"tableRow\"\n  | \"tableCell\"\n  | \"admonition\"\n  | \"image\"\n  | \"blockquote\"\n  | \"definitionList\"\n  | \"definitionItem\"\n  | \"element\";\n\nexport interface ContentNodeBase {\n  kind: ContentKind;\n  position: Position;\n  /** Plain-text rendering, used by pattern rules. */\n  text: string;\n}\n\nexport interface ParagraphNode extends ContentNodeBase {\n  kind: \"paragraph\";\n}\n\nexport interface CodeNode extends ContentNodeBase {\n  kind: \"codeBlock\";\n  /** Language, when the format carries one. */\n  language?: string;\n  /** The info-string tail after the language, when the format carries one. */\n  fenceInfo?: string;\n}\n\nexport interface ListItemNode {\n  kind: \"listItem\";\n  position: Position;\n  text: string;\n  /** Nested content, so item-level paragraph/code/list rules can run. */\n  children: ContentNode[];\n}\n\nexport interface ListNode extends ContentNodeBase {\n  kind: \"list\";\n  ordered: boolean;\n  items: ListItemNode[];\n}\n\nexport interface TableCellNode extends ContentNodeBase {\n  kind: \"tableCell\";\n  children: ContentNode[];\n}\n\nexport interface TableRowNode extends ContentNodeBase {\n  kind: \"tableRow\";\n  header: boolean;\n  children: TableCellNode[];\n}\n\nexport interface TableNode extends ContentNodeBase {\n  kind: \"table\";\n  children: TableRowNode[];\n}\n\n/**\n * A callout, and the flavor the source gave it.\n *\n * `variant` is optional because not every format names one this vocabulary\n * has. reStructuredText has `hint`, `attention`, `error` and a generic\n * `admonition` directive, and a bare HTML `<aside>` says nothing at all. Those\n * produce an admonition with no variant rather than an invented equivalence:\n * mapping `hint` onto `tip` would make `variant: tip` pass on a page that\n * never said tip. A `variant:` rule reports such a node as a mismatch, and a\n * plain count rule still counts it.\n */\nexport interface AdmonitionNode extends ContentNodeBase {\n  kind: \"admonition\";\n  variant?: \"note\" | \"tip\" | \"important\" | \"caution\" | \"warning\" | \"danger\";\n  children: ContentNode[];\n}\n\nexport interface ImageNode extends ContentNodeBase {\n  kind: \"image\";\n  url: string;\n  alt: string;\n  title?: string;\n}\n\nexport interface BlockquoteNode extends ContentNodeBase {\n  kind: \"blockquote\";\n  children: ContentNode[];\n}\n\nexport interface DefinitionItemNode {\n  kind: \"definitionItem\";\n  position: Position;\n  text: string;\n  term: string;\n  definition: ContentNode[];\n}\n\nexport interface DefinitionListNode extends ContentNodeBase {\n  kind: \"definitionList\";\n  children: DefinitionItemNode[];\n}\n\n/**\n * A named wrapper - an MDX/JSX component today, and where HTML and DITA may\n * eventually anchor a custom element. Its children are its own content, never\n * the enclosing section's: a rule reading a section's `children` must not see\n * inside an `<Element>` it did not ask about.\n */\nexport interface ElementNode extends ContentNodeBase {\n  kind: \"element\";\n  name: string;\n  attributes?: Record<string, string | true>;\n  children: ContentNode[];\n}\n\nexport type ContentNode =\n  | ParagraphNode\n  | CodeNode\n  | ListNode\n  | TableNode\n  | AdmonitionNode\n  | ImageNode\n  | BlockquoteNode\n  | DefinitionListNode\n  | ElementNode;\n\n/**\n * One section of a document, demarcated by a heading.\n *\n * `slug`/`title`/`level`/`order`/`parentSlug` intentionally match manni graph's\n * `Section` (dockg/src/types.ts), so its graph can be built from this tree.\n *\n * `children` is in document order and is the single source of truth: the\n * paragraph/codeBlock/list counts every rule needs are queries over it, not\n * separately maintained arrays.\n */\nexport interface SectionNode {\n  /** Slug of the heading, disambiguated across the document (`install-1`). */\n  slug: string;\n  /** Heading text, with inline markup flattened. */\n  title: string;\n  /** Heading level, 1-6. 0 for the implicit lead section before any heading. */\n  level: number;\n  /** 1-based position among siblings under the same parent. */\n  order: number;\n  /** Slug of the enclosing section, or null at the top level. */\n  parentSlug: string | null;\n  /** Span of the title itself. Null for the implicit lead section. */\n  titlePosition: Position | null;\n  /**\n   * The anchor the source itself gives this section, verbatim - an HTML `id`,\n   * a DITA `@id`, an AsciiDoc `[[id]]`, a reST `.. _label:` - when it gives\n   * one. `slug` stays the slugged title either way: a link written against\n   * the source's own id resolves through this, and nothing lint matches on\n   * reads it.\n   */\n  id?: string;\n  /**\n   * Set on the level-1 section `withMetadataTitle` made from a metadata\n   * `title`, so a consumer can tell it from a heading the author wrote. Its\n   * `titlePosition` is not enough: a reST title read back as docinfo shares\n   * its span with the frontmatter, written or not.\n   */\n  synthetic?: true;\n  /** Span of the whole section: its heading through the last node before the next sibling heading. */\n  position: Position;\n  /** Direct content, in document order, excluding anything owned by a subsection. */\n  children: ContentNode[];\n  /** Nested sections, in document order. */\n  sections: SectionNode[];\n}\n\n/** What a parser returns for one file. */\nexport interface DocumentTree {\n  /** Name of the parser that produced this (`markdown`, `asciidoc`, ...). */\n  format: string;\n  /** Path the content came from, for error messages. */\n  filePath: string;\n  /** Raw frontmatter/metadata values, or null when the file carries none. */\n  frontmatter: Record<string, unknown> | null;\n  /** Span of the frontmatter block, for anchoring findings about it. */\n  frontmatterPosition: Position | null;\n  /** Top-level sections, in document order. */\n  sections: SectionNode[];\n  /**\n   * Link targets exactly as the source wrote them, in document order, for\n   * `manni graph`. No lint rule reads them. Each parser decides what counts:\n   * an anchor to elsewhere does, and a stylesheet, a heading's own permalink,\n   * or a key reference resolved only at build time does not.\n   */\n  links: { target: string; position: Position }[];\n}\n\n/**\n * A parser for one input format.\n *\n * Shaped after docmeta's `MetadataExtractor` so the two registries read the\n * same way. A format is registered only when its parser reads it, so every\n * registered format is one the tool reads, and an extension no parser claims is\n * skipped by name rather than parsed as Markdown.\n */\nexport interface DocumentParser {\n  /** Stable name, also used as `DocumentTree.format`. */\n  name: string;\n  /** Human-readable label for `manni lint tools`. */\n  label: string;\n  /**\n   * The content kinds this parser actually emits today. A capability\n   * declaration, not the full `ContentKind` vocabulary: a kind absent here is\n   * one no rule will ever see from this parser's trees, whatever the format\n   * could in principle represent.\n   */\n  kinds: ContentKind[];\n  /** Lowercase file extensions this parser handles, incl. dot (e.g. \".md\"). */\n  extensions: string[];\n  /**\n   * Extensions safe to collect from a directory walk. Defaults to\n   * `extensions`.\n   *\n   * The two differ when an extension is a generic container rather than a\n   * documentation format. `.xml` is the case: this parser can read a DocBook\n   * or DITA document named explicitly, but a docs tree also contains\n   * `pom.xml`, `sitemap.xml`, and `.csproj`, and sweeping those in turns a\n   * clean run into a failure about files the user never asked to lint.\n   */\n  walkExtensions?: string[];\n  /** Parse raw file content into the generic tree. */\n  parse(content: string, filePath: string): DocumentTree;\n}\n\n/**\n * How much a finding weighs, on the one scale every manni tool speaks\n * (`src/shared/severity.ts`): `notice | warning | error`.\n *\n * Almost every structural finding is an `error`, since a template either\n * describes a document or it does not. `unsupported_content_kind` is the\n * exception and is a `warning`: the rule never ran, so the page may still be\n * fine, and a warning never moves the exit code.\n *\n * The scale is the family's and not this tool's private pair, because a flag\n * or config key two domains both have carries the same name *and* the same\n * values. Re-exported so `lint.Severity` names the same type a caller already\n * has.\n */\nexport type { Severity };\n\n/**\n * One structural violation.\n *\n * The field set is pinned by manni docevals' tool adapter, which reads\n * `{ type, heading, message, position }` off the JSON reporter. Additions are\n * safe; renames are not.\n */\nexport interface Finding {\n  /** Machine-readable rule id, e.g. `missing_section`. */\n  type: string;\n  /** Heading of the section the finding is anchored to, if any. */\n  heading: string | null;\n  message: string;\n  position: Position;\n  severity: Severity;\n}\n\n/**\n * Why a file was not linted.\n *\n * `unreadable` is the one that is not about the document: the file was found,\n * claimed by a parser, and then could not be opened - a denied permission, a\n * symlink loop, a page a doc build moved between the walk and the read. It is a\n * skip rather than a finding because nothing was checked, and calling it a\n * finding would report the docs as wrong when the filesystem was.\n */\nexport type SkipReason = \"no-template\" | \"unsupported-format\" | \"unreadable\";\n\n/** Result of linting one file. */\nexport interface FileResult {\n  file: string;\n  /** True when the file was linted and produced no findings. */\n  success: boolean;\n  findings: Finding[];\n  /** Template id/ref applied, or null when skipped. */\n  template: string | null;\n  /** Set when the file was skipped rather than linted. */\n  skipped?: SkipReason;\n}\n"],"mappings":";;;;;;AAsBO,IAAM,YAAN,cAAwB,UAAU;AAAA,EACvC,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;","names":[]}
+{"version":3,"sources":["../src/lint/types.ts"],"sourcesContent":["/**\n * The contract every other module is written against.\n *\n * Two shapes matter. `DocumentTree` is what a parser owes the rest of the tool:\n * a nested section tree with real source positions, in a vocabulary that has\n * nothing to do with Markdown. `Finding` is what the tool owes its caller.\n * Everything between the two - matching, rules, reporting - touches neither\n * mdast nor Asciidoctor nor parse5, which is what lets a new input format be\n * one file plus a line in the parser registry.\n */\n\nimport { ToolError } from \"../shared/errors.js\";\nimport type { Severity } from \"../shared/severity.js\";\n\n/**\n * Operational/usage failure. Exits 2; never used for lint findings.\n *\n * Extends the umbrella's `ToolError`, which is what the shared bin runner\n * matches on; the subclass stays so this tool's tests and library callers can\n * match on it by name. Named for its domain, as `A11yError`, `CiteError` and\n * `KeyError` are.\n */\nexport class LintError extends ToolError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"LintError\";\n  }\n}\n\n/** A point in a source file. Line and column are 1-based, offset 0-based. */\nexport interface Point {\n  line: number;\n  column: number;\n  offset: number;\n}\n\n/** A half-open source span, `start` inclusive and `end` exclusive. */\nexport interface Position {\n  start: Point;\n  end: Point;\n}\n\n/**\n * Content kinds a section can hold, named generically so a rule written once\n * works on every format. Each parser maps its own AST onto these: mdast\n * `paragraph`/`code`/`list`, Asciidoctor `paragraph`/`listing`/`ulist`|`olist`,\n * HTML `<p>`/`<pre>`/`<ul>` - all three onto `paragraph`/`codeBlock`/`list`.\n *\n * The vocabulary is wider than any one parser emits today. `table`,\n * `admonition`, `image`, `blockquote`, `definitionList`, and `element` are\n * declared here, and in each `DocumentParser.kinds`, only once a parser\n * actually produces them - see `src/lint/parsers/index.ts`.\n */\nexport type ContentKind =\n  | \"paragraph\"\n  | \"codeBlock\"\n  | \"list\"\n  | \"listItem\"\n  | \"table\"\n  | \"tableRow\"\n  | \"tableCell\"\n  | \"admonition\"\n  | \"image\"\n  | \"blockquote\"\n  | \"definitionList\"\n  | \"definitionItem\"\n  | \"element\";\n\nexport interface ContentNodeBase {\n  kind: ContentKind;\n  position: Position;\n  /** Plain-text rendering, used by pattern rules. */\n  text: string;\n}\n\nexport interface ParagraphNode extends ContentNodeBase {\n  kind: \"paragraph\";\n}\n\nexport interface CodeNode extends ContentNodeBase {\n  kind: \"codeBlock\";\n  /** Language, when the format carries one. */\n  language?: string;\n  /** The info-string tail after the language, when the format carries one. */\n  fenceInfo?: string;\n}\n\nexport interface ListItemNode {\n  kind: \"listItem\";\n  position: Position;\n  text: string;\n  /** Nested content, so item-level paragraph/code/list rules can run. */\n  children: ContentNode[];\n}\n\nexport interface ListNode extends ContentNodeBase {\n  kind: \"list\";\n  ordered: boolean;\n  items: ListItemNode[];\n}\n\nexport interface TableCellNode extends ContentNodeBase {\n  kind: \"tableCell\";\n  children: ContentNode[];\n}\n\nexport interface TableRowNode extends ContentNodeBase {\n  kind: \"tableRow\";\n  header: boolean;\n  children: TableCellNode[];\n}\n\nexport interface TableNode extends ContentNodeBase {\n  kind: \"table\";\n  children: TableRowNode[];\n}\n\n/**\n * A callout, and the flavor the source gave it.\n *\n * `variant` is optional because not every format names one this vocabulary\n * has. reStructuredText has `hint`, `attention`, `error` and a generic\n * `admonition` directive, and a bare HTML `<aside>` says nothing at all. Those\n * produce an admonition with no variant rather than an invented equivalence:\n * mapping `hint` onto `tip` would make `variant: tip` pass on a page that\n * never said tip. A `variant:` rule reports such a node as a mismatch, and a\n * plain count rule still counts it.\n */\nexport interface AdmonitionNode extends ContentNodeBase {\n  kind: \"admonition\";\n  variant?: \"note\" | \"tip\" | \"important\" | \"caution\" | \"warning\" | \"danger\";\n  children: ContentNode[];\n}\n\nexport interface ImageNode extends ContentNodeBase {\n  kind: \"image\";\n  url: string;\n  alt: string;\n  title?: string;\n}\n\nexport interface BlockquoteNode extends ContentNodeBase {\n  kind: \"blockquote\";\n  children: ContentNode[];\n}\n\nexport interface DefinitionItemNode {\n  kind: \"definitionItem\";\n  position: Position;\n  text: string;\n  term: string;\n  definition: ContentNode[];\n}\n\nexport interface DefinitionListNode extends ContentNodeBase {\n  kind: \"definitionList\";\n  children: DefinitionItemNode[];\n}\n\n/**\n * A named wrapper - an MDX/JSX component today, and where HTML and DITA may\n * eventually anchor a custom element. Its children are its own content, never\n * the enclosing section's: a rule reading a section's `children` must not see\n * inside an `<Element>` it did not ask about.\n */\nexport interface ElementNode extends ContentNodeBase {\n  kind: \"element\";\n  name: string;\n  attributes?: Record<string, string | true>;\n  children: ContentNode[];\n}\n\nexport type ContentNode =\n  | ParagraphNode\n  | CodeNode\n  | ListNode\n  | TableNode\n  | AdmonitionNode\n  | ImageNode\n  | BlockquoteNode\n  | DefinitionListNode\n  | ElementNode;\n\n/**\n * One section of a document, demarcated by a heading.\n *\n * `slug`/`title`/`level`/`order`/`parentSlug` intentionally match manni graph's\n * `Section` (dockg/src/types.ts), so its graph can be built from this tree.\n *\n * `children` is in document order and is the single source of truth: the\n * paragraph/codeBlock/list counts every rule needs are queries over it, not\n * separately maintained arrays.\n */\nexport interface SectionNode {\n  /** Slug of the heading, disambiguated across the document (`install-1`). */\n  slug: string;\n  /** Heading text, with inline markup flattened. */\n  title: string;\n  /** Heading level, 1-6. 0 for the implicit lead section before any heading. */\n  level: number;\n  /** 1-based position among siblings under the same parent. */\n  order: number;\n  /** Slug of the enclosing section, or null at the top level. */\n  parentSlug: string | null;\n  /** Span of the title itself. Null for the implicit lead section. */\n  titlePosition: Position | null;\n  /**\n   * The anchor the source itself gives this section, verbatim - an HTML `id`,\n   * a DITA `@id`, an AsciiDoc `[[id]]`, a reST `.. _label:` - when it gives\n   * one. `slug` stays the slugged title either way: a link written against\n   * the source's own id resolves through this, and nothing lint matches on\n   * reads it.\n   */\n  id?: string;\n  /**\n   * Set on the level-1 section `withMetadataTitle` made from a metadata\n   * `title`, so a consumer can tell it from a heading the author wrote. Its\n   * `titlePosition` is not enough: a reST title read back as docinfo shares\n   * its span with the frontmatter, written or not.\n   */\n  synthetic?: true;\n  /** Span of the whole section: its heading through the last node before the next sibling heading. */\n  position: Position;\n  /** Direct content, in document order, excluding anything owned by a subsection. */\n  children: ContentNode[];\n  /** Nested sections, in document order. */\n  sections: SectionNode[];\n}\n\n/** What a parser returns for one file. */\nexport interface DocumentTree {\n  /** Name of the parser that produced this (`markdown`, `asciidoc`, ...). */\n  format: string;\n  /** Path the content came from, for error messages. */\n  filePath: string;\n  /** Raw frontmatter/metadata values, or null when the file carries none. */\n  frontmatter: Record<string, unknown> | null;\n  /** Span of the frontmatter block, for anchoring findings about it. */\n  frontmatterPosition: Position | null;\n  /** Top-level sections, in document order. */\n  sections: SectionNode[];\n  /**\n   * Link targets exactly as the source wrote them, in document order, for\n   * `manni graph`. No lint rule reads them. Each parser decides what counts:\n   * an anchor to elsewhere does, and a stylesheet, a heading's own permalink,\n   * or a key reference resolved only at build time does not.\n   */\n  links: { target: string; position: Position }[];\n}\n\n/**\n * A parser for one input format.\n *\n * Shaped after docmeta's `MetadataExtractor` so the two registries read the\n * same way. A format is registered only when its parser reads it, so every\n * registered format is one the tool reads, and an extension no parser claims is\n * skipped by name rather than parsed as Markdown.\n */\nexport interface DocumentParser {\n  /** Stable name, also used as `DocumentTree.format`. */\n  name: string;\n  /** Human-readable label for `manni lint tools`. */\n  label: string;\n  /**\n   * The content kinds this parser actually emits today. A capability\n   * declaration, not the full `ContentKind` vocabulary: a kind absent here is\n   * one no rule will ever see from this parser's trees, whatever the format\n   * could in principle represent.\n   */\n  kinds: ContentKind[];\n  /** Lowercase file extensions this parser handles, incl. dot (e.g. \".md\"). */\n  extensions: string[];\n  /**\n   * Extensions safe to collect from a directory walk. Defaults to\n   * `extensions`.\n   *\n   * The two differ when an extension is a generic container rather than a\n   * documentation format. `.xml` is the case: this parser can read a DocBook\n   * or DITA document named explicitly, but a docs tree also contains\n   * `pom.xml`, `sitemap.xml`, and `.csproj`, and sweeping those in turns a\n   * clean run into a failure about files the user never asked to lint.\n   */\n  walkExtensions?: string[];\n  /** Parse raw file content into the generic tree. */\n  parse(content: string, filePath: string): DocumentTree;\n}\n\n/**\n * How much a finding weighs, on the one scale every manni tool speaks\n * (`src/shared/severity.ts`): `notice | warning | error`.\n *\n * Almost every structural finding is an `error`, since a template either\n * describes a document or it does not. `unsupported_content_kind` is the\n * exception and is a `warning`: the rule never ran, so the page may still be\n * fine, and a warning never moves the exit code.\n *\n * The scale is the family's and not this tool's private pair, because a flag\n * or config key two domains both have carries the same name *and* the same\n * values. Re-exported so `lint.Severity` names the same type a caller already\n * has.\n */\nexport type { Severity };\n\n/**\n * One structural violation.\n *\n * The field set is pinned by manni docevals' tool adapter, which reads\n * `{ type, heading, message, position }` off the JSON reporter. Additions are\n * safe; renames are not.\n */\nexport interface Finding {\n  /** Machine-readable rule id, e.g. `missing_section`. */\n  type: string;\n  /** Heading of the section the finding is anchored to, if any. */\n  heading: string | null;\n  message: string;\n  position: Position;\n  severity: Severity;\n  /**\n   * The template that judged the page and the rule this finding is about, so\n   * an author reads what the section is for beside what is wrong with it.\n   * `null` when no template stands behind the finding: a parse failure, an\n   * unknown doctype, a broken template, or a tool other than manni.\n   */\n  template?: FindingTemplate | null;\n}\n\n/** What a template asks for, as a finding carries it. */\nexport interface FindingTemplate {\n  /** The template's ref, as `manni lint templates` lists it and `--template` takes it. */\n  id: string;\n  /** The rule's `id`. `null` for a rule without one, the template itself, or no rule at all. */\n  rule: string | null;\n  /** The rule's `description`, or `null` when it has none. */\n  description: string | null;\n  /** The template's `guide`, after `extends`, or `null`. */\n  guide: string | null;\n}\n\n/**\n * Why a file was not linted.\n *\n * `unreadable` is the one that is not about the document: the file was found,\n * claimed by a parser, and then could not be opened - a denied permission, a\n * symlink loop, a page a doc build moved between the walk and the read. It is a\n * skip rather than a finding because nothing was checked, and calling it a\n * finding would report the docs as wrong when the filesystem was.\n */\nexport type SkipReason = \"no-template\" | \"unsupported-format\" | \"unreadable\";\n\n/** Result of linting one file. */\nexport interface FileResult {\n  file: string;\n  /** True when the file was linted and produced no findings. */\n  success: boolean;\n  findings: Finding[];\n  /** Template id/ref applied, or null when skipped. */\n  template: string | null;\n  /** Set when the file was skipped rather than linted. */\n  skipped?: SkipReason;\n}\n"],"mappings":";;;;;;AAsBO,IAAM,YAAN,cAAwB,UAAU;AAAA,EACvC,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;","names":[]}

package/dist/{chunk-PNUM6RHR.js → chunk-TDCOKKMI.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   LintError
-} from "./chunk-YGFIQ6Y5.js";
+} from "./chunk-SCLXVTFZ.js";
 import {
   extractFrontmatter,
   extractorForExtension,
   locateFrontmatter
-} from "./chunk-Y4TDIUG6.js";
+} from "./chunk-HY6ROJTH.js";
 import {
   errorMessage
 } from "./chunk-G3T47CFV.js";
@@ -3247,4 +3247,4 @@ export {
   unsupportedFormatMessage,
   listFormats
 };
-//# sourceMappingURL=chunk-PNUM6RHR.js.map
+//# sourceMappingURL=chunk-TDCOKKMI.js.map

package/dist/{chunk-X4GQ4HPY.js → chunk-TQ3W6RKG.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   pathKey
-} from "./chunk-5NNPEPVM.js";
+} from "./chunk-PCGBXHSE.js";
 import {
   DEFAULT_CAPTURE_DIR,
   makeRedactor
@@ -230,4 +230,4 @@ export {
   rollup,
   writeLedger
 };
-//# sourceMappingURL=chunk-X4GQ4HPY.js.map
+//# sourceMappingURL=chunk-TQ3W6RKG.js.map

package/dist/{chunk-EX6E2P6Z.js → chunk-ULDV2LUI.js}

@@ -2,7 +2,7 @@
 import {
   TERM_FIELDS,
   displayPath
-} from "./chunk-3QUCVYNX.js";
+} from "./chunk-3XGTNN3M.js";
 
 // src/term/reporters/json.ts
 function termEntry(term) {
@@ -49,4 +49,4 @@ export {
   renderFindingsJson,
   renderFormatsJson
 };
-//# sourceMappingURL=chunk-EX6E2P6Z.js.map
+//# sourceMappingURL=chunk-ULDV2LUI.js.map

package/dist/{chunk-XP4RNQZL.js → chunk-UQMLCIRX.js}

@@ -1,26 +1,34 @@
 #!/usr/bin/env node
 import {
   LINT_JOBS,
+  classifyRef,
   listBuiltins,
+  loadResolvedTemplate,
+  loadTemplate,
   loadTemplateFile,
   resolveLintRun,
   resolveStructureTool
-} from "./chunk-7QH2ZI4F.js";
+} from "./chunk-NWUXRV6N.js";
 import {
   parserByName,
   parserForExtension,
   unsupportedFormatMessage
-} from "./chunk-PNUM6RHR.js";
+} from "./chunk-TDCOKKMI.js";
 import {
   BLOCK_KINDS,
-  BLOCK_KIND_NODE
-} from "./chunk-TBAMBLF3.js";
+  BLOCK_KIND_NODE,
+  occurrenceRange,
+  quoteList
+} from "./chunk-6ZFJWUUH.js";
 import {
   LintError
-} from "./chunk-YGFIQ6Y5.js";
+} from "./chunk-SCLXVTFZ.js";
 import {
   writeTextAtomic
-} from "./chunk-EBZ4QKKX.js";
+} from "./chunk-LNGSE7V2.js";
+import {
+  palette
+} from "./chunk-RNVYGWIC.js";
 import {
   ToolError,
   errorMessage
@@ -149,12 +157,15 @@ import { mkdir, readFile } from "node:fs/promises";
 import { basename, dirname, extname, resolve } from "node:path";
 var BUILTIN_SOURCE = "builtin";
 async function runTemplates(opts = {}) {
-  const templates = listBuiltins().map((builtin) => ({
-    id: builtin.id,
-    title: builtin.title,
-    types: builtin.types,
-    source: BUILTIN_SOURCE
-  }));
+  const templates = await Promise.all(
+    listBuiltins().map(async (builtin) => ({
+      id: builtin.id,
+      title: builtin.title,
+      types: builtin.types,
+      source: BUILTIN_SOURCE,
+      guide: (await loadTemplate(builtin.id)).guide ?? null
+    }))
+  );
   const paths = opts.templates == null ? [] : Array.isArray(opts.templates) ? opts.templates : [opts.templates];
   for (const path of paths) {
     const file = await loadTemplateFile(path);
@@ -163,7 +174,8 @@ async function runTemplates(opts = {}) {
         id,
         title: "",
         types: template.types ?? [],
-        source: path
+        source: path,
+        guide: template.guide ?? null
       });
     }
   }
@@ -248,6 +260,21 @@ async function runTemplatesInfer(opts) {
   await writeTextAtomic(absOut, text);
   return { name, file, text, written: opts.out };
 }
+async function runTemplateShow(opts) {
+  const template = await loadResolvedTemplate(opts.ref);
+  const { extends: _extends, id: _id, ...body } = template;
+  if (classifyRef(opts.ref).kind === "builtin") {
+    const title = listBuiltins().find((b) => b.id === opts.ref)?.title;
+    return { id: opts.ref, source: BUILTIN_SOURCE, ...title ? { title } : {}, ...body };
+  }
+  const hash = opts.ref.lastIndexOf("#");
+  const source = hash === -1 ? opts.ref : opts.ref.slice(0, hash);
+  const fragment = hash === -1 ? "" : opts.ref.slice(hash + 1);
+  const id = fragment || // The `?? ""` is unreachable: loadResolvedTemplate already refused a file
+  // with no templates, and one with several but no fragment.
+  (Object.keys((await loadTemplateFile(source)).templates ?? {})[0] ?? "");
+  return { id, source, ...body };
+}
 
 // src/lint/commands/tools.ts
 var REPORTABLE_KINDS = new Set(Object.values(BLOCK_KIND_NODE));
@@ -289,13 +316,213 @@ async function runTools(opts = {}) {
   );
 }
 
+// src/lint/reporters/template-show.ts
+var SHOW_FORMATS = ["pretty", "json", "markdown"];
+function isShowFormat(value) {
+  return SHOW_FORMATS.includes(value);
+}
+function occurrenceWords(rule) {
+  const { min, max } = occurrenceRange(rule);
+  if (max === 0) return "forbidden";
+  if (max === null) {
+    if (min === 0) return "optional, repeats";
+    if (min === 1) return "required, repeats";
+    return `at least ${min}`;
+  }
+  if (min === 1 && max === 1) return "required";
+  if (min === 0 && max === 1) return "optional";
+  return `${min} to ${max}`;
+}
+function headingForm(heading) {
+  if (heading === void 0) return "(any heading)";
+  if (heading === false) return "(no heading)";
+  if (typeof heading === "string") return heading;
+  if (Array.isArray(heading)) return heading.join(" | ");
+  return `/${heading.pattern}/`;
+}
+var NOUNS = {
+  paragraphs: "paragraph",
+  codeBlocks: "code block",
+  lists: "list",
+  tables: "table",
+  admonitions: "admonition",
+  images: "image",
+  blockquotes: "blockquote",
+  definitionLists: "definition list",
+  elements: "element"
+};
+function noun(kind, block) {
+  if (kind === "lists" && block.lists?.ordered !== void 0) {
+    return block.lists.ordered ? "numbered list" : "bulleted list";
+  }
+  if (kind === "admonitions" && block.admonitions?.variant !== void 0) {
+    return `${block.admonitions.variant} admonition`;
+  }
+  const tag = block.elements?.tag;
+  if (kind === "elements" && tag !== void 0) {
+    const tags = Array.isArray(tag) ? tag : [tag];
+    return `${tags.map((t) => `"${t}"`).join(" or ")} element`;
+  }
+  return NOUNS[kind];
+}
+function plural(word, n) {
+  return n === 1 ? word : `${word}s`;
+}
+function counted(range, word) {
+  const { min, max } = occurrenceRange(range);
+  if (max === 0) return `no ${plural(word, 0)}`;
+  if (max === null) {
+    return min === 0 ? `any number of ${plural(word, 0)}` : `at least ${min} ${plural(word, min)}`;
+  }
+  if (min === 0) return `at most ${max} ${plural(word, max)}`;
+  if (min === max) return `exactly ${min} ${plural(word, min)}`;
+  return `${min} to ${max} ${plural(word, max)}`;
+}
+function qualifiers(block) {
+  const parts = [];
+  if (block.paragraphs?.pattern !== void 0) {
+    parts.push(`each matching /${block.paragraphs.pattern}/`);
+  }
+  const language = block.codeBlocks?.language;
+  if (language !== void 0) {
+    parts.push(`in ${(Array.isArray(language) ? language : [language]).join(" or ")}`);
+  }
+  if (block.codeBlocks?.fenceInfo !== void 0) {
+    parts.push(`with fence info "${block.codeBlocks.fenceInfo}"`);
+  }
+  if (block.lists?.items !== void 0) {
+    parts.push(`each with ${counted(block.lists.items, "item")}`);
+  }
+  if (block.tables?.columns !== void 0) {
+    parts.push(`with columns ${quoteList(block.tables.columns)}`);
+  }
+  return parts.map((p) => `, ${p}`).join("");
+}
+function contentLines(rule) {
+  const lines = [];
+  const contains = rule.contains;
+  if (contains !== void 0) {
+    for (const kind of BLOCK_KINDS) {
+      const range = contains[kind];
+      if (range === void 0) continue;
+      lines.push(
+        `Contains ${counted(range, noun(kind, contains))}${qualifiers({ [kind]: range })}.`
+      );
+    }
+  }
+  if (rule.sequence !== void 0) {
+    const kinds = rule.sequence.flatMap((entry) => {
+      const kind = BLOCK_KINDS.find((k) => entry[k] !== void 0);
+      return kind === void 0 ? [] : [noun(kind, entry)];
+    });
+    lines.push(`In order: ${kinds.join(", ")}.`);
+  }
+  return lines;
+}
+function detailLines(rule) {
+  return [...contentLines(rule), ...rule.description === void 0 ? [] : [rule.description]];
+}
+function prettyRule(c, rule, level, indent, out) {
+  const pad = " ".repeat(indent);
+  const hashes = "#".repeat(level);
+  const occurs = c.dim(occurrenceWords(rule));
+  if (rule.repeat !== void 0) {
+    const group = rule.id === void 0 ? "(group)" : `(group ${rule.id})`;
+    out.push(`${pad}${hashes} ${group}  ${occurs}`);
+  } else {
+    const id = rule.id === void 0 ? "" : `${c.cyan(rule.id)} \xB7 `;
+    out.push(`${pad}${hashes} ${headingForm(rule.heading)}  ${id}${occurs}`);
+  }
+  for (const line of detailLines(rule)) out.push(`${pad}   ${line}`);
+  for (const member of rule.repeat ?? []) prettyRule(c, member, level, indent + 2, out);
+  for (const section of rule.sections ?? []) {
+    prettyRule(c, section, level + 1, indent + 2, out);
+  }
+}
+function renderPrettyShow(show, c) {
+  const title = show.title ? `  ${c.dim("\u2014")}  ${show.title}` : "";
+  const lines = [`${c.bold(show.id)}${title}`];
+  if (show.types !== void 0 && show.types.length > 0) {
+    lines.push(`  types: ${show.types.join(", ")}`);
+  }
+  if (show.description !== void 0) lines.push(`  ${show.description}`);
+  for (const line of contentLines(show)) lines.push(`  ${line}`);
+  if (show.guide !== void 0) lines.push(`  Guide: ${show.guide}`);
+  const sections = show.sections ?? [];
+  if (sections.length > 0) lines.push("");
+  for (const section of sections) prettyRule(c, section, 2, 2, lines);
+  return lines.join("\n");
+}
+function skeletonRules(rules) {
+  const kept = (rules ?? []).filter((rule) => occurrenceRange(rule).max !== 0);
+  const last = kept[kept.length - 1];
+  if (last !== void 0 && last.id === void 0 && last.heading === void 0 && last.repeat === void 0) {
+    kept.pop();
+  }
+  return kept;
+}
+function sentence(text) {
+  const trimmed = text.trim();
+  return /[.!?]$/.test(trimmed) ? trimmed : `${trimmed}.`;
+}
+function comment(parts) {
+  return `<!-- ${parts.join(" ").replace(/-(?=-)/g, "- ")} -->`;
+}
+function capitalise(text) {
+  return text.charAt(0).toUpperCase() + text.slice(1);
+}
+function headingText(heading) {
+  if (typeof heading === "string") return heading;
+  return Array.isArray(heading) ? heading[0] : void 0;
+}
+function markdownRule(rule, level, out) {
+  if (rule.repeat !== void 0) {
+    for (const member of skeletonRules(rule.repeat)) markdownRule(member, level, out);
+  } else {
+    if (rule.heading !== false) {
+      const text = headingText(rule.heading) ?? `{${rule.id ?? "section"}}`;
+      out.push(`${"#".repeat(level)} ${text}`, "");
+    }
+    out.push(
+      comment([sentence(capitalise(occurrenceWords(rule))), ...detailLines(rule).map(sentence)]),
+      ""
+    );
+  }
+  for (const section of skeletonRules(rule.sections)) markdownRule(section, level + 1, out);
+}
+function renderMarkdownShow(show) {
+  const lines = [];
+  const type = show.types?.[0];
+  if (type !== void 0) lines.push("---", `type: ${type}`, "---", "");
+  lines.push(`# ${headingText(show.heading) ?? "{Title}"}`, "");
+  const parts = [
+    sentence(show.id),
+    ...contentLines(show),
+    ...show.description === void 0 ? [] : [sentence(show.description)],
+    ...show.guide === void 0 ? [] : [`Guide: ${show.guide}`]
+  ];
+  lines.push(comment(parts), "");
+  for (const section of skeletonRules(show.sections)) markdownRule(section, 2, lines);
+  return lines.join("\n").trimEnd();
+}
+function renderTemplateShow(show, format, opts = {}) {
+  if (format === "json") return JSON.stringify(show, null, 2);
+  if (format === "markdown") return renderMarkdownShow(show);
+  return renderPrettyShow(show, palette(opts.color ?? false));
+}
+
 export {
   INFER_FORMATS,
   isInferFormat,
   BUILTIN_SOURCE,
   runTemplates,
   runTemplatesInfer,
+  runTemplateShow,
   BUILT_IN_DEFAULTS,
-  runTools
+  runTools,
+  SHOW_FORMATS,
+  isShowFormat,
+  occurrenceWords,
+  renderTemplateShow
 };
-//# sourceMappingURL=chunk-XP4RNQZL.js.map
+//# sourceMappingURL=chunk-UQMLCIRX.js.map