brighterscript 1.0.0-alpha.52 → 1.0.0-alpha.53

package/README.md

@@ -186,9 +186,11 @@ The presence of a `bsconfig.json` file in a directory indicates that the directo
         "**/*"
     ],
     "outDir": "out",
-    //this flag tells BrighterScript that for every xml file, try to import a .bs file with the same name and location
-    "autoImportComponentScript": true,
-    "sourceMap": true
+    "compilerOptions": {
+        //this flag tells BrighterScript that for every xml file, try to import a .bs file with the same name and location
+        "autoImportComponentScript": true,
+        "sourceMap": true
+    }
 }
 ```
 

package/bsconfig.schema.json

@@ -70,6 +70,8 @@
         },
         "manifest": {
             "description": "A entry to modify manifest values",
+            "deprecated": true,
+            "deprecationMessage": "Deprecated starting in v1. Use `compilerOptions.manifest` instead.",
             "type": "object",
             "properties": {
                 "bs_const": {
@@ -147,11 +149,15 @@
         },
         "sourceMap": {
             "description": "Enables generating sourcemap files, which allow debugging tools to show the original source code while running the emitted files.",
+            "deprecated": true,
+            "deprecationMessage": "Deprecated starting in v1. Use `compilerOptions.sourceMap` instead.",
             "type": "boolean",
             "default": false
         },
         "relativeSourceMaps": {
             "description": "If true, source file paths in generated sourcemaps will be relative to the map file location instead of absolute. This makes sourcemaps portable across different machines and environments.",
+            "deprecated": true,
+            "deprecationMessage": "Deprecated starting in v1. Use `compilerOptions.relativeSourceMaps` instead.",
             "type": "boolean",
             "default": false
         },
@@ -258,16 +264,22 @@
         },
         "emitFullPaths": {
             "description": "Emit full paths to files when printing diagnostics to the console.",
+            "deprecated": true,
+            "deprecationMessage": "Deprecated starting in v1. Use `compilerOptions.emitFullPaths` instead.",
             "type": "boolean",
             "default": false
         },
         "emitDefinitions": {
             "description": "Emit type definition files (`d.bs`) during transpile",
+            "deprecated": true,
+            "deprecationMessage": "Deprecated starting in v1. Use `compilerOptions.emitDefinitions` instead.",
             "type": "boolean",
             "default": false
         },
         "removeParameterTypes": {
             "description": "Removes the explicit type to function's parameters and return (i.e. the `as type` syntax) ",
+            "deprecated": true,
+            "deprecationMessage": "Deprecated starting in v1. Use `compilerOptions.removeParameterTypes` instead.",
             "type": "boolean",
             "default": false
         },
@@ -343,6 +355,8 @@
         },
         "autoImportComponentScript": {
             "description": "When enabled, every xml component will search for a .bs or .brs file with the same name in the same folder, and add it as a script import if found. Disabled by default",
+            "deprecated": true,
+            "deprecationMessage": "Deprecated starting in v1. Use `compilerOptions.autoImportComponentScript` instead.",
             "type": "boolean",
             "default": false
         },
@@ -361,10 +375,14 @@
         },
         "sourceRoot": {
             "description": "Override the root directory path where debugger should locate the source files. The location will be embedded in the source map to help debuggers locate the original source files. This only applies to files found within rootDir. This is useful when you want to preprocess files before passing them to BrighterScript, and want a debugger to open the original files. This option also affects the `SOURCE_FILE_PATH` and `SOURCE_LOCATION` source literals.",
+            "deprecated": true,
+            "deprecationMessage": "Deprecated starting in v1. Use `compilerOptions.sourceRoot` instead.",
             "type": "string"
         },
         "resolveSourceRoot": {
             "description": "Should the `sourceRoot` property be resolve to an absolute path (relative to the bsconfig it's defined in)",
+            "deprecated": true,
+            "deprecationMessage": "Deprecated starting in v1. Use `compilerOptions.resolveSourceRoot` instead.",
             "type": "boolean",
             "default": false
         },
@@ -396,21 +414,154 @@
         },
         "allowBrighterScriptInBrightScript": {
             "description": "Allow brighterscript features (classes, interfaces, etc...) to be included in BrightScript (`.brs`) files, and force those files to be transpiled.",
+            "deprecated": true,
+            "deprecationMessage": "Deprecated starting in v1. Use `compilerOptions.allowBrighterScriptInBrightScript` instead.",
             "type": "boolean",
             "default": false
         },
         "legacyCallfuncHandling": {
             "description": "Legacy RokuOS versions required at least one argument in callfunc() invocations. Previous brighterscript versions handled this by inserting invalid as an argument when no other args are present. This is not necessary in modern RokuOS versions.",
+            "deprecated": true,
+            "deprecationMessage": "Deprecated starting in v1. Use `compilerOptions.legacyCallfuncHandling` instead.",
             "type": "boolean",
             "default": false
         },
         "minFirmwareVersion": {
             "description": "The minimum Roku firmware version required to run this project. When set, BrightScript (.brs) files will be validated to ensure they only use language features available in that firmware version or earlier. BrighterScript (.bs) files are always allowed to use all features since they are transpiled. Should be a semver-compatible string (e.g. \"11.0.0\").",
+            "deprecated": true,
+            "deprecationMessage": "Deprecated starting in v1. Use `compilerOptions.minFirmwareVersion` instead.",
             "type": "string",
             "examples": [
                 "11.0.0",
                 "12.0.0"
             ]
+        },
+        "strict": {
+            "description": "Enables a set of stricter type-checking rules and language features. When set, this acts as a default value for other `strict`-related options. Defaults to false.",
+            "deprecated": true,
+            "deprecationMessage": "Deprecated starting in v1. Use `compilerOptions.strict` instead.",
+            "type": "boolean",
+            "default": false
+        },
+        "strictCallFunc": {
+            "description": "Enables stricter type-checking for callfunc() invocations. When true, callfunc() invocations will not be allowed on generic Node types. Defaults to false.",
+            "deprecated": true,
+            "deprecationMessage": "Deprecated starting in v1. Use `compilerOptions.strictCallFunc` instead.",
+            "type": "boolean",
+            "default": false
+        },
+        "strictNodeMembers": {
+            "description": "Enables stricter type-checking for Node members. When true, unknown members on Node types will be treated as errors instead of dynamic values. Defaults to false.",
+            "deprecated": true,
+            "deprecationMessage": "Deprecated starting in v1. Use `compilerOptions.strictNodeMembers` instead.",
+            "type": "boolean",
+            "default": false
+        },
+        "compilerOptions": {
+            "description": "Options that control how BrighterScript interprets, validates, and compiles your code (as opposed to the top-level options, which control project structure, file discovery, and tooling/reporting behavior). Similar in spirit to TypeScript's `compilerOptions`. If an option is set both here and at the top level (deprecated location), the value here wins.",
+            "type": "object",
+            "properties": {
+                "allowBrighterScriptInBrightScript": {
+                    "description": "Allow brighterscript features (classes, interfaces, etc...) to be included in BrightScript (`.brs`) files, and force those files to be transpiled.",
+                    "type": "boolean",
+                    "default": false
+                },
+                "autoImportComponentScript": {
+                    "description": "When enabled, every xml component will search for a .bs or .brs file with the same name in the same folder, and add it as a script import if found. Disabled by default",
+                    "type": "boolean",
+                    "default": false
+                },
+                "bslibDestinationDir": {
+                    "description": "Override the destination directory for the bslib.brs file. Use this if you want to customize where the bslib.brs file is located in the staging directory. Note that using a location outside of `source` will break scripts inside `source` that depend on bslib.brs. Defaults to `source`.",
+                    "type": "string",
+                    "default": "source"
+                },
+                "emitDefinitions": {
+                    "description": "Emit type definition files (`d.bs`) during transpile",
+                    "type": "boolean",
+                    "default": false
+                },
+                "emitFullPaths": {
+                    "description": "Emit full paths to files when printing diagnostics to the console.",
+                    "type": "boolean",
+                    "default": false
+                },
+                "legacyCallfuncHandling": {
+                    "description": "Legacy RokuOS versions required at least one argument in callfunc() invocations. Previous brighterscript versions handled this by inserting invalid as an argument when no other args are present. This is not necessary in modern RokuOS versions.",
+                    "type": "boolean",
+                    "default": false
+                },
+                "manifest": {
+                    "description": "A entry to modify manifest values",
+                    "type": "object",
+                    "properties": {
+                        "bs_const": {
+                            "description": "A dictionary of bs_consts to change or add to the manifest. Each entry ",
+                            "type": "object",
+                            "patternProperties": {
+                                "^.+$": {
+                                    "type": [
+                                        "boolean",
+                                        "null"
+                                    ]
+                                }
+                            }
+                        }
+                    }
+                },
+                "minFirmwareVersion": {
+                    "description": "The minimum Roku firmware version required to run this project. When set, BrightScript (.brs) files will be validated to ensure they only use language features available in that firmware version or earlier. BrighterScript (.bs) files are always allowed to use all features since they are transpiled. Should be a semver-compatible string (e.g. \"11.0.0\").",
+                    "type": "string",
+                    "examples": [
+                        "11.0.0",
+                        "12.0.0"
+                    ]
+                },
+                "pruneEmptyCodeFiles": {
+                    "description": "Excludes empty files from being included in the output. Some Brighterscript files are left empty or with only comments after transpilation to Brightscript. The default behavior is to write these to disk after transpilation. Setting this flag to `true` will prevent empty files being written and will remove associated script tags from XML.",
+                    "type": "boolean",
+                    "default": false
+                },
+                "relativeSourceMaps": {
+                    "description": "If true, source file paths in generated sourcemaps will be relative to the map file location instead of absolute. This makes sourcemaps portable across different machines and environments.",
+                    "type": "boolean",
+                    "default": false
+                },
+                "removeParameterTypes": {
+                    "description": "Removes the explicit type to function's parameters and return (i.e. the `as type` syntax) ",
+                    "type": "boolean",
+                    "default": false
+                },
+                "resolveSourceRoot": {
+                    "description": "Should the `sourceRoot` property be resolve to an absolute path (relative to the bsconfig it's defined in)",
+                    "type": "boolean",
+                    "default": false
+                },
+                "sourceMap": {
+                    "description": "Enables generating sourcemap files, which allow debugging tools to show the original source code while running the emitted files.",
+                    "type": "boolean",
+                    "default": false
+                },
+                "sourceRoot": {
+                    "description": "Override the root directory path where debugger should locate the source files. The location will be embedded in the source map to help debuggers locate the original source files. This only applies to files found within rootDir. This is useful when you want to preprocess files before passing them to BrighterScript, and want a debugger to open the original files. This option also affects the `SOURCE_FILE_PATH` and `SOURCE_LOCATION` source literals.",
+                    "type": "string"
+                },
+                "strict": {
+                    "description": "Enables a set of stricter type-checking rules and language features. When set, this acts as a default value for other `strict`-related options. Defaults to false.",
+                    "type": "boolean",
+                    "default": false
+                },
+                "strictCallFunc": {
+                    "description": "Enables stricter type-checking for callfunc() invocations. When true, callfunc() invocations will not be allowed on generic Node types. Defaults to false.",
+                    "type": "boolean",
+                    "default": false
+                },
+                "strictNodeMembers": {
+                    "description": "Enables stricter type-checking for Node members. When true, unknown members on Node types will be treated as errors instead of dynamic values. Defaults to false.",
+                    "type": "boolean",
+                    "default": false
+                }
+            }
         }
     }
 }

package/dist/BsConfig.d.ts

@@ -9,6 +9,9 @@ export interface BsConfig {
      * Prefix with a question mark (?) to prevent throwing an exception if the file does not exist.
      */
     project?: string;
+    /**
+     * @deprecated Moved to `compilerOptions.manifest`. If both are present, `compilerOptions.manifest` wins.
+     */
     manifest?: {
         bs_const?: Record<string, boolean | null>;
     };
@@ -42,6 +45,18 @@ export interface BsConfig {
      * If true, the files are not copied to outDir.
      */
     noEmit?: boolean;
+    /**
+     * @deprecated packaging is handled outside of `BsConfig`
+     */
+    createPackage?: boolean;
+    /**
+     * @deprecated deployment is handled outside of `BsConfig`
+     */
+    deploy?: boolean;
+    /**
+     * @deprecated staging copy behavior is handled outside of `BsConfig`
+     */
+    copyToStaging?: boolean;
     /**
      * If true, the server will keep running and will watch and recompile on every file change
      * @default false
@@ -69,17 +84,15 @@ export interface BsConfig {
      */
     diagnosticSeverityOverrides?: Record<number | string, 'error' | 'warn' | 'info' | 'hint'>;
     /**
-     * Emit full paths to files when printing diagnostics to the console. Defaults to false
+     * @deprecated Moved to `compilerOptions.emitFullPaths`. If both are present, `compilerOptions.emitFullPaths` wins.
      */
     emitFullPaths?: boolean;
     /**
-     * Emit type definition files (`d.bs`)
-     * @default false
+     * @deprecated Moved to `compilerOptions.emitDefinitions`. If both are present, `compilerOptions.emitDefinitions` wins.
      */
     emitDefinitions?: boolean;
     /**
-     * If true, removes the explicit type to function's parameters and return (i.e. the `as type` syntax); otherwise keep this information.
-     * @default false
+     * @deprecated Moved to `compilerOptions.removeParameterTypes`. If both are present, `compilerOptions.removeParameterTypes` wins.
      */
     removeParameterTypes?: boolean;
     /**
@@ -132,8 +145,7 @@ export interface BsConfig {
      */
     require?: Array<string>;
     /**
-     * When enabled, every xml component will search for a .bs or .brs file with the same name
-     * in the same folder, and add it as a script import if found. Disabled by default"
+     * @deprecated Moved to `compilerOptions.autoImportComponentScript`. If both are present, `compilerOptions.autoImportComponentScript` wins.
      */
     autoImportComponentScript?: boolean;
     /**
@@ -148,56 +160,83 @@ export interface BsConfig {
      */
     logLevel?: LogLevel | 'error' | 'warn' | 'log' | 'info' | 'debug' | 'trace' | 'off';
     /**
-     * Overrides where source files appear to live, in both sourcemaps and the `SOURCE_FILE_PATH` /
-     * `SOURCE_LOCATION` runtime literals. Only applies to files within `rootDir`.
-     *
-     * When `relativeSourceMaps` is false (default): the `rootDir` portion of each source path is
-     * replaced with `sourceRoot` directly in `sources[]`. The map's `sourceRoot` field is not written.
-     *
-     * When `relativeSourceMaps` is true: the map's `sourceRoot` field is set to this value, and
-     * `sources[]` entries are relative to `sourceRoot` (per the sourcemap spec).
-     *
-     * In both modes, `SOURCE_FILE_PATH` and `SOURCE_LOCATION` reflect the `sourceRoot`-substituted path.
+     * @deprecated Moved to `compilerOptions.sourceRoot`. If both are present, `compilerOptions.sourceRoot` wins.
      */
     sourceRoot?: string;
     /**
-     * Should the `sourceRoot` property be resolve to an absolute path (relative to the bsconfig it's defined in)
-     * @default false
+     * @deprecated Moved to `compilerOptions.resolveSourceRoot`. If both are present, `compilerOptions.resolveSourceRoot` wins.
      */
     resolveSourceRoot?: boolean;
     /**
-     * Enables generating sourcemap files, which allow debugging tools to show the original source code while running the emitted files.
-     * @default true
+     * @deprecated Moved to `compilerOptions.sourceMap`. If both are present, `compilerOptions.sourceMap` wins.
      */
     sourceMap?: boolean;
     /**
-     * If true, file paths in sourcemap `sources[]` will be written as relative paths instead of absolute.
-     * Only has an effect when `sourceMap` is true.
-     *
-     * When false (default): `sources[]` contains absolute paths. If `sourceRoot` is set, the `rootDir`
-     * portion is replaced with `sourceRoot` in-place; the map's `sourceRoot` field is never written.
-     *
-     * When true: `sources[]` entries are relative to the map file's directory, making sourcemaps
-     * portable across machines. If `sourceRoot` is also set, the map's `sourceRoot` field is written
-     * and `sources[]` entries are instead relative to `sourceRoot` (per the sourcemap spec — consumers
-     * reconstruct the full path as `path.resolve(sourceRoot, sources[0])`).
-     * @default false
+     * @deprecated Moved to `compilerOptions.relativeSourceMaps`. If both are present, `compilerOptions.relativeSourceMaps` wins.
      */
     relativeSourceMaps?: boolean;
     /**
-     * Excludes empty files from being included in the output. Some Brighterscript files
-     * are left empty or with only comments after transpilation to Brightscript.
-     * The default behavior is to write these to disk after transpilation.
-     * Setting this flag to `true` will prevent empty files being written and will
-     * remove associated script tags from XML
-     * @default false
+     * @deprecated Moved to `compilerOptions.pruneEmptyCodeFiles`. If both are present, `compilerOptions.pruneEmptyCodeFiles` wins.
      */
     pruneEmptyCodeFiles?: boolean;
+    /**
+     * @deprecated Moved to `compilerOptions.allowBrighterScriptInBrightScript`. If both are present, `compilerOptions.allowBrighterScriptInBrightScript` wins.
+     */
+    allowBrighterScriptInBrightScript?: boolean;
+    /**
+     * @deprecated Moved to `compilerOptions.bslibDestinationDir`. If both are present, `compilerOptions.bslibDestinationDir` wins.
+     */
+    bslibDestinationDir?: string;
+    /**
+     * @deprecated Moved to `compilerOptions.legacyCallfuncHandling`. If both are present, `compilerOptions.legacyCallfuncHandling` wins.
+     */
+    legacyCallfuncHandling?: boolean;
+    /**
+     * @deprecated Moved to `compilerOptions.minFirmwareVersion`. If both are present, `compilerOptions.minFirmwareVersion` wins.
+     */
+    minFirmwareVersion?: string;
+    /**
+     * When set to false, validation is skipped entirely. This can speed up builds when diagnostics
+     * are not needed (e.g. when using the VSCode extension which already surfaces diagnostics in the
+     * editor). Note that skipping validation may cause transpilation to fail or produce incorrect
+     * output if the project contains errors that would normally be caught during validation.
+     * @default true
+     */
+    validate?: boolean;
+    /**
+     * @deprecated Moved to `compilerOptions.strict`. If both are present, `compilerOptions.strict` wins.
+     */
+    strict?: boolean;
+    /**
+     * @deprecated Moved to `compilerOptions.strictCallFunc`. If both are present, `compilerOptions.strictCallFunc` wins.
+     */
+    strictCallFunc?: boolean;
+    /**
+     * @deprecated Moved to `compilerOptions.strictNodeMembers`. If both are present, `compilerOptions.strictNodeMembers` wins.
+     */
+    strictNodeMembers?: boolean;
+    /**
+     * Options that control how BrighterScript interprets, validates, and compiles your code
+     * (as opposed to top-level options, which control project structure, file discovery, and
+     * tooling/reporting behavior). Similar in spirit to TypeScript's `compilerOptions`.
+     *
+     * Several of these options used to live at the top level of `bsconfig.json`. Those top-level
+     * options still work, but are deprecated: if an option is set in both places, the value in
+     * `compilerOptions` wins, and a deprecation warning is emitted for the top-level usage.
+     */
+    compilerOptions?: BsConfigCompilerOptions;
+}
+export interface BsConfigCompilerOptions {
     /**
      * Allow brighterscript features (classes, interfaces, etc...) to be included in BrightScript (`.brs`) files, and force those files to be transpiled.
      * @default false
      */
     allowBrighterScriptInBrightScript?: boolean;
+    /**
+     * When enabled, every xml component will search for a .bs or .brs file with the same name
+     * in the same folder, and add it as a script import if found. Disabled by default"
+     */
+    autoImportComponentScript?: boolean;
     /**
      * Override the destination directory for the bslib.brs file.  Use this if
      * you want to customize where the bslib.brs file is located in the staging
@@ -205,7 +244,19 @@ export interface BsConfig {
      * scripts inside `source` that depend on bslib.brs.  Defaults to `source`.
      */
     bslibDestinationDir?: string;
+    /**
+     * Emit type definition files (`d.bs`)
+     * @default false
+     */
+    emitDefinitions?: boolean;
+    /**
+     * Emit full paths to files when printing diagnostics to the console. Defaults to false
+     */
+    emitFullPaths?: boolean;
     legacyCallfuncHandling?: boolean;
+    manifest?: {
+        bs_const?: Record<string, boolean | null>;
+    };
     /**
      * The minimum Roku firmware version required to run this project.
      * When set, BrightScript (.brs) files are always validated against the version restriction.
@@ -217,14 +268,77 @@ export interface BsConfig {
      */
     minFirmwareVersion?: string;
     /**
-     * When set to false, validation is skipped entirely. This can speed up builds when diagnostics
-     * are not needed (e.g. when using the VSCode extension which already surfaces diagnostics in the
-     * editor). Note that skipping validation may cause transpilation to fail or produce incorrect
-     * output if the project contains errors that would normally be caught during validation.
+     * Excludes empty files from being included in the output. Some Brighterscript files
+     * are left empty or with only comments after transpilation to Brightscript.
+     * The default behavior is to write these to disk after transpilation.
+     * Setting this flag to `true` will prevent empty files being written and will
+     * remove associated script tags from XML
+     * @default false
+     */
+    pruneEmptyCodeFiles?: boolean;
+    /**
+     * If true, file paths in sourcemap `sources[]` will be written as relative paths instead of absolute.
+     * Only has an effect when `sourceMap` is true.
+     *
+     * When false (default): `sources[]` contains absolute paths. If `sourceRoot` is set, the `rootDir`
+     * portion is replaced with `sourceRoot` in-place; the map's `sourceRoot` field is never written.
+     *
+     * When true: `sources[]` entries are relative to the map file's directory, making sourcemaps
+     * portable across machines. If `sourceRoot` is also set, the map's `sourceRoot` field is written
+     * and `sources[]` entries are instead relative to `sourceRoot` (per the sourcemap spec — consumers
+     * reconstruct the full path as `path.resolve(sourceRoot, sources[0])`).
+     * @default false
+     */
+    relativeSourceMaps?: boolean;
+    /**
+     * If true, removes the explicit type to function's parameters and return (i.e. the `as type` syntax); otherwise keep this information.
+     * @default false
+     */
+    removeParameterTypes?: boolean;
+    /**
+     * Should the `sourceRoot` property be resolve to an absolute path (relative to the bsconfig it's defined in)
+     * @default false
+     */
+    resolveSourceRoot?: boolean;
+    /**
+     * Enables generating sourcemap files, which allow debugging tools to show the original source code while running the emitted files.
      * @default true
      */
-    validate?: boolean;
+    sourceMap?: boolean;
+    /**
+     * Overrides where source files appear to live, in both sourcemaps and the `SOURCE_FILE_PATH` /
+     * `SOURCE_LOCATION` runtime literals. Only applies to files within `rootDir`.
+     *
+     * When `relativeSourceMaps` is false (default): the `rootDir` portion of each source path is
+     * replaced with `sourceRoot` directly in `sources[]`. The map's `sourceRoot` field is not written.
+     *
+     * When `relativeSourceMaps` is true: the map's `sourceRoot` field is set to this value, and
+     * `sources[]` entries are relative to `sourceRoot` (per the sourcemap spec).
+     *
+     * In both modes, `SOURCE_FILE_PATH` and `SOURCE_LOCATION` reflect the `sourceRoot`-substituted path.
+     */
+    sourceRoot?: string;
+    /**
+     * When true, enables all strict mode options (strictCallFunc, strictNodeMembers, and any future options added that are considered "strict"). This is a convenient way to enable strict mode without having to set each option individually.
+     * @default false
+     */
+    strict?: boolean;
+    /**
+     * Enables stricter type-checking for callfunc() invocations. When true, callfunc() invocations will not be allowed on generic Node types.
+     * @default false
+     */
+    strictCallFunc?: boolean;
+    /**
+     * Enables stricter type-checking for Node members. When true, unknown members on Node types will be treated as errors instead of dynamic values.
+     * @default false
+     */
+    strictNodeMembers?: boolean;
 }
+/**
+ * The list of `BsConfig` keys that were moved into `compilerOptions`. Kept in one place so the
+ * legacy-option shimming/deprecation logic in `util.ts` and the JSON schema stay in sync.
+ */
+export declare const deprecatedCompilerOptionKeys: ReadonlyArray<keyof BsConfigCompilerOptions & keyof BsConfig>;
 /**
  * Discriminated union describing how diagnostics are rendered to the console.
  * - String shorthand: a preset name ('detailed' | 'github-actions') or a template string
@@ -250,6 +364,6 @@ export declare type NormalizedDiagnosticReporter = {
     type: 'custom';
     format: string;
 };
-declare type OptionalBsConfigFields = '_ancestors' | 'sourceRoot' | 'project' | 'manifest' | 'noProject' | 'extends' | 'require' | 'outDir' | 'diagnosticLevel' | 'rootDir' | 'stagingDir' | 'stagingFolderPath' | 'minFirmwareVersion' | 'diagnosticReporters';
+declare type OptionalBsConfigFields = '_ancestors' | 'sourceRoot' | 'project' | 'manifest' | 'noProject' | 'extends' | 'require' | 'outDir' | 'createPackage' | 'deploy' | 'copyToStaging' | 'diagnosticLevel' | 'rootDir' | 'stagingDir' | 'stagingFolderPath' | 'minFirmwareVersion' | 'diagnosticReporters' | 'compilerOptions';
 export declare type FinalizedBsConfig = Omit<Required<BsConfig>, OptionalBsConfigFields> & Pick<BsConfig, OptionalBsConfigFields>;
 export {};

package/dist/BsConfig.js

@@ -1,3 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.deprecatedCompilerOptionKeys = void 0;
+/**
+ * The list of `BsConfig` keys that were moved into `compilerOptions`. Kept in one place so the
+ * legacy-option shimming/deprecation logic in `util.ts` and the JSON schema stay in sync.
+ */
+exports.deprecatedCompilerOptionKeys = [
+    'allowBrighterScriptInBrightScript',
+    'autoImportComponentScript',
+    'bslibDestinationDir',
+    'emitDefinitions',
+    'emitFullPaths',
+    'legacyCallfuncHandling',
+    'manifest',
+    'minFirmwareVersion',
+    'pruneEmptyCodeFiles',
+    'relativeSourceMaps',
+    'removeParameterTypes',
+    'resolveSourceRoot',
+    'sourceMap',
+    'sourceRoot',
+    'strict',
+    'strictCallFunc',
+    'strictNodeMembers'
+];
 //# sourceMappingURL=BsConfig.js.map

package/dist/BsConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"BsConfig.js","sourceRoot":"","sources":["../src/BsConfig.ts"],"names":[],"mappings":""}
+{"version":3,"file":"BsConfig.js","sourceRoot":"","sources":["../src/BsConfig.ts"],"names":[],"mappings":";;;AAiYA;;;GAGG;AACU,QAAA,4BAA4B,GAAkE;IACvG,mCAAmC;IACnC,2BAA2B;IAC3B,qBAAqB;IACrB,iBAAiB;IACjB,eAAe;IACf,wBAAwB;IACxB,UAAU;IACV,oBAAoB;IACpB,qBAAqB;IACrB,oBAAoB;IACpB,sBAAsB;IACtB,mBAAmB;IACnB,WAAW;IACX,YAAY;IACZ,QAAQ;IACR,gBAAgB;IAChB,mBAAmB;CACtB,CAAC"}

package/dist/BusyStatusTracker.js

@@ -113,8 +113,11 @@ class BusyStatusTracker {
     }
     once(eventName) {
         return new Promise((resolve) => {
+            //the widened `eventName` can't match the literal-string `on()` overload
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
             const off = this.on(eventName, (data) => {
                 off();
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
                 resolve(data);
             });
         });

package/dist/BusyStatusTracker.js.map

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

package/dist/CrossScopeValidator.js

@@ -221,6 +221,11 @@ class CrossScopeValidator {
     getRequiredMap(scope) {
         const map = new Map();
         scope.enumerateBrsFiles((file) => {
+            //typedef files (.d.bs) are ambient declarations only - never validated for diagnostics,
+            //so don't flag their own unresolved type references as missing symbols
+            if (file.isTypedef) {
+                return;
+            }
             for (const symbol of file.requiredSymbols) {
                 const symbolKeysArray = this.symbolMapKeys(symbol);
                 for (const symbolKeys of symbolKeysArray) {