vbapm 0.6.15 → 0.8.0

package/lib/{vbapm-test-u7AWC-AV.js → vbapm-test-C4KWMPLz.js}

@@ -1,4 +1,4 @@
-"use strict";var e=require("./installer-CJlDenLg.js"),r=require("./test-project-BTkTNZXs.js");require("child_process"),require("util"),require("assert"),require("path"),require("fs"),require("./_commonjsHelpers-Bjf42z7h.js"),require("crypto"),require("events"),require("os"),require("constants"),require("stream"),require("http"),require("url"),require("punycode"),require("https"),require("zlib"),require("./run-macro-D_9-BO3U.js"),require("./transform-target-Doak2S1q.js"),require("string_decoder"),require("./project-C3bWzV0O.js"),require("querystring"),require("./get-target-CH6IpAa1.js");const t=e.dedent`
+"use strict";var e=require("./installer-DPj-zT7L.js"),r=require("./test-project-DXBFZH3o.js");require("child_process"),require("util"),require("assert"),require("path"),require("fs"),require("./_commonjsHelpers-Bjf42z7h.js"),require("crypto"),require("events"),require("os"),require("constants"),require("stream"),require("http"),require("url"),require("punycode"),require("https"),require("zlib"),require("./run-macro-C1-aJWu5.js"),require("./transform-build-graph-DgRrocSn.js"),require("node:fs"),require("node:path"),require("node:buffer"),require("./project-BPmPCkUS.js"),require("./index-CBGUBgfk.js"),require("querystring"),require("./transform-target-CYhuozxP.js"),require("string_decoder"),require("./get-target-LUoY1UWJ.js");const t=e.dedent`
   Run tests for built target.
 
   Usage: vbapm test [options]

package/lib/vbapm-update-DnbmW8tc.js

@@ -0,0 +1,13 @@
+"use strict";var e=require("./installer-DPj-zT7L.js"),r=require("./index-C61lSPb5.js"),t=require("./project-BPmPCkUS.js"),i=require("./build-target-ooHNsSLD.js"),a=require("./get-target-LUoY1UWJ.js");require("child_process"),require("util"),require("assert"),require("path"),require("fs"),require("./_commonjsHelpers-Bjf42z7h.js"),require("crypto"),require("events"),require("os"),require("constants"),require("stream"),require("http"),require("url"),require("punycode"),require("https"),require("zlib"),require("./index-CBGUBgfk.js"),require("querystring"),require("./transform-build-graph-DgRrocSn.js"),require("node:fs"),require("node:path"),require("node:buffer"),require("./load-from-project-ClF4qaC0.js");const n=e.dedent`
+  Update VBA source in a built target (including one currently open in Excel).
+
+  Usage: vbapm update [options]
+
+  Options:
+    --target=TYPE   Update VBA in a target of type TYPE
+    --release       Exclude dev-* items from update
+    --open          Leave the target open in Excel after updating`;exports.default=async function(o){if(o.help)return void console.log(n);const s=process.hrtime(),u=o.target,d=o.addin,p=!!o.release,l=!!o.open;await async function(r={}){e.env.reporter.log(e.Message.UpdateProjectLoading,"[1/2] Loading project...");const n=await t.loadProject(),{target:o}=a.getTarget(n,r.target),s=await t.fetchDependencies(n),u=e.join(n.paths.build,o.filename);if(!await e.pathExistsExports.pathExists(u))throw new e.CliError(e.ErrorCode.UpdateTargetNotBuilt,e.dedent`
+        No built target found for "${o.name}" at "${u}".
+
+        Run "vbapm build" first to create the built target.
+      `);return e.env.reporter.log(e.Message.UpdateTargetUpdating,`\n[2/2] Updating VBA in "${o.filename}"...`),await i.importTarget(o,{project:n,dependencies:s},u,{addin:r.addin,release:r.release,open:r.open}),u}({target:u,addin:d,release:p,open:l}),console.log(`Done. ${r.time(process.hrtime(s))}`)};

package/lib/vbapm-version-CRicT8YA.js

@@ -0,0 +1,8 @@
+"use strict";var e=require("./installer-DPj-zT7L.js"),r=require("./index-CBGUBgfk.js"),i=require("./project-BPmPCkUS.js");require("child_process"),require("util"),require("assert"),require("path"),require("fs"),require("./_commonjsHelpers-Bjf42z7h.js"),require("crypto"),require("events"),require("os"),require("constants"),require("stream"),require("http"),require("url"),require("punycode"),require("https"),require("zlib"),require("querystring");const t=["patch","minor","major","prepatch","preminor","premajor","prerelease"];async function s(s,n={}){const o=await i.loadProject(),a=o.manifest.version,p=(c=s,t.includes(c));var c;let u;try{u=p?e.semverExports.inc(a,s,void 0,n.preid):e.semverExports.valid(s)}catch(e){}if(!u)throw new e.CliError(e.ErrorCode.InvalidVersion,`Invalid version increment "${s}"`);return o.manifest.version=u,await r.writeManifest(o.manifest,o.paths.dir),u}const n=e.dedent`
+  Increment this project's version.
+
+  Usage: vbapm version [<increment>] [options]
+
+  Options:
+    <increment>   VERSION | patch | minor | major | prepatch | preminor | premajor
+    --preid=TYPE   Use TYPE for prerelease (e.g. "beta")`;exports.default=async function(e){if(e.help)return void console.log(n);const r=e._[0]||"patch",i=e.preid,t=await s(r,{preid:i});console.log(t)};

