jsii-rosetta 5.9.6-dev.2 → 5.9.6

package/lib/commands/transliterate.js

@@ -5,6 +5,7 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const spec_1 = require("@jsii/spec");
 const extract_1 = require("./extract");
+const assemblies_1 = require("../jsii/assemblies");
 const target_language_1 = require("../languages/target-language");
 const logging_1 = require("../logging");
 const rosetta_reader_1 = require("../rosetta-reader");
@@ -88,7 +89,7 @@ async function transliterateAssembly(assemblyLocations, targetLanguages, options
 async function loadAssemblies(directories, rosetta) {
     const result = new Map();
     for (const directory of directories) {
-        const loader = () => (0, spec_1.loadAssemblyFromPath)(directory);
+        const loader = () => (0, spec_1.loadAssemblyFromPath)(directory, false, assemblies_1.SUPPORTED_ASSEMBLY_FEATURES);
         // eslint-disable-next-line no-await-in-loop
         await rosetta.addAssembly(loader(), directory);
         result.set(directory, loader);

package/lib/commands/transliterate.js.map

@@ -1 +1 @@
-{"version":3,"file":"transliterate.js","sourceRoot":"","sources":["../../src/commands/transliterate.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fs } from 'node:fs';\nimport { resolve } from 'node:path';\nimport { Assembly, Docs, SPEC_FILE_NAME, Type, TypeKind, loadAssemblyFromPath } from '@jsii/spec';\n\nimport { extractSnippets } from './extract';\nimport { TargetLanguage } from '../languages';\nimport { targetName } from '../languages/target-language';\nimport { debug } from '../logging';\nimport { RosettaTabletReader, UnknownSnippetMode } from '../rosetta-reader';\nimport { typeScriptSnippetFromVisibleSource, ApiLocation } from '../snippet';\nimport { Mutable } from '../util';\n\nexport interface TransliterateAssemblyOptions {\n  /**\n   * Whether to ignore any missing fixture files or literate markdown documents\n   * referenced by the assembly, instead of failing.\n   *\n   * @default false\n   */\n  readonly loose?: boolean;\n\n  /**\n   * Whether transliteration should fail upon failing to compile an example that\n   * required live transliteration.\n   *\n   * @default false\n   */\n  readonly strict?: boolean;\n\n  /**\n   * A pre-build translation tablet (as produced by `jsii-rosetta extract`).\n   *\n   * @default - Only the default tablet (`.jsii.tabl.json`) files will be used.\n   */\n  readonly tablet?: string;\n\n  /**\n   * A directory to output translated assemblies to\n   *\n   * @default - assembly location\n   */\n  readonly outdir?: string;\n\n  /**\n   * Whether or not to live-convert samples\n   *\n   * @default UnknownSnippetMode.FAIL\n   */\n  readonly unknownSnippets?: UnknownSnippetMode;\n}\n\n/**\n * Prepares transliterated versions of the designated assemblies into the\n * selected target languages.\n *\n * @param assemblyLocations the directories which contain assemblies to\n *                          transliterate.\n * @param targetLanguages   the languages into which to transliterate.\n * @param tabletLocation    an optional Rosetta tablet file to source\n *                          pre-transliterated snippets from.\n *\n * @experimental\n */\nexport async function transliterateAssembly(\n  assemblyLocations: readonly string[],\n  targetLanguages: readonly TargetLanguage[],\n  options: TransliterateAssemblyOptions = {},\n): Promise<void> {\n  // Start by doing an 'extract' for all these assemblies\n  //\n  // This will locate all examples that haven't been translated yet and translate\n  // them. Importantly: it will translate them in parallel, which is going to improve\n  // performance a lot. We ignore diagnostics.\n  const { tablet } = await extractSnippets(assemblyLocations, {\n    includeCompilerDiagnostics: true,\n    loose: options.loose,\n    cacheFromFile: options.tablet,\n    writeToImplicitTablets: false,\n    allowDirtyTranslations: true,\n  });\n\n  // Now do a regular \"tablet reader\" cycle, expecting everything to be translated already,\n  // and therefore it doesn't matter that we do this all in a single-threaded loop.\n  const rosetta = new RosettaTabletReader({\n    unknownSnippets: options?.unknownSnippets ?? UnknownSnippetMode.FAIL,\n    targetLanguages,\n    prefixDisclaimer: true,\n  });\n  // Put in the same caching tablet here\n  if (options.tablet) {\n    await rosetta.loadTabletFromFile(options.tablet);\n  }\n  // Any fresh translations we just came up with\n  rosetta.addTablet(tablet);\n\n  const assemblies = await loadAssemblies(assemblyLocations, rosetta);\n\n  for (const [location, loadAssembly] of assemblies.entries()) {\n    for (const language of targetLanguages) {\n      const now = new Date().getTime();\n      const result = loadAssembly();\n\n      if (result.targets?.[targetName(language)] == null) {\n        // This language is not supported by the assembly, so we skip it...\n        continue;\n      }\n\n      if (result.readme?.markdown) {\n        result.readme.markdown = rosetta.translateSnippetsInMarkdown(\n          { api: 'moduleReadme', moduleFqn: result.name },\n          result.readme.markdown,\n          language,\n          true /* strict */,\n        );\n      }\n      for (const type of Object.values(result.types ?? {})) {\n        transliterateType(type, rosetta, language);\n      }\n      // eslint-disable-next-line no-await-in-loop\n      await fs.writeFile(\n        resolve(options?.outdir ?? location, `${SPEC_FILE_NAME}.${language}`),\n        JSON.stringify(result, null, 2),\n      );\n      const then = new Date().getTime();\n      debug(`Done transliterating ${result.name}@${result.version} to ${language} after ${then - now} milliseconds`);\n    }\n  }\n\n  rosetta.printDiagnostics(process.stderr, process.stderr.isTTY);\n  if (rosetta.hasErrors && options.strict) {\n    throw new Error('Strict mode is enabled and some examples failed compilation!');\n  }\n}\n\n/**\n * Given a set of directories containing `.jsii` assemblies, load all the\n * assemblies into the provided `Rosetta` instance and return a map of\n * directories to assembly-loading functions (the function re-loads the original\n * assembly from disk on each invocation).\n *\n * @param directories the assembly-containing directories to traverse.\n * @param rosetta     the `Rosetta` instance in which to load assemblies.\n *\n * @returns a map of directories to a function that loads the `.jsii` assembly\n *          contained therein from disk.\n */\nasync function loadAssemblies(\n  directories: readonly string[],\n  rosetta: RosettaTabletReader,\n): Promise<ReadonlyMap<string, AssemblyLoader>> {\n  const result = new Map<string, AssemblyLoader>();\n\n  for (const directory of directories) {\n    const loader = () => loadAssemblyFromPath(directory);\n    // eslint-disable-next-line no-await-in-loop\n    await rosetta.addAssembly(loader(), directory);\n    result.set(directory, loader);\n  }\n\n  return result;\n}\n\ntype AssemblyLoader = () => Mutable<Assembly>;\n\nfunction transliterateType(type: Type, rosetta: RosettaTabletReader, language: TargetLanguage): void {\n  transliterateDocs({ api: 'type', fqn: type.fqn }, type.docs);\n  switch (type.kind) {\n    // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n    // @ts-ignore 7029\n    case TypeKind.Class:\n      if (type.initializer) {\n        transliterateDocs({ api: 'initializer', fqn: type.fqn }, type.initializer.docs);\n      }\n\n    // fallthrough\n    case TypeKind.Interface:\n      for (const method of type.methods ?? []) {\n        transliterateDocs({ api: 'member', fqn: type.fqn, memberName: method.name }, method.docs);\n        for (const parameter of method.parameters ?? []) {\n          transliterateDocs(\n            { api: 'parameter', fqn: type.fqn, methodName: method.name, parameterName: parameter.name },\n            parameter.docs,\n          );\n        }\n      }\n      for (const property of type.properties ?? []) {\n        transliterateDocs({ api: 'member', fqn: type.fqn, memberName: property.name }, property.docs);\n      }\n      break;\n\n    case TypeKind.Enum:\n      for (const member of type.members) {\n        transliterateDocs({ api: 'member', fqn: type.fqn, memberName: member.name }, member.docs);\n      }\n      break;\n\n    default:\n      throw new Error(`Unsupported type kind: ${(type as any).kind}`);\n  }\n\n  function transliterateDocs(api: ApiLocation, docs: Docs | undefined) {\n    if (docs?.remarks) {\n      docs.remarks = rosetta.translateSnippetsInMarkdown(api, docs.remarks, language, true /* strict */);\n    }\n\n    if (docs?.example) {\n      const location = { api, field: { field: 'example' } } as const;\n      const snippet = typeScriptSnippetFromVisibleSource(docs.example, location, true /* strict */);\n      const translation = rosetta.translateSnippet(snippet, language);\n      if (translation != null) {\n        docs.example = translation.source;\n      }\n    }\n  }\n}\n"]}
+{"version":3,"file":"transliterate.js","sourceRoot":"","sources":["../../src/commands/transliterate.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fs } from 'node:fs';\nimport { resolve } from 'node:path';\nimport { Assembly, Docs, SPEC_FILE_NAME, Type, TypeKind, loadAssemblyFromPath } from '@jsii/spec';\n\nimport { extractSnippets } from './extract';\nimport { SUPPORTED_ASSEMBLY_FEATURES } from '../jsii/assemblies';\nimport { TargetLanguage } from '../languages';\nimport { targetName } from '../languages/target-language';\nimport { debug } from '../logging';\nimport { RosettaTabletReader, UnknownSnippetMode } from '../rosetta-reader';\nimport { typeScriptSnippetFromVisibleSource, ApiLocation } from '../snippet';\nimport { Mutable } from '../util';\n\nexport interface TransliterateAssemblyOptions {\n  /**\n   * Whether to ignore any missing fixture files or literate markdown documents\n   * referenced by the assembly, instead of failing.\n   *\n   * @default false\n   */\n  readonly loose?: boolean;\n\n  /**\n   * Whether transliteration should fail upon failing to compile an example that\n   * required live transliteration.\n   *\n   * @default false\n   */\n  readonly strict?: boolean;\n\n  /**\n   * A pre-build translation tablet (as produced by `jsii-rosetta extract`).\n   *\n   * @default - Only the default tablet (`.jsii.tabl.json`) files will be used.\n   */\n  readonly tablet?: string;\n\n  /**\n   * A directory to output translated assemblies to\n   *\n   * @default - assembly location\n   */\n  readonly outdir?: string;\n\n  /**\n   * Whether or not to live-convert samples\n   *\n   * @default UnknownSnippetMode.FAIL\n   */\n  readonly unknownSnippets?: UnknownSnippetMode;\n}\n\n/**\n * Prepares transliterated versions of the designated assemblies into the\n * selected target languages.\n *\n * @param assemblyLocations the directories which contain assemblies to\n *                          transliterate.\n * @param targetLanguages   the languages into which to transliterate.\n * @param tabletLocation    an optional Rosetta tablet file to source\n *                          pre-transliterated snippets from.\n *\n * @experimental\n */\nexport async function transliterateAssembly(\n  assemblyLocations: readonly string[],\n  targetLanguages: readonly TargetLanguage[],\n  options: TransliterateAssemblyOptions = {},\n): Promise<void> {\n  // Start by doing an 'extract' for all these assemblies\n  //\n  // This will locate all examples that haven't been translated yet and translate\n  // them. Importantly: it will translate them in parallel, which is going to improve\n  // performance a lot. We ignore diagnostics.\n  const { tablet } = await extractSnippets(assemblyLocations, {\n    includeCompilerDiagnostics: true,\n    loose: options.loose,\n    cacheFromFile: options.tablet,\n    writeToImplicitTablets: false,\n    allowDirtyTranslations: true,\n  });\n\n  // Now do a regular \"tablet reader\" cycle, expecting everything to be translated already,\n  // and therefore it doesn't matter that we do this all in a single-threaded loop.\n  const rosetta = new RosettaTabletReader({\n    unknownSnippets: options?.unknownSnippets ?? UnknownSnippetMode.FAIL,\n    targetLanguages,\n    prefixDisclaimer: true,\n  });\n  // Put in the same caching tablet here\n  if (options.tablet) {\n    await rosetta.loadTabletFromFile(options.tablet);\n  }\n  // Any fresh translations we just came up with\n  rosetta.addTablet(tablet);\n\n  const assemblies = await loadAssemblies(assemblyLocations, rosetta);\n\n  for (const [location, loadAssembly] of assemblies.entries()) {\n    for (const language of targetLanguages) {\n      const now = new Date().getTime();\n      const result = loadAssembly();\n\n      if (result.targets?.[targetName(language)] == null) {\n        // This language is not supported by the assembly, so we skip it...\n        continue;\n      }\n\n      if (result.readme?.markdown) {\n        result.readme.markdown = rosetta.translateSnippetsInMarkdown(\n          { api: 'moduleReadme', moduleFqn: result.name },\n          result.readme.markdown,\n          language,\n          true /* strict */,\n        );\n      }\n      for (const type of Object.values(result.types ?? {})) {\n        transliterateType(type, rosetta, language);\n      }\n      // eslint-disable-next-line no-await-in-loop\n      await fs.writeFile(\n        resolve(options?.outdir ?? location, `${SPEC_FILE_NAME}.${language}`),\n        JSON.stringify(result, null, 2),\n      );\n      const then = new Date().getTime();\n      debug(`Done transliterating ${result.name}@${result.version} to ${language} after ${then - now} milliseconds`);\n    }\n  }\n\n  rosetta.printDiagnostics(process.stderr, process.stderr.isTTY);\n  if (rosetta.hasErrors && options.strict) {\n    throw new Error('Strict mode is enabled and some examples failed compilation!');\n  }\n}\n\n/**\n * Given a set of directories containing `.jsii` assemblies, load all the\n * assemblies into the provided `Rosetta` instance and return a map of\n * directories to assembly-loading functions (the function re-loads the original\n * assembly from disk on each invocation).\n *\n * @param directories the assembly-containing directories to traverse.\n * @param rosetta     the `Rosetta` instance in which to load assemblies.\n *\n * @returns a map of directories to a function that loads the `.jsii` assembly\n *          contained therein from disk.\n */\nasync function loadAssemblies(\n  directories: readonly string[],\n  rosetta: RosettaTabletReader,\n): Promise<ReadonlyMap<string, AssemblyLoader>> {\n  const result = new Map<string, AssemblyLoader>();\n\n  for (const directory of directories) {\n    const loader = () => loadAssemblyFromPath(directory, false, SUPPORTED_ASSEMBLY_FEATURES);\n    // eslint-disable-next-line no-await-in-loop\n    await rosetta.addAssembly(loader(), directory);\n    result.set(directory, loader);\n  }\n\n  return result;\n}\n\ntype AssemblyLoader = () => Mutable<Assembly>;\n\nfunction transliterateType(type: Type, rosetta: RosettaTabletReader, language: TargetLanguage): void {\n  transliterateDocs({ api: 'type', fqn: type.fqn }, type.docs);\n  switch (type.kind) {\n    // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n    // @ts-ignore 7029\n    case TypeKind.Class:\n      if (type.initializer) {\n        transliterateDocs({ api: 'initializer', fqn: type.fqn }, type.initializer.docs);\n      }\n\n    // fallthrough\n    case TypeKind.Interface:\n      for (const method of type.methods ?? []) {\n        transliterateDocs({ api: 'member', fqn: type.fqn, memberName: method.name }, method.docs);\n        for (const parameter of method.parameters ?? []) {\n          transliterateDocs(\n            { api: 'parameter', fqn: type.fqn, methodName: method.name, parameterName: parameter.name },\n            parameter.docs,\n          );\n        }\n      }\n      for (const property of type.properties ?? []) {\n        transliterateDocs({ api: 'member', fqn: type.fqn, memberName: property.name }, property.docs);\n      }\n      break;\n\n    case TypeKind.Enum:\n      for (const member of type.members) {\n        transliterateDocs({ api: 'member', fqn: type.fqn, memberName: member.name }, member.docs);\n      }\n      break;\n\n    default:\n      throw new Error(`Unsupported type kind: ${(type as any).kind}`);\n  }\n\n  function transliterateDocs(api: ApiLocation, docs: Docs | undefined) {\n    if (docs?.remarks) {\n      docs.remarks = rosetta.translateSnippetsInMarkdown(api, docs.remarks, language, true /* strict */);\n    }\n\n    if (docs?.example) {\n      const location = { api, field: { field: 'example' } } as const;\n      const snippet = typeScriptSnippetFromVisibleSource(docs.example, location, true /* strict */);\n      const translation = rosetta.translateSnippet(snippet, language);\n      if (translation != null) {\n        docs.example = translation.source;\n      }\n    }\n  }\n}\n"]}

package/lib/jsii/assemblies.d.ts

@@ -1,6 +1,15 @@
 import * as spec from '@jsii/spec';
 import { TypeScriptSnippet, ApiLocation } from '../snippet';
 import { LanguageTablet } from '../tablets/tablets';
+/**
+ * The Assembly features jsii-rosetta supports
+ *
+ * In actual fact, Rosetta doesn't do much with the Assembly, just crawl all
+ * API documentations, so basically most new features would be supported... but
+ * we technically should advertise a known list here anyway since we don't
+ * know what future extension are going to be.
+ */
+export declare const SUPPORTED_ASSEMBLY_FEATURES: spec.JsiiFeature[];
 /**
  * The JSDoc tag users can use to associate non-visible metadata with an example
  *

package/lib/jsii/assemblies.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EXAMPLE_METADATA_JSDOCTAG = void 0;
+exports.EXAMPLE_METADATA_JSDOCTAG = exports.SUPPORTED_ASSEMBLY_FEATURES = void 0;
 exports.loadAssemblies = loadAssemblies;
 exports.loadAllDefaultTablets = loadAllDefaultTablets;
 exports.guessTabletLocation = guessTabletLocation;
@@ -21,6 +21,15 @@ const snippet_dependencies_1 = require("../snippet-dependencies");
 const strict_1 = require("../strict");
 const tablets_1 = require("../tablets/tablets");
 const util_1 = require("../util");
+/**
+ * The Assembly features jsii-rosetta supports
+ *
+ * In actual fact, Rosetta doesn't do much with the Assembly, just crawl all
+ * API documentations, so basically most new features would be supported... but
+ * we technically should advertise a known list here anyway since we don't
+ * know what future extension are going to be.
+ */
+exports.SUPPORTED_ASSEMBLY_FEATURES = ['intersection-types'];
 /**
  * The JSDoc tag users can use to associate non-visible metadata with an example
  *
@@ -48,7 +57,7 @@ function loadAssemblies(assemblyLocations, validateAssemblies) {
         }
         const directory = path.dirname(location);
         const pjLocation = path.join(directory, 'package.json');
-        const assembly = (0, spec_1.loadAssemblyFromFile)(location, validateAssemblies);
+        const assembly = (0, spec_1.loadAssemblyFromFile)(location, validateAssemblies, exports.SUPPORTED_ASSEMBLY_FEATURES);
         const packageJson = fs.existsSync(pjLocation) ? JSON.parse(fs.readFileSync(pjLocation, 'utf-8')) : undefined;
         return { assembly, directory, packageJson };
     }
@@ -210,7 +219,7 @@ function findTypeLookupAssembly(startingDirectory) {
 function loadLookupAssembly(directory) {
     try {
         const packageJson = JSON.parse(fs.readFileSync(path.join(directory, 'package.json'), 'utf-8'));
-        const assembly = (0, spec_1.loadAssemblyFromPath)(directory);
+        const assembly = (0, spec_1.loadAssemblyFromPath)(directory, false, exports.SUPPORTED_ASSEMBLY_FEATURES);
         const symbolIdMap = (0, util_1.mkDict)([
             ...Object.values(assembly.types ?? {}).map((type) => [type.symbolId ?? '', type.fqn]),
             ...Object.entries(assembly.submodules ?? {}).map(([fqn, mod]) => [mod.symbolId ?? '', fqn]),

package/lib/jsii/assemblies.js.map

@@ -1 +1 @@
-{"version":3,"file":"assemblies.js","sourceRoot":"","sources":["../../src/jsii/assemblies.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fsPromises } from 'node:fs';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { loadAssemblyFromFile, loadAssemblyFromPath, findAssemblyFile } from '@jsii/spec';\nimport * as spec from '@jsii/spec';\nimport { fixturize } from '../fixtures';\nimport { extractTypescriptSnippetsFromMarkdown } from '../markdown/extract-snippets';\nimport {\n  TypeScriptSnippet,\n  updateParameters,\n  SnippetParameters,\n  ApiLocation,\n  parseMetadataLine,\n  CompilationDependency,\n  INITIALIZER_METHOD_NAME,\n  typeScriptSnippetFromVisibleSource,\n} from '../snippet';\nimport { resolveDependenciesFromPackageJson } from '../snippet-dependencies';\nimport { enforcesStrictMode } from '../strict';\nimport { LanguageTablet, DEFAULT_TABLET_NAME, DEFAULT_TABLET_NAME_COMPRESSED } from '../tablets/tablets';\nimport { fmap, mkDict, pathExists, sortBy } from '../util';\n\n/**\n * The JSDoc tag users can use to associate non-visible metadata with an example\n *\n * In a Markdown section, metadata goes after the code block fence, where it will\n * be attached to the example but invisible.\n *\n *    ```ts metadata=goes here\n *\n * But in doc comments, '@example' already delineates the example, and any metadata\n * in there added by the '///' tags becomes part of the visible code (there is no\n * place to put hidden information).\n *\n * We introduce the '@exampleMetadata' tag to put that additional information.\n */\nexport const EXAMPLE_METADATA_JSDOCTAG = 'exampleMetadata';\n\ninterface RosettaPackageJson extends spec.PackageJson {\n  readonly jsiiRosetta?: {\n    readonly strict?: boolean;\n    readonly exampleDependencies?: Record<string, string>;\n  };\n}\n\nexport interface LoadedAssembly {\n  readonly assembly: spec.Assembly;\n  readonly directory: string;\n  readonly packageJson?: RosettaPackageJson;\n}\n\n/**\n * Load assemblies by filename or directory\n */\nexport function loadAssemblies(\n  assemblyLocations: readonly string[],\n  validateAssemblies: boolean,\n): readonly LoadedAssembly[] {\n  return assemblyLocations.map(loadAssembly);\n\n  function loadAssembly(location: string): LoadedAssembly {\n    const stat = fs.statSync(location);\n    if (stat.isDirectory()) {\n      return loadAssembly(findAssemblyFile(location));\n    }\n\n    const directory = path.dirname(location);\n    const pjLocation = path.join(directory, 'package.json');\n\n    const assembly = loadAssemblyFromFile(location, validateAssemblies);\n    const packageJson = fs.existsSync(pjLocation) ? JSON.parse(fs.readFileSync(pjLocation, 'utf-8')) : undefined;\n\n    return { assembly, directory, packageJson };\n  }\n}\n\n/**\n * Load the default tablets for every assembly, if available\n *\n * Returns a map of { directory -> tablet }.\n */\nexport async function loadAllDefaultTablets(asms: readonly LoadedAssembly[]): Promise<Record<string, LanguageTablet>> {\n  return mkDict(\n    await Promise.all(\n      asms.map(\n        async (a) => [a.directory, await LanguageTablet.fromOptionalFile(guessTabletLocation(a.directory))] as const,\n      ),\n    ),\n  );\n}\n\n/**\n * Returns the location of the tablet file, either .jsii.tabl.json or .jsii.tabl.json.gz.\n * Assumes that a tablet exists in the directory and if not, the ensuing behavior is\n * handled by the caller of this function.\n */\nexport function guessTabletLocation(directory: string) {\n  return compressedTabletExists(directory)\n    ? path.join(directory, DEFAULT_TABLET_NAME_COMPRESSED)\n    : path.join(directory, DEFAULT_TABLET_NAME);\n}\n\nexport function compressedTabletExists(directory: string) {\n  return fs.existsSync(path.join(directory, DEFAULT_TABLET_NAME_COMPRESSED));\n}\n\nexport type AssemblySnippetSource =\n  | { type: 'markdown'; markdown: string; location: ApiLocation }\n  | { type: 'example'; source: string; metadata?: { [key: string]: string }; location: ApiLocation };\n\n/**\n * Return all markdown and example snippets from the given assembly\n */\nexport function allSnippetSources(assembly: spec.Assembly): AssemblySnippetSource[] {\n  const ret: AssemblySnippetSource[] = [];\n\n  if (assembly.readme) {\n    ret.push({\n      type: 'markdown',\n      markdown: assembly.readme.markdown,\n      location: { api: 'moduleReadme', moduleFqn: assembly.name },\n    });\n  }\n\n  for (const [submoduleFqn, submodule] of Object.entries(assembly.submodules ?? {})) {\n    if (submodule.readme) {\n      ret.push({\n        type: 'markdown',\n        markdown: submodule.readme.markdown,\n        location: { api: 'moduleReadme', moduleFqn: submoduleFqn },\n      });\n    }\n  }\n\n  if (assembly.types) {\n    for (const type of Object.values(assembly.types)) {\n      emitDocs(type.docs, { api: 'type', fqn: type.fqn });\n\n      if (spec.isEnumType(type)) {\n        for (const m of type.members) emitDocs(m.docs, { api: 'member', fqn: type.fqn, memberName: m.name });\n      }\n      if (spec.isClassType(type)) {\n        emitDocsForCallable(type.initializer, type.fqn);\n      }\n      if (spec.isClassOrInterfaceType(type)) {\n        for (const m of type.methods ?? []) emitDocsForCallable(m, type.fqn, m.name);\n        for (const m of type.properties ?? []) emitDocs(m.docs, { api: 'member', fqn: type.fqn, memberName: m.name });\n      }\n    }\n  }\n\n  return ret;\n\n  function emitDocsForCallable(callable: spec.Callable | undefined, fqn: string, memberName?: string) {\n    if (!callable) {\n      return;\n    }\n    emitDocs(callable.docs, memberName ? { api: 'member', fqn, memberName } : { api: 'initializer', fqn });\n\n    for (const parameter of callable.parameters ?? []) {\n      emitDocs(parameter.docs, {\n        api: 'parameter',\n        fqn: fqn,\n        methodName: memberName ?? INITIALIZER_METHOD_NAME,\n        parameterName: parameter.name,\n      });\n    }\n  }\n\n  function emitDocs(docs: spec.Docs | undefined, location: ApiLocation) {\n    if (!docs) {\n      return;\n    }\n\n    if (docs.remarks) {\n      ret.push({\n        type: 'markdown',\n        markdown: docs.remarks,\n        location,\n      });\n    }\n    if (docs.example) {\n      ret.push({\n        type: 'example',\n        source: docs.example,\n        metadata: fmap(docs.custom?.[EXAMPLE_METADATA_JSDOCTAG], parseMetadataLine),\n        location,\n      });\n    }\n  }\n}\n\nexport async function allTypeScriptSnippets(\n  assemblies: readonly LoadedAssembly[],\n  loose = false,\n): Promise<TypeScriptSnippet[]> {\n  const sources = assemblies\n    .flatMap((loaded) => allSnippetSources(loaded.assembly).map((source) => ({ source, loaded })))\n    .flatMap(({ source, loaded }) => {\n      switch (source.type) {\n        case 'example':\n          return [\n            {\n              snippet: updateParameters(\n                typeScriptSnippetFromVisibleSource(\n                  source.source,\n                  { api: source.location, field: { field: 'example' } },\n                  isStrict(loaded),\n                ),\n                source.metadata ?? {},\n              ),\n              loaded,\n            },\n          ];\n        case 'markdown':\n          return extractTypescriptSnippetsFromMarkdown(source.markdown, source.location, isStrict(loaded)).map(\n            (snippet) => ({ snippet, loaded }),\n          );\n      }\n    });\n\n  const fixtures = [];\n  for (let { snippet, loaded } of sources) {\n    const isInfused = snippet.parameters?.infused != null;\n\n    // Ignore fixturization errors if requested on this command, or if the snippet was infused\n    const ignoreFixtureErrors = loose || isInfused;\n\n    // Also if the snippet was infused: switch off 'strict' mode if it was set\n    if (isInfused) {\n      snippet = { ...snippet, strict: false };\n    }\n\n    snippet = await withDependencies(loaded, withProjectDirectory(loaded.directory, snippet));\n    fixtures.push(fixturize(snippet, ignoreFixtureErrors));\n  }\n\n  return fixtures;\n}\n\nexport interface TypeLookupAssembly {\n  readonly packageJson: any;\n  readonly assembly: spec.Assembly;\n  readonly directory: string;\n  readonly symbolIdMap: Record<string, string>;\n}\n\nconst MAX_ASM_CACHE = 3;\nconst ASM_CACHE: TypeLookupAssembly[] = [];\n\n/**\n * Recursively searches for a .jsii file in the directory.\n * When file is found, checks cache to see if we already\n * stored the assembly in memory. If not, we synchronously\n * load the assembly into memory.\n */\nexport function findTypeLookupAssembly(startingDirectory: string): TypeLookupAssembly | undefined {\n  const pjLocation = findPackageJsonLocation(path.resolve(startingDirectory));\n  if (!pjLocation) {\n    return undefined;\n  }\n  const directory = path.dirname(pjLocation);\n\n  const fromCache = ASM_CACHE.find((c) => c.directory === directory);\n  if (fromCache) {\n    return fromCache;\n  }\n\n  const loaded = loadLookupAssembly(directory);\n  if (!loaded) {\n    return undefined;\n  }\n\n  while (ASM_CACHE.length >= MAX_ASM_CACHE) {\n    ASM_CACHE.pop();\n  }\n  ASM_CACHE.unshift(loaded);\n  return loaded;\n}\n\nfunction loadLookupAssembly(directory: string): TypeLookupAssembly | undefined {\n  try {\n    const packageJson = JSON.parse(fs.readFileSync(path.join(directory, 'package.json'), 'utf-8'));\n    const assembly: spec.Assembly = loadAssemblyFromPath(directory);\n    const symbolIdMap = mkDict([\n      ...Object.values(assembly.types ?? {}).map((type) => [type.symbolId ?? '', type.fqn] as const),\n      ...Object.entries(assembly.submodules ?? {}).map(([fqn, mod]) => [mod.symbolId ?? '', fqn] as const),\n    ]);\n\n    return {\n      packageJson,\n      assembly,\n      directory,\n      symbolIdMap,\n    };\n  } catch {\n    return undefined;\n  }\n}\n\nfunction findPackageJsonLocation(currentPath: string): string | undefined {\n  // eslint-disable-next-line no-constant-condition\n  while (true) {\n    const candidate = path.join(currentPath, 'package.json');\n    if (fs.existsSync(candidate)) {\n      return candidate;\n    }\n\n    const parentPath = path.resolve(currentPath, '..');\n    if (parentPath === currentPath) {\n      return undefined;\n    }\n    currentPath = parentPath;\n  }\n}\n\n/**\n * Find the jsii [sub]module that contains the given FQN\n *\n * @returns `undefined` if the type is a member of the assembly root.\n */\nexport function findContainingSubmodule(assembly: spec.Assembly, fqn: string): string | undefined {\n  const submoduleNames = Object.keys(assembly.submodules ?? {});\n  sortBy(submoduleNames, (s) => [-s.length]); // Longest first\n  for (const s of submoduleNames) {\n    if (fqn.startsWith(`${s}.`)) {\n      return s;\n    }\n  }\n  return undefined;\n}\n\nfunction withProjectDirectory(dir: string, snippet: TypeScriptSnippet) {\n  return updateParameters(snippet, {\n    [SnippetParameters.$PROJECT_DIRECTORY]: dir,\n  });\n}\n\n/**\n * Return a TypeScript snippet with dependencies added\n *\n * The dependencies will be taken from the package.json, and will consist of:\n *\n * - The package itself\n * - The package's dependencies and peerDependencies (but NOT devDependencies). Will\n *   symlink to the files on disk.\n * - Any additional dependencies declared in `jsiiRosetta.exampleDependencies`.\n */\nasync function withDependencies(asm: LoadedAssembly, snippet: TypeScriptSnippet): Promise<TypeScriptSnippet> {\n  const compilationDependencies: Record<string, CompilationDependency> = {};\n\n  if (await pathExists(path.join(asm.directory, 'package.json'))) {\n    compilationDependencies[asm.assembly.name] = {\n      type: 'concrete',\n      resolvedDirectory: await fsPromises.realpath(asm.directory),\n    };\n  }\n\n  Object.assign(compilationDependencies, await resolveDependenciesFromPackageJson(asm.packageJson, asm.directory));\n\n  Object.assign(\n    compilationDependencies,\n    mkDict(\n      Object.entries(asm.packageJson?.jsiiRosetta?.exampleDependencies ?? {}).map(\n        ([name, versionRange]) => [name, { type: 'symbolic', versionRange }] as const,\n      ),\n    ),\n  );\n\n  return {\n    ...snippet,\n    compilationDependencies,\n  };\n}\n\n/**\n * Whether samples in the assembly should be treated as strict\n *\n * True if the strict flag is found in the package.json (modern) or the assembly itself (legacy).\n */\nfunction isStrict(loaded: LoadedAssembly) {\n  return loaded.packageJson?.jsiiRosetta?.strict ?? enforcesStrictMode(loaded.assembly);\n}\n"]}
+{"version":3,"file":"assemblies.js","sourceRoot":"","sources":["../../src/jsii/assemblies.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fsPromises } from 'node:fs';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { loadAssemblyFromFile, loadAssemblyFromPath, findAssemblyFile } from '@jsii/spec';\nimport * as spec from '@jsii/spec';\nimport { fixturize } from '../fixtures';\nimport { extractTypescriptSnippetsFromMarkdown } from '../markdown/extract-snippets';\nimport {\n  TypeScriptSnippet,\n  updateParameters,\n  SnippetParameters,\n  ApiLocation,\n  parseMetadataLine,\n  CompilationDependency,\n  INITIALIZER_METHOD_NAME,\n  typeScriptSnippetFromVisibleSource,\n} from '../snippet';\nimport { resolveDependenciesFromPackageJson } from '../snippet-dependencies';\nimport { enforcesStrictMode } from '../strict';\nimport { LanguageTablet, DEFAULT_TABLET_NAME, DEFAULT_TABLET_NAME_COMPRESSED } from '../tablets/tablets';\nimport { fmap, mkDict, pathExists, sortBy } from '../util';\n\n/**\n * The Assembly features jsii-rosetta supports\n *\n * In actual fact, Rosetta doesn't do much with the Assembly, just crawl all\n * API documentations, so basically most new features would be supported... but\n * we technically should advertise a known list here anyway since we don't\n * know what future extension are going to be.\n */\nexport const SUPPORTED_ASSEMBLY_FEATURES: spec.JsiiFeature[] = ['intersection-types'];\n\n/**\n * The JSDoc tag users can use to associate non-visible metadata with an example\n *\n * In a Markdown section, metadata goes after the code block fence, where it will\n * be attached to the example but invisible.\n *\n *    ```ts metadata=goes here\n *\n * But in doc comments, '@example' already delineates the example, and any metadata\n * in there added by the '///' tags becomes part of the visible code (there is no\n * place to put hidden information).\n *\n * We introduce the '@exampleMetadata' tag to put that additional information.\n */\nexport const EXAMPLE_METADATA_JSDOCTAG = 'exampleMetadata';\n\ninterface RosettaPackageJson extends spec.PackageJson {\n  readonly jsiiRosetta?: {\n    readonly strict?: boolean;\n    readonly exampleDependencies?: Record<string, string>;\n  };\n}\n\nexport interface LoadedAssembly {\n  readonly assembly: spec.Assembly;\n  readonly directory: string;\n  readonly packageJson?: RosettaPackageJson;\n}\n\n/**\n * Load assemblies by filename or directory\n */\nexport function loadAssemblies(\n  assemblyLocations: readonly string[],\n  validateAssemblies: boolean,\n): readonly LoadedAssembly[] {\n  return assemblyLocations.map(loadAssembly);\n\n  function loadAssembly(location: string): LoadedAssembly {\n    const stat = fs.statSync(location);\n    if (stat.isDirectory()) {\n      return loadAssembly(findAssemblyFile(location));\n    }\n\n    const directory = path.dirname(location);\n    const pjLocation = path.join(directory, 'package.json');\n\n    const assembly = loadAssemblyFromFile(location, validateAssemblies, SUPPORTED_ASSEMBLY_FEATURES);\n    const packageJson = fs.existsSync(pjLocation) ? JSON.parse(fs.readFileSync(pjLocation, 'utf-8')) : undefined;\n\n    return { assembly, directory, packageJson };\n  }\n}\n\n/**\n * Load the default tablets for every assembly, if available\n *\n * Returns a map of { directory -> tablet }.\n */\nexport async function loadAllDefaultTablets(asms: readonly LoadedAssembly[]): Promise<Record<string, LanguageTablet>> {\n  return mkDict(\n    await Promise.all(\n      asms.map(\n        async (a) => [a.directory, await LanguageTablet.fromOptionalFile(guessTabletLocation(a.directory))] as const,\n      ),\n    ),\n  );\n}\n\n/**\n * Returns the location of the tablet file, either .jsii.tabl.json or .jsii.tabl.json.gz.\n * Assumes that a tablet exists in the directory and if not, the ensuing behavior is\n * handled by the caller of this function.\n */\nexport function guessTabletLocation(directory: string) {\n  return compressedTabletExists(directory)\n    ? path.join(directory, DEFAULT_TABLET_NAME_COMPRESSED)\n    : path.join(directory, DEFAULT_TABLET_NAME);\n}\n\nexport function compressedTabletExists(directory: string) {\n  return fs.existsSync(path.join(directory, DEFAULT_TABLET_NAME_COMPRESSED));\n}\n\nexport type AssemblySnippetSource =\n  | { type: 'markdown'; markdown: string; location: ApiLocation }\n  | { type: 'example'; source: string; metadata?: { [key: string]: string }; location: ApiLocation };\n\n/**\n * Return all markdown and example snippets from the given assembly\n */\nexport function allSnippetSources(assembly: spec.Assembly): AssemblySnippetSource[] {\n  const ret: AssemblySnippetSource[] = [];\n\n  if (assembly.readme) {\n    ret.push({\n      type: 'markdown',\n      markdown: assembly.readme.markdown,\n      location: { api: 'moduleReadme', moduleFqn: assembly.name },\n    });\n  }\n\n  for (const [submoduleFqn, submodule] of Object.entries(assembly.submodules ?? {})) {\n    if (submodule.readme) {\n      ret.push({\n        type: 'markdown',\n        markdown: submodule.readme.markdown,\n        location: { api: 'moduleReadme', moduleFqn: submoduleFqn },\n      });\n    }\n  }\n\n  if (assembly.types) {\n    for (const type of Object.values(assembly.types)) {\n      emitDocs(type.docs, { api: 'type', fqn: type.fqn });\n\n      if (spec.isEnumType(type)) {\n        for (const m of type.members) emitDocs(m.docs, { api: 'member', fqn: type.fqn, memberName: m.name });\n      }\n      if (spec.isClassType(type)) {\n        emitDocsForCallable(type.initializer, type.fqn);\n      }\n      if (spec.isClassOrInterfaceType(type)) {\n        for (const m of type.methods ?? []) emitDocsForCallable(m, type.fqn, m.name);\n        for (const m of type.properties ?? []) emitDocs(m.docs, { api: 'member', fqn: type.fqn, memberName: m.name });\n      }\n    }\n  }\n\n  return ret;\n\n  function emitDocsForCallable(callable: spec.Callable | undefined, fqn: string, memberName?: string) {\n    if (!callable) {\n      return;\n    }\n    emitDocs(callable.docs, memberName ? { api: 'member', fqn, memberName } : { api: 'initializer', fqn });\n\n    for (const parameter of callable.parameters ?? []) {\n      emitDocs(parameter.docs, {\n        api: 'parameter',\n        fqn: fqn,\n        methodName: memberName ?? INITIALIZER_METHOD_NAME,\n        parameterName: parameter.name,\n      });\n    }\n  }\n\n  function emitDocs(docs: spec.Docs | undefined, location: ApiLocation) {\n    if (!docs) {\n      return;\n    }\n\n    if (docs.remarks) {\n      ret.push({\n        type: 'markdown',\n        markdown: docs.remarks,\n        location,\n      });\n    }\n    if (docs.example) {\n      ret.push({\n        type: 'example',\n        source: docs.example,\n        metadata: fmap(docs.custom?.[EXAMPLE_METADATA_JSDOCTAG], parseMetadataLine),\n        location,\n      });\n    }\n  }\n}\n\nexport async function allTypeScriptSnippets(\n  assemblies: readonly LoadedAssembly[],\n  loose = false,\n): Promise<TypeScriptSnippet[]> {\n  const sources = assemblies\n    .flatMap((loaded) => allSnippetSources(loaded.assembly).map((source) => ({ source, loaded })))\n    .flatMap(({ source, loaded }) => {\n      switch (source.type) {\n        case 'example':\n          return [\n            {\n              snippet: updateParameters(\n                typeScriptSnippetFromVisibleSource(\n                  source.source,\n                  { api: source.location, field: { field: 'example' } },\n                  isStrict(loaded),\n                ),\n                source.metadata ?? {},\n              ),\n              loaded,\n            },\n          ];\n        case 'markdown':\n          return extractTypescriptSnippetsFromMarkdown(source.markdown, source.location, isStrict(loaded)).map(\n            (snippet) => ({ snippet, loaded }),\n          );\n      }\n    });\n\n  const fixtures = [];\n  for (let { snippet, loaded } of sources) {\n    const isInfused = snippet.parameters?.infused != null;\n\n    // Ignore fixturization errors if requested on this command, or if the snippet was infused\n    const ignoreFixtureErrors = loose || isInfused;\n\n    // Also if the snippet was infused: switch off 'strict' mode if it was set\n    if (isInfused) {\n      snippet = { ...snippet, strict: false };\n    }\n\n    snippet = await withDependencies(loaded, withProjectDirectory(loaded.directory, snippet));\n    fixtures.push(fixturize(snippet, ignoreFixtureErrors));\n  }\n\n  return fixtures;\n}\n\nexport interface TypeLookupAssembly {\n  readonly packageJson: any;\n  readonly assembly: spec.Assembly;\n  readonly directory: string;\n  readonly symbolIdMap: Record<string, string>;\n}\n\nconst MAX_ASM_CACHE = 3;\nconst ASM_CACHE: TypeLookupAssembly[] = [];\n\n/**\n * Recursively searches for a .jsii file in the directory.\n * When file is found, checks cache to see if we already\n * stored the assembly in memory. If not, we synchronously\n * load the assembly into memory.\n */\nexport function findTypeLookupAssembly(startingDirectory: string): TypeLookupAssembly | undefined {\n  const pjLocation = findPackageJsonLocation(path.resolve(startingDirectory));\n  if (!pjLocation) {\n    return undefined;\n  }\n  const directory = path.dirname(pjLocation);\n\n  const fromCache = ASM_CACHE.find((c) => c.directory === directory);\n  if (fromCache) {\n    return fromCache;\n  }\n\n  const loaded = loadLookupAssembly(directory);\n  if (!loaded) {\n    return undefined;\n  }\n\n  while (ASM_CACHE.length >= MAX_ASM_CACHE) {\n    ASM_CACHE.pop();\n  }\n  ASM_CACHE.unshift(loaded);\n  return loaded;\n}\n\nfunction loadLookupAssembly(directory: string): TypeLookupAssembly | undefined {\n  try {\n    const packageJson = JSON.parse(fs.readFileSync(path.join(directory, 'package.json'), 'utf-8'));\n    const assembly: spec.Assembly = loadAssemblyFromPath(directory, false, SUPPORTED_ASSEMBLY_FEATURES);\n    const symbolIdMap = mkDict([\n      ...Object.values(assembly.types ?? {}).map((type) => [type.symbolId ?? '', type.fqn] as const),\n      ...Object.entries(assembly.submodules ?? {}).map(([fqn, mod]) => [mod.symbolId ?? '', fqn] as const),\n    ]);\n\n    return {\n      packageJson,\n      assembly,\n      directory,\n      symbolIdMap,\n    };\n  } catch {\n    return undefined;\n  }\n}\n\nfunction findPackageJsonLocation(currentPath: string): string | undefined {\n  // eslint-disable-next-line no-constant-condition\n  while (true) {\n    const candidate = path.join(currentPath, 'package.json');\n    if (fs.existsSync(candidate)) {\n      return candidate;\n    }\n\n    const parentPath = path.resolve(currentPath, '..');\n    if (parentPath === currentPath) {\n      return undefined;\n    }\n    currentPath = parentPath;\n  }\n}\n\n/**\n * Find the jsii [sub]module that contains the given FQN\n *\n * @returns `undefined` if the type is a member of the assembly root.\n */\nexport function findContainingSubmodule(assembly: spec.Assembly, fqn: string): string | undefined {\n  const submoduleNames = Object.keys(assembly.submodules ?? {});\n  sortBy(submoduleNames, (s) => [-s.length]); // Longest first\n  for (const s of submoduleNames) {\n    if (fqn.startsWith(`${s}.`)) {\n      return s;\n    }\n  }\n  return undefined;\n}\n\nfunction withProjectDirectory(dir: string, snippet: TypeScriptSnippet) {\n  return updateParameters(snippet, {\n    [SnippetParameters.$PROJECT_DIRECTORY]: dir,\n  });\n}\n\n/**\n * Return a TypeScript snippet with dependencies added\n *\n * The dependencies will be taken from the package.json, and will consist of:\n *\n * - The package itself\n * - The package's dependencies and peerDependencies (but NOT devDependencies). Will\n *   symlink to the files on disk.\n * - Any additional dependencies declared in `jsiiRosetta.exampleDependencies`.\n */\nasync function withDependencies(asm: LoadedAssembly, snippet: TypeScriptSnippet): Promise<TypeScriptSnippet> {\n  const compilationDependencies: Record<string, CompilationDependency> = {};\n\n  if (await pathExists(path.join(asm.directory, 'package.json'))) {\n    compilationDependencies[asm.assembly.name] = {\n      type: 'concrete',\n      resolvedDirectory: await fsPromises.realpath(asm.directory),\n    };\n  }\n\n  Object.assign(compilationDependencies, await resolveDependenciesFromPackageJson(asm.packageJson, asm.directory));\n\n  Object.assign(\n    compilationDependencies,\n    mkDict(\n      Object.entries(asm.packageJson?.jsiiRosetta?.exampleDependencies ?? {}).map(\n        ([name, versionRange]) => [name, { type: 'symbolic', versionRange }] as const,\n      ),\n    ),\n  );\n\n  return {\n    ...snippet,\n    compilationDependencies,\n  };\n}\n\n/**\n * Whether samples in the assembly should be treated as strict\n *\n * True if the strict flag is found in the package.json (modern) or the assembly itself (legacy).\n */\nfunction isStrict(loaded: LoadedAssembly) {\n  return loaded.packageJson?.jsiiRosetta?.strict ?? enforcesStrictMode(loaded.assembly);\n}\n"]}

package/lib/rosetta-reader.d.ts

@@ -62,6 +62,10 @@ export interface RosettaOptions {
  */
 export declare class RosettaTabletReader {
     private readonly options;
+    /**
+     * The assembly features that the current version of `jsii-rosetta` supports.
+     */
+    static get supportedAssemblyFeatures(): spec.JsiiFeature[];
     /**
      * Newly translated samples
      *

package/lib/rosetta-reader.js

@@ -39,6 +39,12 @@ var UnknownSnippetMode;
  * when the second one is not necessary.
  */
 class RosettaTabletReader {
+    /**
+     * The assembly features that the current version of `jsii-rosetta` supports.
+     */
+    static get supportedAssemblyFeatures() {
+        return assemblies_1.SUPPORTED_ASSEMBLY_FEATURES;
+    }
     constructor(options = {}) {
         this.options = options;
         /**

package/lib/rosetta-reader.js.map

@@ -1 +1 @@
-{"version":3,"file":"rosetta-reader.js","sourceRoot":"","sources":["../src/rosetta-reader.ts"],"names":[],"mappings":"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","sourcesContent":["import * as spec from '@jsii/spec';\n\nimport { allTypeScriptSnippets, guessTabletLocation } from './jsii/assemblies';\nimport { TargetLanguage } from './languages';\nimport * as logging from './logging';\nimport { transformMarkdown } from './markdown/markdown';\nimport { MarkdownRenderer } from './markdown/markdown-renderer';\nimport { ReplaceTypeScriptTransform } from './markdown/replace-typescript-transform';\nimport { CodeBlock } from './markdown/types';\nimport {\n  SnippetParameters,\n  TypeScriptSnippet,\n  updateParameters,\n  ApiLocation,\n  typeScriptSnippetFromSource,\n} from './snippet';\nimport { snippetKey } from './tablets/key';\nimport { LanguageTablet, Translation } from './tablets/tablets';\nimport { Translator } from './translate';\nimport { commentToken, pathExists, printDiagnostics } from './util';\n\nexport enum UnknownSnippetMode {\n  /**\n   * Return the snippet as given (untranslated)\n   */\n  VERBATIM = 'verbatim',\n\n  /**\n   * Live-translate the snippet as best as we can\n   */\n  TRANSLATE = 'translate',\n\n  /**\n   * Throw an error if this occurs\n   */\n  FAIL = 'fail',\n}\n\nexport interface RosettaOptions {\n  /**\n   * Whether or not to live-convert samples\n   *\n   * @default UnknownSnippetMode.VERBATIM\n   */\n  readonly unknownSnippets?: UnknownSnippetMode;\n\n  /**\n   * Target languages to use for live conversion\n   *\n   * @default All languages\n   */\n  readonly targetLanguages?: readonly TargetLanguage[];\n\n  /**\n   * Whether to include compiler diagnostics in the compilation results.\n   */\n  readonly includeCompilerDiagnostics?: boolean;\n\n  /**\n   * Whether this Rosetta should operate in \"loose\" mode, where missing literate\n   * source files and missing fixtures are ignored instead of failing.\n   *\n   * @default false\n   */\n  readonly loose?: boolean;\n\n  /**\n   * Adds a disclaimer to start of snippet if it did not compile.\n   *\n   * @default false\n   */\n  readonly prefixDisclaimer?: boolean;\n}\n\n/**\n * Entry point class for consumers of Rosetta tablets (primarily: pacmak)\n *\n * Rosetta can work in one of two modes:\n *\n * 1. Live translation of snippets.\n * 2. Read translations from a pre-translated tablet (prepared using `jsii-rosetta extract` command).\n *\n * The second method affords more control over the precise circumstances of\n * sample compilation and is recommended, but the first method will do\n * when the second one is not necessary.\n */\nexport class RosettaTabletReader {\n  /**\n   * Newly translated samples\n   *\n   * In case live translation has been enabled, all samples that have been translated on-the-fly\n   * are added to this tablet.\n   */\n  public readonly liveTablet = new LanguageTablet();\n\n  private readonly loadedTablets: LanguageTablet[] = [];\n  private readonly extractedSnippets = new Map<string, TypeScriptSnippet>();\n  private readonly translator: Translator;\n  private readonly loose: boolean;\n  private readonly unknownSnippets: UnknownSnippetMode;\n  private readonly _prefixDisclaimer: boolean;\n\n  public constructor(private readonly options: RosettaOptions = {}) {\n    this.loose = !!options.loose;\n    this.unknownSnippets = options.unknownSnippets ?? UnknownSnippetMode.VERBATIM;\n    this.translator = new Translator(options.includeCompilerDiagnostics ?? false);\n    this._prefixDisclaimer = options.prefixDisclaimer ?? false;\n  }\n\n  /**\n   * Diagnostics encountered while doing live translation\n   */\n  public get diagnostics() {\n    return this.translator.diagnostics;\n  }\n\n  /**\n   * Load a tablet as a source for translateable snippets\n   *\n   * Note: the snippets loaded from this tablet will NOT be validated for\n   * their fingerprints or translator versions! If a matching snippet is found\n   * in the tablet, it will always be returned, whether or not it is stale.\n   */\n  public async loadTabletFromFile(tabletFile: string) {\n    const tablet = new LanguageTablet();\n    await tablet.load(tabletFile);\n    this.addTablet(tablet);\n  }\n\n  /**\n   * Directly add a tablet to the list of tablets to load translations from\n   */\n  public addTablet(tablet: LanguageTablet) {\n    this.loadedTablets.push(tablet);\n  }\n\n  /**\n   * Add an assembly\n   *\n   * If a default tablet file is found in the assembly's directory, it will be\n   * loaded (and assumed to contain a complete list of translated snippets for\n   * this assembly already).\n   *\n   * Otherwise, if live conversion is enabled, the snippets in the assembly\n   * become available for live translation later. This is necessary because we probably\n   * need to fixturize snippets for successful compilation, and the information\n   * pacmak sends our way later on is not going to be enough to do that.\n   */\n  public async addAssembly(assembly: spec.Assembly, assemblyDir: string) {\n    const defaultTablet = guessTabletLocation(assemblyDir);\n    if (await pathExists(defaultTablet)) {\n      try {\n        await this.loadTabletFromFile(defaultTablet);\n        return;\n      } catch (e: any) {\n        logging.warn(`Error loading ${defaultTablet}: ${e.message}. Skipped.`);\n      }\n    }\n\n    // Inventarize the snippets from this assembly, but only if there's a chance\n    // we're going to need them.\n    if (this.unknownSnippets === UnknownSnippetMode.TRANSLATE) {\n      for (const tsnip of await allTypeScriptSnippets([{ assembly, directory: assemblyDir }], this.loose)) {\n        this.extractedSnippets.set(snippetKey(tsnip), tsnip);\n      }\n    }\n  }\n\n  /**\n   * Translate the given snippet for the given target language\n   *\n   * This will either:\n   *\n   * - Find an existing translation in a tablet and return that, if available.\n   * - Otherwise, find a fixturized version of this snippet in an assembly that\n   *   was loaded beforehand, and translate it on-the-fly. Finding the fixture\n   *   will be based on the snippet key, which consists of a hash of the\n   *   visible source and the API location.\n   * - Otherwise, translate the snippet as-is (without fixture information).\n   *\n   * This will do and store a full conversion of the given snippet, even if it only\n   * returns one language. Subsequent retrievals for the same snippet in other\n   * languages will reuse the translation from cache.\n   *\n   * If you are calling this for the side effect of adding translations to the live\n   * tablet, you only need to do that for one language.\n   */\n  public translateSnippet(source: TypeScriptSnippet, targetLang: TargetLanguage): Translation | undefined {\n    // Look for it in loaded tablets (or previous conversions)\n    for (const tab of this.allTablets) {\n      const ret = tab.lookup(source, targetLang);\n      if (ret !== undefined) {\n        return this.prefixDisclaimer(ret, this._prefixDisclaimer);\n      }\n    }\n\n    if (this.unknownSnippets === UnknownSnippetMode.VERBATIM) {\n      return this.prefixDisclaimer(\n        {\n          language: targetLang,\n          source: source.visibleSource,\n        },\n        this._prefixDisclaimer,\n      );\n    }\n\n    if (this.unknownSnippets === UnknownSnippetMode.FAIL) {\n      const message = [\n        'The following snippet was not found in any of the loaded tablets:',\n        source.visibleSource,\n        `Location: ${JSON.stringify(source.location)}`,\n        `Language: ${targetLang}`,\n      ].join('\\n');\n      throw new Error(message);\n    }\n\n    if (this.options.targetLanguages && !this.options.targetLanguages.includes(targetLang)) {\n      throw new Error(\n        `Rosetta configured for live conversion to ${this.options.targetLanguages.join(\n          ', ',\n        )}, but requested ${targetLang}`,\n      );\n    }\n\n    // See if we can find a fixturized version of this snippet. If so, use that do the live\n    // conversion.\n    const extracted = this.extractedSnippets.get(snippetKey(source));\n    if (extracted !== undefined) {\n      const snippet = this.translator.translate(extracted, this.options.targetLanguages);\n      this.liveTablet.addSnippet(snippet);\n      return this.prefixDisclaimer(snippet.get(targetLang), this._prefixDisclaimer);\n    }\n\n    // Try to live-convert it as-is.\n    const snippet = this.translator.translate(source, this.options.targetLanguages);\n    this.liveTablet.addSnippet(snippet);\n    return this.prefixDisclaimer(snippet.get(targetLang), this._prefixDisclaimer);\n  }\n\n  /**\n   * Translate a snippet found in the \"@ example\" section of a jsii assembly\n   *\n   * Behaves exactly like `translateSnippet`, so see that method for documentation.\n   */\n  public translateExample(\n    apiLocation: ApiLocation,\n    example: string,\n    targetLang: TargetLanguage,\n    strict: boolean,\n    compileDirectory = process.cwd(),\n  ): Translation {\n    const location = { api: apiLocation, field: { field: 'example' } } as const;\n\n    const snippet = typeScriptSnippetFromSource(example, location, strict, {\n      [SnippetParameters.$COMPILATION_DIRECTORY]: compileDirectory,\n    });\n\n    const translated = this.translateSnippet(snippet, targetLang);\n\n    return translated ?? { language: 'typescript', source: example };\n  }\n\n  /**\n   * Translate all TypeScript snippets found in a block of Markdown text\n   *\n   * For each snippet, behaves exactly like `translateSnippet`, so see that\n   * method for documentation.\n   */\n  public translateSnippetsInMarkdown(\n    apiLocation: ApiLocation,\n    markdown: string,\n    targetLang: TargetLanguage,\n    strict: boolean,\n    translationToCodeBlock: (x: Translation) => CodeBlock = id,\n    compileDirectory = process.cwd(),\n  ): string {\n    return transformMarkdown(\n      markdown,\n      new MarkdownRenderer(),\n      new ReplaceTypeScriptTransform(apiLocation, strict, (tsSnip) => {\n        const translated = this.translateSnippet(\n          updateParameters(tsSnip, {\n            [SnippetParameters.$COMPILATION_DIRECTORY]: compileDirectory,\n          }),\n          targetLang,\n        );\n        if (!translated) {\n          return undefined;\n        }\n\n        return translationToCodeBlock(translated);\n      }),\n    );\n  }\n\n  public printDiagnostics(stream: NodeJS.WritableStream, colors = true) {\n    printDiagnostics(this.diagnostics, stream, colors);\n  }\n\n  public get hasErrors() {\n    return this.diagnostics.some((d) => d.isError);\n  }\n\n  private get allTablets(): LanguageTablet[] {\n    return [...this.loadedTablets, this.liveTablet];\n  }\n\n  /**\n   * Adds a disclaimer to the front of the example if the prefixDisclaimer\n   * flag is set and we know it does not compile.\n   */\n  private prefixDisclaimer(translation: Translation | undefined, prefixDisclaimer: boolean): Translation | undefined {\n    if (!prefixDisclaimer || translation?.didCompile !== false) {\n      return translation;\n    }\n    const comment = commentToken(translation.language);\n    const disclaimer = 'Example automatically generated from non-compiling source. May contain errors.';\n    return {\n      ...translation,\n      source: `${comment} ${disclaimer}\\n${translation.source}`,\n    };\n  }\n}\n\nfunction id(x: Translation) {\n  return x;\n}\n\n/**\n * Backwards compatibility\n *\n * @deprecated use RosettaTabletReader instead\n */\nexport class Rosetta extends RosettaTabletReader {}\n"]}
+{"version":3,"file":"rosetta-reader.js","sourceRoot":"","sources":["../src/rosetta-reader.ts"],"names":[],"mappings":"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","sourcesContent":["import * as spec from '@jsii/spec';\n\nimport { allTypeScriptSnippets, guessTabletLocation, SUPPORTED_ASSEMBLY_FEATURES } from './jsii/assemblies';\nimport { TargetLanguage } from './languages';\nimport * as logging from './logging';\nimport { transformMarkdown } from './markdown/markdown';\nimport { MarkdownRenderer } from './markdown/markdown-renderer';\nimport { ReplaceTypeScriptTransform } from './markdown/replace-typescript-transform';\nimport { CodeBlock } from './markdown/types';\nimport {\n  SnippetParameters,\n  TypeScriptSnippet,\n  updateParameters,\n  ApiLocation,\n  typeScriptSnippetFromSource,\n} from './snippet';\nimport { snippetKey } from './tablets/key';\nimport { LanguageTablet, Translation } from './tablets/tablets';\nimport { Translator } from './translate';\nimport { commentToken, pathExists, printDiagnostics } from './util';\n\nexport enum UnknownSnippetMode {\n  /**\n   * Return the snippet as given (untranslated)\n   */\n  VERBATIM = 'verbatim',\n\n  /**\n   * Live-translate the snippet as best as we can\n   */\n  TRANSLATE = 'translate',\n\n  /**\n   * Throw an error if this occurs\n   */\n  FAIL = 'fail',\n}\n\nexport interface RosettaOptions {\n  /**\n   * Whether or not to live-convert samples\n   *\n   * @default UnknownSnippetMode.VERBATIM\n   */\n  readonly unknownSnippets?: UnknownSnippetMode;\n\n  /**\n   * Target languages to use for live conversion\n   *\n   * @default All languages\n   */\n  readonly targetLanguages?: readonly TargetLanguage[];\n\n  /**\n   * Whether to include compiler diagnostics in the compilation results.\n   */\n  readonly includeCompilerDiagnostics?: boolean;\n\n  /**\n   * Whether this Rosetta should operate in \"loose\" mode, where missing literate\n   * source files and missing fixtures are ignored instead of failing.\n   *\n   * @default false\n   */\n  readonly loose?: boolean;\n\n  /**\n   * Adds a disclaimer to start of snippet if it did not compile.\n   *\n   * @default false\n   */\n  readonly prefixDisclaimer?: boolean;\n}\n\n/**\n * Entry point class for consumers of Rosetta tablets (primarily: pacmak)\n *\n * Rosetta can work in one of two modes:\n *\n * 1. Live translation of snippets.\n * 2. Read translations from a pre-translated tablet (prepared using `jsii-rosetta extract` command).\n *\n * The second method affords more control over the precise circumstances of\n * sample compilation and is recommended, but the first method will do\n * when the second one is not necessary.\n */\nexport class RosettaTabletReader {\n  /**\n   * The assembly features that the current version of `jsii-rosetta` supports.\n   */\n  public static get supportedAssemblyFeatures(): spec.JsiiFeature[] {\n    return SUPPORTED_ASSEMBLY_FEATURES;\n  }\n\n  /**\n   * Newly translated samples\n   *\n   * In case live translation has been enabled, all samples that have been translated on-the-fly\n   * are added to this tablet.\n   */\n  public readonly liveTablet = new LanguageTablet();\n\n  private readonly loadedTablets: LanguageTablet[] = [];\n  private readonly extractedSnippets = new Map<string, TypeScriptSnippet>();\n  private readonly translator: Translator;\n  private readonly loose: boolean;\n  private readonly unknownSnippets: UnknownSnippetMode;\n  private readonly _prefixDisclaimer: boolean;\n\n  public constructor(private readonly options: RosettaOptions = {}) {\n    this.loose = !!options.loose;\n    this.unknownSnippets = options.unknownSnippets ?? UnknownSnippetMode.VERBATIM;\n    this.translator = new Translator(options.includeCompilerDiagnostics ?? false);\n    this._prefixDisclaimer = options.prefixDisclaimer ?? false;\n  }\n\n  /**\n   * Diagnostics encountered while doing live translation\n   */\n  public get diagnostics() {\n    return this.translator.diagnostics;\n  }\n\n  /**\n   * Load a tablet as a source for translateable snippets\n   *\n   * Note: the snippets loaded from this tablet will NOT be validated for\n   * their fingerprints or translator versions! If a matching snippet is found\n   * in the tablet, it will always be returned, whether or not it is stale.\n   */\n  public async loadTabletFromFile(tabletFile: string) {\n    const tablet = new LanguageTablet();\n    await tablet.load(tabletFile);\n    this.addTablet(tablet);\n  }\n\n  /**\n   * Directly add a tablet to the list of tablets to load translations from\n   */\n  public addTablet(tablet: LanguageTablet) {\n    this.loadedTablets.push(tablet);\n  }\n\n  /**\n   * Add an assembly\n   *\n   * If a default tablet file is found in the assembly's directory, it will be\n   * loaded (and assumed to contain a complete list of translated snippets for\n   * this assembly already).\n   *\n   * Otherwise, if live conversion is enabled, the snippets in the assembly\n   * become available for live translation later. This is necessary because we probably\n   * need to fixturize snippets for successful compilation, and the information\n   * pacmak sends our way later on is not going to be enough to do that.\n   */\n  public async addAssembly(assembly: spec.Assembly, assemblyDir: string) {\n    const defaultTablet = guessTabletLocation(assemblyDir);\n    if (await pathExists(defaultTablet)) {\n      try {\n        await this.loadTabletFromFile(defaultTablet);\n        return;\n      } catch (e: any) {\n        logging.warn(`Error loading ${defaultTablet}: ${e.message}. Skipped.`);\n      }\n    }\n\n    // Inventarize the snippets from this assembly, but only if there's a chance\n    // we're going to need them.\n    if (this.unknownSnippets === UnknownSnippetMode.TRANSLATE) {\n      for (const tsnip of await allTypeScriptSnippets([{ assembly, directory: assemblyDir }], this.loose)) {\n        this.extractedSnippets.set(snippetKey(tsnip), tsnip);\n      }\n    }\n  }\n\n  /**\n   * Translate the given snippet for the given target language\n   *\n   * This will either:\n   *\n   * - Find an existing translation in a tablet and return that, if available.\n   * - Otherwise, find a fixturized version of this snippet in an assembly that\n   *   was loaded beforehand, and translate it on-the-fly. Finding the fixture\n   *   will be based on the snippet key, which consists of a hash of the\n   *   visible source and the API location.\n   * - Otherwise, translate the snippet as-is (without fixture information).\n   *\n   * This will do and store a full conversion of the given snippet, even if it only\n   * returns one language. Subsequent retrievals for the same snippet in other\n   * languages will reuse the translation from cache.\n   *\n   * If you are calling this for the side effect of adding translations to the live\n   * tablet, you only need to do that for one language.\n   */\n  public translateSnippet(source: TypeScriptSnippet, targetLang: TargetLanguage): Translation | undefined {\n    // Look for it in loaded tablets (or previous conversions)\n    for (const tab of this.allTablets) {\n      const ret = tab.lookup(source, targetLang);\n      if (ret !== undefined) {\n        return this.prefixDisclaimer(ret, this._prefixDisclaimer);\n      }\n    }\n\n    if (this.unknownSnippets === UnknownSnippetMode.VERBATIM) {\n      return this.prefixDisclaimer(\n        {\n          language: targetLang,\n          source: source.visibleSource,\n        },\n        this._prefixDisclaimer,\n      );\n    }\n\n    if (this.unknownSnippets === UnknownSnippetMode.FAIL) {\n      const message = [\n        'The following snippet was not found in any of the loaded tablets:',\n        source.visibleSource,\n        `Location: ${JSON.stringify(source.location)}`,\n        `Language: ${targetLang}`,\n      ].join('\\n');\n      throw new Error(message);\n    }\n\n    if (this.options.targetLanguages && !this.options.targetLanguages.includes(targetLang)) {\n      throw new Error(\n        `Rosetta configured for live conversion to ${this.options.targetLanguages.join(\n          ', ',\n        )}, but requested ${targetLang}`,\n      );\n    }\n\n    // See if we can find a fixturized version of this snippet. If so, use that do the live\n    // conversion.\n    const extracted = this.extractedSnippets.get(snippetKey(source));\n    if (extracted !== undefined) {\n      const snippet = this.translator.translate(extracted, this.options.targetLanguages);\n      this.liveTablet.addSnippet(snippet);\n      return this.prefixDisclaimer(snippet.get(targetLang), this._prefixDisclaimer);\n    }\n\n    // Try to live-convert it as-is.\n    const snippet = this.translator.translate(source, this.options.targetLanguages);\n    this.liveTablet.addSnippet(snippet);\n    return this.prefixDisclaimer(snippet.get(targetLang), this._prefixDisclaimer);\n  }\n\n  /**\n   * Translate a snippet found in the \"@ example\" section of a jsii assembly\n   *\n   * Behaves exactly like `translateSnippet`, so see that method for documentation.\n   */\n  public translateExample(\n    apiLocation: ApiLocation,\n    example: string,\n    targetLang: TargetLanguage,\n    strict: boolean,\n    compileDirectory = process.cwd(),\n  ): Translation {\n    const location = { api: apiLocation, field: { field: 'example' } } as const;\n\n    const snippet = typeScriptSnippetFromSource(example, location, strict, {\n      [SnippetParameters.$COMPILATION_DIRECTORY]: compileDirectory,\n    });\n\n    const translated = this.translateSnippet(snippet, targetLang);\n\n    return translated ?? { language: 'typescript', source: example };\n  }\n\n  /**\n   * Translate all TypeScript snippets found in a block of Markdown text\n   *\n   * For each snippet, behaves exactly like `translateSnippet`, so see that\n   * method for documentation.\n   */\n  public translateSnippetsInMarkdown(\n    apiLocation: ApiLocation,\n    markdown: string,\n    targetLang: TargetLanguage,\n    strict: boolean,\n    translationToCodeBlock: (x: Translation) => CodeBlock = id,\n    compileDirectory = process.cwd(),\n  ): string {\n    return transformMarkdown(\n      markdown,\n      new MarkdownRenderer(),\n      new ReplaceTypeScriptTransform(apiLocation, strict, (tsSnip) => {\n        const translated = this.translateSnippet(\n          updateParameters(tsSnip, {\n            [SnippetParameters.$COMPILATION_DIRECTORY]: compileDirectory,\n          }),\n          targetLang,\n        );\n        if (!translated) {\n          return undefined;\n        }\n\n        return translationToCodeBlock(translated);\n      }),\n    );\n  }\n\n  public printDiagnostics(stream: NodeJS.WritableStream, colors = true) {\n    printDiagnostics(this.diagnostics, stream, colors);\n  }\n\n  public get hasErrors() {\n    return this.diagnostics.some((d) => d.isError);\n  }\n\n  private get allTablets(): LanguageTablet[] {\n    return [...this.loadedTablets, this.liveTablet];\n  }\n\n  /**\n   * Adds a disclaimer to the front of the example if the prefixDisclaimer\n   * flag is set and we know it does not compile.\n   */\n  private prefixDisclaimer(translation: Translation | undefined, prefixDisclaimer: boolean): Translation | undefined {\n    if (!prefixDisclaimer || translation?.didCompile !== false) {\n      return translation;\n    }\n    const comment = commentToken(translation.language);\n    const disclaimer = 'Example automatically generated from non-compiling source. May contain errors.';\n    return {\n      ...translation,\n      source: `${comment} ${disclaimer}\\n${translation.source}`,\n    };\n  }\n}\n\nfunction id(x: Translation) {\n  return x;\n}\n\n/**\n * Backwards compatibility\n *\n * @deprecated use RosettaTabletReader instead\n */\nexport class Rosetta extends RosettaTabletReader {}\n"]}

package/package.json

@@ -56,7 +56,7 @@
     "eslint-plugin-unicorn": "^56.0.1",
     "fs-monkey": "^1.1.0",
     "jest": "^29.7.0",
-    "memfs": "^4.43.0",
+    "memfs": "^4.46.0",
     "mock-fs": "^5.5.0",
     "prettier": "^2.8.8",
     "projen": "^0.96.3",
@@ -88,7 +88,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "5.9.6-dev.2",
+  "version": "5.9.6",
   "types": "lib/index.d.ts",
   "exports": {
     ".": "./lib/index.js",