@codesys/mcp-toolkit 2.2.0 → 2.3.0

package/dist/codesys/graphical.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Ladder, FBD and SFC from a structured description, as PLCopenXML that
+ * CODESYS imports (the rules were learned live: a connection lists every
+ * source; SFC actions need relPosition before reference; every localId is
+ * unique; transition conditions are connected inVariables; step outputs use
+ * formalParameter "sfc"). The declaration is written as ST after the import.
+ */
+import * as z from "zod/v4";
+import type { ActionResult, RegisterAction } from "../actions.js";
+import type { AppContext } from "../tools.js";
+/** A boolean expression for ladder: a variable ("xStart", "NOT xStop") or and/or of others. */
+export type Logic = string | {
+    and: Logic[];
+} | {
+    or: Logic[];
+};
+/** An FBD expression: a variable or literal, a function block, or a function such as AND, ADD, GT. */
+export type Fbd = string | {
+    fn: string;
+    args: Fbd[];
+} | {
+    fb: string;
+    instance: string;
+    inputs?: Record<string, Fbd>;
+    output?: string;
+};
+export declare const ladderSchema: z.ZodObject<{
+    rungs: z.ZodArray<z.ZodObject<{
+        when: z.ZodType<Logic, unknown, z.core.$ZodTypeInternals<Logic, unknown>>;
+        then: z.ZodArray<z.ZodObject<{
+            coil: z.ZodString;
+            kind: z.ZodDefault<z.ZodEnum<{
+                coil: "coil";
+                negated: "negated";
+                reset: "reset";
+                set: "set";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const fbdSchema: z.ZodObject<{
+    networks: z.ZodArray<z.ZodObject<{
+        assign: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        to: z.ZodOptional<z.ZodString>;
+        expr: z.ZodType<Fbd, unknown, z.core.$ZodTypeInternals<Fbd, unknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const sfcSchema: z.ZodObject<{
+    steps: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        initial: z.ZodOptional<z.ZodBoolean>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            qualifier: z.ZodDefault<z.ZodEnum<{
+                N: "N";
+                P: "P";
+                P0: "P0";
+                P1: "P1";
+                R: "R";
+                S: "S";
+            }>>;
+            st: z.ZodString;
+        }, z.core.$strip>>>;
+        next: z.ZodString;
+        when: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare function ladderXml(name: string, pouType: "program" | "functionBlock", spec: z.infer<typeof ladderSchema>): string;
+export declare function fbdXml(name: string, pouType: "program" | "functionBlock", spec: z.infer<typeof fbdSchema>): string;
+export declare function sfcXml(name: string, pouType: "program" | "functionBlock", spec: z.infer<typeof sfcSchema>): string;
+/**
+ * The SFCs this generator makes are one sequence: each step goes to the next one
+ * listed, and the last step jumps back (to any step). Branches aren't supported yet.
+ */
+export declare function sfcProblems(spec: z.infer<typeof sfcSchema>): string[];
+export declare function registerGraphicalActions(reg: RegisterAction, ctx: AppContext, run: (fn: () => Promise<string>) => Promise<ActionResult>): void;

package/dist/codesys/graphical.js

@@ -0,0 +1,226 @@
+/**
+ * Ladder, FBD and SFC from a structured description, as PLCopenXML that
+ * CODESYS imports (the rules were learned live: a connection lists every
+ * source; SFC actions need relPosition before reference; every localId is
+ * unique; transition conditions are connected inVariables; step outputs use
+ * formalParameter "sfc"). The declaration is written as ST after the import.
+ */
+import * as z from "zod/v4";
+const logic = z.lazy(() => z.union([z.string().min(1), z.object({ and: z.array(logic).min(1) }), z.object({ or: z.array(logic).min(1) })]));
+const fbd = z.lazy(() => z.union([
+    z.string().min(1),
+    z.object({ fn: z.string().min(1), args: z.array(fbd).min(1) }),
+    z.object({ fb: z.string().min(1), instance: z.string().min(1), inputs: z.record(z.string(), fbd).optional(), output: z.string().optional() }),
+]));
+export const ladderSchema = z.object({
+    rungs: z
+        .array(z.object({
+        when: logic.describe("Contacts: 'xStart', 'NOT xStop', {and: [...]} in series, {or: [...]} in parallel"),
+        then: z.array(z.object({ coil: z.string(), kind: z.enum(["coil", "set", "reset", "negated"]).default("coil") })).min(1),
+    }))
+        .min(1),
+});
+export const fbdSchema = z.object({
+    networks: z
+        .array(z.object({
+        assign: z.record(z.string(), z.string()).optional().describe("For a function block: its outputs to variables, e.g. {Q: 'xLamp', ET: 'tElapsed'}"),
+        to: z.string().optional().describe("Variable the expression's result is written to"),
+        expr: fbd.describe("e.g. {fn: 'AND', args: ['xA', 'xB']} or {fb: 'TON', instance: 'tonDelay', inputs: {IN: 'xIn', PT: 'T#2S'}, output: 'Q'}"),
+    }))
+        .min(1),
+});
+export const sfcSchema = z.object({
+    steps: z
+        .array(z.object({
+        name: z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/),
+        initial: z.boolean().optional(),
+        actions: z.array(z.object({ name: z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/), qualifier: z.enum(["N", "S", "R", "P", "P0", "P1"]).default("N"), st: z.string() })).optional(),
+        next: z.string().describe("Step this one goes to"),
+        when: z.string().describe("Transition condition in ST, e.g. 'xStart AND NOT xFault'"),
+    }))
+        .min(2),
+});
+const esc = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+function wrap(name, pouType, body, actions = "", addData = "") {
+    return `<?xml version="1.0" encoding="utf-8"?>
+<project xmlns="http://www.plcopen.org/xml/tc6_0200">
+  <fileHeader companyName="codesys-mcp-toolkit" productName="codesys-mcp-toolkit" productVersion="2" creationDateTime="2026-01-01T00:00:00" />
+  <contentHeader name="${esc(name)}"><coordinateInfo><fbd><scaling x="1" y="1" /></fbd><ld><scaling x="1" y="1" /></ld><sfc><scaling x="1" y="1" /></sfc></coordinateInfo></contentHeader>
+  <types><dataTypes /><pous>
+    <pou name="${esc(name)}" pouType="${pouType}">
+      <interface />
+      ${actions}<body>${body}</body>${addData}
+    </pou>
+  </pous></types>
+  <instances><configurations /></instances>
+</project>`;
+}
+export function ladderXml(name, pouType, spec) {
+    let id = 0;
+    const parts = [];
+    spec.rungs.forEach((rung, n) => {
+        const y = n * 100;
+        const rail = ++id;
+        parts.push(`<leftPowerRail localId="${rail}"><position x="0" y="${y}" /><connectionPointOut formalParameter="none" /></leftPowerRail>`);
+        const build = (e, inputs) => {
+            if (typeof e === "string") {
+                const neg = /^\s*NOT\s+/i.test(e);
+                const v = e.replace(/^\s*NOT\s+/i, "").trim();
+                const c = ++id;
+                parts.push(`<contact localId="${c}" negated="${neg}"><position x="0" y="${y}" /><connectionPointIn>${inputs.map((i) => `<connection refLocalId="${i}" />`).join("")}</connectionPointIn><connectionPointOut /><variable>${esc(v)}</variable></contact>`);
+                return [c];
+            }
+            if ("and" in e)
+                return e.and.reduce((cur, x) => build(x, cur), inputs);
+            return e.or.flatMap((x) => build(x, inputs));
+        };
+        const outs = build(rung.when, [rail]);
+        const coils = rung.then.map((t) => {
+            const c = ++id;
+            const storage = t.kind === "set" ? ' storage="set"' : t.kind === "reset" ? ' storage="reset"' : "";
+            parts.push(`<coil localId="${c}" negated="${t.kind === "negated"}"${storage}><position x="0" y="${y}" /><connectionPointIn>${outs.map((i) => `<connection refLocalId="${i}" />`).join("")}</connectionPointIn><connectionPointOut /><variable>${esc(t.coil)}</variable></coil>`);
+            return c;
+        });
+        parts.push(`<rightPowerRail localId="${++id}"><position x="0" y="${y}" /><connectionPointIn>${coils.map((i) => `<connection refLocalId="${i}" />`).join("")}</connectionPointIn></rightPowerRail>`);
+    });
+    return wrap(name, pouType, `<LD>${parts.join("\n")}</LD>`);
+}
+export function fbdXml(name, pouType, spec) {
+    let id = 0;
+    const parts = [];
+    spec.networks.forEach((net, n) => {
+        const y = n * 200;
+        let x = 0;
+        /** Emits the expression; returns its output connection. */
+        const build = (e) => {
+            if (typeof e === "string") {
+                const v = ++id;
+                parts.push(`<inVariable localId="${v}"><position x="${x}" y="${y}" /><connectionPointOut /><expression>${esc(e)}</expression></inVariable>`);
+                return { id: v };
+            }
+            if ("fn" in e) {
+                const ins = e.args.map(build);
+                const b = ++id;
+                x += 100;
+                const fn = e.fn.toUpperCase();
+                parts.push(`<block localId="${b}" typeName="${esc(fn)}"><position x="${x}" y="${y}" /><inputVariables>${ins.map((i, k) => `<variable formalParameter="In${k + 1}"><connectionPointIn><connection refLocalId="${i.id}"${i.param ? ` formalParameter="${esc(i.param)}"` : ""} /></connectionPointIn></variable>`).join("")}</inputVariables><inOutVariables /><outputVariables><variable formalParameter="Out1"><connectionPointOut /></variable></outputVariables></block>`);
+                return { id: b, param: "Out1" };
+            }
+            const ins = Object.entries(e.inputs ?? {}).map(([k, v]) => [k, build(v)]);
+            const b = ++id;
+            x += 100;
+            const outs = [...new Set([e.output ?? "Q", ...Object.keys(net.assign ?? {})])];
+            parts.push(`<block localId="${b}" typeName="${esc(e.fb)}" instanceName="${esc(e.instance)}"><position x="${x}" y="${y}" /><inputVariables>${ins.map(([k, i]) => `<variable formalParameter="${esc(k)}"><connectionPointIn><connection refLocalId="${i.id}"${i.param ? ` formalParameter="${esc(i.param)}"` : ""} /></connectionPointIn></variable>`).join("")}</inputVariables><inOutVariables /><outputVariables>${outs.map((o) => `<variable formalParameter="${esc(o)}"><connectionPointOut /></variable>`).join("")}</outputVariables></block>`);
+            return { id: b, param: e.output ?? "Q" };
+        };
+        const out = build(net.expr);
+        const targets = [];
+        if (net.to)
+            targets.push([out.param, net.to]);
+        for (const [param, v] of Object.entries(net.assign ?? {}))
+            targets.push([param, v]);
+        for (const [param, v] of targets) {
+            x += 100;
+            parts.push(`<outVariable localId="${++id}"><position x="${x}" y="${y}" /><connectionPointIn><connection refLocalId="${out.id}"${param ? ` formalParameter="${esc(param)}"` : ""} /></connectionPointIn><expression>${esc(v)}</expression></outVariable>`);
+        }
+    });
+    return wrap(name, pouType, `<FBD>${parts.join("\n")}</FBD>`);
+}
+export function sfcXml(name, pouType, spec) {
+    const steps = spec.steps;
+    const names = new Set(steps.map((s) => s.name));
+    for (const s of steps)
+        if (!names.has(s.next))
+            throw new Error(`step ${s.name} goes to '${s.next}', which isn't a step`);
+    if (!steps.some((s) => s.initial))
+        steps[0].initial = true;
+    let id = 0;
+    const parts = [];
+    const actionDefs = [];
+    let y = 0;
+    let prev;
+    steps.forEach((s, k) => {
+        const st = ++id;
+        parts.push(`<step localId="${st}"${s.initial ? ' initialStep="true"' : ""} name="${esc(s.name)}"><position x="0" y="${y}" /><connectionPointIn>${prev ? `<connection refLocalId="${prev}" />` : ""}</connectionPointIn><connectionPointOut formalParameter="sfc" /></step>`);
+        if (s.actions?.length) {
+            const blk = ++id;
+            const acts = s.actions.map((a) => {
+                actionDefs.push(`<action name="${esc(a.name)}"><body><ST><xhtml xmlns="http://www.w3.org/1999/xhtml">${esc(a.st)}</xhtml></ST></body></action>`);
+                return `<action localId="${++id}" qualifier="${a.qualifier}"><relPosition x="0" y="0" /><reference name="${esc(a.name)}" /><connectionPointOut /></action>`;
+            });
+            parts.push(`<actionBlock localId="${blk}"><position x="150" y="${y}" /><connectionPointIn><connection refLocalId="${st}" /></connectionPointIn>${acts.join("")}</actionBlock>`);
+        }
+        y += 40;
+        const cond = ++id;
+        parts.push(`<inVariable localId="${cond}"><position x="0" y="${y}" /><connectionPointOut /><expression>${esc(s.when)}</expression></inVariable>`);
+        const tr = ++id;
+        parts.push(`<transition localId="${tr}"><position x="0" y="${y}" /><connectionPointIn><connection refLocalId="${st}" formalParameter="sfc" /></connectionPointIn><connectionPointOut /><condition><connectionPointIn><connection refLocalId="${cond}" /></connectionPointIn></condition></transition>`);
+        y += 40;
+        const following = steps[k + 1];
+        if (following && following.name === s.next)
+            prev = tr;
+        else {
+            parts.push(`<jumpStep localId="${++id}" targetName="${esc(s.next)}"><position x="0" y="${y}" /><connectionPointIn><connection refLocalId="${tr}" /></connectionPointIn></jumpStep>`);
+            y += 40;
+            prev = undefined;
+        }
+    });
+    const sfcSettings = `<addData><data name="http://www.3s-software.com/plcopenxml/sfcsettings" handleUnknown="implementation"><SFCSettings><LibTitle>IecSfc</LibTitle><LibCompany>System</LibCompany><LibVersion>4.4.0.0</LibVersion><LibNamespace>IecSfc</LibNamespace><CalcActiveTransOnly>false</CalcActiveTransOnly><UseDefaults>false</UseDefaults></SFCSettings></data></addData>`;
+    return wrap(name, pouType, `<SFC>${parts.join("\n")}</SFC>`, actionDefs.length ? `<actions>${actionDefs.join("")}</actions>\n      ` : "", sfcSettings);
+}
+/**
+ * The SFCs this generator makes are one sequence: each step goes to the next one
+ * listed, and the last step jumps back (to any step). Branches aren't supported yet.
+ */
+export function sfcProblems(spec) {
+    const out = [];
+    const names = new Set(spec.steps.map((s) => s.name));
+    if (names.size !== spec.steps.length)
+        out.push("step names must be unique");
+    spec.steps.forEach((s, k) => {
+        const following = spec.steps[k + 1];
+        if (!names.has(s.next))
+            out.push(`step ${s.name} goes to '${s.next}', which isn't a step`);
+        else if (following && s.next !== following.name)
+            out.push(`step ${s.name} must go to the next step listed (${following.name}); only the last step can jump back. Branches aren't supported yet: write the sequence in ST instead.`);
+    });
+    return out;
+}
+export function registerGraphicalActions(reg, ctx, run) {
+    reg("create_graphical", {
+        description: "Create a ladder (LD), function block diagram (FBD) or sequential function chart (SFC) program or function block from a structured description; CODESYS draws it. " +
+            "ladder: {rungs: [{when: 'xStart' | 'NOT xStop' | {and: [...]} (series) | {or: [...]} (parallel), then: [{coil: 'xMotor', kind: 'coil'|'set'|'reset'|'negated'}]}]}. " +
+            "fbd: {networks: [{expr: 'xA' | {fn: 'AND', args: [...]} | {fb: 'TON', instance: 'tonDelay', inputs: {IN: ..., PT: 'T#2S'}, output: 'Q'}, to: 'xOut', assign: {ET: 'tEt'}}]}. " +
+            "sfc: {steps: [{name, initial?, actions?: [{name, qualifier: 'N'|'S'|'R'|'P', st: 'ST code'}], next: 'NextStep', when: 'ST condition'}]}, one sequence: each step goes to the next listed, the last jumps back. " +
+            "declaration is the POU's ST declaration (PROGRAM or FUNCTION_BLOCK with its variables, FB instances included). Compile afterwards.",
+        inputSchema: z.object({
+            name: z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/),
+            declaration: z.string().describe("e.g. 'PROGRAM LD_Motor\nVAR\n    xStart, xStop, xMotor : BOOL;\nEND_VAR'"),
+            ladder: ladderSchema.optional(),
+            fbd: fbdSchema.optional(),
+            sfc: sfcSchema.optional(),
+            parent: z.string().optional().describe("Folder or object to create it under (default: the application)"),
+        }),
+    }, async (a) => run(async () => {
+        const kinds = [a.ladder && "ladder", a.fbd && "fbd", a.sfc && "sfc"].filter(Boolean);
+        if (kinds.length !== 1)
+            throw new Error("Give exactly one of ladder, fbd or sfc.");
+        const head = /^\s*(?:\{[^}]*\}\s*)*(PROGRAM|FUNCTION_BLOCK)\s+([A-Za-z_][A-Za-z0-9_]*)/i.exec(a.declaration);
+        if (!head)
+            throw new Error("The declaration must start with PROGRAM or FUNCTION_BLOCK and the name.");
+        if (head[2].toLowerCase() !== a.name.toLowerCase())
+            throw new Error(`The declaration names ${head[2]}, not ${a.name}.`);
+        const pouType = head[1].toUpperCase() === "PROGRAM" ? "program" : "functionBlock";
+        if (a.sfc) {
+            const p = sfcProblems(a.sfc);
+            if (p.length)
+                throw new Error(p.join("\n"));
+        }
+        const xml = a.ladder ? ladderXml(a.name, pouType, a.ladder) : a.fbd ? fbdXml(a.name, pouType, a.fbd) : sfcXml(a.name, pouType, a.sfc);
+        const r = await ctx.bridge.call("object.import_xml", { parent: a.parent, xml, save: false }, { timeoutMs: 120_000 });
+        const path = r.added[0];
+        await ctx.bridge.call("object.write", { path, declaration: a.declaration, save: ctx.autosave });
+        return `Created ${path} in ${kinds[0] === "ladder" ? "ladder (LD)" : kinds[0] === "fbd" ? "FBD" : "SFC"}${a.sfc ? ` with ${a.sfc.steps.length} steps` : ""}. Compile to check it, and call it from a task (configure_task) or another POU.`;
+    }));
+}
+//# sourceMappingURL=graphical.js.map

package/dist/codesys/graphical.js.map

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

package/dist/codesys/lang.d.ts

@@ -0,0 +1,39 @@
+import type { ActionResult, RegisterAction } from "../actions.js";
+import type { AppContext } from "../tools.js";
+interface Var {
+    name: string;
+    type: string;
+    section: "input" | "output" | "other";
+    comment?: string;
+    hidden?: boolean;
+    init?: string;
+}
+interface Sig {
+    name: string;
+    kind?: string;
+    library?: string;
+    comment?: string;
+    variables?: Var[];
+    members?: string[];
+    error?: string;
+}
+/** A library doc comment without its reStructuredText blocks (examples, ranges, images). */
+export declare function plainComment(c?: string): string;
+export declare function formatSignature(s: Sig): string;
+export declare function registerLangActions(reg: RegisterAction, ctx: AppContext, run: (fn: () => Promise<string>) => Promise<ActionResult>): void;
+/** "Line 3, Column 22 (Impl)" -> where the reference is. */
+export declare function parseLocation(loc: string): {
+    line: number;
+    col?: number;
+    part: "declaration" | "implementation";
+} | undefined;
+/** Replaces the identifier at (or after) each location; locations on one line go right to left. */
+export declare function renameAt(text: string, spots: {
+    line: number;
+    col?: number;
+}[], oldName: string, newName: string): {
+    text: string;
+    done: number;
+};
+export declare function registerRenameAction(reg: RegisterAction, ctx: AppContext, run: (fn: () => Promise<string>) => Promise<ActionResult>): void;
+export {};

package/dist/codesys/lang.js

@@ -0,0 +1,177 @@
+/**
+ * What CODESYS's compiler knows about names: the interface of any POU or type,
+ * including FBs in compiled libraries (TON, MC_MoveAbsolute, SysFileOpen...),
+ * and where a name is read, written or called. See watcher/mcp_lang.py.
+ */
+import * as z from "zod/v4";
+/** A library doc comment without its reStructuredText blocks (examples, ranges, images). */
+export function plainComment(c) {
+    return (c ?? "").split(/\s\.\.\s|^\.\.\s/)[0].trim();
+}
+export function formatSignature(s) {
+    if (s.error)
+        return `${s.name}: ${s.error}`;
+    const head = `${s.name} (${s.kind ?? "?"}${s.library ? `, ${s.library}` : ", this project"})${plainComment(s.comment) ? `: ${plainComment(s.comment)}` : ""}`;
+    const shown = (s.variables ?? []).filter((v) => !v.hidden);
+    const line = (v) => `  ${v.name} : ${v.type}${v.init ? ` := ${v.init}` : ""}${v.comment ? `  // ${v.comment}` : ""}`;
+    const parts = [head];
+    const ins = shown.filter((v) => v.section === "input");
+    const outs = shown.filter((v) => v.section === "output");
+    const other = shown.filter((v) => v.section === "other");
+    if (ins.length)
+        parts.push("VAR_INPUT", ...ins.map(line));
+    if (outs.length)
+        parts.push("VAR_OUTPUT", ...outs.map(line));
+    if (other.length)
+        parts.push("Other variables (in/out, locals)", ...other.map(line));
+    const hidden = (s.variables ?? []).filter((v) => v.hidden).map((v) => v.name);
+    if (hidden.length)
+        parts.push(`Hidden (internal): ${hidden.join(", ")}`);
+    if (s.members?.length)
+        parts.push(`Methods, properties and actions: ${s.members.join(", ")}`);
+    return parts.join("\n");
+}
+export function registerLangActions(reg, ctx, run) {
+    const b = ctx.bridge;
+    reg("get_signature", {
+        description: "The real interface of POUs and types as CODESYS's compiler sees them: inputs, outputs, other variables with types, initial values and doc comments, and methods/properties. Works for the project's own code and for FBs in any referenced library, compiled ones included (TON, CTU, R_TRIG, MC_MoveAbsolute, SysFileOpen...). Use it before calling a library FB instead of guessing its parameters. Builds the application first if the names aren't known yet.",
+        inputSchema: z.object({ names: z.array(z.string()).min(1).max(20).describe("POU or type names, e.g. ['TON', 'FB_Pump']") }),
+    }, async ({ names }) => run(async () => {
+        const r = await b.call("lang.signature", { names }, { timeoutMs: 300_000 });
+        return r.signatures.map(formatSignature).join("\n\n");
+    }));
+    reg("find_references", {
+        description: "Where a variable, POU or type is used in the application: each read, write and call with the POU, line and column, from CODESYS's cross-reference list. Builds first. Use it before renaming or changing an interface.",
+        inputSchema: z.object({
+            name: z.string().describe("e.g. 'xRunning', 'fbPump', 'FB_Pump'"),
+            kind: z.enum(["variable", "pou", "type"]).default("variable"),
+        }),
+    }, async ({ name, kind }) => run(async () => {
+        const r = await b.call("lang.xref", { name, kind }, { timeoutMs: 300_000 });
+        if (!r.references.length)
+            return `No references to ${name} (as a ${kind}).`;
+        return [`${r.references.length} reference${r.references.length === 1 ? "" : "s"} to ${name}:`, ...r.references.map((x) => `  ${x.access.padEnd(11)} ${x.pou}  ${x.location}  ${x.text}`)].join("\n");
+    }));
+}
+/** "Line 3, Column 22 (Impl)" -> where the reference is. */
+export function parseLocation(loc) {
+    const m = /Line\s+(\d+)(?:,\s*Column\s+(\d+))?\s*\((Decl|Impl)\)/i.exec(loc);
+    if (!m)
+        return undefined;
+    return { line: Number(m[1]), ...(m[2] ? { col: Number(m[2]) } : {}), part: /^decl/i.test(m[3]) ? "declaration" : "implementation" };
+}
+const word = (name) => new RegExp(`(?<![A-Za-z0-9_])${name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(?![A-Za-z0-9_])`, "gi");
+/** Replaces the identifier at (or after) each location; locations on one line go right to left. */
+export function renameAt(text, spots, oldName, newName) {
+    const eol = text.includes("\r\n") ? "\r\n" : "\n";
+    const lines = text.split(/\r?\n/);
+    let done = 0;
+    const sorted = [...spots].sort((a, b) => b.line - a.line || (b.col ?? 0) - (a.col ?? 0));
+    const seen = new Set();
+    for (const s of sorted) {
+        const key = `${s.line}:${s.col ?? 0}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const l = lines[s.line - 1];
+        if (l === undefined)
+            continue;
+        const re = word(oldName);
+        re.lastIndex = Math.max(0, (s.col ?? 1) - 1);
+        const m = re.exec(l);
+        if (!m)
+            continue;
+        lines[s.line - 1] = l.slice(0, m.index) + newName + l.slice(m.index + m[0].length);
+        done++;
+    }
+    return { text: lines.join(eol), done };
+}
+export function registerRenameAction(reg, ctx, run) {
+    reg("rename_symbol", {
+        description: "Rename a variable or a POU everywhere it is used, from CODESYS's cross-references: the declaration, every read, write and call, and instance declarations of a renamed FB. kind 'variable': name is the variable, owner the POU or GVL that declares it (refused when several objects declare the same name). kind 'pou': owner is the POU to rename. Compile afterwards. Graphical bodies that need changes are reported, not changed.",
+        inputSchema: z.object({
+            kind: z.enum(["variable", "pou"]),
+            owner: z.string().describe("POU or GVL that declares the variable, or the POU to rename, e.g. 'FB_Pump'"),
+            name: z.string().optional().describe("The variable's current name (kind 'variable')"),
+            newName: z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/),
+        }),
+    }, async ({ kind, owner, name, newName }) => run(async () => {
+        if (kind === "variable" && !name)
+            throw new Error("Give the variable's name.");
+        const b = ctx.bridge;
+        const oldName = kind === "pou" ? owner.split("/").pop() : name;
+        const r = await b.call("lang.xref", { name: oldName, kind: kind === "pou" ? "pou" : "variable" }, { timeoutMs: 300_000 });
+        let refs = r.references;
+        if (kind === "variable") {
+            const decls = refs.filter((x) => /^declaration$/i.test(x.access));
+            const owners = [...new Set(decls.map((x) => x.pou.toLowerCase()))];
+            if (owners.length > 1)
+                throw new Error(`Several objects declare ${oldName} (${owners.join(", ")}); renaming would be ambiguous. Rename it in ${owner} by hand with write_object, or rename the others first.`);
+            if (owners.length === 1 && owners[0] !== owner.split("/").pop().toLowerCase())
+                throw new Error(`${oldName} is declared in ${decls[0].pou}, not in ${owner}.`);
+        }
+        else {
+            // Only the type name's own uses: declarations of instances (Type) and calls of functions or programs.
+            refs = refs.filter((x) => x.text.toLowerCase().startsWith(oldName.toLowerCase()));
+        }
+        const byObj = new Map();
+        for (const x of refs) {
+            const loc = parseLocation(x.location);
+            if (!loc)
+                continue;
+            const path = x.pou.replace(/\./g, "/");
+            const e = byObj.get(path) ?? { declaration: [], implementation: [] };
+            e[loc.part].push({ line: loc.line, ...(loc.col ? { col: loc.col } : {}) });
+            byObj.set(path, e);
+        }
+        if (kind === "pou") {
+            const e = byObj.get(owner) ?? { declaration: [], implementation: [] };
+            e.declaration.push({ line: 1 });
+            byObj.set(owner, e);
+        }
+        if (!byObj.size)
+            return `Nothing to rename: ${oldName} isn't used.`;
+        const objs = (await b.call("objects.read", { paths: [...byObj.keys()] })).objects;
+        const changed = [];
+        const skipped = [];
+        let count = 0;
+        for (const o of objs) {
+            const spots = byObj.get(o.path) ?? byObj.get([...byObj.keys()].find((k) => k.toLowerCase() === o.path.toLowerCase()) ?? "");
+            if (!spots || o.error) {
+                skipped.push(`${o.path}${o.error ? ` (${o.error})` : ""}`);
+                continue;
+            }
+            const args = { path: o.path };
+            if (spots.declaration.length && o.declaration !== undefined) {
+                const d = renameAt(o.declaration, spots.declaration, oldName, newName);
+                if (d.done)
+                    (args.declaration = d.text), (count += d.done);
+            }
+            if (spots.implementation.length) {
+                if (o.implementation === undefined) {
+                    skipped.push(`${o.path} (graphical body)`);
+                }
+                else {
+                    const im = renameAt(o.implementation, spots.implementation, oldName, newName);
+                    if (im.done)
+                        (args.implementation = im.text), (count += im.done);
+                }
+            }
+            if (args.declaration || args.implementation) {
+                await b.call("object.write", { ...args, save: false });
+                changed.push(o.path);
+            }
+        }
+        if (kind === "pou")
+            await b.call("object.rename", { path: owner, new_name: newName, save: false });
+        await b.call("project.save", {}).catch(() => undefined);
+        return [
+            `Renamed ${kind === "pou" ? owner : `${owner}.${oldName}`} to ${newName}: ${count} occurrence(s) in ${changed.length} object(s) (${changed.join(", ")}).`,
+            skipped.length ? `Not changed (do these by hand): ${skipped.join(", ")}.` : "",
+            "Compile to check.",
+        ]
+            .filter(Boolean)
+            .join("\n");
+    }));
+}
+//# sourceMappingURL=lang.js.map