package/lib/vbapm.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-"use strict";var e,r,n=require("./installer-CJlDenLg.js"),t=require("fs"),o=require("./_commonjsHelpers-Bjf42z7h.js");require("child_process"),require("util"),require("assert"),require("path"),require("crypto"),require("events"),require("os"),require("constants"),require("stream"),require("http"),require("url"),require("punycode"),require("https"),require("zlib");var i=(r||(r=1,e=function(e,r){var n=[],t=[];return r.forEach(function(r,t){var o={};o[function(e,r){var n=[],t=0;for(t=0;t<=e.length;t++)n[t]=[t];for(t=0;t<=r.length;t++)n[0][t]=t;return r.split("").forEach(function(r,t){e.split("").forEach(function(e,o){n[o+1][t+1]=e!==r?Math.min(n[o][t+1]+1,n[o+1][t]+1,n[o][t]+1):n[o][t]})}),n[e.length][r.length]}(e,r)]=t,n.push(o)}),n.sort(function(e,r){return Number(Object.keys(e)[0])-Number(Object.keys(r)[0])}),n.forEach(function(n){var o=Number(Object.keys(n)[0]);e.length/2>=o&&t.push(r[n[o]])}),t}),e),a=o.getDefaultExportFromCjs(i);function s(e){return null==e?[]:Array.isArray(e)?e:[e]}function l(e,r,n,t){var o,i=e[r],a=~t.string.indexOf(r)?null==n||!0===n?"":String(n):"boolean"==typeof n?n:~t.boolean.indexOf(r)?"false"!==n&&("true"===n||(e._.push(0*(o=+n)==0?o:n),!!n)):0*(o=+n)==0?o:n;e[r]=null==i?a:Array.isArray(i)?i.concat(a):[i,a]}Error.stackTraceLimit=1/0;const u=n.env.debug("vbapm:main"),c={new:async()=>(await Promise.resolve().then(function(){return require("./vbapm-new-Dt0tX1xQ.js")})).default,init:async()=>(await Promise.resolve().then(function(){return require("./vbapm-init-csKsZ87H.js")})).default,build:async()=>(await Promise.resolve().then(function(){return require("./vbapm-build-B1OOy6VL.js")})).default,test:async()=>(await Promise.resolve().then(function(){return require("./vbapm-test-u7AWC-AV.js")})).default,export:async()=>(await Promise.resolve().then(function(){return require("./vbapm-export-vvUDCDqi.js")})).default,run:async()=>(await Promise.resolve().then(function(){return require("./vbapm-run-Ccciwg2y.js")})).default,version:async()=>(await Promise.resolve().then(function(){return require("./vbapm-version-Bsb-cWCD.js")})).default},p=function(e,r){r=r||{};var n,t,o,i,a,u={_:[]},c=0,p=0,f=0,d=(e=e||[]).length;const h=void 0!==r.alias,m=void 0!==r.unknown,v=void 0!==r.default;if(r.alias=r.alias||{},r.string=s(r.string),r.boolean=s(r.boolean),h)for(n in r.alias)for(t=r.alias[n]=s(r.alias[n]),c=0;c<t.length;c++)(r.alias[t[c]]=t.concat(n)).splice(c,1);for(c=r.boolean.length;c-- >0;)for(p=(t=r.alias[r.boolean[c]]||[]).length;p-- >0;)r.boolean.push(t[p]);for(c=r.string.length;c-- >0;)for(p=(t=r.alias[r.string[c]]||[]).length;p-- >0;)r.string.push(t[p]);if(v)for(n in r.default)if(i=typeof r.default[n],t=r.alias[n]=r.alias[n]||[],void 0!==r[i])for(r[i].push(n),c=0;c<t.length;c++)r[i].push(t[c]);const g=m?Object.keys(r.alias):[];for(c=0;c<d;c++){if("--"===(o=e[c])){u._=u._.concat(e.slice(++c));break}for(p=0;p<o.length&&45===o.charCodeAt(p);p++);if(0===p)u._.push(o);else if("no-"===o.substring(p,p+3)){if(i=o.substring(p+3),m&&!~g.indexOf(i))return r.unknown(o);u[i]=!1}else{for(f=p+1;f<o.length&&61!==o.charCodeAt(f);f++);for(i=o.substring(p,f),a=o.substring(++f)||c+1===d||45===(""+e[c+1]).charCodeAt(0)||e[++c],t=2===p?[i]:i,f=0;f<t.length;f++){if(i=t[f],m&&!~g.indexOf(i))return r.unknown("-".repeat(p)+i);l(u,i,f+1<t.length||a,r)}}}if(v)for(n in r.default)void 0===u[n]&&(u[n]=r.default[n]);if(h)for(n in u)for(t=r.alias[n]||[];t.length>0;)u[t.shift()]=u[n];return u}(process.argv.slice(2),{alias:{v:"version",h:"help"}});if(p.debug){let e=p.debug;!0===e?e="*":Array.isArray(e)&&(e=e.join(","));const r=e.split(",").map(e=>`vbapm:${e}`),n=process.env.DEBUG?process.env.DEBUG.split(","):[];process.env.DEBUG=n.concat(r).join(",")}const f=n.dedent`
+"use strict";var e,r,n=require("./installer-DPj-zT7L.js"),t=require("fs"),o=require("./_commonjsHelpers-Bjf42z7h.js");require("child_process"),require("util"),require("assert"),require("path"),require("crypto"),require("events"),require("os"),require("constants"),require("stream"),require("http"),require("url"),require("punycode"),require("https"),require("zlib");var i=(r||(r=1,e=function(e,r){var n=[],t=[];return r.forEach(function(r,t){var o={};o[function(e,r){var n=[],t=0;for(t=0;t<=e.length;t++)n[t]=[t];for(t=0;t<=r.length;t++)n[0][t]=t;return r.split("").forEach(function(r,t){e.split("").forEach(function(e,o){n[o+1][t+1]=e!==r?Math.min(n[o][t+1]+1,n[o+1][t]+1,n[o][t]+1):n[o][t]})}),n[e.length][r.length]}(e,r)]=t,n.push(o)}),n.sort(function(e,r){return Number(Object.keys(e)[0])-Number(Object.keys(r)[0])}),n.forEach(function(n){var o=Number(Object.keys(n)[0]);e.length/2>=o&&t.push(r[n[o]])}),t}),e),a=o.getDefaultExportFromCjs(i);function s(e){return null==e?[]:Array.isArray(e)?e:[e]}function l(e,r,n,t){var o,i=e[r],a=~t.string.indexOf(r)?null==n||!0===n?"":String(n):"boolean"==typeof n?n:~t.boolean.indexOf(r)?"false"!==n&&("true"===n||(e._.push(0*(o=+n)==0?o:n),!!n)):0*(o=+n)==0?o:n;e[r]=null==i?a:Array.isArray(i)?i.concat(a):[i,a]}Error.stackTraceLimit=1/0;const u=n.env.debug("vbapm:main"),c={new:async()=>(await Promise.resolve().then(function(){return require("./vbapm-new-YQRNQ4Iq.js")})).default,init:async()=>(await Promise.resolve().then(function(){return require("./vbapm-init-Ba2xCez2.js")})).default,add:async()=>(await Promise.resolve().then(function(){return require("./vbapm-add-CASFjXAL.js")})).default,build:async()=>(await Promise.resolve().then(function(){return require("./vbapm-build-Bhm_pqQW.js")})).default,test:async()=>(await Promise.resolve().then(function(){return require("./vbapm-test-C4KWMPLz.js")})).default,export:async()=>(await Promise.resolve().then(function(){return require("./vbapm-export-8KDCdFOz.js")})).default,update:async()=>(await Promise.resolve().then(function(){return require("./vbapm-update-DnbmW8tc.js")})).default,run:async()=>(await Promise.resolve().then(function(){return require("./vbapm-run-J-R--noZ.js")})).default,version:async()=>(await Promise.resolve().then(function(){return require("./vbapm-version-CRicT8YA.js")})).default},p=function(e,r){r=r||{};var n,t,o,i,a,u={_:[]},c=0,p=0,f=0,d=(e=e||[]).length;const h=void 0!==r.alias,m=void 0!==r.unknown,v=void 0!==r.default;if(r.alias=r.alias||{},r.string=s(r.string),r.boolean=s(r.boolean),h)for(n in r.alias)for(t=r.alias[n]=s(r.alias[n]),c=0;c<t.length;c++)(r.alias[t[c]]=t.concat(n)).splice(c,1);for(c=r.boolean.length;c-- >0;)for(p=(t=r.alias[r.boolean[c]]||[]).length;p-- >0;)r.boolean.push(t[p]);for(c=r.string.length;c-- >0;)for(p=(t=r.alias[r.string[c]]||[]).length;p-- >0;)r.string.push(t[p]);if(v)for(n in r.default)if(i=typeof r.default[n],t=r.alias[n]=r.alias[n]||[],void 0!==r[i])for(r[i].push(n),c=0;c<t.length;c++)r[i].push(t[c]);const g=m?Object.keys(r.alias):[];for(c=0;c<d;c++){if("--"===(o=e[c])){u._=u._.concat(e.slice(++c));break}for(p=0;p<o.length&&45===o.charCodeAt(p);p++);if(0===p)u._.push(o);else if("no-"===o.substring(p,p+3)){if(i=o.substring(p+3),m&&!~g.indexOf(i))return r.unknown(o);u[i]=!1}else{for(f=p+1;f<o.length&&61!==o.charCodeAt(f);f++);for(i=o.substring(p,f),a=o.substring(++f)||c+1===d||45===(""+e[c+1]).charCodeAt(0)||e[++c],t=2===p?[i]:i,f=0;f<t.length;f++){if(i=t[f],m&&!~g.indexOf(i))return r.unknown("-".repeat(p)+i);l(u,i,f+1<t.length||a,r)}}}if(v)for(n in r.default)void 0===u[n]&&(u[n]=r.default[n]);if(h)for(n in u)for(t=r.alias[n]||[];t.length>0;)u[t.shift()]=u[n];return u}(process.argv.slice(2),{alias:{v:"version",h:"help"}});if(p.debug){let e=p.debug;!0===e?e="*":Array.isArray(e)&&(e=e.join(","));const r=e.split(",").map(e=>`vbapm:${e}`),n=process.env.DEBUG?process.env.DEBUG.split(","):[];process.env.DEBUG=n.concat(r).join(",")}const f=n.dedent`
   vbapm v${n.version}
 
   Usage: vbapm [command] [options]
