@codesys/mcp-toolkit 1.5.8 → 2.0.0

package/dist/codesys/decl.js

@@ -0,0 +1,251 @@
+/**
+ * A tolerant parser for CODESYS ST declarations: headers (kind, name,
+ * EXTENDS / IMPLEMENTS, return type, modifiers), variable sections with
+ * names, types, initial values, AT addresses and comments, enum members and
+ * struct fields. Used for the outline and the I/O list; it never rejects
+ * input, it just extracts what it recognises.
+ */
+const SECTION_RE = /^(VAR_INPUT|VAR_OUTPUT|VAR_IN_OUT|VAR_GLOBAL|VAR_EXTERNAL|VAR_CONFIG|VAR_TEMP|VAR_STAT|VAR_INST|VAR)\b(.*)$/i;
+const MODIFIERS = new Set(["PUBLIC", "PRIVATE", "PROTECTED", "INTERNAL", "ABSTRACT", "FINAL"]);
+/** Split text into statements ending in `;` outside brackets, strings and comments; keep the trailing line comment. */
+function statements(text) {
+    const out = [];
+    let cur = "";
+    let depth = 0;
+    let pendingComment;
+    let i = 0;
+    const push = () => {
+        const body = cur.replace(/\s+/g, " ").trim();
+        if (body)
+            out.push({ body, ...(pendingComment ? { comment: pendingComment } : {}) });
+        cur = "";
+        pendingComment = undefined;
+    };
+    while (i < text.length) {
+        const c = text[i];
+        const two = text.slice(i, i + 2);
+        if (two === "//") {
+            const end = text.indexOf("\n", i);
+            const comment = text.slice(i + 2, end < 0 ? undefined : end).trim();
+            // A comment right after `;` on the same line belongs to the previous statement.
+            const last = out.at(-1);
+            if (!cur.trim() && last && !last.comment && comment)
+                last.comment = comment;
+            else if (comment)
+                pendingComment ??= comment;
+            i = end < 0 ? text.length : end;
+            continue;
+        }
+        if (two === "(*" || two === "/*") {
+            const close = two === "(*" ? "*)" : "*/";
+            const end = text.indexOf(close, i + 2);
+            const comment = text.slice(i + 2, end < 0 ? undefined : end).trim();
+            const last = out.at(-1);
+            if (!cur.trim() && last && !last.comment && comment && !comment.includes("\n"))
+                last.comment = comment;
+            i = end < 0 ? text.length : end + 2;
+            continue;
+        }
+        if (c === "{") {
+            const end = text.indexOf("}", i);
+            cur += text.slice(i, end < 0 ? undefined : end + 1);
+            i = end < 0 ? text.length : end + 1;
+            continue;
+        }
+        if (c === "'" || c === '"') {
+            let j = i + 1;
+            while (j < text.length && text[j] !== c)
+                j += text[j] === "$" ? 2 : 1;
+            cur += text.slice(i, j + 1);
+            i = j + 1;
+            continue;
+        }
+        if (c === "(" || c === "[")
+            depth++;
+        if (c === ")" || c === "]")
+            depth = Math.max(0, depth - 1);
+        if (c === ";" && depth === 0) {
+            push();
+            i++;
+            continue;
+        }
+        if (c === "\n" && depth === 0) {
+            // Section keywords and headers have no `;`: end them at the line break.
+            const t = cur.trim();
+            // `TYPE X :` continues on the next line (the enum list or STRUCT).
+            if (/^(\{[^}]*\}\s*)*TYPE\b[^;]*:\s*$/i.test(t))
+                cur += " ";
+            else if (/^(\{[^}]*\}\s*)*(VAR\w*|END_VAR|END_STRUCT|END_UNION|END_TYPE|STRUCT|UNION|(PROGRAM|FUNCTION_BLOCK|FUNCTION|METHOD|PROPERTY|INTERFACE|TYPE)\b.*)(\s+\w+)*$/i.test(t) && !/:=/.test(t.replace(/^TYPE\b.*/i, "")))
+                push();
+            else
+                cur += " ";
+            i++;
+            continue;
+        }
+        cur += c;
+        i++;
+    }
+    push();
+    return out;
+}
+const splitList = (s) => s
+    .split(",")
+    .map((x) => x.trim())
+    .filter(Boolean);
+function parseHeader(stmt) {
+    const attributes = [...stmt.matchAll(/\{\s*attribute\s+'([^']+)'(?:\s*:=\s*'[^']*')?\s*\}/gi)].map((m) => m[1]);
+    const s = stmt.replace(/\{[^}]*\}/g, " ").replace(/\s+/g, " ").trim();
+    const m = /^(PROGRAM|FUNCTION_BLOCK|FUNCTION|METHOD|PROPERTY|INTERFACE|TYPE|VAR_GLOBAL|TEST_PROGRAM|TEST_FUNCTION_BLOCK)\b\s*(.*)$/i.exec(s);
+    if (!m)
+        return { keyword: "", modifiers: [], attributes };
+    const keyword = m[1].toUpperCase();
+    let rest = m[2];
+    const modifiers = [];
+    for (;;) {
+        const w = /^(\w+)\s*/.exec(rest);
+        if (w && MODIFIERS.has(w[1].toUpperCase())) {
+            modifiers.push(w[1].toUpperCase());
+            rest = rest.slice(w[0].length);
+        }
+        else
+            break;
+    }
+    const h = { keyword, modifiers, attributes };
+    const name = /^([A-Za-z_]\w*)/.exec(rest);
+    if (name) {
+        h.name = name[1];
+        rest = rest.slice(name[0].length).trim();
+    }
+    const ret = /^:\s*(.+?)(?=\s+(EXTENDS|IMPLEMENTS)\b|$)/i.exec(rest);
+    if (ret && keyword !== "TYPE")
+        h.returnType = ret[1].trim();
+    const ext = /\bEXTENDS\s+(.+?)(?=\s+IMPLEMENTS\b|$)/i.exec(rest);
+    if (ext)
+        h.extends = splitList(ext[1]);
+    const imp = /\bIMPLEMENTS\s+(.+)$/i.exec(rest);
+    if (imp)
+        h.implements = splitList(imp[1]);
+    return h;
+}
+function parseVar(body, section, flags, comment) {
+    const s = body.replace(/\{[^}]*\}/g, " ").trim();
+    const m = /^([A-Za-z_][\w\s,]*?)(?:\s+AT\s+(%\S+))?\s*:\s*([\s\S]+)$/i.exec(s);
+    if (!m)
+        return [];
+    let type = m[3].trim();
+    let init;
+    // `:=` at top level separates type and initial value.
+    let depth = 0;
+    for (let i = 0; i < type.length - 1; i++) {
+        const c = type[i];
+        if (c === "(" || c === "[")
+            depth++;
+        else if (c === ")" || c === "]")
+            depth--;
+        else if (depth === 0 && c === ":" && type[i + 1] === "=") {
+            init = type.slice(i + 2).trim();
+            type = type.slice(0, i).trim();
+            break;
+        }
+    }
+    return splitList(m[1]).map((name) => ({
+        name,
+        type,
+        section,
+        ...(init !== undefined ? { init } : {}),
+        ...(m[2] ? { at: m[2] } : {}),
+        ...(comment ? { comment } : {}),
+        ...(flags.constant ? { constant: true } : {}),
+        ...(flags.retain ? { retain: true } : {}),
+        ...(flags.persistent ? { persistent: true } : {}),
+    }));
+}
+export function parseDeclaration(decl) {
+    const stmts = statements(decl ?? "");
+    const result = { header: { keyword: "", modifiers: [], attributes: [] }, vars: [] };
+    let section;
+    let flags = { constant: false, retain: false, persistent: false };
+    let inStruct;
+    for (let k = 0; k < stmts.length; k++) {
+        const { body, comment } = stmts[k];
+        const plain = body.replace(/\{[^}]*\}/g, " ").trim();
+        if (!result.header.keyword) {
+            const h = parseHeader(body);
+            if (h.keyword) {
+                result.header = h;
+                if (h.keyword === "VAR_GLOBAL") {
+                    section = "VAR_GLOBAL";
+                    flags = { constant: /\bCONSTANT\b/i.test(body), retain: /\bRETAIN\b/i.test(body), persistent: /\bPERSISTENT\b/i.test(body) };
+                }
+                if (h.keyword === "TYPE") {
+                    // TYPE Name : (A := 0, B) INT  |  TYPE Name : STRUCT  |  TYPE Name : INT
+                    const t = /^TYPE\s+\w+\s*(?:EXTENDS\s+[\w.]+\s*)?:\s*([\s\S]*)$/i.exec(plain)?.[1]?.trim() ?? "";
+                    if (t.startsWith("(")) {
+                        const close = t.lastIndexOf(")");
+                        result.dutKind = "enum";
+                        result.enumMembers = splitList(t.slice(1, close)).map((x) => {
+                            const [n, v] = x.split(":=").map((y) => y.trim());
+                            return v !== undefined ? { name: n, value: v } : { name: n };
+                        });
+                        const base = t.slice(close + 1).trim();
+                        if (base)
+                            result.baseType = base;
+                    }
+                    else if (/^STRUCT\b/i.test(t)) {
+                        result.dutKind = "struct";
+                        inStruct = "struct";
+                        result.fields = [];
+                    }
+                    else if (/^UNION\b/i.test(t)) {
+                        result.dutKind = "union";
+                        inStruct = "union";
+                        result.fields = [];
+                    }
+                    else if (t) {
+                        result.dutKind = "alias";
+                        result.baseType = t;
+                    }
+                }
+                continue;
+            }
+        }
+        const sec = SECTION_RE.exec(plain);
+        if (sec) {
+            section = sec[1].toUpperCase();
+            flags = { constant: /\bCONSTANT\b/i.test(sec[2]), retain: /\bRETAIN\b/i.test(sec[2]), persistent: /\bPERSISTENT\b/i.test(sec[2]) };
+            continue;
+        }
+        if (/^END_VAR\b/i.test(plain)) {
+            section = undefined;
+            continue;
+        }
+        if (/^(STRUCT|UNION)\b/i.test(plain) && result.header.keyword === "TYPE") {
+            inStruct = /^STRUCT/i.test(plain) ? "struct" : "union";
+            result.dutKind ??= inStruct;
+            result.fields ??= [];
+            continue;
+        }
+        if (/^END_(STRUCT|UNION|TYPE)\b/i.test(plain)) {
+            inStruct = undefined;
+            continue;
+        }
+        if (inStruct) {
+            result.fields.push(...parseVar(body, "VAR", { constant: false, retain: false, persistent: false }, comment));
+            continue;
+        }
+        if (section)
+            result.vars.push(...parseVar(body, section, flags, comment));
+    }
+    return result;
+}
+/** One-line signature, e.g. `METHOD Reset(bHard : BOOL) : BOOL`. */
+export function signature(p, name) {
+    const h = p.header;
+    const ins = p.vars.filter((v) => v.section === "VAR_INPUT" || v.section === "VAR_IN_OUT").map((v) => `${v.section === "VAR_IN_OUT" ? "VAR_IN_OUT " : ""}${v.name} : ${v.type}`);
+    const outs = p.vars.filter((v) => v.section === "VAR_OUTPUT").map((v) => `${v.name} : ${v.type}`);
+    let s = `${name ?? h.name ?? "?"}(${ins.join(", ")}${outs.length ? `; out ${outs.join(", ")}` : ""})`;
+    if (h.returnType)
+        s += ` : ${h.returnType}`;
+    return s;
+}
+//# sourceMappingURL=decl.js.map

package/dist/codesys/decl.js.map

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

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":"AAAA,uFAAuF;AAGvF,+EAA+E;AAC/E,MAAM,UAAU,QAAQ,CAAC,CAAS,EAAE,CAAS;IAC3C,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,GAAG,SAAS;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAY,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAY,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjJ,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,MAAM,CAAC,GAAkB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrF,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;YAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC;IAC5J,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC;YACnC,CAAC,EAAE,CAAC;YACJ,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,GAAG,CAAC,CAAE;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAE,EAAE,CAAC,CAAC;;YAC3E,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,CAAC,GAAG,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAE,EAAE,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAE,EAAE,CAAC,CAAC;IACnD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAa,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAE9I,gGAAgG;AAChG,MAAM,UAAU,UAAU,CAAC,GAAa,EAAE,OAAO,GAAG,CAAC;IACnD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7B,IAAI,CAAC,CAAC,EAAE,KAAK,GAAG;YAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC5D,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACxB,IAAI,CAAC,CAAC,EAAE,KAAK,GAAG;YAAE,KAAK,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,EAAE;gBAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IACH,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IACd,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACxB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO;QACzB,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM;YAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9F,IAAI,GAAG,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}

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;