kirograph 0.15.0 → 0.16.0

package/dist/docs/formats/index.js

@@ -0,0 +1,81 @@
+"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 formats_exports = {};
+__export(formats_exports, {
+  getParser: () => getParser,
+  getRegisteredParsers: () => getRegisteredParsers,
+  getSupportedExtensions: () => getSupportedExtensions,
+  isSupportedDocFormat: () => isSupportedDocFormat,
+  parseDocFile: () => parseDocFile
+});
+module.exports = __toCommonJS(formats_exports);
+var import_markdown = require("./markdown");
+var import_rst = require("./rst");
+var import_asciidoc = require("./asciidoc");
+var import_rdoc = require("./rdoc");
+var import_org = require("./org");
+var import_html = require("./html");
+var import_plaintext = require("./plaintext");
+var import_openapi = require("./openapi");
+const parsers = [
+  import_markdown.markdownParser,
+  import_rst.rstParser,
+  import_asciidoc.asciidocParser,
+  import_rdoc.rdocParser,
+  import_org.orgParser,
+  import_html.htmlParser,
+  import_plaintext.plaintextParser
+];
+const extensionMap = /* @__PURE__ */ new Map();
+for (const parser of parsers) {
+  for (const ext of parser.extensions) {
+    extensionMap.set(ext.toLowerCase(), parser);
+  }
+}
+function getParser(filePath) {
+  const ext = filePath.slice(filePath.lastIndexOf(".")).toLowerCase();
+  return extensionMap.get(ext) ?? null;
+}
+function parseDocFile(content, filePath) {
+  const ext = filePath.slice(filePath.lastIndexOf(".")).toLowerCase();
+  if ((ext === ".yaml" || ext === ".yml" || ext === ".json") && (0, import_openapi.isOpenAPI)(content, filePath)) {
+    return import_openapi.openapiParser.parse(content, filePath);
+  }
+  const parser = getParser(filePath);
+  if (!parser) return null;
+  return parser.parse(content, filePath);
+}
+function isSupportedDocFormat(filePath) {
+  return getParser(filePath) !== null;
+}
+function getSupportedExtensions() {
+  return [...extensionMap.keys()];
+}
+function getRegisteredParsers() {
+  return parsers.map((p) => p.name);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getParser,
+  getRegisteredParsers,
+  getSupportedExtensions,
+  isSupportedDocFormat,
+  parseDocFile
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/docs/formats/index.ts"],
+  "sourcesContent": ["/**\n * Documentation Format Registry\n *\n * Maps file extensions to their appropriate parser.\n * New parsers are registered here as they are implemented.\n */\n\nimport type { DocFormatParser, ParseResult } from '../types';\nimport { markdownParser } from './markdown';\nimport { rstParser } from './rst';\nimport { asciidocParser } from './asciidoc';\nimport { rdocParser } from './rdoc';\nimport { orgParser } from './org';\nimport { htmlParser } from './html';\nimport { plaintextParser } from './plaintext';\nimport { openapiParser, isOpenAPI } from './openapi';\n\n// \u2500\u2500 Registry \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nconst parsers: DocFormatParser[] = [\n  markdownParser,\n  rstParser,\n  asciidocParser,\n  rdocParser,\n  orgParser,\n  htmlParser,\n  plaintextParser,\n];\n\n/** Extension \u2192 parser lookup (built once at module load) */\nconst extensionMap = new Map<string, DocFormatParser>();\nfor (const parser of parsers) {\n  for (const ext of parser.extensions) {\n    extensionMap.set(ext.toLowerCase(), parser);\n  }\n}\n\n// \u2500\u2500 Public API \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * Get the parser for a given file extension.\n * Returns null if no parser is registered for the extension.\n */\nexport function getParser(filePath: string): DocFormatParser | null {\n  const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();\n  return extensionMap.get(ext) ?? null;\n}\n\n/**\n * Parse a documentation file into sections.\n * Returns null if no parser is available for the file format.\n * Supports content-based detection for OpenAPI specs.\n */\nexport function parseDocFile(content: string, filePath: string): ParseResult | null {\n  // Content-based detection: OpenAPI specs in .yaml/.yml/.json files\n  const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();\n  if ((ext === '.yaml' || ext === '.yml' || ext === '.json') && isOpenAPI(content, filePath)) {\n    return openapiParser.parse(content, filePath);\n  }\n\n  const parser = getParser(filePath);\n  if (!parser) return null;\n  return parser.parse(content, filePath);\n}\n\n/**\n * Check if a file extension is supported for documentation parsing.\n */\nexport function isSupportedDocFormat(filePath: string): boolean {\n  return getParser(filePath) !== null;\n}\n\n/**\n * Get all supported file extensions.\n */\nexport function getSupportedExtensions(): string[] {\n  return [...extensionMap.keys()];\n}\n\n/**\n * Get all registered parser names.\n */\nexport function getRegisteredParsers(): string[] {\n  return parsers.map(p => p.name);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,sBAA+B;AAC/B,iBAA0B;AAC1B,sBAA+B;AAC/B,kBAA2B;AAC3B,iBAA0B;AAC1B,kBAA2B;AAC3B,uBAAgC;AAChC,qBAAyC;AAIzC,MAAM,UAA6B;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGA,MAAM,eAAe,oBAAI,IAA6B;AACtD,WAAW,UAAU,SAAS;AAC5B,aAAW,OAAO,OAAO,YAAY;AACnC,iBAAa,IAAI,IAAI,YAAY,GAAG,MAAM;AAAA,EAC5C;AACF;AAQO,SAAS,UAAU,UAA0C;AAClE,QAAM,MAAM,SAAS,MAAM,SAAS,YAAY,GAAG,CAAC,EAAE,YAAY;AAClE,SAAO,aAAa,IAAI,GAAG,KAAK;AAClC;AAOO,SAAS,aAAa,SAAiB,UAAsC;AAElF,QAAM,MAAM,SAAS,MAAM,SAAS,YAAY,GAAG,CAAC,EAAE,YAAY;AAClE,OAAK,QAAQ,WAAW,QAAQ,UAAU,QAAQ,gBAAY,0BAAU,SAAS,QAAQ,GAAG;AAC1F,WAAO,6BAAc,MAAM,SAAS,QAAQ;AAAA,EAC9C;AAEA,QAAM,SAAS,UAAU,QAAQ;AACjC,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,OAAO,MAAM,SAAS,QAAQ;AACvC;AAKO,SAAS,qBAAqB,UAA2B;AAC9D,SAAO,UAAU,QAAQ,MAAM;AACjC;AAKO,SAAS,yBAAmC;AACjD,SAAO,CAAC,GAAG,aAAa,KAAK,CAAC;AAChC;AAKO,SAAS,uBAAiC;AAC/C,SAAO,QAAQ,IAAI,OAAK,EAAE,IAAI;AAChC;",
+  "names": []
+}

package/dist/docs/formats/markdown.js

@@ -0,0 +1,146 @@
+"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 markdown_exports = {};
+__export(markdown_exports, {
+  markdownParser: () => markdownParser
+});
+module.exports = __toCommonJS(markdown_exports);
+const ATX_HEADING = /^(#{1,6})\s+(.+?)(?:\s+#+)?$/;
+const SETEXT_H1 = /^=+\s*$/;
+const SETEXT_H2 = /^-+\s*$/;
+const FENCE_OPEN = /^(`{3,}|~{3,})/;
+function extractHeadings(content) {
+  const lines = content.split("\n");
+  const headings = [];
+  let inFence = false;
+  let fenceChar = "";
+  let fenceLen = 0;
+  let byteOffset = 0;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const lineBytes = Buffer.byteLength(line, "utf8") + 1;
+    if (!inFence) {
+      const fenceMatch = line.match(FENCE_OPEN);
+      if (fenceMatch) {
+        inFence = true;
+        fenceChar = fenceMatch[1][0];
+        fenceLen = fenceMatch[1].length;
+        byteOffset += lineBytes;
+        continue;
+      }
+    } else {
+      const closingPattern = new RegExp(`^${fenceChar}{${fenceLen},}\\s*$`);
+      if (closingPattern.test(line)) {
+        inFence = false;
+      }
+      byteOffset += lineBytes;
+      continue;
+    }
+    const atxMatch = line.match(ATX_HEADING);
+    if (atxMatch) {
+      headings.push({
+        title: atxMatch[2].trim(),
+        level: atxMatch[1].length,
+        lineIndex: i,
+        byteOffset
+      });
+      byteOffset += lineBytes;
+      continue;
+    }
+    if (i + 1 < lines.length && line.trim().length > 0) {
+      const nextLine = lines[i + 1];
+      if (SETEXT_H1.test(nextLine)) {
+        headings.push({
+          title: line.trim(),
+          level: 1,
+          lineIndex: i,
+          byteOffset
+        });
+      } else if (SETEXT_H2.test(nextLine)) {
+        headings.push({
+          title: line.trim(),
+          level: 2,
+          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 markdownParser = {
+  name: "markdown",
+  extensions: [".md", ".mdx", ".cheatmd"],
+  parse(content, _filePath) {
+    const headings = extractHeadings(content);
+    const sections = buildHierarchy(headings, content);
+    return {
+      sections,
+      format: "markdown"
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  markdownParser
+});
+//# sourceMappingURL=markdown.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/docs/formats/markdown.ts"],
+  "sourcesContent": ["/**\n * Markdown Section Parser\n *\n * Handles: .md, .mdx, .cheatmd\n * Parsing strategy: ATX headings (# Heading) + setext headings (underline with = or -)\n *\n * Correctly ignores headings inside fenced code blocks (``` or ~~~).\n */\n\nimport type { DocFormatParser, ParseResult, ParsedSection } from '../types';\n\n// \u2500\u2500 ATX heading regex: # to ###### at start of line \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nconst ATX_HEADING = /^(#{1,6})\\s+(.+?)(?:\\s+#+)?$/;\n\n// \u2500\u2500 Setext heading: line followed by === or --- \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nconst SETEXT_H1 = /^=+\\s*$/;\nconst SETEXT_H2 = /^-+\\s*$/;\n\n// \u2500\u2500 Fenced code block markers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nconst FENCE_OPEN = /^(`{3,}|~{3,})/;\n\ninterface RawHeading {\n  title: string;\n  level: number;\n  lineIndex: number;\n  byteOffset: number;\n}\n\n/**\n * Extract all headings from Markdown content, respecting code fences.\n */\nfunction extractHeadings(content: string): RawHeading[] {\n  const lines = content.split('\\n');\n  const headings: RawHeading[] = [];\n  let inFence = false;\n  let fenceChar = '';\n  let fenceLen = 0;\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; // +1 for \\n\n\n    // Track fenced code blocks\n    if (!inFence) {\n      const fenceMatch = line.match(FENCE_OPEN);\n      if (fenceMatch) {\n        inFence = true;\n        fenceChar = fenceMatch[1][0];\n        fenceLen = fenceMatch[1].length;\n        byteOffset += lineBytes;\n        continue;\n      }\n    } else {\n      // Check for closing fence\n      const closingPattern = new RegExp(`^${fenceChar}{${fenceLen},}\\\\s*$`);\n      if (closingPattern.test(line)) {\n        inFence = false;\n      }\n      byteOffset += lineBytes;\n      continue;\n    }\n\n    // ATX heading\n    const atxMatch = line.match(ATX_HEADING);\n    if (atxMatch) {\n      headings.push({\n        title: atxMatch[2].trim(),\n        level: atxMatch[1].length,\n        lineIndex: i,\n        byteOffset,\n      });\n      byteOffset += lineBytes;\n      continue;\n    }\n\n    // Setext heading (check next line)\n    if (i + 1 < lines.length && line.trim().length > 0) {\n      const nextLine = lines[i + 1];\n      if (SETEXT_H1.test(nextLine)) {\n        headings.push({\n          title: line.trim(),\n          level: 1,\n          lineIndex: i,\n          byteOffset,\n        });\n      } else if (SETEXT_H2.test(nextLine)) {\n        headings.push({\n          title: line.trim(),\n          level: 2,\n          lineIndex: i,\n          byteOffset,\n        });\n      }\n    }\n\n    byteOffset += lineBytes;\n  }\n\n  return headings;\n}\n\n/**\n * Build a section hierarchy from flat headings list.\n * Each section's content spans from its heading to the next heading of same or higher level.\n */\nfunction buildHierarchy(headings: RawHeading[], content: string): ParsedSection[] {\n  const contentBytes = Buffer.byteLength(content, 'utf8');\n\n  if (headings.length === 0) {\n    // No headings \u2014 treat entire file as a single root section\n    return [{\n      title: '(document)',\n      level: 0,\n      byteStart: 0,\n      byteEnd: contentBytes,\n      content,\n      children: [],\n    }];\n  }\n\n  // Calculate byte ranges for each heading\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  // Build tree using a stack-based approach\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    // Pop stack until we find a parent with lower level\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\n// \u2500\u2500 Parser Export \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const markdownParser: DocFormatParser = {\n  name: 'markdown',\n  extensions: ['.md', '.mdx', '.cheatmd'],\n\n  parse(content: string, _filePath: string): ParseResult {\n    const headings = extractHeadings(content);\n    const sections = buildHierarchy(headings, content);\n\n    return {\n      sections,\n      format: 'markdown',\n    };\n  },\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/docs/formats/openapi.js

@@ -0,0 +1,228 @@
+"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 openapi_exports = {};
+__export(openapi_exports, {
+  isOpenAPI: () => isOpenAPI,
+  openapiParser: () => openapiParser
+});
+module.exports = __toCommonJS(openapi_exports);
+function isOpenAPIContent(content, filePath) {
+  const ext = filePath.slice(filePath.lastIndexOf(".")).toLowerCase();
+  if (ext === ".json") {
+    try {
+      const parsed = JSON.parse(content);
+      return "openapi" in parsed || "swagger" in parsed;
+    } catch {
+      return false;
+    }
+  }
+  return /^(openapi|swagger)\s*:/m.test(content);
+}
+function parseYAMLOperations(content) {
+  const operations = [];
+  const lines = content.split("\n");
+  let inPaths = false;
+  let currentPath = "";
+  let currentMethod = "";
+  let currentTags = [];
+  let currentSummary = "";
+  let currentDescription = "";
+  let opStart = 0;
+  let byteOffset = 0;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const lineBytes = Buffer.byteLength(line, "utf8") + 1;
+    if (/^paths\s*:/.test(line)) {
+      inPaths = true;
+      byteOffset += lineBytes;
+      continue;
+    }
+    if (inPaths && /^\S/.test(line) && !/^paths/.test(line)) {
+      if (currentPath && currentMethod) {
+        operations.push({
+          method: currentMethod.toUpperCase(),
+          path: currentPath,
+          summary: currentSummary,
+          description: currentDescription,
+          tags: currentTags.length > 0 ? currentTags : ["default"],
+          byteStart: opStart,
+          byteEnd: byteOffset
+        });
+      }
+      inPaths = false;
+      byteOffset += lineBytes;
+      continue;
+    }
+    if (inPaths) {
+      const pathMatch = line.match(/^\s{2}(['"]?)(\/[^'":\s]*)\1\s*:/);
+      if (pathMatch) {
+        if (currentPath && currentMethod) {
+          operations.push({
+            method: currentMethod.toUpperCase(),
+            path: currentPath,
+            summary: currentSummary,
+            description: currentDescription,
+            tags: currentTags.length > 0 ? currentTags : ["default"],
+            byteStart: opStart,
+            byteEnd: byteOffset
+          });
+          currentMethod = "";
+          currentSummary = "";
+          currentDescription = "";
+          currentTags = [];
+        }
+        currentPath = pathMatch[2];
+      }
+      const methodMatch = line.match(/^\s{4}(get|post|put|delete|patch|head|options)\s*:/);
+      if (methodMatch) {
+        if (currentMethod) {
+          operations.push({
+            method: currentMethod.toUpperCase(),
+            path: currentPath,
+            summary: currentSummary,
+            description: currentDescription,
+            tags: currentTags.length > 0 ? currentTags : ["default"],
+            byteStart: opStart,
+            byteEnd: byteOffset
+          });
+        }
+        currentMethod = methodMatch[1];
+        currentSummary = "";
+        currentDescription = "";
+        currentTags = [];
+        opStart = byteOffset;
+      }
+      const summaryMatch = line.match(/^\s{6}summary\s*:\s*['"]?(.+?)['"]?\s*$/);
+      if (summaryMatch) currentSummary = summaryMatch[1];
+      const descMatch = line.match(/^\s{6}description\s*:\s*['"]?(.+?)['"]?\s*$/);
+      if (descMatch) currentDescription = descMatch[1];
+      const tagMatch = line.match(/^\s{8}-\s*['"]?(.+?)['"]?\s*$/);
+      if (tagMatch && i > 0 && /^\s{6}tags\s*:/.test(lines[i - 1] || "")) {
+        currentTags.push(tagMatch[1]);
+      }
+      if (/^\s{6}tags\s*:/.test(line)) {
+        for (let j = i + 1; j < lines.length && /^\s{8}-/.test(lines[j]); j++) {
+          const t = lines[j].match(/^\s{8}-\s*['"]?(.+?)['"]?\s*$/);
+          if (t) currentTags.push(t[1]);
+        }
+      }
+    }
+    byteOffset += lineBytes;
+  }
+  if (currentPath && currentMethod) {
+    operations.push({
+      method: currentMethod.toUpperCase(),
+      path: currentPath,
+      summary: currentSummary,
+      description: currentDescription,
+      tags: currentTags.length > 0 ? currentTags : ["default"],
+      byteStart: opStart,
+      byteEnd: byteOffset
+    });
+  }
+  return operations;
+}
+function parseJSONOperations(content) {
+  const operations = [];
+  try {
+    const spec = JSON.parse(content);
+    const paths = spec.paths || {};
+    const contentBytes = Buffer.byteLength(content, "utf8");
+    const methods = ["get", "post", "put", "delete", "patch", "head", "options"];
+    for (const [pathStr, pathItem] of Object.entries(paths)) {
+      if (!pathItem || typeof pathItem !== "object") continue;
+      for (const method of methods) {
+        const op = pathItem[method];
+        if (!op) continue;
+        operations.push({
+          method: method.toUpperCase(),
+          path: pathStr,
+          summary: op.summary || "",
+          description: op.description || "",
+          tags: Array.isArray(op.tags) ? op.tags : ["default"],
+          byteStart: 0,
+          byteEnd: contentBytes
+        });
+      }
+    }
+  } catch {
+  }
+  return operations;
+}
+function buildSections(operations, content) {
+  const contentBytes = Buffer.byteLength(content, "utf8");
+  if (operations.length === 0) {
+    return [{
+      title: "(API spec)",
+      level: 0,
+      byteStart: 0,
+      byteEnd: contentBytes,
+      content,
+      children: []
+    }];
+  }
+  const byTag = /* @__PURE__ */ new Map();
+  for (const op of operations) {
+    for (const tag of op.tags) {
+      if (!byTag.has(tag)) byTag.set(tag, []);
+      byTag.get(tag).push(op);
+    }
+  }
+  const root = [];
+  for (const [tag, ops] of byTag) {
+    const children = ops.map((op) => ({
+      title: `${op.method} ${op.path}`,
+      level: 2,
+      byteStart: op.byteStart,
+      byteEnd: op.byteEnd,
+      content: [op.summary, op.description].filter(Boolean).join("\n") || `${op.method} ${op.path}`,
+      children: []
+    }));
+    root.push({
+      title: tag,
+      level: 1,
+      byteStart: ops[0]?.byteStart ?? 0,
+      byteEnd: ops[ops.length - 1]?.byteEnd ?? contentBytes,
+      content: `Tag: ${tag}
+${ops.map((o) => `${o.method} ${o.path}`).join("\n")}`,
+      children
+    });
+  }
+  return root;
+}
+const openapiParser = {
+  name: "openapi",
+  extensions: [],
+  // Not registered by extension — detected by content
+  parse(content, filePath) {
+    const ext = filePath.slice(filePath.lastIndexOf(".")).toLowerCase();
+    const operations = ext === ".json" ? parseJSONOperations(content) : parseYAMLOperations(content);
+    const sections = buildSections(operations, content);
+    return { sections, format: "openapi" };
+  }
+};
+function isOpenAPI(content, filePath) {
+  return isOpenAPIContent(content, filePath);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isOpenAPI,
+  openapiParser
+});
+//# sourceMappingURL=openapi.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/docs/formats/openapi.ts"],
+  "sourcesContent": ["/**\n * OpenAPI/Swagger Section Parser\n *\n * Handles: .yaml, .yml, .json (when detected as OpenAPI spec)\n * Parsing strategy: Operations grouped by tag.\n * Each tag becomes a level-1 section, each operation becomes a level-2 section.\n *\n * Detection: file must contain \"openapi:\" or \"swagger:\" (YAML) or\n * \"openapi\" / \"swagger\" keys at root level (JSON).\n */\n\nimport type { DocFormatParser, ParseResult, ParsedSection } from '../types';\n\ninterface OpenAPIOperation {\n  method: string;\n  path: string;\n  summary?: string;\n  description?: string;\n  tags: string[];\n  byteStart: number;\n  byteEnd: number;\n}\n\nfunction isOpenAPIContent(content: string, filePath: string): boolean {\n  const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();\n  if (ext === '.json') {\n    try {\n      const parsed = JSON.parse(content);\n      return 'openapi' in parsed || 'swagger' in parsed;\n    } catch { return false; }\n  }\n  // YAML detection\n  return /^(openapi|swagger)\\s*:/m.test(content);\n}\n\nfunction parseYAMLOperations(content: string): OpenAPIOperation[] {\n  const operations: OpenAPIOperation[] = [];\n  const lines = content.split('\\n');\n  let inPaths = false;\n  let currentPath = '';\n  let currentMethod = '';\n  let currentTags: string[] = [];\n  let currentSummary = '';\n  let currentDescription = '';\n  let opStart = 0;\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    // Detect paths: section\n    if (/^paths\\s*:/.test(line)) {\n      inPaths = true;\n      byteOffset += lineBytes;\n      continue;\n    }\n\n    // Exit paths section on next top-level key\n    if (inPaths && /^\\S/.test(line) && !/^paths/.test(line)) {\n      // Flush last operation\n      if (currentPath && currentMethod) {\n        operations.push({\n          method: currentMethod.toUpperCase(),\n          path: currentPath,\n          summary: currentSummary,\n          description: currentDescription,\n          tags: currentTags.length > 0 ? currentTags : ['default'],\n          byteStart: opStart,\n          byteEnd: byteOffset,\n        });\n      }\n      inPaths = false;\n      byteOffset += lineBytes;\n      continue;\n    }\n\n    if (inPaths) {\n      // Path pattern: \"  /users:\" or \"  '/users/{id}':\"\n      const pathMatch = line.match(/^\\s{2}(['\"]?)(\\/[^'\":\\s]*)\\1\\s*:/);\n      if (pathMatch) {\n        // Flush previous operation\n        if (currentPath && currentMethod) {\n          operations.push({\n            method: currentMethod.toUpperCase(),\n            path: currentPath,\n            summary: currentSummary,\n            description: currentDescription,\n            tags: currentTags.length > 0 ? currentTags : ['default'],\n            byteStart: opStart,\n            byteEnd: byteOffset,\n          });\n          currentMethod = '';\n          currentSummary = '';\n          currentDescription = '';\n          currentTags = [];\n        }\n        currentPath = pathMatch[2];\n      }\n\n      // Method pattern: \"    get:\", \"    post:\", etc.\n      const methodMatch = line.match(/^\\s{4}(get|post|put|delete|patch|head|options)\\s*:/);\n      if (methodMatch) {\n        // Flush previous operation if same path different method\n        if (currentMethod) {\n          operations.push({\n            method: currentMethod.toUpperCase(),\n            path: currentPath,\n            summary: currentSummary,\n            description: currentDescription,\n            tags: currentTags.length > 0 ? currentTags : ['default'],\n            byteStart: opStart,\n            byteEnd: byteOffset,\n          });\n        }\n        currentMethod = methodMatch[1];\n        currentSummary = '';\n        currentDescription = '';\n        currentTags = [];\n        opStart = byteOffset;\n      }\n\n      // Summary\n      const summaryMatch = line.match(/^\\s{6}summary\\s*:\\s*['\"]?(.+?)['\"]?\\s*$/);\n      if (summaryMatch) currentSummary = summaryMatch[1];\n\n      // Description\n      const descMatch = line.match(/^\\s{6}description\\s*:\\s*['\"]?(.+?)['\"]?\\s*$/);\n      if (descMatch) currentDescription = descMatch[1];\n\n      // Tags\n      const tagMatch = line.match(/^\\s{8}-\\s*['\"]?(.+?)['\"]?\\s*$/);\n      if (tagMatch && i > 0 && /^\\s{6}tags\\s*:/.test(lines[i - 1] || '')) {\n        currentTags.push(tagMatch[1]);\n      }\n      // Also handle inline tag after \"tags:\" line\n      if (/^\\s{6}tags\\s*:/.test(line)) {\n        // Look ahead for tag items\n        for (let j = i + 1; j < lines.length && /^\\s{8}-/.test(lines[j]); j++) {\n          const t = lines[j].match(/^\\s{8}-\\s*['\"]?(.+?)['\"]?\\s*$/);\n          if (t) currentTags.push(t[1]);\n        }\n      }\n    }\n\n    byteOffset += lineBytes;\n  }\n\n  // Flush last operation\n  if (currentPath && currentMethod) {\n    operations.push({\n      method: currentMethod.toUpperCase(),\n      path: currentPath,\n      summary: currentSummary,\n      description: currentDescription,\n      tags: currentTags.length > 0 ? currentTags : ['default'],\n      byteStart: opStart,\n      byteEnd: byteOffset,\n    });\n  }\n\n  return operations;\n}\n\nfunction parseJSONOperations(content: string): OpenAPIOperation[] {\n  const operations: OpenAPIOperation[] = [];\n  try {\n    const spec = JSON.parse(content);\n    const paths = spec.paths || {};\n    const contentBytes = Buffer.byteLength(content, 'utf8');\n    const methods = ['get', 'post', 'put', 'delete', 'patch', 'head', 'options'];\n\n    for (const [pathStr, pathItem] of Object.entries(paths)) {\n      if (!pathItem || typeof pathItem !== 'object') continue;\n      for (const method of methods) {\n        const op = (pathItem as any)[method];\n        if (!op) continue;\n        operations.push({\n          method: method.toUpperCase(),\n          path: pathStr,\n          summary: op.summary || '',\n          description: op.description || '',\n          tags: Array.isArray(op.tags) ? op.tags : ['default'],\n          byteStart: 0,\n          byteEnd: contentBytes,\n        });\n      }\n    }\n  } catch { /* invalid JSON */ }\n  return operations;\n}\n\nfunction buildSections(operations: OpenAPIOperation[], content: string): ParsedSection[] {\n  const contentBytes = Buffer.byteLength(content, 'utf8');\n\n  if (operations.length === 0) {\n    return [{\n      title: '(API spec)',\n      level: 0,\n      byteStart: 0,\n      byteEnd: contentBytes,\n      content,\n      children: [],\n    }];\n  }\n\n  // Group by tag\n  const byTag = new Map<string, OpenAPIOperation[]>();\n  for (const op of operations) {\n    for (const tag of op.tags) {\n      if (!byTag.has(tag)) byTag.set(tag, []);\n      byTag.get(tag)!.push(op);\n    }\n  }\n\n  const root: ParsedSection[] = [];\n  for (const [tag, ops] of byTag) {\n    const children: ParsedSection[] = ops.map(op => ({\n      title: `${op.method} ${op.path}`,\n      level: 2,\n      byteStart: op.byteStart,\n      byteEnd: op.byteEnd,\n      content: [op.summary, op.description].filter(Boolean).join('\\n') || `${op.method} ${op.path}`,\n      children: [],\n    }));\n\n    root.push({\n      title: tag,\n      level: 1,\n      byteStart: ops[0]?.byteStart ?? 0,\n      byteEnd: ops[ops.length - 1]?.byteEnd ?? contentBytes,\n      content: `Tag: ${tag}\\n${ops.map(o => `${o.method} ${o.path}`).join('\\n')}`,\n      children,\n    });\n  }\n\n  return root;\n}\n\nexport const openapiParser: DocFormatParser = {\n  name: 'openapi',\n  extensions: [], // Not registered by extension \u2014 detected by content\n\n  parse(content: string, filePath: string): ParseResult {\n    const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();\n    const operations = ext === '.json'\n      ? parseJSONOperations(content)\n      : parseYAMLOperations(content);\n\n    const sections = buildSections(operations, content);\n    return { sections, format: 'openapi' };\n  },\n};\n\n/**\n * Check if a file is an OpenAPI spec (used by the format registry for content-based detection).\n */\nexport function isOpenAPI(content: string, filePath: string): boolean {\n  return isOpenAPIContent(content, filePath);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuBA,SAAS,iBAAiB,SAAiB,UAA2B;AACpE,QAAM,MAAM,SAAS,MAAM,SAAS,YAAY,GAAG,CAAC,EAAE,YAAY;AAClE,MAAI,QAAQ,SAAS;AACnB,QAAI;AACF,YAAM,SAAS,KAAK,MAAM,OAAO;AACjC,aAAO,aAAa,UAAU,aAAa;AAAA,IAC7C,QAAQ;AAAE,aAAO;AAAA,IAAO;AAAA,EAC1B;AAEA,SAAO,0BAA0B,KAAK,OAAO;AAC/C;AAEA,SAAS,oBAAoB,SAAqC;AAChE,QAAM,aAAiC,CAAC;AACxC,QAAM,QAAQ,QAAQ,MAAM,IAAI;AAChC,MAAI,UAAU;AACd,MAAI,cAAc;AAClB,MAAI,gBAAgB;AACpB,MAAI,cAAwB,CAAC;AAC7B,MAAI,iBAAiB;AACrB,MAAI,qBAAqB;AACzB,MAAI,UAAU;AACd,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,aAAa,KAAK,IAAI,GAAG;AAC3B,gBAAU;AACV,oBAAc;AACd;AAAA,IACF;AAGA,QAAI,WAAW,MAAM,KAAK,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,GAAG;AAEvD,UAAI,eAAe,eAAe;AAChC,mBAAW,KAAK;AAAA,UACd,QAAQ,cAAc,YAAY;AAAA,UAClC,MAAM;AAAA,UACN,SAAS;AAAA,UACT,aAAa;AAAA,UACb,MAAM,YAAY,SAAS,IAAI,cAAc,CAAC,SAAS;AAAA,UACvD,WAAW;AAAA,UACX,SAAS;AAAA,QACX,CAAC;AAAA,MACH;AACA,gBAAU;AACV,oBAAc;AACd;AAAA,IACF;AAEA,QAAI,SAAS;AAEX,YAAM,YAAY,KAAK,MAAM,kCAAkC;AAC/D,UAAI,WAAW;AAEb,YAAI,eAAe,eAAe;AAChC,qBAAW,KAAK;AAAA,YACd,QAAQ,cAAc,YAAY;AAAA,YAClC,MAAM;AAAA,YACN,SAAS;AAAA,YACT,aAAa;AAAA,YACb,MAAM,YAAY,SAAS,IAAI,cAAc,CAAC,SAAS;AAAA,YACvD,WAAW;AAAA,YACX,SAAS;AAAA,UACX,CAAC;AACD,0BAAgB;AAChB,2BAAiB;AACjB,+BAAqB;AACrB,wBAAc,CAAC;AAAA,QACjB;AACA,sBAAc,UAAU,CAAC;AAAA,MAC3B;AAGA,YAAM,cAAc,KAAK,MAAM,oDAAoD;AACnF,UAAI,aAAa;AAEf,YAAI,eAAe;AACjB,qBAAW,KAAK;AAAA,YACd,QAAQ,cAAc,YAAY;AAAA,YAClC,MAAM;AAAA,YACN,SAAS;AAAA,YACT,aAAa;AAAA,YACb,MAAM,YAAY,SAAS,IAAI,cAAc,CAAC,SAAS;AAAA,YACvD,WAAW;AAAA,YACX,SAAS;AAAA,UACX,CAAC;AAAA,QACH;AACA,wBAAgB,YAAY,CAAC;AAC7B,yBAAiB;AACjB,6BAAqB;AACrB,sBAAc,CAAC;AACf,kBAAU;AAAA,MACZ;AAGA,YAAM,eAAe,KAAK,MAAM,yCAAyC;AACzE,UAAI,aAAc,kBAAiB,aAAa,CAAC;AAGjD,YAAM,YAAY,KAAK,MAAM,6CAA6C;AAC1E,UAAI,UAAW,sBAAqB,UAAU,CAAC;AAG/C,YAAM,WAAW,KAAK,MAAM,+BAA+B;AAC3D,UAAI,YAAY,IAAI,KAAK,iBAAiB,KAAK,MAAM,IAAI,CAAC,KAAK,EAAE,GAAG;AAClE,oBAAY,KAAK,SAAS,CAAC,CAAC;AAAA,MAC9B;AAEA,UAAI,iBAAiB,KAAK,IAAI,GAAG;AAE/B,iBAAS,IAAI,IAAI,GAAG,IAAI,MAAM,UAAU,UAAU,KAAK,MAAM,CAAC,CAAC,GAAG,KAAK;AACrE,gBAAM,IAAI,MAAM,CAAC,EAAE,MAAM,+BAA+B;AACxD,cAAI,EAAG,aAAY,KAAK,EAAE,CAAC,CAAC;AAAA,QAC9B;AAAA,MACF;AAAA,IACF;AAEA,kBAAc;AAAA,EAChB;AAGA,MAAI,eAAe,eAAe;AAChC,eAAW,KAAK;AAAA,MACd,QAAQ,cAAc,YAAY;AAAA,MAClC,MAAM;AAAA,MACN,SAAS;AAAA,MACT,aAAa;AAAA,MACb,MAAM,YAAY,SAAS,IAAI,cAAc,CAAC,SAAS;AAAA,MACvD,WAAW;AAAA,MACX,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAEA,SAAS,oBAAoB,SAAqC;AAChE,QAAM,aAAiC,CAAC;AACxC,MAAI;AACF,UAAM,OAAO,KAAK,MAAM,OAAO;AAC/B,UAAM,QAAQ,KAAK,SAAS,CAAC;AAC7B,UAAM,eAAe,OAAO,WAAW,SAAS,MAAM;AACtD,UAAM,UAAU,CAAC,OAAO,QAAQ,OAAO,UAAU,SAAS,QAAQ,SAAS;AAE3E,eAAW,CAAC,SAAS,QAAQ,KAAK,OAAO,QAAQ,KAAK,GAAG;AACvD,UAAI,CAAC,YAAY,OAAO,aAAa,SAAU;AAC/C,iBAAW,UAAU,SAAS;AAC5B,cAAM,KAAM,SAAiB,MAAM;AACnC,YAAI,CAAC,GAAI;AACT,mBAAW,KAAK;AAAA,UACd,QAAQ,OAAO,YAAY;AAAA,UAC3B,MAAM;AAAA,UACN,SAAS,GAAG,WAAW;AAAA,UACvB,aAAa,GAAG,eAAe;AAAA,UAC/B,MAAM,MAAM,QAAQ,GAAG,IAAI,IAAI,GAAG,OAAO,CAAC,SAAS;AAAA,UACnD,WAAW;AAAA,UACX,SAAS;AAAA,QACX,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF,QAAQ;AAAA,EAAqB;AAC7B,SAAO;AACT;AAEA,SAAS,cAAc,YAAgC,SAAkC;AACvF,QAAM,eAAe,OAAO,WAAW,SAAS,MAAM;AAEtD,MAAI,WAAW,WAAW,GAAG;AAC3B,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;AAGA,QAAM,QAAQ,oBAAI,IAAgC;AAClD,aAAW,MAAM,YAAY;AAC3B,eAAW,OAAO,GAAG,MAAM;AACzB,UAAI,CAAC,MAAM,IAAI,GAAG,EAAG,OAAM,IAAI,KAAK,CAAC,CAAC;AACtC,YAAM,IAAI,GAAG,EAAG,KAAK,EAAE;AAAA,IACzB;AAAA,EACF;AAEA,QAAM,OAAwB,CAAC;AAC/B,aAAW,CAAC,KAAK,GAAG,KAAK,OAAO;AAC9B,UAAM,WAA4B,IAAI,IAAI,SAAO;AAAA,MAC/C,OAAO,GAAG,GAAG,MAAM,IAAI,GAAG,IAAI;AAAA,MAC9B,OAAO;AAAA,MACP,WAAW,GAAG;AAAA,MACd,SAAS,GAAG;AAAA,MACZ,SAAS,CAAC,GAAG,SAAS,GAAG,WAAW,EAAE,OAAO,OAAO,EAAE,KAAK,IAAI,KAAK,GAAG,GAAG,MAAM,IAAI,GAAG,IAAI;AAAA,MAC3F,UAAU,CAAC;AAAA,IACb,EAAE;AAEF,SAAK,KAAK;AAAA,MACR,OAAO;AAAA,MACP,OAAO;AAAA,MACP,WAAW,IAAI,CAAC,GAAG,aAAa;AAAA,MAChC,SAAS,IAAI,IAAI,SAAS,CAAC,GAAG,WAAW;AAAA,MACzC,SAAS,QAAQ,GAAG;AAAA,EAAK,IAAI,IAAI,OAAK,GAAG,EAAE,MAAM,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,IAAI,CAAC;AAAA,MACzE;AAAA,IACF,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAEO,MAAM,gBAAiC;AAAA,EAC5C,MAAM;AAAA,EACN,YAAY,CAAC;AAAA;AAAA,EAEb,MAAM,SAAiB,UAA+B;AACpD,UAAM,MAAM,SAAS,MAAM,SAAS,YAAY,GAAG,CAAC,EAAE,YAAY;AAClE,UAAM,aAAa,QAAQ,UACvB,oBAAoB,OAAO,IAC3B,oBAAoB,OAAO;AAE/B,UAAM,WAAW,cAAc,YAAY,OAAO;AAClD,WAAO,EAAE,UAAU,QAAQ,UAAU;AAAA,EACvC;AACF;AAKO,SAAS,UAAU,SAAiB,UAA2B;AACpE,SAAO,iBAAiB,SAAS,QAAQ;AAC3C;",
+  "names": []
+}

package/dist/docs/formats/org.js

@@ -0,0 +1,117 @@
+"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 org_exports = {};
+__export(org_exports, {
+  orgParser: () => orgParser
+});
+module.exports = __toCommonJS(org_exports);
+const HEADING_RE = /^(\*{1,6})\s+(.+)$/;
+function extractHeadings(content) {
+  const lines = content.split("\n");
+  const headings = [];
+  let byteOffset = 0;
+  let inBlock = false;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const lineBytes = Buffer.byteLength(line, "utf8") + 1;
+    if (/^#\+BEGIN_/i.test(line)) {
+      inBlock = true;
+      byteOffset += lineBytes;
+      continue;
+    }
+    if (/^#\+END_/i.test(line)) {
+      inBlock = false;
+      byteOffset += lineBytes;
+      continue;
+    }
+    if (!inBlock) {
+      const match = line.match(HEADING_RE);
+      if (match) {
+        let title = match[2].trim();
+        title = title.replace(/^(TODO|DONE|NEXT|WAITING|CANCELLED)\s+/, "");
+        title = title.replace(/^\[#[A-Z]\]\s+/, "");
+        title = title.replace(/\s+:[^\s:]+(?::[^\s:]+)*:\s*$/, "");
+        headings.push({
+          title,
+          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 orgParser = {
+  name: "org",
+  extensions: [".org"],
+  parse(content, _filePath) {
+    const headings = extractHeadings(content);
+    const sections = buildHierarchy(headings, content);
+    return { sections, format: "org" };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  orgParser
+});
+//# sourceMappingURL=org.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/docs/formats/org.ts"],
+  "sourcesContent": ["/**\n * Org-mode Section Parser\n *\n * Handles: .org\n * Parsing strategy: * heading hierarchy (* Title, ** Section, *** Subsection)\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 inBlock = 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 source blocks (#+BEGIN_SRC ... #+END_SRC)\n    if (/^#\\+BEGIN_/i.test(line)) { inBlock = true; byteOffset += lineBytes; continue; }\n    if (/^#\\+END_/i.test(line)) { inBlock = false; byteOffset += lineBytes; continue; }\n\n    if (!inBlock) {\n      const match = line.match(HEADING_RE);\n      if (match) {\n        // Strip TODO keywords and priority cookies from title\n        let title = match[2].trim();\n        title = title.replace(/^(TODO|DONE|NEXT|WAITING|CANCELLED)\\s+/, '');\n        title = title.replace(/^\\[#[A-Z]\\]\\s+/, '');\n        // Strip tags at end (:tag1:tag2:)\n        title = title.replace(/\\s+:[^\\s:]+(?::[^\\s:]+)*:\\s*$/, '');\n\n        headings.push({\n          title,\n          level: match[1].length,\n          lineIndex: i,\n          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 orgParser: DocFormatParser = {\n  name: 'org',\n  extensions: ['.org'],\n\n  parse(content: string, _filePath: string): ParseResult {\n    const headings = extractHeadings(content);\n    const sections = buildHierarchy(headings, content);\n    return { sections, format: 'org' };\n  },\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,MAAM,aAAa;AASnB,SAAS,gBAAgB,SAA+B;AACtD,QAAM,QAAQ,QAAQ,MAAM,IAAI;AAChC,QAAM,WAAyB,CAAC;AAChC,MAAI,aAAa;AACjB,MAAI,UAAU;AAEd,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,UAAM,OAAO,MAAM,CAAC;AACpB,UAAM,YAAY,OAAO,WAAW,MAAM,MAAM,IAAI;AAGpD,QAAI,cAAc,KAAK,IAAI,GAAG;AAAE,gBAAU;AAAM,oBAAc;AAAW;AAAA,IAAU;AACnF,QAAI,YAAY,KAAK,IAAI,GAAG;AAAE,gBAAU;AAAO,oBAAc;AAAW;AAAA,IAAU;AAElF,QAAI,CAAC,SAAS;AACZ,YAAM,QAAQ,KAAK,MAAM,UAAU;AACnC,UAAI,OAAO;AAET,YAAI,QAAQ,MAAM,CAAC,EAAE,KAAK;AAC1B,gBAAQ,MAAM,QAAQ,0CAA0C,EAAE;AAClE,gBAAQ,MAAM,QAAQ,kBAAkB,EAAE;AAE1C,gBAAQ,MAAM,QAAQ,iCAAiC,EAAE;AAEzD,iBAAS,KAAK;AAAA,UACZ;AAAA,UACA,OAAO,MAAM,CAAC,EAAE;AAAA,UAChB,WAAW;AAAA,UACX;AAAA,QACF,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": []
+}