@winccoa-tools-pack/npm-winccoa-ctrl-code-style 0.1.0

package/dist/esm/style-check.js

@@ -0,0 +1,110 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASTYLE_SCRIPT = void 0;
+exports.buildCtrlArgs = buildCtrlArgs;
+exports.runStyleCheck = runStyleCheck;
+exports.checkStyle = checkStyle;
+exports.formatStyle = formatStyle;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const CtrlComponent_1 = require("@winccoa-tools-pack/npm-winccoa-core/types/components/implementations/CtrlComponent");
+const paths_1 = require("./paths");
+const register_1 = require("./register");
+const DEFAULT_TIMEOUT = 120000;
+/** Script name relative to StyleCheck scripts/ (OA proj_path resolution). */
+exports.ASTYLE_SCRIPT = 'astyle.ctl';
+/**
+ * Build WCCOActrl argv for astyle.ctl against the worker project config.
+ *
+ *   WCCOActrl -config <worker>/config/config -n -log +stderr astyle.ctl <source> [TRUE]
+ *
+ * Script is always the bare name `astyle.ctl` (resolved via StyleCheck on
+ * proj_path). Worker project is runnable; logs stay on the worker.
+ */
+function buildCtrlArgs(options) {
+    const args = [
+        '-config',
+        options.configPath,
+        '-n',
+        '-log',
+        '+stderr',
+        options.scriptName ?? exports.ASTYLE_SCRIPT,
+        options.sourcePath,
+    ];
+    if (options.applyChanges) {
+        args.push('TRUE');
+    }
+    return args;
+}
+/**
+ * Run CTL style check or format via worker project + StyleCheck sub-project.
+ */
+async function runStyleCheck(options) {
+    const version = (0, register_1.resolveWinCCOAVersion)(options.version);
+    const projectPath = node_path_1.default.resolve(options.projectPath);
+    const sourcePath = node_path_1.default.resolve(options.sourcePath ?? projectPath);
+    const applyChanges = options.applyChanges === true;
+    const styleCheckPath = node_path_1.default.resolve(options.styleCheckProjectPath ?? (0, paths_1.getDefaultStyleCheckProjectPath)());
+    // Existence check only — CTRL receives bare script name, not this path.
+    const bundledScriptPath = (0, paths_1.getAstyleScriptPath)(styleCheckPath);
+    const timeout = options.timeout ?? DEFAULT_TIMEOUT;
+    const registerProject = options.registerProject !== false;
+    if (!node_fs_1.default.existsSync(projectPath)) {
+        throw new Error(`projectPath does not exist: ${projectPath}`);
+    }
+    if (!node_fs_1.default.existsSync(sourcePath)) {
+        throw new Error(`sourcePath does not exist: ${sourcePath}`);
+    }
+    if (!node_fs_1.default.existsSync(bundledScriptPath)) {
+        throw new Error(`astyle.ctl not found: ${bundledScriptPath}`);
+    }
+    let configPath = node_path_1.default.join(projectPath, 'config', 'config');
+    if (registerProject) {
+        const registered = await (0, register_1.registerWorkerProjectWithStyleCheck)({
+            projectPath,
+            version,
+            langs: options.langs,
+            styleCheckProjectPath: styleCheckPath,
+            forceRewriteConfig: true,
+        });
+        configPath = registered.configPath;
+    }
+    if (!node_fs_1.default.existsSync(configPath)) {
+        throw new Error(`Worker project config not found: ${configPath}. Register first ` +
+            `(registerProject or scripts/register-stylecheck-projects.sh).`);
+    }
+    const ctrl = new CtrlComponent_1.CtrlComponent();
+    ctrl.setVersion(version);
+    const args = buildCtrlArgs({
+        configPath,
+        sourcePath,
+        applyChanges,
+    });
+    const exitCode = await ctrl.start(args, { timeout });
+    return {
+        success: exitCode === 0,
+        exitCode,
+        stdout: ctrl.stdOut ?? '',
+        stderr: ctrl.stdErr ?? '',
+        projectPath,
+        sourcePath,
+        configPath,
+        applyChanges,
+    };
+}
+/**
+ * Dry-run style check (no file changes).
+ */
+async function checkStyle(options) {
+    return runStyleCheck({ ...options, applyChanges: false });
+}
+/**
+ * Format CTL sources in place.
+ */
+async function formatStyle(options) {
+    return runStyleCheck({ ...options, applyChanges: true });
+}
+//# sourceMappingURL=style-check.js.map

