kirograph 0.15.0 → 0.16.0

package/dist/docs/formats/plaintext.js

@@ -0,0 +1,119 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var plaintext_exports = {};
+__export(plaintext_exports, {
+  plaintextParser: () => plaintextParser
+});
+module.exports = __toCommonJS(plaintext_exports);
+function isAllCaps(line) {
+  const trimmed = line.trim();
+  if (trimmed.length < 3) return false;
+  return /[A-Z]/.test(trimmed) && trimmed === trimmed.toUpperCase() && /^[A-Z\s\d\-_:]+$/.test(trimmed);
+}
+function isDashUnderline(line) {
+  const trimmed = line.trim();
+  return trimmed.length >= 3 && /^[-=~]+$/.test(trimmed);
+}
+function extractHeadings(content) {
+  const lines = content.split("\n");
+  const headings = [];
+  let byteOffset = 0;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const lineBytes = Buffer.byteLength(line, "utf8") + 1;
+    const trimmed = line.trim();
+    if (isAllCaps(trimmed) && (i === 0 || lines[i - 1].trim() === "")) {
+      headings.push({
+        title: trimmed,
+        level: 1,
+        byteOffset
+      });
+      byteOffset += lineBytes;
+      continue;
+    }
+    if (trimmed.length > 0 && i + 1 < lines.length && isDashUnderline(lines[i + 1])) {
+      const underlineChar = lines[i + 1].trim()[0];
+      headings.push({
+        title: trimmed,
+        level: underlineChar === "=" ? 1 : 2,
+        byteOffset
+      });
+      byteOffset += lineBytes;
+      continue;
+    }
+    byteOffset += lineBytes;
+  }
+  return headings;
+}
+function buildHierarchy(headings, content) {
+  const contentBytes = Buffer.byteLength(content, "utf8");
+  if (headings.length === 0) {
+    return [{
+      title: "(document)",
+      level: 0,
+      byteStart: 0,
+      byteEnd: contentBytes,
+      content,
+      children: []
+    }];
+  }
+  const sections = [];
+  for (let i = 0; i < headings.length; i++) {
+    const start = headings[i].byteOffset;
+    const end = i + 1 < headings.length ? headings[i + 1].byteOffset : contentBytes;
+    const sectionContent = Buffer.from(content, "utf8").slice(start, end).toString("utf8");
+    sections.push({ ...headings[i], byteEnd: end, content: sectionContent });
+  }
+  const root = [];
+  const stack = [];
+  for (const s of sections) {
+    const parsed = {
+      title: s.title,
+      level: s.level,
+      byteStart: s.byteOffset,
+      byteEnd: s.byteEnd,
+      content: s.content,
+      children: []
+    };
+    while (stack.length > 0 && stack[stack.length - 1].level >= s.level) {
+      stack.pop();
+    }
+    if (stack.length === 0) {
+      root.push(parsed);
+    } else {
+      stack[stack.length - 1].section.children.push(parsed);
+    }
+    stack.push({ section: parsed, level: s.level });
+  }
+  return root;
+}
+const plaintextParser = {
+  name: "plaintext",
+  extensions: [".txt"],
+  parse(content, _filePath) {
+    const headings = extractHeadings(content);
+    const sections = buildHierarchy(headings, content);
+    return { sections, format: "plaintext" };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  plaintextParser
+});
+//# sourceMappingURL=plaintext.js.map

