@markw65/monkeyc-optimizer 1.1.63 → 1.1.64

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to the "monkeyc-optimizer" package will be documented in this file.
 
+### 1.1.64
+
+- Pull all relevent config options from any found settings files
+- Look for a .code-workspace file, starting from the project folder and working upwards. Pull settings from it if found.
+- Update the example code in the README to fix some nits.
+
 ### 1.1.63
 
 - Fixes #31 again, after the fix for #35 broke it

package/README.md

@@ -16,11 +16,11 @@ See [Change Log](CHANGELOG.md)
 
 ## API
 
-First you will need to [install nodejs/npm](https://nodejs.org/en/download).
+First you will need to [install nodejs/npm](https://nodejs.org/en/download). Note that you need node 16.17.1 or later, preferably 18.20.3 or later
 
 Then you can install the package. From the directory where you want to use it:
 
-```
+```sh
 npm install -D @markw65/monkeyc-optimizer
 ```
 
@@ -31,7 +31,8 @@ import { buildOptimizedProject, getConfig } from "@markw65/monkeyc-optimizer";
 import { optimizeProgram } from "@markw65/monkeyc-optimizer/sdk-util.js";
 import * as path from "node:path";
 
-const jungleFiles = process.argv[2];
+const cwd = process.cwd();
+const jungleFiles = path.resolve(cwd, process.argv[2]);
 const workspace = path.dirname(jungleFiles);
 
 getConfig({
@@ -48,7 +49,7 @@ getConfig({
   // Defaults to bin. Relative paths are relative to workspace
   buildDir: "bin",
   // Where to put the files generated by the source-to-source optimizer
-  // Defaults to bin/optimized. Relative paths are relative to workspace
+  // Defaults to `${buildDir}/optimized`. Relative paths are relative to workspace
   outputPath: "bin/optimized",
   // Semi-colon separated list of jungle files
   jungleFiles,

package/build/api.cjs

@@ -18,47 +18,47 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var api_exports = {};
 __export(api_exports, {
-  checkCompilerVersion: () => import_chunk_Y2ZRISYL.checkCompilerVersion,
-  collectNamespaces: () => import_chunk_Y2ZRISYL.collectNamespaces,
-  createDocumentationMap: () => import_chunk_Y2ZRISYL.createDocumentationMap,
-  diagnostic: () => import_chunk_Y2ZRISYL.diagnostic,
-  diagnosticHelper: () => import_chunk_Y2ZRISYL.diagnosticHelper,
-  findNamesInScope: () => import_chunk_Y2ZRISYL.findNamesInScope,
-  findUsingForNode: () => import_chunk_Y2ZRISYL.findUsingForNode,
-  formatAst: () => import_chunk_Y2ZRISYL.formatAst,
-  formatAstLongLines: () => import_chunk_Y2ZRISYL.formatAstLongLines,
-  formatScopedName: () => import_chunk_Y2ZRISYL.formatScopedName,
-  getApiFunctionInfo: () => import_chunk_Y2ZRISYL.getApiFunctionInfo,
-  getApiMapping: () => import_chunk_Y2ZRISYL.getApiMapping,
-  getSuperClasses: () => import_chunk_Y2ZRISYL.getSuperClasses,
+  checkCompilerVersion: () => import_chunk_VZBYW6QS.checkCompilerVersion,
+  collectNamespaces: () => import_chunk_VZBYW6QS.collectNamespaces,
+  createDocumentationMap: () => import_chunk_VZBYW6QS.createDocumentationMap,
+  diagnostic: () => import_chunk_VZBYW6QS.diagnostic,
+  diagnosticHelper: () => import_chunk_VZBYW6QS.diagnosticHelper,
+  findNamesInScope: () => import_chunk_VZBYW6QS.findNamesInScope,
+  findUsingForNode: () => import_chunk_VZBYW6QS.findUsingForNode,
+  formatAst: () => import_chunk_VZBYW6QS.formatAst,
+  formatAstLongLines: () => import_chunk_VZBYW6QS.formatAstLongLines,
+  formatScopedName: () => import_chunk_VZBYW6QS.formatScopedName,
+  getApiFunctionInfo: () => import_chunk_VZBYW6QS.getApiFunctionInfo,
+  getApiMapping: () => import_chunk_VZBYW6QS.getApiMapping,
+  getSuperClasses: () => import_chunk_VZBYW6QS.getSuperClasses,
   hasProperty: () => import_chunk_MBTLUWXR.hasProperty,
-  isClassVariable: () => import_chunk_Y2ZRISYL.isClassVariable,
-  isLocal: () => import_chunk_Y2ZRISYL.isLocal,
-  isLookupCandidate: () => import_chunk_Y2ZRISYL.isLookupCandidate,
-  isStateNode: () => import_chunk_Y2ZRISYL.isStateNode,
-  lookupByFullName: () => import_chunk_Y2ZRISYL.lookupByFullName,
-  lookupNext: () => import_chunk_Y2ZRISYL.lookupNext,
-  lookupResultContains: () => import_chunk_Y2ZRISYL.lookupResultContains,
-  lookupWithType: () => import_chunk_Y2ZRISYL.lookupWithType,
-  makeToyboxLink: () => import_chunk_Y2ZRISYL.makeToyboxLink,
-  mapVarDeclsByType: () => import_chunk_Y2ZRISYL.mapVarDeclsByType,
-  markInvokeClassMethod: () => import_chunk_Y2ZRISYL.markInvokeClassMethod,
-  parseSdkVersion: () => import_chunk_Y2ZRISYL.parseSdkVersion,
-  resolveDiagnostics: () => import_chunk_Y2ZRISYL.resolveDiagnostics,
-  resolveDiagnosticsMap: () => import_chunk_Y2ZRISYL.resolveDiagnosticsMap,
-  sameLookupResult: () => import_chunk_Y2ZRISYL.sameLookupResult,
+  isClassVariable: () => import_chunk_VZBYW6QS.isClassVariable,
+  isLocal: () => import_chunk_VZBYW6QS.isLocal,
+  isLookupCandidate: () => import_chunk_VZBYW6QS.isLookupCandidate,
+  isStateNode: () => import_chunk_VZBYW6QS.isStateNode,
+  lookupByFullName: () => import_chunk_VZBYW6QS.lookupByFullName,
+  lookupNext: () => import_chunk_VZBYW6QS.lookupNext,
+  lookupResultContains: () => import_chunk_VZBYW6QS.lookupResultContains,
+  lookupWithType: () => import_chunk_VZBYW6QS.lookupWithType,
+  makeToyboxLink: () => import_chunk_VZBYW6QS.makeToyboxLink,
+  mapVarDeclsByType: () => import_chunk_VZBYW6QS.mapVarDeclsByType,
+  markInvokeClassMethod: () => import_chunk_VZBYW6QS.markInvokeClassMethod,
+  parseSdkVersion: () => import_chunk_VZBYW6QS.parseSdkVersion,
+  resolveDiagnostics: () => import_chunk_VZBYW6QS.resolveDiagnostics,
+  resolveDiagnosticsMap: () => import_chunk_VZBYW6QS.resolveDiagnosticsMap,
+  sameLookupResult: () => import_chunk_VZBYW6QS.sameLookupResult,
   traverseAst: () => import_chunk_MBTLUWXR.traverseAst,
-  variableDeclarationName: () => import_chunk_Y2ZRISYL.variableDeclarationName,
-  visitReferences: () => import_chunk_Y2ZRISYL.visitReferences,
-  visit_resources: () => import_chunk_Y2ZRISYL.visit_resources,
-  visitorNode: () => import_chunk_Y2ZRISYL.visitorNode
+  variableDeclarationName: () => import_chunk_VZBYW6QS.variableDeclarationName,
+  visitReferences: () => import_chunk_VZBYW6QS.visitReferences,
+  visit_resources: () => import_chunk_VZBYW6QS.visit_resources,
+  visitorNode: () => import_chunk_VZBYW6QS.visitorNode
 });
 module.exports = __toCommonJS(api_exports);
-var import_chunk_Y2ZRISYL = require("./chunk-Y2ZRISYL.cjs");
+var import_chunk_VZBYW6QS = require("./chunk-VZBYW6QS.cjs");
 var import_chunk_SG7ODKRM = require("./chunk-SG7ODKRM.cjs");
 var import_chunk_MBTLUWXR = require("./chunk-MBTLUWXR.cjs");
 var import_chunk_ABYVSU2C = require("./chunk-ABYVSU2C.cjs");
-(0, import_chunk_Y2ZRISYL.init_api)();
+(0, import_chunk_VZBYW6QS.init_api)();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   checkCompilerVersion,

package/build/{chunk-Y2ZRISYL.cjs → chunk-VZBYW6QS.cjs}

@@ -26,8 +26,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var chunk_Y2ZRISYL_exports = {};
-__export(chunk_Y2ZRISYL_exports, {
+var chunk_VZBYW6QS_exports = {};
+__export(chunk_VZBYW6QS_exports, {
   EnumTagsConst: () => EnumTagsConst,
   LastTypeTag: () => LastTypeTag,
   ObjectLikeTagsConst: () => ObjectLikeTagsConst,
@@ -37,6 +37,7 @@ __export(chunk_Y2ZRISYL_exports, {
   TruthyTypes: () => TruthyTypes,
   analyze: () => analyze,
   appSupport: () => appSupport,
+  buildConfigDescription: () => buildConfigDescription,
   buildOptimizedProject: () => buildOptimizedProject,
   checkCompilerVersion: () => checkCompilerVersion,
   collectNamespaces: () => collectNamespaces,
@@ -133,7 +134,7 @@ __export(chunk_Y2ZRISYL_exports, {
   visitorNode: () => visitorNode,
   xml_util_exports: () => xml_util_exports
 });
-module.exports = __toCommonJS(chunk_Y2ZRISYL_exports);
+module.exports = __toCommonJS(chunk_VZBYW6QS_exports);
 var import_chunk_SG7ODKRM = require("./chunk-SG7ODKRM.cjs");
 var import_chunk_MBTLUWXR = require("./chunk-MBTLUWXR.cjs");
 var import_chunk_ABYVSU2C = require("./chunk-ABYVSU2C.cjs");
@@ -5560,10 +5561,289 @@ var init_function_info = (0, import_chunk_ABYVSU2C.__esm)({
     (0, import_chunk_MBTLUWXR.init_ast)();
   }
 });
+var buildConfigDescription;
+var init_build_config = (0, import_chunk_ABYVSU2C.__esm)({
+  "src/build-config.ts"() {
+    "use strict";
+    buildConfigDescription = [
+      {
+        title: "Optimizer",
+        type: "object",
+        properties: {
+          outputPath: {
+            type: "string",
+            description: "Path to where the optimized project should be generated.",
+            default: "bin/optimized",
+            scope: "resource"
+          },
+          extraExcludes: {
+            type: "string",
+            markdownDescription: "[Semicolon separated list of excludeAnnotations to add or remove](https://github.com/markw65/monkeyc-optimizer/wiki/The-extraExcludes-Option)",
+            default: "",
+            scope: "resource"
+          },
+          ignoredExcludeAnnotations: {
+            type: "string",
+            description: "Semicolon separated list of excludeAnnotations to ignore, or `*' to ignore all",
+            default: "",
+            scope: "resource"
+          },
+          ignoredAnnotations: {
+            type: "string",
+            description: "Semicolon separated list of annotations to ignore, or `*' to ignore all",
+            default: "",
+            scope: "resource"
+          },
+          ignoredSourcePaths: {
+            type: "string",
+            description: "Regex of source paths to ignore.",
+            default: "",
+            scope: "resource"
+          },
+          typeCheckLevel: {
+            type: "string",
+            description: "Unless set to 'Default', overrides the corresponding `monkeyC' setting.",
+            taskDescription: "If present, overrides the corresponding `monkeyC' setting.",
+            launchDescription: "If present, overrides the corresponding `monkeyC' setting.",
+            default: "Off",
+            enum: ["Off", "Default", "Gradual", "Informative", "Strict"],
+            enumDescriptions: [
+              "Disable type checking",
+              "Inherit the Garmin Extension's typeCheckLevel",
+              "Type match failures are marked as errors, but ambiguity is ignored",
+              "Type match failures are marked as errors, and ambiguity is marked as a warning",
+              "Type match failures and ambiguity are marked as errors"
+            ],
+            scope: "resource"
+          },
+          checkInvalidSymbols: {
+            type: "string",
+            description: "Whether to check for invalid symbols, and how to report them",
+            enum: ["OFF", "INFO", "WARNING", "ERROR"],
+            enumDescriptions: [
+              "Disable checking",
+              "Generate INFO level diagnostics",
+              "Generate WARNING level diagnostics",
+              "Generate ERROR level diagnostics"
+            ],
+            default: "WARNING",
+            scope: "resource"
+          },
+          checkTypes: {
+            type: "string",
+            description: "Whether to check for type related issues, and how to report them",
+            enum: ["OFF", "INFO", "WARNING", "ERROR"],
+            enumDescriptions: [
+              "Disable checking",
+              "Generate INFO level diagnostics",
+              "Generate WARNING level diagnostics",
+              "Generate ERROR level diagnostics"
+            ],
+            default: "WARNING",
+            scope: "resource"
+          },
+          trustDeclaredTypes: {
+            order: 10,
+            type: "boolean",
+            markdownDescription: "[Whether to rely on type declarations when optimizing](https://github.com/markw65/monkeyc-optimizer/wiki/Type-and-Dataflow-analysis#trust-declared-types)",
+            default: true,
+            scope: "resource"
+          },
+          propagateTypes: {
+            order: 11,
+            type: "boolean",
+            markdownDescription: "[Whether to propagate type information, or process it locally](https://github.com/markw65/monkeyc-optimizer/wiki/Type-and-Dataflow-analysis#propagate-types)",
+            default: true,
+            scope: "resource"
+          },
+          sizeBasedPRE: {
+            order: 11,
+            type: "boolean",
+            markdownDescription: "[Whether to enable the size based partial redundancy pass](https://github.com/markw65/monkeyc-optimizer/wiki/Type-and-Dataflow-analysis#size-based-pre)",
+            default: true,
+            scope: "resource"
+          },
+          minimizeLocals: {
+            order: 12,
+            type: "boolean",
+            markdownDescription: "[Whether to enable the minimize locals pass](https://github.com/markw65/monkeyc-optimizer/wiki/Local-variable-elimination#minimize-locals)",
+            default: true,
+            scope: "resource"
+          },
+          singleUseCopyProp: {
+            order: 12,
+            type: "boolean",
+            markdownDescription: "[Whether to enable the single use copy propagation pass](https://github.com/markw65/monkeyc-optimizer/wiki/Local-variable-elimination#single-use-copy-propagation)",
+            default: true,
+            scope: "resource"
+          },
+          minimizeModules: {
+            order: 12,
+            type: "boolean",
+            markdownDescription: "[Whether to enable the minimize modules pass](https://github.com/markw65/monkeyc-optimizer/wiki/Optimizing-module-imports#minimize-modules)",
+            default: true,
+            scope: "resource"
+          },
+          iterateOptimizer: {
+            order: 12,
+            type: "boolean",
+            description: "Whether to keep running the optimizer pass until it makes no further changes (may be slow)",
+            default: false,
+            scope: "resource"
+          },
+          enforceStatic: {
+            type: "string",
+            description: "Whether to perform lookups in static methods as if they were invoked statically",
+            enum: ["NO", "YES"],
+            enumDescriptions: [
+              "Assume static functions may be invoked non-statically",
+              "Assume static functions will always be invoked statically"
+            ],
+            default: "YES",
+            scope: "resource"
+          },
+          compilerLookupRules: {
+            type: "string",
+            description: "Whether to perform lookups as compiler1, compiler2, or based on the currently selected sdk",
+            enum: ["COMPILER1", "COMPILER2", "DEFAULT"],
+            enumDescriptions: [
+              "Match compiler1's behavior when performing lookups",
+              "Match compiler2's behavior when performing lookups",
+              "Match the currently selected compiler's behavior"
+            ],
+            default: "DEFAULT",
+            scope: "resource"
+          },
+          checkCompilerLookupRules: {
+            type: "string",
+            description: "Whether to report differences in your code's behavior between compiler1 and compiler2",
+            enum: ["OFF", "INFO", "WARNING", "ERROR"],
+            enumDescriptions: [
+              "Disable checking",
+              "Generate INFO level diagnostics",
+              "Generate WARNING level diagnostics",
+              "Generate ERROR level diagnostics"
+            ],
+            default: "WARNING",
+            scope: "resource"
+          },
+          useLocalOptimizer: {
+            type: "boolean",
+            description: "Whether to use a locally installed @markw65/monkeyc-optimizer for builds",
+            default: true,
+            scope: "resource"
+          }
+        }
+      },
+      {
+        title: "Post Build Optimizer",
+        type: "object",
+        properties: {
+          postBuildOptimizer: {
+            title: "Enable",
+            order: 0,
+            type: "boolean",
+            description: "Whether to enable the post build optimizer",
+            default: false,
+            scope: "resource"
+          },
+          removeArgc: {
+            order: 1,
+            type: "boolean",
+            markdownDescription: "[Whether to remove argc bytecodes](https://github.com/markw65/monkeyc-optimizer/wiki/Post-Build-Optimizer#remove-argc). Does not apply to exports",
+            default: false,
+            scope: "resource"
+          },
+          allowForbiddenOpts: {
+            order: 2,
+            type: "boolean",
+            markdownDescription: "[Whether to perform optimizations no longer allowed on the app store](https://github.com/markw65/monkeyc-optimizer/wiki/Post-Build-Optimizer#allow-forbidden-optimizations). Always false for exports",
+            default: false,
+            scope: "resource"
+          },
+          postBuildPRE: {
+            order: 3,
+            type: "boolean",
+            markdownDescription: "Post Build Size based PRE [similar to the source-to-source pass](https://github.com/markw65/monkeyc-optimizer/wiki/Type-and-Dataflow-analysis#size-based-pre)",
+            default: true,
+            scope: "resource"
+          }
+        }
+      },
+      {
+        title: "OnlyTasks",
+        type: "object",
+        properties: {
+          device: {
+            type: "string",
+            taskDescription: "The device to build for. The special value `export' will do an iq build into bin/export, and the value `choose' will let you pick the device from a list",
+            launchDescription: "Device to run or 'choose' or '${command:GetTargetDevice}' to choose a new device each run.",
+            scope: "tasks_launch"
+          },
+          releaseBuild: {
+            type: "boolean",
+            taskDescription: "Is this a release build.",
+            launchDescription: "Run a release build.",
+            scope: "tasks_launch"
+          },
+          runTests: {
+            type: "boolean",
+            description: "run test cases.",
+            default: false,
+            scope: "launch"
+          },
+          jungleFiles: {
+            type: "string",
+            description: "If present, overrides the corresponding `monkeyC' setting.",
+            scope: "tasks_launch"
+          },
+          developerKeyPath: {
+            type: "string",
+            description: "If present, overrides the corresponding `monkeyC' setting.",
+            scope: "tasks_launch"
+          },
+          optimizationLevel: {
+            type: "string",
+            description: "If present, overrides the corresponding `monkeyC' setting.",
+            enum: ["None", "Basic", "Fast", "Slow"],
+            enumDescriptions: [
+              "No optimization",
+              "Basic optimizations for building in debug",
+              "Fast optimizations for building in release",
+              "Slow optimizations that need more time"
+            ],
+            scope: "tasks_launch"
+          },
+          compilerOptions: {
+            type: "string",
+            description: "If present, overrides the corresponding `monkeyC' setting.",
+            scope: "tasks_launch"
+          },
+          compilerWarnings: {
+            type: "boolean",
+            description: "If present, overrides the corresponding `monkeyC' setting.",
+            scope: "tasks_launch"
+          },
+          simulatorBuild: {
+            type: "boolean",
+            description: "Is this build for the simulator.",
+            scope: "tasks"
+          },
+          testBuild: {
+            type: "boolean",
+            description: "Is this a test build.",
+            scope: "tasks"
+          }
+        }
+      }
+    ];
+  }
+});
 var StateNodeAttributes;
 var init_optimizer_types = (0, import_chunk_ABYVSU2C.__esm)({
   "src/optimizer-types.ts"() {
     "use strict";
+    init_build_config();
     StateNodeAttributes = /* @__PURE__ */ ((StateNodeAttributes2) => {
       StateNodeAttributes2[StateNodeAttributes2["NONE"] = 0] = "NONE";
       StateNodeAttributes2[StateNodeAttributes2["PUBLIC"] = 1] = "PUBLIC";
@@ -28677,32 +28957,56 @@ async function getVSCodeSettings(path7) {
     return {};
   }
 }
+async function getCodeWorkspaceSettings(folder) {
+  let curDir = folder;
+  try {
+    while (curDir) {
+      const code_workspaces = await (0, import_chunk_SG7ODKRM.globa)(
+        path4.resolve(curDir, "*.code-workspace"),
+        { onlyFiles: true }
+      );
+      if (code_workspaces.length === 1) {
+        const contents = await fs6.readFile(code_workspaces[0], "utf-8");
+        const code_workspace = JSON.parse(contents);
+        if (Array.isArray(code_workspace.folders) && code_workspace.settings && code_workspace.folders.some(
+          (workspace) => path4.resolve(curDir, workspace.path) === folder
+        )) {
+          return code_workspace.settings;
+        }
+        break;
+      }
+      if (code_workspaces.length > 1)
+        break;
+      const next = path4.dirname(curDir);
+      if (next === curDir)
+        break;
+      curDir = next;
+    }
+  } catch (ex) {
+  }
+  return {};
+}
 function isErrorWithLocation(e) {
   return (0, import_chunk_MBTLUWXR.hasProperty)(e, "location");
 }
 function getConfig(options) {
   const config = { ...defaultConfig, ...options || {} };
-  return [
-    "jungleFiles",
-    "developerKeyPath",
-    "typeCheckLevel",
-    "optimizationLevel",
-    "compilerOptions",
-    "compilerWarnings",
-    "ignoredExcludeAnnotations",
-    "ignoredAnnotations",
-    "ignoredSourcePaths"
-  ].reduce((promise, key) => {
+  const defaults = buildConfigDescription.flatMap(
+    (desc) => Object.entries(desc.properties)
+  );
+  return defaults.reduce((promise, [key, info]) => {
     if (key in config)
       return promise;
     return promise.then(
       (v) => v || getVSCodeSettings(`${appSupport}/Code/User/settings.json`).then(
-        (globals) => getVSCodeSettings(
-          `${config.workspace}/.vscode/settings.json`
-        ).then((locals) => ({ ...globals, ...locals }))
+        (globals) => getCodeWorkspaceSettings(config.workspace).then(
+          (workspace) => getVSCodeSettings(
+            `${config.workspace ?? "."}/.vscode/settings.json`
+          ).then((locals) => ({ ...globals, ...workspace, ...locals }))
+        )
       )
     ).then((settings) => {
-      const value2 = settings[`monkeyC.${key}`] || settings[`prettierMonkeyC.${key}`];
+      const value2 = settings[`prettierMonkeyC.${key}`] ?? settings[`monkeyC.${key}`] ?? info.default;
       if (value2 !== void 0) {
         config[key] = value2;
       }
@@ -29218,7 +29522,7 @@ async function generateOneConfig(buildConfig, manifestXML, dependencyFiles, conf
       const opt_time = await (0, import_chunk_SG7ODKRM.first_modified)(
         Object.values(fnMap).map((v) => v.output)
       );
-      if (source_time < opt_time && 1716827034287 < opt_time) {
+      if (source_time < opt_time && 1717017718374 < opt_time) {
         return {
           hasTests,
           diagnostics: prevDiagnostics,
@@ -29257,7 +29561,7 @@ async function generateOneConfig(buildConfig, manifestXML, dependencyFiles, conf
             hasTests: hasTests2,
             diagnostics,
             sdkVersion,
-            optimizerVersion: "1.1.63",
+            optimizerVersion: "1.1.64",
             ...Object.fromEntries(
               configOptionsToCheck.map((option) => [option, config[option]])
             )
@@ -29408,6 +29712,7 @@ var init_optimizer = (0, import_chunk_ABYVSU2C.__esm)({
   "src/optimizer.ts"() {
     init_api();
     init_build();
+    init_build_config();
     init_jungles();
     init_launch();
     init_manifest();
@@ -30105,6 +30410,7 @@ var init_sdk_util = (0, import_chunk_ABYVSU2C.__esm)({
   TruthyTypes,
   analyze,
   appSupport,
+  buildConfigDescription,
   buildOptimizedProject,
   checkCompilerVersion,
   collectNamespaces,

package/build/optimizer.cjs

@@ -18,31 +18,33 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var optimizer_exports = {};
 __export(optimizer_exports, {
-  StateNodeAttributes: () => import_chunk_Y2ZRISYL.StateNodeAttributes,
-  buildOptimizedProject: () => import_chunk_Y2ZRISYL.buildOptimizedProject,
+  StateNodeAttributes: () => import_chunk_VZBYW6QS.StateNodeAttributes,
+  buildConfigDescription: () => import_chunk_VZBYW6QS.buildConfigDescription,
+  buildOptimizedProject: () => import_chunk_VZBYW6QS.buildOptimizedProject,
   copyRecursiveAsNeeded: () => import_chunk_SG7ODKRM.copyRecursiveAsNeeded,
-  defaultConfig: () => import_chunk_Y2ZRISYL.defaultConfig,
-  display: () => import_chunk_Y2ZRISYL.display,
-  generateOneConfig: () => import_chunk_Y2ZRISYL.generateOneConfig,
-  generateOptimizedProject: () => import_chunk_Y2ZRISYL.generateOptimizedProject,
-  getConfig: () => import_chunk_Y2ZRISYL.getConfig,
-  getProjectAnalysis: () => import_chunk_Y2ZRISYL.getProjectAnalysis,
-  get_jungle: () => import_chunk_Y2ZRISYL.get_jungle,
-  isErrorWithLocation: () => import_chunk_Y2ZRISYL.isErrorWithLocation,
-  launchSimulator: () => import_chunk_Y2ZRISYL.launchSimulator,
-  manifestProducts: () => import_chunk_Y2ZRISYL.manifestProducts,
-  mctree: () => import_chunk_Y2ZRISYL.mctree,
-  simulateProgram: () => import_chunk_Y2ZRISYL.simulateProgram
+  defaultConfig: () => import_chunk_VZBYW6QS.defaultConfig,
+  display: () => import_chunk_VZBYW6QS.display,
+  generateOneConfig: () => import_chunk_VZBYW6QS.generateOneConfig,
+  generateOptimizedProject: () => import_chunk_VZBYW6QS.generateOptimizedProject,
+  getConfig: () => import_chunk_VZBYW6QS.getConfig,
+  getProjectAnalysis: () => import_chunk_VZBYW6QS.getProjectAnalysis,
+  get_jungle: () => import_chunk_VZBYW6QS.get_jungle,
+  isErrorWithLocation: () => import_chunk_VZBYW6QS.isErrorWithLocation,
+  launchSimulator: () => import_chunk_VZBYW6QS.launchSimulator,
+  manifestProducts: () => import_chunk_VZBYW6QS.manifestProducts,
+  mctree: () => import_chunk_VZBYW6QS.mctree,
+  simulateProgram: () => import_chunk_VZBYW6QS.simulateProgram
 });
 module.exports = __toCommonJS(optimizer_exports);
-var import_chunk_Y2ZRISYL = require("./chunk-Y2ZRISYL.cjs");
+var import_chunk_VZBYW6QS = require("./chunk-VZBYW6QS.cjs");
 var import_chunk_SG7ODKRM = require("./chunk-SG7ODKRM.cjs");
 var import_chunk_MBTLUWXR = require("./chunk-MBTLUWXR.cjs");
 var import_chunk_ABYVSU2C = require("./chunk-ABYVSU2C.cjs");
-(0, import_chunk_Y2ZRISYL.init_optimizer)();
+(0, import_chunk_VZBYW6QS.init_optimizer)();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   StateNodeAttributes,
+  buildConfigDescription,
   buildOptimizedProject,
   copyRecursiveAsNeeded,
   defaultConfig,

package/build/sdk-util.cjs

@@ -18,25 +18,25 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var sdk_util_exports = {};
 __export(sdk_util_exports, {
-  SectionKinds: () => import_chunk_Y2ZRISYL.SectionKinds,
-  appSupport: () => import_chunk_Y2ZRISYL.appSupport,
-  connectiq: () => import_chunk_Y2ZRISYL.connectiq,
-  getDeviceInfo: () => import_chunk_Y2ZRISYL.getDeviceInfo,
-  getFunctionDocumentation: () => import_chunk_Y2ZRISYL.getFunctionDocumentation,
-  getLanguages: () => import_chunk_Y2ZRISYL.getLanguages,
-  getSdkPath: () => import_chunk_Y2ZRISYL.getSdkPath,
-  isWin: () => import_chunk_Y2ZRISYL.isWin,
-  optimizeProgram: () => import_chunk_Y2ZRISYL.optimizeProgram,
-  readPrg: () => import_chunk_Y2ZRISYL.readPrg,
-  readPrgWithOffsets: () => import_chunk_Y2ZRISYL.readPrgWithOffsets,
-  xmlUtil: () => import_chunk_Y2ZRISYL.xml_util_exports
+  SectionKinds: () => import_chunk_VZBYW6QS.SectionKinds,
+  appSupport: () => import_chunk_VZBYW6QS.appSupport,
+  connectiq: () => import_chunk_VZBYW6QS.connectiq,
+  getDeviceInfo: () => import_chunk_VZBYW6QS.getDeviceInfo,
+  getFunctionDocumentation: () => import_chunk_VZBYW6QS.getFunctionDocumentation,
+  getLanguages: () => import_chunk_VZBYW6QS.getLanguages,
+  getSdkPath: () => import_chunk_VZBYW6QS.getSdkPath,
+  isWin: () => import_chunk_VZBYW6QS.isWin,
+  optimizeProgram: () => import_chunk_VZBYW6QS.optimizeProgram,
+  readPrg: () => import_chunk_VZBYW6QS.readPrg,
+  readPrgWithOffsets: () => import_chunk_VZBYW6QS.readPrgWithOffsets,
+  xmlUtil: () => import_chunk_VZBYW6QS.xml_util_exports
 });
 module.exports = __toCommonJS(sdk_util_exports);
-var import_chunk_Y2ZRISYL = require("./chunk-Y2ZRISYL.cjs");
+var import_chunk_VZBYW6QS = require("./chunk-VZBYW6QS.cjs");
 var import_chunk_SG7ODKRM = require("./chunk-SG7ODKRM.cjs");
 var import_chunk_MBTLUWXR = require("./chunk-MBTLUWXR.cjs");
 var import_chunk_ABYVSU2C = require("./chunk-ABYVSU2C.cjs");
-(0, import_chunk_Y2ZRISYL.init_sdk_util)();
+(0, import_chunk_VZBYW6QS.init_sdk_util)();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   SectionKinds,

package/build/src/build-config.d.ts

@@ -0,0 +1,83 @@
+export type DiagnosticType = "ERROR" | "WARNING" | "INFO";
+export type LookupRules = "COMPILER1" | "COMPILER2" | "DEFAULT";
+export type EnforceStatic = "YES" | "NO";
+export type BuildConfig = {
+    workspace?: string;
+    jungleFiles?: string;
+    developerKeyPath?: string;
+    typeCheckLevel?: "Off" | "Default" | "Gradual" | "Informative" | "Strict";
+    optimizationLevel?: "None" | "Basic" | "Fast" | "Slow";
+    compilerOptions?: string;
+    compilerWarnings?: boolean;
+    simulatorBuild?: boolean;
+    releaseBuild?: boolean;
+    testBuild?: boolean;
+    products?: string[];
+    buildDir?: string;
+    outputPath?: string;
+    program?: string;
+    skipOptimization?: boolean;
+    checkManifest?: boolean;
+    device?: string;
+    extraExcludes?: string;
+    ignoredExcludeAnnotations?: string;
+    ignoredAnnotations?: string;
+    ignoredSourcePaths?: string;
+    returnCommand?: boolean;
+    checkBuildPragmas?: boolean;
+    checkInvalidSymbols?: DiagnosticType | "OFF";
+    checkCompilerLookupRules?: DiagnosticType | "OFF";
+    compilerLookupRules?: LookupRules;
+    enforceStatic?: EnforceStatic;
+    sizeBasedPRE?: boolean | string;
+    prettier?: Record<string, unknown>;
+    extensionVersion?: string;
+    useLocalOptimizer?: boolean;
+    propagateTypes?: boolean;
+    trustDeclaredTypes?: boolean;
+    minimizeLocals?: boolean;
+    minimizeModules?: boolean;
+    postBuildOptimizer?: boolean;
+    singleUseCopyProp?: boolean;
+    iterateOptimizer?: boolean;
+    covarianceWarnings?: boolean;
+    checkTypes?: DiagnosticType | "OFF";
+    removeArgc?: boolean;
+    postBuildPRE?: boolean;
+    allowForbiddenOpts?: boolean;
+    runTests?: boolean;
+};
+interface BuildConfigEntryBase {
+    title?: string;
+    type: string;
+    description?: string;
+    taskDescription?: string;
+    launchDescription?: string;
+    markdownDescription?: string;
+    order?: number;
+    scope: "application" | "machine" | "machine-overridable" | "window" | "resource" | "tasks" | "launch" | "tasks_launch" | "language-overridable";
+}
+interface BuildConfigEntryBoolean extends BuildConfigEntryBase {
+    type: "boolean";
+    default?: boolean;
+}
+interface BuildConfigEntryString extends BuildConfigEntryBase {
+    type: "string";
+    default?: string;
+}
+interface BuildConfigEntryEnum<V> extends BuildConfigEntryBase {
+    type: "string";
+    default?: string;
+    enum: readonly V[];
+    enumDescriptions?: readonly string[];
+}
+type BuildConfigEntry<V> = boolean extends V ? BuildConfigEntryBoolean : [V] extends [string] ? [string] extends [V] ? BuildConfigEntryString : BuildConfigEntryEnum<V> : never;
+type BuildConfigDescription = {
+    title: string;
+    type: "object";
+    properties: {
+        [K in keyof BuildConfig]?: BuildConfigEntry<NonNullable<BuildConfig[K]>>;
+    };
+};
+export declare const buildConfigDescription: readonly BuildConfigDescription[];
+export {};

package/build/src/optimizer-types.d.ts

@@ -1,54 +1,8 @@
 import { mctree } from "@markw65/prettier-plugin-monkeyc";
+import { BuildConfig, DiagnosticType, LookupRules } from "./build-config";
 import { xmlUtil } from "./sdk-util";
 import { ExactOrUnion } from "./type-flow/types";
-export type DiagnosticType = "ERROR" | "WARNING" | "INFO";
-export type LookupRules = "COMPILER1" | "COMPILER2" | "DEFAULT";
-export type EnforceStatic = "YES" | "NO";
-export type BuildConfig = {
-    workspace?: string;
-    jungleFiles?: string;
-    developerKeyPath?: string;
-    typeCheckLevel?: string;
-    optimizationLevel?: string;
-    compilerOptions?: string;
-    compilerWarnings?: boolean;
-    simulatorBuild?: boolean;
-    releaseBuild?: boolean;
-    testBuild?: boolean;
-    products?: string[];
-    buildDir?: string;
-    outputPath?: string;
-    program?: string;
-    skipOptimization?: boolean;
-    checkManifest?: boolean;
-    device?: string;
-    extraExcludes?: string;
-    ignoredExcludeAnnotations?: string;
-    ignoredAnnotations?: string;
-    ignoredSourcePaths?: string;
-    returnCommand?: boolean;
-    checkBuildPragmas?: boolean;
-    checkInvalidSymbols?: DiagnosticType | "OFF";
-    checkCompilerLookupRules?: DiagnosticType | "OFF";
-    compilerLookupRules?: LookupRules;
-    enforceStatic?: EnforceStatic;
-    sizeBasedPRE?: boolean | string;
-    prettier?: Record<string, unknown>;
-    extensionVersion?: string;
-    useLocalOptimizer?: boolean;
-    propagateTypes?: boolean;
-    trustDeclaredTypes?: boolean;
-    minimizeLocals?: boolean;
-    minimizeModules?: boolean;
-    postBuildOptimizer?: boolean;
-    singleUseCopyProp?: boolean;
-    iterateOptimizer?: boolean;
-    covarianceWarnings?: boolean;
-    checkTypes?: DiagnosticType | "OFF";
-    removeArgc?: boolean;
-    postBuildPRE?: boolean;
-    allowForbiddenOpts?: boolean;
-};
+export { BuildConfig, DiagnosticType };
 export type StateNodeDecl = StateNode | mctree.EnumStringMember | mctree.TypedIdentifier;
 export type StateNodeDecls = {
     [key: string]: StateNodeDecl[];
@@ -250,4 +204,3 @@ export type FilesToOptimizeMap = {
         hasTests?: boolean;
     };
 };
-export {};

package/build/src/optimizer.d.ts

@@ -1,4 +1,5 @@
 import { mctree } from "@markw65/prettier-plugin-monkeyc";
+import { buildConfigDescription } from "./build-config";
 import { JungleBuildDependencies, JungleError, JungleQualifier, JungleResourceMap, ResolvedJungle, Target, get_jungle } from "./jungles";
 import { launchSimulator, simulateProgram } from "./launch";
 import { manifestProducts } from "./manifest";
@@ -8,7 +9,7 @@ import { TypeMap } from "./type-flow/interp";
 import { copyRecursiveAsNeeded } from "./util";
 export * from "./optimizer-types";
 export { ExactOrUnion, display } from "./type-flow/types";
-export { JungleBuildDependencies, JungleError, JungleResourceMap, ResolvedJungle, TypeMap, copyRecursiveAsNeeded, get_jungle, launchSimulator, manifestProducts, mctree, simulateProgram, };
+export { JungleBuildDependencies, JungleError, JungleResourceMap, ResolvedJungle, TypeMap, buildConfigDescription, copyRecursiveAsNeeded, get_jungle, launchSimulator, manifestProducts, mctree, simulateProgram, };
 export declare const defaultConfig: {
     outputPath: string;
     workspace: string;

package/build/worker-thread.cjs

@@ -21,17 +21,17 @@ __export(worker_thread_exports, {
   default: () => worker_thread_default
 });
 module.exports = __toCommonJS(worker_thread_exports);
-var import_chunk_Y2ZRISYL = require("./chunk-Y2ZRISYL.cjs");
+var import_chunk_VZBYW6QS = require("./chunk-VZBYW6QS.cjs");
 var import_chunk_SG7ODKRM = require("./chunk-SG7ODKRM.cjs");
 var import_chunk_MBTLUWXR = require("./chunk-MBTLUWXR.cjs");
 var import_chunk_ABYVSU2C = require("./chunk-ABYVSU2C.cjs");
 var import_node_worker_threads = require("node:worker_threads");
 var require_worker_thread = (0, import_chunk_ABYVSU2C.__commonJS)({
   "src/worker-thread.ts"() {
-    (0, import_chunk_Y2ZRISYL.init_worker_task)();
+    (0, import_chunk_VZBYW6QS.init_worker_task)();
     if (import_node_worker_threads.parentPort) {
       import_node_worker_threads.parentPort.on("message", async (task) => {
-        return import_node_worker_threads.parentPort.postMessage(await (0, import_chunk_Y2ZRISYL.performTask)(task));
+        return import_node_worker_threads.parentPort.postMessage(await (0, import_chunk_VZBYW6QS.performTask)(task));
       });
     }
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@markw65/monkeyc-optimizer",
   "type": "commonjs",
-  "version": "1.1.63",
+  "version": "1.1.64",
   "description": "Source to source optimizer for Garmin Monkey C code",
   "main": "build/optimizer.cjs",
   "types": "build/src/optimizer.d.ts",