@hawkeyexl/manni 2.2.0 → 2.3.1

package/dist/docmeta.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   buildProgram
-} from "./chunk-2Q5JUEIO.js";
+} from "./chunk-ESOEJTV2.js";
 import {
   runIfMain
-} from "./chunk-5O4FIGDJ.js";
+} from "./chunk-HUHERW7E.js";
 
 // src/docmeta.ts
 runIfMain(import.meta.url, () => buildProgram().name("docmeta"));

package/dist/index.d.ts

@@ -128,14 +128,6 @@ interface MetadataExtractor {
     name: string;
     /** Lowercase file extensions this extractor handles, incl. dot (e.g. ".md"). */
     extensions: string[];
-    /**
-     * Whether this extractor can *read* — false for a format that is registered
-     * but not yet wired up. Every registered extractor sets it true today; it is
-     * kept because it is a distinct capability from writability, which is the
-     * presence of `apply`. A format can read without writing, and one being
-     * added could be declared before it can do either.
-     */
-    implemented: boolean;
     /**
      * Extract metadata from raw file content.
      *
@@ -358,6 +350,16 @@ declare function selectCollections(collections: readonly CollectionConfig[], nam
  */
 declare function isMember(collection: CollectionConfig, relPath: string): boolean;
 
+/** Vale's settings under `tools.vale`. */
+interface ValeToolConfig {
+    /** Vale's config file, as written, relative to `manni.config.yaml`. */
+    config?: string;
+}
+/** The document's top-level `tools:`, one namespace per outside tool. */
+interface ToolsConfig {
+    vale?: ValeToolConfig;
+}
+
 interface ConfigFile {
     /** Absolute path to the file. */
     path: string;
@@ -387,6 +389,12 @@ interface ConfigFile {
      * document *is* the tool's section, so it carries no family-wide keys.
      */
     collections: CollectionConfig[];
+    /**
+     * The document's top-level `tools:` (proposal 0052), an outside tool's
+     * settings, parsed once here for the same reason as `collections`. `{}` when
+     * the key is absent, and always `{}` for a `legacy` file.
+     */
+    tools: ToolsConfig;
     /**
      * The document's top-level `encryptionKey:` (proposal 0045), validated
      * here. Absent when the key is, and always absent for a `legacy` file, for
@@ -2092,7 +2100,6 @@ interface SchemasInfo {
     formats: {
         name: string;
         extensions: string[];
-        implemented: boolean;
         /** Whether `manni meta fill` can write metadata back to this format. */
         writable: boolean;
     }[];
@@ -3422,15 +3429,13 @@ contents: string | Uint8Array): Promise<void>;
 
 /**
  * Extractor registry. Maps file extensions to extractors and resolves an
- * extractor by name (for the `--as` override). Every registered extractor is
- * implemented today; the `implemented` filters below are what would keep a
- * declared-but-unwired format out of directory walks, so an unfinished format
- * can be registered without becoming "supported".
+ * extractor by name (for the `--as` override). A registered extractor reads
+ * its format, so registration is what makes an extension supported.
  */
 
-/** Resolve an implemented extractor for a file extension (incl. dot). */
+/** Resolve the extractor for a file extension (incl. dot). */
 declare function extractorForExtension(ext: string): MetadataExtractor | undefined;
-/** Extensions handled by implemented extractors (used for directory walks). */
+/** Extensions handled by registered extractors (used for directory walks). */
 declare function supportedExtensions(): string[];
 
 type KeySource = "env" | "config" | "none";
@@ -4118,12 +4123,9 @@ declare function readSource(root: string, index: SourceIndex, range: SourceRange
  * `indexOf` for the delimiters, never a regex over the whole page, and is
  * handed the body only, so a `cite` inside frontmatter is never matched.
  *
- * It does not read code. An opener inside a fenced block (``` or ~~~ in
- * markdown and mdx, indented or not; `----` in asciidoc; an unclosed fence
- * runs to the end, as a renderer reads it) or inside a backtick span (a run of
- * backticks closed by a run of the same length on the same line) is skipped,
- * so a page that documents the syntax carries no statements. html and xml
- * have neither; a `<pre>` is not code to this scanner.
+ * It does not read code. An opener inside a fenced block or a backtick span,
+ * as `src/shared/code-regions.ts` finds them, is skipped, so a page that
+ * documents the syntax carries no statements.
  *
  * Every form parses in both markdown and mdx. The first form is what
  * `formatStatement` writes: the html comment for markdown, the jsx comment
@@ -4146,9 +4148,10 @@ declare function detectEol(text: string): "\n" | "\r\n";
 /**
  * The paragraph starting at or after `offset` (skipping blank lines), as
  * `{ start, end, line }` file offsets and the file line it starts on. A fence
- * opener ends the search with no paragraph.
+ * opener ends the search with no paragraph. Given a `format`, a marker-only
+ * line is skipped like a blank one before the paragraph, and ends it after.
  */
-declare function paragraphAfter(content: string, offset: number): {
+declare function paragraphAfter(content: string, offset: number, format?: string): {
     start: number;
     end: number;
     line: number;
@@ -4201,8 +4204,10 @@ declare function insideFence(text: string, bodyOffset: number, line: number, for
 /**
  * The lines a marker anchors, as 1-based lines of `text`: the rest of its own
  * line when that carries text, else the paragraph or fenced block that
- * follows. With `quote`, the next fenced block after it, wherever that is.
- * Undefined when nothing follows to anchor.
+ * follows. Marker-only lines below it are skipped, so markers stacked above
+ * one paragraph all anchor it, and none is part of the pin. With `quote`, the
+ * next fenced block after it, wherever that is. Undefined when nothing
+ * follows to anchor.
  */
 declare function anchoredLines(text: string, after: number, format: string, quote?: boolean): {
     start: number;

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   reencryptMetadata,
   runKeyRotate,
   runKeySet
-} from "./chunk-6JWX6JM2.js";
+} from "./chunk-CD3LHG26.js";
 import {
   BinMissing,
   COMMON_FORMATS,
@@ -127,7 +127,7 @@ import {
   valueOf,
   vendorFileName,
   writeFileAtomic
-} from "./chunk-5O4FIGDJ.js";
+} from "./chunk-HUHERW7E.js";
 
 // src/key/index.ts
 var key_exports = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hawkeyexl/manni",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "description": "One command line for documentation that is meant to be checked. `manni meta` validates the presence and format of document metadata (Markdown frontmatter and more) against JSON Schema, built for CI. Formerly docmeta.",
   "type": "module",
   "bin": {
@@ -85,6 +85,7 @@
     "ajv-formats": "^3.0.1",
     "commander": "^15.0.0",
     "fast-glob": "^3.3.2",
+    "github-slugger": "^2.0.0",
     "parse5": "^8.0.1",
     "picocolors": "^1.1.1",
     "picomatch": "^4.0.7",