package/dist/docs/formats/plaintext.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/docs/formats/plaintext.ts"],
+  "sourcesContent": ["/**\n * Plain Text Section Parser\n *\n * Handles: .txt\n * Parsing strategy: Paragraph-block splitting.\n * Treats blank-line-separated blocks as sections.\n * Lines that are ALL CAPS or followed by a line of dashes are treated as headings.\n */\n\nimport type { DocFormatParser, ParseResult, ParsedSection } from '../types';\n\ninterface RawHeading {\n  title: string;\n  level: number;\n  byteOffset: number;\n}\n\nfunction isAllCaps(line: string): boolean {\n  const trimmed = line.trim();\n  if (trimmed.length < 3) return false;\n  // Must have at least some letters and be all uppercase\n  return /[A-Z]/.test(trimmed) && trimmed === trimmed.toUpperCase() && /^[A-Z\\s\\d\\-_:]+$/.test(trimmed);\n}\n\nfunction isDashUnderline(line: string): boolean {\n  const trimmed = line.trim();\n  return trimmed.length >= 3 && /^[-=~]+$/.test(trimmed);\n}\n\nfunction extractHeadings(content: string): RawHeading[] {\n  const lines = content.split('\\n');\n  const headings: RawHeading[] = [];\n  let byteOffset = 0;\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i];\n    const lineBytes = Buffer.byteLength(line, 'utf8') + 1;\n    const trimmed = line.trim();\n\n    // Pattern 1: ALL CAPS line preceded by blank line (or first line)\n    if (isAllCaps(trimmed) && (i === 0 || lines[i - 1].trim() === '')) {\n      headings.push({\n        title: trimmed,\n        level: 1,\n        byteOffset,\n      });\n      byteOffset += lineBytes;\n      continue;\n    }\n\n    // Pattern 2: Line followed by dash/equals underline\n    if (trimmed.length > 0 && i + 1 < lines.length && isDashUnderline(lines[i + 1])) {\n      const underlineChar = lines[i + 1].trim()[0];\n      headings.push({\n        title: trimmed,\n        level: underlineChar === '=' ? 1 : 2,\n        byteOffset,\n      });\n      byteOffset += lineBytes;\n      continue;\n    }\n\n    byteOffset += lineBytes;\n  }\n\n  return headings;\n}\n\nfunction buildHierarchy(headings: RawHeading[], content: string): ParsedSection[] {\n  const contentBytes = Buffer.byteLength(content, 'utf8');\n\n  if (headings.length === 0) {\n    // No headings detected \u2014 treat as single section\n    return [{\n      title: '(document)',\n      level: 0,\n      byteStart: 0,\n      byteEnd: contentBytes,\n      content,\n      children: [],\n    }];\n  }\n\n  const sections: Array<RawHeading & { byteEnd: number; content: string }> = [];\n  for (let i = 0; i < headings.length; i++) {\n    const start = headings[i].byteOffset;\n    const end = i + 1 < headings.length ? headings[i + 1].byteOffset : contentBytes;\n    const sectionContent = Buffer.from(content, 'utf8').slice(start, end).toString('utf8');\n    sections.push({ ...headings[i], byteEnd: end, content: sectionContent });\n  }\n\n  const root: ParsedSection[] = [];\n  const stack: Array<{ section: ParsedSection; level: number }> = [];\n\n  for (const s of sections) {\n    const parsed: ParsedSection = {\n      title: s.title,\n      level: s.level,\n      byteStart: s.byteOffset,\n      byteEnd: s.byteEnd,\n      content: s.content,\n      children: [],\n    };\n\n    while (stack.length > 0 && stack[stack.length - 1].level >= s.level) {\n      stack.pop();\n    }\n\n    if (stack.length === 0) {\n      root.push(parsed);\n    } else {\n      stack[stack.length - 1].section.children.push(parsed);\n    }\n\n    stack.push({ section: parsed, level: s.level });\n  }\n\n  return root;\n}\n\nexport const plaintextParser: DocFormatParser = {\n  name: 'plaintext',\n  extensions: ['.txt'],\n\n  parse(content: string, _filePath: string): ParseResult {\n    const headings = extractHeadings(content);\n    const sections = buildHierarchy(headings, content);\n    return { sections, format: 'plaintext' };\n  },\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAiBA,SAAS,UAAU,MAAuB;AACxC,QAAM,UAAU,KAAK,KAAK;AAC1B,MAAI,QAAQ,SAAS,EAAG,QAAO;AAE/B,SAAO,QAAQ,KAAK,OAAO,KAAK,YAAY,QAAQ,YAAY,KAAK,mBAAmB,KAAK,OAAO;AACtG;AAEA,SAAS,gBAAgB,MAAuB;AAC9C,QAAM,UAAU,KAAK,KAAK;AAC1B,SAAO,QAAQ,UAAU,KAAK,WAAW,KAAK,OAAO;AACvD;AAEA,SAAS,gBAAgB,SAA+B;AACtD,QAAM,QAAQ,QAAQ,MAAM,IAAI;AAChC,QAAM,WAAyB,CAAC;AAChC,MAAI,aAAa;AAEjB,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,UAAM,OAAO,MAAM,CAAC;AACpB,UAAM,YAAY,OAAO,WAAW,MAAM,MAAM,IAAI;AACpD,UAAM,UAAU,KAAK,KAAK;AAG1B,QAAI,UAAU,OAAO,MAAM,MAAM,KAAK,MAAM,IAAI,CAAC,EAAE,KAAK,MAAM,KAAK;AACjE,eAAS,KAAK;AAAA,QACZ,OAAO;AAAA,QACP,OAAO;AAAA,QACP;AAAA,MACF,CAAC;AACD,oBAAc;AACd;AAAA,IACF;AAGA,QAAI,QAAQ,SAAS,KAAK,IAAI,IAAI,MAAM,UAAU,gBAAgB,MAAM,IAAI,CAAC,CAAC,GAAG;AAC/E,YAAM,gBAAgB,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;AAC3C,eAAS,KAAK;AAAA,QACZ,OAAO;AAAA,QACP,OAAO,kBAAkB,MAAM,IAAI;AAAA,QACnC;AAAA,MACF,CAAC;AACD,oBAAc;AACd;AAAA,IACF;AAEA,kBAAc;AAAA,EAChB;AAEA,SAAO;AACT;AAEA,SAAS,eAAe,UAAwB,SAAkC;AAChF,QAAM,eAAe,OAAO,WAAW,SAAS,MAAM;AAEtD,MAAI,SAAS,WAAW,GAAG;AAEzB,WAAO,CAAC;AAAA,MACN,OAAO;AAAA,MACP,OAAO;AAAA,MACP,WAAW;AAAA,MACX,SAAS;AAAA,MACT;AAAA,MACA,UAAU,CAAC;AAAA,IACb,CAAC;AAAA,EACH;AAEA,QAAM,WAAqE,CAAC;AAC5E,WAAS,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;AACxC,UAAM,QAAQ,SAAS,CAAC,EAAE;AAC1B,UAAM,MAAM,IAAI,IAAI,SAAS,SAAS,SAAS,IAAI,CAAC,EAAE,aAAa;AACnE,UAAM,iBAAiB,OAAO,KAAK,SAAS,MAAM,EAAE,MAAM,OAAO,GAAG,EAAE,SAAS,MAAM;AACrF,aAAS,KAAK,EAAE,GAAG,SAAS,CAAC,GAAG,SAAS,KAAK,SAAS,eAAe,CAAC;AAAA,EACzE;AAEA,QAAM,OAAwB,CAAC;AAC/B,QAAM,QAA0D,CAAC;AAEjE,aAAW,KAAK,UAAU;AACxB,UAAM,SAAwB;AAAA,MAC5B,OAAO,EAAE;AAAA,MACT,OAAO,EAAE;AAAA,MACT,WAAW,EAAE;AAAA,MACb,SAAS,EAAE;AAAA,MACX,SAAS,EAAE;AAAA,MACX,UAAU,CAAC;AAAA,IACb;AAEA,WAAO,MAAM,SAAS,KAAK,MAAM,MAAM,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO;AACnE,YAAM,IAAI;AAAA,IACZ;AAEA,QAAI,MAAM,WAAW,GAAG;AACtB,WAAK,KAAK,MAAM;AAAA,IAClB,OAAO;AACL,YAAM,MAAM,SAAS,CAAC,EAAE,QAAQ,SAAS,KAAK,MAAM;AAAA,IACtD;AAEA,UAAM,KAAK,EAAE,SAAS,QAAQ,OAAO,EAAE,MAAM,CAAC;AAAA,EAChD;AAEA,SAAO;AACT;AAEO,MAAM,kBAAmC;AAAA,EAC9C,MAAM;AAAA,EACN,YAAY,CAAC,MAAM;AAAA,EAEnB,MAAM,SAAiB,WAAgC;AACrD,UAAM,WAAW,gBAAgB,OAAO;AACxC,UAAM,WAAW,eAAe,UAAU,OAAO;AACjD,WAAO,EAAE,UAAU,QAAQ,YAAY;AAAA,EACzC;AACF;",
+  "names": []
+}

