@utilix-tech/sdk 0.86.0 → 0.87.0

package/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 Full release notes for all Utilix surfaces (browser tools, REST API, SDKs, MCP server) live at [utilix.tech/changelog](https://utilix.tech/changelog). This file tracks just this package.
 
+## 0.87.0
+- Add `validateMarkdownHeadingHierarchy` (markdown-heading-hierarchy-validator): scan a Markdown document's ATX headings and flag heading-structure issues: skipped levels, multiple H1s, empty headings, duplicate headings at the same level, and a document that doesn't start at H1.
+
 ## 0.86.0
 - Add `calculateSalesCommission` (sales-commission-calculator): compute a flat or tiered (marginal) sales commission from a sale amount, where tiered mode applies each rate only to the slice of sales within that tier, plus an optional base salary added to the total payout.
 - Add `buildCharacterClass` (regex-character-class-builder): assemble a `[...]` regex character class from named building blocks (lowercase, uppercase, digits, whitespace), custom ranges, and literal custom characters, with optional negation.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**724 developer utility functions for Node.js: runs locally, no API key required.**
+**725 developer utility functions for Node.js: runs locally, no API key required.**
 
 [![npm version](https://img.shields.io/npm/v/@utilix-tech/sdk?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@utilix-tech/sdk)
 [![npm downloads](https://img.shields.io/npm/dm/@utilix-tech/sdk?style=flat-square)](https://www.npmjs.com/package/@utilix-tech/sdk)
@@ -1049,7 +1049,7 @@ readMidiInfo(new Uint8Array(midiBytes));
 | `@utilix-tech/sdk/encoding` | Base64, URL, HTML entities, Base32/Base58/Base62 encode/decode |
 | `@utilix-tech/sdk/hashing` | MD5, SHA-1/256/512, bcrypt, HMAC, .htpasswd, SRI hashes, content-hash ETag generation |
 | `@utilix-tech/sdk/text` | Case convert, slugify, word count, lorem ipsum, line ops, HTML→Markdown, Levenshtein/Damerau string distance, readability scoring, sentence length distribution, emoji lookup |
-| `@utilix-tech/sdk/data` | CSV, YAML, TOML, XML, INI, NDJSON parse and convert, NDJSON record deduplicator, SRT/WebVTT subtitles, Markdown front matter parser, YAML anchor/alias resolver, CSV column type inferencer, Markdown table column aligner |
+| `@utilix-tech/sdk/data` | CSV, YAML, TOML, XML, INI, NDJSON parse and convert, NDJSON record deduplicator, SRT/WebVTT subtitles, Markdown front matter parser, YAML anchor/alias resolver, CSV column type inferencer, Markdown table column aligner, Markdown heading hierarchy validator |
 | `@utilix-tech/sdk/generators` | UUID v4/v7, ULID, passwords, strength check, entropy estimator, fake data, CSP nonce generator |
 | `@utilix-tech/sdk/time` | Date diff, timezone convert, cron parse, relative time |
 | `@utilix-tech/sdk/units` | Bytes, CSS px/rem, number bases, currency format, credit card/IBAN/barcode/ISBN/VIN/ISIN validation, loan calculator, EMI calculator, compound/simple interest calculators, VAT/sales tax calculator, tip/bill split calculator, break-even point calculator, Rule of 72 calculator, savings goal calculator, ROI calculator, cash denomination/till calculator, payback period calculator, CD maturity calculator, debt-to-income ratio calculator, freelancer hourly rate calculator, debt snowball/avalanche payoff planner, tax-equivalent yield calculator, mortgage discount points break-even calculator, loan prepayment penalty calculator, data transfer time / required bandwidth estimator, real rate of return (Fisher equation) calculator, sales commission calculator (flat or tiered) |

package/dist/{chunk-XOUS3M5Z.js → chunk-CUQDHXUX.js}

@@ -54,6 +54,7 @@ __export(data_exports, {
   tomlToJson: () => tomlToJson,
   validateEnvKey: () => validateEnvKey,
   validateIni: () => validateIni,
+  validateMarkdownHeadingHierarchy: () => validateMarkdownHeadingHierarchy,
   validateNdjson: () => validateNdjson,
   validateToml: () => validateToml,
   validateXml: () => validateXml,
@@ -1580,6 +1581,84 @@ function generateMarkdownToc(markdown, options = {}) {
   });
   return { toc: tocLines.join("\n"), entries };
 }
+var HEADING_HIERARCHY_RE = /^(#{1,6})(?!#)(?:[ \t]+(.*?))?[ \t]*#*[ \t]*$/;
+function validateMarkdownHeadingHierarchy(markdown) {
+  const lines = markdown.replace(/\r\n/g, "\n").split("\n");
+  const headings = [];
+  let inFence = false;
+  let fenceMarker = "";
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const fenceMatch = line.match(/^\s*(```+|~~~+)/);
+    if (fenceMatch) {
+      if (!inFence) {
+        inFence = true;
+        fenceMarker = fenceMatch[1][0];
+      } else if (fenceMatch[1][0] === fenceMarker) {
+        inFence = false;
+      }
+      continue;
+    }
+    if (inFence) continue;
+    const match = line.match(HEADING_HIERARCHY_RE);
+    if (!match) continue;
+    const level = match[1].length;
+    const text = stripInlineMarkdown(match[2] ?? "");
+    headings.push({ line: i + 1, level, text });
+  }
+  const issues = [];
+  const seen = /* @__PURE__ */ new Map();
+  let h1Count = 0;
+  let firstH1Line = null;
+  let prevLevel = null;
+  headings.forEach((h, idx) => {
+    if (h.text === "") {
+      issues.push({ line: h.line, type: "empty-heading", message: `Heading at line ${h.line} has no text` });
+    }
+    if (idx === 0 && h.level !== 1) {
+      issues.push({
+        line: h.line,
+        type: "starts-below-h1",
+        message: `Document starts with an H${h.level} heading instead of H1`
+      });
+    }
+    if (h.level === 1) {
+      h1Count++;
+      if (h1Count === 1) {
+        firstH1Line = h.line;
+      } else {
+        issues.push({
+          line: h.line,
+          type: "multiple-h1",
+          message: `Multiple H1 headings found: another H1 at line ${h.line} (first was at line ${firstH1Line})`
+        });
+      }
+    }
+    if (prevLevel !== null && h.level > prevLevel + 1) {
+      const skipped = h.level - prevLevel > 2 ? `H${prevLevel + 1}-H${h.level - 1}` : `H${prevLevel + 1}`;
+      issues.push({
+        line: h.line,
+        type: "skipped-level",
+        message: `Heading level jumps from H${prevLevel} to H${h.level} at line ${h.line}, skipping ${skipped}`
+      });
+    }
+    prevLevel = h.level;
+    if (h.text !== "") {
+      const key = `${h.level}:${h.text.toLowerCase()}`;
+      const earlierLine = seen.get(key);
+      if (earlierLine !== void 0) {
+        issues.push({
+          line: h.line,
+          type: "duplicate-heading",
+          message: `Heading "${h.text}" at line ${h.line} duplicates an H${h.level} heading at line ${earlierLine}`
+        });
+      } else {
+        seen.set(key, h.line);
+      }
+    }
+  });
+  return { headings, issues, h1Count };
+}
 function quoteSqlIdentifier(name, dialect) {
   if (dialect === "mysql") return "`" + name.replace(/`/g, "``") + "`";
   return '"' + name.replace(/"/g, '""') + '"';
@@ -1976,4 +2055,4 @@ function alignMarkdownTables(markdown) {
   return { output: outputLines.join("\n"), tables, warnings };
 }
 
-export { alignMarkdownTables, analyzeCaptionSpeed, calculateMarkdownTaskListProgress, convertSubtitles, csvToJson, csvToSqlInsert, data_exports, dedupeNdjson, detectDelimiter, detectSubtitleFormat, diffEnvExample, envToExport, envToJson, findCsvDuplicateRows, formatNdjson, formatSubtitleTimestamp, formatToml, formatXml, generateMarkdownToc, getSection, getSectionNames, getTomlStats, getXmlStats, getYamlStats, inferCsvColumnTypes, iniToJson, jsonArrayToNdjson, jsonToIni, jsonToToml, jsonToXml, minifyNdjson, minifyToml, minifyXml, ndjsonToCsv, ndjsonToJsonArray, parseCsv, parseEnv, parseFrontMatter, parseIni, parseSubtitleTimestamp, parseSubtitles, parseXmlToObject, resolveYamlAnchors, serializeSubtitles, shiftSubtitles, stringifyIni, toCsvString, tomlToJson, validateEnvKey, validateIni, validateNdjson, validateToml, validateXml, validateYaml, xmlToJson };
+export { alignMarkdownTables, analyzeCaptionSpeed, calculateMarkdownTaskListProgress, convertSubtitles, csvToJson, csvToSqlInsert, data_exports, dedupeNdjson, detectDelimiter, detectSubtitleFormat, diffEnvExample, envToExport, envToJson, findCsvDuplicateRows, formatNdjson, formatSubtitleTimestamp, formatToml, formatXml, generateMarkdownToc, getSection, getSectionNames, getTomlStats, getXmlStats, getYamlStats, inferCsvColumnTypes, iniToJson, jsonArrayToNdjson, jsonToIni, jsonToToml, jsonToXml, minifyNdjson, minifyToml, minifyXml, ndjsonToCsv, ndjsonToJsonArray, parseCsv, parseEnv, parseFrontMatter, parseIni, parseSubtitleTimestamp, parseSubtitles, parseXmlToObject, resolveYamlAnchors, serializeSubtitles, shiftSubtitles, stringifyIni, toCsvString, tomlToJson, validateEnvKey, validateIni, validateMarkdownHeadingHierarchy, validateNdjson, validateToml, validateXml, validateYaml, xmlToJson };

package/dist/{data-DIyBrJ6l.d.cts → data-Cz1Q0sg0.d.cts}

@@ -21,6 +21,7 @@
  *  - csv-duplicate-row-finder: findCsvDuplicateRows
  *  - yaml-anchor-resolver: resolveYamlAnchors
  *  - markdown-table-aligner: alignMarkdownTables
+ *  - markdown-heading-hierarchy-validator: validateMarkdownHeadingHierarchy
  */
 interface ValidationResult {
     valid: boolean;
@@ -384,6 +385,30 @@ interface MarkdownTocResult {
 declare function generateMarkdownToc(markdown: string, options?: MarkdownTocOptions): MarkdownTocResult | {
     error: string;
 };
+type HeadingIssueType = 'empty-heading' | 'multiple-h1' | 'skipped-level' | 'duplicate-heading' | 'starts-below-h1';
+interface HeadingEntry {
+    line: number;
+    level: number;
+    text: string;
+}
+interface HeadingIssue {
+    line: number;
+    type: HeadingIssueType;
+    message: string;
+}
+interface HeadingHierarchyResult {
+    headings: HeadingEntry[];
+    issues: HeadingIssue[];
+    h1Count: number;
+}
+/**
+ * Scans a Markdown document's ATX headings and validates the overall
+ * heading hierarchy: a level that skips one or more levels going deeper,
+ * more than one H1, an empty heading, a duplicate heading at the same
+ * level, or a document that doesn't start at H1. Setext-style headings are
+ * not recognized, and headings inside fenced code blocks are ignored.
+ */
+declare function validateMarkdownHeadingHierarchy(markdown: string): HeadingHierarchyResult;
 interface CsvToSqlOptions {
     tableName?: string;
     dialect?: 'ansi' | 'mysql';
@@ -563,6 +588,10 @@ type data_EnvEntry = EnvEntry;
 type data_EnvParseResult = EnvParseResult;
 type data_FrontMatterError = FrontMatterError;
 type data_FrontMatterResult = FrontMatterResult;
+type data_HeadingEntry = HeadingEntry;
+type data_HeadingHierarchyResult = HeadingHierarchyResult;
+type data_HeadingIssue = HeadingIssue;
+type data_HeadingIssueType = HeadingIssueType;
 type data_IniSection = IniSection;
 type data_MarkdownTableAlignResult = MarkdownTableAlignResult;
 type data_MarkdownTableColumnAlignment = MarkdownTableColumnAlignment;
@@ -637,13 +666,14 @@ declare const data_toCsvString: typeof toCsvString;
 declare const data_tomlToJson: typeof tomlToJson;
 declare const data_validateEnvKey: typeof validateEnvKey;
 declare const data_validateIni: typeof validateIni;
+declare const data_validateMarkdownHeadingHierarchy: typeof validateMarkdownHeadingHierarchy;
 declare const data_validateNdjson: typeof validateNdjson;
 declare const data_validateToml: typeof validateToml;
 declare const data_validateXml: typeof validateXml;
 declare const data_validateYaml: typeof validateYaml;
 declare const data_xmlToJson: typeof xmlToJson;
 declare namespace data {
-  export { type data_CaptionSpeedCue as CaptionSpeedCue, type data_CaptionSpeedResult as CaptionSpeedResult, type data_ConvertedSubtitles as ConvertedSubtitles, type data_CsvColumnType as CsvColumnType, type data_CsvColumnTypeInfo as CsvColumnTypeInfo, type data_CsvColumnTypeOptions as CsvColumnTypeOptions, type data_CsvColumnTypeResult as CsvColumnTypeResult, type data_CsvDuplicateGroup as CsvDuplicateGroup, type data_CsvDuplicateOptions as CsvDuplicateOptions, type data_CsvDuplicateResult as CsvDuplicateResult, type data_CsvParseResult as CsvParseResult, type data_CsvToSqlOptions as CsvToSqlOptions, type data_CsvToSqlResult as CsvToSqlResult, type data_EnvDiffError as EnvDiffError, type data_EnvDiffResult as EnvDiffResult, type data_EnvEntry as EnvEntry, type data_EnvParseResult as EnvParseResult, type data_FrontMatterError as FrontMatterError, type data_FrontMatterResult as FrontMatterResult, type data_IniSection as IniSection, type data_MarkdownTableAlignResult as MarkdownTableAlignResult, type data_MarkdownTableColumnAlignment as MarkdownTableColumnAlignment, type data_MarkdownTableInfo as MarkdownTableInfo, type data_MarkdownTaskListItem as MarkdownTaskListItem, type data_MarkdownTaskListProgressResult as MarkdownTaskListProgressResult, type data_MarkdownTaskListSectionSummary as MarkdownTaskListSectionSummary, type data_MarkdownTocEntry as MarkdownTocEntry, type data_MarkdownTocOptions as MarkdownTocOptions, type data_MarkdownTocResult as MarkdownTocResult, type data_NdjsonDedupeResult as NdjsonDedupeResult, type data_NdjsonLineResult as NdjsonLineResult, type data_NdjsonValidateResult as NdjsonValidateResult, type data_ParseOptions as ParseOptions, type data_ParsedIni as ParsedIni, type data_ParsedSubtitles as ParsedSubtitles, type data_SubtitleCue as SubtitleCue, type data_SubtitleFormat as SubtitleFormat, type data_TomlFormatResult as TomlFormatResult, type data_ValidationResult as ValidationResult, type data_XmlFormatResult as XmlFormatResult, type data_XmlToJsonOptions as XmlToJsonOptions, type data_YamlAnchorInfo as YamlAnchorInfo, type data_YamlAnchorResolveError as YamlAnchorResolveError, type data_YamlAnchorResolveResult as YamlAnchorResolveResult, data_alignMarkdownTables as alignMarkdownTables, data_analyzeCaptionSpeed as analyzeCaptionSpeed, data_calculateMarkdownTaskListProgress as calculateMarkdownTaskListProgress, data_convertSubtitles as convertSubtitles, data_csvToJson as csvToJson, data_csvToSqlInsert as csvToSqlInsert, data_dedupeNdjson as dedupeNdjson, data_detectDelimiter as detectDelimiter, data_detectSubtitleFormat as detectSubtitleFormat, data_diffEnvExample as diffEnvExample, data_envToExport as envToExport, data_envToJson as envToJson, data_findCsvDuplicateRows as findCsvDuplicateRows, data_formatNdjson as formatNdjson, data_formatSubtitleTimestamp as formatSubtitleTimestamp, data_formatToml as formatToml, data_formatXml as formatXml, data_generateMarkdownToc as generateMarkdownToc, data_getSection as getSection, data_getSectionNames as getSectionNames, data_getTomlStats as getTomlStats, data_getXmlStats as getXmlStats, data_getYamlStats as getYamlStats, data_inferCsvColumnTypes as inferCsvColumnTypes, data_iniToJson as iniToJson, data_jsonArrayToNdjson as jsonArrayToNdjson, data_jsonToIni as jsonToIni, data_jsonToToml as jsonToToml, data_jsonToXml as jsonToXml, data_minifyNdjson as minifyNdjson, data_minifyToml as minifyToml, data_minifyXml as minifyXml, data_ndjsonToCsv as ndjsonToCsv, data_ndjsonToJsonArray as ndjsonToJsonArray, data_parseCsv as parseCsv, data_parseEnv as parseEnv, data_parseFrontMatter as parseFrontMatter, data_parseIni as parseIni, data_parseSubtitleTimestamp as parseSubtitleTimestamp, data_parseSubtitles as parseSubtitles, data_parseXmlToObject as parseXmlToObject, data_resolveYamlAnchors as resolveYamlAnchors, data_serializeSubtitles as serializeSubtitles, data_shiftSubtitles as shiftSubtitles, data_stringifyIni as stringifyIni, data_toCsvString as toCsvString, data_tomlToJson as tomlToJson, data_validateEnvKey as validateEnvKey, data_validateIni as validateIni, data_validateNdjson as validateNdjson, data_validateToml as validateToml, data_validateXml as validateXml, data_validateYaml as validateYaml, data_xmlToJson as xmlToJson };
+  export { type data_CaptionSpeedCue as CaptionSpeedCue, type data_CaptionSpeedResult as CaptionSpeedResult, type data_ConvertedSubtitles as ConvertedSubtitles, type data_CsvColumnType as CsvColumnType, type data_CsvColumnTypeInfo as CsvColumnTypeInfo, type data_CsvColumnTypeOptions as CsvColumnTypeOptions, type data_CsvColumnTypeResult as CsvColumnTypeResult, type data_CsvDuplicateGroup as CsvDuplicateGroup, type data_CsvDuplicateOptions as CsvDuplicateOptions, type data_CsvDuplicateResult as CsvDuplicateResult, type data_CsvParseResult as CsvParseResult, type data_CsvToSqlOptions as CsvToSqlOptions, type data_CsvToSqlResult as CsvToSqlResult, type data_EnvDiffError as EnvDiffError, type data_EnvDiffResult as EnvDiffResult, type data_EnvEntry as EnvEntry, type data_EnvParseResult as EnvParseResult, type data_FrontMatterError as FrontMatterError, type data_FrontMatterResult as FrontMatterResult, type data_HeadingEntry as HeadingEntry, type data_HeadingHierarchyResult as HeadingHierarchyResult, type data_HeadingIssue as HeadingIssue, type data_HeadingIssueType as HeadingIssueType, type data_IniSection as IniSection, type data_MarkdownTableAlignResult as MarkdownTableAlignResult, type data_MarkdownTableColumnAlignment as MarkdownTableColumnAlignment, type data_MarkdownTableInfo as MarkdownTableInfo, type data_MarkdownTaskListItem as MarkdownTaskListItem, type data_MarkdownTaskListProgressResult as MarkdownTaskListProgressResult, type data_MarkdownTaskListSectionSummary as MarkdownTaskListSectionSummary, type data_MarkdownTocEntry as MarkdownTocEntry, type data_MarkdownTocOptions as MarkdownTocOptions, type data_MarkdownTocResult as MarkdownTocResult, type data_NdjsonDedupeResult as NdjsonDedupeResult, type data_NdjsonLineResult as NdjsonLineResult, type data_NdjsonValidateResult as NdjsonValidateResult, type data_ParseOptions as ParseOptions, type data_ParsedIni as ParsedIni, type data_ParsedSubtitles as ParsedSubtitles, type data_SubtitleCue as SubtitleCue, type data_SubtitleFormat as SubtitleFormat, type data_TomlFormatResult as TomlFormatResult, type data_ValidationResult as ValidationResult, type data_XmlFormatResult as XmlFormatResult, type data_XmlToJsonOptions as XmlToJsonOptions, type data_YamlAnchorInfo as YamlAnchorInfo, type data_YamlAnchorResolveError as YamlAnchorResolveError, type data_YamlAnchorResolveResult as YamlAnchorResolveResult, data_alignMarkdownTables as alignMarkdownTables, data_analyzeCaptionSpeed as analyzeCaptionSpeed, data_calculateMarkdownTaskListProgress as calculateMarkdownTaskListProgress, data_convertSubtitles as convertSubtitles, data_csvToJson as csvToJson, data_csvToSqlInsert as csvToSqlInsert, data_dedupeNdjson as dedupeNdjson, data_detectDelimiter as detectDelimiter, data_detectSubtitleFormat as detectSubtitleFormat, data_diffEnvExample as diffEnvExample, data_envToExport as envToExport, data_envToJson as envToJson, data_findCsvDuplicateRows as findCsvDuplicateRows, data_formatNdjson as formatNdjson, data_formatSubtitleTimestamp as formatSubtitleTimestamp, data_formatToml as formatToml, data_formatXml as formatXml, data_generateMarkdownToc as generateMarkdownToc, data_getSection as getSection, data_getSectionNames as getSectionNames, data_getTomlStats as getTomlStats, data_getXmlStats as getXmlStats, data_getYamlStats as getYamlStats, data_inferCsvColumnTypes as inferCsvColumnTypes, data_iniToJson as iniToJson, data_jsonArrayToNdjson as jsonArrayToNdjson, data_jsonToIni as jsonToIni, data_jsonToToml as jsonToToml, data_jsonToXml as jsonToXml, data_minifyNdjson as minifyNdjson, data_minifyToml as minifyToml, data_minifyXml as minifyXml, data_ndjsonToCsv as ndjsonToCsv, data_ndjsonToJsonArray as ndjsonToJsonArray, data_parseCsv as parseCsv, data_parseEnv as parseEnv, data_parseFrontMatter as parseFrontMatter, data_parseIni as parseIni, data_parseSubtitleTimestamp as parseSubtitleTimestamp, data_parseSubtitles as parseSubtitles, data_parseXmlToObject as parseXmlToObject, data_resolveYamlAnchors as resolveYamlAnchors, data_serializeSubtitles as serializeSubtitles, data_shiftSubtitles as shiftSubtitles, data_stringifyIni as stringifyIni, data_toCsvString as toCsvString, data_tomlToJson as tomlToJson, data_validateEnvKey as validateEnvKey, data_validateIni as validateIni, data_validateMarkdownHeadingHierarchy as validateMarkdownHeadingHierarchy, data_validateNdjson as validateNdjson, data_validateToml as validateToml, data_validateXml as validateXml, data_validateYaml as validateYaml, data_xmlToJson as xmlToJson };
 }
 
-export { detectSubtitleFormat as $, type NdjsonValidateResult as A, type ParsedIni as B, type CaptionSpeedCue as C, type ParsedSubtitles as D, type EnvDiffError as E, type FrontMatterError as F, type SubtitleFormat as G, type XmlToJsonOptions as H, type IniSection as I, type YamlAnchorResolveError as J, type YamlAnchorResolveResult as K, alignMarkdownTables as L, type MarkdownTableAlignResult as M, type NdjsonDedupeResult as N, analyzeCaptionSpeed as O, type ParseOptions as P, calculateMarkdownTaskListProgress as Q, convertSubtitles as R, type SubtitleCue as S, type TomlFormatResult as T, csvToJson as U, type ValidationResult as V, csvToSqlInsert as W, type XmlFormatResult as X, type YamlAnchorInfo as Y, dedupeNdjson as Z, detectDelimiter as _, type CaptionSpeedResult as a, diffEnvExample as a0, envToExport as a1, envToJson as a2, findCsvDuplicateRows as a3, formatNdjson as a4, formatSubtitleTimestamp as a5, formatToml as a6, formatXml as a7, generateMarkdownToc as a8, getSection as a9, toCsvString as aA, tomlToJson as aB, validateEnvKey as aC, validateIni as aD, validateNdjson as aE, validateToml as aF, validateXml as aG, validateYaml as aH, xmlToJson as aI, getSectionNames as aa, getTomlStats as ab, getXmlStats as ac, getYamlStats as ad, inferCsvColumnTypes as ae, iniToJson as af, jsonArrayToNdjson as ag, jsonToIni as ah, jsonToToml as ai, jsonToXml as aj, minifyNdjson as ak, minifyToml as al, minifyXml as am, ndjsonToCsv as an, ndjsonToJsonArray as ao, parseCsv as ap, parseEnv as aq, parseFrontMatter as ar, parseIni as as, parseSubtitleTimestamp as at, parseSubtitles as au, parseXmlToObject as av, resolveYamlAnchors as aw, serializeSubtitles as ax, shiftSubtitles as ay, stringifyIni as az, type ConvertedSubtitles as b, type CsvColumnType as c, data as d, type CsvColumnTypeInfo as e, type CsvColumnTypeOptions as f, type CsvColumnTypeResult as g, type CsvDuplicateGroup as h, type CsvDuplicateOptions as i, type CsvDuplicateResult as j, type CsvParseResult as k, type CsvToSqlOptions as l, type CsvToSqlResult as m, type EnvDiffResult as n, type EnvEntry as o, type EnvParseResult as p, type FrontMatterResult as q, type MarkdownTableColumnAlignment as r, type MarkdownTableInfo as s, type MarkdownTaskListItem as t, type MarkdownTaskListProgressResult as u, type MarkdownTaskListSectionSummary as v, type MarkdownTocEntry as w, type MarkdownTocOptions as x, type MarkdownTocResult as y, type NdjsonLineResult as z };
+export { csvToJson as $, type MarkdownTocOptions as A, type MarkdownTocResult as B, type CaptionSpeedCue as C, type NdjsonLineResult as D, type EnvDiffError as E, type FrontMatterError as F, type NdjsonValidateResult as G, type HeadingEntry as H, type IniSection as I, type ParsedIni as J, type ParsedSubtitles as K, type SubtitleFormat as L, type MarkdownTableAlignResult as M, type NdjsonDedupeResult as N, type XmlToJsonOptions as O, type ParseOptions as P, type YamlAnchorResolveError as Q, type YamlAnchorResolveResult as R, type SubtitleCue as S, type TomlFormatResult as T, alignMarkdownTables as U, type ValidationResult as V, analyzeCaptionSpeed as W, type XmlFormatResult as X, type YamlAnchorInfo as Y, calculateMarkdownTaskListProgress as Z, convertSubtitles as _, type CaptionSpeedResult as a, csvToSqlInsert as a0, dedupeNdjson as a1, detectDelimiter as a2, detectSubtitleFormat as a3, diffEnvExample as a4, envToExport as a5, envToJson as a6, findCsvDuplicateRows as a7, formatNdjson as a8, formatSubtitleTimestamp as a9, resolveYamlAnchors as aA, serializeSubtitles as aB, shiftSubtitles as aC, stringifyIni as aD, toCsvString as aE, tomlToJson as aF, validateEnvKey as aG, validateIni as aH, validateMarkdownHeadingHierarchy as aI, validateNdjson as aJ, validateToml as aK, validateXml as aL, validateYaml as aM, xmlToJson as aN, formatToml as aa, formatXml as ab, generateMarkdownToc as ac, getSection as ad, getSectionNames as ae, getTomlStats as af, getXmlStats as ag, getYamlStats as ah, inferCsvColumnTypes as ai, iniToJson as aj, jsonArrayToNdjson as ak, jsonToIni as al, jsonToToml as am, jsonToXml as an, minifyNdjson as ao, minifyToml as ap, minifyXml as aq, ndjsonToCsv as ar, ndjsonToJsonArray as as, parseCsv as at, parseEnv as au, parseFrontMatter as av, parseIni as aw, parseSubtitleTimestamp as ax, parseSubtitles as ay, parseXmlToObject as az, type ConvertedSubtitles as b, type CsvColumnType as c, data as d, type CsvColumnTypeInfo as e, type CsvColumnTypeOptions as f, type CsvColumnTypeResult as g, type CsvDuplicateGroup as h, type CsvDuplicateOptions as i, type CsvDuplicateResult as j, type CsvParseResult as k, type CsvToSqlOptions as l, type CsvToSqlResult as m, type EnvDiffResult as n, type EnvEntry as o, type EnvParseResult as p, type FrontMatterResult as q, type HeadingHierarchyResult as r, type HeadingIssue as s, type HeadingIssueType as t, type MarkdownTableColumnAlignment as u, type MarkdownTableInfo as v, type MarkdownTaskListItem as w, type MarkdownTaskListProgressResult as x, type MarkdownTaskListSectionSummary as y, type MarkdownTocEntry as z };

package/dist/{data-DIyBrJ6l.d.ts → data-Cz1Q0sg0.d.ts}

@@ -21,6 +21,7 @@
  *  - csv-duplicate-row-finder: findCsvDuplicateRows
  *  - yaml-anchor-resolver: resolveYamlAnchors
  *  - markdown-table-aligner: alignMarkdownTables
+ *  - markdown-heading-hierarchy-validator: validateMarkdownHeadingHierarchy
  */
 interface ValidationResult {
     valid: boolean;
@@ -384,6 +385,30 @@ interface MarkdownTocResult {
 declare function generateMarkdownToc(markdown: string, options?: MarkdownTocOptions): MarkdownTocResult | {
     error: string;
 };
+type HeadingIssueType = 'empty-heading' | 'multiple-h1' | 'skipped-level' | 'duplicate-heading' | 'starts-below-h1';
+interface HeadingEntry {
+    line: number;
+    level: number;
+    text: string;
+}
+interface HeadingIssue {
+    line: number;
+    type: HeadingIssueType;
+    message: string;
+}
+interface HeadingHierarchyResult {
+    headings: HeadingEntry[];
+    issues: HeadingIssue[];
+    h1Count: number;
+}
+/**
+ * Scans a Markdown document's ATX headings and validates the overall
+ * heading hierarchy: a level that skips one or more levels going deeper,
+ * more than one H1, an empty heading, a duplicate heading at the same
+ * level, or a document that doesn't start at H1. Setext-style headings are
+ * not recognized, and headings inside fenced code blocks are ignored.
+ */
+declare function validateMarkdownHeadingHierarchy(markdown: string): HeadingHierarchyResult;
 interface CsvToSqlOptions {
     tableName?: string;
     dialect?: 'ansi' | 'mysql';
@@ -563,6 +588,10 @@ type data_EnvEntry = EnvEntry;
 type data_EnvParseResult = EnvParseResult;
 type data_FrontMatterError = FrontMatterError;
 type data_FrontMatterResult = FrontMatterResult;
+type data_HeadingEntry = HeadingEntry;
+type data_HeadingHierarchyResult = HeadingHierarchyResult;
+type data_HeadingIssue = HeadingIssue;
+type data_HeadingIssueType = HeadingIssueType;
 type data_IniSection = IniSection;
 type data_MarkdownTableAlignResult = MarkdownTableAlignResult;
 type data_MarkdownTableColumnAlignment = MarkdownTableColumnAlignment;
@@ -637,13 +666,14 @@ declare const data_toCsvString: typeof toCsvString;
 declare const data_tomlToJson: typeof tomlToJson;
 declare const data_validateEnvKey: typeof validateEnvKey;
 declare const data_validateIni: typeof validateIni;
+declare const data_validateMarkdownHeadingHierarchy: typeof validateMarkdownHeadingHierarchy;
 declare const data_validateNdjson: typeof validateNdjson;
 declare const data_validateToml: typeof validateToml;
 declare const data_validateXml: typeof validateXml;
 declare const data_validateYaml: typeof validateYaml;
 declare const data_xmlToJson: typeof xmlToJson;
 declare namespace data {
-  export { type data_CaptionSpeedCue as CaptionSpeedCue, type data_CaptionSpeedResult as CaptionSpeedResult, type data_ConvertedSubtitles as ConvertedSubtitles, type data_CsvColumnType as CsvColumnType, type data_CsvColumnTypeInfo as CsvColumnTypeInfo, type data_CsvColumnTypeOptions as CsvColumnTypeOptions, type data_CsvColumnTypeResult as CsvColumnTypeResult, type data_CsvDuplicateGroup as CsvDuplicateGroup, type data_CsvDuplicateOptions as CsvDuplicateOptions, type data_CsvDuplicateResult as CsvDuplicateResult, type data_CsvParseResult as CsvParseResult, type data_CsvToSqlOptions as CsvToSqlOptions, type data_CsvToSqlResult as CsvToSqlResult, type data_EnvDiffError as EnvDiffError, type data_EnvDiffResult as EnvDiffResult, type data_EnvEntry as EnvEntry, type data_EnvParseResult as EnvParseResult, type data_FrontMatterError as FrontMatterError, type data_FrontMatterResult as FrontMatterResult, type data_IniSection as IniSection, type data_MarkdownTableAlignResult as MarkdownTableAlignResult, type data_MarkdownTableColumnAlignment as MarkdownTableColumnAlignment, type data_MarkdownTableInfo as MarkdownTableInfo, type data_MarkdownTaskListItem as MarkdownTaskListItem, type data_MarkdownTaskListProgressResult as MarkdownTaskListProgressResult, type data_MarkdownTaskListSectionSummary as MarkdownTaskListSectionSummary, type data_MarkdownTocEntry as MarkdownTocEntry, type data_MarkdownTocOptions as MarkdownTocOptions, type data_MarkdownTocResult as MarkdownTocResult, type data_NdjsonDedupeResult as NdjsonDedupeResult, type data_NdjsonLineResult as NdjsonLineResult, type data_NdjsonValidateResult as NdjsonValidateResult, type data_ParseOptions as ParseOptions, type data_ParsedIni as ParsedIni, type data_ParsedSubtitles as ParsedSubtitles, type data_SubtitleCue as SubtitleCue, type data_SubtitleFormat as SubtitleFormat, type data_TomlFormatResult as TomlFormatResult, type data_ValidationResult as ValidationResult, type data_XmlFormatResult as XmlFormatResult, type data_XmlToJsonOptions as XmlToJsonOptions, type data_YamlAnchorInfo as YamlAnchorInfo, type data_YamlAnchorResolveError as YamlAnchorResolveError, type data_YamlAnchorResolveResult as YamlAnchorResolveResult, data_alignMarkdownTables as alignMarkdownTables, data_analyzeCaptionSpeed as analyzeCaptionSpeed, data_calculateMarkdownTaskListProgress as calculateMarkdownTaskListProgress, data_convertSubtitles as convertSubtitles, data_csvToJson as csvToJson, data_csvToSqlInsert as csvToSqlInsert, data_dedupeNdjson as dedupeNdjson, data_detectDelimiter as detectDelimiter, data_detectSubtitleFormat as detectSubtitleFormat, data_diffEnvExample as diffEnvExample, data_envToExport as envToExport, data_envToJson as envToJson, data_findCsvDuplicateRows as findCsvDuplicateRows, data_formatNdjson as formatNdjson, data_formatSubtitleTimestamp as formatSubtitleTimestamp, data_formatToml as formatToml, data_formatXml as formatXml, data_generateMarkdownToc as generateMarkdownToc, data_getSection as getSection, data_getSectionNames as getSectionNames, data_getTomlStats as getTomlStats, data_getXmlStats as getXmlStats, data_getYamlStats as getYamlStats, data_inferCsvColumnTypes as inferCsvColumnTypes, data_iniToJson as iniToJson, data_jsonArrayToNdjson as jsonArrayToNdjson, data_jsonToIni as jsonToIni, data_jsonToToml as jsonToToml, data_jsonToXml as jsonToXml, data_minifyNdjson as minifyNdjson, data_minifyToml as minifyToml, data_minifyXml as minifyXml, data_ndjsonToCsv as ndjsonToCsv, data_ndjsonToJsonArray as ndjsonToJsonArray, data_parseCsv as parseCsv, data_parseEnv as parseEnv, data_parseFrontMatter as parseFrontMatter, data_parseIni as parseIni, data_parseSubtitleTimestamp as parseSubtitleTimestamp, data_parseSubtitles as parseSubtitles, data_parseXmlToObject as parseXmlToObject, data_resolveYamlAnchors as resolveYamlAnchors, data_serializeSubtitles as serializeSubtitles, data_shiftSubtitles as shiftSubtitles, data_stringifyIni as stringifyIni, data_toCsvString as toCsvString, data_tomlToJson as tomlToJson, data_validateEnvKey as validateEnvKey, data_validateIni as validateIni, data_validateNdjson as validateNdjson, data_validateToml as validateToml, data_validateXml as validateXml, data_validateYaml as validateYaml, data_xmlToJson as xmlToJson };
+  export { type data_CaptionSpeedCue as CaptionSpeedCue, type data_CaptionSpeedResult as CaptionSpeedResult, type data_ConvertedSubtitles as ConvertedSubtitles, type data_CsvColumnType as CsvColumnType, type data_CsvColumnTypeInfo as CsvColumnTypeInfo, type data_CsvColumnTypeOptions as CsvColumnTypeOptions, type data_CsvColumnTypeResult as CsvColumnTypeResult, type data_CsvDuplicateGroup as CsvDuplicateGroup, type data_CsvDuplicateOptions as CsvDuplicateOptions, type data_CsvDuplicateResult as CsvDuplicateResult, type data_CsvParseResult as CsvParseResult, type data_CsvToSqlOptions as CsvToSqlOptions, type data_CsvToSqlResult as CsvToSqlResult, type data_EnvDiffError as EnvDiffError, type data_EnvDiffResult as EnvDiffResult, type data_EnvEntry as EnvEntry, type data_EnvParseResult as EnvParseResult, type data_FrontMatterError as FrontMatterError, type data_FrontMatterResult as FrontMatterResult, type data_HeadingEntry as HeadingEntry, type data_HeadingHierarchyResult as HeadingHierarchyResult, type data_HeadingIssue as HeadingIssue, type data_HeadingIssueType as HeadingIssueType, type data_IniSection as IniSection, type data_MarkdownTableAlignResult as MarkdownTableAlignResult, type data_MarkdownTableColumnAlignment as MarkdownTableColumnAlignment, type data_MarkdownTableInfo as MarkdownTableInfo, type data_MarkdownTaskListItem as MarkdownTaskListItem, type data_MarkdownTaskListProgressResult as MarkdownTaskListProgressResult, type data_MarkdownTaskListSectionSummary as MarkdownTaskListSectionSummary, type data_MarkdownTocEntry as MarkdownTocEntry, type data_MarkdownTocOptions as MarkdownTocOptions, type data_MarkdownTocResult as MarkdownTocResult, type data_NdjsonDedupeResult as NdjsonDedupeResult, type data_NdjsonLineResult as NdjsonLineResult, type data_NdjsonValidateResult as NdjsonValidateResult, type data_ParseOptions as ParseOptions, type data_ParsedIni as ParsedIni, type data_ParsedSubtitles as ParsedSubtitles, type data_SubtitleCue as SubtitleCue, type data_SubtitleFormat as SubtitleFormat, type data_TomlFormatResult as TomlFormatResult, type data_ValidationResult as ValidationResult, type data_XmlFormatResult as XmlFormatResult, type data_XmlToJsonOptions as XmlToJsonOptions, type data_YamlAnchorInfo as YamlAnchorInfo, type data_YamlAnchorResolveError as YamlAnchorResolveError, type data_YamlAnchorResolveResult as YamlAnchorResolveResult, data_alignMarkdownTables as alignMarkdownTables, data_analyzeCaptionSpeed as analyzeCaptionSpeed, data_calculateMarkdownTaskListProgress as calculateMarkdownTaskListProgress, data_convertSubtitles as convertSubtitles, data_csvToJson as csvToJson, data_csvToSqlInsert as csvToSqlInsert, data_dedupeNdjson as dedupeNdjson, data_detectDelimiter as detectDelimiter, data_detectSubtitleFormat as detectSubtitleFormat, data_diffEnvExample as diffEnvExample, data_envToExport as envToExport, data_envToJson as envToJson, data_findCsvDuplicateRows as findCsvDuplicateRows, data_formatNdjson as formatNdjson, data_formatSubtitleTimestamp as formatSubtitleTimestamp, data_formatToml as formatToml, data_formatXml as formatXml, data_generateMarkdownToc as generateMarkdownToc, data_getSection as getSection, data_getSectionNames as getSectionNames, data_getTomlStats as getTomlStats, data_getXmlStats as getXmlStats, data_getYamlStats as getYamlStats, data_inferCsvColumnTypes as inferCsvColumnTypes, data_iniToJson as iniToJson, data_jsonArrayToNdjson as jsonArrayToNdjson, data_jsonToIni as jsonToIni, data_jsonToToml as jsonToToml, data_jsonToXml as jsonToXml, data_minifyNdjson as minifyNdjson, data_minifyToml as minifyToml, data_minifyXml as minifyXml, data_ndjsonToCsv as ndjsonToCsv, data_ndjsonToJsonArray as ndjsonToJsonArray, data_parseCsv as parseCsv, data_parseEnv as parseEnv, data_parseFrontMatter as parseFrontMatter, data_parseIni as parseIni, data_parseSubtitleTimestamp as parseSubtitleTimestamp, data_parseSubtitles as parseSubtitles, data_parseXmlToObject as parseXmlToObject, data_resolveYamlAnchors as resolveYamlAnchors, data_serializeSubtitles as serializeSubtitles, data_shiftSubtitles as shiftSubtitles, data_stringifyIni as stringifyIni, data_toCsvString as toCsvString, data_tomlToJson as tomlToJson, data_validateEnvKey as validateEnvKey, data_validateIni as validateIni, data_validateMarkdownHeadingHierarchy as validateMarkdownHeadingHierarchy, data_validateNdjson as validateNdjson, data_validateToml as validateToml, data_validateXml as validateXml, data_validateYaml as validateYaml, data_xmlToJson as xmlToJson };
 }
 
-export { detectSubtitleFormat as $, type NdjsonValidateResult as A, type ParsedIni as B, type CaptionSpeedCue as C, type ParsedSubtitles as D, type EnvDiffError as E, type FrontMatterError as F, type SubtitleFormat as G, type XmlToJsonOptions as H, type IniSection as I, type YamlAnchorResolveError as J, type YamlAnchorResolveResult as K, alignMarkdownTables as L, type MarkdownTableAlignResult as M, type NdjsonDedupeResult as N, analyzeCaptionSpeed as O, type ParseOptions as P, calculateMarkdownTaskListProgress as Q, convertSubtitles as R, type SubtitleCue as S, type TomlFormatResult as T, csvToJson as U, type ValidationResult as V, csvToSqlInsert as W, type XmlFormatResult as X, type YamlAnchorInfo as Y, dedupeNdjson as Z, detectDelimiter as _, type CaptionSpeedResult as a, diffEnvExample as a0, envToExport as a1, envToJson as a2, findCsvDuplicateRows as a3, formatNdjson as a4, formatSubtitleTimestamp as a5, formatToml as a6, formatXml as a7, generateMarkdownToc as a8, getSection as a9, toCsvString as aA, tomlToJson as aB, validateEnvKey as aC, validateIni as aD, validateNdjson as aE, validateToml as aF, validateXml as aG, validateYaml as aH, xmlToJson as aI, getSectionNames as aa, getTomlStats as ab, getXmlStats as ac, getYamlStats as ad, inferCsvColumnTypes as ae, iniToJson as af, jsonArrayToNdjson as ag, jsonToIni as ah, jsonToToml as ai, jsonToXml as aj, minifyNdjson as ak, minifyToml as al, minifyXml as am, ndjsonToCsv as an, ndjsonToJsonArray as ao, parseCsv as ap, parseEnv as aq, parseFrontMatter as ar, parseIni as as, parseSubtitleTimestamp as at, parseSubtitles as au, parseXmlToObject as av, resolveYamlAnchors as aw, serializeSubtitles as ax, shiftSubtitles as ay, stringifyIni as az, type ConvertedSubtitles as b, type CsvColumnType as c, data as d, type CsvColumnTypeInfo as e, type CsvColumnTypeOptions as f, type CsvColumnTypeResult as g, type CsvDuplicateGroup as h, type CsvDuplicateOptions as i, type CsvDuplicateResult as j, type CsvParseResult as k, type CsvToSqlOptions as l, type CsvToSqlResult as m, type EnvDiffResult as n, type EnvEntry as o, type EnvParseResult as p, type FrontMatterResult as q, type MarkdownTableColumnAlignment as r, type MarkdownTableInfo as s, type MarkdownTaskListItem as t, type MarkdownTaskListProgressResult as u, type MarkdownTaskListSectionSummary as v, type MarkdownTocEntry as w, type MarkdownTocOptions as x, type MarkdownTocResult as y, type NdjsonLineResult as z };
+export { csvToJson as $, type MarkdownTocOptions as A, type MarkdownTocResult as B, type CaptionSpeedCue as C, type NdjsonLineResult as D, type EnvDiffError as E, type FrontMatterError as F, type NdjsonValidateResult as G, type HeadingEntry as H, type IniSection as I, type ParsedIni as J, type ParsedSubtitles as K, type SubtitleFormat as L, type MarkdownTableAlignResult as M, type NdjsonDedupeResult as N, type XmlToJsonOptions as O, type ParseOptions as P, type YamlAnchorResolveError as Q, type YamlAnchorResolveResult as R, type SubtitleCue as S, type TomlFormatResult as T, alignMarkdownTables as U, type ValidationResult as V, analyzeCaptionSpeed as W, type XmlFormatResult as X, type YamlAnchorInfo as Y, calculateMarkdownTaskListProgress as Z, convertSubtitles as _, type CaptionSpeedResult as a, csvToSqlInsert as a0, dedupeNdjson as a1, detectDelimiter as a2, detectSubtitleFormat as a3, diffEnvExample as a4, envToExport as a5, envToJson as a6, findCsvDuplicateRows as a7, formatNdjson as a8, formatSubtitleTimestamp as a9, resolveYamlAnchors as aA, serializeSubtitles as aB, shiftSubtitles as aC, stringifyIni as aD, toCsvString as aE, tomlToJson as aF, validateEnvKey as aG, validateIni as aH, validateMarkdownHeadingHierarchy as aI, validateNdjson as aJ, validateToml as aK, validateXml as aL, validateYaml as aM, xmlToJson as aN, formatToml as aa, formatXml as ab, generateMarkdownToc as ac, getSection as ad, getSectionNames as ae, getTomlStats as af, getXmlStats as ag, getYamlStats as ah, inferCsvColumnTypes as ai, iniToJson as aj, jsonArrayToNdjson as ak, jsonToIni as al, jsonToToml as am, jsonToXml as an, minifyNdjson as ao, minifyToml as ap, minifyXml as aq, ndjsonToCsv as ar, ndjsonToJsonArray as as, parseCsv as at, parseEnv as au, parseFrontMatter as av, parseIni as aw, parseSubtitleTimestamp as ax, parseSubtitles as ay, parseXmlToObject as az, type ConvertedSubtitles as b, type CsvColumnType as c, data as d, type CsvColumnTypeInfo as e, type CsvColumnTypeOptions as f, type CsvColumnTypeResult as g, type CsvDuplicateGroup as h, type CsvDuplicateOptions as i, type CsvDuplicateResult as j, type CsvParseResult as k, type CsvToSqlOptions as l, type CsvToSqlResult as m, type EnvDiffResult as n, type EnvEntry as o, type EnvParseResult as p, type FrontMatterResult as q, type HeadingHierarchyResult as r, type HeadingIssue as s, type HeadingIssueType as t, type MarkdownTableColumnAlignment as u, type MarkdownTableInfo as v, type MarkdownTaskListItem as w, type MarkdownTaskListProgressResult as x, type MarkdownTaskListSectionSummary as y, type MarkdownTocEntry as z };

package/dist/index.cjs

@@ -5621,6 +5621,7 @@ __export(data_exports, {
   tomlToJson: () => tomlToJson,
   validateEnvKey: () => validateEnvKey,
   validateIni: () => validateIni,
+  validateMarkdownHeadingHierarchy: () => validateMarkdownHeadingHierarchy,
   validateNdjson: () => validateNdjson,
   validateToml: () => validateToml,
   validateXml: () => validateXml,
@@ -7147,6 +7148,84 @@ function generateMarkdownToc(markdown, options = {}) {
   });
   return { toc: tocLines.join("\n"), entries };
 }
+var HEADING_HIERARCHY_RE = /^(#{1,6})(?!#)(?:[ \t]+(.*?))?[ \t]*#*[ \t]*$/;
+function validateMarkdownHeadingHierarchy(markdown) {
+  const lines = markdown.replace(/\r\n/g, "\n").split("\n");
+  const headings = [];
+  let inFence = false;
+  let fenceMarker = "";
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const fenceMatch = line.match(/^\s*(```+|~~~+)/);
+    if (fenceMatch) {
+      if (!inFence) {
+        inFence = true;
+        fenceMarker = fenceMatch[1][0];
+      } else if (fenceMatch[1][0] === fenceMarker) {
+        inFence = false;
+      }
+      continue;
+    }
+    if (inFence) continue;
+    const match = line.match(HEADING_HIERARCHY_RE);
+    if (!match) continue;
+    const level = match[1].length;
+    const text = stripInlineMarkdown(match[2] ?? "");
+    headings.push({ line: i + 1, level, text });
+  }
+  const issues = [];
+  const seen = /* @__PURE__ */ new Map();
+  let h1Count = 0;
+  let firstH1Line = null;
+  let prevLevel = null;
+  headings.forEach((h, idx) => {
+    if (h.text === "") {
+      issues.push({ line: h.line, type: "empty-heading", message: `Heading at line ${h.line} has no text` });
+    }
+    if (idx === 0 && h.level !== 1) {
+      issues.push({
+        line: h.line,
+        type: "starts-below-h1",
+        message: `Document starts with an H${h.level} heading instead of H1`
+      });
+    }
+    if (h.level === 1) {
+      h1Count++;
+      if (h1Count === 1) {
+        firstH1Line = h.line;
+      } else {
+        issues.push({
+          line: h.line,
+          type: "multiple-h1",
+          message: `Multiple H1 headings found: another H1 at line ${h.line} (first was at line ${firstH1Line})`
+        });
+      }
+    }
+    if (prevLevel !== null && h.level > prevLevel + 1) {
+      const skipped = h.level - prevLevel > 2 ? `H${prevLevel + 1}-H${h.level - 1}` : `H${prevLevel + 1}`;
+      issues.push({
+        line: h.line,
+        type: "skipped-level",
+        message: `Heading level jumps from H${prevLevel} to H${h.level} at line ${h.line}, skipping ${skipped}`
+      });
+    }
+    prevLevel = h.level;
+    if (h.text !== "") {
+      const key = `${h.level}:${h.text.toLowerCase()}`;
+      const earlierLine = seen.get(key);
+      if (earlierLine !== void 0) {
+        issues.push({
+          line: h.line,
+          type: "duplicate-heading",
+          message: `Heading "${h.text}" at line ${h.line} duplicates an H${h.level} heading at line ${earlierLine}`
+        });
+      } else {
+        seen.set(key, h.line);
+      }
+    }
+  });
+  return { headings, issues, h1Count };
+}
 function quoteSqlIdentifier(name, dialect) {
   if (dialect === "mysql") return "`" + name.replace(/`/g, "``") + "`";
   return '"' + name.replace(/"/g, '""') + '"';

package/dist/index.d.cts

@@ -2,7 +2,7 @@ export { j as json } from './json-Ca6gZCNB.cjs';
 export { e as encoding } from './encoding-Dk3wpmb3.cjs';
 export { h as hashing } from './hashing-CJjlvqS_.cjs';
 export { t as text } from './text-xY5MJwr0.cjs';
-export { d as data } from './data-DIyBrJ6l.cjs';
+export { d as data } from './data-Cz1Q0sg0.cjs';
 export { g as generators } from './generators-DAXXrMvG.cjs';
 export { t as time } from './time-VMAy_SrV.cjs';
 export { u as units } from './units-gLm_pq6U.cjs';

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { j as json } from './json-Ca6gZCNB.js';
 export { e as encoding } from './encoding-Dk3wpmb3.js';
 export { h as hashing } from './hashing-CJjlvqS_.js';
 export { t as text } from './text-xY5MJwr0.js';
-export { d as data } from './data-DIyBrJ6l.js';
+export { d as data } from './data-Cz1Q0sg0.js';
 export { g as generators } from './generators-DAXXrMvG.js';
 export { t as time } from './time-VMAy_SrV.js';
 export { u as units } from './units-gLm_pq6U.js';

package/dist/index.js

@@ -11,7 +11,7 @@ export { json_exports as json } from './chunk-WUOZHCIC.js';
 export { encoding_exports as encoding } from './chunk-DOWQZUTP.js';
 export { hashing_exports as hashing } from './chunk-PET2CGTH.js';
 export { text_exports as text } from './chunk-FB6CCFR5.js';
-export { data_exports as data } from './chunk-XOUS3M5Z.js';
+export { data_exports as data } from './chunk-CUQDHXUX.js';
 export { generators_exports as generators } from './chunk-422ICOZX.js';
 export { time_exports as time } from './chunk-6EJVNQSY.js';
 import './chunk-MLKGABMK.js';

package/dist/tools/data.cjs

@@ -1544,6 +1544,84 @@ function generateMarkdownToc(markdown, options = {}) {
   });
   return { toc: tocLines.join("\n"), entries };
 }
+var HEADING_HIERARCHY_RE = /^(#{1,6})(?!#)(?:[ \t]+(.*?))?[ \t]*#*[ \t]*$/;
+function validateMarkdownHeadingHierarchy(markdown) {
+  const lines = markdown.replace(/\r\n/g, "\n").split("\n");
+  const headings = [];
+  let inFence = false;
+  let fenceMarker = "";
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const fenceMatch = line.match(/^\s*(```+|~~~+)/);
+    if (fenceMatch) {
+      if (!inFence) {
+        inFence = true;
+        fenceMarker = fenceMatch[1][0];
+      } else if (fenceMatch[1][0] === fenceMarker) {
+        inFence = false;
+      }
+      continue;
+    }
+    if (inFence) continue;
+    const match = line.match(HEADING_HIERARCHY_RE);
+    if (!match) continue;
+    const level = match[1].length;
+    const text = stripInlineMarkdown(match[2] ?? "");
+    headings.push({ line: i + 1, level, text });
+  }
+  const issues = [];
+  const seen = /* @__PURE__ */ new Map();
+  let h1Count = 0;
+  let firstH1Line = null;
+  let prevLevel = null;
+  headings.forEach((h, idx) => {
+    if (h.text === "") {
+      issues.push({ line: h.line, type: "empty-heading", message: `Heading at line ${h.line} has no text` });
+    }
+    if (idx === 0 && h.level !== 1) {
+      issues.push({
+        line: h.line,
+        type: "starts-below-h1",
+        message: `Document starts with an H${h.level} heading instead of H1`
+      });
+    }
+    if (h.level === 1) {
+      h1Count++;
+      if (h1Count === 1) {
+        firstH1Line = h.line;
+      } else {
+        issues.push({
+          line: h.line,
+          type: "multiple-h1",
+          message: `Multiple H1 headings found: another H1 at line ${h.line} (first was at line ${firstH1Line})`
+        });
+      }
+    }
+    if (prevLevel !== null && h.level > prevLevel + 1) {
+      const skipped = h.level - prevLevel > 2 ? `H${prevLevel + 1}-H${h.level - 1}` : `H${prevLevel + 1}`;
+      issues.push({
+        line: h.line,
+        type: "skipped-level",
+        message: `Heading level jumps from H${prevLevel} to H${h.level} at line ${h.line}, skipping ${skipped}`
+      });
+    }
+    prevLevel = h.level;
+    if (h.text !== "") {
+      const key = `${h.level}:${h.text.toLowerCase()}`;
+      const earlierLine = seen.get(key);
+      if (earlierLine !== void 0) {
+        issues.push({
+          line: h.line,
+          type: "duplicate-heading",
+          message: `Heading "${h.text}" at line ${h.line} duplicates an H${h.level} heading at line ${earlierLine}`
+        });
+      } else {
+        seen.set(key, h.line);
+      }
+    }
+  });
+  return { headings, issues, h1Count };
+}
 function quoteSqlIdentifier(name, dialect) {
   if (dialect === "mysql") return "`" + name.replace(/`/g, "``") + "`";
   return '"' + name.replace(/"/g, '""') + '"';
@@ -1989,6 +2067,7 @@ exports.toCsvString = toCsvString;
 exports.tomlToJson = tomlToJson;
 exports.validateEnvKey = validateEnvKey;
 exports.validateIni = validateIni;
+exports.validateMarkdownHeadingHierarchy = validateMarkdownHeadingHierarchy;
 exports.validateNdjson = validateNdjson;
 exports.validateToml = validateToml;
 exports.validateXml = validateXml;

package/dist/tools/data.d.cts

@@ -1 +1 @@
-export { C as CaptionSpeedCue, a as CaptionSpeedResult, b as ConvertedSubtitles, c as CsvColumnType, e as CsvColumnTypeInfo, f as CsvColumnTypeOptions, g as CsvColumnTypeResult, h as CsvDuplicateGroup, i as CsvDuplicateOptions, j as CsvDuplicateResult, k as CsvParseResult, l as CsvToSqlOptions, m as CsvToSqlResult, E as EnvDiffError, n as EnvDiffResult, o as EnvEntry, p as EnvParseResult, F as FrontMatterError, q as FrontMatterResult, I as IniSection, M as MarkdownTableAlignResult, r as MarkdownTableColumnAlignment, s as MarkdownTableInfo, t as MarkdownTaskListItem, u as MarkdownTaskListProgressResult, v as MarkdownTaskListSectionSummary, w as MarkdownTocEntry, x as MarkdownTocOptions, y as MarkdownTocResult, N as NdjsonDedupeResult, z as NdjsonLineResult, A as NdjsonValidateResult, P as ParseOptions, B as ParsedIni, D as ParsedSubtitles, S as SubtitleCue, G as SubtitleFormat, T as TomlFormatResult, V as ValidationResult, X as XmlFormatResult, H as XmlToJsonOptions, Y as YamlAnchorInfo, J as YamlAnchorResolveError, K as YamlAnchorResolveResult, L as alignMarkdownTables, O as analyzeCaptionSpeed, Q as calculateMarkdownTaskListProgress, R as convertSubtitles, U as csvToJson, W as csvToSqlInsert, Z as dedupeNdjson, _ as detectDelimiter, $ as detectSubtitleFormat, a0 as diffEnvExample, a1 as envToExport, a2 as envToJson, a3 as findCsvDuplicateRows, a4 as formatNdjson, a5 as formatSubtitleTimestamp, a6 as formatToml, a7 as formatXml, a8 as generateMarkdownToc, a9 as getSection, aa as getSectionNames, ab as getTomlStats, ac as getXmlStats, ad as getYamlStats, ae as inferCsvColumnTypes, af as iniToJson, ag as jsonArrayToNdjson, ah as jsonToIni, ai as jsonToToml, aj as jsonToXml, ak as minifyNdjson, al as minifyToml, am as minifyXml, an as ndjsonToCsv, ao as ndjsonToJsonArray, ap as parseCsv, aq as parseEnv, ar as parseFrontMatter, as as parseIni, at as parseSubtitleTimestamp, au as parseSubtitles, av as parseXmlToObject, aw as resolveYamlAnchors, ax as serializeSubtitles, ay as shiftSubtitles, az as stringifyIni, aA as toCsvString, aB as tomlToJson, aC as validateEnvKey, aD as validateIni, aE as validateNdjson, aF as validateToml, aG as validateXml, aH as validateYaml, aI as xmlToJson } from '../data-DIyBrJ6l.cjs';
+export { C as CaptionSpeedCue, a as CaptionSpeedResult, b as ConvertedSubtitles, c as CsvColumnType, e as CsvColumnTypeInfo, f as CsvColumnTypeOptions, g as CsvColumnTypeResult, h as CsvDuplicateGroup, i as CsvDuplicateOptions, j as CsvDuplicateResult, k as CsvParseResult, l as CsvToSqlOptions, m as CsvToSqlResult, E as EnvDiffError, n as EnvDiffResult, o as EnvEntry, p as EnvParseResult, F as FrontMatterError, q as FrontMatterResult, H as HeadingEntry, r as HeadingHierarchyResult, s as HeadingIssue, t as HeadingIssueType, I as IniSection, M as MarkdownTableAlignResult, u as MarkdownTableColumnAlignment, v as MarkdownTableInfo, w as MarkdownTaskListItem, x as MarkdownTaskListProgressResult, y as MarkdownTaskListSectionSummary, z as MarkdownTocEntry, A as MarkdownTocOptions, B as MarkdownTocResult, N as NdjsonDedupeResult, D as NdjsonLineResult, G as NdjsonValidateResult, P as ParseOptions, J as ParsedIni, K as ParsedSubtitles, S as SubtitleCue, L as SubtitleFormat, T as TomlFormatResult, V as ValidationResult, X as XmlFormatResult, O as XmlToJsonOptions, Y as YamlAnchorInfo, Q as YamlAnchorResolveError, R as YamlAnchorResolveResult, U as alignMarkdownTables, W as analyzeCaptionSpeed, Z as calculateMarkdownTaskListProgress, _ as convertSubtitles, $ as csvToJson, a0 as csvToSqlInsert, a1 as dedupeNdjson, a2 as detectDelimiter, a3 as detectSubtitleFormat, a4 as diffEnvExample, a5 as envToExport, a6 as envToJson, a7 as findCsvDuplicateRows, a8 as formatNdjson, a9 as formatSubtitleTimestamp, aa as formatToml, ab as formatXml, ac as generateMarkdownToc, ad as getSection, ae as getSectionNames, af as getTomlStats, ag as getXmlStats, ah as getYamlStats, ai as inferCsvColumnTypes, aj as iniToJson, ak as jsonArrayToNdjson, al as jsonToIni, am as jsonToToml, an as jsonToXml, ao as minifyNdjson, ap as minifyToml, aq as minifyXml, ar as ndjsonToCsv, as as ndjsonToJsonArray, at as parseCsv, au as parseEnv, av as parseFrontMatter, aw as parseIni, ax as parseSubtitleTimestamp, ay as parseSubtitles, az as parseXmlToObject, aA as resolveYamlAnchors, aB as serializeSubtitles, aC as shiftSubtitles, aD as stringifyIni, aE as toCsvString, aF as tomlToJson, aG as validateEnvKey, aH as validateIni, aI as validateMarkdownHeadingHierarchy, aJ as validateNdjson, aK as validateToml, aL as validateXml, aM as validateYaml, aN as xmlToJson } from '../data-Cz1Q0sg0.cjs';

package/dist/tools/data.d.ts

@@ -1 +1 @@
-export { C as CaptionSpeedCue, a as CaptionSpeedResult, b as ConvertedSubtitles, c as CsvColumnType, e as CsvColumnTypeInfo, f as CsvColumnTypeOptions, g as CsvColumnTypeResult, h as CsvDuplicateGroup, i as CsvDuplicateOptions, j as CsvDuplicateResult, k as CsvParseResult, l as CsvToSqlOptions, m as CsvToSqlResult, E as EnvDiffError, n as EnvDiffResult, o as EnvEntry, p as EnvParseResult, F as FrontMatterError, q as FrontMatterResult, I as IniSection, M as MarkdownTableAlignResult, r as MarkdownTableColumnAlignment, s as MarkdownTableInfo, t as MarkdownTaskListItem, u as MarkdownTaskListProgressResult, v as MarkdownTaskListSectionSummary, w as MarkdownTocEntry, x as MarkdownTocOptions, y as MarkdownTocResult, N as NdjsonDedupeResult, z as NdjsonLineResult, A as NdjsonValidateResult, P as ParseOptions, B as ParsedIni, D as ParsedSubtitles, S as SubtitleCue, G as SubtitleFormat, T as TomlFormatResult, V as ValidationResult, X as XmlFormatResult, H as XmlToJsonOptions, Y as YamlAnchorInfo, J as YamlAnchorResolveError, K as YamlAnchorResolveResult, L as alignMarkdownTables, O as analyzeCaptionSpeed, Q as calculateMarkdownTaskListProgress, R as convertSubtitles, U as csvToJson, W as csvToSqlInsert, Z as dedupeNdjson, _ as detectDelimiter, $ as detectSubtitleFormat, a0 as diffEnvExample, a1 as envToExport, a2 as envToJson, a3 as findCsvDuplicateRows, a4 as formatNdjson, a5 as formatSubtitleTimestamp, a6 as formatToml, a7 as formatXml, a8 as generateMarkdownToc, a9 as getSection, aa as getSectionNames, ab as getTomlStats, ac as getXmlStats, ad as getYamlStats, ae as inferCsvColumnTypes, af as iniToJson, ag as jsonArrayToNdjson, ah as jsonToIni, ai as jsonToToml, aj as jsonToXml, ak as minifyNdjson, al as minifyToml, am as minifyXml, an as ndjsonToCsv, ao as ndjsonToJsonArray, ap as parseCsv, aq as parseEnv, ar as parseFrontMatter, as as parseIni, at as parseSubtitleTimestamp, au as parseSubtitles, av as parseXmlToObject, aw as resolveYamlAnchors, ax as serializeSubtitles, ay as shiftSubtitles, az as stringifyIni, aA as toCsvString, aB as tomlToJson, aC as validateEnvKey, aD as validateIni, aE as validateNdjson, aF as validateToml, aG as validateXml, aH as validateYaml, aI as xmlToJson } from '../data-DIyBrJ6l.js';
+export { C as CaptionSpeedCue, a as CaptionSpeedResult, b as ConvertedSubtitles, c as CsvColumnType, e as CsvColumnTypeInfo, f as CsvColumnTypeOptions, g as CsvColumnTypeResult, h as CsvDuplicateGroup, i as CsvDuplicateOptions, j as CsvDuplicateResult, k as CsvParseResult, l as CsvToSqlOptions, m as CsvToSqlResult, E as EnvDiffError, n as EnvDiffResult, o as EnvEntry, p as EnvParseResult, F as FrontMatterError, q as FrontMatterResult, H as HeadingEntry, r as HeadingHierarchyResult, s as HeadingIssue, t as HeadingIssueType, I as IniSection, M as MarkdownTableAlignResult, u as MarkdownTableColumnAlignment, v as MarkdownTableInfo, w as MarkdownTaskListItem, x as MarkdownTaskListProgressResult, y as MarkdownTaskListSectionSummary, z as MarkdownTocEntry, A as MarkdownTocOptions, B as MarkdownTocResult, N as NdjsonDedupeResult, D as NdjsonLineResult, G as NdjsonValidateResult, P as ParseOptions, J as ParsedIni, K as ParsedSubtitles, S as SubtitleCue, L as SubtitleFormat, T as TomlFormatResult, V as ValidationResult, X as XmlFormatResult, O as XmlToJsonOptions, Y as YamlAnchorInfo, Q as YamlAnchorResolveError, R as YamlAnchorResolveResult, U as alignMarkdownTables, W as analyzeCaptionSpeed, Z as calculateMarkdownTaskListProgress, _ as convertSubtitles, $ as csvToJson, a0 as csvToSqlInsert, a1 as dedupeNdjson, a2 as detectDelimiter, a3 as detectSubtitleFormat, a4 as diffEnvExample, a5 as envToExport, a6 as envToJson, a7 as findCsvDuplicateRows, a8 as formatNdjson, a9 as formatSubtitleTimestamp, aa as formatToml, ab as formatXml, ac as generateMarkdownToc, ad as getSection, ae as getSectionNames, af as getTomlStats, ag as getXmlStats, ah as getYamlStats, ai as inferCsvColumnTypes, aj as iniToJson, ak as jsonArrayToNdjson, al as jsonToIni, am as jsonToToml, an as jsonToXml, ao as minifyNdjson, ap as minifyToml, aq as minifyXml, ar as ndjsonToCsv, as as ndjsonToJsonArray, at as parseCsv, au as parseEnv, av as parseFrontMatter, aw as parseIni, ax as parseSubtitleTimestamp, ay as parseSubtitles, az as parseXmlToObject, aA as resolveYamlAnchors, aB as serializeSubtitles, aC as shiftSubtitles, aD as stringifyIni, aE as toCsvString, aF as tomlToJson, aG as validateEnvKey, aH as validateIni, aI as validateMarkdownHeadingHierarchy, aJ as validateNdjson, aK as validateToml, aL as validateXml, aM as validateYaml, aN as xmlToJson } from '../data-Cz1Q0sg0.js';

package/dist/tools/data.js

@@ -1,2 +1,2 @@
-export { alignMarkdownTables, analyzeCaptionSpeed, calculateMarkdownTaskListProgress, convertSubtitles, csvToJson, csvToSqlInsert, dedupeNdjson, detectDelimiter, detectSubtitleFormat, diffEnvExample, envToExport, envToJson, findCsvDuplicateRows, formatNdjson, formatSubtitleTimestamp, formatToml, formatXml, generateMarkdownToc, getSection, getSectionNames, getTomlStats, getXmlStats, getYamlStats, inferCsvColumnTypes, iniToJson, jsonArrayToNdjson, jsonToIni, jsonToToml, jsonToXml, minifyNdjson, minifyToml, minifyXml, ndjsonToCsv, ndjsonToJsonArray, parseCsv, parseEnv, parseFrontMatter, parseIni, parseSubtitleTimestamp, parseSubtitles, parseXmlToObject, resolveYamlAnchors, serializeSubtitles, shiftSubtitles, stringifyIni, toCsvString, tomlToJson, validateEnvKey, validateIni, validateNdjson, validateToml, validateXml, validateYaml, xmlToJson } from '../chunk-XOUS3M5Z.js';
+export { alignMarkdownTables, analyzeCaptionSpeed, calculateMarkdownTaskListProgress, convertSubtitles, csvToJson, csvToSqlInsert, dedupeNdjson, detectDelimiter, detectSubtitleFormat, diffEnvExample, envToExport, envToJson, findCsvDuplicateRows, formatNdjson, formatSubtitleTimestamp, formatToml, formatXml, generateMarkdownToc, getSection, getSectionNames, getTomlStats, getXmlStats, getYamlStats, inferCsvColumnTypes, iniToJson, jsonArrayToNdjson, jsonToIni, jsonToToml, jsonToXml, minifyNdjson, minifyToml, minifyXml, ndjsonToCsv, ndjsonToJsonArray, parseCsv, parseEnv, parseFrontMatter, parseIni, parseSubtitleTimestamp, parseSubtitles, parseXmlToObject, resolveYamlAnchors, serializeSubtitles, shiftSubtitles, stringifyIni, toCsvString, tomlToJson, validateEnvKey, validateIni, validateMarkdownHeadingHierarchy, validateNdjson, validateToml, validateXml, validateYaml, xmlToJson } from '../chunk-CUQDHXUX.js';
 import '../chunk-MLKGABMK.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/sdk",
-  "version": "0.86.0",
+  "version": "0.87.0",
   "description": "154+ developer utility tools for Node.js: JSON, encoding, hashing, color, CSS, network and more. Runs locally, no API key required.",
   "author": "Utilix <hello@utilix.tech>",
   "license": "MIT",