jsii 5.9.44 → 6.0.0

package/lib/tsconfig/rule-set-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-set-format.js","sourceRoot":"","sources":["../../src/tsconfig/rule-set-format.ts"],"names":[],"mappings":"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","sourcesContent":["import chalk from 'chalk';\nimport { TypeScriptConfigValidationRuleSet } from '.';\nimport { describeRuleSet, getCompilerOptionsRuleSet } from './tsconfig-validator';\nimport { RuleDescription, RuleType } from './validator';\n\n/**\n * Human-readable descriptions for each tsconfig validation rule set.\n *\n * These are surfaced both as CLI option help (e.g. for `--validate-tsconfig` and\n * `--rule-set`) and as the heading when printing a rule set via `formatRuleSet`.\n */\nexport const RULE_SET_DESCRIPTIONS: {\n  [choice in TypeScriptConfigValidationRuleSet]: string;\n} = {\n  [TypeScriptConfigValidationRuleSet.STRICT]:\n    'Validates the provided config against a strict rule set designed for maximum backwards-compatibility.',\n  [TypeScriptConfigValidationRuleSet.GENERATED]:\n    'Enforces a config as created by --generate-tsconfig. Use this to stay compatible with the generated config, but have full ownership over the file.',\n  [TypeScriptConfigValidationRuleSet.MINIMAL]:\n    'Only enforce options that are known to be incompatible with jsii. This rule set is likely to be incomplete and new rules will be added without notice as incompatibilities emerge.',\n  [TypeScriptConfigValidationRuleSet.NONE]:\n    'Disables all config validation, including options that are known to be incompatible with jsii. Intended for experimentation only. Use at your own risk.',\n};\n\n/**\n * Render a single rule set (its `compilerOptions` rules) as a human-readable block.\n *\n * @param ruleSet the rule set to render\n * @returns a multi-line string suitable for printing to the console\n */\nexport function formatRuleSet(ruleSet: TypeScriptConfigValidationRuleSet): string {\n  const lines: string[] = [`${chalk.bold('Rule set:')} ${chalk.bold.cyan(ruleSet)}`];\n\n  const description = RULE_SET_DESCRIPTIONS[ruleSet];\n  if (description) {\n    lines.push(chalk.dim(description));\n  }\n\n  const rules = describeRuleSet(ruleSet);\n  if (rules.length === 0) {\n    lines.push('');\n    lines.push(chalk.dim('  No rules. Configuration validation is disabled for this rule set.'));\n    return lines.join('\\n');\n  }\n\n  const unknownRejected = getCompilerOptionsRuleSet(ruleSet).options.unexpectedFields === RuleType.FAIL;\n  lines.push('');\n  lines.push(chalk.dim(`Applies to: compilerOptions (other options: ${unknownRejected ? 'rejected' : 'allowed'})`));\n  lines.push('');\n\n  // Group rules by field, preserving the order in which each field first appears.\n  const byField = new Map<string, RuleDescription[]>();\n  for (const rule of rules) {\n    const list = byField.get(rule.field) ?? [];\n    list.push(rule);\n    byField.set(rule.field, list);\n  }\n\n  const width = Math.max(...[...byField.keys()].map((field) => field.length));\n  for (const [field, fieldRules] of byField) {\n    const phrases = fieldRules.map(formatConstraint);\n    // A required field is surfaced as an explicit \"required\" constraint at the front.\n    if (fieldRules.some((rule) => rule.required)) {\n      phrases.unshift(chalk.italic('required'));\n    }\n    // Dedupe identical phrases (some fields are constrained by several rules that overlap).\n    const constraints = [...new Set(phrases)].join('; ');\n    lines.push(`  ${chalk.bold(field.padEnd(width))}  ${constraints}`);\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Render a single rule's constraint as a human-readable phrase.\n *\n * @param rule the rule description to render\n * @returns a phrase such as `must be one of: es2022, es2023` or `not allowed`\n */\nexport function formatConstraint(rule: RuleDescription): string {\n  const { type, values } = rule;\n\n  // No hints means the matcher accepts anything (e.g. Match.ANY).\n  if (values === undefined) {\n    return type === RuleType.PASS ? chalk.italic('any value') : 'must not be set to the matched value';\n  }\n\n  // Only null/undefined hints means the option must be absent (e.g. Match.MISSING).\n  if (values.length > 0 && values.every((value) => value == null)) {\n    return chalk.italic('not allowed');\n  }\n\n  const formatted = values.map(formatRuleValue);\n  if (type === RuleType.FAIL) {\n    return formatted.length > 1 ? `must not be one of: ${formatted.join(', ')}` : `must not be ${formatted[0]}`;\n  }\n  return formatted.length > 1 ? `must be one of: ${formatted.join(', ')}` : `must be ${formatted[0]}`;\n}\n\n/**\n * Render a single hinted value as a highlighted code literal. Strings are shown\n * verbatim (as a user writes them in tsconfig.json), everything else is JSON-encoded.\n *\n * @param value the hinted value to render\n * @returns the value as a (possibly colorized) code literal\n */\nexport function formatRuleValue(value: any): string {\n  const literal = typeof value === 'string' ? value : JSON.stringify(value);\n  return chalk.cyan(literal);\n}\n"]}

package/lib/tsconfig/rulesets/configurable-options.js

@@ -1,6 +1,9 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-const jsii_configured_options_1 = require("./jsii-configured-options");
+const jsii_configured_options_1 = __importDefault(require("./jsii-configured-options"));
 const validator_1 = require("../validator");
 // A rule set defining all compilerOptions that can be configured by users with or without constraints.
 // These are options jsii doesn't have a particular opinion about
@@ -19,5 +22,11 @@ configurableOptions.shouldPass('noFallthroughCasesInSwitch', validator_1.Match.A
 configurableOptions.shouldPass('verbatimModuleSyntax', validator_1.Match.ANY);
 configurableOptions.shouldPass('isolatedModules', validator_1.Match.ANY);
 configurableOptions.shouldPass('isolatedDeclarations', validator_1.Match.ANY);
+configurableOptions.shouldPass('useDefineForClassFields', validator_1.Match.ANY);
+// Authoring options the user may opt into; some jsii language features won't be
+// usable under them, but that is the user's choice (TS reports any violations).
+configurableOptions.shouldPass('erasableSyntaxOnly', validator_1.Match.ANY);
+configurableOptions.shouldPass('allowImportingTsExtensions', validator_1.Match.ANY);
+configurableOptions.shouldPass('rewriteRelativeImportExtensions', validator_1.Match.ANY);
 exports.default = configurableOptions;
 //# sourceMappingURL=configurable-options.js.map

package/lib/tsconfig/rulesets/configurable-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"configurable-options.js","sourceRoot":"","sources":["../../../src/tsconfig/rulesets/configurable-options.ts"],"names":[],"mappings":";;AAAA,uEAA8D;AAC9D,4CAA8C;AAE9C,uGAAuG;AACvG,iEAAiE;AACjE,qEAAqE;AAErE,MAAM,mBAAmB,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE1C,6DAA6D;AAC7D,mBAAmB,CAAC,MAAM,CAAC,iCAAqB,CAAC,CAAC;AAElD,uCAAuC;AACvC,mBAAmB,CAAC,UAAU,CAAC,aAAa,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACzD,mBAAmB,CAAC,UAAU,CAAC,mBAAmB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAC/D,mBAAmB,CAAC,UAAU,CAAC,gBAAgB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAC5D,mBAAmB,CAAC,UAAU,CAAC,oBAAoB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAChE,mBAAmB,CAAC,UAAU,CAAC,mBAAmB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAC/D,mBAAmB,CAAC,UAAU,CAAC,wBAAwB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACpE,mBAAmB,CAAC,UAAU,CAAC,4BAA4B,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACxE,mBAAmB,CAAC,UAAU,CAAC,sBAAsB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAClE,mBAAmB,CAAC,UAAU,CAAC,iBAAiB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAC7D,mBAAmB,CAAC,UAAU,CAAC,sBAAsB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAElE,kBAAe,mBAAmB,CAAC","sourcesContent":["import jsiiConfiguredOptions from './jsii-configured-options';\nimport { Match, RuleSet } from '../validator';\n\n// A rule set defining all compilerOptions that can be configured by users with or without constraints.\n// These are options jsii doesn't have a particular opinion about\n// This is an internal rule set, that may be used by other rule sets.\n\nconst configurableOptions = new RuleSet();\n\n// import all options that are configurable via jsii settings\nconfigurableOptions.import(jsiiConfiguredOptions);\n\n// options jsii allows to be configured\nconfigurableOptions.shouldPass('incremental', Match.ANY);\nconfigurableOptions.shouldPass('noImplicitReturns', Match.ANY);\nconfigurableOptions.shouldPass('noUnusedLocals', Match.ANY);\nconfigurableOptions.shouldPass('noUnusedParameters', Match.ANY);\nconfigurableOptions.shouldPass('resolveJsonModule', Match.ANY);\nconfigurableOptions.shouldPass('experimentalDecorators', Match.ANY);\nconfigurableOptions.shouldPass('noFallthroughCasesInSwitch', Match.ANY);\nconfigurableOptions.shouldPass('verbatimModuleSyntax', Match.ANY);\nconfigurableOptions.shouldPass('isolatedModules', Match.ANY);\nconfigurableOptions.shouldPass('isolatedDeclarations', Match.ANY);\n\nexport default configurableOptions;\n"]}
+{"version":3,"file":"configurable-options.js","sourceRoot":"","sources":["../../../src/tsconfig/rulesets/configurable-options.ts"],"names":[],"mappings":";;;;;AAAA,wFAA8D;AAC9D,4CAA8C;AAE9C,uGAAuG;AACvG,iEAAiE;AACjE,qEAAqE;AAErE,MAAM,mBAAmB,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE1C,6DAA6D;AAC7D,mBAAmB,CAAC,MAAM,CAAC,iCAAqB,CAAC,CAAC;AAElD,uCAAuC;AACvC,mBAAmB,CAAC,UAAU,CAAC,aAAa,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACzD,mBAAmB,CAAC,UAAU,CAAC,mBAAmB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAC/D,mBAAmB,CAAC,UAAU,CAAC,gBAAgB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAC5D,mBAAmB,CAAC,UAAU,CAAC,oBAAoB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAChE,mBAAmB,CAAC,UAAU,CAAC,mBAAmB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAC/D,mBAAmB,CAAC,UAAU,CAAC,wBAAwB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACpE,mBAAmB,CAAC,UAAU,CAAC,4BAA4B,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACxE,mBAAmB,CAAC,UAAU,CAAC,sBAAsB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAClE,mBAAmB,CAAC,UAAU,CAAC,iBAAiB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAC7D,mBAAmB,CAAC,UAAU,CAAC,sBAAsB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAClE,mBAAmB,CAAC,UAAU,CAAC,yBAAyB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACrE,gFAAgF;AAChF,gFAAgF;AAChF,mBAAmB,CAAC,UAAU,CAAC,oBAAoB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAChE,mBAAmB,CAAC,UAAU,CAAC,4BAA4B,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACxE,mBAAmB,CAAC,UAAU,CAAC,iCAAiC,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAE7E,kBAAe,mBAAmB,CAAC","sourcesContent":["import jsiiConfiguredOptions from './jsii-configured-options';\nimport { Match, RuleSet } from '../validator';\n\n// A rule set defining all compilerOptions that can be configured by users with or without constraints.\n// These are options jsii doesn't have a particular opinion about\n// This is an internal rule set, that may be used by other rule sets.\n\nconst configurableOptions = new RuleSet();\n\n// import all options that are configurable via jsii settings\nconfigurableOptions.import(jsiiConfiguredOptions);\n\n// options jsii allows to be configured\nconfigurableOptions.shouldPass('incremental', Match.ANY);\nconfigurableOptions.shouldPass('noImplicitReturns', Match.ANY);\nconfigurableOptions.shouldPass('noUnusedLocals', Match.ANY);\nconfigurableOptions.shouldPass('noUnusedParameters', Match.ANY);\nconfigurableOptions.shouldPass('resolveJsonModule', Match.ANY);\nconfigurableOptions.shouldPass('experimentalDecorators', Match.ANY);\nconfigurableOptions.shouldPass('noFallthroughCasesInSwitch', Match.ANY);\nconfigurableOptions.shouldPass('verbatimModuleSyntax', Match.ANY);\nconfigurableOptions.shouldPass('isolatedModules', Match.ANY);\nconfigurableOptions.shouldPass('isolatedDeclarations', Match.ANY);\nconfigurableOptions.shouldPass('useDefineForClassFields', Match.ANY);\n// Authoring options the user may opt into; some jsii language features won't be\n// usable under them, but that is the user's choice (TS reports any violations).\nconfigurableOptions.shouldPass('erasableSyntaxOnly', Match.ANY);\nconfigurableOptions.shouldPass('allowImportingTsExtensions', Match.ANY);\nconfigurableOptions.shouldPass('rewriteRelativeImportExtensions', Match.ANY);\n\nexport default configurableOptions;\n"]}

package/lib/tsconfig/rulesets/deprecated-options.js

@@ -1,9 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const validator_1 = require("../validator");
-// A rule set for deprecated compilerOptions that should not be used with jsii
+// A rule set for deprecated compilerOptions that should not be used with jsii.
+// These options are deprecated in TypeScript 6.0 and will be removed in TypeScript 7.0.
 // This is an internal rule set, that may be used by other rule sets.
 const deprecatedOptions = new validator_1.RuleSet();
 deprecatedOptions.shouldPass('prepend', validator_1.Match.MISSING);
+deprecatedOptions.shouldPass('downlevelIteration', validator_1.Match.MISSING);
+deprecatedOptions.shouldPass('outFile', validator_1.Match.MISSING);
+deprecatedOptions.shouldPass('baseUrl', validator_1.Match.MISSING);
+// esModuleInterop: false and allowSyntheticDefaultImports: false are deprecated
+deprecatedOptions.shouldPass('esModuleInterop', validator_1.Match.optional(validator_1.Match.TRUE));
+deprecatedOptions.shouldPass('allowSyntheticDefaultImports', validator_1.Match.optional(validator_1.Match.TRUE));
+// alwaysStrict: false is deprecated
+deprecatedOptions.shouldPass('alwaysStrict', validator_1.Match.optional(validator_1.Match.TRUE));
+// target: es5 is deprecated
+deprecatedOptions.shouldFail('target', validator_1.Match.eq('es5'));
+// Deprecated module values: amd, umd, systemjs, none
+deprecatedOptions.shouldFail('module', validator_1.Match.oneOf('amd', 'umd', 'systemjs', 'none'));
+// Deprecated moduleResolution values: node (node10), classic
+deprecatedOptions.shouldFail('moduleResolution', validator_1.Match.oneOf('node', 'node10', 'classic'));
 exports.default = deprecatedOptions;
 //# sourceMappingURL=deprecated-options.js.map

package/lib/tsconfig/rulesets/deprecated-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"deprecated-options.js","sourceRoot":"","sources":["../../../src/tsconfig/rulesets/deprecated-options.ts"],"names":[],"mappings":";;AAAA,4CAA8C;AAE9C,8EAA8E;AAC9E,qEAAqE;AACrE,MAAM,iBAAiB,GAAG,IAAI,mBAAO,EAAE,CAAC;AACxC,iBAAiB,CAAC,UAAU,CAAC,SAAS,EAAE,iBAAK,CAAC,OAAO,CAAC,CAAC;AAEvD,kBAAe,iBAAiB,CAAC","sourcesContent":["import { Match, RuleSet } from '../validator';\n\n// A rule set for deprecated compilerOptions that should not be used with jsii\n// This is an internal rule set, that may be used by other rule sets.\nconst deprecatedOptions = new RuleSet();\ndeprecatedOptions.shouldPass('prepend', Match.MISSING);\n\nexport default deprecatedOptions;\n"]}
+{"version":3,"file":"deprecated-options.js","sourceRoot":"","sources":["../../../src/tsconfig/rulesets/deprecated-options.ts"],"names":[],"mappings":";;AAAA,4CAA8C;AAE9C,+EAA+E;AAC/E,wFAAwF;AACxF,qEAAqE;AACrE,MAAM,iBAAiB,GAAG,IAAI,mBAAO,EAAE,CAAC;AACxC,iBAAiB,CAAC,UAAU,CAAC,SAAS,EAAE,iBAAK,CAAC,OAAO,CAAC,CAAC;AACvD,iBAAiB,CAAC,UAAU,CAAC,oBAAoB,EAAE,iBAAK,CAAC,OAAO,CAAC,CAAC;AAClE,iBAAiB,CAAC,UAAU,CAAC,SAAS,EAAE,iBAAK,CAAC,OAAO,CAAC,CAAC;AACvD,iBAAiB,CAAC,UAAU,CAAC,SAAS,EAAE,iBAAK,CAAC,OAAO,CAAC,CAAC;AAEvD,gFAAgF;AAChF,iBAAiB,CAAC,UAAU,CAAC,iBAAiB,EAAE,iBAAK,CAAC,QAAQ,CAAC,iBAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5E,iBAAiB,CAAC,UAAU,CAAC,8BAA8B,EAAE,iBAAK,CAAC,QAAQ,CAAC,iBAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAEzF,oCAAoC;AACpC,iBAAiB,CAAC,UAAU,CAAC,cAAc,EAAE,iBAAK,CAAC,QAAQ,CAAC,iBAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAEzE,4BAA4B;AAC5B,iBAAiB,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AAExD,qDAAqD;AACrD,iBAAiB,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAEtF,6DAA6D;AAC7D,iBAAiB,CAAC,UAAU,CAAC,kBAAkB,EAAE,iBAAK,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AAE3F,kBAAe,iBAAiB,CAAC","sourcesContent":["import { Match, RuleSet } from '../validator';\n\n// A rule set for deprecated compilerOptions that should not be used with jsii.\n// These options are deprecated in TypeScript 6.0 and will be removed in TypeScript 7.0.\n// This is an internal rule set, that may be used by other rule sets.\nconst deprecatedOptions = new RuleSet();\ndeprecatedOptions.shouldPass('prepend', Match.MISSING);\ndeprecatedOptions.shouldPass('downlevelIteration', Match.MISSING);\ndeprecatedOptions.shouldPass('outFile', Match.MISSING);\ndeprecatedOptions.shouldPass('baseUrl', Match.MISSING);\n\n// esModuleInterop: false and allowSyntheticDefaultImports: false are deprecated\ndeprecatedOptions.shouldPass('esModuleInterop', Match.optional(Match.TRUE));\ndeprecatedOptions.shouldPass('allowSyntheticDefaultImports', Match.optional(Match.TRUE));\n\n// alwaysStrict: false is deprecated\ndeprecatedOptions.shouldPass('alwaysStrict', Match.optional(Match.TRUE));\n\n// target: es5 is deprecated\ndeprecatedOptions.shouldFail('target', Match.eq('es5'));\n\n// Deprecated module values: amd, umd, systemjs, none\ndeprecatedOptions.shouldFail('module', Match.oneOf('amd', 'umd', 'systemjs', 'none'));\n\n// Deprecated moduleResolution values: node (node10), classic\ndeprecatedOptions.shouldFail('moduleResolution', Match.oneOf('node', 'node10', 'classic'));\n\nexport default deprecatedOptions;\n"]}