package/dist/docs/formats/rdoc.js

@@ -0,0 +1,105 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var rdoc_exports = {};
+__export(rdoc_exports, {
+  rdocParser: () => rdocParser
+});
+module.exports = __toCommonJS(rdoc_exports);
+const HEADING_RE = /^(={1,6})\s+(.+)$/;
+function extractHeadings(content) {
+  const lines = content.split("\n");
+  const headings = [];
+  let byteOffset = 0;
+  let inVerbatim = false;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const lineBytes = Buffer.byteLength(line, "utf8") + 1;
+    if (line.startsWith("  ") && line.trim().length > 0) {
+      byteOffset += lineBytes;
+      continue;
+    }
+    const match = line.match(HEADING_RE);
+    if (match) {
+      headings.push({
+        title: match[2].trim(),
+        level: match[1].length,
+        lineIndex: i,
+        byteOffset
+      });
+    }
+    byteOffset += lineBytes;
+  }
+  return headings;
+}
+function buildHierarchy(headings, content) {
+  const contentBytes = Buffer.byteLength(content, "utf8");
+  if (headings.length === 0) {
+    return [{
+      title: "(document)",
+      level: 0,
+      byteStart: 0,
+      byteEnd: contentBytes,
+      content,
+      children: []
+    }];
+  }
+  const sections = [];
+  for (let i = 0; i < headings.length; i++) {
+    const start = headings[i].byteOffset;
+    const end = i + 1 < headings.length ? headings[i + 1].byteOffset : contentBytes;
+    const sectionContent = Buffer.from(content, "utf8").slice(start, end).toString("utf8");
+    sections.push({ ...headings[i], byteEnd: end, content: sectionContent });
+  }
+  const root = [];
+  const stack = [];
+  for (const s of sections) {
+    const parsed = {
+      title: s.title,
+      level: s.level,
+      byteStart: s.byteOffset,
+      byteEnd: s.byteEnd,
+      content: s.content,
+      children: []
+    };
+    while (stack.length > 0 && stack[stack.length - 1].level >= s.level) {
+      stack.pop();
+    }
+    if (stack.length === 0) {
+      root.push(parsed);
+    } else {
+      stack[stack.length - 1].section.children.push(parsed);
+    }
+    stack.push({ section: parsed, level: s.level });
+  }
+  return root;
+}
+const rdocParser = {
+  name: "rdoc",
+  extensions: [".rdoc"],
+  parse(content, _filePath) {
+    const headings = extractHeadings(content);
+    const sections = buildHierarchy(headings, content);
+    return { sections, format: "rdoc" };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  rdocParser
+});
+//# sourceMappingURL=rdoc.js.map

