@roarpeng/graphflow 1.7.9 → 1.7.11

package/dist/graph/language-indexers/markdown.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.markdownIndexer = void 0;
+exports.buildDocumentEdges = buildDocumentEdges;
+exports.markdownIndexer = {
+    language: "markdown",
+    extensions: [".md"],
+    extract(filePath, content) {
+        const symbols = [];
+        const imports = [];
+        const lines = content.split(/\r?\n/);
+        let frontmatterTitle;
+        if (lines[0]?.trim() === "---") {
+            for (let i = 1; i < lines.length; i++) {
+                const line = lines[i]?.trim();
+                if (line === "---")
+                    break;
+                const match = /^(\w[\w-]*):\s*(.+)/.exec(line ?? "");
+                if (match && match[1] === "title") {
+                    frontmatterTitle = match[2].trim();
+                }
+            }
+        }
+        const headings = [];
+        const headingRegex = /^(#{1,6})\s+(.+)$/;
+        const wikiLinkRegex = /\[\[([^\]]+)\]\]/g;
+        const mdLinkRegex = /\[([^\]]*)\]\(([^)]+)\)/g;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i] ?? "";
+            const headingMatch = headingRegex.exec(line);
+            if (headingMatch) {
+                headings.push({
+                    line: i + 1,
+                    level: headingMatch[1].length,
+                    text: headingMatch[2].trim(),
+                });
+            }
+            let wikiMatch;
+            wikiLinkRegex.lastIndex = 0;
+            while ((wikiMatch = wikiLinkRegex.exec(line)) !== null) {
+                imports.push({ module: wikiMatch[1].trim() });
+            }
+            let mdMatch;
+            mdLinkRegex.lastIndex = 0;
+            while ((mdMatch = mdLinkRegex.exec(line)) !== null) {
+                const text = mdMatch[1]?.trim() ?? "";
+                const url = mdMatch[2]?.trim() ?? "";
+                imports.push({ module: url, raw: text });
+            }
+        }
+        for (const heading of headings) {
+            const headingLine = lines[heading.line - 1] ?? "";
+            symbols.push({
+                name: heading.text.slice(0, 120),
+                kind: "section",
+                exported: true,
+                line: heading.line,
+                file: filePath,
+                jsdoc: `#${heading.level}`,
+                signature: headingLine.trim(),
+            });
+        }
+        if (frontmatterTitle && symbols.length > 0 && symbols[0]?.kind === "section") {
+            symbols[0].name = frontmatterTitle.slice(0, 120);
+        }
+        if (headings.length === 0) {
+            const chunkContent = content.trim();
+            if (chunkContent) {
+                symbols.push({
+                    name: chunkContent.slice(0, 80),
+                    kind: "chunk",
+                    exported: true,
+                    line: 1,
+                    file: filePath,
+                    signature: chunkContent,
+                });
+            }
+        }
+        else {
+            let contentStartLine = 1;
+            if (lines[0]?.trim() === "---") {
+                for (let i = 1; i < lines.length; i++) {
+                    if (lines[i]?.trim() === "---") {
+                        contentStartLine = i + 2;
+                        break;
+                    }
+                }
+            }
+            for (let i = 0; i < headings.length; i++) {
+                const heading = headings[i];
+                const nextHeading = headings[i + 1];
+                const startLine = i === 0 ? contentStartLine : heading.line + 1;
+                const endLine = nextHeading ? nextHeading.line - 1 : lines.length;
+                if (startLine <= endLine) {
+                    const chunkLines = [];
+                    for (let j = startLine; j <= endLine; j++) {
+                        chunkLines.push(lines[j - 1] ?? "");
+                    }
+                    const chunkContent = chunkLines.join("\n").trim();
+                    if (chunkContent) {
+                        symbols.push({
+                            name: `chunk: ${heading.text.slice(0, 70)}`,
+                            kind: "chunk",
+                            exported: true,
+                            line: startLine,
+                            file: filePath,
+                            signature: chunkContent,
+                        });
+                    }
+                }
+            }
+        }
+        return { symbols, imports };
+    },
+};
+function buildDocumentEdges(fileNodeId, symbols) {
+    const edges = [];
+    const sections = symbols.filter((s) => s.kind === "section");
+    const chunks = symbols.filter((s) => s.kind === "chunk");
+    sections.sort((a, b) => a.line - b.line);
+    chunks.sort((a, b) => a.line - b.line);
+    for (const section of sections) {
+        edges.push({ from: section.nodeId, to: fileNodeId, relation: "part_of" });
+    }
+    for (let i = 0; i < sections.length - 1; i++) {
+        edges.push({
+            from: sections[i].nodeId,
+            to: sections[i + 1].nodeId,
+            relation: "next_section",
+        });
+    }
+    for (const chunk of chunks) {
+        const chunkLine = chunk.line;
+        let parentSection;
+        for (let i = sections.length - 1; i >= 0; i--) {
+            if (sections[i].line < chunkLine) {
+                parentSection = sections[i];
+                break;
+            }
+        }
+        if (parentSection) {
+            edges.push({
+                from: chunk.nodeId,
+                to: parentSection.nodeId,
+                relation: "part_of",
+            });
+        }
+        else {
+            edges.push({
+                from: chunk.nodeId,
+                to: fileNodeId,
+                relation: "part_of",
+            });
+        }
+    }
+    return edges;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/graph/language-indexers/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/graph/language-indexers/markdown.ts"],"names":[],"mappings":"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"}

package/dist/graph/language-indexers/plcopen-xml.d.ts

@@ -0,0 +1,16 @@
+/**
+ * plcopen-xml.ts — PLCopen XML indexer (IEC 61131-10 / Beremiz / OpenPLC)
+ *
+ * Regex-based parser that extracts POU, variable, task, and ST code
+ * symbols from PLCopen TC6-compliant XML project files.
+ *
+ * NOTE: PLC XML files can exceed DEFAULT_MAX_FILE_SIZE (200 KB) for
+ * large projects with many SFC steps or inlined data. Consider raising
+ * `maxFileSizeBytes` when indexing large PLC workspaces.
+ */
+import type { LanguageIndexer } from "./index.js";
+import type { GraphEdge } from "../../core/types.js";
+import type { IndexedSymbol } from "../file-indexer-nodes.js";
+export declare function buildPlcEdges(fileNodeId: string, symbols: IndexedSymbol[], _imports: string[]): GraphEdge[];
+export declare const plcopenIndexer: LanguageIndexer;
+//# sourceMappingURL=plcopen-xml.d.ts.map

package/dist/graph/language-indexers/plcopen-xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plcopen-xml.d.ts","sourceRoot":"","sources":["../../../src/graph/language-indexers/plcopen-xml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAkD,eAAe,EAAE,MAAM,YAAY,CAAC;AAClG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA0L9D,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,EAAE,EACxB,QAAQ,EAAE,MAAM,EAAE,GACjB,SAAS,EAAE,CA0Cb;AAED,eAAO,MAAM,cAAc,EAAE,eAI5B,CAAC"}

package/dist/graph/language-indexers/plcopen-xml.js

@@ -0,0 +1,204 @@
+"use strict";
+/**
+ * plcopen-xml.ts — PLCopen XML indexer (IEC 61131-10 / Beremiz / OpenPLC)
+ *
+ * Regex-based parser that extracts POU, variable, task, and ST code
+ * symbols from PLCopen TC6-compliant XML project files.
+ *
+ * NOTE: PLC XML files can exceed DEFAULT_MAX_FILE_SIZE (200 KB) for
+ * large projects with many SFC steps or inlined data. Consider raising
+ * `maxFileSizeBytes` when indexing large PLC workspaces.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.plcopenIndexer = void 0;
+exports.buildPlcEdges = buildPlcEdges;
+const PROJECT_TAG_RE = /<project\s+[^>]*xmlns\s*=\s*"[^"]*plcopen[^"]*"/i;
+const VAR_SCOPE_TAGS = [
+    "localVars",
+    "inputVars",
+    "outputVars",
+    "inOutVars",
+    "tempVars",
+    "returnType",
+];
+function isPlcOpenXml(content) {
+    return PROJECT_TAG_RE.test(content);
+}
+function extractTypeName(typeContent) {
+    const derived = typeContent.match(/<derived\s+name="([^"]+)"/);
+    if (derived?.[1])
+        return derived[1];
+    const baseType = typeContent.match(/<baseType>\s*<(\w+)\s*\/?>/);
+    if (baseType?.[1])
+        return baseType[1];
+    if (/<array>/.test(typeContent))
+        return "ARRAY";
+    const simple = typeContent.match(/<(\w+)\s*\/?>/);
+    if (simple?.[1])
+        return simple[1];
+    return "UNKNOWN";
+}
+function extractPouVariables(pouBody, pouName, filePath, symbols, imports) {
+    for (const scopeTag of VAR_SCOPE_TAGS) {
+        const scopeRe = new RegExp(`<${scopeTag}>([\\s\\S]*?)</${scopeTag}>`, "gi");
+        let scopeMatch;
+        while ((scopeMatch = scopeRe.exec(pouBody)) !== null) {
+            const scopeBody = scopeMatch[1];
+            if (!scopeBody)
+                continue;
+            const varRe = /<variable\s+name="([^"]+)">\s*<type>([\s\S]*?)<\/type>/gi;
+            let varMatch;
+            while ((varMatch = varRe.exec(scopeBody)) !== null) {
+                const varName = varMatch[1];
+                const typeContentRaw = varMatch[2];
+                if (!varName || !typeContentRaw)
+                    continue;
+                const typeContent = typeContentRaw.trim();
+                const varType = extractTypeName(typeContent);
+                const fullName = `${pouName}.${varName}`;
+                symbols.push({
+                    name: fullName,
+                    kind: "variable",
+                    line: 0,
+                    exported: true,
+                    signature: `VAR ${varType} ${fullName}`,
+                    jsdoc: `${pouName}:${scopeTag}`,
+                    file: filePath,
+                });
+                const derived = typeContent.match(/<derived\s+name="([^"]+)"/);
+                if (derived?.[1]) {
+                    imports.push({ module: `pou:${derived[1]}` });
+                }
+            }
+        }
+    }
+}
+function extractStCode(pouBody, pouName, filePath, symbols) {
+    const stRe = /<ST>\s*<xhtml>\s*<!\[CDATA\[([\s\S]*?)\]\]>\s*<\/xhtml>\s*<\/ST>/gi;
+    let match;
+    while ((match = stRe.exec(pouBody)) !== null) {
+        const code = match[1]?.trim();
+        if (!code)
+            continue;
+        symbols.push({
+            name: `${pouName}.st_code`,
+            kind: "code",
+            line: 0,
+            exported: true,
+            signature: code,
+            file: filePath,
+        });
+    }
+}
+function extractTasks(xml, filePath, symbols) {
+    const resourceRe = /<resource\s+name="([^"]+)"[^>]*>([\s\S]*?)<\/resource>/g;
+    let resourceMatch;
+    while ((resourceMatch = resourceRe.exec(xml)) !== null) {
+        const resourceName = resourceMatch[1];
+        const resourceBody = resourceMatch[2];
+        if (!resourceName || !resourceBody)
+            continue;
+        const taskRe = /<task\s+name="([^"]+)"(?:\s+priority="(\d+)")?(?:\s+interval="([^"]+)")?/gi;
+        let taskMatch;
+        while ((taskMatch = taskRe.exec(resourceBody)) !== null) {
+            const taskName = taskMatch[1];
+            if (!taskName)
+                continue;
+            const priority = taskMatch[2] ?? "0";
+            const interval = taskMatch[3] ?? "N/A";
+            symbols.push({
+                name: `task.${taskName}`,
+                kind: "task",
+                line: 0,
+                exported: true,
+                signature: `TASK ${taskName} interval=${interval} prio=${priority}`,
+                jsdoc: `resource=${resourceName}`,
+                file: filePath,
+            });
+        }
+    }
+}
+function extractInstanceRefs(xml, imports) {
+    const re = /<pouInstance\s+name="([^"]+)"\s+typeName="([^"]+)"/gi;
+    let match;
+    while ((match = re.exec(xml)) !== null) {
+        const typeName = match[2];
+        if (!typeName)
+            continue;
+        imports.push({ module: `pou:${typeName}` });
+    }
+}
+function extract(filePath, content) {
+    if (!isPlcOpenXml(content)) {
+        return { symbols: [], imports: [] };
+    }
+    const cleanXml = content.replace(/<!--[\s\S]*?-->/g, "");
+    const symbols = [];
+    const imports = [];
+    const pouRe = /<pou\s+[^>]*?\bname="([^"]+)"[^>]*?\bpouType="([^"]+)"[^>]*>([\s\S]*?)<\/pou>/g;
+    let pouMatch;
+    while ((pouMatch = pouRe.exec(cleanXml)) !== null) {
+        const pouName = pouMatch[1];
+        const pouType = pouMatch[2];
+        const pouBody = pouMatch[3];
+        if (!pouName || !pouType)
+            continue;
+        symbols.push({
+            name: pouName,
+            kind: "pou",
+            line: 0,
+            exported: true,
+            signature: `POU ${pouType} ${pouName}`,
+            jsdoc: pouType,
+            file: filePath,
+        });
+        if (pouBody) {
+            extractPouVariables(pouBody, pouName, filePath, symbols, imports);
+            extractStCode(pouBody, pouName, filePath, symbols);
+        }
+    }
+    extractTasks(cleanXml, filePath, symbols);
+    extractInstanceRefs(cleanXml, imports);
+    return { symbols, imports };
+}
+function buildPlcEdges(fileNodeId, symbols, _imports) {
+    const edges = [];
+    for (const sym of symbols) {
+        if (sym.kind === "variable" && sym.jsdoc) {
+            const pouName = sym.jsdoc.split(":")[0];
+            const pouNode = symbols.find((s) => s.kind === "pou" && s.name === pouName);
+            if (pouNode?.nodeId && sym.nodeId) {
+                edges.push({
+                    from: pouNode.nodeId,
+                    to: sym.nodeId,
+                    relation: "depends_on",
+                });
+            }
+        }
+        if (sym.kind === "code") {
+            const pouName = sym.name.replace(".st_code", "");
+            const pouNode = symbols.find((s) => s.kind === "pou" && s.name === pouName);
+            if (pouNode?.nodeId && sym.nodeId) {
+                edges.push({
+                    from: pouNode.nodeId,
+                    to: sym.nodeId,
+                    relation: "depends_on",
+                });
+            }
+        }
+        if (sym.kind === "task" && sym.nodeId) {
+            edges.push({
+                from: fileNodeId,
+                to: sym.nodeId,
+                relation: "depends_on",
+            });
+        }
+    }
+    return edges;
+}
+exports.plcopenIndexer = {
+    language: "plcopen",
+    extensions: [".xml"],
+    extract,
+};
+//# sourceMappingURL=plcopen-xml.js.map

package/dist/graph/language-indexers/plcopen-xml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plcopen-xml.js","sourceRoot":"","sources":["../../../src/graph/language-indexers/plcopen-xml.ts"],"names":[],"mappings":"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"}

package/dist/graph/language-indexers/st-analyzer.d.ts

@@ -0,0 +1,49 @@
+/**
+ * st-analyzer.ts — IEC 61131-3 Structured Text code analysis utility
+ *
+ * Extracts POU calls, data flow (variable reads/writes), and control flow
+ * from ST code embedded in PLCopen XML. Called by the plcopen-xml indexer
+ * to enhance its ExtractionResult.
+ *
+ * Integration guide for the plcopen-xml indexer:
+ *
+ *   import { analyzeStCode } from "./st-analyzer";
+ *
+ *   for (const pou of pouData) {
+ *     if (pou.stCode !== undefined) {
+ *       const analysis = analyzeStCode(pou.name, pou.stCode);
+ *       // Merge analysis.calls into ExtractionResult.calls
+ *       // Store analysis.dataFlow / analysis.controlFlow in POU symbol metadata
+ *       stCalls.push(...analysis.calls);
+ *     }
+ *   }
+ */
+import type { CallRelation } from "./index.js";
+export interface StDataFlow {
+    /** Qualified source: `${pouName}.${varName}` */
+    from: string;
+    /** Qualified target: `${pouName}.${varName}` or `${pouName}.IF_12` for conditions */
+    to: string;
+    kind: "reads" | "writes";
+    line: number;
+}
+export interface StControlFlow {
+    /** Parent block name or "entry" */
+    from: string;
+    /** Block label, e.g. "IF_3", "FOR_8", "CASE_12" */
+    to: string;
+    /** Condition expression (abbreviated), if applicable */
+    condition?: string;
+    type: "if" | "elsif" | "else" | "for" | "while" | "repeat" | "case" | "case_entry";
+    line: number;
+}
+export interface StAnalysisResult {
+    /** POU call relations extracted from ST code */
+    calls: CallRelation[];
+    /** Variable-level read / write edges within the POU */
+    dataFlow: StDataFlow[];
+    /** High-level control structure for code understanding */
+    controlFlow: StControlFlow[];
+}
+export declare function analyzeStCode(pouName: string, stCode: string): StAnalysisResult;
+//# sourceMappingURL=st-analyzer.d.ts.map

package/dist/graph/language-indexers/st-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"st-analyzer.d.ts","sourceRoot":"","sources":["../../../src/graph/language-indexers/st-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,MAAM,WAAW,UAAU;IACzB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,YAAY,CAAC;IACnF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,uDAAuD;IACvD,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,0DAA0D;IAC1D,WAAW,EAAE,aAAa,EAAE,CAAC;CAC9B;AAuMD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CA8P/E"}