package/dist/esm/style-check.js.map

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

package/dist/esm/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @winccoa-tools-pack/npm-winccoa-ctrl-code-style
+ *
+ * Check and format WinCC OA CTL sources via WCCOActrl + astyle.ctl.
+ * Worker project is runnable; StyleCheck is a non-runnable sub-project.
+ */
+export type { StyleCheckOptions, StyleCheckResult } from './types';
+export type { RegisterProjectsOptions, RegisterProjectsResult } from './register';
+export { runStyleCheck, checkStyle, formatStyle, buildCtrlArgs, ASTYLE_SCRIPT, } from './style-check';
+export { getPackageRoot, getDefaultStyleCheckProjectPath, getAstyleScriptPath } from './paths';
+export { registerStyleCheckSubProject, registerWorkerProjectWithStyleCheck, resolveWinCCOAVersion, spawnRegisterProjectCli, } from './register';
+export { parseArgs, printUsage, main } from './cli';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACnE,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EACH,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,EACb,aAAa,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,+BAA+B,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC/F,OAAO,EACH,4BAA4B,EAC5B,mCAAmC,EACnC,qBAAqB,EACrB,uBAAuB,GAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Resolve the package root that contains `winccoa/StyleCheck`.
+ * Works from source (`src/`) and built layouts (`dist/cjs`, `dist/esm`).
+ */
+export declare function getPackageRoot(startDir?: string): string;
+/**
+ * Absolute path to the bundled StyleCheck WinCC OA subproject.
+ */
+export declare function getDefaultStyleCheckProjectPath(): string;
+/**
+ * Absolute path to astyle.ctl inside the StyleCheck project.
+ * Used to verify the bundled script exists. WCCOActrl must receive the bare
+ * name `astyle.ctl` (relative to scripts/), not this full path.
+ */
+export declare function getAstyleScriptPath(projectPath?: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAqBxD;AAED;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhE"}

package/dist/register.d.ts

@@ -0,0 +1,49 @@
+export interface RegisterProjectsOptions {
+    /** Runnable worker / source project (e.g. Squirt). */
+    projectPath: string;
+    /** WinCC OA version, e.g. 3.21. */
+    version: string;
+    /** Languages for the runnable worker project. */
+    langs?: string[];
+    /** StyleCheck sub-project path (default: package winccoa/StyleCheck). */
+    styleCheckProjectPath?: string;
+    /**
+     * When true, always rewrite worker config so StyleCheck is listed as
+     * sub-project before the main proj_path (even if config already exists).
+     * @default true
+     */
+    forceRewriteConfig?: boolean;
+}
+export interface RegisterProjectsResult {
+    styleCheckPath: string;
+    projectPath: string;
+    configPath: string;
+}
+/**
+ * Resolve a WinCC OA version: explicit, or the single installed version.
+ */
+export declare function resolveWinCCOAVersion(explicit?: string): string;
+/**
+ * Register StyleCheck as a non-runnable WinCC OA project.
+ */
+export declare function registerStyleCheckSubProject(styleCheckPath: string, version: string): Promise<string>;
+/**
+ * Write / refresh worker project config with StyleCheck as sub-project, then
+ * register the worker as runnable.
+ *
+ * Config shape (matches npm-winccoa-register-project --sub-project):
+ *   [general]
+ *   pvss_path = "..."
+ *   proj_path = "<StyleCheck>"
+ *   proj_path = "<worker>"
+ *   proj_version = "..."
+ *   langs = "..."
+ */
+export declare function registerWorkerProjectWithStyleCheck(options: RegisterProjectsOptions): Promise<RegisterProjectsResult>;
+/**
+ * Spawn npm-winccoa-register-project CLI (for shells / debugging).
+ * Prefer registerWorkerProjectWithStyleCheck() in-process for reliability
+ * (register-project skips config rewrite when config already exists).
+ */
+export declare function spawnRegisterProjectCli(args: string[]): void;
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,uBAAuB;IACpC,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,yEAAyE;IACzE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAiB/D;AAkBD;;GAEG;AACH,wBAAsB,4BAA4B,CAC9C,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mCAAmC,CACrD,OAAO,EAAE,uBAAuB,GACjC,OAAO,CAAC,sBAAsB,CAAC,CAgEjC;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA8C5D"}

package/dist/style-check.d.ts

@@ -0,0 +1,31 @@
+import type { StyleCheckOptions, StyleCheckResult } from './types';
+/** Script name relative to StyleCheck scripts/ (OA proj_path resolution). */
+export declare const ASTYLE_SCRIPT = "astyle.ctl";
+/**
+ * Build WCCOActrl argv for astyle.ctl against the worker project config.
+ *
+ *   WCCOActrl -config <worker>/config/config -n -log +stderr astyle.ctl <source> [TRUE]
+ *
+ * Script is always the bare name `astyle.ctl` (resolved via StyleCheck on
+ * proj_path). Worker project is runnable; logs stay on the worker.
+ */
+export declare function buildCtrlArgs(options: {
+    configPath: string;
+    sourcePath: string;
+    applyChanges: boolean;
+    /** @default ASTYLE_SCRIPT (`astyle.ctl`) */
+    scriptName?: string;
+}): string[];
+/**
+ * Run CTL style check or format via worker project + StyleCheck sub-project.
+ */
+export declare function runStyleCheck(options: StyleCheckOptions): Promise<StyleCheckResult>;
+/**
+ * Dry-run style check (no file changes).
+ */
+export declare function checkStyle(options: Omit<StyleCheckOptions, 'applyChanges'>): Promise<StyleCheckResult>;
+/**
+ * Format CTL sources in place.
+ */
+export declare function formatStyle(options: Omit<StyleCheckOptions, 'applyChanges'>): Promise<StyleCheckResult>;
+//# sourceMappingURL=style-check.d.ts.map

package/dist/style-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-check.d.ts","sourceRoot":"","sources":["../src/style-check.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAMnE,6EAA6E;AAC7E,eAAO,MAAM,aAAa,eAAe,CAAC;AAE1C;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,EAAE,CAgBX;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgEzF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC5B,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,cAAc,CAAC,GACjD,OAAO,CAAC,gBAAgB,CAAC,CAE3B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC7B,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,cAAc,CAAC,GACjD,OAAO,CAAC,gBAAgB,CAAC,CAE3B"}

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Options for CTL style check / format via WCCOActrl + astyle.ctl.
+ *
+ * Worker project is the runnable source project (e.g. Squirt). StyleCheck is
+ * registered as a non-runnable sub-project so scripts resolve from there while
+ * logs and artifacts stay on the worker project.
+ */
+export interface StyleCheckOptions {
+    /**
+     * Absolute or relative path to the runnable WinCC OA source project
+     * (the worker project, e.g. `src/Squirt`).
+     */
+    projectPath: string;
+    /**
+     * WinCC OA version (e.g. `3.21`).
+     */
+    version: string;
+    /**
+     * Directory to scan for `*.ctl` files.
+     * Defaults to `projectPath` when omitted.
+     */
+    sourcePath?: string;
+    /**
+     * When true, format files in place. When false (default), dry-run only.
+     * @default false
+     */
+    applyChanges?: boolean;
+    /**
+     * Languages for runnable project registration.
+     * @default ['en_US.utf8']
+     */
+    langs?: string[];
+    /**
+     * Path or registered id of the StyleCheck sub-project.
+     * Defaults to the `winccoa/StyleCheck` directory shipped with this package.
+     */
+    styleCheckProjectPath?: string;
+    /**
+     * When true, register StyleCheck (non-runnable) and the worker project
+     * (runnable, with StyleCheck as --sub-project) before running.
+     * @default true
+     */
+    registerProject?: boolean;
+    /**
+     * Timeout in milliseconds for the WCCOActrl process.
+     * @default 120000
+     */
+    timeout?: number;
+}
+/**
+ * Result of a style check / format run.
+ */
+export interface StyleCheckResult {
+    /** True when exit code is 0. */
+    success: boolean;
+    /** WCCOActrl / astyle exit code. */
+    exitCode: number;
+    /** Captured stdout. */
+    stdout: string;
+    /** Captured stderr (includes WinCC OA throwError log lines). */
+    stderr: string;
+    /** Absolute worker project path. */
+    projectPath: string;
+    /** Absolute source path that was checked. */
+    sourcePath: string;
+    /** Absolute path to the worker project config file used with -config. */
+    configPath: string;
+    /** Whether formatting was applied. */
+    applyChanges: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IAEjB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IAEjB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IAEf,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IAEf,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IAEpB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IAEnB,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IAEnB,sCAAsC;IACtC,YAAY,EAAE,OAAO,CAAC;CACzB"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@winccoa-tools-pack/npm-winccoa-ctrl-code-style",
+  "version": "0.1.0",
+  "description": "CLI and API to check/format WinCC OA CTL sources via WCCOActrl and astyle.ctl",
+  "author": "winccoa-tools-pack",
+  "license": "MIT",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "winccoa-ctrl-style": "./dist/cjs/cli.js"
+  },
+  "files": [
+    "dist",
+    "winccoa",
+    "scripts"
+  ],
+  "scripts": {
+    "build:types": "tsc -p tsconfig.build.types.json",
+    "build:cjs": "tsc -p tsconfig.build.cjs.json",
+    "build:esm": "tsc -p tsconfig.build.esm.json && node scripts/fix-esm-imports.mjs",
+    "build": "npm run build:types && npm run build:cjs && npm run build:esm",
+    "compile": "tsc --build",
+    "prepublishOnly": "npm run build",
+    "lint": "eslint \"src/**/*.ts\"",
+    "lint:fix": "eslint \"src/**/*.ts\" --fix",
+    "lint:md": "markdownlint \"**/*.md\" --ignore node_modules",
+    "lint:md:fix": "markdownlint \"**/*.md\" --ignore node_modules --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "style-check": "npm run lint && npm run format:check && npm run lint:md",
+    "style-fix": "npm run lint:fix && npm run format && npm run lint:md:fix",
+    "test": "npm run style-check && npm run build && npm run test:unit",
+    "test:unit": "node --import tsx scripts/run-node-tests.ts test/unit",
+    "test:integration": "node --import tsx scripts/run-node-tests.ts test/integration",
+    "ci:integration": "npm ci && npm run build && npm run test:integration",
+    "register:projects": "node dist/cjs/cli.js register"
+  },
+  "dependencies": {
+    "@winccoa-tools-pack/npm-winccoa-core": "^2.0.8",
+    "@winccoa-tools-pack/npm-winccoa-register-project": "^1.1.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.5",
+    "@types/node": "^26.4.0",
+    "eslint": "^9.39.5",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "^2.32.0",
+    "globals": "^17.12.0",
+    "markdownlint": "^0.41.1",
+    "markdownlint-cli": "^0.49.1",
+    "prettier": "^3.9.6",
+    "ts-node": "^10.9.1",
+    "tsx": "^4.23.13",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.68.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/scripts/approve-open-pr-workflows.sh

@@ -0,0 +1,85 @@
+#!/usr/bin/env bash
+# Approve waiting workflow runs for open PRs using only the `gh` CLI.
+# Usage: ./scripts/approve-open-pr-workflows.sh [owner/repo]
+# Requires: gh CLI authenticated (or set GH_TOKEN). Does NOT require `jq`.
+
+set -euo pipefail
+REPO=${1:-}
+if [ -z "$REPO" ]; then
+  REPO=$(gh repo view --json nameWithOwner -q .nameWithOwner 2>/dev/null || true)
+  if [ -z "$REPO" ]; then
+    echo "Repository not specified and could not detect from gh. Use: $0 owner/repo" >&2
+    exit 2
+  fi
+fi
+
+echo "Using repo: $REPO"
+
+# Optional env flags
+DEPENDABOT_ONLY=${DEPENDABOT_ONLY:-true}
+# Comma-separated workflow names to include (empty = any)
+WORKFLOWS=${WORKFLOWS:-}
+
+TMPDIR=$(mktemp -d)
+trap 'rm -rf "$TMPDIR"' EXIT
+
+echo "Fetching open PR numbers..."
+PR_NUMBERS=$(gh api repos/$REPO/pulls --jq '.[].number' 2>/dev/null || true)
+if [ -z "$PR_NUMBERS" ]; then
+  echo "No open PRs found or 'gh' failed to list PRs." >&2
+  exit 0
+fi
+
+APPROVED=0
+
+# Iterate PR numbers and fetch head shas per-PR using gh --jq (no external jq required)
+while read -r PR_NUMBER; do
+  [ -z "$PR_NUMBER" ] && continue
+  PR_HEAD_SHA=$(gh api repos/$REPO/pulls/$PR_NUMBER --jq '.head.sha' 2>/dev/null || true)
+  if [ -z "$PR_HEAD_SHA" ]; then
+    echo "Could not get head SHA for PR #$PR_NUMBER, skipping." >&2
+    continue
+  fi
+
+  # Query workflow runs for this head_sha and only output matching runs as tab-separated lines: id\tname\tactor
+  runs_output=$(gh api "repos/$REPO/actions/runs?event=pull_request&per_page=100&head_sha=$PR_HEAD_SHA" --jq '.workflow_runs[] | select(.status=="waiting" or .status=="requested") | "\(.id)\t\(.name)\t\(.actor.login // "")"' 2>/dev/null || true)
+  if [ -z "$runs_output" ]; then
+    continue
+  fi
+
+  # Process each matching run line
+  echo "$runs_output" | while IFS=$'\t' read -r RUN_ID RUN_NAME ACTOR; do
+    if [ -z "$RUN_ID" ]; then
+      continue
+    fi
+
+    if [ "${DEPENDABOT_ONLY}" = "true" ]; then
+      ACTOR_LOWER=$(echo "$ACTOR" | tr '[:upper:]' '[:lower:]')
+      case "$ACTOR_LOWER" in
+        dependabot* ) ;;
+        * ) echo "SKIP run $RUN_ID for PR #$PR_NUMBER (actor $ACTOR)"; continue ;;
+      esac
+    fi
+
+    if [ -n "$WORKFLOWS" ]; then
+      IFS="," read -ra WF <<< "$WORKFLOWS"
+      keep=false
+      for w in "${WF[@]}"; do
+        if [ "$w" = "$RUN_NAME" ]; then keep=true; break; fi
+      done
+      if [ "$keep" = false ]; then
+        echo "SKIP run $RUN_ID for PR #$PR_NUMBER (workflow $RUN_NAME not in filter)"
+        continue
+      fi
+    fi
+
+    echo "Approving run $RUN_ID for PR #$PR_NUMBER (workflow: $RUN_NAME)"
+    gh api -X POST repos/$REPO/actions/runs/$RUN_ID/approve || echo "approve failed for $RUN_ID"
+    APPROVED=$((APPROVED+1))
+  done
+
+done <<< "$PR_NUMBERS"
+
+echo "Total approved runs: $APPROVED"
+
+exit 0

