@codesys/mcp-toolkit 1.5.8 → 2.0.0-alpha.0

package/dist/codesys/devices.d.ts

@@ -0,0 +1,34 @@
+/** The device tree and its I/O mapping, as CODESYS exports it. Pure: parsing and formatting only. */
+export interface DeviceInfo {
+    /** Path from the project root, e.g. "Device/Plc Logic/..." or "PLCWinNT/EtherCAT_Master/EL1008". */
+    path: string;
+    name: string;
+    depth: number;
+    type?: number | null;
+    id?: string;
+    version?: string;
+    enabled?: boolean | null;
+    /** The device's I/O mapping in CODESYS's CSV export format (only when it has channels). */
+    io_csv?: string;
+    io_error?: string;
+}
+export interface IoChannel {
+    /** The mapped variable, e.g. "Application.GVL_IO.xValve"; empty when nothing is mapped. */
+    variable: string;
+    /** "Parameter name @ counter in device", e.g. "Input@1" or "Bit0@3". */
+    parameter: string;
+    unit: string;
+    description: string;
+    /** IEC address, e.g. "%IX0.0". */
+    address: string;
+    device: string;
+}
+/**
+ * Parse CODESYS's I/O mapping export ("//CoDeSys Mapping Export V1.2"): comment lines start
+ * with "//"; the column header names "Mapped variable", "Parameter name @ counter in device",
+ * "Unit", "Description", "IEC address", "Device name". The separator is taken from that header.
+ */
+export declare function parseIoMappingCsv(text: string): IoChannel[];
+/** "Application.GVL_IO.xValve" -> "GVL_IO.xValve" (the toolkit's paths are relative to the application). */
+export declare const shortVariable: (v: string) => string;
+export declare function describeDevices(devices: DeviceInfo[]): string;

package/dist/codesys/devices.js