package/dist/docs/formats/rdoc.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/docs/formats/rdoc.ts"],
+  "sourcesContent": ["/**\n * RDoc Section Parser\n *\n * Handles: .rdoc (Ruby documentation format)\n * Parsing strategy: = heading hierarchy (= Title, == Section, === Subsection)\n * Similar to AsciiDoc but with Ruby-specific conventions.\n */\n\nimport type { DocFormatParser, ParseResult, ParsedSection } from '../types';\n\nconst HEADING_RE = /^(={1,6})\\s+(.+)$/;\n\ninterface RawHeading {\n  title: string;\n  level: number;\n  lineIndex: number;\n  byteOffset: number;\n}\n\nfunction extractHeadings(content: string): RawHeading[] {\n  const lines = content.split('\\n');\n  const headings: RawHeading[] = [];\n  let byteOffset = 0;\n  let inVerbatim = false;\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i];\n    const lineBytes = Buffer.byteLength(line, 'utf8') + 1;\n\n    // Track verbatim blocks (indented by 2+ spaces in RDoc)\n    // Skip lines starting with spaces (code blocks in RDoc)\n    if (line.startsWith('  ') && line.trim().length > 0) {\n      byteOffset += lineBytes;\n      continue;\n    }\n\n    const match = line.match(HEADING_RE);\n    if (match) {\n      headings.push({\n        title: match[2].trim(),\n        level: match[1].length,\n        lineIndex: i,\n        byteOffset,\n      });\n    }\n\n    byteOffset += lineBytes;\n  }\n\n  return headings;\n}\n\nfunction buildHierarchy(headings: RawHeading[], content: string): ParsedSection[] {\n  const contentBytes = Buffer.byteLength(content, 'utf8');\n\n  if (headings.length === 0) {\n    return [{\n      title: '(document)',\n      level: 0,\n      byteStart: 0,\n      byteEnd: contentBytes,\n      content,\n      children: [],\n    }];\n  }\n\n  const sections: Array<RawHeading & { byteEnd: number; content: string }> = [];\n  for (let i = 0; i < headings.length; i++) {\n    const start = headings[i].byteOffset;\n    const end = i + 1 < headings.length ? headings[i + 1].byteOffset : contentBytes;\n    const sectionContent = Buffer.from(content, 'utf8').slice(start, end).toString('utf8');\n    sections.push({ ...headings[i], byteEnd: end, content: sectionContent });\n  }\n\n  const root: ParsedSection[] = [];\n  const stack: Array<{ section: ParsedSection; level: number }> = [];\n\n  for (const s of sections) {\n    const parsed: ParsedSection = {\n      title: s.title,\n      level: s.level,\n      byteStart: s.byteOffset,\n      byteEnd: s.byteEnd,\n      content: s.content,\n      children: [],\n    };\n\n    while (stack.length > 0 && stack[stack.length - 1].level >= s.level) {\n      stack.pop();\n    }\n\n    if (stack.length === 0) {\n      root.push(parsed);\n    } else {\n      stack[stack.length - 1].section.children.push(parsed);\n    }\n\n    stack.push({ section: parsed, level: s.level });\n  }\n\n  return root;\n}\n\nexport const rdocParser: DocFormatParser = {\n  name: 'rdoc',\n  extensions: ['.rdoc'],\n\n  parse(content: string, _filePath: string): ParseResult {\n    const headings = extractHeadings(content);\n    const sections = buildHierarchy(headings, content);\n    return { sections, format: 'rdoc' };\n  },\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAUA,MAAM,aAAa;AASnB,SAAS,gBAAgB,SAA+B;AACtD,QAAM,QAAQ,QAAQ,MAAM,IAAI;AAChC,QAAM,WAAyB,CAAC;AAChC,MAAI,aAAa;AACjB,MAAI,aAAa;AAEjB,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,UAAM,OAAO,MAAM,CAAC;AACpB,UAAM,YAAY,OAAO,WAAW,MAAM,MAAM,IAAI;AAIpD,QAAI,KAAK,WAAW,IAAI,KAAK,KAAK,KAAK,EAAE,SAAS,GAAG;AACnD,oBAAc;AACd;AAAA,IACF;AAEA,UAAM,QAAQ,KAAK,MAAM,UAAU;AACnC,QAAI,OAAO;AACT,eAAS,KAAK;AAAA,QACZ,OAAO,MAAM,CAAC,EAAE,KAAK;AAAA,QACrB,OAAO,MAAM,CAAC,EAAE;AAAA,QAChB,WAAW;AAAA,QACX;AAAA,MACF,CAAC;AAAA,IACH;AAEA,kBAAc;AAAA,EAChB;AAEA,SAAO;AACT;AAEA,SAAS,eAAe,UAAwB,SAAkC;AAChF,QAAM,eAAe,OAAO,WAAW,SAAS,MAAM;AAEtD,MAAI,SAAS,WAAW,GAAG;AACzB,WAAO,CAAC;AAAA,MACN,OAAO;AAAA,MACP,OAAO;AAAA,MACP,WAAW;AAAA,MACX,SAAS;AAAA,MACT;AAAA,MACA,UAAU,CAAC;AAAA,IACb,CAAC;AAAA,EACH;AAEA,QAAM,WAAqE,CAAC;AAC5E,WAAS,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;AACxC,UAAM,QAAQ,SAAS,CAAC,EAAE;AAC1B,UAAM,MAAM,IAAI,IAAI,SAAS,SAAS,SAAS,IAAI,CAAC,EAAE,aAAa;AACnE,UAAM,iBAAiB,OAAO,KAAK,SAAS,MAAM,EAAE,MAAM,OAAO,GAAG,EAAE,SAAS,MAAM;AACrF,aAAS,KAAK,EAAE,GAAG,SAAS,CAAC,GAAG,SAAS,KAAK,SAAS,eAAe,CAAC;AAAA,EACzE;AAEA,QAAM,OAAwB,CAAC;AAC/B,QAAM,QAA0D,CAAC;AAEjE,aAAW,KAAK,UAAU;AACxB,UAAM,SAAwB;AAAA,MAC5B,OAAO,EAAE;AAAA,MACT,OAAO,EAAE;AAAA,MACT,WAAW,EAAE;AAAA,MACb,SAAS,EAAE;AAAA,MACX,SAAS,EAAE;AAAA,MACX,UAAU,CAAC;AAAA,IACb;AAEA,WAAO,MAAM,SAAS,KAAK,MAAM,MAAM,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO;AACnE,YAAM,IAAI;AAAA,IACZ;AAEA,QAAI,MAAM,WAAW,GAAG;AACtB,WAAK,KAAK,MAAM;AAAA,IAClB,OAAO;AACL,YAAM,MAAM,SAAS,CAAC,EAAE,QAAQ,SAAS,KAAK,MAAM;AAAA,IACtD;AAEA,UAAM,KAAK,EAAE,SAAS,QAAQ,OAAO,EAAE,MAAM,CAAC;AAAA,EAChD;AAEA,SAAO;AACT;AAEO,MAAM,aAA8B;AAAA,EACzC,MAAM;AAAA,EACN,YAAY,CAAC,OAAO;AAAA,EAEpB,MAAM,SAAiB,WAAgC;AACrD,UAAM,WAAW,gBAAgB,OAAO;AACxC,UAAM,WAAW,eAAe,UAAU,OAAO;AACjD,WAAO,EAAE,UAAU,QAAQ,OAAO;AAAA,EACpC;AACF;",
+  "names": []
+}