package/scripts/check-changelog-version.mjs

@@ -0,0 +1,37 @@
+/* eslint-env node */
+/* global console, process */
+import fs from 'node:fs';
+import path from 'node:path';
+
+const repoRoot = path.resolve(process.cwd());
+const packageJsonPath = path.join(repoRoot, 'package.json');
+const changelogPath = path.join(repoRoot, 'CHANGELOG.md');
+
+if (!fs.existsSync(packageJsonPath)) {
+  console.error(`::error::Missing package.json at ${packageJsonPath}`);
+  process.exit(1);
+}
+
+if (!fs.existsSync(changelogPath)) {
+  console.error(`::error::Missing CHANGELOG.md at ${changelogPath}`);
+  process.exit(1);
+}
+
+const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+const version = String(pkg.version || '').trim();
+
+if (!version) {
+  console.error('::error::package.json does not contain a valid "version" field');
+  process.exit(1);
+}
+
+const changelog = fs.readFileSync(changelogPath, 'utf8');
+const expectedHeadingPrefix = `## [${version}] - `;
+
+if (!changelog.includes(expectedHeadingPrefix)) {
+  console.error('::error::Release notes missing in CHANGELOG.md');
+  console.error(`Expected CHANGELOG.md to contain a heading like: ${expectedHeadingPrefix}YYYY-MM-DD`);
+  process.exit(1);
+}
+
+console.log(`✅ CHANGELOG.md contains release heading for v${version}`);

