jsii-rosetta 4.9.0-dev.2 → 4.9.0-dev.3

package/README.md

@@ -278,6 +278,17 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
 This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification.
 Contributions of any kind welcome!
 
+## :gear: Maintenance & Support
+
+The applicable _Maintenance & Support policy_ can be reviewed in [SUPPORT.md](./SUPPORT.md).
+
+The current status of `jsii-rosetta` releases is:
+
+Release | Status  | Comment
+--------|---------|-----------------------------
+`1.x`   | Current | https://github.com/aws/jsii
+`4.9.x` | Preview | ![](https://img.shields.io/npm/v/jsii-rosetta/v4.9-next?label=jsii-rosetta%40v4.9-next&logo=npm)
+
 ## :balance_scale: License
 
 **jsii** is distributed under the [Apache License, Version 2.0][apache-2.0].

package/SUPPORT.md

@@ -0,0 +1,129 @@
+## Maintenance & Support Policy
+
+This document describes the Maintenance & Support Policy applicable to releases
+of the `jsii-rosetta` tool ([`npm:jsii-rosetta`](https://npmjs.com/packages/jsii-rosetta))
+with versions `4.9.x` and newer.
+
+### Versioning Scheme
+
+In-scope `jsii-rosetta` release lines use the same `major.minor` version as the
+TypeScript compiler ([`npm:typescript`](https://npmjs.com/packages/typescript))
+they are built with. This means that `jsii-rosetta@4.9.x` is built on top of
+`typescript@4.9.x`.
+
+Since the `typescript` package does not follow [Semantic Versioning][semver],
+the `jsii-rosetta` package does not eiher. The `typescript` compiler guarantees
+no breaking change is introduced within a given `major.minor` release line, and
+`jsii` upholds the same guarantee. As a consequence, users are advised to use
+`~` ranges (also referred to as minor-pinned ranges) when declaring dependencies
+on `jsii-rosetta`.
+
+New `jsii-rosetta` release lines will be started matching new `typescript`
+compiler releases shortly after they become `latest` (i.e: the first regular
+release of is issued).
+
+[semver]: https://semver.org
+
+### Release Lines Lifecycle Stages
+
+This Maintenance & Support Policy assigns one of the following lifecycle stages
+to each in-scope `jsii-rosetta` release line in existence:
+
+1. **Current**: The latest release line is always the **Current** one. This is
+   the release under active development, receiving new features, bug fixes and
+   security updates.
+
+1. **Maintenace**: Release lines in **Maintenance** stage are no longer
+   considered in active development, and no new features will be added to these.
+   They however continue to receive bug fixes and security updates. Users can
+   continue to use release lines in **Maintenance** stage indefinitely, but we
+   recommend they regularly upgrade to the **Current** release lines in order to
+   keep the necessary effort low.
+
+1. **End-of-Support**: Release lines in **End-of-Support** are considered
+   defunct and are no longer maintained. They no longer receive new features,
+   bug fixes, or security updates. **End-of-Support** releases may continue to
+   be usable for a period of time, but they could be indirectly broken by
+   changes in newer releases at any time. Users are advised to migrate away from
+   **End-of-Support** release lines at the earliest convenience.
+
+### Stage Transitions
+
+```mermaid
+---
+title: Release Line Lifecycle
+---
+stateDiagram-v2
+  direction LR
+
+  EoL: End-of-Support
+
+  [*] --> Current
+  Current --> Maintenance : new release line started
+  Maintenance --> EoL : after 6 months
+  EoL --> [*]
+```
+
+Whenever a new release line is started (typically with a new `x.y.0` release,
+excluding pre-releases), it becomes **Current** and the release line it replaced
+immediately enters the **Maintenace** stage.
+
+Releases stay in the **Maintenance** stage for a minimum of 6 months before they
+reach **End-of-Support**.
+
+Once a release line has reached **End-of-Support**, it remains in this stage
+indefinitely.
+
+### Timelines & Communication
+
+The `typescript` compiler maintainers start a new release line on a quarterly
+basis, and users should expect the `jsii-rosetta` maintainers to do the same.
+Users should expect some small code changes may be necessary when upgrading from
+one release line to another, as a result of breaking changes introduced by the
+`typescript` compiler or `jsii-rosetta` itself. In either case, the release
+notes for the first release in a line includes the relevant information about
+the breaking changes and instructions for users to fix their codebase.
+
+The `jsii-rosetta` tool has a built-in mechanism to inform users that they are
+using an unsupported or soon-to-become unsupported release line. A message is
+emitted to `STDERR` when invoking the `jsii-rosetta` command if the current
+release is:
+
+- **End-of-Support** already
+- Planned to move to **End-of-Support** within the next 30 calendar days
+
+The built-in messaging can only be expected to deliver the message if the
+tool is on the latest available release within the line, or if the environment
+in which the tool is run is able to download the lifecycle manifest document.
+
+The current status of `jsii-rosetta` tool release lines is also documented on
+the [repository's `README.md` document][readme].
+
+### Modification
+
+The maintainers of the jsii project reserve the right to modify this Maintenance
+and Support Policy as necessary. Updates will be proposed by way of a pull
+request updating this document. Updates that materially affect the support
+timeline of release lines will be broadly announced to the community via
+established communication channels (such as the `cdk.dev` Slack), and will
+remain open for the community to comment on for a minimum of 15 days.
+
+Community members are welcome to propose changes to the support and maintenace
+policy through the same process.
+
+### Derogation
+
+Under _exceptional_ circumstances, the project maintainers may elect to derogate
+from this Support & Maintenance Policy. In cases where the decisision to
+derogate extends supplemental maintenance & support coverage for a release line,
+the increased coverage will be documented in the
+[repository's `README.md` document][readme].
+
+However, in situations where the derogation results in reduced support for one
+or more release lines, the decision to derogate is considered a "break glass"
+event and maintainers will document the motivation for the derogation, as well
+as provide the post-mortem analysis to determine and address the reason
+why this decision has to be taken, including an action plan put in place to
+ensure the same situation does not occur again in the future.
+
+[readme]: ./README.md

package/lib/main.js

@@ -16,8 +16,10 @@ const languages_1 = require("./languages");
 const python_1 = require("./languages/python");
 const visualize_1 = require("./languages/visualize");
 const logging = require("./logging");
+const support_1 = require("./support");
 const util_1 = require("./util");
-function main() {
+async function main() {
+    await (0, support_1.emitSupportPolicyInformation)();
     const argv = yargs
         .usage('$0 <cmd> [args]')
         .option('verbose', {
@@ -460,5 +462,8 @@ function handleDiagnostics(diagnostics, fail, snippetCount = 1) {
 function roundPercentage(num) {
     return Math.round(10000 * num) / 100;
 }
-main();
+main().catch((cause) => {
+    console.error(cause);
+    process.exitCode = -1;
+});
 //# sourceMappingURL=main.js.map

package/lib/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"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","sourcesContent":["import '@jsii/check-node/run';\n\nimport { promises as fs } from 'node:fs';\nimport * as path from 'node:path';\nimport * as yargs from 'yargs';\n\nimport { translateMarkdown } from './commands/convert';\nimport { checkCoverage } from './commands/coverage';\nimport { extractAndInfuse, extractSnippets, ExtractOptions } from './commands/extract';\nimport { infuse, DEFAULT_INFUSION_RESULTS_NAME } from './commands/infuse';\nimport { readTablet } from './commands/read';\nimport { transliterateAssembly } from './commands/transliterate';\nimport { trimCache } from './commands/trim-cache';\nimport { TranslateResult, translateTypeScript, RosettaDiagnostic } from './index';\nimport { TargetLanguage } from './languages';\nimport { PythonVisitor } from './languages/python';\nimport { VisualizeAstVisitor } from './languages/visualize';\nimport * as logging from './logging';\nimport { File, fmap, printDiagnostics } from './util';\n\nfunction main() {\n  const argv = yargs\n    .usage('$0 <cmd> [args]')\n    .option('verbose', {\n      alias: 'v',\n      type: 'boolean',\n      desc: 'Increase logging verbosity',\n      count: true,\n      default: 0,\n    })\n    .command(\n      'snippet FILE',\n      'Translate a single snippet',\n      (command) =>\n        command\n          .positional('FILE', {\n            type: 'string',\n            describe: 'The file to translate (leave out for stdin)',\n          })\n          .option('python', {\n            alias: 'p',\n            boolean: true,\n            description: 'Translate snippets to Python',\n          }),\n      wrapHandler(async (args) => {\n        const result = translateTypeScript(await makeFileSource(args.FILE ?? '-', 'stdin.ts'), makeVisitor(args));\n        handleSingleResult(result);\n      }),\n    )\n    .command(\n      'markdown FILE',\n      'Translate a MarkDown file',\n      (command) =>\n        command\n          .positional('FILE', {\n            type: 'string',\n            describe: 'The file to translate (leave out for stdin)',\n          })\n          .option('python', {\n            alias: 'p',\n            boolean: true,\n            description: 'Translate snippets to Python',\n          }),\n      wrapHandler(async (args) => {\n        const result = translateMarkdown(await makeFileSource(args.FILE ?? '-', 'stdin.md'), makeVisitor(args));\n        handleSingleResult(result);\n      }),\n    )\n    .command(\n      'infuse [ASSEMBLY..]',\n      '(EXPERIMENTAL) mutates one or more assemblies by adding documentation examples to top-level types',\n      (command) =>\n        command\n          .positional('ASSEMBLY', {\n            type: 'string',\n            array: true,\n            default: [],\n            describe: 'Assembly or directory to mutate',\n          })\n          .option('log-file', {\n            alias: 'l',\n            type: 'string',\n            describe: 'Output file to store logging results. Ignored if -log is not true',\n            default: DEFAULT_INFUSION_RESULTS_NAME,\n          })\n          .option('cache-from', {\n            alias: 'C',\n            type: 'string',\n            // eslint-disable-next-line prettier/prettier\n            describe:\n              'Reuse translations from the given tablet file if the snippet and type definitions did not change',\n            requiresArg: true,\n            default: undefined,\n          })\n          .option('cache-to', {\n            alias: 'o',\n            type: 'string',\n            describe: 'Append all translated snippets to the given tablet file',\n            requiresArg: true,\n            default: undefined,\n          })\n          .option('cache', {\n            alias: 'k',\n            type: 'string',\n            describe: 'Alias for --cache-from and --cache-to together',\n            requiresArg: true,\n            default: undefined,\n          })\n          .conflicts('cache', 'cache-from')\n          .conflicts('cache', 'cache-to'),\n      wrapHandler(async (args) => {\n        const absAssemblies = (args.ASSEMBLY.length > 0 ? args.ASSEMBLY : ['.']).map((x) => path.resolve(x));\n        const absCacheFrom = fmap(args.cache ?? args['cache-from'], path.resolve);\n        const absCacheTo = fmap(args.cache ?? args['cache-to'], path.resolve);\n        const result = await infuse(absAssemblies, {\n          logFile: args['log-file'],\n          cacheToFile: absCacheTo,\n          cacheFromFile: absCacheFrom,\n        });\n\n        let totalTypes = 0;\n        let insertedExamples = 0;\n        for (const [directory, map] of Object.entries(result.coverageResults)) {\n          const commonName = directory.split('/').pop()!;\n          const newCoverage = roundPercentage(map.typesWithInsertedExamples / map.types);\n          process.stdout.write(\n            `${commonName}: Added ${map.typesWithInsertedExamples} examples to ${map.types} types.\\n`,\n          );\n          process.stdout.write(`${commonName}: New coverage: ${newCoverage}%.\\n`);\n\n          insertedExamples += map.typesWithInsertedExamples;\n          totalTypes += map.types;\n        }\n        const newCoverage = roundPercentage(insertedExamples / totalTypes);\n        process.stdout.write(`\\n\\nFinal Stats:\\nNew coverage: ${newCoverage}%.\\n`);\n      }),\n    )\n    .command(\n      ['extract [ASSEMBLY..]', '$0 [ASSEMBLY..]'],\n      'Extract code snippets from one or more assemblies into language tablets',\n      (command) =>\n        command\n          .positional('ASSEMBLY', {\n            type: 'string',\n            array: true,\n            default: [],\n            describe: 'Assembly or directory to extract from',\n          })\n          .option('output', {\n            type: 'string',\n            describe: 'Additional output file where to store translated samples (deprecated, alias for --cache-to)',\n            requiresArg: true,\n            default: undefined,\n          })\n          .option('compile', {\n            alias: 'c',\n            type: 'boolean',\n            describe: 'Try compiling (on by default, use --no-compile to switch off)',\n            default: true,\n          })\n          .option('directory', {\n            alias: 'd',\n            type: 'string',\n            describe: 'Working directory (for require() etc)',\n          })\n          .option('include', {\n            alias: 'i',\n            type: 'string',\n            array: true,\n            describe: 'Extract only snippets with given ids',\n            default: [],\n          })\n          .option('infuse', {\n            type: 'boolean',\n            describe: 'bundle this command with the infuse command',\n            default: false,\n          })\n          .option('fail', {\n            alias: 'f',\n            type: 'boolean',\n            describe: 'Fail if there are compilation errors',\n            default: false,\n          })\n          .option('validate-assemblies', {\n            type: 'boolean',\n            describe: 'Whether to validate loaded assemblies or not (this can be slow)',\n            default: false,\n          })\n          .option('cache-from', {\n            alias: 'C',\n            type: 'string',\n            // eslint-disable-next-line prettier/prettier\n            describe:\n              'Reuse translations from the given tablet file if the snippet and type definitions did not change',\n            requiresArg: true,\n            default: undefined,\n          })\n          .option('cache-to', {\n            alias: 'o',\n            type: 'string',\n            describe: 'Append all translated snippets to the given tablet file',\n            requiresArg: true,\n            default: undefined,\n          })\n          .conflicts('cache-to', 'output')\n          .option('cache', {\n            alias: 'k',\n            type: 'string',\n            describe: 'Alias for --cache-from and --cache-to together',\n            requiresArg: true,\n            default: undefined,\n          })\n          .conflicts('cache', 'cache-from')\n          .conflicts('cache', 'cache-to')\n          .option('trim-cache', {\n            alias: 'T',\n            type: 'boolean',\n            describe: 'Remove translations that are not referenced by any of the assemblies anymore from the cache',\n          })\n          .option('strict', {\n            alias: 'S',\n            type: 'boolean',\n            describe:\n              'Require all code samples compile, and fail if one does not. Strict mode always enables --compile and --fail',\n            default: false,\n          })\n          .options('loose', {\n            alias: 'l',\n            describe: 'Ignore missing fixtures and literate markdown files instead of failing',\n            type: 'boolean',\n          })\n          .options('compress-tablet', {\n            alias: 'z',\n            type: 'boolean',\n            describe: 'Compress the implicit tablet file',\n            default: false,\n          })\n          .options('compress-cache', {\n            type: 'boolean',\n            describe: 'Compress the cache-to file',\n            default: false,\n          })\n          .conflicts('loose', 'strict')\n          .conflicts('loose', 'fail'),\n      wrapHandler(async (args) => {\n        // `--strict` is short for `--compile --fail`, and we'll override those even if they're set to `false`, such as\n        // using `--no-(compile|fail)`, because yargs does not quite give us a better option that does not hurt CX.\n        if (args.strict) {\n          args.compile = args.c = true;\n          args.fail = args.f = true;\n        }\n\n        const absAssemblies = (args.ASSEMBLY.length > 0 ? args.ASSEMBLY : ['.']).map((x) => path.resolve(x));\n\n        const absCacheFrom = fmap(args.cache ?? args['cache-from'], path.resolve);\n        const absCacheTo = fmap(args.cache ?? args['cache-to'] ?? args.output, path.resolve);\n\n        const extractOptions: ExtractOptions = {\n          compilationDirectory: args.directory,\n          includeCompilerDiagnostics: !!args.compile,\n          validateAssemblies: args['validate-assemblies'],\n          only: args.include,\n          cacheFromFile: absCacheFrom,\n          cacheToFile: absCacheTo,\n          trimCache: args['trim-cache'],\n          loose: args.loose,\n          compressTablet: args['compress-tablet'],\n          compressCacheToFile: args['compress-cache'],\n        };\n\n        const result = args.infuse\n          ? await extractAndInfuse(absAssemblies, extractOptions)\n          : await extractSnippets(absAssemblies, extractOptions);\n\n        handleDiagnostics(result.diagnostics, args.fail, result.tablet.count);\n      }),\n    )\n    .command(\n      'transliterate [ASSEMBLY..]',\n      '(EXPERIMENTAL) Transliterates the designated assemblies',\n      (command) =>\n        command\n          .positional('ASSEMBLY', {\n            type: 'string',\n            array: true,\n            default: [],\n            required: true,\n            describe: 'Assembly to transliterate',\n          })\n          .option('language', {\n            alias: 'l',\n            type: 'string',\n            array: true,\n            default: [],\n            describe: 'Language ID to transliterate to',\n          })\n          .options('strict', {\n            alias: 's',\n            conflicts: 'loose',\n            describe:\n              'Fail if an example that needs live transliteration fails to compile (which could cause incorrect transpilation results)',\n            type: 'boolean',\n          })\n          .options('loose', {\n            alias: 'l',\n            conflicts: 'strict',\n            describe: 'Ignore missing fixtures and literate markdown files instead of failing',\n            type: 'boolean',\n          })\n          .option('tablet', {\n            alias: 't',\n            type: 'string',\n            describe:\n              'Language tablet containing pre-translated code examples to use (these are generated by the `extract` command)',\n          }),\n      wrapHandler((args) => {\n        const assemblies = (args.ASSEMBLY.length > 0 ? args.ASSEMBLY : ['.']).map((dir) =>\n          path.resolve(process.cwd(), dir),\n        );\n        const languages =\n          args.language.length > 0\n            ? args.language.map((lang) => {\n                const target = Object.entries(TargetLanguage).find(([k]) => k === lang)?.[1];\n                if (target == null) {\n                  throw new Error(\n                    `Unknown target language: ${lang}. Expected one of ${Object.keys(TargetLanguage).join(', ')}`,\n                  );\n                }\n                return target;\n              })\n            : Object.values(TargetLanguage);\n        return transliterateAssembly(assemblies, languages, args);\n      }),\n    )\n    .command(\n      'trim-cache <TABLET> [ASSEMBLY..]',\n      'Retain only those snippets in the cache which occur in one of the given assemblies',\n      (command) =>\n        command\n          .positional('TABLET', {\n            type: 'string',\n            required: true,\n            describe: 'Language tablet to trim',\n          })\n          .positional('ASSEMBLY', {\n            type: 'string',\n            array: true,\n            default: [],\n            describe: 'Assembly or directory to search',\n          })\n          .demandOption('TABLET'),\n      wrapHandler(async (args) => {\n        await trimCache({\n          cacheFile: args.TABLET,\n          assemblyLocations: args.ASSEMBLY,\n        });\n      }),\n    )\n    .command(\n      'coverage [ASSEMBLY..]',\n      'Check the translation coverage of implicit tablets for the given assemblies',\n      (command) =>\n        command.positional('ASSEMBLY', {\n          type: 'string',\n          array: true,\n          default: ['.'],\n          describe: 'Assembly or directory to search',\n        }),\n      wrapHandler(async (args) => {\n        const absAssemblies = (args.ASSEMBLY.length > 0 ? args.ASSEMBLY : ['.']).map((x) => path.resolve(x));\n        await checkCoverage(absAssemblies);\n      }),\n    )\n    .command(\n      'read <TABLET> [KEY] [LANGUAGE]',\n      'Display snippets in a language tablet file',\n      (command) =>\n        command\n          .positional('TABLET', {\n            type: 'string',\n            required: true,\n            describe: 'Language tablet to read',\n          })\n          .positional('KEY', {\n            type: 'string',\n            describe: 'Snippet key to read',\n          })\n          .positional('LANGUAGE', {\n            type: 'string',\n            describe: 'Language ID to read',\n          })\n          .demandOption('TABLET'),\n      wrapHandler(async (args) => {\n        await readTablet(args.TABLET, args.KEY, args.LANGUAGE);\n      }),\n    )\n    .command(\n      'configure-strict [PACKAGE]',\n      \"Enables strict mode for a package's assembly\",\n      (command) =>\n        command.positional('PACKAGE', {\n          type: 'string',\n          describe: 'The path to the package to configure',\n          required: false,\n          default: '.',\n          normalize: true,\n        }),\n      wrapHandler(async (args) => {\n        const packageJsonPath = (await fs.stat(args.PACKAGE)).isDirectory()\n          ? path.join(args.PACKAGE, 'package.json')\n          : args.PACKAGE;\n        const packageJson = JSON.parse(await fs.readFile(packageJsonPath, 'utf-8'));\n        if (packageJson.jsii == null) {\n          console.error(\n            `The package in ${args.PACKAGE} does not have a jsii configuration! You can set it up using jsii-config.`,\n          );\n          process.exitCode = 1;\n          return Promise.resolve();\n        }\n        if (packageJson.jsii.metadata?.jsii?.rosetta?.strict) {\n          // Nothing to do - it's already configured, so we assert idempotent success!\n          return Promise.resolve();\n        }\n        const md = (packageJson.jsii.metadata = packageJson.jsii.metadata ?? {});\n        const mdJsii = (md.jsii = md.jsii ?? {});\n        const mdRosetta = (mdJsii.rosetta = mdJsii.rosetta ?? {});\n        mdRosetta.strict = true;\n\n        return fs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2));\n      }),\n    )\n    .demandCommand()\n    .help()\n    .strict() // Error on wrong command\n    // eslint-disable-next-line @typescript-eslint/no-require-imports,@typescript-eslint/no-var-requires\n    .version(require('../package.json').version)\n    .showHelpOnFail(false).argv;\n\n  // Evaluating .argv triggers the parsing but the command gets implicitly executed,\n  // so we don't need the output.\n  Array.isArray(argv);\n}\n\n/**\n * Wrap a command's handler with standard pre- and post-work\n */\nfunction wrapHandler<A extends { verbose?: number }, R>(handler: (x: A) => Promise<R>) {\n  return (argv: A) => {\n    logging.configure({ level: argv.verbose !== undefined ? argv.verbose : 0 });\n    handler(argv).catch((e) => {\n      logging.error(e.message);\n      logging.error(e.stack);\n      process.exitCode = 1;\n    });\n  };\n}\n\nfunction makeVisitor(args: { python?: boolean }) {\n  if (args.python) {\n    return new PythonVisitor();\n  }\n  // Default to visualizing AST, including nodes we don't recognize yet\n  return new VisualizeAstVisitor();\n}\n\nasync function makeFileSource(fileName: string, stdinName: string): Promise<File> {\n  if (fileName === '-') {\n    return {\n      contents: await readStdin(),\n      fileName: stdinName,\n    };\n  }\n  return {\n    contents: await fs.readFile(fileName, { encoding: 'utf-8' }),\n    fileName: fileName,\n  };\n}\n\nasync function readStdin(): Promise<string> {\n  process.stdin.setEncoding('utf8');\n\n  const parts: Buffer[] = [];\n\n  return new Promise((resolve, reject) => {\n    process.stdin.on('readable', () => {\n      const chunk = process.stdin.read();\n      if (chunk !== null) {\n        parts.push(Buffer.from(chunk));\n      }\n    });\n\n    process.stdin.on('error', reject);\n    process.stdin.on('end', () => resolve(Buffer.concat(parts).toString('utf-8')));\n  });\n}\n\nfunction handleSingleResult(result: TranslateResult) {\n  process.stdout.write(`${result.translation}\\n`);\n\n  // For a single result, we always request implicit failure.\n  handleDiagnostics(result.diagnostics, 'implicit');\n}\n\n/**\n * Print diagnostics and set exit code\n *\n * 'fail' is whether or not the user passed '--fail' for commands that accept\n * it, or 'implicit' for commands that should always fail. 'implicit' will be\n * treated as 'fail=true, but will not print to the user that the '--fail' is\n * set (because for this particular command that switch does not exist and so it\n * would be confusing).\n */\nfunction handleDiagnostics(diagnostics: readonly RosettaDiagnostic[], fail: boolean | 'implicit', snippetCount = 1) {\n  if (fail !== false) {\n    // Fail on any diagnostic\n    if (diagnostics.length > 0) {\n      printDiagnostics(diagnostics, process.stderr);\n      logging.error(\n        [\n          `${diagnostics.length} diagnostics encountered in ${snippetCount} snippets`,\n          ...(fail === true ? [\"(running with '--fail')\"] : []),\n        ].join(' '),\n      );\n      process.exitCode = 1;\n    }\n\n    return;\n  }\n\n  // Otherwise fail only on strict diagnostics. If we have strict diagnostics, print only those\n  // (so it's very clear what is failing the build), otherwise print everything.\n  const strictDiagnostics = diagnostics.filter((diag) => diag.isFromStrictAssembly);\n  if (strictDiagnostics.length > 0) {\n    printDiagnostics(strictDiagnostics, process.stderr);\n    const remaining = diagnostics.length - strictDiagnostics.length;\n    logging.warn(\n      [\n        `${strictDiagnostics.length} diagnostics from assemblies with 'strict' mode on`,\n        ...(remaining > 0 ? [`(and ${remaining} more non-strict diagnostics)`] : []),\n      ].join(' '),\n    );\n    process.exitCode = 1;\n    return;\n  }\n\n  if (diagnostics.length > 0) {\n    printDiagnostics(diagnostics, process.stderr);\n    logging.warn(`${diagnostics.length} diagnostics encountered in ${snippetCount} snippets`);\n  }\n}\n\n/**\n * Rounds a decimal number to two decimal points.\n * The function is useful for fractions that need to be outputted as percentages.\n */\nfunction roundPercentage(num: number): number {\n  return Math.round(10000 * num) / 100;\n}\n\nmain();\n"]}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"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","sourcesContent":["import '@jsii/check-node/run';\n\nimport { promises as fs } from 'node:fs';\nimport * as path from 'node:path';\nimport * as yargs from 'yargs';\n\nimport { translateMarkdown } from './commands/convert';\nimport { checkCoverage } from './commands/coverage';\nimport { extractAndInfuse, extractSnippets, ExtractOptions } from './commands/extract';\nimport { infuse, DEFAULT_INFUSION_RESULTS_NAME } from './commands/infuse';\nimport { readTablet } from './commands/read';\nimport { transliterateAssembly } from './commands/transliterate';\nimport { trimCache } from './commands/trim-cache';\nimport { TranslateResult, translateTypeScript, RosettaDiagnostic } from './index';\nimport { TargetLanguage } from './languages';\nimport { PythonVisitor } from './languages/python';\nimport { VisualizeAstVisitor } from './languages/visualize';\nimport * as logging from './logging';\nimport { emitSupportPolicyInformation } from './support';\nimport { File, fmap, printDiagnostics } from './util';\n\nasync function main() {\n  await emitSupportPolicyInformation();\n\n  const argv = yargs\n    .usage('$0 <cmd> [args]')\n    .option('verbose', {\n      alias: 'v',\n      type: 'boolean',\n      desc: 'Increase logging verbosity',\n      count: true,\n      default: 0,\n    })\n    .command(\n      'snippet FILE',\n      'Translate a single snippet',\n      (command) =>\n        command\n          .positional('FILE', {\n            type: 'string',\n            describe: 'The file to translate (leave out for stdin)',\n          })\n          .option('python', {\n            alias: 'p',\n            boolean: true,\n            description: 'Translate snippets to Python',\n          }),\n      wrapHandler(async (args) => {\n        const result = translateTypeScript(await makeFileSource(args.FILE ?? '-', 'stdin.ts'), makeVisitor(args));\n        handleSingleResult(result);\n      }),\n    )\n    .command(\n      'markdown FILE',\n      'Translate a MarkDown file',\n      (command) =>\n        command\n          .positional('FILE', {\n            type: 'string',\n            describe: 'The file to translate (leave out for stdin)',\n          })\n          .option('python', {\n            alias: 'p',\n            boolean: true,\n            description: 'Translate snippets to Python',\n          }),\n      wrapHandler(async (args) => {\n        const result = translateMarkdown(await makeFileSource(args.FILE ?? '-', 'stdin.md'), makeVisitor(args));\n        handleSingleResult(result);\n      }),\n    )\n    .command(\n      'infuse [ASSEMBLY..]',\n      '(EXPERIMENTAL) mutates one or more assemblies by adding documentation examples to top-level types',\n      (command) =>\n        command\n          .positional('ASSEMBLY', {\n            type: 'string',\n            array: true,\n            default: [],\n            describe: 'Assembly or directory to mutate',\n          })\n          .option('log-file', {\n            alias: 'l',\n            type: 'string',\n            describe: 'Output file to store logging results. Ignored if -log is not true',\n            default: DEFAULT_INFUSION_RESULTS_NAME,\n          })\n          .option('cache-from', {\n            alias: 'C',\n            type: 'string',\n            // eslint-disable-next-line prettier/prettier\n            describe:\n              'Reuse translations from the given tablet file if the snippet and type definitions did not change',\n            requiresArg: true,\n            default: undefined,\n          })\n          .option('cache-to', {\n            alias: 'o',\n            type: 'string',\n            describe: 'Append all translated snippets to the given tablet file',\n            requiresArg: true,\n            default: undefined,\n          })\n          .option('cache', {\n            alias: 'k',\n            type: 'string',\n            describe: 'Alias for --cache-from and --cache-to together',\n            requiresArg: true,\n            default: undefined,\n          })\n          .conflicts('cache', 'cache-from')\n          .conflicts('cache', 'cache-to'),\n      wrapHandler(async (args) => {\n        const absAssemblies = (args.ASSEMBLY.length > 0 ? args.ASSEMBLY : ['.']).map((x) => path.resolve(x));\n        const absCacheFrom = fmap(args.cache ?? args['cache-from'], path.resolve);\n        const absCacheTo = fmap(args.cache ?? args['cache-to'], path.resolve);\n        const result = await infuse(absAssemblies, {\n          logFile: args['log-file'],\n          cacheToFile: absCacheTo,\n          cacheFromFile: absCacheFrom,\n        });\n\n        let totalTypes = 0;\n        let insertedExamples = 0;\n        for (const [directory, map] of Object.entries(result.coverageResults)) {\n          const commonName = directory.split('/').pop()!;\n          const newCoverage = roundPercentage(map.typesWithInsertedExamples / map.types);\n          process.stdout.write(\n            `${commonName}: Added ${map.typesWithInsertedExamples} examples to ${map.types} types.\\n`,\n          );\n          process.stdout.write(`${commonName}: New coverage: ${newCoverage}%.\\n`);\n\n          insertedExamples += map.typesWithInsertedExamples;\n          totalTypes += map.types;\n        }\n        const newCoverage = roundPercentage(insertedExamples / totalTypes);\n        process.stdout.write(`\\n\\nFinal Stats:\\nNew coverage: ${newCoverage}%.\\n`);\n      }),\n    )\n    .command(\n      ['extract [ASSEMBLY..]', '$0 [ASSEMBLY..]'],\n      'Extract code snippets from one or more assemblies into language tablets',\n      (command) =>\n        command\n          .positional('ASSEMBLY', {\n            type: 'string',\n            array: true,\n            default: [],\n            describe: 'Assembly or directory to extract from',\n          })\n          .option('output', {\n            type: 'string',\n            describe: 'Additional output file where to store translated samples (deprecated, alias for --cache-to)',\n            requiresArg: true,\n            default: undefined,\n          })\n          .option('compile', {\n            alias: 'c',\n            type: 'boolean',\n            describe: 'Try compiling (on by default, use --no-compile to switch off)',\n            default: true,\n          })\n          .option('directory', {\n            alias: 'd',\n            type: 'string',\n            describe: 'Working directory (for require() etc)',\n          })\n          .option('include', {\n            alias: 'i',\n            type: 'string',\n            array: true,\n            describe: 'Extract only snippets with given ids',\n            default: [],\n          })\n          .option('infuse', {\n            type: 'boolean',\n            describe: 'bundle this command with the infuse command',\n            default: false,\n          })\n          .option('fail', {\n            alias: 'f',\n            type: 'boolean',\n            describe: 'Fail if there are compilation errors',\n            default: false,\n          })\n          .option('validate-assemblies', {\n            type: 'boolean',\n            describe: 'Whether to validate loaded assemblies or not (this can be slow)',\n            default: false,\n          })\n          .option('cache-from', {\n            alias: 'C',\n            type: 'string',\n            // eslint-disable-next-line prettier/prettier\n            describe:\n              'Reuse translations from the given tablet file if the snippet and type definitions did not change',\n            requiresArg: true,\n            default: undefined,\n          })\n          .option('cache-to', {\n            alias: 'o',\n            type: 'string',\n            describe: 'Append all translated snippets to the given tablet file',\n            requiresArg: true,\n            default: undefined,\n          })\n          .conflicts('cache-to', 'output')\n          .option('cache', {\n            alias: 'k',\n            type: 'string',\n            describe: 'Alias for --cache-from and --cache-to together',\n            requiresArg: true,\n            default: undefined,\n          })\n          .conflicts('cache', 'cache-from')\n          .conflicts('cache', 'cache-to')\n          .option('trim-cache', {\n            alias: 'T',\n            type: 'boolean',\n            describe: 'Remove translations that are not referenced by any of the assemblies anymore from the cache',\n          })\n          .option('strict', {\n            alias: 'S',\n            type: 'boolean',\n            describe:\n              'Require all code samples compile, and fail if one does not. Strict mode always enables --compile and --fail',\n            default: false,\n          })\n          .options('loose', {\n            alias: 'l',\n            describe: 'Ignore missing fixtures and literate markdown files instead of failing',\n            type: 'boolean',\n          })\n          .options('compress-tablet', {\n            alias: 'z',\n            type: 'boolean',\n            describe: 'Compress the implicit tablet file',\n            default: false,\n          })\n          .options('compress-cache', {\n            type: 'boolean',\n            describe: 'Compress the cache-to file',\n            default: false,\n          })\n          .conflicts('loose', 'strict')\n          .conflicts('loose', 'fail'),\n      wrapHandler(async (args) => {\n        // `--strict` is short for `--compile --fail`, and we'll override those even if they're set to `false`, such as\n        // using `--no-(compile|fail)`, because yargs does not quite give us a better option that does not hurt CX.\n        if (args.strict) {\n          args.compile = args.c = true;\n          args.fail = args.f = true;\n        }\n\n        const absAssemblies = (args.ASSEMBLY.length > 0 ? args.ASSEMBLY : ['.']).map((x) => path.resolve(x));\n\n        const absCacheFrom = fmap(args.cache ?? args['cache-from'], path.resolve);\n        const absCacheTo = fmap(args.cache ?? args['cache-to'] ?? args.output, path.resolve);\n\n        const extractOptions: ExtractOptions = {\n          compilationDirectory: args.directory,\n          includeCompilerDiagnostics: !!args.compile,\n          validateAssemblies: args['validate-assemblies'],\n          only: args.include,\n          cacheFromFile: absCacheFrom,\n          cacheToFile: absCacheTo,\n          trimCache: args['trim-cache'],\n          loose: args.loose,\n          compressTablet: args['compress-tablet'],\n          compressCacheToFile: args['compress-cache'],\n        };\n\n        const result = args.infuse\n          ? await extractAndInfuse(absAssemblies, extractOptions)\n          : await extractSnippets(absAssemblies, extractOptions);\n\n        handleDiagnostics(result.diagnostics, args.fail, result.tablet.count);\n      }),\n    )\n    .command(\n      'transliterate [ASSEMBLY..]',\n      '(EXPERIMENTAL) Transliterates the designated assemblies',\n      (command) =>\n        command\n          .positional('ASSEMBLY', {\n            type: 'string',\n            array: true,\n            default: [],\n            required: true,\n            describe: 'Assembly to transliterate',\n          })\n          .option('language', {\n            alias: 'l',\n            type: 'string',\n            array: true,\n            default: [],\n            describe: 'Language ID to transliterate to',\n          })\n          .options('strict', {\n            alias: 's',\n            conflicts: 'loose',\n            describe:\n              'Fail if an example that needs live transliteration fails to compile (which could cause incorrect transpilation results)',\n            type: 'boolean',\n          })\n          .options('loose', {\n            alias: 'l',\n            conflicts: 'strict',\n            describe: 'Ignore missing fixtures and literate markdown files instead of failing',\n            type: 'boolean',\n          })\n          .option('tablet', {\n            alias: 't',\n            type: 'string',\n            describe:\n              'Language tablet containing pre-translated code examples to use (these are generated by the `extract` command)',\n          }),\n      wrapHandler((args) => {\n        const assemblies = (args.ASSEMBLY.length > 0 ? args.ASSEMBLY : ['.']).map((dir) =>\n          path.resolve(process.cwd(), dir),\n        );\n        const languages =\n          args.language.length > 0\n            ? args.language.map((lang) => {\n                const target = Object.entries(TargetLanguage).find(([k]) => k === lang)?.[1];\n                if (target == null) {\n                  throw new Error(\n                    `Unknown target language: ${lang}. Expected one of ${Object.keys(TargetLanguage).join(', ')}`,\n                  );\n                }\n                return target;\n              })\n            : Object.values(TargetLanguage);\n        return transliterateAssembly(assemblies, languages, args);\n      }),\n    )\n    .command(\n      'trim-cache <TABLET> [ASSEMBLY..]',\n      'Retain only those snippets in the cache which occur in one of the given assemblies',\n      (command) =>\n        command\n          .positional('TABLET', {\n            type: 'string',\n            required: true,\n            describe: 'Language tablet to trim',\n          })\n          .positional('ASSEMBLY', {\n            type: 'string',\n            array: true,\n            default: [],\n            describe: 'Assembly or directory to search',\n          })\n          .demandOption('TABLET'),\n      wrapHandler(async (args) => {\n        await trimCache({\n          cacheFile: args.TABLET,\n          assemblyLocations: args.ASSEMBLY,\n        });\n      }),\n    )\n    .command(\n      'coverage [ASSEMBLY..]',\n      'Check the translation coverage of implicit tablets for the given assemblies',\n      (command) =>\n        command.positional('ASSEMBLY', {\n          type: 'string',\n          array: true,\n          default: ['.'],\n          describe: 'Assembly or directory to search',\n        }),\n      wrapHandler(async (args) => {\n        const absAssemblies = (args.ASSEMBLY.length > 0 ? args.ASSEMBLY : ['.']).map((x) => path.resolve(x));\n        await checkCoverage(absAssemblies);\n      }),\n    )\n    .command(\n      'read <TABLET> [KEY] [LANGUAGE]',\n      'Display snippets in a language tablet file',\n      (command) =>\n        command\n          .positional('TABLET', {\n            type: 'string',\n            required: true,\n            describe: 'Language tablet to read',\n          })\n          .positional('KEY', {\n            type: 'string',\n            describe: 'Snippet key to read',\n          })\n          .positional('LANGUAGE', {\n            type: 'string',\n            describe: 'Language ID to read',\n          })\n          .demandOption('TABLET'),\n      wrapHandler(async (args) => {\n        await readTablet(args.TABLET, args.KEY, args.LANGUAGE);\n      }),\n    )\n    .command(\n      'configure-strict [PACKAGE]',\n      \"Enables strict mode for a package's assembly\",\n      (command) =>\n        command.positional('PACKAGE', {\n          type: 'string',\n          describe: 'The path to the package to configure',\n          required: false,\n          default: '.',\n          normalize: true,\n        }),\n      wrapHandler(async (args) => {\n        const packageJsonPath = (await fs.stat(args.PACKAGE)).isDirectory()\n          ? path.join(args.PACKAGE, 'package.json')\n          : args.PACKAGE;\n        const packageJson = JSON.parse(await fs.readFile(packageJsonPath, 'utf-8'));\n        if (packageJson.jsii == null) {\n          console.error(\n            `The package in ${args.PACKAGE} does not have a jsii configuration! You can set it up using jsii-config.`,\n          );\n          process.exitCode = 1;\n          return Promise.resolve();\n        }\n        if (packageJson.jsii.metadata?.jsii?.rosetta?.strict) {\n          // Nothing to do - it's already configured, so we assert idempotent success!\n          return Promise.resolve();\n        }\n        const md = (packageJson.jsii.metadata = packageJson.jsii.metadata ?? {});\n        const mdJsii = (md.jsii = md.jsii ?? {});\n        const mdRosetta = (mdJsii.rosetta = mdJsii.rosetta ?? {});\n        mdRosetta.strict = true;\n\n        return fs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2));\n      }),\n    )\n    .demandCommand()\n    .help()\n    .strict() // Error on wrong command\n    // eslint-disable-next-line @typescript-eslint/no-require-imports,@typescript-eslint/no-var-requires\n    .version(require('../package.json').version)\n    .showHelpOnFail(false).argv;\n\n  // Evaluating .argv triggers the parsing but the command gets implicitly executed,\n  // so we don't need the output.\n  Array.isArray(argv);\n}\n\n/**\n * Wrap a command's handler with standard pre- and post-work\n */\nfunction wrapHandler<A extends { verbose?: number }, R>(handler: (x: A) => Promise<R>) {\n  return (argv: A) => {\n    logging.configure({ level: argv.verbose !== undefined ? argv.verbose : 0 });\n    handler(argv).catch((e) => {\n      logging.error(e.message);\n      logging.error(e.stack);\n      process.exitCode = 1;\n    });\n  };\n}\n\nfunction makeVisitor(args: { python?: boolean }) {\n  if (args.python) {\n    return new PythonVisitor();\n  }\n  // Default to visualizing AST, including nodes we don't recognize yet\n  return new VisualizeAstVisitor();\n}\n\nasync function makeFileSource(fileName: string, stdinName: string): Promise<File> {\n  if (fileName === '-') {\n    return {\n      contents: await readStdin(),\n      fileName: stdinName,\n    };\n  }\n  return {\n    contents: await fs.readFile(fileName, { encoding: 'utf-8' }),\n    fileName: fileName,\n  };\n}\n\nasync function readStdin(): Promise<string> {\n  process.stdin.setEncoding('utf8');\n\n  const parts: Buffer[] = [];\n\n  return new Promise((resolve, reject) => {\n    process.stdin.on('readable', () => {\n      const chunk = process.stdin.read();\n      if (chunk !== null) {\n        parts.push(Buffer.from(chunk));\n      }\n    });\n\n    process.stdin.on('error', reject);\n    process.stdin.on('end', () => resolve(Buffer.concat(parts).toString('utf-8')));\n  });\n}\n\nfunction handleSingleResult(result: TranslateResult) {\n  process.stdout.write(`${result.translation}\\n`);\n\n  // For a single result, we always request implicit failure.\n  handleDiagnostics(result.diagnostics, 'implicit');\n}\n\n/**\n * Print diagnostics and set exit code\n *\n * 'fail' is whether or not the user passed '--fail' for commands that accept\n * it, or 'implicit' for commands that should always fail. 'implicit' will be\n * treated as 'fail=true, but will not print to the user that the '--fail' is\n * set (because for this particular command that switch does not exist and so it\n * would be confusing).\n */\nfunction handleDiagnostics(diagnostics: readonly RosettaDiagnostic[], fail: boolean | 'implicit', snippetCount = 1) {\n  if (fail !== false) {\n    // Fail on any diagnostic\n    if (diagnostics.length > 0) {\n      printDiagnostics(diagnostics, process.stderr);\n      logging.error(\n        [\n          `${diagnostics.length} diagnostics encountered in ${snippetCount} snippets`,\n          ...(fail === true ? [\"(running with '--fail')\"] : []),\n        ].join(' '),\n      );\n      process.exitCode = 1;\n    }\n\n    return;\n  }\n\n  // Otherwise fail only on strict diagnostics. If we have strict diagnostics, print only those\n  // (so it's very clear what is failing the build), otherwise print everything.\n  const strictDiagnostics = diagnostics.filter((diag) => diag.isFromStrictAssembly);\n  if (strictDiagnostics.length > 0) {\n    printDiagnostics(strictDiagnostics, process.stderr);\n    const remaining = diagnostics.length - strictDiagnostics.length;\n    logging.warn(\n      [\n        `${strictDiagnostics.length} diagnostics from assemblies with 'strict' mode on`,\n        ...(remaining > 0 ? [`(and ${remaining} more non-strict diagnostics)`] : []),\n      ].join(' '),\n    );\n    process.exitCode = 1;\n    return;\n  }\n\n  if (diagnostics.length > 0) {\n    printDiagnostics(diagnostics, process.stderr);\n    logging.warn(`${diagnostics.length} diagnostics encountered in ${snippetCount} snippets`);\n  }\n}\n\n/**\n * Rounds a decimal number to two decimal points.\n * The function is useful for fractions that need to be outputted as percentages.\n */\nfunction roundPercentage(num: number): number {\n  return Math.round(10000 * num) / 100;\n}\n\nmain().catch((cause) => {\n  console.error(cause);\n  process.exitCode = -1;\n});\n"]}

package/lib/support.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Checks whether the current release line is close to End-of-Support (within
+ * 30 days), or already in End-of-Support, and if that is the case, emits a
+ * warning to call the user to action.
+ *
+ * It is possible for users to opt out of these notifications by setting the
+ * `JSII_SILENCE_SUPPORT_WARNING` environment variable to any truthy value (that
+ * is, any non-empty value).
+ */
+export declare function emitSupportPolicyInformation(): Promise<void>;
+//# sourceMappingURL=support.d.ts.map

package/lib/support.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitSupportPolicyInformation = void 0;
+const node_fs_1 = require("node:fs");
+const node_https_1 = require("node:https");
+const node_path_1 = require("node:path");
+const chalk = require("chalk");
+const typescript_1 = require("typescript");
+const SILENCE_ENV_VAR = 'JSII_SILENCE_SUPPORT_WARNING';
+const THIRTY_DAYS_IN_MILLIS = 2592000000;
+/**
+ * Checks whether the current release line is close to End-of-Support (within
+ * 30 days), or already in End-of-Support, and if that is the case, emits a
+ * warning to call the user to action.
+ *
+ * It is possible for users to opt out of these notifications by setting the
+ * `JSII_SILENCE_SUPPORT_WARNING` environment variable to any truthy value (that
+ * is, any non-empty value).
+ */
+async function emitSupportPolicyInformation() {
+    if (process.env[SILENCE_ENV_VAR]) {
+        return;
+    }
+    const data = await getReleasesDocument();
+    if (data.current == typescript_1.versionMajorMinor) {
+        // Current release is not close to deprecation
+        return;
+    }
+    const endOfSupportDate = data.endOfSupport?.includes(typescript_1.versionMajorMinor)
+        ? new Date(0)
+        : data.maintenance[typescript_1.versionMajorMinor];
+    if (endOfSupportDate == null) {
+        // Don't know the status, so don't say anything...
+        return;
+    }
+    const now = new Date();
+    const inThirtyDays = new Date(now.getTime() + THIRTY_DAYS_IN_MILLIS);
+    const alternatives = Object.entries(data.maintenance)
+        .flatMap(([release, dateStr]) => {
+        const date = new Date(dateStr);
+        if (date <= inThirtyDays) {
+            return [];
+        }
+        return [{ release, date }];
+    })
+        .reduce((acc, { release, date }) => {
+        if (acc.length === 0) {
+            acc.push('', 'Other actively supported release lines include:');
+        }
+        acc.push(`- ${release} (planned End-of-Support date: ${date.toISOString()})`);
+        return acc;
+    }, new Array());
+    if (endOfSupportDate <= now) {
+        // End-of-Support already!
+        veryVisibleMessage(chalk.bgRed.white.bold, `The ${typescript_1.versionMajorMinor} release line of jsii has reached End-of-Support.`, `We strongly recommend you upgrade to the current release line (${data.current}) at your earliest convenience.`, ...alternatives);
+    }
+    else if (endOfSupportDate <= inThirtyDays) {
+        // End-of-Support within 30 days!
+        veryVisibleMessage(chalk.bgYellow.black, `The ${typescript_1.versionMajorMinor} release line of jsii will reach End-of-Support soon, on ${endOfSupportDate.toISOString()}.`, `We strongly recommend you upgrade to the current release line (${data.current}) at your earliest convenience.`, ...alternatives);
+    }
+}
+exports.emitSupportPolicyInformation = emitSupportPolicyInformation;
+/**
+ * Downloads the latest `releases.json` document from 'https://raw.githubusercontent.com/aws/jsii-rosetta/main/releases.json'
+ * if possible, or falls back to the built-in version of that file if that fails in any way.
+ */
+async function getReleasesDocument() {
+    const downloaded = await new Promise((ok, ko) => {
+        const request = (0, node_https_1.get)(new URL('https://raw.githubusercontent.com/aws/jsii-rosetta/main/releases.json'), (response) => {
+            if (response.statusCode === 404) {
+                return ok(undefined);
+            }
+            if (response.statusCode !== 200) {
+                return ko(`received error response: HTTP ${response.statusCode} - ${response.statusMessage}`);
+            }
+            response.once('error', ko);
+            const chunks = new Array();
+            response.on('data', (chunk) => chunks.push(Buffer.from(chunk)));
+            response.once('end', () => ok(Buffer.concat(chunks).toString('utf-8')));
+        });
+        request.once('abort', () => ko('request aborted'));
+        request.once('timeout', () => ko('request timed out'));
+        request.once('error', ko);
+        request.end();
+    }).catch((cause) => {
+        if (process.env.JSII_DEBUG) {
+            console.error(`Could not download releases.json from GitHub: ${cause}`);
+        }
+        undefined;
+    });
+    return JSON.parse(downloaded ?? (0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, '..', 'releases.json'), 'utf-8'), (key, value) => {
+        if (key !== 'maintenance') {
+            return value;
+        }
+        return Object.fromEntries(Object.entries(value).map(([release, date]) => [release, new Date(date)]));
+    });
+}
+function veryVisibleMessage(formatter, ...lines) {
+    if (lines.length === 0) {
+        throw new Error(`At least one line of message must be provided!`);
+    }
+    const len = Math.max(...lines.map((line) => line.length));
+    const border = formatter('!'.repeat(len + 8));
+    const spacer = formatter(`!!  ${' '.repeat(len)}  !!`);
+    console.error(border);
+    console.error(spacer);
+    for (const line of lines) {
+        console.error(formatter(`!!  ${line.padEnd(len, ' ')}  !!`));
+    }
+    console.error(spacer);
+    console.error(border);
+}
+//# sourceMappingURL=support.js.map

package/lib/support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"support.js","sourceRoot":"","sources":["../src/support.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from 'node:fs';\nimport { get } from 'node:https';\nimport { join } from 'node:path';\nimport * as chalk from 'chalk';\nimport { versionMajorMinor } from 'typescript';\n\nconst SILENCE_ENV_VAR = 'JSII_SILENCE_SUPPORT_WARNING';\nconst THIRTY_DAYS_IN_MILLIS = 2_592_000_000;\n\n/** @internal */\nexport interface ReleasesDocument {\n  /**\n   * The release line that occupies the 'Current' stage.\n   */\n  readonly current: ReleaseLine;\n  /**\n   * Release lines currently in 'Maintenance' with the date at which they are\n   * planned to go into the 'End-of-Support' stage. This date should always be\n   * set a minimum of 6 months in the future when a release line is added to the\n   * list.\n   */\n  readonly maintenance: { readonly [release: ReleaseLine]: Date };\n  /**\n   * Release lines that are currently out-of-support. This is semantically\n   * equivalent to being in the `maintenance` list with a past date, but offers\n   * slightly faster look-up.\n   */\n  readonly endOfSupport?: readonly ReleaseLine[];\n}\n\n/**\n * Checks whether the current release line is close to End-of-Support (within\n * 30 days), or already in End-of-Support, and if that is the case, emits a\n * warning to call the user to action.\n *\n * It is possible for users to opt out of these notifications by setting the\n * `JSII_SILENCE_SUPPORT_WARNING` environment variable to any truthy value (that\n * is, any non-empty value).\n */\nexport async function emitSupportPolicyInformation() {\n  if (process.env[SILENCE_ENV_VAR]) {\n    return;\n  }\n\n  const data = await getReleasesDocument();\n\n  if (data.current == versionMajorMinor) {\n    // Current release is not close to deprecation\n    return;\n  }\n\n  const endOfSupportDate = data.endOfSupport?.includes(versionMajorMinor)\n    ? new Date(0)\n    : data.maintenance[versionMajorMinor];\n  if (endOfSupportDate == null) {\n    // Don't know the status, so don't say anything...\n    return;\n  }\n\n  const now = new Date();\n  const inThirtyDays = new Date(now.getTime() + THIRTY_DAYS_IN_MILLIS);\n  const alternatives = Object.entries(data.maintenance)\n    .flatMap(([release, dateStr]) => {\n      const date = new Date(dateStr);\n      if (date <= inThirtyDays) {\n        return [];\n      }\n      return [{ release, date }];\n    })\n    .reduce((acc, { release, date }) => {\n      if (acc.length === 0) {\n        acc.push('', 'Other actively supported release lines include:');\n      }\n      acc.push(`- ${release} (planned End-of-Support date: ${date.toISOString()})`);\n      return acc;\n    }, new Array<string>());\n  if (endOfSupportDate <= now) {\n    // End-of-Support already!\n    veryVisibleMessage(\n      chalk.bgRed.white.bold,\n      `The ${versionMajorMinor} release line of jsii has reached End-of-Support.`,\n      `We strongly recommend you upgrade to the current release line (${data.current}) at your earliest convenience.`,\n      ...alternatives,\n    );\n  } else if (endOfSupportDate <= inThirtyDays) {\n    // End-of-Support within 30 days!\n    veryVisibleMessage(\n      chalk.bgYellow.black,\n      `The ${versionMajorMinor} release line of jsii will reach End-of-Support soon, on ${endOfSupportDate.toISOString()}.`,\n      `We strongly recommend you upgrade to the current release line (${data.current}) at your earliest convenience.`,\n      ...alternatives,\n    );\n  }\n}\n\n/**\n * Downloads the latest `releases.json` document from 'https://raw.githubusercontent.com/aws/jsii-rosetta/main/releases.json'\n * if possible, or falls back to the built-in version of that file if that fails in any way.\n */\nasync function getReleasesDocument(): Promise<ReleasesDocument> {\n  const downloaded = await new Promise<string | undefined>((ok, ko) => {\n    const request = get(\n      new URL('https://raw.githubusercontent.com/aws/jsii-rosetta/main/releases.json'),\n      (response) => {\n        if (response.statusCode === 404) {\n          return ok(undefined);\n        }\n        if (response.statusCode !== 200) {\n          return ko(`received error response: HTTP ${response.statusCode} - ${response.statusMessage}`);\n        }\n        response.once('error', ko);\n        const chunks = new Array<Buffer>();\n        response.on('data', (chunk) => chunks.push(Buffer.from(chunk)));\n        response.once('end', () => ok(Buffer.concat(chunks).toString('utf-8')));\n      },\n    );\n    request.once('abort', () => ko('request aborted'));\n    request.once('timeout', () => ko('request timed out'));\n    request.once('error', ko);\n    request.end();\n  }).catch((cause) => {\n    if (process.env.JSII_DEBUG) {\n      console.error(`Could not download releases.json from GitHub: ${cause}`);\n    }\n    undefined;\n  });\n\n  return JSON.parse(downloaded ?? readFileSync(join(__dirname, '..', 'releases.json'), 'utf-8'), (key, value) => {\n    if (key !== 'maintenance') {\n      return value;\n    }\n    return Object.fromEntries(Object.entries(value).map(([release, date]) => [release, new Date(date as string)]));\n  }) as ReleasesDocument;\n}\n\nfunction veryVisibleMessage(formatter: chalk.Chalk, ...lines: readonly string[]): void {\n  if (lines.length === 0) {\n    throw new Error(`At least one line of message must be provided!`);\n  }\n\n  const len = Math.max(...lines.map((line) => line.length));\n  const border = formatter('!'.repeat(len + 8));\n  const spacer = formatter(`!!  ${' '.repeat(len)}  !!`);\n\n  console.error(border);\n  console.error(spacer);\n  for (const line of lines) {\n    console.error(formatter(`!!  ${line.padEnd(len, ' ')}  !!`));\n  }\n  console.error(spacer);\n  console.error(border);\n}\n\ntype ReleaseLine = `${number}.${number}`;\n"]}

package/package.json

@@ -35,33 +35,34 @@
     "@actions/core": "^1.10.0",
     "@actions/github": "^5.1.1",
     "@types/commonmark": "^0.27.5",
-    "@types/jest": "^29.4.0",
+    "@types/jest": "^29.4.1",
     "@types/mock-fs": "^4.13.1",
     "@types/node": "^14",
     "@types/tar": "^6.1.4",
-    "@types/workerpool": "^6.1.1",
+    "@types/workerpool": "^6.4.0",
     "@typescript-eslint/eslint-plugin": "^5",
     "@typescript-eslint/parser": "^5",
     "eslint": "^8",
-    "eslint-config-prettier": "^8.6.0",
+    "eslint-config-prettier": "^8.7.0",
     "eslint-import-resolver-node": "^0.3.7",
     "eslint-import-resolver-typescript": "^3.5.3",
     "eslint-plugin-import": "^2.27.5",
     "eslint-plugin-prettier": "^4.2.1",
     "eslint-plugin-unicorn": "^45.0.2",
-    "jest": "^29.4.3",
+    "jest": "^29.5.0",
     "mock-fs": "^5.2.0",
     "npm-check-updates": "^16",
     "prettier": "^2.8.4",
-    "projen": "^0.67.68",
+    "projen": "^0.68.1",
     "tar": "^6.1.13",
     "ts-jest": "^29.0.5",
     "ts-node": "^10.9.1"
   },
   "dependencies": {
-    "@jsii/check-node": "1.76.0",
-    "@jsii/spec": "^1.76.0",
+    "@jsii/check-node": "1.77.0",
+    "@jsii/spec": "^1.77.0",
     "@xmldom/xmldom": "^0.8.6",
+    "chalk": "^4",
     "commonmark": "^0.30.0",
     "fast-glob": "^3.2.12",
     "jsii": "v4.9-next",
@@ -77,7 +78,7 @@
   "main": "lib/index.js",
   "license": "Apache-2.0",
   "homepage": "https://aws.github.io/jsii",
-  "version": "4.9.0-dev.2",
+  "version": "4.9.0-dev.3",
   "types": "lib/index.d.ts",
   "exports": {
     ".": "./lib/index.js",

package/releases.json

@@ -0,0 +1,5 @@
+{
+  "current": "4.9",
+  "maintenance": {},
+  "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"npx projen\"."
+}

package/temp.tabl.json

@@ -1,48 +0,0 @@
-{
-  "version": "2",
-  "toolVersion": "4.9.0-dev.2",
-  "snippets": {
-    "d54054dded92a8c59670816ed22b893ca888d5e2cab871b833af1723039662c9": {
-      "translations": {
-        "python": {
-          "source": "print(\"hello world\")",
-          "version": "2"
-        },
-        "csharp": {
-          "source": "Console.WriteLine(\"hello world\");",
-          "version": "1"
-        },
-        "java": {
-          "source": "System.out.println(\"hello world\");",
-          "version": "1"
-        },
-        "go": {
-          "source": "fmt.Println(\"hello world\")",
-          "version": "1"
-        },
-        "$": {
-          "source": "console.log(\"hello world\");",
-          "version": "0"
-        }
-      },
-      "location": {
-        "api": {
-          "api": "file",
-          "fileName": "test.ts"
-        }
-      },
-      "didCompile": false,
-      "fqnsReferenced": [],
-      "fullSource": "console.log(\"hello world\");",
-      "syntaxKindCounter": {
-        "10": 1,
-        "79": 2,
-        "208": 1,
-        "210": 1,
-        "241": 1,
-        "308": 1
-      },
-      "fqnsFingerprint": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
-    }
-  }
-}