package/dist/docs/formats/rst.js

@@ -0,0 +1,121 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var rst_exports = {};
+__export(rst_exports, {
+  rstParser: () => rstParser
+});
+module.exports = __toCommonJS(rst_exports);
+const ADORNMENT_CHARS = new Set("= - ` : . ' \" ~ ^ _ * + #".split(" "));
+function isAdornmentLine(line) {
+  const trimmed = line.trim();
+  if (trimmed.length < 3) return false;
+  const char = trimmed[0];
+  if (!ADORNMENT_CHARS.has(char)) return false;
+  return trimmed.split("").every((c) => c === char);
+}
+function extractHeadings(content) {
+  const lines = content.split("\n");
+  const headings = [];
+  const adornmentOrder = [];
+  let byteOffset = 0;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const lineBytes = Buffer.byteLength(line, "utf8") + 1;
+    if (i + 1 < lines.length && line.trim().length > 0 && !isAdornmentLine(line)) {
+      const nextLine = lines[i + 1];
+      if (isAdornmentLine(nextLine) && nextLine.trim().length >= line.trim().length) {
+        const adornChar = nextLine.trim()[0];
+        let hasOverline = false;
+        if (i > 0 && isAdornmentLine(lines[i - 1]) && lines[i - 1].trim()[0] === adornChar) {
+          hasOverline = true;
+        }
+        const key = hasOverline ? `over_${adornChar}` : adornChar;
+        let levelIdx = adornmentOrder.indexOf(key);
+        if (levelIdx === -1) {
+          adornmentOrder.push(key);
+          levelIdx = adornmentOrder.length - 1;
+        }
+        headings.push({
+          title: line.trim(),
+          level: levelIdx + 1,
+          lineIndex: i,
+          byteOffset: hasOverline ? byteOffset - (Buffer.byteLength(lines[i - 1], "utf8") + 1) : byteOffset
+        });
+      }
+    }
+    byteOffset += lineBytes;
+  }
+  return headings;
+}
+function buildHierarchy(headings, content) {
+  const contentBytes = Buffer.byteLength(content, "utf8");
+  if (headings.length === 0) {
+    return [{
+      title: "(document)",
+      level: 0,
+      byteStart: 0,
+      byteEnd: contentBytes,
+      content,
+      children: []
+    }];
+  }
+  const sections = [];
+  for (let i = 0; i < headings.length; i++) {
+    const start = headings[i].byteOffset;
+    const end = i + 1 < headings.length ? headings[i + 1].byteOffset : contentBytes;
+    const sectionContent = Buffer.from(content, "utf8").slice(start, end).toString("utf8");
+    sections.push({ ...headings[i], byteEnd: end, content: sectionContent });
+  }
+  const root = [];
+  const stack = [];
+  for (const s of sections) {
+    const parsed = {
+      title: s.title,
+      level: s.level,
+      byteStart: s.byteOffset,
+      byteEnd: s.byteEnd,
+      content: s.content,
+      children: []
+    };
+    while (stack.length > 0 && stack[stack.length - 1].level >= s.level) {
+      stack.pop();
+    }
+    if (stack.length === 0) {
+      root.push(parsed);
+    } else {
+      stack[stack.length - 1].section.children.push(parsed);
+    }
+    stack.push({ section: parsed, level: s.level });
+  }
+  return root;
+}
+const rstParser = {
+  name: "rst",
+  extensions: [".rst"],
+  parse(content, _filePath) {
+    const headings = extractHeadings(content);
+    const sections = buildHierarchy(headings, content);
+    return { sections, format: "rst" };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  rstParser
+});
+//# sourceMappingURL=rst.js.map