package/scripts/fix-esm-imports.mjs

@@ -0,0 +1,115 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const projectRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const esmDir = path.join(projectRoot, 'dist', 'esm');
+
+const EXTENSIONS = new Set(['.js', '.json', '.node']);
+
+function withJsExtension(specifier) {
+  if (!specifier.startsWith('.')) return specifier;
+
+  // Split off query/hash if ever present.
+  const match = /^(.*?)([?#].*)?$/.exec(specifier);
+  const base = match?.[1] ?? specifier;
+  const suffix = match?.[2] ?? '';
+
+  if (base.endsWith('/')) return specifier;
+
+  const ext = path.posix.extname(base);
+  if (EXTENSIONS.has(ext)) return specifier;
+
+  return `${base}.js${suffix}`;
+}
+
+function rewriteFile(contents) {
+  let changed = false;
+
+  // Rewrite: export * from '...'
+  contents = contents.replace(
+    /(\bexport\s+\*\s+from\s+)(['"])([^'"]+)(\2)/g,
+    (full, prefix, quote, spec, suffixQuote) => {
+      const next = withJsExtension(spec);
+      if (next === spec) return full;
+      changed = true;
+      return `${prefix}${quote}${next}${suffixQuote}`;
+    },
+  );
+
+  // Rewrite: export { ... } from '...'
+  contents = contents.replace(
+    /(\bexport\s+\{[^}]*\}\s+from\s+)(['"])([^'"]+)(\2)/g,
+    (full, prefix, quote, spec, suffixQuote) => {
+      const next = withJsExtension(spec);
+      if (next === spec) return full;
+      changed = true;
+      return `${prefix}${quote}${next}${suffixQuote}`;
+    },
+  );
+
+  // Rewrite: import ... from '...'
+  contents = contents.replace(
+    /(\bimport\s+[^;\n]+\s+from\s+)(['"])([^'"]+)(\2)/g,
+    (full, prefix, quote, spec, suffixQuote) => {
+      const next = withJsExtension(spec);
+      if (next === spec) return full;
+      changed = true;
+      return `${prefix}${quote}${next}${suffixQuote}`;
+    },
+  );
+
+  // Rewrite: import '...'
+  contents = contents.replace(
+    /(\bimport\s+)(['"])([^'"]+)(\2)/g,
+    (full, prefix, quote, spec, suffixQuote) => {
+      const next = withJsExtension(spec);
+      if (next === spec) return full;
+      changed = true;
+      return `${prefix}${quote}${next}${suffixQuote}`;
+    },
+  );
+
+  return { contents, changed };
+}
+
+async function* walk(dir) {
+  const entries = await fs.readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      yield* walk(fullPath);
+    } else {
+      yield fullPath;
+    }
+  }
+}
+
+async function main() {
+  try {
+    await fs.access(esmDir);
+  } catch {
+    console.error(`dist/esm not found: ${esmDir}`);
+    process.exit(1);
+  }
+
+  let processed = 0;
+  let rewritten = 0;
+
+  for await (const filePath of walk(esmDir)) {
+    if (!filePath.endsWith('.js')) continue;
+
+    const original = await fs.readFile(filePath, 'utf8');
+    const { contents, changed } = rewriteFile(original);
+
+    processed++;
+    if (changed) {
+      await fs.writeFile(filePath, contents, 'utf8');
+      rewritten++;
+    }
+  }
+
+  console.log(`fix-esm-imports: processed ${processed} file(s), rewrote ${rewritten} file(s)`);
+}
+
+await main();