kirograph 0.14.1 → 0.16.0

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": "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",
+  "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": []
+}

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": "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",
+  "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": []
+}