package/dist/codesys/lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lang.js","sourceRoot":"","sources":["../../src/codesys/lang.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAsB5B,4FAA4F;AAC5F,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAM;IACpC,IAAI,CAAC,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,gBAAgB,IAAI,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC9J,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,CAAC,CAAM,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC1H,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC;IACrB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IACzD,IAAI,GAAG,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,IAAI,IAAI,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,kCAAkC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACrF,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9E,IAAI,MAAM,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9F,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAmB,EAAE,GAAe,EAAE,GAAyD;IACjI,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;IACrB,GAAG,CACD,eAAe,EACf;QACE,WAAW,EACT,ocAAoc;QACtc,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC,EAAE,CAAC;KAC5H,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAClB,GAAG,CAAC,KAAK,IAAI,EAAE;QACb,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAwB,gBAAgB,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QACnG,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxD,CAAC,CAAC,CACL,CAAC;IACF,GAAG,CACD,iBAAiB,EACjB;QACE,WAAW,EAAE,wNAAwN;QACrO,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YACjE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;SAC9D,CAAC;KACH,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CACvB,GAAG,CAAC,KAAK,IAAI,EAAE;QACb,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAoF,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/J,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM;YAAE,OAAO,oBAAoB,IAAI,UAAU,IAAI,IAAI,CAAC;QAC5E,OAAO,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,aAAa,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvM,CAAC,CAAC,CACL,CAAC;AACJ,CAAC;AASD,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,CAAC,GAAG,wDAAwD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7E,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC;AACvI,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,oBAAoB,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;AAEnI,mGAAmG;AACnG,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,KAAuC,EAAE,OAAe,EAAE,OAAe;IAC9G,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,SAAS;YAAE,SAAS;QAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,EAAE,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACnF,IAAI,EAAE,CAAC;IACT,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAmB,EAAE,GAAe,EAAE,GAAyD;IAClI,GAAG,CACD,eAAe,EACf;QACE,WAAW,EACT,yaAAya;QAC3a,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6EAA6E,CAAC;YACzG,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;YACrF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,0BAA0B,CAAC;SACtD,CAAC;KACH,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CACvC,GAAG,CAAC,KAAK,IAAI,EAAE;QACb,IAAI,IAAI,KAAK,UAAU,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/E,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;QACrB,MAAM,OAAO,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC,CAAC,CAAC,IAAK,CAAC;QACjE,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAwB,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QACjJ,IAAI,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC;QACxB,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;YACnE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,gDAAgD,KAAK,yDAAyD,CAAC,CAAC;YAC/M,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC,WAAW,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,mBAAmB,KAAK,CAAC,CAAC,CAAE,CAAC,GAAG,YAAY,KAAK,GAAG,CAAC,CAAC;QAClK,CAAC;aAAM,CAAC;YACN,sGAAsG;YACtG,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA+G,CAAC;QACrI,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACvC,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;YACrE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC3E,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;YACtE,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAChC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,OAAO,sBAAsB,OAAO,cAAc,CAAC;QACpE,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAiG,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAClL,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5H,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBACtB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3D,SAAS;YACX,CAAC;YACD,MAAM,IAAI,GAA2B,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACtD,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC5D,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;gBACvE,IAAI,CAAC,CAAC,IAAI;oBAAE,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7D,CAAC;YACD,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;gBAChC,IAAI,CAAC,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;oBACnC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,mBAAmB,CAAC,CAAC;gBAC7C,CAAC;qBAAM,CAAC;oBACN,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;oBAC9E,IAAI,EAAE,CAAC,IAAI;wBAAE,CAAC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;gBACnE,CAAC;YACH,CAAC;YACD,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC5C,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QACD,IAAI,IAAI,KAAK,KAAK;YAAE,MAAM,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACnG,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACxD,OAAO;YACL,WAAW,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,OAAO,EAAE,OAAO,OAAO,KAAK,KAAK,qBAAqB,OAAO,CAAC,MAAM,eAAe,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACzJ,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,mCAAmC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAC9E,mBAAmB;SACpB;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}