package/lib/tsconfig/rulesets/generated.public.js

@@ -1,6 +1,9 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-const jsii_configured_options_1 = require("./jsii-configured-options");
+const jsii_configured_options_1 = __importDefault(require("./jsii-configured-options"));
 const compiler_options_1 = require("../compiler-options");
 const validator_1 = require("../validator");
 // The public rule set used for the "generated" tsconfig validation setting.\
@@ -12,7 +15,9 @@ const generated = new validator_1.RuleSet({
 });
 // import all options that are configurable via jsii settings
 generated.import(jsii_configured_options_1.default);
-// ... and all generated options
+// ... and all generated options. Deprecated options need no explicit handling here: this is a
+// closed whitelist, so any deprecated option is either pinned to its generated value below or
+// rejected as an unexpected field.
 for (const [field, value] of Object.entries((0, compiler_options_1.convertForJson)(compiler_options_1.BASE_COMPILER_OPTIONS))) {
     if (typeof value === 'string') {
         generated.shouldPass(field, validator_1.Match.strEq(value, true));

package/lib/tsconfig/rulesets/generated.public.js.map

@@ -1 +1 @@
-{"version":3,"file":"generated.public.js","sourceRoot":"","sources":["../../../src/tsconfig/rulesets/generated.public.ts"],"names":[],"mappings":";;AAAA,uEAA8D;AAC9D,0DAA4E;AAC5E,4CAAwD;AAExD,6EAA6E;AAC7E,+GAA+G;AAC/G,qFAAqF;AACrF,iGAAiG;AACjG,MAAM,SAAS,GAAG,IAAI,mBAAO,CAAC;IAC5B,gBAAgB,EAAE,oBAAQ,CAAC,IAAI;CAChC,CAAC,CAAC;AAEH,6DAA6D;AAC7D,SAAS,CAAC,MAAM,CAAC,iCAAqB,CAAC,CAAC;AAExC,gCAAgC;AAChC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAA,iCAAc,EAAC,wCAAqB,CAAC,CAAC,EAAE,CAAC;IACnF,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,iBAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QACtD,SAAS;IACX,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,iBAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAChD,SAAS;IACX,CAAC;IAED,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,iBAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,kBAAe,SAAS,CAAC","sourcesContent":["import jsiiConfiguredOptions from './jsii-configured-options';\nimport { BASE_COMPILER_OPTIONS, convertForJson } from '../compiler-options';\nimport { Match, RuleSet, RuleType } from '../validator';\n\n// The public rule set used for the \"generated\" tsconfig validation setting.\\\n// The goal of this rule set is to ensure a tsconfig is compatible to the one jsii would generate for the user.\n// It is explicitly enforcing option values that are used for the generated tsconfig,\n// as well as options that can be configured via jsii settings. All other options are disallowed.\nconst generated = new RuleSet({\n  unexpectedFields: RuleType.FAIL,\n});\n\n// import all options that are configurable via jsii settings\ngenerated.import(jsiiConfiguredOptions);\n\n// ... and all generated options\nfor (const [field, value] of Object.entries(convertForJson(BASE_COMPILER_OPTIONS))) {\n  if (typeof value === 'string') {\n    generated.shouldPass(field, Match.strEq(value, true));\n    continue;\n  }\n\n  if (Array.isArray(value)) {\n    generated.shouldPass(field, Match.arrEq(value));\n    continue;\n  }\n\n  generated.shouldPass(field, Match.eq(value));\n}\n\nexport default generated;\n"]}
+{"version":3,"file":"generated.public.js","sourceRoot":"","sources":["../../../src/tsconfig/rulesets/generated.public.ts"],"names":[],"mappings":";;;;;AAAA,wFAA8D;AAC9D,0DAA4E;AAC5E,4CAAwD;AAExD,6EAA6E;AAC7E,+GAA+G;AAC/G,qFAAqF;AACrF,iGAAiG;AACjG,MAAM,SAAS,GAAG,IAAI,mBAAO,CAAC;IAC5B,gBAAgB,EAAE,oBAAQ,CAAC,IAAI;CAChC,CAAC,CAAC;AAEH,6DAA6D;AAC7D,SAAS,CAAC,MAAM,CAAC,iCAAqB,CAAC,CAAC;AAExC,8FAA8F;AAC9F,8FAA8F;AAC9F,mCAAmC;AACnC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAA,iCAAc,EAAC,wCAAqB,CAAC,CAAC,EAAE,CAAC;IACnF,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,iBAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QACtD,SAAS;IACX,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,iBAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAChD,SAAS;IACX,CAAC;IAED,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,iBAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,kBAAe,SAAS,CAAC","sourcesContent":["import jsiiConfiguredOptions from './jsii-configured-options';\nimport { BASE_COMPILER_OPTIONS, convertForJson } from '../compiler-options';\nimport { Match, RuleSet, RuleType } from '../validator';\n\n// The public rule set used for the \"generated\" tsconfig validation setting.\\\n// The goal of this rule set is to ensure a tsconfig is compatible to the one jsii would generate for the user.\n// It is explicitly enforcing option values that are used for the generated tsconfig,\n// as well as options that can be configured via jsii settings. All other options are disallowed.\nconst generated = new RuleSet({\n  unexpectedFields: RuleType.FAIL,\n});\n\n// import all options that are configurable via jsii settings\ngenerated.import(jsiiConfiguredOptions);\n\n// ... and all generated options. Deprecated options need no explicit handling here: this is a\n// closed whitelist, so any deprecated option is either pinned to its generated value below or\n// rejected as an unexpected field.\nfor (const [field, value] of Object.entries(convertForJson(BASE_COMPILER_OPTIONS))) {\n  if (typeof value === 'string') {\n    generated.shouldPass(field, Match.strEq(value, true));\n    continue;\n  }\n\n  if (Array.isArray(value)) {\n    generated.shouldPass(field, Match.arrEq(value));\n    continue;\n  }\n\n  generated.shouldPass(field, Match.eq(value));\n}\n\nexport default generated;\n"]}

package/lib/tsconfig/rulesets/jsii-configured-options.js

@@ -13,7 +13,6 @@ jsiiConfiguredOptions.shouldPass('inlineSourceMap', validator_1.Match.ANY);
 jsiiConfiguredOptions.shouldPass('inlineSources', validator_1.Match.ANY);
 jsiiConfiguredOptions.shouldPass('sourceMap', validator_1.Match.ANY);
 jsiiConfiguredOptions.shouldPass('types', validator_1.Match.ANY);
-jsiiConfiguredOptions.shouldPass('baseUrl', validator_1.Match.ANY);
 jsiiConfiguredOptions.shouldPass('paths', validator_1.Match.ANY);
 jsiiConfiguredOptions.shouldPass('composite', validator_1.Match.ANY); // configured via projectReferences
 jsiiConfiguredOptions.shouldPass('tsBuildInfoFile', validator_1.Match.ANY);

package/lib/tsconfig/rulesets/jsii-configured-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsii-configured-options.js","sourceRoot":"","sources":["../../../src/tsconfig/rulesets/jsii-configured-options.ts"],"names":[],"mappings":";;AAAA,4CAA8C;AAE9C,mGAAmG;AACnG,qEAAqE;AACrE,gCAAgC;AAChC,MAAM,qBAAqB,GAAG,IAAI,mBAAO,EAAE,CAAC;AAC5C,qBAAqB,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACtD,qBAAqB,CAAC,UAAU,CAAC,SAAS,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACvD,qBAAqB,CAAC,UAAU,CAAC,kCAAkC,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAChF,qBAAqB,CAAC,UAAU,CAAC,gBAAgB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAC9D,qBAAqB,CAAC,UAAU,CAAC,iBAAiB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAC/D,qBAAqB,CAAC,UAAU,CAAC,eAAe,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAC7D,qBAAqB,CAAC,UAAU,CAAC,WAAW,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACzD,qBAAqB,CAAC,UAAU,CAAC,OAAO,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACrD,qBAAqB,CAAC,UAAU,CAAC,SAAS,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACvD,qBAAqB,CAAC,UAAU,CAAC,OAAO,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACrD,qBAAqB,CAAC,UAAU,CAAC,WAAW,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAmC;AAC7F,qBAAqB,CAAC,UAAU,CAAC,iBAAiB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAE/D,kBAAe,qBAAqB,CAAC","sourcesContent":["import { Match, RuleSet } from '../validator';\n\n// A rule set defining all compilerOptions that are configurable via the jsii field in package.json\n// This is an internal rule set, that may be used by other rule sets.\n// We accept all value for these\nconst jsiiConfiguredOptions = new RuleSet();\njsiiConfiguredOptions.shouldPass('outDir', Match.ANY);\njsiiConfiguredOptions.shouldPass('rootDir', Match.ANY);\njsiiConfiguredOptions.shouldPass('forceConsistentCasingInFileNames', Match.ANY);\njsiiConfiguredOptions.shouldPass('declarationMap', Match.ANY);\njsiiConfiguredOptions.shouldPass('inlineSourceMap', Match.ANY);\njsiiConfiguredOptions.shouldPass('inlineSources', Match.ANY);\njsiiConfiguredOptions.shouldPass('sourceMap', Match.ANY);\njsiiConfiguredOptions.shouldPass('types', Match.ANY);\njsiiConfiguredOptions.shouldPass('baseUrl', Match.ANY);\njsiiConfiguredOptions.shouldPass('paths', Match.ANY);\njsiiConfiguredOptions.shouldPass('composite', Match.ANY); // configured via projectReferences\njsiiConfiguredOptions.shouldPass('tsBuildInfoFile', Match.ANY);\n\nexport default jsiiConfiguredOptions;\n"]}
+{"version":3,"file":"jsii-configured-options.js","sourceRoot":"","sources":["../../../src/tsconfig/rulesets/jsii-configured-options.ts"],"names":[],"mappings":";;AAAA,4CAA8C;AAE9C,mGAAmG;AACnG,qEAAqE;AACrE,gCAAgC;AAChC,MAAM,qBAAqB,GAAG,IAAI,mBAAO,EAAE,CAAC;AAC5C,qBAAqB,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACtD,qBAAqB,CAAC,UAAU,CAAC,SAAS,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACvD,qBAAqB,CAAC,UAAU,CAAC,kCAAkC,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAChF,qBAAqB,CAAC,UAAU,CAAC,gBAAgB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAC9D,qBAAqB,CAAC,UAAU,CAAC,iBAAiB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAC/D,qBAAqB,CAAC,UAAU,CAAC,eAAe,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAC7D,qBAAqB,CAAC,UAAU,CAAC,WAAW,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACzD,qBAAqB,CAAC,UAAU,CAAC,OAAO,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACrD,qBAAqB,CAAC,UAAU,CAAC,OAAO,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AACrD,qBAAqB,CAAC,UAAU,CAAC,WAAW,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAmC;AAC7F,qBAAqB,CAAC,UAAU,CAAC,iBAAiB,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;AAE/D,kBAAe,qBAAqB,CAAC","sourcesContent":["import { Match, RuleSet } from '../validator';\n\n// A rule set defining all compilerOptions that are configurable via the jsii field in package.json\n// This is an internal rule set, that may be used by other rule sets.\n// We accept all value for these\nconst jsiiConfiguredOptions = new RuleSet();\njsiiConfiguredOptions.shouldPass('outDir', Match.ANY);\njsiiConfiguredOptions.shouldPass('rootDir', Match.ANY);\njsiiConfiguredOptions.shouldPass('forceConsistentCasingInFileNames', Match.ANY);\njsiiConfiguredOptions.shouldPass('declarationMap', Match.ANY);\njsiiConfiguredOptions.shouldPass('inlineSourceMap', Match.ANY);\njsiiConfiguredOptions.shouldPass('inlineSources', Match.ANY);\njsiiConfiguredOptions.shouldPass('sourceMap', Match.ANY);\njsiiConfiguredOptions.shouldPass('types', Match.ANY);\njsiiConfiguredOptions.shouldPass('paths', Match.ANY);\njsiiConfiguredOptions.shouldPass('composite', Match.ANY); // configured via projectReferences\njsiiConfiguredOptions.shouldPass('tsBuildInfoFile', Match.ANY);\n\nexport default jsiiConfiguredOptions;\n"]}

package/lib/tsconfig/rulesets/minimal.public.js

@@ -1,6 +1,9 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-const incompatible_options_1 = require("./incompatible-options");
+const incompatible_options_1 = __importDefault(require("./incompatible-options"));
 const validator_1 = require("../validator");
 // The public rule set used for the "minimal" tsconfig validation setting
 // To goal of this rule set is to only prevent obvious misconfigurations,

package/lib/tsconfig/rulesets/minimal.public.js.map

@@ -1 +1 @@
-{"version":3,"file":"minimal.public.js","sourceRoot":"","sources":["../../../src/tsconfig/rulesets/minimal.public.ts"],"names":[],"mappings":";;AAAA,iEAAyD;AACzD,4CAAuC;AAEvC,yEAAyE;AACzE,yEAAyE;AACzE,gDAAgD;AAChD,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAC9B,OAAO,CAAC,MAAM,CAAC,8BAAmB,CAAC,CAAC;AAEpC,kBAAe,OAAO,CAAC","sourcesContent":["import incompatibleOptions from './incompatible-options';\nimport { RuleSet } from '../validator';\n\n// The public rule set used for the \"minimal\" tsconfig validation setting\n// To goal of this rule set is to only prevent obvious misconfigurations,\n// while leaving everything else up to the user.\nconst minimal = new RuleSet();\nminimal.import(incompatibleOptions);\n\nexport default minimal;\n"]}
+{"version":3,"file":"minimal.public.js","sourceRoot":"","sources":["../../../src/tsconfig/rulesets/minimal.public.ts"],"names":[],"mappings":";;;;;AAAA,kFAAyD;AACzD,4CAAuC;AAEvC,yEAAyE;AACzE,yEAAyE;AACzE,gDAAgD;AAChD,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAC9B,OAAO,CAAC,MAAM,CAAC,8BAAmB,CAAC,CAAC;AAEpC,kBAAe,OAAO,CAAC","sourcesContent":["import incompatibleOptions from './incompatible-options';\nimport { RuleSet } from '../validator';\n\n// The public rule set used for the \"minimal\" tsconfig validation setting\n// To goal of this rule set is to only prevent obvious misconfigurations,\n// while leaving everything else up to the user.\nconst minimal = new RuleSet();\nminimal.import(incompatibleOptions);\n\nexport default minimal;\n"]}

package/lib/tsconfig/rulesets/strict.public.js

@@ -1,9 +1,12 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-const configurable_options_1 = require("./configurable-options");
-const deprecated_options_1 = require("./deprecated-options");
-const incompatible_options_1 = require("./incompatible-options");
-const strict_family_options_1 = require("./strict-family-options");
+const configurable_options_1 = __importDefault(require("./configurable-options"));
+const deprecated_options_1 = __importDefault(require("./deprecated-options"));
+const incompatible_options_1 = __importDefault(require("./incompatible-options"));
+const strict_family_options_1 = __importDefault(require("./strict-family-options"));
 const validator_1 = require("../validator");
 // The public rule set used for the "strict" tsconfig validation setting.
 // The goal of this rule set is to ensure a tsconfig that is following best practices for jsii.
@@ -19,15 +22,15 @@ strict.import(incompatible_options_1.default);
 // strict family options
 strict.import(strict_family_options_1.default);
 // Best practice rules
-strict.shouldPass('target', validator_1.Match.eq('es2022')); // node18
-strict.shouldPass('lib', validator_1.Match.arrEq(['es2022'])); // node18
-strict.shouldPass('module', validator_1.Match.oneOf('node16', 'commonjs'));
-strict.shouldPass('moduleResolution', validator_1.Match.optional(validator_1.Match.oneOf('node', 'node16')));
-strict.shouldPass('esModuleInterop', validator_1.Match.TRUE);
+strict.shouldPass('target', validator_1.Match.oneOf('es2022', 'es2023', 'esnext')); // node18+
+strict.shouldPass('lib', validator_1.Match.anyOf(validator_1.Match.arrEq(['es2022']), validator_1.Match.arrEq(['es2023']), validator_1.Match.arrEq(['esnext']))); // node18+
+strict.shouldPass('module', validator_1.Match.oneOf('node16', 'node18', 'node20', 'nodenext', 'commonjs'));
+strict.shouldPass('moduleResolution', validator_1.Match.optional(validator_1.Match.oneOf('node16', 'nodenext', 'bundler')));
 strict.shouldPass('skipLibCheck', validator_1.Match.TRUE);
 strict.shouldPass('stripInternal', validator_1.Match.optional(validator_1.Match.FALSE));
 strict.shouldPass('noEmitOnError', validator_1.Match.TRUE);
 strict.shouldPass('declaration', validator_1.Match.TRUE);
+strict.shouldPass('noUncheckedSideEffectImports', validator_1.Match.optional(validator_1.Match.TRUE));
 // Deprecated ts options that should not be used with jsii
 strict.import(deprecated_options_1.default);
 exports.default = strict;

package/lib/tsconfig/rulesets/strict.public.js.map

@@ -1 +1 @@
-{"version":3,"file":"strict.public.js","sourceRoot":"","sources":["../../../src/tsconfig/rulesets/strict.public.ts"],"names":[],"mappings":";;AAAA,iEAAyD;AACzD,6DAAqD;AACrD,iEAAyD;AACzD,mEAA0D;AAC1D,4CAAwD;AAExD,yEAAyE;AACzE,+FAA+F;AAC/F,8HAA8H;AAC9H,0DAA0D;AAC1D,MAAM,MAAM,GAAG,IAAI,mBAAO,CAAC;IACzB,gBAAgB,EAAE,oBAAQ,CAAC,IAAI;CAChC,CAAC,CAAC;AAEH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,CAAC,8BAAmB,CAAC,CAAC;AAEnC,sDAAsD;AACtD,MAAM,CAAC,MAAM,CAAC,8BAAmB,CAAC,CAAC;AAEnC,wBAAwB;AACxB,MAAM,CAAC,MAAM,CAAC,+BAAmB,CAAC,CAAC;AAEnC,sBAAsB;AACtB,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;AAC1D,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,iBAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;AAC5D,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAC/D,MAAM,CAAC,UAAU,CAAC,kBAAkB,EAAE,iBAAK,CAAC,QAAQ,CAAC,iBAAK,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;AACrF,MAAM,CAAC,UAAU,CAAC,iBAAiB,EAAE,iBAAK,CAAC,IAAI,CAAC,CAAC;AACjD,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,iBAAK,CAAC,IAAI,CAAC,CAAC;AAC9C,MAAM,CAAC,UAAU,CAAC,eAAe,EAAE,iBAAK,CAAC,QAAQ,CAAC,iBAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAChE,MAAM,CAAC,UAAU,CAAC,eAAe,EAAE,iBAAK,CAAC,IAAI,CAAC,CAAC;AAC/C,MAAM,CAAC,UAAU,CAAC,aAAa,EAAE,iBAAK,CAAC,IAAI,CAAC,CAAC;AAE7C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,CAAC,4BAAiB,CAAC,CAAC;AAEjC,kBAAe,MAAM,CAAC","sourcesContent":["import configurableOptions from './configurable-options';\nimport deprecatedOptions from './deprecated-options';\nimport incompatibleOptions from './incompatible-options';\nimport strictFamilyOptions from './strict-family-options';\nimport { Match, RuleSet, RuleType } from '../validator';\n\n// The public rule set used for the \"strict\" tsconfig validation setting.\n// The goal of this rule set is to ensure a tsconfig that is following best practices for jsii.\n// In practice, this is a combination of known incompatible options, known configurable options and additional best practices.\n// The rule set also explicitly disallows unknown options.\nconst strict = new RuleSet({\n  unexpectedFields: RuleType.FAIL,\n});\n\n// import all options that are configurable\nstrict.import(configurableOptions);\n\n// import all options that are definitely incompatible\nstrict.import(incompatibleOptions);\n\n// strict family options\nstrict.import(strictFamilyOptions);\n\n// Best practice rules\nstrict.shouldPass('target', Match.eq('es2022')); // node18\nstrict.shouldPass('lib', Match.arrEq(['es2022'])); // node18\nstrict.shouldPass('module', Match.oneOf('node16', 'commonjs'));\nstrict.shouldPass('moduleResolution', Match.optional(Match.oneOf('node', 'node16')));\nstrict.shouldPass('esModuleInterop', Match.TRUE);\nstrict.shouldPass('skipLibCheck', Match.TRUE);\nstrict.shouldPass('stripInternal', Match.optional(Match.FALSE));\nstrict.shouldPass('noEmitOnError', Match.TRUE);\nstrict.shouldPass('declaration', Match.TRUE);\n\n// Deprecated ts options that should not be used with jsii\nstrict.import(deprecatedOptions);\n\nexport default strict;\n"]}
+{"version":3,"file":"strict.public.js","sourceRoot":"","sources":["../../../src/tsconfig/rulesets/strict.public.ts"],"names":[],"mappings":";;;;;AAAA,kFAAyD;AACzD,8EAAqD;AACrD,kFAAyD;AACzD,oFAA0D;AAC1D,4CAAwD;AAExD,yEAAyE;AACzE,+FAA+F;AAC/F,8HAA8H;AAC9H,0DAA0D;AAC1D,MAAM,MAAM,GAAG,IAAI,mBAAO,CAAC;IACzB,gBAAgB,EAAE,oBAAQ,CAAC,IAAI;CAChC,CAAC,CAAC;AAEH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,CAAC,8BAAmB,CAAC,CAAC;AAEnC,sDAAsD;AACtD,MAAM,CAAC,MAAM,CAAC,8BAAmB,CAAC,CAAC;AAEnC,wBAAwB;AACxB,MAAM,CAAC,MAAM,CAAC,+BAAmB,CAAC,CAAC;AAEnC,sBAAsB;AACtB,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU;AAClF,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,iBAAK,CAAC,KAAK,CAAC,iBAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,iBAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,iBAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU;AAC5H,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAC/F,MAAM,CAAC,UAAU,CAAC,kBAAkB,EAAE,iBAAK,CAAC,QAAQ,CAAC,iBAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;AACpG,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,iBAAK,CAAC,IAAI,CAAC,CAAC;AAC9C,MAAM,CAAC,UAAU,CAAC,eAAe,EAAE,iBAAK,CAAC,QAAQ,CAAC,iBAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAChE,MAAM,CAAC,UAAU,CAAC,eAAe,EAAE,iBAAK,CAAC,IAAI,CAAC,CAAC;AAC/C,MAAM,CAAC,UAAU,CAAC,aAAa,EAAE,iBAAK,CAAC,IAAI,CAAC,CAAC;AAC7C,MAAM,CAAC,UAAU,CAAC,8BAA8B,EAAE,iBAAK,CAAC,QAAQ,CAAC,iBAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAE9E,0DAA0D;AAC1D,MAAM,CAAC,MAAM,CAAC,4BAAiB,CAAC,CAAC;AAEjC,kBAAe,MAAM,CAAC","sourcesContent":["import configurableOptions from './configurable-options';\nimport deprecatedOptions from './deprecated-options';\nimport incompatibleOptions from './incompatible-options';\nimport strictFamilyOptions from './strict-family-options';\nimport { Match, RuleSet, RuleType } from '../validator';\n\n// The public rule set used for the \"strict\" tsconfig validation setting.\n// The goal of this rule set is to ensure a tsconfig that is following best practices for jsii.\n// In practice, this is a combination of known incompatible options, known configurable options and additional best practices.\n// The rule set also explicitly disallows unknown options.\nconst strict = new RuleSet({\n  unexpectedFields: RuleType.FAIL,\n});\n\n// import all options that are configurable\nstrict.import(configurableOptions);\n\n// import all options that are definitely incompatible\nstrict.import(incompatibleOptions);\n\n// strict family options\nstrict.import(strictFamilyOptions);\n\n// Best practice rules\nstrict.shouldPass('target', Match.oneOf('es2022', 'es2023', 'esnext')); // node18+\nstrict.shouldPass('lib', Match.anyOf(Match.arrEq(['es2022']), Match.arrEq(['es2023']), Match.arrEq(['esnext']))); // node18+\nstrict.shouldPass('module', Match.oneOf('node16', 'node18', 'node20', 'nodenext', 'commonjs'));\nstrict.shouldPass('moduleResolution', Match.optional(Match.oneOf('node16', 'nodenext', 'bundler')));\nstrict.shouldPass('skipLibCheck', Match.TRUE);\nstrict.shouldPass('stripInternal', Match.optional(Match.FALSE));\nstrict.shouldPass('noEmitOnError', Match.TRUE);\nstrict.shouldPass('declaration', Match.TRUE);\nstrict.shouldPass('noUncheckedSideEffectImports', Match.optional(Match.TRUE));\n\n// Deprecated ts options that should not be used with jsii\nstrict.import(deprecatedOptions);\n\nexport default strict;\n"]}

package/lib/tsconfig/tsconfig-validator.d.ts

@@ -1,4 +1,5 @@
 import { TypeScriptConfig, TypeScriptConfigValidationRuleSet } from '.';
+import { RuleDescription, RuleSet, Violation } from './validator';
 export declare class TypeScriptConfigValidator {
     ruleSet: TypeScriptConfigValidationRuleSet;
     private readonly validator;
@@ -13,4 +14,42 @@ export declare class TypeScriptConfigValidator {
      */
     validate(tsconfig: TypeScriptConfig): void;
 }
+/**
+ * Returns the `compilerOptions` rule set that backs the given validation setting.
+ *
+ * These are the substantive, set-specific rules (the top-level rules such as
+ * `files`/`include`/`exclude` are identical across all sets). The `off` rule set
+ * is empty, as it disables validation.
+ *
+ * @param ruleSet the validation setting to look up
+ * @returns the `RuleSet` applied to `compilerOptions`
+ */
+export declare function getCompilerOptionsRuleSet(ruleSet: TypeScriptConfigValidationRuleSet): RuleSet;
+/**
+ * Produces a human-readable description of every `compilerOptions` rule in a rule set.
+ *
+ * @param ruleSet the validation setting to describe
+ * @returns a description for every rule in the set
+ */
+export declare function describeRuleSet(ruleSet: TypeScriptConfigValidationRuleSet): RuleDescription[];
+/**
+ * Reads and parses a `tsconfig.json` file from disk into the format expected by
+ * the validator. This resolves `extends` and normalizes the options the same way
+ * the compiler does, so validation behaves identically to a real compilation.
+ *
+ * @param configPath the path to the tsconfig file to read
+ * @throws {@link JsiiError} if the file cannot be read or parsed
+ * @returns the parsed TypeScript configuration
+ */
+export declare function readTypeScriptConfig(configPath: string): TypeScriptConfig;
+/**
+ * Reads a `tsconfig.json` file from disk and validates its `compilerOptions`
+ * against the given rule set, without running a compilation.
+ *
+ * @param configPath the path to the tsconfig file to validate
+ * @param ruleSet the rule set to validate against
+ * @throws {@link JsiiError} if the file cannot be read or parsed
+ * @returns the list of rule violations (empty if the config is valid)
+ */
+export declare function validateTypeScriptConfigFile(configPath: string, ruleSet: TypeScriptConfigValidationRuleSet): Violation[];
 //# sourceMappingURL=tsconfig-validator.d.ts.map

package/lib/tsconfig/tsconfig-validator.js

@@ -1,9 +1,53 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TypeScriptConfigValidator = void 0;
-const generated_public_1 = require("./rulesets/generated.public");
-const minimal_public_1 = require("./rulesets/minimal.public");
-const strict_public_1 = require("./rulesets/strict.public");
+exports.getCompilerOptionsRuleSet = getCompilerOptionsRuleSet;
+exports.describeRuleSet = describeRuleSet;
+exports.readTypeScriptConfig = readTypeScriptConfig;
+exports.validateTypeScriptConfigFile = validateTypeScriptConfigFile;
+const path = __importStar(require("node:path"));
+const ts = __importStar(require("typescript"));
+const compiler_options_1 = require("./compiler-options");
+const utils_1 = require("../utils");
+const generated_public_1 = __importDefault(require("./rulesets/generated.public"));
+const minimal_public_1 = __importDefault(require("./rulesets/minimal.public"));
+const strict_public_1 = __importDefault(require("./rulesets/strict.public"));
 const validator_1 = require("./validator");
 const RuleSets = {
     generated: generated_public_1.default,
@@ -12,6 +56,9 @@ const RuleSets = {
     off: new validator_1.RuleSet(),
 };
 class TypeScriptConfigValidator {
+    ruleSet;
+    validator;
+    compilerOptions;
     constructor(ruleSet) {
         this.ruleSet = ruleSet;
         const topLevelRules = new validator_1.RuleSet({
@@ -43,4 +90,78 @@ class TypeScriptConfigValidator {
     }
 }
 exports.TypeScriptConfigValidator = TypeScriptConfigValidator;
+/**
+ * Returns the `compilerOptions` rule set that backs the given validation setting.
+ *
+ * These are the substantive, set-specific rules (the top-level rules such as
+ * `files`/`include`/`exclude` are identical across all sets). The `off` rule set
+ * is empty, as it disables validation.
+ *
+ * @param ruleSet the validation setting to look up
+ * @returns the `RuleSet` applied to `compilerOptions`
+ */
+function getCompilerOptionsRuleSet(ruleSet) {
+    return RuleSets[ruleSet];
+}
+/**
+ * Produces a human-readable description of every `compilerOptions` rule in a rule set.
+ *
+ * @param ruleSet the validation setting to describe
+ * @returns a description for every rule in the set
+ */
+function describeRuleSet(ruleSet) {
+    return getCompilerOptionsRuleSet(ruleSet).describe();
+}
+/**
+ * Reads and parses a `tsconfig.json` file from disk into the format expected by
+ * the validator. This resolves `extends` and normalizes the options the same way
+ * the compiler does, so validation behaves identically to a real compilation.
+ *
+ * @param configPath the path to the tsconfig file to read
+ * @throws {@link JsiiError} if the file cannot be read or parsed
+ * @returns the parsed TypeScript configuration
+ */
+function readTypeScriptConfig(configPath) {
+    const absolutePath = path.resolve(configPath);
+    const { config, error } = ts.readConfigFile(absolutePath, ts.sys.readFile);
+    if (error) {
+        throw new utils_1.JsiiError(`Failed to read tsconfig at "${configPath}": ${ts.flattenDiagnosticMessageText(error.messageText, '\n')}`);
+    }
+    const basePath = path.dirname(absolutePath);
+    const extended = ts.parseJsonConfigFileContent(config, ts.sys, basePath);
+    // the tsconfig parser adds this in, but it is not an expected compilerOption
+    delete extended.options.configFilePath;
+    return {
+        compilerOptions: extended.options,
+        watchOptions: extended.watchOptions,
+        include: extended.fileNames,
+    };
+}
+/**
+ * Reads a `tsconfig.json` file from disk and validates its `compilerOptions`
+ * against the given rule set, without running a compilation.
+ *
+ * @param configPath the path to the tsconfig file to validate
+ * @param ruleSet the rule set to validate against
+ * @throws {@link JsiiError} if the file cannot be read or parsed
+ * @returns the list of rule violations (empty if the config is valid)
+ */
+function validateTypeScriptConfigFile(configPath, ruleSet) {
+    const config = readTypeScriptConfig(configPath);
+    const validator = new TypeScriptConfigValidator(ruleSet);
+    try {
+        validator.validate({
+            ...config,
+            // convert the internal format to the user format which is what the validator operates on
+            compilerOptions: (0, compiler_options_1.convertForJson)(config.compilerOptions),
+        });
+        return [];
+    }
+    catch (error) {
+        if (error instanceof validator_1.ValidationError) {
+            return error.violations;
+        }
+        throw error;
+    }
+}
 //# sourceMappingURL=tsconfig-validator.js.map

package/lib/tsconfig/tsconfig-validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"tsconfig-validator.js","sourceRoot":"","sources":["../../src/tsconfig/tsconfig-validator.ts"],"names":[],"mappings":";;;AACA,kEAAoD;AACpD,8DAAgD;AAChD,4DAA8C;AAC9C,2CAAwE;AAExE,MAAM,QAAQ,GAEV;IACF,SAAS,EAAT,0BAAS;IACT,MAAM,EAAN,uBAAM;IACN,OAAO,EAAP,wBAAO;IACP,GAAG,EAAE,IAAI,mBAAO,EAAE;CACnB,CAAC;AAEF,MAAa,yBAAyB;IAIpC,YAA0B,OAA0C;QAA1C,YAAO,GAAP,OAAO,CAAmC;QAClE,MAAM,aAAa,GAAG,IAAI,mBAAO,CAAC;YAChC,gBAAgB,EAAE,oBAAQ,CAAC,IAAI;SAChC,CAAC,CAAC;QACH,aAAa,CAAC,UAAU,CAAC,OAAO,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;QAC7C,aAAa,CAAC,UAAU,CAAC,SAAS,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;QAC/C,aAAa,CAAC,UAAU,CAAC,SAAS,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;QAC/C,aAAa,CAAC,UAAU,CAAC,SAAS,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;QAC/C,aAAa,CAAC,UAAU,CAAC,YAAY,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;QAClD,aAAa,CAAC,UAAU,CAAC,cAAc,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;QACpD,aAAa,CAAC,UAAU,CAAC,iBAAiB,EAAE,iBAAK,CAAC,OAAO,CAAC,CAAC;QAE3D,IAAI,CAAC,eAAe,GAAG,IAAI,2BAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAC;QACjF,aAAa,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,eAAe,EAAE,EAAE;YAC9D,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,IAAI,2BAAe,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;OAMG;IACI,QAAQ,CAAC,QAA0B;QACxC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;CACF;AAnCD,8DAmCC","sourcesContent":["import { TypeScriptConfig, TypeScriptConfigValidationRuleSet } from '.';\nimport generated from './rulesets/generated.public';\nimport minimal from './rulesets/minimal.public';\nimport strict from './rulesets/strict.public';\nimport { Match, ObjectValidator, RuleSet, RuleType } from './validator';\n\nconst RuleSets: {\n  [name in TypeScriptConfigValidationRuleSet]: RuleSet;\n} = {\n  generated,\n  strict,\n  minimal,\n  off: new RuleSet(),\n};\n\nexport class TypeScriptConfigValidator {\n  private readonly validator: ObjectValidator;\n  private readonly compilerOptions: ObjectValidator;\n\n  public constructor(public ruleSet: TypeScriptConfigValidationRuleSet) {\n    const topLevelRules = new RuleSet({\n      unexpectedFields: RuleType.PASS,\n    });\n    topLevelRules.shouldPass('files', Match.ANY);\n    topLevelRules.shouldPass('extends', Match.ANY);\n    topLevelRules.shouldPass('include', Match.ANY);\n    topLevelRules.shouldPass('exclude', Match.ANY);\n    topLevelRules.shouldPass('references', Match.ANY);\n    topLevelRules.shouldPass('watchOptions', Match.ANY);\n    topLevelRules.shouldPass('typeAcquisition', Match.MISSING);\n\n    this.compilerOptions = new ObjectValidator(RuleSets[ruleSet], 'compilerOptions');\n    topLevelRules.shouldPass('compilerOptions', (compilerOptions) => {\n      this.compilerOptions.validate(compilerOptions);\n      return true;\n    });\n\n    this.validator = new ObjectValidator(topLevelRules, 'tsconfig');\n  }\n\n  /**\n   * Validated the provided config against the set of rules.\n   *\n   * @throws when the config is invalid\n   *\n   * @param tsconfig the tsconfig to be validated, this MUST be a tsconfig as a user would have written it in tsconfig.\n   */\n  public validate(tsconfig: TypeScriptConfig) {\n    this.validator.validate(tsconfig);\n  }\n}\n"]}
+{"version":3,"file":"tsconfig-validator.js","sourceRoot":"","sources":["../../src/tsconfig/tsconfig-validator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkEA,8DAEC;AAQD,0CAEC;AAWD,oDAmBC;AAWD,oEAmBC;AA1ID,gDAAkC;AAClC,+CAAiC;AAEjC,yDAAoD;AACpD,oCAAqC;AACrC,mFAAoD;AACpD,+EAAgD;AAChD,6EAA8C;AAC9C,2CAAqH;AAErH,MAAM,QAAQ,GAEV;IACF,SAAS,EAAT,0BAAS;IACT,MAAM,EAAN,uBAAM;IACN,OAAO,EAAP,wBAAO;IACP,GAAG,EAAE,IAAI,mBAAO,EAAE;CACnB,CAAC;AAEF,MAAa,yBAAyB;IAIV;IAHT,SAAS,CAAkB;IAC3B,eAAe,CAAkB;IAElD,YAA0B,OAA0C;QAA1C,YAAO,GAAP,OAAO,CAAmC;QAClE,MAAM,aAAa,GAAG,IAAI,mBAAO,CAAC;YAChC,gBAAgB,EAAE,oBAAQ,CAAC,IAAI;SAChC,CAAC,CAAC;QACH,aAAa,CAAC,UAAU,CAAC,OAAO,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;QAC7C,aAAa,CAAC,UAAU,CAAC,SAAS,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;QAC/C,aAAa,CAAC,UAAU,CAAC,SAAS,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;QAC/C,aAAa,CAAC,UAAU,CAAC,SAAS,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;QAC/C,aAAa,CAAC,UAAU,CAAC,YAAY,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;QAClD,aAAa,CAAC,UAAU,CAAC,cAAc,EAAE,iBAAK,CAAC,GAAG,CAAC,CAAC;QACpD,aAAa,CAAC,UAAU,CAAC,iBAAiB,EAAE,iBAAK,CAAC,OAAO,CAAC,CAAC;QAE3D,IAAI,CAAC,eAAe,GAAG,IAAI,2BAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAC;QACjF,aAAa,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,eAAe,EAAE,EAAE;YAC9D,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,IAAI,2BAAe,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;OAMG;IACI,QAAQ,CAAC,QAA0B;QACxC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;CACF;AAnCD,8DAmCC;AAED;;;;;;;;;GASG;AACH,SAAgB,yBAAyB,CAAC,OAA0C;IAClF,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,OAA0C;IACxE,OAAO,yBAAyB,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;AACvD,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,oBAAoB,CAAC,UAAkB;IACrD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9C,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,YAAY,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3E,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,iBAAS,CACjB,+BAA+B,UAAU,MAAM,EAAE,CAAC,4BAA4B,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,CAC1G,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,EAAE,CAAC,0BAA0B,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACzE,6EAA6E;IAC7E,OAAO,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC;IAEvC,OAAO;QACL,eAAe,EAAE,QAAQ,CAAC,OAAO;QACjC,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,OAAO,EAAE,QAAQ,CAAC,SAAS;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,4BAA4B,CAC1C,UAAkB,EAClB,OAA0C;IAE1C,MAAM,MAAM,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,IAAI,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,SAAS,CAAC,QAAQ,CAAC;YACjB,GAAG,MAAM;YACT,yFAAyF;YACzF,eAAe,EAAE,IAAA,iCAAc,EAAC,MAAM,CAAC,eAAe,CAAC;SACxD,CAAC,CAAC;QACH,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,KAAK,YAAY,2BAAe,EAAE,CAAC;YACrC,OAAO,KAAK,CAAC,UAAU,CAAC;QAC1B,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["import * as path from 'node:path';\nimport * as ts from 'typescript';\nimport { TypeScriptConfig, TypeScriptConfigValidationRuleSet } from '.';\nimport { convertForJson } from './compiler-options';\nimport { JsiiError } from '../utils';\nimport generated from './rulesets/generated.public';\nimport minimal from './rulesets/minimal.public';\nimport strict from './rulesets/strict.public';\nimport { Match, ObjectValidator, RuleDescription, RuleSet, RuleType, ValidationError, Violation } from './validator';\n\nconst RuleSets: {\n  [name in TypeScriptConfigValidationRuleSet]: RuleSet;\n} = {\n  generated,\n  strict,\n  minimal,\n  off: new RuleSet(),\n};\n\nexport class TypeScriptConfigValidator {\n  private readonly validator: ObjectValidator;\n  private readonly compilerOptions: ObjectValidator;\n\n  public constructor(public ruleSet: TypeScriptConfigValidationRuleSet) {\n    const topLevelRules = new RuleSet({\n      unexpectedFields: RuleType.PASS,\n    });\n    topLevelRules.shouldPass('files', Match.ANY);\n    topLevelRules.shouldPass('extends', Match.ANY);\n    topLevelRules.shouldPass('include', Match.ANY);\n    topLevelRules.shouldPass('exclude', Match.ANY);\n    topLevelRules.shouldPass('references', Match.ANY);\n    topLevelRules.shouldPass('watchOptions', Match.ANY);\n    topLevelRules.shouldPass('typeAcquisition', Match.MISSING);\n\n    this.compilerOptions = new ObjectValidator(RuleSets[ruleSet], 'compilerOptions');\n    topLevelRules.shouldPass('compilerOptions', (compilerOptions) => {\n      this.compilerOptions.validate(compilerOptions);\n      return true;\n    });\n\n    this.validator = new ObjectValidator(topLevelRules, 'tsconfig');\n  }\n\n  /**\n   * Validated the provided config against the set of rules.\n   *\n   * @throws when the config is invalid\n   *\n   * @param tsconfig the tsconfig to be validated, this MUST be a tsconfig as a user would have written it in tsconfig.\n   */\n  public validate(tsconfig: TypeScriptConfig) {\n    this.validator.validate(tsconfig);\n  }\n}\n\n/**\n * Returns the `compilerOptions` rule set that backs the given validation setting.\n *\n * These are the substantive, set-specific rules (the top-level rules such as\n * `files`/`include`/`exclude` are identical across all sets). The `off` rule set\n * is empty, as it disables validation.\n *\n * @param ruleSet the validation setting to look up\n * @returns the `RuleSet` applied to `compilerOptions`\n */\nexport function getCompilerOptionsRuleSet(ruleSet: TypeScriptConfigValidationRuleSet): RuleSet {\n  return RuleSets[ruleSet];\n}\n\n/**\n * Produces a human-readable description of every `compilerOptions` rule in a rule set.\n *\n * @param ruleSet the validation setting to describe\n * @returns a description for every rule in the set\n */\nexport function describeRuleSet(ruleSet: TypeScriptConfigValidationRuleSet): RuleDescription[] {\n  return getCompilerOptionsRuleSet(ruleSet).describe();\n}\n\n/**\n * Reads and parses a `tsconfig.json` file from disk into the format expected by\n * the validator. This resolves `extends` and normalizes the options the same way\n * the compiler does, so validation behaves identically to a real compilation.\n *\n * @param configPath the path to the tsconfig file to read\n * @throws {@link JsiiError} if the file cannot be read or parsed\n * @returns the parsed TypeScript configuration\n */\nexport function readTypeScriptConfig(configPath: string): TypeScriptConfig {\n  const absolutePath = path.resolve(configPath);\n  const { config, error } = ts.readConfigFile(absolutePath, ts.sys.readFile);\n  if (error) {\n    throw new JsiiError(\n      `Failed to read tsconfig at \"${configPath}\": ${ts.flattenDiagnosticMessageText(error.messageText, '\\n')}`,\n    );\n  }\n\n  const basePath = path.dirname(absolutePath);\n  const extended = ts.parseJsonConfigFileContent(config, ts.sys, basePath);\n  // the tsconfig parser adds this in, but it is not an expected compilerOption\n  delete extended.options.configFilePath;\n\n  return {\n    compilerOptions: extended.options,\n    watchOptions: extended.watchOptions,\n    include: extended.fileNames,\n  };\n}\n\n/**\n * Reads a `tsconfig.json` file from disk and validates its `compilerOptions`\n * against the given rule set, without running a compilation.\n *\n * @param configPath the path to the tsconfig file to validate\n * @param ruleSet the rule set to validate against\n * @throws {@link JsiiError} if the file cannot be read or parsed\n * @returns the list of rule violations (empty if the config is valid)\n */\nexport function validateTypeScriptConfigFile(\n  configPath: string,\n  ruleSet: TypeScriptConfigValidationRuleSet,\n): Violation[] {\n  const config = readTypeScriptConfig(configPath);\n  const validator = new TypeScriptConfigValidator(ruleSet);\n  try {\n    validator.validate({\n      ...config,\n      // convert the internal format to the user format which is what the validator operates on\n      compilerOptions: convertForJson(config.compilerOptions),\n    });\n    return [];\n  } catch (error: unknown) {\n    if (error instanceof ValidationError) {\n      return error.violations;\n    }\n    throw error;\n  }\n}\n"]}

package/lib/tsconfig/validator.d.ts

@@ -42,6 +42,30 @@ interface Rule {
     type: RuleType;
     matcher: Matcher;
 }
+/**
+ * A human-readable description of a single rule.
+ * Intended for displaying a rule set to a user, e.g. via the CLI.
+ */
+export interface RuleDescription {
+    /**
+     * The field (compilerOption) the rule applies to.
+     */
+    readonly field: string;
+    /**
+     * Whether the value must match (`PASS`) or must not match (`FAIL`) the constraint.
+     */
+    readonly type: RuleType;
+    /**
+     * Whether the field is required to be present for the rule to pass.
+     */
+    readonly required: boolean;
+    /**
+     * The values the matcher offered as hints.
+     * For `PASS` rules these are allowed values, for `FAIL` rules these are disallowed values.
+     * `undefined` when the matcher did not offer any hints (e.g. any value is accepted).
+     */
+    readonly values?: any[];
+}
 export declare class RuleSet {
     readonly options: RuleSetOptions;
     private _rules;
@@ -93,12 +117,27 @@ export declare class RuleSet {
      * @returns A record of fields and allowed values
      */
     getFieldHints(): Record<string, any[]>;
+    /**
+     * Produces a human-readable description of every rule in the set.
+     *
+     * This is derived directly from the rules (it does not duplicate them), so it
+     * stays in sync as rules are added or changed. It is primarily intended for
+     * surfacing a rule set to a user, e.g. via the CLI.
+     *
+     * @returns A description for every rule, in the order the rules were added.
+     */
+    describe(): RuleDescription[];
 }
 export declare class Match {
     /**
      * Value is optional, but if present should match
      */
     static optional(matcher: Matcher): Matcher;
+    /**
+     * Value must match at least one of the provided matchers.
+     * All matchers are evaluated (no short-circuit) so their hints are collected.
+     */
+    static anyOf(...matchers: Matcher[]): Matcher;
     /**
      * Value must be one of the allowed options
      */