@@ -7,9 +7,11 @@
   Commands:
     - new           Create a new project / package in a new directory
     - init          Initialize a new project / package in the current directory
+    - add           Create and register a new src file in vbaproject.toml
     - build         Build project from manifest
     - test          Run tests for built target
     - export        Export src from built target
+    - update        Update VBA source in a built target
     - run           Run macro in document / add-in
     - help          Outputs this message or the help of the given command
 

package/package.json

@@ -1,142 +1,132 @@
 {
-  "name": "vbapm",
-  "version": "0.6.15",
-  "description": "A package manager and build tool for VBA",
-  "repository": "https://github.com/vbapm/core.git",
-  "contributors": [
-    "Martin Leduc <31558169+DecimalTurn@users.noreply.github.com> (https://github.com/DecimalTurn)",
-    "Tim Hall <tim.hall.engr@gmail.com> (https://github.com/timhall)"
-  ],
-  "license": "MIT",
-  "bin": {
-    "vbapm": "lib/vbapm.js",
-    "vba": "lib/vbapm.js"
-  },
-  "main": "lib/index.js",
-  "types": "lib/src/index.d.ts",
-  "exports": {
-    ".": {
-      "require": "./lib/index.js",
-      "types": "./lib/src/index.d.ts"
-    }
-  },
-  "files": [
-    "lib/",
-    "addins/build/",
-    "run-scripts/",
-    "LICENSE",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "scripts": {
-    "format": "prettier --write \"**/*.{ts,js}\"",
-    "format:check": "prettier --check \"**/*.{ts,js}\"",
-    "test": "jest --runInBand",
-    "typecheck": "tsc",
-    "deps": "npm i",
-    "dev": "run-s deps typecheck format:check test build:cli",
-    "test:e2e": "jest --config e2e.config.cjs --runInBand",
-    "build": "rimraf lib && rollup -c rollup.config.mjs",
-    "build:lib": "run-s build && tsc -p tsconfig.build.json",
-    "build:cli": "run-s build && node scripts/ensure-vendor",
-    "build:dev": "cross-env NODE_ENV=development rollup -c rollup.config.mjs",
-    "build:addins": "cd addins && node --no-warnings ../scripts/build-addins",
-    "build:bootstrap": "cd scripts/bootstrap && node --no-warnings ../../lib/vbapm build",
-    "clean": "rimraf lib && rimraf dist && rimraf addins/build"
-  },
-  "jest": {
-    "preset": "ts-jest",
-    "testEnvironment": "node",
-    "testPathIgnorePatterns": [
-      "/node_modules/",
-      "/lib/"
+    "name": "vbapm",
+    "version": "0.8.0",
+    "description": "A package manager and build tool for VBA",
+    "repository": "https://github.com/vbapm/core.git",
+    "contributors": [
+        "Martin Leduc <31558169+DecimalTurn@users.noreply.github.com> (https://github.com/DecimalTurn)",
+        "Tim Hall <tim.hall.engr@gmail.com> (https://github.com/timhall)"
     ],
-    "moduleNameMapper": {
-      "^@timhall/dedent$": "<rootDir>/node_modules/@timhall/dedent/dist/dedent.js"
+    "license": "MIT",
+    "bin": {
+        "vbapm": "lib/vbapm.js",
+        "vba": "lib/vbapm.js"
     },
-    "snapshotFormat": {
-      "escapeString": true,
-      "printBasicPrototype": true
-    }
-  },
-  "dependencies": {
-    "@decimalturn/toml-patch": "^0.7",
-    "@timhall/ansi-colors": "^5.0.0",
-    "@timhall/dedent": "^0.9.1",
-    "archiver": "^7.0.1",
-    "conf": "^3",
-    "date-fns": "^2",
-    "debug": "^4",
-    "decompress": "^4",
-    "editorconfig": "^0.15.3",
-    "env-paths": "^2",
-    "fs-extra": "^7",
-    "isomorphic-git": "^1.37.1",
-    "logic-solver": "^2",
-    "meant": "^1.0",
-    "mri": "^1",
-    "node-fetch": "^2",
-    "open": "^6",
-    "pretty-hrtime": "^1",
-    "sanitize-filename": "^1",
-    "semver": "^5",
-    "tmp": "^0.2.5",
-    "walk-sync": "^4.0.1",
-    "xml-js": "^1.6"
-  },
-  "devDependencies": {
-    "@rollup/plugin-commonjs": "^28.0.3",
-    "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-node-resolve": "^16.0.1",
-    "@rollup/plugin-replace": "^6.0.2",
-    "@rollup/plugin-terser": "^0.4.4",
-    "@rollup/plugin-typescript": "^12.1.2",
-    "@types/archiver": "^2",
-    "@types/fs-extra": "^5",
-    "@types/jest": "^29",
-    "@types/node": "^22",
-    "@types/node-fetch": "^2.6.13",
-    "@types/semver": "^5",
-    "@types/tmp": "^0.0",
-    "aws-sdk": "^2.562.0",
-    "builtin-modules": "^3.0.0",
-    "cross-env": "^5",
-    "dotenv": "^7.0.0",
-    "jest": "^29",
-    "mustache": "^3",
-    "npm-run-all": "^4",
-    "prettier": "^3",
-    "rimraf": "^6.1.3",
-    "rollup": "^4.34.9",
-    "ts-jest": "^29",
-    "tslib": "^1.9.3",
-    "typescript": "^5",
-    "url-join": "^4.0.1"
-  },
-  "overrides": {
-    "minimatch": "^10.2.1"
-  },
-  "json-comments": {
-    "tips": "You may install the JsonComments plugin to enable commenting functionality for JSON files, see: https://github.com/zhangfisher/json_comments_extension",
-    "package.json": {
-      "scripts.format": "Formats all .ts and .js files using Prettier",
-      "scripts.format:check": "Checks all .ts and .js files with Prettier",
-      "scripts.test": "Runs Jest tests in a single thread",
-      "scripts.typecheck": "Runs the TypeScript compiler to check for type errors",
-      "scripts.test:e2e": "Runs end-to-end tests using a specific Jest configuration",
-      "scripts.build:lib": "Core build: rollup bundle + .d.ts generation (used by both npm and standalone channels)",
-      "scripts.build:cli": "Standalone CLI build: rollup bundle (no sourcemaps, no .d.ts) + fetch vendored Node binary",
-      "scripts.build:dev": "Allows to quickly rebuild the project in development mode with environment variables set for easier debugging of the js/ts code",
-      "scripts.build:addins": "Builds the add-ins by running a custom build script in the addins directory",
-      "scripts.build:bootstrap": "Update the bootstrap file (used to build the addin) by using the latest addin build (inception!)",
-      "scripts.clean": "Removes generated files from lib, dist, and addins/build directories",
-      "devDependencies.cross-env": "Used to set environment variables in a cross-platform-compatible way for build scripts",
-      "overrides": "Pins vulnerable transitive dependencies to patched versions to remove critical npm audit findings without large upstream upgrades.",
-      "overrides.minimist": "Prototype pollution fix, mainly needed for ts-jest/handlebars transitive chain.",
-      "overrides.underscore": "Arbitrary code execution mitigation, mainly needed for logic-solver transitive dependency.",
-      "overrides.shell-quote": "Command injection advisory mitigation, mainly needed for npm-run-all transitive dependency."
+    "main": "lib/index.js",
+    "types": "lib/src/index.d.ts",
+    "exports": {
+        ".": {
+            "require": "./lib/index.js",
+            "types": "./lib/src/index.d.ts"
+        }
+    },
+    "files": [
+        "lib/",
+        "addins/build/",
+        "run-scripts/",
+        "LICENSE",
+        "README.md"
+    ],
+    "engines": {
+        "node": ">=18.14.0"
+    },
+    "scripts": {
+        "format": "prettier --write \"**/*.{ts,js}\"",
+        "format:check": "prettier --check \"**/*.{ts,js}\"",
+        "test": "jest --runInBand",
+        "typecheck": "tsc",
+        "deps": "npm i",
+        "dev": "run-s deps typecheck format:check test build:cli",
+        "test:e2e": "cross-env VBA_BACKGROUND_BUILD=0 jest --config e2e.config.mjs --runInBand",
+        "test:e2e:background": "cross-env VBA_BACKGROUND_BUILD=1 jest --config e2e.config.mjs --runInBand",
+        "test:e2e:updateSnapshots": "cross-env VBA_BACKGROUND_BUILD=0 jest --config e2e.config.mjs --runInBand --updateSnapshot",
+        "build": "rimraf lib && rollup -c rollup.config.mjs",
+        "build:lib": "run-s build && tsc -p tsconfig.build.json",
+        "build:cli": "run-s build && node scripts/ensure-vendor",
+        "build:dev": "cross-env NODE_ENV=development rollup -c rollup.config.mjs",
+        "build:addins": "cd addins && node --no-warnings ../scripts/build-addins",
+        "build:bootstrap": "cd scripts/bootstrap && node --no-warnings ../../lib/vbapm build",
+        "clean": "rimraf lib && rimraf dist && rimraf addins/build",
+        "deploy:dev": "npm run build:dev && powershell -ExecutionPolicy Bypass -File ./installer/devinstall.ps1"
+    },
+    "dependencies": {
+        "@decimalturn/toml-patch": "^1.0.5",
+        "@timhall/ansi-colors": "^5.0.0",
+        "@timhall/dedent": "^0.10.0",
+        "archiver": "^7.0.1",
+        "conf": "^3",
+        "date-fns": "^4.0.0",
+        "debug": "^4",
+        "decompress": "^4",
+        "editorconfig": "^3.0.0",
+        "env-paths": "^2",
+        "fs-extra": "^7",
+        "isomorphic-git": "^1.37.1",
+        "logic-solver": "^2",
+        "meant": "^2.0.0",
+        "mri": "^1",
+        "node-fetch": "^2",
+        "open": "^11.0.0",
+        "pretty-hrtime": "^1",
+        "sanitize-filename": "^1",
+        "semver": "^7.0.0",
+        "tmp": "^0.2.5",
+        "walk-sync": "^4.0.1",
+        "xml-js": "^1.6"
+    },
+    "devDependencies": {
+        "@rollup/plugin-commonjs": "^29.0.0",
+        "@rollup/plugin-json": "^6.1.0",
+        "@rollup/plugin-node-resolve": "^16.0.1",
+        "@rollup/plugin-replace": "^6.0.2",
+        "@rollup/plugin-terser": "^1.0.0",
+        "@rollup/plugin-typescript": "^12.1.2",
+        "@types/archiver": "^7.0.0",
+        "@types/fs-extra": "^5",
+        "@types/jest": "^30",
+        "@types/node": "^24.0.0",
+        "@types/node-fetch": "^2.6.13",
+        "@types/semver": "^7.0.0",
+        "@types/tmp": "^0.2.0",
+        "aws-sdk": "^2.562.0",
+        "builtin-modules": "^5.0.0",
+        "cross-env": "^10.0.0",
+        "dotenv": "^17.0.0",
+        "jest": "^30",
+        "mustache": "^4.0.0",
+        "npm-run-all2": "^8.0.0",
+        "prettier": "^3",
+        "rimraf": "^6.1.3",
+        "rollup": "^4.34.9",
+        "ts-jest": "^29",
+        "tslib": "^2.0.0",
+        "typescript": "^5",
+        "url-join": "^5.0.0"
+    },
+    "overrides": {
+        "minimatch": "^10.2.1"
+    },
+    "json-comments": {
+        "tips": "You may install the JsonComments plugin to enable commenting functionality for JSON files, see: https://github.com/zhangfisher/json_comments_extension",
+        "package.json": {
+            "scripts.format": "Formats all .ts and .js files using Prettier",
+            "scripts.format:check": "Checks all .ts and .js files with Prettier",
+            "scripts.test": "Runs Jest tests in a single thread",
+            "scripts.typecheck": "Runs the TypeScript compiler to check for type errors",
+            "scripts.test:e2e": "Runs end-to-end tests using a specific Jest configuration",
+            "scripts.build:lib": "Core build: rollup bundle + .d.ts generation (used by both npm and standalone channels)",
+            "scripts.build:cli": "Standalone CLI build: rollup bundle (no sourcemaps, no .d.ts) + fetch vendored Node binary",
+            "scripts.build:dev": "Allows to quickly rebuild the project in development mode with environment variables set for easier debugging of the js/ts code",
+            "scripts.build:addins": "Builds the add-ins by running a custom build script in the addins directory",
+            "scripts.build:bootstrap": "Update the bootstrap file (used to build the addin) by using the latest addin build (inception!)",
+            "scripts.clean": "Removes generated files from lib, dist, and addins/build directories",
+            "devDependencies.cross-env": "Used to set environment variables in a cross-platform-compatible way for build scripts",
+            "jest.transformIgnorePatterns": "@decimalturn/toml-patch v1+ is ESM-only. Jest (running in CJS mode via ts-jest) skips transforming node_modules by default, which causes 'Unexpected token export' errors. This pattern excludes toml-patch from that skip list so ts-jest can downcompile it to CJS at test time.",
+            "jest.transform": "Required alongside transformIgnorePatterns: overrides the default ts-jest transform to add allowJs:true so ts-jest can process the plain .js ESM dist file of @decimalturn/toml-patch.",
+            "overrides": "Pins vulnerable transitive dependencies to patched versions to remove critical npm audit findings without large upstream upgrades.",
+            "overrides.minimist": "Prototype pollution fix, mainly needed for ts-jest/handlebars transitive chain.",
+            "overrides.underscore": "Arbitrary code execution mitigation, mainly needed for logic-solver transitive dependency.",
+            "overrides.shell-quote": "Command injection advisory mitigation, mainly needed for npm-run-all transitive dependency."
+        }
     }
-  }
 }

package/run-scripts/run.applescript

@@ -3,42 +3,53 @@
 -- appname (e.g. "excel")
 -- addin: posix full path to addin (e.g. "...")
 -- command: macro to execute in addin (e.g. "Build.ImportGraph")
+-- keep_open: "1" to leave the workbook/app open after the macro, "0" to close
 -- ...args: arguments to pass to macro (up to 10)
 
 on run argv
 	set output to ""
 
-	if (count of argv) >= 3 and (count of argv) <= 13 then
+	if (count of argv) >= 4 and (count of argv) <= 14 then
 		set appname to (item 1 of argv)
 		set addin to POSIX file (item 2 of argv)
 		set command to (item 3 of argv)
+		set keep_open to (item 4 of argv) is "1"
 
 		set args to {}
-		repeat with index from 4 to count of argv
+		repeat with index from 5 to count of argv
 			set end of args to (item index of argv)
 		end repeat
 
 		if appname is "excel" then
 			set workbook_name to name of (info for addin)
 
+			set excel_was_open to application "Microsoft Excel" is running
+
 			tell application "Microsoft Excel"
 				set workbook_was_open to (exists workbook workbook_name)
 				if not workbook_was_open then
 					open workbook workbook file name addin without notify
 				end if
 
-				set output to output & my run_excel_macro(command, args)
+				set output to my run_excel_macro(command, args)
 
-				if not workbook_was_open then
+				-- A workbook that was already open is never closed by us.
+				-- Otherwise close it unless keep_open was requested.
+				if not workbook_was_open and not keep_open then
 					close workbook workbook_name saving yes
 				end if
 			end tell
+
+			-- Quit Excel only if we launched it AND we are not keeping the file open.
+			if not excel_was_open and not keep_open then
+				tell application "Microsoft Excel" to quit
+			end if
 		end if
 	else
-		if (count of argv) < 3 then
-			set output to output & "ERROR #1: Invalid Input (appname, file, and macro are required"
+		if (count of argv) < 4 then
+			set output to "ERROR #1: Invalid Input (appname, file, macro, and keep_open are required)"
 		else
-			set output to output & "ERROR #2: Invalid Input (only 10 arguments are supported)"
+			set output to "ERROR #2: Invalid Input (only 10 arguments are supported)"
 		end if
 	end if
 

package/run-scripts/run.ps1

@@ -8,6 +8,8 @@ param(
     [Parameter(Position=2)]
     [string]$Command,
 
+    [switch]$KeepOpen,
+
     [Parameter(Position=3, ValueFromRemainingArguments=$true)]
     [string[]]$MacroArgs
 )
@@ -90,6 +92,7 @@ function RunMacro {
 
 class Excel {
     hidden [object]$App
+    hidden [bool]$BackgroundBuild = $false
     hidden [bool]$ExcelWasOpen = $false
     hidden [object]$Workbook
     hidden [bool]$WorkbookWasOpen = $false
@@ -106,13 +109,29 @@ class Excel {
     }
 
     hidden [void] OpenExcel() {
-        try {
-            $this.App = [System.Runtime.InteropServices.Marshal]::GetActiveObject("Excel.Application")
-            $this.ExcelWasOpen = $true
-        } catch {
+        # When VBA_BACKGROUND_BUILD is set, always create a new hidden instance
+        # instead of attaching to an already-running (visible) Excel process.
+        # This prevents the application window from flashing during automated runs.
+        $this.BackgroundBuild = $env:VBA_BACKGROUND_BUILD -match '^(1|true|yes)$'
+
+        if (-not $this.BackgroundBuild) {
+            try {
+                $this.App = [System.Runtime.InteropServices.Marshal]::GetActiveObject("Excel.Application")
+                $this.ExcelWasOpen = $true
+            } catch {
+                # Excel not running; fall through to create a new instance
+            }
+        }
+
+        if (-not $this.ExcelWasOpen) {
             try {
                 $this.App = New-Object -ComObject "Excel.Application"
-                $this.App.Visible = $false
+                $this.App.Visible = if ($this.BackgroundBuild) { $false } else { $true }
+                $this.App.ScreenUpdating = $false
+				$this.App.DisplayStatusBar = $false
+				$this.App.PrintCommunication = $false
+				$this.App.EnableAnimations = $false
+                $this.App.EnableEvents = $false
             } catch {
                 Fail "ERROR #5: Failed to open Excel - $($_.Exception.Message)"
             }
@@ -147,17 +166,29 @@ class Excel {
         # Open the workbook
         try {
             $this.Workbook = $this.App.Workbooks.Open($Path)
+            # Workbooks.Open() can flip Excel back to visible; re-enforce
+            # invisible mode if we created this instance for automation.
+            # Also apply workbook-level performance flags now that a workbook is open.
+            if ($this.BackgroundBuild) {
+                $this.App.Visible = $false
+                try { $this.App.Calculation = -4135 } catch {}  # xlCalculationManual — requires an open workbook
+
+            }
         } catch {
             Fail "ERROR #6: Failed to open workbook - $($_.Exception.Message)"
         }
     }
 
-    [void] Dispose() {
-        if (-not $this.WorkbookWasOpen -and $null -ne $this.Workbook) {
+    [void] Dispose([bool]$KeepOpen) {
+        # A file that was open before we started is never closed by us
+        $closeWorkbook = -not $this.WorkbookWasOpen -and -not $KeepOpen
+
+        if ($closeWorkbook -and $null -ne $this.Workbook) {
             $this.Workbook.Close($true)
             $this.Workbook = $null
         }
-        if (-not $this.ExcelWasOpen -and $null -ne $this.App) {
+        # Quit Excel only if we launched it AND we are not keeping the file open
+        if (-not $this.ExcelWasOpen -and -not $KeepOpen -and $null -ne $this.App) {
             $this.App.Quit()
             [System.Runtime.InteropServices.Marshal]::ReleaseComObject($this.App) | Out-Null
             $this.App = $null
@@ -174,6 +205,7 @@ function Run {
         [string]$AppName,
         [string]$FilePath,
         [string]$MacroName,
+        [bool]$KeepOpen,
         [string[]]$MacroArgValues
     )
 
@@ -183,7 +215,7 @@ function Run {
             try {
                 $result = $excel.Run($FilePath, $MacroName, $MacroArgValues)
             } finally {
-                $excel.Dispose()
+                $excel.Dispose($KeepOpen)
             }
         }
         default {
@@ -214,5 +246,5 @@ foreach ($arg in $MacroArgs) {
     $UnescapedArgs += Unescape $arg
 }
 
-Run $AppName $File $Command $UnescapedArgs
+Run $AppName $File $Command $KeepOpen.IsPresent $UnescapedArgs
 exit 0

package/lib/build-project-BczswKQl.js

@@ -1,3 +0,0 @@
-"use strict";var e=require("./installer-CJlDenLg.js"),r=require("./project-C3bWzV0O.js"),t=require("./build-target-D6L5nsgt.js");require("assert"),require("./transform-target-Doak2S1q.js"),require("fs");var i=require("./get-target-CH6IpAa1.js");exports.buildProject=async function(n={}){e.env.reporter.log(e.Message.BuildProjectLoading,"[1/3] Loading project...");const a=await r.loadProject(),{target:s,blankTarget:o}=i.getTarget(a,n.target),g=await r.fetchDependencies(a),c=a.packages.map(e=>{const t=r.toDependency(e);return r.isRegistryDependency(t)?`${e.id} registry+${t.registry}`:`${e.id} ${e.source}`});e.env.reporter.log(e.Message.BuildTargetBuilding,e.dedent`
-      \n[2/3] Building target "${s.type}" for "${a.manifest.name}"...
-      ${c.length?`\nDependencies:\n${c.join("\n")}`:""}`),await t.buildTarget(s,{project:a,dependencies:g,blankTarget:o},n);const d=!a.hasDirtyLockfile;return e.env.reporter.log(e.Message.BuildLockfileWriting,"\n[3/3] Writing lockfile..."+(d?" (skipped, no changes)":"")),d||await r.writeLockfile(a.paths.root,a),e.join(a.paths.dir,"build",s.filename)};

package/lib/build-target-D6L5nsgt.js

@@ -1,9 +0,0 @@
-"use strict";var t=require("./installer-CJlDenLg.js"),a=require("./transform-target-Doak2S1q.js");require("assert");var r=require("./load-from-project-Bpb6Ne_i.js"),e=require("path"),i=require("./project-C3bWzV0O.js");const o=t=>/1004/.test(t),n=(a,r)=>t.dedent`
-  Failed to build target "${a.name}", it is currently open.
-
-  Please close "${r}" and try again.
-`;async function s(a,r){if(!await t.pathExistsExports.pathExists(r.path))throw new t.CliError(t.ErrorCode.TargetNotFound,`Target "${r.name}" not found at "${r.path}".`);const e=t.join(a.paths.staging,r.filename);try{await t.mkdirsExports.ensureDir(a.paths.staging),await i.zip(r.path,e)}catch(a){throw new t.CliError(t.ErrorCode.TargetCreateFailed,`Failed to create project for target "${r.name}".`,a)}return e}exports.buildTarget=async function(i,p,c={}){const{project:l}=p;let m;try{m=p.blankTarget?await a.createDocument(l,i,{staging:!0}):await s(l,i)}catch(a){if(!t.isRunError(a)||!a.result.errors.some(o))throw a;const r=t.join(l.paths.build,i.filename);throw new t.CliError(t.ErrorCode.TargetIsOpen,n(i,r))}await async function(i,o,n,s={}){const{project:p,dependencies:c}=o,l=t.join(p.paths.staging,"import");await t.mkdirsExports.ensureDir(l),await t.emptyExports.emptyDir(l);const m=await r.loadFromProject(p,c,s),w=await async function(a,r){const i=await t.parallel(a.components,async a=>{const i=t.join(r,a.filename);if(await t.writeFile(i,a.code),a.binaryPath){const i=t.join(r,e.basename(a.binaryPath));if(!a.details.binary)throw new Error(`Binary data missing for component "${a.name}"`);await t.writeFile(i,a.details.binary)}return{name:a.name,path:i}});return{name:a.name,components:i,references:a.references}}(m,l);try{await a.importGraph(p,i,w,n,s)}catch(a){throw new t.CliError(t.ErrorCode.TargetImportFailed,`Failed to import project for target "${i.name}".`,a)}finally{await t.removeExports.remove(l)}}(i,p,m,c);try{await async function(a,r){const e=t.join(a.paths.backup,r.filename),i=t.join(a.paths.build,r.filename);await t.pathExistsExports.pathExists(e)&&await t.removeExports.remove(e);if(await t.pathExistsExports.pathExists(i)){await t.mkdirsExports.ensureDir(a.paths.backup);try{await t.moveExports.move(i,e)}catch(a){throw new t.CliError(t.ErrorCode.TargetIsOpen,n(r,i))}}}(l,i);const a=t.join(l.paths.build,i.filename);await t.moveExports.move(m,a)}catch(a){throw await async function(a,r){const e=t.join(a.paths.backup,r.filename),i=t.join(a.paths.build,r.filename);if(!await t.pathExistsExports.pathExists(e))return;try{await t.copyExports.copy(e,i)}catch(a){throw new t.CliError(t.ErrorCode.TargetRestoreFailed,t.dedent`
-        Failed to automatically restore backup from "${e}" to "${i}".
-
-        The previous version can be moved back manually, if desired.
-      `,a)}}(l,i),a}finally{await t.removeExports.remove(m)}};

package/lib/export-project-DQ3bfvbV.js

@@ -1,4 +0,0 @@
-"use strict";var e=require("./installer-CJlDenLg.js"),t=require("./transform-target-Doak2S1q.js"),r=require("./project-C3bWzV0O.js");require("assert"),require("fs");var o=require("./export-target-CN6RA_mA.js");exports.exportProject=async function(a={}){e.env.reporter.log(e.Message.ExportProjectLoading,"[1/3] Loading project...");const i=await r.loadProject();if(!a.target&&!i.manifest.target)throw new e.CliError(e.ErrorCode.ExportNoTarget,e.dedent`
-        No default target found for project,
-        use --target TYPE to export from a specific target.
-      `);let n,s=!1;if(i.manifest.target)a.target&&a.target!==i.manifest.target.type||(n=i.manifest.target);else{const t=a.target,r=i.manifest.name;n={type:t,name:r,path:`targets/${t}`,filename:`${e.sanitize(r)}.${t}`},s=!0}if(!n)throw new e.CliError(e.ErrorCode.ExportNoMatching,`No matching target found for type "${a.target}" in project.`);const p=await r.fetchDependencies(i);let g;try{a.completed?g=a.completed:(g=e.join(i.paths.staging,"export"),e.env.reporter.log(e.Message.ExportToStaging,`\n[2/3] Exporting src from "${n.filename}"`),await e.mkdirsExports.ensureDir(g),await e.emptyExports.emptyDir(g),await t.exportTo(i,n,g,a)),e.env.reporter.log(e.Message.ExportToProject,"\n[3/3] Updating project"),await o.exportTarget(n,{project:i,dependencies:p,blankTarget:s},g)}catch(e){throw e}finally{g&&await e.removeExports.remove(g)}};

package/lib/export-target-CN6RA_mA.js

@@ -1,4 +0,0 @@
-"use strict";var e=require("./installer-CJlDenLg.js"),n=require("./project-C3bWzV0O.js"),t=require("path"),r=require("./load-from-project-Bpb6Ne_i.js"),o=require("./transform-target-Doak2S1q.js");async function a(t,r){for(const n of r.components.added){const r={name:n.name,path:e.join(t.paths.dir,`src/${n.filename}`)};t.manifest.src.push(r)}for(const e of r.components.removed){const n=t.manifest.src.findIndex(n=>n.name===e.name);t.manifest.src.splice(n,1)}for(let e of r.references.added)t.manifest.references.push(e);for(const e of r.references.removed){const n=t.manifest.references.findIndex(n=>n.name===e.name);t.manifest.references.splice(n,1)}await n.writeManifest(t.manifest,t.paths.dir)}async function s(n,r){const o=t.dirname(n);if(await e.mkdirsExports.ensureDir(o),await e.writeFile(n,r.code),r.binaryPath){if(!r.details.binary)throw new Error(`Binary data missing for component "${r.name}"`);await e.writeFile(e.join(o,r.binaryPath),r.details.binary)}}require("assert");const i=[".frx"];async function c(n){const a=o.walk(n,{directories:!1}).filter(e=>"project.json"!==e&&!e.startsWith("target")&&!e.startsWith("staged")&&!(e=>!(""!==t.extname(e)))(e)).map(t=>e.join(n,t)),{name:s,references:c}=await async function(n){const t=e.join(n,"project.json");if(!await e.pathExistsExports.pathExists(t))return{name:"VBAProject",references:[]};return await e.jsonfileExports.readJson(t)}(n),m={},d=a.filter(e=>{if(!function(e){return i.includes(t.extname(e))}(e))return!0;const n=p(e);return m[n]=e,!1}),f=await e.parallel(d,async n=>{const o=p(n),a=r.extensionToType[t.extname(n)],s=await e.readFile(n),i=m[o]&&await e.readFile(m[o]);if(!a)throw new e.CliError(e.ErrorCode.ComponentUnrecognized,`Unrecognized component extension "${t.extname(n)}" (at "${n}").`);return new r.Component(a,s,{binary:i})},{progress:e.env.reporter.progress("Loading exported components")});return f.sort(r.byComponentName),{name:s,components:f,references:c,fromDependencies:{components:new Map,references:new Map}}}function p(e){return t.basename(e,t.extname(e))}async function m(r,a,s){let i=e.join(r.paths.build,a.filename);const c=e.join(s,"target");if(!await e.pathExistsExports.pathExists(i))throw new e.CliError(e.ErrorCode.ExportTargetNotFound,e.dedent`
-        Could not find built target for type "${a.type}"
-        (checked "${i}").
-      `);if(!e.env.isWindows){const n=e.join(s,"staged",a.filename);await e.pathExistsExports.pathExists(n)||(await e.mkdirsExports.ensureDir(t.dirname(n)),await e.copyExports.copy(i,n)),i=n}return await e.mkdirsExports.ensureDir(c),await n.unzip(i,c,{filter:o.filterTarget,map:o.mapTarget}),c}exports.exportTarget=async function(n,t,i){const{project:p,dependencies:d,blankTarget:f}=t;let l;f||(l=await m(p,n,i));const u=await r.loadFromProject(p,d),w=await c(i),h=function(e,n){const t={components:{added:[],changed:[],removed:[]},references:{added:[],changed:[],removed:[]}},o={components:new Map,references:new Map};for(const n of e.components)o.components.set(n.name,n);for(const n of e.references)o.references.set(n.name,n);for(const r of n.components){const n=r.name,a=o.components.get(n);o.components.delete(n),a&&e.fromDependencies.components.has(a)||(a?r.code!==a.code&&(r.details.path=a.details.path,t.components.changed.push(r)):t.components.added.push(r))}for(const e of o.components.values())t.components.removed.push(e);t.components.added.sort(r.byComponentName),t.components.changed.sort(r.byComponentName),t.components.removed.sort(r.byComponentName);for(const r of n.references){const n=r.name,a=o.references.get(n);o.references.delete(n),a&&e.fromDependencies.references.has(a)||(a?r.guid===a.guid&&r.major===a.major&&r.minor===a.minor||t.references.changed.push(r):t.references.added.push(r))}for(const e of o.references.values())t.references.removed.push(e);return t}(u,await o.toSrc(w));await async function(n,t){const r=e.env.reporter.progress("Updating src files"),o=r.start,i=r.done;r.start=()=>{},r.done=()=>{},o(),await e.parallel(t.components.changed,e=>s(e.details.path,e),{progress:r}),await e.parallel(t.components.added,async t=>{const r=e.join(n.paths.dir,"src",t.filename);t.details.path=r,await s(r,t)},{progress:r}),await e.parallel(t.components.removed,async n=>{await e.removeExports.remove(n.details.path)},{progress:r}),await a(n,t),i()}(p,h),f||(await e.removeExports.remove(n.path),await e.copyExports.copy(l,n.path)),await e.removeExports.remove(i)},exports.extractTarget=m;