@@ -0,0 +1,82 @@
+/** The device tree and its I/O mapping, as CODESYS exports it. Pure: parsing and formatting only. */
+/** Split one CSV line, honouring double quotes. */
+function splitCsv(line, sep) {
+    const out = [];
+    let cur = "";
+    let quoted = false;
+    for (let i = 0; i < line.length; i++) {
+        const c = line[i];
+        if (c === '"') {
+            if (quoted && line[i + 1] === '"') {
+                cur += '"';
+                i++;
+            }
+            else
+                quoted = !quoted;
+        }
+        else if (c === sep && !quoted) {
+            out.push(cur);
+            cur = "";
+        }
+        else
+            cur += c;
+    }
+    out.push(cur);
+    return out.map((s) => s.trim());
+}
+/**
+ * Parse CODESYS's I/O mapping export ("//CoDeSys Mapping Export V1.2"): comment lines start
+ * with "//"; the column header names "Mapped variable", "Parameter name @ counter in device",
+ * "Unit", "Description", "IEC address", "Device name". The separator is taken from that header.
+ */
+export function parseIoMappingCsv(text) {
+    const lines = text.split(/\r?\n/);
+    const header = lines.find((l) => /mapped variable/i.test(l)) ?? "";
+    const sep = [";", "\t", ","].find((s) => header.includes(s)) ?? ",";
+    const names = splitCsv(header, sep).map((h) => h.replace(/^\/\//, "").trim().toLowerCase());
+    const col = (re, fallback) => {
+        const i = names.findIndex((n) => re.test(n));
+        return i >= 0 ? i : fallback;
+    };
+    const at = {
+        variable: col(/^mapped variable/, 0),
+        parameter: col(/^parameter/, 1),
+        unit: col(/^unit/, 2),
+        description: col(/^description/, 3),
+        address: col(/address$/, 4),
+        device: col(/^device/, 5),
+    };
+    const out = [];
+    for (const l of lines) {
+        if (!l.trim() || l.startsWith("//"))
+            continue;
+        const c = splitCsv(l, sep);
+        out.push({
+            variable: c[at.variable] ?? "",
+            parameter: c[at.parameter] ?? "",
+            unit: c[at.unit] ?? "",
+            description: c[at.description] ?? "",
+            address: c[at.address] ?? "",
+            device: c[at.device] ?? "",
+        });
+    }
+    return out;
+}
+/** "Application.GVL_IO.xValve" -> "GVL_IO.xValve" (the toolkit's paths are relative to the application). */
+export const shortVariable = (v) => v.replace(/^[A-Za-z_][A-Za-z0-9_]*\.(?=[A-Za-z_][A-Za-z0-9_]*\.)/, "");
+export function describeDevices(devices) {
+    if (!devices.length)
+        return "No devices in the project.";
+    const lines = [];
+    for (const d of devices) {
+        const ident = d.id ? ` (type ${d.type ?? "?"}, id ${d.id}, version ${d.version ?? "?"})` : "";
+        const channels = d.io_csv ? parseIoMappingCsv(d.io_csv) : [];
+        const mapped = channels.filter((c) => c.variable).length;
+        lines.push(`${"  ".repeat(d.depth)}${d.name}${ident}${d.enabled === false ? " [disabled]" : ""}${channels.length ? `: ${channels.length} channel(s), ${mapped} mapped` : ""}${d.io_error ? ` (I/O mapping not readable: ${d.io_error})` : ""}`);
+        for (const c of channels) {
+            lines.push(`${"  ".repeat(d.depth + 1)}${(c.address || "-").padEnd(10)} ${c.parameter}${c.description ? ` ${c.description}` : ""}${c.unit ? ` [${c.unit}]` : ""} -> ${c.variable ? shortVariable(c.variable) : "(not mapped)"}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=devices.js.map

package/dist/codesys/devices.js.map

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

package/dist/codesys/diff.d.ts

@@ -0,0 +1,13 @@
+/** Line diff (LCS) and unified-style formatting. Pure: also bundled into the panel. */
+export type DiffOp = {
+    op: " " | "+" | "-";
+    text: string;
+};
+/** Line diff (LCS). Falls back to remove-all/add-all for very large inputs. */
+export declare function lineDiff(a: string, b: string): DiffOp[];
+export declare const countDiff: (ops: DiffOp[]) => {
+    plus: number;
+    minus: number;
+};
+/** Unified-style hunks with line numbers of the new text and `context` lines around changes. */
+export declare function formatDiff(ops: DiffOp[], context?: number): string[];

package/dist/codesys/diff.js

@@ -0,0 +1,61 @@
+/** Line diff (LCS) and unified-style formatting. Pure: also bundled into the panel. */
+/** Line diff (LCS). Falls back to remove-all/add-all for very large inputs. */
+export function lineDiff(a, b) {
+    const x = a ? a.split("\n") : [];
+    const y = b ? b.split("\n") : [];
+    if (x.length * y.length > 4_000_000)
+        return [...x.map((t) => ({ op: "-", text: t })), ...y.map((t) => ({ op: "+", text: t }))];
+    const n = x.length;
+    const m = y.length;
+    const L = Array.from({ length: n + 1 }, () => new Uint32Array(m + 1));
+    for (let i = n - 1; i >= 0; i--)
+        for (let j = m - 1; j >= 0; j--)
+            L[i][j] = x[i] === y[j] ? L[i + 1][j + 1] + 1 : Math.max(L[i + 1][j], L[i][j + 1]);
+    const ops = [];
+    let i = 0;
+    let j = 0;
+    while (i < n && j < m) {
+        if (x[i] === y[j]) {
+            ops.push({ op: " ", text: x[i] });
+            i++;
+            j++;
+        }
+        else if (L[i + 1][j] >= L[i][j + 1])
+            ops.push({ op: "-", text: x[i++] });
+        else
+            ops.push({ op: "+", text: y[j++] });
+    }
+    while (i < n)
+        ops.push({ op: "-", text: x[i++] });
+    while (j < m)
+        ops.push({ op: "+", text: y[j++] });
+    return ops;
+}
+export const countDiff = (ops) => ({ plus: ops.filter((o) => o.op === "+").length, minus: ops.filter((o) => o.op === "-").length });
+/** Unified-style hunks with line numbers of the new text and `context` lines around changes. */
+export function formatDiff(ops, context = 2) {
+    const out = [];
+    let newLine = 0;
+    const numbered = ops.map((o) => {
+        if (o.op !== "-")
+            newLine++;
+        return { ...o, line: o.op === "-" ? undefined : newLine };
+    });
+    const keep = new Set();
+    numbered.forEach((o, k) => {
+        if (o.op !== " ")
+            for (let d = -context; d <= context; d++)
+                keep.add(k + d);
+    });
+    let last = -2;
+    numbered.forEach((o, k) => {
+        if (!keep.has(k))
+            return;
+        if (k !== last + 1 && out.length)
+            out.push("  ...");
+        out.push(`${o.op} ${o.line !== undefined ? String(o.line).padStart(4) : "    "} | ${o.text}`);
+        last = k;
+    });
+    return out;
+}
+//# sourceMappingURL=diff.js.map

package/dist/codesys/diff.js.map

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

package/dist/codesys/install.d.ts

@@ -0,0 +1,40 @@
+export interface CodesysInstall {
+    /** Full path to CODESYS.exe */
+    exe: string;
+    /** Profile names found in the Profiles folder, newest first. */
+    profiles: string[];
+    /** Templates folder (holds Standard.project), if present. */
+    templatesDir?: string;
+    /** Install folder name, e.g. "CODESYS 3.5.21.0". */
+    label: string;
+    /** Add-on folder passed as --additionalfolder (SP22 and later). */
+    additionalFolder?: string;
+}
+/** The workspace folder: created when missing, with a clear error when it can't be used. */
+export declare function ensureWorkspace(dir: string, log: (m: string) => void): string;
+/**
+ * The add-on folder CODESYS's own shortcuts start this install with
+ * (`--additionalfolder`). SP22 installs add-ons such as Scripting there:
+ * `<CODESYS>\AdditionalFolders\Default`, or the only folder in AdditionalFolders.
+ */
+export declare function findAdditionalFolder(base: string): string | undefined;
+export declare function describeInstall(exe: string, additionalFolder?: string): CodesysInstall;
+/** Scan Program Files for CODESYS installs (Windows only). */
+export declare function findInstalls(): CodesysInstall[];
+/** "CODESYS V3.5 SP22 Patch 1" -> a key that sorts numerically (SP9 < SP21 < SP22 < SP22 Patch 1). */
+export declare function profileKey(name: string): string;
+/** Newest profile first; names without a version last, alphabetically. */
+export declare function compareProfiles(a: string, b: string): number;
+export interface ResolvedCodesys {
+    exe: string;
+    profile: string;
+    install: CodesysInstall;
+    /** Why this install was picked, for the log. */
+    reason: string;
+    /** Something to log about the profile, when it couldn't be confirmed. */
+    warning?: string;
+}
+/** Pick the CODESYS exe + profile from options, falling back to the newest install. */
+export declare function resolveCodesys(exe?: string, profile?: string, additionalFolder?: string): ResolvedCodesys;
+/** "newest of 2 installs found (CODESYS 3.5.22.40, CODESYS 3.5.21.0); --codesys-path picks another" */
+export declare function pickedNewest(labels: string[]): string;

package/dist/codesys/install.js

@@ -0,0 +1,144 @@
+/** Find CODESYS installations, their profiles and project templates. */
+import { existsSync, mkdirSync, readdirSync, statSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+const isCodesysExe = (exe) => basename(exe).toLowerCase() === "codesys.exe";
+/**
+ * The folder holding an install's Profiles and Templates. CODESYS keeps them
+ * two levels above the program (`<root>\CODESYS\Common\CODESYS.exe`). Products
+ * built on CODESYS can lay this out differently, so look a few levels up.
+ */
+function installBase(exe) {
+    let dir = dirname(exe);
+    for (let level = 0; level < 3; level++) {
+        for (const base of [dir, join(dir, "CODESYS")])
+            if (existsSync(join(base, "Profiles")))
+                return base;
+        dir = dirname(dir);
+    }
+    return dirname(dirname(exe));
+}
+/** The workspace folder: created when missing, with a clear error when it can't be used. */
+export function ensureWorkspace(dir, log) {
+    try {
+        if (existsSync(dir)) {
+            if (!statSync(dir).isDirectory())
+                throw new Error("it is a file, not a folder");
+            return dir;
+        }
+        mkdirSync(dir, { recursive: true });
+        log(`created the workspace folder ${dir}`);
+        return dir;
+    }
+    catch (e) {
+        throw new Error(`Can't use the workspace ${dir}: ${e.message}`);
+    }
+}
+/**
+ * The add-on folder CODESYS's own shortcuts start this install with
+ * (`--additionalfolder`). SP22 installs add-ons such as Scripting there:
+ * `<CODESYS>\AdditionalFolders\Default`, or the only folder in AdditionalFolders.
+ */
+export function findAdditionalFolder(base) {
+    const root = join(base, "AdditionalFolders");
+    if (!existsSync(root))
+        return undefined;
+    const dirs = readdirSync(root, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
+    const pick = dirs.find((d) => d.toLowerCase() === "default") ?? (dirs.length === 1 ? dirs[0] : undefined);
+    return pick ? join(root, pick) : undefined;
+}
+function profilesIn(dir) {
+    const profilesDir = join(dir, "Profiles");
+    if (!existsSync(profilesDir))
+        return [];
+    return readdirSync(profilesDir)
+        .filter((f) => f.toLowerCase().endsWith(".profile.xml"))
+        .map((f) => f.slice(0, -".profile.xml".length));
+}
+export function describeInstall(exe, additionalFolder) {
+    const base = installBase(exe);
+    const extra = additionalFolder ?? findAdditionalFolder(base);
+    const profiles = [...new Set([...profilesIn(base), ...(extra ? profilesIn(extra) : [])])].sort(compareProfiles);
+    const templatesDir = join(base, "Templates");
+    return {
+        exe,
+        profiles,
+        templatesDir: existsSync(templatesDir) ? templatesDir : undefined,
+        label: isCodesysExe(exe) ? (dirname(base).split(/[\\/]/).pop() ?? base) : dirname(exe).split(/[\\/]/).slice(-2).join(" "),
+        ...(extra ? { additionalFolder: extra } : {}),
+    };
+}
+/** Scan Program Files for CODESYS installs (Windows only). */
+export function findInstalls() {
+    const roots = [process.env["ProgramFiles"], process.env["ProgramFiles(x86)"], process.env["ProgramW6432"]]
+        .filter((r) => !!r)
+        .filter((r, i, a) => a.indexOf(r) === i);
+    const found = [];
+    for (const root of roots) {
+        if (!existsSync(root))
+            continue;
+        for (const dir of readdirSync(root)) {
+            if (!/^codesys/i.test(dir))
+                continue;
+            const exe = join(root, dir, "CODESYS", "Common", "CODESYS.exe");
+            if (existsSync(exe))
+                found.push(describeInstall(exe));
+        }
+    }
+    // Newest version first ("CODESYS 3.5.21.0" > "CODESYS 3.5.19.50").
+    return found.sort((a, b) => versionKey(b.label).localeCompare(versionKey(a.label)));
+}
+/** "CODESYS V3.5 SP22 Patch 1" -> a key that sorts numerically (SP9 < SP21 < SP22 < SP22 Patch 1). */
+export function profileKey(name) {
+    const m = /V(\d+)\.(\d+)(?:\.(\d+))?(?:\s*SP\s*(\d+))?(?:\s*Patch\s*(\d+))?/i.exec(name);
+    if (!m)
+        return "";
+    return [m[1], m[2], m[3], m[4], m[5]].map((n) => (n ?? "0").padStart(4, "0")).join(".");
+}
+/** Newest profile first; names without a version last, alphabetically. */
+export function compareProfiles(a, b) {
+    return profileKey(b).localeCompare(profileKey(a)) || a.localeCompare(b);
+}
+function versionKey(label) {
+    const m = label.match(/(\d+)\.(\d+)\.(\d+)\.(\d+)/);
+    return m ? m.slice(1).map((n) => n.padStart(4, "0")).join(".") : label;
+}
+/** Pick the CODESYS exe + profile from options, falling back to the newest install. */
+export function resolveCodesys(exe, profile, additionalFolder) {
+    if (additionalFolder && !existsSync(additionalFolder))
+        throw new Error(`CODESYS additional folder not found: ${additionalFolder}`);
+    let install;
+    let reason;
+    if (exe) {
+        if (!existsSync(exe))
+            throw new Error(`CODESYS executable not found: ${exe}`);
+        install = describeInstall(exe, additionalFolder);
+        reason = "set with --codesys-path";
+    }
+    else {
+        const all = findInstalls();
+        const withProfile = profile ? all.find((i) => i.profiles.includes(profile)) : undefined;
+        install = withProfile ?? all[0];
+        if (!install)
+            throw new Error("No CODESYS installation found. Pass --codesys-path <...\\CODESYS\\Common\\CODESYS.exe>.");
+        reason = withProfile ? `it has profile "${profile}"` : pickedNewest(all.map((i) => i.label));
+        if (additionalFolder)
+            install = { ...install, additionalFolder };
+    }
+    const prof = profile ?? install.profiles[0];
+    if (!prof)
+        throw new Error(`No CODESYS profile found next to ${install.exe}. Pass --codesys-profile "<name>".`);
+    let warning;
+    if (profile && !install.profiles.some((p) => p.toLowerCase() === profile.toLowerCase())) {
+        const known = install.profiles.join(", ");
+        // Only CODESYS.exe is known to name its profiles after these files; other products get the benefit of the doubt.
+        if (known && isCodesysExe(install.exe))
+            throw new Error(`Profile "${profile}" isn't installed next to ${install.exe}. Installed profiles: ${known}.`);
+        warning = known ? `profile "${profile}" isn't among those found next to ${install.exe} (${known}); trying it anyway` : `no Profiles folder found near ${install.exe}, so profile "${profile}" can't be checked`;
+    }
+    return { exe: install.exe, profile: prof, install, reason, ...(warning ? { warning } : {}) };
+}
+/** "newest of 2 installs found (CODESYS 3.5.22.40, CODESYS 3.5.21.0); --codesys-path picks another" */
+export function pickedNewest(labels) {
+    return labels.length === 1 ? "the only install found" : `newest of ${labels.length} installs found (${labels.join(", ")}); --codesys-path picks another`;
+}
+//# sourceMappingURL=install.js.map

package/dist/codesys/install.js.map

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

package/dist/codesys/library-browse.d.ts

@@ -0,0 +1,19 @@
+export interface BrowseEntry {
+    name: string;
+    comment?: string;
+}
+export interface InstalledLibrary {
+    title: string;
+    version: string;
+    company: string;
+}
+export declare function parseBrowseCache(xml: string): BrowseEntry[];
+/** The newest of several installed versions, compared as numbers (3.5.22 is newer than 3.5.9). */
+export declare function newestLibrary<T extends {
+    version: string;
+}>(libs: T[]): T | undefined;
+/** The library's browse cache in one of the repositories CODESYS reports. */
+export declare function browseCacheFile(repositories: string[], lib: InstalledLibrary): string | undefined;
+export declare function readBrowseCache(file: string): BrowseEntry[];
+/** A library's objects as text; `symbol` narrows it to names or descriptions containing that text. */
+export declare function describeBrowse(head: string, entries: BrowseEntry[], symbol?: string, maxLines?: number): string;

package/dist/codesys/library-browse.js

@@ -0,0 +1,57 @@
+/**
+ * What CODESYS's own library browser knows about an installed library. Each
+ * library in a repository has a `browsercache` XML file listing its objects
+ * and their descriptions. Scripting can't read a compiled library's contents,
+ * and this works for libraries the project doesn't reference yet.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+const decode = (s) => s
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&quot;/g, '"')
+    .replace(/&apos;/g, "'")
+    .replace(/&#x([0-9a-fA-F]+);/g, (_, h) => String.fromCodePoint(parseInt(h, 16)))
+    .replace(/&#(\d+);/g, (_, d) => String.fromCodePoint(parseInt(d, 10)))
+    .replace(/&amp;/g, "&");
+export function parseBrowseCache(xml) {
+    const out = [];
+    for (const node of xml.matchAll(/<Node\s+([^>]*?)\/?>/g)) {
+        const attrs = new Map([...node[1].matchAll(/(\w+)="([^"]*)"/g)].map((a) => [a[1], decode(a[2])]));
+        const name = attrs.get("Name");
+        if (!name)
+            continue;
+        const comment = attrs.get("Comment")?.trim().replace(/\s+/g, " ");
+        out.push({ name, ...(comment ? { comment } : {}) });
+    }
+    return out;
+}
+const versionParts = (v) => v.split(".").map((n) => Number.parseInt(n, 10) || 0);
+/** The newest of several installed versions, compared as numbers (3.5.22 is newer than 3.5.9). */
+export function newestLibrary(libs) {
+    return [...libs].sort((a, b) => {
+        const [x, y] = [versionParts(a.version), versionParts(b.version)];
+        for (let i = 0; i < Math.max(x.length, y.length); i++)
+            if ((x[i] ?? 0) !== (y[i] ?? 0))
+                return (y[i] ?? 0) - (x[i] ?? 0);
+        return 0;
+    })[0];
+}
+/** The library's browse cache in one of the repositories CODESYS reports. */
+export function browseCacheFile(repositories, lib) {
+    return repositories.map((root) => join(root, lib.company, lib.title, lib.version, "browsercache")).find((f) => existsSync(f));
+}
+export function readBrowseCache(file) {
+    return parseBrowseCache(readFileSync(file, "utf8"));
+}
+/** A library's objects as text; `symbol` narrows it to names or descriptions containing that text. */
+export function describeBrowse(head, entries, symbol, maxLines = 300) {
+    const want = symbol?.toLowerCase();
+    const shown = want ? entries.filter((e) => e.name.toLowerCase().includes(want) || e.comment?.toLowerCase().includes(want)) : entries;
+    if (want && !shown.length)
+        return `${head} has nothing matching '${symbol}'.`;
+    const lines = shown.slice(0, maxLines).map((e) => `- ${e.name}${e.comment ? ` :: ${e.comment}` : ""}`);
+    const more = shown.length > maxLines ? [`... ${shown.length - maxLines} more. Pass symbol to narrow it.`] : [];
+    return [`${head}: ${want ? `${shown.length} of ` : ""}${entries.length} objects, from CODESYS's library browser. Parameters aren't listed here; test a call with compile.`, ...lines, ...more].join("\n");
+}
+//# sourceMappingURL=library-browse.js.map

package/dist/codesys/library-browse.js.map

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

package/dist/codesys/outline.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Project outline for the model: what exists, how to call it, and what runs
+ * it, without reading every object. Built from the CODESYS export (all ST
+ * text in one call) and the task list.
+ */
+import type { TreeNode } from "./st.js";
+export interface OutlineTask {
+    name: string;
+    interval?: string | null;
+    interval_unit?: string | null;
+    priority?: string | null;
+    kind?: string | null;
+    pous: string[];
+}
+export interface OutlineOptions {
+    /** An object or folder path: details for an object, an overview of a folder. */
+    path?: string;
+    /** Max lines of output (default 400). */
+    maxLines?: number;
+}
+export declare function buildOutline(nodes: TreeNode[], tasks: OutlineTask[], o?: OutlineOptions): string;
+export interface IoEntry {
+    owner: string;
+    name: string;
+    at: string;
+    type: string;
+    direction: "input" | "output" | "memory";
+    comment?: string;
+    placeholder: boolean;
+}
+/** Variables with AT addresses (including the %I* and %Q* placeholders), from GVLs and POUs. */
+export declare function ioList(nodes: TreeNode[]): IoEntry[];