package/dist/codesys/simtest.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Unit tests in CODESYS's simulation: test cases of steps (write or force
+ * inputs, run cycles or wait, check values), run in order, reported as a table.
+ */
+import * as z from "zod/v4";
+import type { ActionResult, RegisterAction } from "../actions.js";
+import type { AppContext } from "../tools.js";
+declare const expectation: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    op: z.ZodEnum<{
+        "<": "<";
+        "<=": "<=";
+        "<>": "<>";
+        "=": "=";
+        ">": ">";
+        ">=": ">=";
+    }>;
+    value: z.ZodNumber;
+    tolerance: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>]>;
+export declare const testSchema: z.ZodObject<{
+    cases: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        steps: z.ZodArray<z.ZodObject<{
+            write: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            force: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            unforce: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            cycles: z.ZodOptional<z.ZodNumber>;
+            waitMs: z.ZodOptional<z.ZodNumber>;
+            expect: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                op: z.ZodEnum<{
+                    "<": "<";
+                    "<=": "<=";
+                    "<>": "<>";
+                    "=": "=";
+                    ">": ">";
+                    ">=": ">=";
+                }>;
+                value: z.ZodNumber;
+                tolerance: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>]>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type Expectation = z.infer<typeof expectation>;
+/** Whether a read value meets an expectation; booleans and numbers compare by value. */
+export declare function check(raw: string | undefined, exp: Expectation): boolean;
+export declare function registerSimTestAction(reg: RegisterAction, ctx: AppContext, run: (fn: () => Promise<string>) => Promise<ActionResult>): void;
+export {};