package/dist/docs/formats/rst.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/docs/formats/rst.ts"],
+  "sourcesContent": ["/**\n * reStructuredText Section Parser\n *\n * Handles: .rst\n * Parsing strategy: Adornment-based heading detection.\n * RST headings are defined by underline (and optional overline) characters.\n * The first adornment character encountered defines level 1, the second level 2, etc.\n */\n\nimport type { DocFormatParser, ParseResult, ParsedSection } from '../types';\n\n// Characters that can be used as RST adornments\nconst ADORNMENT_CHARS = new Set('= - ` : . \\' \" ~ ^ _ * + #'.split(' '));\n\ninterface RawHeading {\n  title: string;\n  level: number;\n  lineIndex: number;\n  byteOffset: number;\n}\n\nfunction isAdornmentLine(line: string): boolean {\n  const trimmed = line.trim();\n  if (trimmed.length < 3) return false;\n  const char = trimmed[0];\n  if (!ADORNMENT_CHARS.has(char)) return false;\n  return trimmed.split('').every(c => c === char);\n}\n\nfunction extractHeadings(content: string): RawHeading[] {\n  const lines = content.split('\\n');\n  const headings: RawHeading[] = [];\n  const adornmentOrder: string[] = []; // tracks which chars map to which levels\n  let byteOffset = 0;\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i];\n    const lineBytes = Buffer.byteLength(line, 'utf8') + 1;\n\n    // Check for heading pattern: title line followed by adornment line\n    if (i + 1 < lines.length && line.trim().length > 0 && !isAdornmentLine(line)) {\n      const nextLine = lines[i + 1];\n      if (isAdornmentLine(nextLine) && nextLine.trim().length >= line.trim().length) {\n        const adornChar = nextLine.trim()[0];\n\n        // Also check for overline pattern (adornment above and below)\n        let hasOverline = false;\n        if (i > 0 && isAdornmentLine(lines[i - 1]) && lines[i - 1].trim()[0] === adornChar) {\n          hasOverline = true;\n        }\n\n        // Determine level based on order of appearance\n        const key = hasOverline ? `over_${adornChar}` : adornChar;\n        let levelIdx = adornmentOrder.indexOf(key);\n        if (levelIdx === -1) {\n          adornmentOrder.push(key);\n          levelIdx = adornmentOrder.length - 1;\n        }\n\n        headings.push({\n          title: line.trim(),\n          level: levelIdx + 1,\n          lineIndex: i,\n          byteOffset: hasOverline ? byteOffset - (Buffer.byteLength(lines[i - 1], 'utf8') + 1) : byteOffset,\n        });\n      }\n    }\n\n    byteOffset += lineBytes;\n  }\n\n  return headings;\n}\n\nfunction buildHierarchy(headings: RawHeading[], content: string): ParsedSection[] {\n  const contentBytes = Buffer.byteLength(content, 'utf8');\n\n  if (headings.length === 0) {\n    return [{\n      title: '(document)',\n      level: 0,\n      byteStart: 0,\n      byteEnd: contentBytes,\n      content,\n      children: [],\n    }];\n  }\n\n  const sections: Array<RawHeading & { byteEnd: number; content: string }> = [];\n  for (let i = 0; i < headings.length; i++) {\n    const start = headings[i].byteOffset;\n    const end = i + 1 < headings.length ? headings[i + 1].byteOffset : contentBytes;\n    const sectionContent = Buffer.from(content, 'utf8').slice(start, end).toString('utf8');\n    sections.push({ ...headings[i], byteEnd: end, content: sectionContent });\n  }\n\n  const root: ParsedSection[] = [];\n  const stack: Array<{ section: ParsedSection; level: number }> = [];\n\n  for (const s of sections) {\n    const parsed: ParsedSection = {\n      title: s.title,\n      level: s.level,\n      byteStart: s.byteOffset,\n      byteEnd: s.byteEnd,\n      content: s.content,\n      children: [],\n    };\n\n    while (stack.length > 0 && stack[stack.length - 1].level >= s.level) {\n      stack.pop();\n    }\n\n    if (stack.length === 0) {\n      root.push(parsed);\n    } else {\n      stack[stack.length - 1].section.children.push(parsed);\n    }\n\n    stack.push({ section: parsed, level: s.level });\n  }\n\n  return root;\n}\n\nexport const rstParser: DocFormatParser = {\n  name: 'rst',\n  extensions: ['.rst'],\n\n  parse(content: string, _filePath: string): ParseResult {\n    const headings = extractHeadings(content);\n    const sections = buildHierarchy(headings, content);\n    return { sections, format: 'rst' };\n  },\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAYA,MAAM,kBAAkB,IAAI,IAAI,6BAA6B,MAAM,GAAG,CAAC;AASvE,SAAS,gBAAgB,MAAuB;AAC9C,QAAM,UAAU,KAAK,KAAK;AAC1B,MAAI,QAAQ,SAAS,EAAG,QAAO;AAC/B,QAAM,OAAO,QAAQ,CAAC;AACtB,MAAI,CAAC,gBAAgB,IAAI,IAAI,EAAG,QAAO;AACvC,SAAO,QAAQ,MAAM,EAAE,EAAE,MAAM,OAAK,MAAM,IAAI;AAChD;AAEA,SAAS,gBAAgB,SAA+B;AACtD,QAAM,QAAQ,QAAQ,MAAM,IAAI;AAChC,QAAM,WAAyB,CAAC;AAChC,QAAM,iBAA2B,CAAC;AAClC,MAAI,aAAa;AAEjB,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,UAAM,OAAO,MAAM,CAAC;AACpB,UAAM,YAAY,OAAO,WAAW,MAAM,MAAM,IAAI;AAGpD,QAAI,IAAI,IAAI,MAAM,UAAU,KAAK,KAAK,EAAE,SAAS,KAAK,CAAC,gBAAgB,IAAI,GAAG;AAC5E,YAAM,WAAW,MAAM,IAAI,CAAC;AAC5B,UAAI,gBAAgB,QAAQ,KAAK,SAAS,KAAK,EAAE,UAAU,KAAK,KAAK,EAAE,QAAQ;AAC7E,cAAM,YAAY,SAAS,KAAK,EAAE,CAAC;AAGnC,YAAI,cAAc;AAClB,YAAI,IAAI,KAAK,gBAAgB,MAAM,IAAI,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,WAAW;AAClF,wBAAc;AAAA,QAChB;AAGA,cAAM,MAAM,cAAc,QAAQ,SAAS,KAAK;AAChD,YAAI,WAAW,eAAe,QAAQ,GAAG;AACzC,YAAI,aAAa,IAAI;AACnB,yBAAe,KAAK,GAAG;AACvB,qBAAW,eAAe,SAAS;AAAA,QACrC;AAEA,iBAAS,KAAK;AAAA,UACZ,OAAO,KAAK,KAAK;AAAA,UACjB,OAAO,WAAW;AAAA,UAClB,WAAW;AAAA,UACX,YAAY,cAAc,cAAc,OAAO,WAAW,MAAM,IAAI,CAAC,GAAG,MAAM,IAAI,KAAK;AAAA,QACzF,CAAC;AAAA,MACH;AAAA,IACF;AAEA,kBAAc;AAAA,EAChB;AAEA,SAAO;AACT;AAEA,SAAS,eAAe,UAAwB,SAAkC;AAChF,QAAM,eAAe,OAAO,WAAW,SAAS,MAAM;AAEtD,MAAI,SAAS,WAAW,GAAG;AACzB,WAAO,CAAC;AAAA,MACN,OAAO;AAAA,MACP,OAAO;AAAA,MACP,WAAW;AAAA,MACX,SAAS;AAAA,MACT;AAAA,MACA,UAAU,CAAC;AAAA,IACb,CAAC;AAAA,EACH;AAEA,QAAM,WAAqE,CAAC;AAC5E,WAAS,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;AACxC,UAAM,QAAQ,SAAS,CAAC,EAAE;AAC1B,UAAM,MAAM,IAAI,IAAI,SAAS,SAAS,SAAS,IAAI,CAAC,EAAE,aAAa;AACnE,UAAM,iBAAiB,OAAO,KAAK,SAAS,MAAM,EAAE,MAAM,OAAO,GAAG,EAAE,SAAS,MAAM;AACrF,aAAS,KAAK,EAAE,GAAG,SAAS,CAAC,GAAG,SAAS,KAAK,SAAS,eAAe,CAAC;AAAA,EACzE;AAEA,QAAM,OAAwB,CAAC;AAC/B,QAAM,QAA0D,CAAC;AAEjE,aAAW,KAAK,UAAU;AACxB,UAAM,SAAwB;AAAA,MAC5B,OAAO,EAAE;AAAA,MACT,OAAO,EAAE;AAAA,MACT,WAAW,EAAE;AAAA,MACb,SAAS,EAAE;AAAA,MACX,SAAS,EAAE;AAAA,MACX,UAAU,CAAC;AAAA,IACb;AAEA,WAAO,MAAM,SAAS,KAAK,MAAM,MAAM,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO;AACnE,YAAM,IAAI;AAAA,IACZ;AAEA,QAAI,MAAM,WAAW,GAAG;AACtB,WAAK,KAAK,MAAM;AAAA,IAClB,OAAO;AACL,YAAM,MAAM,SAAS,CAAC,EAAE,QAAQ,SAAS,KAAK,MAAM;AAAA,IACtD;AAEA,UAAM,KAAK,EAAE,SAAS,QAAQ,OAAO,EAAE,MAAM,CAAC;AAAA,EAChD;AAEA,SAAO;AACT;AAEO,MAAM,YAA6B;AAAA,EACxC,MAAM;AAAA,EACN,YAAY,CAAC,MAAM;AAAA,EAEnB,MAAM,SAAiB,WAAgC;AACrD,UAAM,WAAW,gBAAgB,OAAO;AACxC,UAAM,WAAW,eAAe,UAAU,OAAO;AACjD,WAAO,EAAE,UAAU,QAAQ,MAAM;AAAA,EACnC;AACF;",
+  "names": []
+}