jsii-rosetta 5.4.32-dev.4 → 5.5.1-dev.0

package/lib/snippet-dependencies.js.map

@@ -1 +1 @@
-{"version":3,"file":"snippet-dependencies.js","sourceRoot":"","sources":["../src/snippet-dependencies.ts"],"names":[],"mappings":"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","sourcesContent":["import * as cp from 'node:child_process';\nimport { promises as fsPromises } from 'node:fs';\nimport * as fs from 'node:fs';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\nimport { PackageJson } from '@jsii/spec';\nimport * as fastGlob from 'fast-glob';\nimport * as semver from 'semver';\n\nimport { findDependencyDirectory, findUp, isBuiltinModule } from './find-utils';\nimport * as logging from './logging';\nimport { TypeScriptSnippet, CompilationDependency } from './snippet';\nimport { mkDict, formatList, pathExists } from './util';\n// eslint-disable-next-line @typescript-eslint/no-require-imports\nconst { intersect } = require('semver-intersect');\n\n/**\n * Collect the dependencies of a bunch of snippets together in one declaration\n *\n * We assume here the dependencies will not conflict.\n */\nexport function collectDependencies(snippets: TypeScriptSnippet[]) {\n  const ret: Record<string, CompilationDependency> = {};\n  for (const snippet of snippets) {\n    for (const [name, source] of Object.entries(snippet.compilationDependencies ?? {})) {\n      ret[name] = resolveConflict(name, source, ret[name]);\n    }\n  }\n  return ret;\n}\n\n/**\n * Add transitive dependencies of concrete dependencies to the array\n *\n * This is necessary to prevent multiple copies of transitive dependencies on disk, which\n * jsii-based packages might not deal with very well.\n */\nexport async function expandWithTransitiveDependencies(deps: Record<string, CompilationDependency>) {\n  const pathsSeen = new Set<string>();\n  const queue = Object.values(deps).filter(isConcrete);\n\n  let next = queue.shift();\n  while (next) {\n    await addDependenciesOf(next.resolvedDirectory);\n    next = queue.shift();\n  }\n\n  async function addDependenciesOf(dir: string) {\n    if (pathsSeen.has(dir)) {\n      return;\n    }\n    pathsSeen.add(dir);\n    try {\n      const pj: PackageJson = JSON.parse(\n        await fsPromises.readFile(path.join(dir, 'package.json'), { encoding: 'utf-8' }),\n      );\n      for (const [name, dep] of Object.entries(await resolveDependenciesFromPackageJson(pj, dir))) {\n        if (!deps[name]) {\n          deps[name] = dep;\n          queue.push(dep);\n        }\n      }\n    } catch (e: any) {\n      if (e.code === 'ENOENT') {\n        return;\n      }\n      throw e;\n    }\n  }\n}\n\n/**\n * Find the corresponding package directories for all dependencies in a package.json\n */\nexport async function resolveDependenciesFromPackageJson(packageJson: PackageJson | undefined, directory: string) {\n  return mkDict(\n    await Promise.all(\n      Object.keys({ ...packageJson?.dependencies, ...packageJson?.peerDependencies })\n        .filter((name) => !isBuiltinModule(name))\n        .filter(\n          (name) =>\n            !packageJson?.bundledDependencies?.includes(name) && !packageJson?.bundleDependencies?.includes(name),\n        )\n        .map(\n          async (name) =>\n            [\n              name,\n              {\n                type: 'concrete',\n                resolvedDirectory: await fsPromises.realpath(await findDependencyDirectory(name, directory)),\n              },\n            ] as const,\n        ),\n    ),\n  );\n}\n\nfunction resolveConflict(\n  name: string,\n  a: CompilationDependency,\n  b: CompilationDependency | undefined,\n): CompilationDependency {\n  if (!b) {\n    return a;\n  }\n\n  if (a.type === 'concrete' && b.type === 'concrete') {\n    if (b.resolvedDirectory !== a.resolvedDirectory) {\n      throw new Error(`Dependency conflict: ${name} can be either ${a.resolvedDirectory} or ${b.resolvedDirectory}`);\n    }\n    return a;\n  }\n\n  if (a.type === 'symbolic' && b.type === 'symbolic') {\n    // Intersect the ranges\n    return {\n      type: 'symbolic',\n      versionRange: myVersionIntersect(a.versionRange, b.versionRange),\n    };\n  }\n\n  if (a.type === 'concrete' && b.type === 'symbolic') {\n    const concreteVersion: string = JSON.parse(\n      fs.readFileSync(path.join(a.resolvedDirectory, 'package.json'), 'utf-8'),\n    ).version;\n\n    if (!semver.satisfies(concreteVersion, b.versionRange, { includePrerelease: true })) {\n      throw new Error(\n        `Dependency conflict: ${name} expected to match ${b.versionRange} but found ${concreteVersion} at ${a.resolvedDirectory}`,\n      );\n    }\n\n    return a;\n  }\n\n  if (a.type === 'symbolic' && b.type === 'concrete') {\n    // Reverse roles so we fall into the previous case\n    return resolveConflict(name, b, a);\n  }\n\n  throw new Error('Cases should have been exhaustive');\n}\n\n/**\n * Check that the directory we were given has all the necessary dependencies in it\n *\n * It's a warning if this is not true, not an error.\n */\nexport async function validateAvailableDependencies(directory: string, deps: Record<string, CompilationDependency>) {\n  logging.info(`Validating dependencies at ${directory}`);\n  const failures = await Promise.all(\n    Object.entries(deps).flatMap(async ([name, _dep]) => {\n      try {\n        await findDependencyDirectory(name, directory);\n        return [];\n      } catch {\n        return [name];\n      }\n    }),\n  );\n\n  if (failures.length > 0) {\n    logging.warn(\n      `${directory}: packages necessary to compile examples missing from supplied directory: ${failures.join(', ')}`,\n    );\n  }\n}\n\n/**\n * Intersect two semver ranges\n *\n * The package we are using for this doesn't support all syntaxes yet.\n * Do some work on top.\n */\nfunction myVersionIntersect(a: string, b: string): string {\n  if (a === '*') {\n    return b;\n  }\n  if (b === '*') {\n    return a;\n  }\n\n  try {\n    return intersect(a, b);\n  } catch (e: any) {\n    throw new Error(`semver-intersect does not support either '${a}' or '${b}': ${e.message}`);\n  }\n}\n\n/**\n * Prepare a temporary directory with symlinks to all the dependencies we need.\n *\n * - Symlinks the concrete dependencies\n * - Tries to first find the symbolic dependencies in a potential monorepo that might be present\n *   (try both `lerna` and `yarn` monorepos).\n * - Installs the remaining symbolic dependencies using 'npm'.\n */\nexport async function prepareDependencyDirectory(deps: Record<string, CompilationDependency>): Promise<string> {\n  const concreteDirs = Object.values(deps)\n    .filter(isConcrete)\n    .map((x) => x.resolvedDirectory);\n  const monorepoPackages = await scanMonoRepos(concreteDirs);\n\n  const tmpDir = await fsPromises.mkdtemp(path.join(os.tmpdir(), 'rosetta'));\n  logging.info(`Preparing dependency closure at ${tmpDir} (-vv for more details)`);\n\n  // Resolved symbolic packages against monorepo\n  const resolvedDeps = mkDict(\n    Object.entries(deps).map(([name, dep]) => [\n      name,\n      dep.type === 'concrete'\n        ? dep\n        : ((monorepoPackages[name]\n            ? { type: 'concrete', resolvedDirectory: monorepoPackages[name] }\n            : dep) as CompilationDependency),\n    ]),\n  );\n\n  const dependencies: Record<string, string> = {};\n  for (const [name, dep] of Object.entries(resolvedDeps)) {\n    if (isConcrete(dep)) {\n      logging.debug(`${name} -> ${dep.resolvedDirectory}`);\n      dependencies[name] = `file:${dep.resolvedDirectory}`;\n    } else {\n      logging.debug(`${name} @ ${dep.versionRange}`);\n      dependencies[name] = dep.versionRange;\n    }\n  }\n\n  await fsPromises.writeFile(\n    path.join(tmpDir, 'package.json'),\n    JSON.stringify(\n      {\n        name: 'examples',\n        version: '0.0.1',\n        private: true,\n        dependencies,\n      },\n      undefined,\n      2,\n    ),\n    {\n      encoding: 'utf-8',\n    },\n  );\n\n  // Run NPM install on this package.json. We need to include --force for packages\n  // that have a symbolic version in the symlinked dev tree (like \"0.0.0\"), but have\n  // actual version range dependencies from externally installed packages (like \"^2.0.0\").\n  cp.execSync(`npm install --force --loglevel error`, { cwd: tmpDir, encoding: 'utf-8' });\n\n  return tmpDir;\n}\n\n/**\n * Map package name to directory\n */\nasync function scanMonoRepos(startingDirs: readonly string[]): Promise<Record<string, string>> {\n  const globs = new Set<string>();\n  for (const dir of startingDirs) {\n    // eslint-disable-next-line no-await-in-loop\n    setExtend(globs, await findMonoRepoGlobs(dir));\n  }\n\n  if (globs.size === 0) {\n    return {};\n  }\n\n  logging.debug(`Monorepo package sources: ${Array.from(globs).join(', ')}`);\n\n  const packageDirectories = await fastGlob(Array.from(globs).map(windowsToUnix), { onlyDirectories: true });\n  const results = mkDict(\n    (\n      await Promise.all(\n        packageDirectories.map(async (directory) => {\n          const pjLocation = path.join(directory, 'package.json');\n          return (await pathExists(pjLocation))\n            ? [[JSON.parse(await fsPromises.readFile(pjLocation, 'utf-8')).name as string, directory] as const]\n            : [];\n        }),\n      )\n    ).flat(),\n  );\n\n  logging.debug(`Found ${Object.keys(results).length} packages in monorepo: ${formatList(Object.keys(results))}`);\n  return results;\n}\n\nasync function findMonoRepoGlobs(startingDir: string): Promise<Set<string>> {\n  const ret = new Set<string>();\n\n  // Lerna monorepo\n  const lernaJsonDir = await findUp(startingDir, async (dir) => pathExists(path.join(dir, 'lerna.json')));\n  if (lernaJsonDir) {\n    const lernaJson = JSON.parse(await fsPromises.readFile(path.join(lernaJsonDir, 'lerna.json'), 'utf-8'));\n    for (const glob of lernaJson?.packages ?? []) {\n      ret.add(path.join(lernaJsonDir, glob));\n    }\n  }\n\n  // Yarn monorepo\n  const yarnWsDir = await findUp(\n    startingDir,\n    async (dir) =>\n      (await pathExists(path.join(dir, 'package.json'))) &&\n      JSON.parse(await fsPromises.readFile(path.join(dir, 'package.json'), 'utf-8'))?.workspaces !== undefined,\n  );\n  if (yarnWsDir) {\n    const yarnWs = JSON.parse(await fsPromises.readFile(path.join(yarnWsDir, 'package.json'), 'utf-8'));\n    for (const glob of yarnWs.workspaces?.packages ?? []) {\n      ret.add(path.join(yarnWsDir, glob));\n    }\n  }\n\n  return ret;\n}\n\nfunction isConcrete(x: CompilationDependency): x is Extract<CompilationDependency, { type: 'concrete' }> {\n  return x.type === 'concrete';\n}\n\nfunction setExtend<A>(xs: Set<A>, ys: Set<A>) {\n  for (const y of ys) {\n    xs.add(y);\n  }\n  return xs;\n}\n\n/**\n * Necessary for fastGlob\n */\nfunction windowsToUnix(x: string) {\n  return x.replace(/\\\\/g, '/');\n}\n"]}
+{"version":3,"file":"snippet-dependencies.js","sourceRoot":"","sources":["../src/snippet-dependencies.ts"],"names":[],"mappings":"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","sourcesContent":["import * as cp from 'node:child_process';\nimport { promises as fsPromises } from 'node:fs';\nimport * as fs from 'node:fs';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\nimport { PackageJson } from '@jsii/spec';\nimport * as fastGlob from 'fast-glob';\nimport * as semver from 'semver';\n\nimport { findDependencyDirectory, findUp, isBuiltinModule } from './find-utils';\nimport * as logging from './logging';\nimport { TypeScriptSnippet, CompilationDependency } from './snippet';\nimport { mkDict, formatList, pathExists } from './util';\n// eslint-disable-next-line @typescript-eslint/no-require-imports\nconst { intersect } = require('semver-intersect');\n\n/**\n * Collect the dependencies of a bunch of snippets together in one declaration\n *\n * We assume here the dependencies will not conflict.\n */\nexport function collectDependencies(snippets: TypeScriptSnippet[]) {\n  const ret: Record<string, CompilationDependency> = {};\n  for (const snippet of snippets) {\n    for (const [name, source] of Object.entries(snippet.compilationDependencies ?? {})) {\n      ret[name] = resolveConflict(name, source, ret[name]);\n    }\n  }\n  return ret;\n}\n\n/**\n * Add transitive dependencies of concrete dependencies to the array\n *\n * This is necessary to prevent multiple copies of transitive dependencies on disk, which\n * jsii-based packages might not deal with very well.\n */\nexport async function expandWithTransitiveDependencies(deps: Record<string, CompilationDependency>) {\n  const pathsSeen = new Set<string>();\n  const queue = Object.values(deps).filter(isConcrete);\n\n  let next = queue.shift();\n  while (next) {\n    await addDependenciesOf(next.resolvedDirectory);\n    next = queue.shift();\n  }\n\n  async function addDependenciesOf(dir: string) {\n    if (pathsSeen.has(dir)) {\n      return;\n    }\n    pathsSeen.add(dir);\n    try {\n      const pj: PackageJson = JSON.parse(\n        await fsPromises.readFile(path.join(dir, 'package.json'), { encoding: 'utf-8' }),\n      );\n      for (const [name, dep] of Object.entries(await resolveDependenciesFromPackageJson(pj, dir))) {\n        if (!deps[name]) {\n          deps[name] = dep;\n          queue.push(dep);\n        }\n      }\n    } catch (e: any) {\n      if (e.code === 'ENOENT') {\n        return;\n      }\n      throw e;\n    }\n  }\n}\n\n/**\n * Find the corresponding package directories for all dependencies in a package.json\n */\nexport async function resolveDependenciesFromPackageJson(packageJson: PackageJson | undefined, directory: string) {\n  return mkDict(\n    await Promise.all(\n      Object.keys({ ...packageJson?.dependencies, ...packageJson?.peerDependencies })\n        .filter((name) => !isBuiltinModule(name))\n        .filter(\n          (name) =>\n            !packageJson?.bundledDependencies?.includes(name) && !packageJson?.bundleDependencies?.includes(name),\n        )\n        .map(\n          async (name) =>\n            [\n              name,\n              {\n                type: 'concrete',\n                resolvedDirectory: await fsPromises.realpath(await findDependencyDirectory(name, directory)),\n              },\n            ] as const,\n        ),\n    ),\n  );\n}\n\nfunction resolveConflict(\n  name: string,\n  a: CompilationDependency,\n  b: CompilationDependency | undefined,\n): CompilationDependency {\n  if (!b) {\n    return a;\n  }\n\n  if (a.type === 'concrete' && b.type === 'concrete') {\n    if (b.resolvedDirectory !== a.resolvedDirectory) {\n      throw new Error(`Dependency conflict: ${name} can be either ${a.resolvedDirectory} or ${b.resolvedDirectory}`);\n    }\n    return a;\n  }\n\n  if (a.type === 'symbolic' && b.type === 'symbolic') {\n    // Intersect the ranges\n    return {\n      type: 'symbolic',\n      versionRange: myVersionIntersect(a.versionRange, b.versionRange),\n    };\n  }\n\n  if (a.type === 'concrete' && b.type === 'symbolic') {\n    const concreteVersion: string = JSON.parse(\n      fs.readFileSync(path.join(a.resolvedDirectory, 'package.json'), 'utf-8'),\n    ).version;\n\n    if (!semver.satisfies(concreteVersion, b.versionRange, { includePrerelease: true })) {\n      throw new Error(\n        `Dependency conflict: ${name} expected to match ${b.versionRange} but found ${concreteVersion} at ${a.resolvedDirectory}`,\n      );\n    }\n\n    return a;\n  }\n\n  if (a.type === 'symbolic' && b.type === 'concrete') {\n    // Reverse roles so we fall into the previous case\n    return resolveConflict(name, b, a);\n  }\n\n  throw new Error('Cases should have been exhaustive');\n}\n\n/**\n * Check that the directory we were given has all the necessary dependencies in it\n *\n * It's a warning if this is not true, not an error.\n */\nexport async function validateAvailableDependencies(directory: string, deps: Record<string, CompilationDependency>) {\n  logging.info(`Validating dependencies at ${directory}`);\n  const failures = await Promise.all(\n    Object.entries(deps).flatMap(async ([name, _dep]) => {\n      try {\n        await findDependencyDirectory(name, directory);\n        return [];\n      } catch {\n        return [name];\n      }\n    }),\n  );\n\n  if (failures.length > 0) {\n    logging.warn(\n      `${directory}: packages necessary to compile examples missing from supplied directory: ${failures.join(', ')}`,\n    );\n  }\n}\n\n/**\n * Intersect two semver ranges\n *\n * The package we are using for this doesn't support all syntaxes yet.\n * Do some work on top.\n */\nfunction myVersionIntersect(a: string, b: string): string {\n  if (a === '*') {\n    return b;\n  }\n  if (b === '*') {\n    return a;\n  }\n\n  try {\n    return intersect(a, b);\n  } catch (e: any) {\n    throw new Error(`semver-intersect does not support either '${a}' or '${b}': ${e.message}`);\n  }\n}\n\n/**\n * Prepare a temporary directory with symlinks to all the dependencies we need.\n *\n * - Symlinks the concrete dependencies\n * - Tries to first find the symbolic dependencies in a potential monorepo that might be present\n *   (try both `lerna` and `yarn` monorepos).\n * - Installs the remaining symbolic dependencies using 'npm'.\n */\nexport async function prepareDependencyDirectory(deps: Record<string, CompilationDependency>): Promise<string> {\n  const concreteDirs = Object.values(deps)\n    .filter(isConcrete)\n    .map((x) => x.resolvedDirectory);\n  const monorepoPackages = await scanMonoRepos(concreteDirs);\n\n  const tmpDir = await fsPromises.mkdtemp(path.join(os.tmpdir(), 'rosetta'));\n  logging.info(`Preparing dependency closure at ${tmpDir} (-vv for more details)`);\n\n  // Resolved symbolic packages against monorepo\n  const resolvedDeps = mkDict(\n    Object.entries(deps).map(([name, dep]) => [\n      name,\n      dep.type === 'concrete'\n        ? dep\n        : ((monorepoPackages[name]\n            ? { type: 'concrete', resolvedDirectory: monorepoPackages[name] }\n            : dep) as CompilationDependency),\n    ]),\n  );\n\n  const dependencies: Record<string, string> = {};\n  for (const [name, dep] of Object.entries(resolvedDeps)) {\n    if (isConcrete(dep)) {\n      logging.debug(`${name} -> ${dep.resolvedDirectory}`);\n      dependencies[name] = `file:${dep.resolvedDirectory}`;\n    } else {\n      logging.debug(`${name} @ ${dep.versionRange}`);\n      dependencies[name] = dep.versionRange;\n    }\n  }\n\n  await fsPromises.writeFile(\n    path.join(tmpDir, 'package.json'),\n    JSON.stringify(\n      {\n        name: 'examples',\n        version: '0.0.1',\n        private: true,\n        dependencies,\n      },\n      undefined,\n      2,\n    ),\n    {\n      encoding: 'utf-8',\n    },\n  );\n\n  // Run NPM install on this package.json. We need to include --force for packages\n  // that have a symbolic version in the symlinked dev tree (like \"0.0.0\"), but have\n  // actual version range dependencies from externally installed packages (like \"^2.0.0\").\n  cp.execSync(`npm install --force --loglevel error`, { cwd: tmpDir, encoding: 'utf-8' });\n\n  return tmpDir;\n}\n\n/**\n * Map package name to directory\n */\nasync function scanMonoRepos(startingDirs: readonly string[]): Promise<Record<string, string>> {\n  const globs = new Set<string>();\n  for (const dir of startingDirs) {\n    // eslint-disable-next-line no-await-in-loop\n    setExtend(globs, await findMonoRepoGlobs(dir));\n  }\n\n  if (globs.size === 0) {\n    return {};\n  }\n\n  logging.debug(`Monorepo package sources: ${Array.from(globs).join(', ')}`);\n\n  const packageDirectories = await fastGlob(Array.from(globs).map(windowsToUnix), { onlyDirectories: true });\n  const results = mkDict(\n    (\n      await Promise.all(\n        packageDirectories.map(async (directory) => {\n          const pjLocation = path.join(directory, 'package.json');\n          return (await pathExists(pjLocation))\n            ? [[JSON.parse(await fsPromises.readFile(pjLocation, 'utf-8')).name as string, directory] as const]\n            : [];\n        }),\n      )\n    ).flat(),\n  );\n\n  logging.debug(`Found ${Object.keys(results).length} packages in monorepo: ${formatList(Object.keys(results))}`);\n  return results;\n}\n\nasync function findMonoRepoGlobs(startingDir: string): Promise<Set<string>> {\n  const ret = new Set<string>();\n\n  // Lerna monorepo\n  const lernaJsonDir = await findUp(startingDir, async (dir) => pathExists(path.join(dir, 'lerna.json')));\n  if (lernaJsonDir) {\n    const lernaJson = JSON.parse(await fsPromises.readFile(path.join(lernaJsonDir, 'lerna.json'), 'utf-8'));\n    for (const glob of lernaJson?.packages ?? []) {\n      ret.add(path.join(lernaJsonDir, glob));\n    }\n  }\n\n  // Yarn monorepo\n  const yarnWsDir = await findUp(\n    startingDir,\n    async (dir) =>\n      (await pathExists(path.join(dir, 'package.json'))) &&\n      JSON.parse(await fsPromises.readFile(path.join(dir, 'package.json'), 'utf-8'))?.workspaces !== undefined,\n  );\n  if (yarnWsDir) {\n    const yarnWs = JSON.parse(await fsPromises.readFile(path.join(yarnWsDir, 'package.json'), 'utf-8'));\n    for (const glob of yarnWs.workspaces?.packages ?? []) {\n      ret.add(path.join(yarnWsDir, glob));\n    }\n  }\n\n  return ret;\n}\n\nfunction isConcrete(x: CompilationDependency): x is Extract<CompilationDependency, { type: 'concrete' }> {\n  return x.type === 'concrete';\n}\n\nfunction setExtend<A>(xs: Set<A>, ys: Set<A>) {\n  for (const y of ys) {\n    xs.add(y);\n  }\n  return xs;\n}\n\n/**\n * Necessary for fastGlob\n */\nfunction windowsToUnix(x: string) {\n  return x.replace(/\\\\/g, '/');\n}\n"]}

package/lib/snippet-selectors.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mean = exports.meanLength = exports.shortest = exports.longest = void 0;
+exports.longest = longest;
+exports.shortest = shortest;
+exports.meanLength = meanLength;
+exports.mean = mean;
 class SnippetScore {
     constructor(snippet, score) {
         this.snippet = snippet;
@@ -20,7 +23,6 @@ function longest(snippets) {
     }
     return getMaxScore(snippetScores).snippet;
 }
-exports.longest = longest;
 /**
  * Returns the shortest available snippet.
  */
@@ -34,7 +36,6 @@ function shortest(snippets) {
     }
     return getMinScore(snippetScores).snippet;
 }
-exports.shortest = shortest;
 /**
  * Returns the snippet with the length closest to the mean length of the available snippets.
  */
@@ -49,7 +50,6 @@ function meanLength(snippets) {
     }
     return getMinScore(snippetScores).snippet;
 }
-exports.meanLength = meanLength;
 /**
  * Finds and returns the mean sparse vector of available snippets for each type.
  */
@@ -70,7 +70,6 @@ function mean(snippets) {
     }
     return getMinScore(snippetScores).snippet;
 }
-exports.mean = mean;
 /**
  * Given a list of Records, outputs a Record that averages all the items in each Record.
  */

package/lib/snippet-selectors.js.map

@@ -1 +1 @@
-{"version":3,"file":"snippet-selectors.js","sourceRoot":"","sources":["../src/snippet-selectors.ts"],"names":[],"mappings":"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","sourcesContent":["import { TranslatedSnippet } from './tablets/tablets';\n\nexport type SnippetSelector = (snippets: TranslatedSnippet[]) => TranslatedSnippet;\n\nclass SnippetScore {\n  public constructor(public readonly snippet: TranslatedSnippet, public readonly score: number) {}\n}\n\n/**\n * Returns the longest available snippet.\n */\nexport function longest(snippets: TranslatedSnippet[]): TranslatedSnippet {\n  if (snippets.length === 0) {\n    throw new Error('longest: array cannot be empty');\n  }\n  const snippetScores: SnippetScore[] = [];\n  for (const snippet of snippets) {\n    snippetScores.push({ snippet: snippet, score: snippet.originalSource.source.length });\n  }\n  return getMaxScore(snippetScores).snippet;\n}\n\n/**\n * Returns the shortest available snippet.\n */\nexport function shortest(snippets: TranslatedSnippet[]): TranslatedSnippet {\n  if (snippets.length === 0) {\n    throw new Error('shortest: array cannot be empty');\n  }\n  const snippetScores: SnippetScore[] = [];\n  for (const snippet of snippets) {\n    snippetScores.push({ snippet: snippet, score: snippet.originalSource.source.length });\n  }\n  return getMinScore(snippetScores).snippet;\n}\n\n/**\n * Returns the snippet with the length closest to the mean length of the available snippets.\n */\nexport function meanLength(snippets: TranslatedSnippet[]): TranslatedSnippet {\n  if (snippets.length === 0) {\n    throw new Error('meanLength: array cannot be empty');\n  }\n\n  const meanLen = snippets.reduce((x, y) => x + y.originalSource.source.length, 0) / snippets.length;\n  const snippetScores: SnippetScore[] = [];\n  for (const snippet of snippets) {\n    snippetScores.push({ snippet: snippet, score: Math.abs(snippet.originalSource.source.length - meanLen) });\n  }\n  return getMinScore(snippetScores).snippet;\n}\n\n/**\n * Finds and returns the mean sparse vector of available snippets for each type.\n */\nexport function mean(snippets: TranslatedSnippet[]): TranslatedSnippet {\n  if (snippets.length === 0) {\n    throw new Error('mean: array cannot be empty');\n  }\n\n  // Find mean counter.\n  const counters: Array<Record<string, number>> = [];\n  snippets.map((snippet) => {\n    counters.push(snippet.snippet.syntaxKindCounter ?? {});\n  });\n  const meanCounter = findCenter(counters);\n  // Find counter with closest euclidian distance.\n  const snippetScores: SnippetScore[] = [];\n  for (let i = 0; i < snippets.length; i++) {\n    snippetScores.push({ snippet: snippets[i], score: euclideanDistance(meanCounter, counters[i]) });\n  }\n  return getMinScore(snippetScores).snippet;\n}\n\n/**\n * Given a list of Records, outputs a Record that averages all the items in each Record.\n */\nfunction findCenter(counters: Array<Record<string, number>>): Record<string, number> {\n  const centerCounter: Record<string, number> = {};\n  for (const counter of counters) {\n    for (const [key, value] of Object.entries(counter)) {\n      centerCounter[key] = value + (centerCounter[key] ?? 0);\n    }\n  }\n  const total = counters.length;\n  Object.entries(centerCounter).map(([key, value]) => {\n    centerCounter[key] = value / total;\n  });\n  return centerCounter;\n}\n\n/**\n * Finds the euclidean distance between two sparse vectors.\n * !!! This function assumes that the center parameter is a superset of the counter parameter. !!!\n */\nfunction euclideanDistance(center: Record<string, number>, counter: Record<string, number>): number {\n  const individualDistances: number[] = [];\n  Object.entries(center).map(([key, value]) => {\n    individualDistances.push(value - (counter[key] ?? 0));\n  });\n  return individualDistances.reduce((acc, curr) => acc + Math.sqrt(Math.pow(curr, 2)), 0);\n}\n\nfunction getMaxScore(snippetScores: SnippetScore[]): SnippetScore {\n  return snippetScores.reduce((x, y) => {\n    return x.score >= y.score ? x : y;\n  });\n}\n\nfunction getMinScore(snippetScores: SnippetScore[]): SnippetScore {\n  return snippetScores.reduce((x, y) => {\n    return x.score <= y.score ? x : y;\n  });\n}\n"]}
+{"version":3,"file":"snippet-selectors.js","sourceRoot":"","sources":["../src/snippet-selectors.ts"],"names":[],"mappings":"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","sourcesContent":["import { TranslatedSnippet } from './tablets/tablets';\n\nexport type SnippetSelector = (snippets: TranslatedSnippet[]) => TranslatedSnippet;\n\nclass SnippetScore {\n  public constructor(public readonly snippet: TranslatedSnippet, public readonly score: number) {}\n}\n\n/**\n * Returns the longest available snippet.\n */\nexport function longest(snippets: TranslatedSnippet[]): TranslatedSnippet {\n  if (snippets.length === 0) {\n    throw new Error('longest: array cannot be empty');\n  }\n  const snippetScores: SnippetScore[] = [];\n  for (const snippet of snippets) {\n    snippetScores.push({ snippet: snippet, score: snippet.originalSource.source.length });\n  }\n  return getMaxScore(snippetScores).snippet;\n}\n\n/**\n * Returns the shortest available snippet.\n */\nexport function shortest(snippets: TranslatedSnippet[]): TranslatedSnippet {\n  if (snippets.length === 0) {\n    throw new Error('shortest: array cannot be empty');\n  }\n  const snippetScores: SnippetScore[] = [];\n  for (const snippet of snippets) {\n    snippetScores.push({ snippet: snippet, score: snippet.originalSource.source.length });\n  }\n  return getMinScore(snippetScores).snippet;\n}\n\n/**\n * Returns the snippet with the length closest to the mean length of the available snippets.\n */\nexport function meanLength(snippets: TranslatedSnippet[]): TranslatedSnippet {\n  if (snippets.length === 0) {\n    throw new Error('meanLength: array cannot be empty');\n  }\n\n  const meanLen = snippets.reduce((x, y) => x + y.originalSource.source.length, 0) / snippets.length;\n  const snippetScores: SnippetScore[] = [];\n  for (const snippet of snippets) {\n    snippetScores.push({ snippet: snippet, score: Math.abs(snippet.originalSource.source.length - meanLen) });\n  }\n  return getMinScore(snippetScores).snippet;\n}\n\n/**\n * Finds and returns the mean sparse vector of available snippets for each type.\n */\nexport function mean(snippets: TranslatedSnippet[]): TranslatedSnippet {\n  if (snippets.length === 0) {\n    throw new Error('mean: array cannot be empty');\n  }\n\n  // Find mean counter.\n  const counters: Array<Record<string, number>> = [];\n  snippets.map((snippet) => {\n    counters.push(snippet.snippet.syntaxKindCounter ?? {});\n  });\n  const meanCounter = findCenter(counters);\n  // Find counter with closest euclidian distance.\n  const snippetScores: SnippetScore[] = [];\n  for (let i = 0; i < snippets.length; i++) {\n    snippetScores.push({ snippet: snippets[i], score: euclideanDistance(meanCounter, counters[i]) });\n  }\n  return getMinScore(snippetScores).snippet;\n}\n\n/**\n * Given a list of Records, outputs a Record that averages all the items in each Record.\n */\nfunction findCenter(counters: Array<Record<string, number>>): Record<string, number> {\n  const centerCounter: Record<string, number> = {};\n  for (const counter of counters) {\n    for (const [key, value] of Object.entries(counter)) {\n      centerCounter[key] = value + (centerCounter[key] ?? 0);\n    }\n  }\n  const total = counters.length;\n  Object.entries(centerCounter).map(([key, value]) => {\n    centerCounter[key] = value / total;\n  });\n  return centerCounter;\n}\n\n/**\n * Finds the euclidean distance between two sparse vectors.\n * !!! This function assumes that the center parameter is a superset of the counter parameter. !!!\n */\nfunction euclideanDistance(center: Record<string, number>, counter: Record<string, number>): number {\n  const individualDistances: number[] = [];\n  Object.entries(center).map(([key, value]) => {\n    individualDistances.push(value - (counter[key] ?? 0));\n  });\n  return individualDistances.reduce((acc, curr) => acc + Math.sqrt(Math.pow(curr, 2)), 0);\n}\n\nfunction getMaxScore(snippetScores: SnippetScore[]): SnippetScore {\n  return snippetScores.reduce((x, y) => {\n    return x.score >= y.score ? x : y;\n  });\n}\n\nfunction getMinScore(snippetScores: SnippetScore[]): SnippetScore {\n  return snippetScores.reduce((x, y) => {\n    return x.score <= y.score ? x : y;\n  });\n}\n"]}

package/lib/snippet.js

@@ -1,6 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SnippetParameters = exports.renderMetadataline = exports.parseMetadataLine = exports.parseKeyValueList = exports.completeSource = exports.updateParameters = exports.typeScriptSnippetFromCompleteSource = exports.typeScriptSnippetFromSource = exports.typeScriptSnippetFromVisibleSource = exports.renderApiLocation = exports.formatLocation = exports.INITIALIZER_METHOD_NAME = void 0;
+exports.SnippetParameters = exports.INITIALIZER_METHOD_NAME = void 0;
+exports.formatLocation = formatLocation;
+exports.renderApiLocation = renderApiLocation;
+exports.typeScriptSnippetFromVisibleSource = typeScriptSnippetFromVisibleSource;
+exports.typeScriptSnippetFromSource = typeScriptSnippetFromSource;
+exports.typeScriptSnippetFromCompleteSource = typeScriptSnippetFromCompleteSource;
+exports.updateParameters = updateParameters;
+exports.completeSource = completeSource;
+exports.parseKeyValueList = parseKeyValueList;
+exports.parseMetadataLine = parseMetadataLine;
+exports.renderMetadataline = renderMetadataline;
 const visible_spans_1 = require("./typescript/visible-spans");
 /**
  * How to represent the initializer in a 'parameter' type.
@@ -22,7 +32,6 @@ function formatLocation(location) {
             return renderApiLocation(location.api);
     }
 }
-exports.formatLocation = formatLocation;
 /**
  * Render an API location to an unique string
  *
@@ -45,7 +54,6 @@ function renderApiLocation(apiLoc) {
             return `${apiLoc.fqn}#${apiLoc.methodName}!#${apiLoc.parameterName}`;
     }
 }
-exports.renderApiLocation = renderApiLocation;
 /**
  * Construct a TypeScript snippet from visible source
  *
@@ -69,7 +77,6 @@ function typeScriptSnippetFromVisibleSource(typeScriptSource, location, strict,
         strict,
     };
 }
-exports.typeScriptSnippetFromVisibleSource = typeScriptSnippetFromVisibleSource;
 /**
  * Construct a TypeScript snippet from literal source
  *
@@ -78,7 +85,6 @@ exports.typeScriptSnippetFromVisibleSource = typeScriptSnippetFromVisibleSource;
 function typeScriptSnippetFromSource(typeScriptSource, location, strict, parameters = {}) {
     return typeScriptSnippetFromVisibleSource(typeScriptSource, location, strict, parameters);
 }
-exports.typeScriptSnippetFromSource = typeScriptSnippetFromSource;
 /**
  * Construct a TypeScript snippet from complete source
  *
@@ -104,21 +110,18 @@ function typeScriptSnippetFromCompleteSource(typeScriptSource, location, strict,
         strict,
     };
 }
-exports.typeScriptSnippetFromCompleteSource = typeScriptSnippetFromCompleteSource;
 function updateParameters(snippet, params) {
     return {
         ...snippet,
         parameters: Object.assign(Object.create(null), snippet.parameters ?? {}, params),
     };
 }
-exports.updateParameters = updateParameters;
 /**
  * Get the complete (compilable) source of a snippet
  */
 function completeSource(snippet) {
     return snippet.completeSource ?? snippet.visibleSource;
 }
-exports.completeSource = completeSource;
 /**
  * Extract snippet parameters from the first line of the source if it's a compiler directive
  */
@@ -147,7 +150,6 @@ function parseKeyValueList(parameters) {
     }
     return ret;
 }
-exports.parseKeyValueList = parseKeyValueList;
 function parseMetadataLine(metadata) {
     return parseKeyValueList(parseMetadata(metadata));
     function parseMetadata(md) {
@@ -158,7 +160,6 @@ function parseMetadataLine(metadata) {
             .filter((s) => s !== '');
     }
 }
-exports.parseMetadataLine = parseMetadataLine;
 function renderMetadataline(metadata = {}) {
     const line = Object.entries(metadata)
         .filter(([key, _]) => !key.startsWith('$'))
@@ -166,7 +167,6 @@ function renderMetadataline(metadata = {}) {
         .join(' ');
     return line ? line : undefined;
 }
-exports.renderMetadataline = renderMetadataline;
 /**
  * Recognized snippet parameters
  */

package/lib/snippet.js.map

@@ -1 +1 @@
-{"version":3,"file":"snippet.js","sourceRoot":"","sources":["../src/snippet.ts"],"names":[],"mappings":"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","sourcesContent":["import { trimCompleteSourceToVisible } from './typescript/visible-spans';\n\n/**\n * A piece of TypeScript code found in an assembly, ready to be translated\n */\nexport interface TypeScriptSnippet {\n  /**\n   * The snippet code that ends up in the JSII assembly\n   */\n  readonly visibleSource: string;\n\n  /**\n   * Description of where the snippet was found\n   */\n  readonly location: SnippetLocation;\n\n  /**\n   * When enhanced with a fixture, the snippet's complete source code\n   */\n  readonly completeSource?: string;\n\n  /**\n   * Parameters for the conversion\n   */\n  readonly parameters?: Record<string, string>;\n\n  /**\n   * Whether this snippet must be processed as if `--strict` was always supplied.\n   *\n   * @default false\n   */\n  readonly strict?: boolean;\n\n  /**\n   * Dependencies necessary to compile this snippet\n   *\n   * Value is a regular { name -> semver } map like NPM's `dependencies`,\n   * `devDependencies` etc.\n   *\n   * @default none\n   */\n  readonly compilationDependencies?: Record<string, CompilationDependency>;\n}\n\nexport type CompilationDependency =\n  | { readonly type: 'concrete'; readonly resolvedDirectory: string }\n  | { readonly type: 'symbolic'; readonly versionRange: string };\n\n/**\n * Description of a location where the snippet is found\n *\n * The location does not necessarily indicate an exact source file,\n * but it will generally refer to a location that can contain one or more\n * snippets.\n */\nexport interface SnippetLocation {\n  /**\n   * The jsii API with which this snippet is associated\n   */\n  readonly api: ApiLocation;\n\n  /**\n   * The API field in which the snippet is found, if any\n   *\n   * Absence of this field is appropriate for source files (or tests),\n   * but for Markdown files 'field' should really be set to a Markdown\n   * location.\n   */\n  readonly field?: FieldLocation;\n}\n\n/**\n * How to represent the initializer in a 'parameter' type.\n *\n * (Don't feel like making everyone's `case` statement worse by adding an\n * 'initializer-parameter' variant).\n */\nexport const INITIALIZER_METHOD_NAME = '<initializer>';\n\nexport type ApiLocation =\n  | { readonly api: 'file'; readonly fileName: string }\n  | { readonly api: 'moduleReadme'; readonly moduleFqn: string }\n  | { readonly api: 'type'; readonly fqn: string }\n  | { readonly api: 'initializer'; readonly fqn: string }\n  | { readonly api: 'member'; readonly fqn: string; readonly memberName: string }\n  | {\n      readonly api: 'parameter';\n      readonly fqn: string;\n      readonly methodName: string | typeof INITIALIZER_METHOD_NAME;\n      readonly parameterName: string;\n    };\n\nexport type FieldLocation = { readonly field: 'markdown'; readonly line: number } | { readonly field: 'example' };\n\n/**\n * Render an API location to a human readable representation\n */\nexport function formatLocation(location: SnippetLocation): string {\n  switch (location.field?.field) {\n    case 'example':\n      return `${renderApiLocation(location.api)}-example`;\n    case 'markdown':\n      return `${renderApiLocation(location.api)}-L${location.field.line}`;\n    case undefined:\n      return renderApiLocation(location.api);\n  }\n}\n\n/**\n * Render an API location to an unique string\n *\n * This function is used in hashing examples for reuse, and so the formatting\n * here should not be changed lightly.\n */\nexport function renderApiLocation(apiLoc: ApiLocation): string {\n  switch (apiLoc.api) {\n    case 'file':\n      return apiLoc.fileName;\n    case 'moduleReadme':\n      return `${apiLoc.moduleFqn}-README`;\n    case 'type':\n      return apiLoc.fqn;\n    case 'initializer':\n      return `${apiLoc.fqn}#initializer`;\n    case 'member':\n      return `${apiLoc.fqn}#${apiLoc.memberName}`;\n    case 'parameter':\n      return `${apiLoc.fqn}#${apiLoc.methodName}!#${apiLoc.parameterName}`;\n  }\n}\n\n/**\n * Construct a TypeScript snippet from visible source\n *\n * Will parse parameters from a directive in the given source, but will not\n * interpret `/// !show` and `/// !hide` directives.\n *\n * `/// !show` and `/// !hide` directives WILL affect what gets displayed by\n * the translator, but they will NOT affect the snippet's cache key (i.e. the\n * cache key will be based on the full source given here).\n *\n * Use this if you are looking up a snippet in a tablet, which has been translated\n * previously using a fixture.\n */\nexport function typeScriptSnippetFromVisibleSource(\n  typeScriptSource: string,\n  location: SnippetLocation,\n  strict: boolean,\n  parameters: Record<string, string> = {},\n): TypeScriptSnippet {\n  const [source, sourceParameters] = parametersFromSourceDirectives(typeScriptSource);\n  const visibleSource = source.trimRight();\n\n  return {\n    visibleSource,\n    location,\n    parameters: Object.assign({}, parameters, sourceParameters),\n    strict,\n  };\n}\n\n/**\n * Construct a TypeScript snippet from literal source\n *\n * @deprecated Use `typeScriptSnippetFromVisibleSource`\n */\nexport function typeScriptSnippetFromSource(\n  typeScriptSource: string,\n  location: SnippetLocation,\n  strict: boolean,\n  parameters: Record<string, string> = {},\n): TypeScriptSnippet {\n  return typeScriptSnippetFromVisibleSource(typeScriptSource, location, strict, parameters);\n}\n\n/**\n * Construct a TypeScript snippet from complete source\n *\n * Will parse parameters from a directive in the given source, and will\n * interpret `/// !show` and `/// !hide` directives.\n *\n * The snippet's cache key will be based on the source that remains after\n * these directives are processed.\n *\n * Use this if you are building a snippet to be translated, and take care\n * to store the return object's `visibleSource` in the assembly (not the original\n * source you passed in).\n */\nexport function typeScriptSnippetFromCompleteSource(\n  typeScriptSource: string,\n  location: SnippetLocation,\n  strict: boolean,\n  parameters: Record<string, string> = {},\n): TypeScriptSnippet {\n  const [source, sourceParameters] = parametersFromSourceDirectives(typeScriptSource);\n  const completeSrc = source.trimRight();\n\n  const visibleSource = trimCompleteSourceToVisible(completeSrc);\n\n  return {\n    visibleSource,\n    completeSource: visibleSource !== completeSrc ? completeSrc : undefined,\n    location,\n    parameters: Object.assign({}, parameters, sourceParameters),\n    strict,\n  };\n}\n\nexport function updateParameters(snippet: TypeScriptSnippet, params: Record<string, string>): TypeScriptSnippet {\n  return {\n    ...snippet,\n    parameters: Object.assign(Object.create(null), snippet.parameters ?? {}, params),\n  };\n}\n\n/**\n * Get the complete (compilable) source of a snippet\n */\nexport function completeSource(snippet: TypeScriptSnippet) {\n  return snippet.completeSource ?? snippet.visibleSource;\n}\n\n/**\n * Extract snippet parameters from the first line of the source if it's a compiler directive\n */\nfunction parametersFromSourceDirectives(source: string): [string, Record<string, string>] {\n  const [firstLine, ...rest] = source.split('\\n');\n  // Also extract parameters from an initial line starting with '/// ' (getting rid of that line).\n  const m = /[/]{3}(.*)$/.exec(firstLine);\n  if (m) {\n    return [rest.join('\\n'), parseMetadataLine(m[1])];\n  }\n\n  return [source, {}];\n}\n\n/**\n * Parse a set of 'param param=value' directives into an object\n */\nexport function parseKeyValueList(parameters: string[]): Record<string, string> {\n  const ret: Record<string, string> = {};\n  for (const param of parameters) {\n    const parts = param.split('=', 2);\n    if (parts.length === 2) {\n      ret[parts[0]] = parts[1];\n    } else {\n      ret[parts[0]] = '';\n    }\n  }\n  return ret;\n}\n\nexport function parseMetadataLine(metadata: string): Record<string, string> {\n  return parseKeyValueList(parseMetadata(metadata));\n\n  function parseMetadata(md: string): string[] {\n    return md\n      .trim()\n      .split(' ')\n      .map((s) => s.trim())\n      .filter((s) => s !== '');\n  }\n}\n\nexport function renderMetadataline(metadata: Record<string, string> = {}): string | undefined {\n  const line = Object.entries(metadata)\n    .filter(([key, _]) => !key.startsWith('$'))\n    .map(([key, value]) => (value !== '' ? `${key}=${value}` : key))\n    .join(' ');\n\n  return line ? line : undefined;\n}\n\n/**\n * Recognized snippet parameters\n */\nexport enum SnippetParameters {\n  /**\n   * Use fixture with the given name (author parameter)\n   */\n  FIXTURE = 'fixture',\n\n  /**\n   * Don't use a fixture (author parameter)\n   */\n  NO_FIXTURE = 'nofixture',\n\n  /**\n   * Snippet was extracted from this literate file (backwards compatibility)\n   *\n   * Parameter attached by 'jsii'; load the given file instead of any fixture,\n   * process as usual.\n   */\n  LITERATE_SOURCE = 'lit',\n\n  /**\n   * This snippet has been infused\n   *\n   * This means it has been copied from a different location, and potentially\n   * even from a different assembly. If so, we can't expect it to compile in\n   * the future, and if doesn't, we ignore the errors.\n   *\n   * N.B: this shouldn't make a difference in normal operation, as the `infuse`\n   * command will duplicate the translation to the target tablet. This only\n   * matters if we remove the tablet and try to re-extract an assembly with\n   * infused examples from somewher else.\n   */\n  INFUSED = 'infused',\n\n  /**\n   * What directory to resolve fixtures in for this snippet (system parameter)\n   *\n   * Attached during processing, should not be used by authors. Does NOT imply\n   * anything about the directory where we pretend to compile this file.\n   */\n  $PROJECT_DIRECTORY = '$directory',\n\n  /**\n   * What directory to pretend the file is in (system parameter)\n   *\n   * Attached when compiling a literate file, as they compile in\n   * the location where they are stored.\n   */\n  $COMPILATION_DIRECTORY = '$compilation',\n}\n"]}
+{"version":3,"file":"snippet.js","sourceRoot":"","sources":["../src/snippet.ts"],"names":[],"mappings":"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","sourcesContent":["import { trimCompleteSourceToVisible } from './typescript/visible-spans';\n\n/**\n * A piece of TypeScript code found in an assembly, ready to be translated\n */\nexport interface TypeScriptSnippet {\n  /**\n   * The snippet code that ends up in the JSII assembly\n   */\n  readonly visibleSource: string;\n\n  /**\n   * Description of where the snippet was found\n   */\n  readonly location: SnippetLocation;\n\n  /**\n   * When enhanced with a fixture, the snippet's complete source code\n   */\n  readonly completeSource?: string;\n\n  /**\n   * Parameters for the conversion\n   */\n  readonly parameters?: Record<string, string>;\n\n  /**\n   * Whether this snippet must be processed as if `--strict` was always supplied.\n   *\n   * @default false\n   */\n  readonly strict?: boolean;\n\n  /**\n   * Dependencies necessary to compile this snippet\n   *\n   * Value is a regular { name -> semver } map like NPM's `dependencies`,\n   * `devDependencies` etc.\n   *\n   * @default none\n   */\n  readonly compilationDependencies?: Record<string, CompilationDependency>;\n}\n\nexport type CompilationDependency =\n  | { readonly type: 'concrete'; readonly resolvedDirectory: string }\n  | { readonly type: 'symbolic'; readonly versionRange: string };\n\n/**\n * Description of a location where the snippet is found\n *\n * The location does not necessarily indicate an exact source file,\n * but it will generally refer to a location that can contain one or more\n * snippets.\n */\nexport interface SnippetLocation {\n  /**\n   * The jsii API with which this snippet is associated\n   */\n  readonly api: ApiLocation;\n\n  /**\n   * The API field in which the snippet is found, if any\n   *\n   * Absence of this field is appropriate for source files (or tests),\n   * but for Markdown files 'field' should really be set to a Markdown\n   * location.\n   */\n  readonly field?: FieldLocation;\n}\n\n/**\n * How to represent the initializer in a 'parameter' type.\n *\n * (Don't feel like making everyone's `case` statement worse by adding an\n * 'initializer-parameter' variant).\n */\nexport const INITIALIZER_METHOD_NAME = '<initializer>';\n\nexport type ApiLocation =\n  | { readonly api: 'file'; readonly fileName: string }\n  | { readonly api: 'moduleReadme'; readonly moduleFqn: string }\n  | { readonly api: 'type'; readonly fqn: string }\n  | { readonly api: 'initializer'; readonly fqn: string }\n  | { readonly api: 'member'; readonly fqn: string; readonly memberName: string }\n  | {\n      readonly api: 'parameter';\n      readonly fqn: string;\n      readonly methodName: string | typeof INITIALIZER_METHOD_NAME;\n      readonly parameterName: string;\n    };\n\nexport type FieldLocation = { readonly field: 'markdown'; readonly line: number } | { readonly field: 'example' };\n\n/**\n * Render an API location to a human readable representation\n */\nexport function formatLocation(location: SnippetLocation): string {\n  switch (location.field?.field) {\n    case 'example':\n      return `${renderApiLocation(location.api)}-example`;\n    case 'markdown':\n      return `${renderApiLocation(location.api)}-L${location.field.line}`;\n    case undefined:\n      return renderApiLocation(location.api);\n  }\n}\n\n/**\n * Render an API location to an unique string\n *\n * This function is used in hashing examples for reuse, and so the formatting\n * here should not be changed lightly.\n */\nexport function renderApiLocation(apiLoc: ApiLocation): string {\n  switch (apiLoc.api) {\n    case 'file':\n      return apiLoc.fileName;\n    case 'moduleReadme':\n      return `${apiLoc.moduleFqn}-README`;\n    case 'type':\n      return apiLoc.fqn;\n    case 'initializer':\n      return `${apiLoc.fqn}#initializer`;\n    case 'member':\n      return `${apiLoc.fqn}#${apiLoc.memberName}`;\n    case 'parameter':\n      return `${apiLoc.fqn}#${apiLoc.methodName}!#${apiLoc.parameterName}`;\n  }\n}\n\n/**\n * Construct a TypeScript snippet from visible source\n *\n * Will parse parameters from a directive in the given source, but will not\n * interpret `/// !show` and `/// !hide` directives.\n *\n * `/// !show` and `/// !hide` directives WILL affect what gets displayed by\n * the translator, but they will NOT affect the snippet's cache key (i.e. the\n * cache key will be based on the full source given here).\n *\n * Use this if you are looking up a snippet in a tablet, which has been translated\n * previously using a fixture.\n */\nexport function typeScriptSnippetFromVisibleSource(\n  typeScriptSource: string,\n  location: SnippetLocation,\n  strict: boolean,\n  parameters: Record<string, string> = {},\n): TypeScriptSnippet {\n  const [source, sourceParameters] = parametersFromSourceDirectives(typeScriptSource);\n  const visibleSource = source.trimRight();\n\n  return {\n    visibleSource,\n    location,\n    parameters: Object.assign({}, parameters, sourceParameters),\n    strict,\n  };\n}\n\n/**\n * Construct a TypeScript snippet from literal source\n *\n * @deprecated Use `typeScriptSnippetFromVisibleSource`\n */\nexport function typeScriptSnippetFromSource(\n  typeScriptSource: string,\n  location: SnippetLocation,\n  strict: boolean,\n  parameters: Record<string, string> = {},\n): TypeScriptSnippet {\n  return typeScriptSnippetFromVisibleSource(typeScriptSource, location, strict, parameters);\n}\n\n/**\n * Construct a TypeScript snippet from complete source\n *\n * Will parse parameters from a directive in the given source, and will\n * interpret `/// !show` and `/// !hide` directives.\n *\n * The snippet's cache key will be based on the source that remains after\n * these directives are processed.\n *\n * Use this if you are building a snippet to be translated, and take care\n * to store the return object's `visibleSource` in the assembly (not the original\n * source you passed in).\n */\nexport function typeScriptSnippetFromCompleteSource(\n  typeScriptSource: string,\n  location: SnippetLocation,\n  strict: boolean,\n  parameters: Record<string, string> = {},\n): TypeScriptSnippet {\n  const [source, sourceParameters] = parametersFromSourceDirectives(typeScriptSource);\n  const completeSrc = source.trimRight();\n\n  const visibleSource = trimCompleteSourceToVisible(completeSrc);\n\n  return {\n    visibleSource,\n    completeSource: visibleSource !== completeSrc ? completeSrc : undefined,\n    location,\n    parameters: Object.assign({}, parameters, sourceParameters),\n    strict,\n  };\n}\n\nexport function updateParameters(snippet: TypeScriptSnippet, params: Record<string, string>): TypeScriptSnippet {\n  return {\n    ...snippet,\n    parameters: Object.assign(Object.create(null), snippet.parameters ?? {}, params),\n  };\n}\n\n/**\n * Get the complete (compilable) source of a snippet\n */\nexport function completeSource(snippet: TypeScriptSnippet) {\n  return snippet.completeSource ?? snippet.visibleSource;\n}\n\n/**\n * Extract snippet parameters from the first line of the source if it's a compiler directive\n */\nfunction parametersFromSourceDirectives(source: string): [string, Record<string, string>] {\n  const [firstLine, ...rest] = source.split('\\n');\n  // Also extract parameters from an initial line starting with '/// ' (getting rid of that line).\n  const m = /[/]{3}(.*)$/.exec(firstLine);\n  if (m) {\n    return [rest.join('\\n'), parseMetadataLine(m[1])];\n  }\n\n  return [source, {}];\n}\n\n/**\n * Parse a set of 'param param=value' directives into an object\n */\nexport function parseKeyValueList(parameters: string[]): Record<string, string> {\n  const ret: Record<string, string> = {};\n  for (const param of parameters) {\n    const parts = param.split('=', 2);\n    if (parts.length === 2) {\n      ret[parts[0]] = parts[1];\n    } else {\n      ret[parts[0]] = '';\n    }\n  }\n  return ret;\n}\n\nexport function parseMetadataLine(metadata: string): Record<string, string> {\n  return parseKeyValueList(parseMetadata(metadata));\n\n  function parseMetadata(md: string): string[] {\n    return md\n      .trim()\n      .split(' ')\n      .map((s) => s.trim())\n      .filter((s) => s !== '');\n  }\n}\n\nexport function renderMetadataline(metadata: Record<string, string> = {}): string | undefined {\n  const line = Object.entries(metadata)\n    .filter(([key, _]) => !key.startsWith('$'))\n    .map(([key, value]) => (value !== '' ? `${key}=${value}` : key))\n    .join(' ');\n\n  return line ? line : undefined;\n}\n\n/**\n * Recognized snippet parameters\n */\nexport enum SnippetParameters {\n  /**\n   * Use fixture with the given name (author parameter)\n   */\n  FIXTURE = 'fixture',\n\n  /**\n   * Don't use a fixture (author parameter)\n   */\n  NO_FIXTURE = 'nofixture',\n\n  /**\n   * Snippet was extracted from this literate file (backwards compatibility)\n   *\n   * Parameter attached by 'jsii'; load the given file instead of any fixture,\n   * process as usual.\n   */\n  LITERATE_SOURCE = 'lit',\n\n  /**\n   * This snippet has been infused\n   *\n   * This means it has been copied from a different location, and potentially\n   * even from a different assembly. If so, we can't expect it to compile in\n   * the future, and if doesn't, we ignore the errors.\n   *\n   * N.B: this shouldn't make a difference in normal operation, as the `infuse`\n   * command will duplicate the translation to the target tablet. This only\n   * matters if we remove the tablet and try to re-extract an assembly with\n   * infused examples from somewher else.\n   */\n  INFUSED = 'infused',\n\n  /**\n   * What directory to resolve fixtures in for this snippet (system parameter)\n   *\n   * Attached during processing, should not be used by authors. Does NOT imply\n   * anything about the directory where we pretend to compile this file.\n   */\n  $PROJECT_DIRECTORY = '$directory',\n\n  /**\n   * What directory to pretend the file is in (system parameter)\n   *\n   * Attached when compiling a literate file, as they compile in\n   * the location where they are stored.\n   */\n  $COMPILATION_DIRECTORY = '$compilation',\n}\n"]}

package/lib/strict.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.enforcesStrictMode = void 0;
+exports.enforcesStrictMode = enforcesStrictMode;
 function enforcesStrictMode(assembly) {
     return !!assembly.metadata?.jsii?.rosetta?.strict;
 }
-exports.enforcesStrictMode = enforcesStrictMode;
 //# sourceMappingURL=strict.js.map

package/lib/strict.js.map

@@ -1 +1 @@
-{"version":3,"file":"strict.js","sourceRoot":"","sources":["../src/strict.ts"],"names":[],"mappings":";;;AAEA,SAAgB,kBAAkB,CAAC,QAAkB;IACnD,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC;AACpD,CAAC;AAFD,gDAEC","sourcesContent":["import { Assembly } from '@jsii/spec';\n\nexport function enforcesStrictMode(assembly: Assembly): boolean {\n  return !!assembly.metadata?.jsii?.rosetta?.strict;\n}\n"]}
+{"version":3,"file":"strict.js","sourceRoot":"","sources":["../src/strict.ts"],"names":[],"mappings":";;AAEA,gDAEC;AAFD,SAAgB,kBAAkB,CAAC,QAAkB;IACnD,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC;AACpD,CAAC","sourcesContent":["import { Assembly } from '@jsii/spec';\n\nexport function enforcesStrictMode(assembly: Assembly): boolean {\n  return !!assembly.metadata?.jsii?.rosetta?.strict;\n}\n"]}

package/lib/support.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.emitSupportPolicyInformation = void 0;
+exports.emitSupportPolicyInformation = emitSupportPolicyInformation;
 const node_fs_1 = require("node:fs");
 const node_https_1 = require("node:https");
 const node_path_1 = require("node:path");
@@ -59,7 +59,6 @@ async function emitSupportPolicyInformation() {
         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.

package/lib/support.js.map

@@ -1 +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"]}
+{"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/lib/tablets/key.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.snippetKey = void 0;
+exports.snippetKey = snippetKey;
 const crypto = require("node:crypto");
 const record_references_version_1 = require("../languages/record-references-version");
 const snippet_1 = require("../snippet");
@@ -16,5 +16,4 @@ function snippetKey(snippet) {
     h.update(snippet.visibleSource);
     return h.digest('hex');
 }
-exports.snippetKey = snippetKey;
 //# sourceMappingURL=key.js.map

package/lib/tablets/key.js.map

@@ -1 +1 @@
-{"version":3,"file":"key.js","sourceRoot":"","sources":["../../src/tablets/key.ts"],"names":[],"mappings":";;;AAAA,sCAAsC;AAEtC,sFAAmF;AACnF,wCAAkE;AAElE;;GAEG;AACH,SAAgB,UAAU,CAAC,OAA0B;IACnD,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,qDAAyB,CAAC,CAAC,CAAC;IAC5C,8DAA8D;IAC9D,CAAC,CAAC,MAAM,CAAC,IAAA,2BAAiB,EAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACd,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AARD,gCAQC","sourcesContent":["import * as crypto from 'node:crypto';\n\nimport { RECORD_REFERENCES_VERSION } from '../languages/record-references-version';\nimport { TypeScriptSnippet, renderApiLocation } from '../snippet';\n\n/**\n * Determine the key for a code block\n */\nexport function snippetKey(snippet: TypeScriptSnippet) {\n  const h = crypto.createHash('sha256');\n  h.update(String(RECORD_REFERENCES_VERSION));\n  // Mix in API location to distinguish between similar snippets\n  h.update(renderApiLocation(snippet.location.api));\n  h.update(':');\n  h.update(snippet.visibleSource);\n  return h.digest('hex');\n}\n"]}
+{"version":3,"file":"key.js","sourceRoot":"","sources":["../../src/tablets/key.ts"],"names":[],"mappings":";;AAQA,gCAQC;AAhBD,sCAAsC;AAEtC,sFAAmF;AACnF,wCAAkE;AAElE;;GAEG;AACH,SAAgB,UAAU,CAAC,OAA0B;IACnD,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,qDAAyB,CAAC,CAAC,CAAC;IAC5C,8DAA8D;IAC9D,CAAC,CAAC,MAAM,CAAC,IAAA,2BAAiB,EAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACd,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC","sourcesContent":["import * as crypto from 'node:crypto';\n\nimport { RECORD_REFERENCES_VERSION } from '../languages/record-references-version';\nimport { TypeScriptSnippet, renderApiLocation } from '../snippet';\n\n/**\n * Determine the key for a code block\n */\nexport function snippetKey(snippet: TypeScriptSnippet) {\n  const h = crypto.createHash('sha256');\n  h.update(String(RECORD_REFERENCES_VERSION));\n  // Mix in API location to distinguish between similar snippets\n  h.update(renderApiLocation(snippet.location.api));\n  h.update(':');\n  h.update(snippet.visibleSource);\n  return h.digest('hex');\n}\n"]}

package/lib/translate.js

@@ -6,7 +6,10 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _Translator_diagnostics;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rosettaDiagFromTypescript = exports.SnippetTranslator = exports.makeRosettaDiagnostic = exports.Translator = exports.translateTypeScript = void 0;
+exports.SnippetTranslator = exports.Translator = void 0;
+exports.translateTypeScript = translateTypeScript;
+exports.makeRosettaDiagnostic = makeRosettaDiagnostic;
+exports.rosettaDiagFromTypescript = rosettaDiagFromTypescript;
 const node_util_1 = require("node:util");
 const ts = require("typescript");
 const languages_1 = require("./languages");
@@ -32,7 +35,6 @@ function translateTypeScript(source, visitor, options = {}) {
         diagnostics: translator.diagnostics.map(rosettaDiagFromTypescript),
     };
 }
-exports.translateTypeScript = translateTypeScript;
 /**
  * Translate one or more TypeScript snippets into other languages
  *
@@ -95,7 +97,6 @@ _Translator_diagnostics = new WeakMap();
 function makeRosettaDiagnostic(isError, formattedMessage) {
     return { isError, formattedMessage, isFromStrictAssembly: false };
 }
-exports.makeRosettaDiagnostic = makeRosettaDiagnostic;
 /**
  * Translate a single TypeScript snippet
  */
@@ -197,7 +198,6 @@ function rosettaDiagFromTypescript(diag) {
         formattedMessage: ts.formatDiagnosticsWithColorAndContext([diag], DIAG_HOST),
     };
 }
-exports.rosettaDiagFromTypescript = rosettaDiagFromTypescript;
 const DIAG_HOST = {
     getCurrentDirectory() {
         return '.';

package/lib/translate.js.map

@@ -1 +1 @@
-{"version":3,"file":"translate.js","sourceRoot":"","sources":["../src/translate.ts"],"names":[],"mappings":"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","sourcesContent":["import { inspect } from 'node:util';\nimport * as ts from 'typescript';\n\nimport { TARGET_LANGUAGES, TargetLanguage } from './languages';\nimport { RecordReferencesVisitor } from './languages/record-references';\nimport { supportsTransitiveSubmoduleAccess } from './languages/target-language';\nimport * as logging from './logging';\nimport { renderTree } from './o-tree';\nimport { AstRenderer, AstHandler, AstRendererOptions } from './renderer';\nimport { TypeScriptSnippet, completeSource, SnippetParameters, formatLocation } from './snippet';\nimport { SubmoduleReference, SubmoduleReferenceMap } from './submodule-reference';\nimport { snippetKey } from './tablets/key';\nimport { ORIGINAL_SNIPPET_KEY } from './tablets/schema';\nimport { TranslatedSnippet } from './tablets/tablets';\nimport { SyntaxKindCounter } from './typescript/syntax-kind-counter';\nimport { TypeScriptCompiler, CompilationResult } from './typescript/ts-compiler';\nimport { Spans } from './typescript/visible-spans';\nimport { annotateStrictDiagnostic, File, hasStrictBranding, mkDict } from './util';\n\nexport function translateTypeScript(\n  source: File,\n  visitor: AstHandler<any>,\n  options: SnippetTranslatorOptions = {},\n): TranslateResult {\n  const translator = new SnippetTranslator(\n    { visibleSource: source.contents, location: { api: { api: 'file', fileName: source.fileName } } },\n    options,\n  );\n  const translated = translator.renderUsing(visitor);\n\n  return {\n    translation: translated,\n    diagnostics: translator.diagnostics.map(rosettaDiagFromTypescript),\n  };\n}\n\n/**\n * Translate one or more TypeScript snippets into other languages\n *\n * Can be configured to fully typecheck the samples, or perform only syntactical\n * translation.\n */\nexport class Translator {\n  private readonly compiler = new TypeScriptCompiler();\n  // eslint-disable-next-line @typescript-eslint/explicit-member-accessibility\n  #diagnostics: ts.Diagnostic[] = [];\n\n  public constructor(private readonly includeCompilerDiagnostics: boolean) {}\n\n  public translate(snip: TypeScriptSnippet, languages: readonly TargetLanguage[] = Object.values(TargetLanguage)) {\n    logging.debug(`Translating ${snippetKey(snip)} ${inspect(snip.parameters ?? {})}`);\n    const translator = this.translatorFor(snip);\n\n    const translations = mkDict(\n      languages.flatMap((lang, idx, array) => {\n        if (array.slice(0, idx).includes(lang)) {\n          // This language was duplicated in the request... we'll skip that here...\n          return [];\n        }\n        const languageConverterFactory = TARGET_LANGUAGES[lang];\n        const translated = translator.renderUsing(languageConverterFactory.createVisitor());\n        return [[lang, { source: translated, version: languageConverterFactory.version }] as const];\n      }),\n    );\n\n    if (snip.parameters?.infused === undefined) {\n      this.#diagnostics.push(...translator.diagnostics);\n    }\n\n    return TranslatedSnippet.fromSchema({\n      translations: {\n        ...translations,\n        [ORIGINAL_SNIPPET_KEY]: { source: snip.visibleSource, version: '0' },\n      },\n      location: snip.location,\n      didCompile: translator.didSuccessfullyCompile,\n      fqnsReferenced: translator.fqnsReferenced(),\n      fullSource: completeSource(snip),\n      syntaxKindCounter: translator.syntaxKindCounter(),\n    });\n  }\n\n  public get diagnostics(): readonly RosettaDiagnostic[] {\n    return ts.sortAndDeduplicateDiagnostics(this.#diagnostics).map(rosettaDiagFromTypescript);\n  }\n\n  /**\n   * Return the snippet translator for the given snippet\n   *\n   * We used to cache these, but each translator holds on to quite a bit of memory,\n   * so we don't do that anymore.\n   */\n  public translatorFor(snippet: TypeScriptSnippet) {\n    const translator = new SnippetTranslator(snippet, {\n      compiler: this.compiler,\n      includeCompilerDiagnostics: this.includeCompilerDiagnostics,\n    });\n    return translator;\n  }\n}\n\nexport interface SnippetTranslatorOptions extends AstRendererOptions {\n  /**\n   * Re-use the given compiler if given\n   */\n  readonly compiler?: TypeScriptCompiler;\n\n  /**\n   * Include compiler errors in return diagnostics\n   *\n   * If false, only translation diagnostics will be returned.\n   *\n   * @default false\n   */\n  readonly includeCompilerDiagnostics?: boolean;\n}\n\nexport interface TranslateResult {\n  translation: string;\n  diagnostics: readonly RosettaDiagnostic[];\n}\n\n/**\n * A translation of a TypeScript diagnostic into a data-only representation for Rosetta\n *\n * We cannot use the original `ts.Diagnostic` since it holds on to way too much\n * state (the source file and by extension the entire parse tree), which grows\n * too big to be properly serialized by a worker and also takes too much memory.\n *\n * Reduce it down to only the information we need.\n */\nexport interface RosettaDiagnostic {\n  /**\n   * If this is an error diagnostic or not\n   */\n  readonly isError: boolean;\n\n  /**\n   * If the diagnostic was emitted from an assembly that has its 'strict' flag set\n   */\n  readonly isFromStrictAssembly: boolean;\n\n  /**\n   * The formatted message, ready to be printed (will have colors and newlines in it)\n   *\n   * Ends in a newline.\n   */\n  readonly formattedMessage: string;\n}\n\nexport function makeRosettaDiagnostic(isError: boolean, formattedMessage: string): RosettaDiagnostic {\n  return { isError, formattedMessage, isFromStrictAssembly: false };\n}\n\n/**\n * Translate a single TypeScript snippet\n */\nexport class SnippetTranslator {\n  public readonly translateDiagnostics: ts.Diagnostic[] = [];\n  public readonly compileDiagnostics: ts.Diagnostic[] = [];\n  private readonly visibleSpans: Spans;\n  private readonly compilation!: CompilationResult;\n  private readonly tryCompile: boolean;\n  private readonly submoduleReferences: SubmoduleReferenceMap;\n\n  public constructor(snippet: TypeScriptSnippet, private readonly options: SnippetTranslatorOptions = {}) {\n    const compiler = options.compiler ?? new TypeScriptCompiler();\n    const source = completeSource(snippet);\n    const fakeCurrentDirectory = snippet.parameters?.[SnippetParameters.$COMPILATION_DIRECTORY] ?? process.cwd();\n    this.compilation = compiler.compileInMemory(\n      removeSlashes(formatLocation(snippet.location)),\n      source,\n      fakeCurrentDirectory,\n    );\n\n    // Respect '/// !hide' and '/// !show' directives\n    this.visibleSpans = Spans.visibleSpansFromSource(source);\n\n    // Find submodule references on explicit imports\n    this.submoduleReferences = SubmoduleReference.inSourceFile(\n      this.compilation.rootFile,\n      this.compilation.program.getTypeChecker(),\n    );\n\n    // This makes it about 5x slower, so only do it on demand\n    // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing\n    this.tryCompile = (options.includeCompilerDiagnostics || snippet.strict) ?? false;\n    if (this.tryCompile) {\n      const program = this.compilation.program;\n      const diagnostics = [\n        ...neverThrowing(program.getGlobalDiagnostics)(),\n        ...neverThrowing(program.getSyntacticDiagnostics)(this.compilation.rootFile),\n        ...neverThrowing(program.getDeclarationDiagnostics)(this.compilation.rootFile),\n        ...neverThrowing(program.getSemanticDiagnostics)(this.compilation.rootFile),\n      ];\n      if (snippet.strict) {\n        // In a strict assembly, so we'll need to brand all diagnostics here...\n        for (const diag of diagnostics) {\n          annotateStrictDiagnostic(diag);\n        }\n      }\n      this.compileDiagnostics.push(...diagnostics);\n    }\n\n    /**\n     * Intercepts all exceptions thrown by the wrapped call, and logs them to\n     * console.error instead of re-throwing, then returns an empty array. This\n     * is here to avoid compiler crashes due to broken code examples that cause\n     * the TypeScript compiler to hit a \"Debug Failure\".\n     */\n    function neverThrowing<A extends unknown[], R>(call: (...args: A) => readonly R[]): (...args: A) => readonly R[] {\n      return (...args: A) => {\n        try {\n          return call(...args);\n        } catch (err: any) {\n          const isExpectedTypescriptError = err.message.includes('Debug Failure');\n\n          if (!isExpectedTypescriptError) {\n            console.error(`Failed to execute ${call.name}: ${err}`);\n          }\n\n          return [];\n        }\n      };\n    }\n  }\n\n  /**\n   * Returns a boolean if compilation was attempted, and undefined if it was not.\n   */\n  public get didSuccessfullyCompile() {\n    return this.tryCompile ? this.compileDiagnostics.length === 0 : undefined;\n  }\n\n  public renderUsing(visitor: AstHandler<any>) {\n    const converter = new AstRenderer(\n      this.compilation.rootFile,\n      this.compilation.program.getTypeChecker(),\n      visitor,\n      this.options,\n      // If we support transitive submodule access, don't provide a submodule reference map.\n      supportsTransitiveSubmoduleAccess(visitor.language) ? undefined : this.submoduleReferences,\n    );\n    const converted = converter.convert(this.compilation.rootFile);\n    this.translateDiagnostics.push(...filterVisibleDiagnostics(converter.diagnostics, this.visibleSpans));\n    return renderTree(converted, { indentChar: visitor.indentChar, visibleSpans: this.visibleSpans });\n  }\n\n  public syntaxKindCounter(): Partial<Record<ts.SyntaxKind, number>> {\n    const kindCounter = new SyntaxKindCounter(this.visibleSpans);\n    return kindCounter.countKinds(this.compilation.rootFile);\n  }\n\n  public fqnsReferenced() {\n    const visitor = new RecordReferencesVisitor(this.visibleSpans);\n    const converter = new AstRenderer(\n      this.compilation.rootFile,\n      this.compilation.program.getTypeChecker(),\n      visitor,\n      this.options,\n      this.submoduleReferences,\n    );\n    converter.convert(this.compilation.rootFile);\n    return visitor.fqnsReferenced();\n  }\n\n  public get diagnostics(): readonly ts.Diagnostic[] {\n    return ts.sortAndDeduplicateDiagnostics(this.compileDiagnostics.concat(this.translateDiagnostics));\n  }\n}\n\n/**\n * Hide diagnostics that are rosetta-sourced if they are reported against a non-visible span\n */\nfunction filterVisibleDiagnostics(diags: readonly ts.Diagnostic[], visibleSpans: Spans): ts.Diagnostic[] {\n  return diags.filter((d) => d.source !== 'rosetta' || d.start === undefined || visibleSpans.containsPosition(d.start));\n}\n\n/**\n * Turn TypeScript diagnostics into Rosetta diagnostics\n */\nexport function rosettaDiagFromTypescript(diag: ts.Diagnostic): RosettaDiagnostic {\n  return {\n    isError: diag.category === ts.DiagnosticCategory.Error,\n    isFromStrictAssembly: hasStrictBranding(diag),\n    formattedMessage: ts.formatDiagnosticsWithColorAndContext([diag], DIAG_HOST),\n  };\n}\n\nconst DIAG_HOST = {\n  getCurrentDirectory() {\n    return '.';\n  },\n  getCanonicalFileName(fileName: string) {\n    return fileName;\n  },\n  getNewLine() {\n    return '\\n';\n  },\n};\n\n/**\n * Remove slashes from a \"where\" description, as the TS compiler will interpret it as a directory\n * and we can't have that for compiling literate files\n */\nfunction removeSlashes(x: string) {\n  return x.replace(/\\/|\\\\/g, '.');\n}\n"]}
+{"version":3,"file":"translate.js","sourceRoot":"","sources":["../src/translate.ts"],"names":[],"mappings":"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","sourcesContent":["import { inspect } from 'node:util';\nimport * as ts from 'typescript';\n\nimport { TARGET_LANGUAGES, TargetLanguage } from './languages';\nimport { RecordReferencesVisitor } from './languages/record-references';\nimport { supportsTransitiveSubmoduleAccess } from './languages/target-language';\nimport * as logging from './logging';\nimport { renderTree } from './o-tree';\nimport { AstRenderer, AstHandler, AstRendererOptions } from './renderer';\nimport { TypeScriptSnippet, completeSource, SnippetParameters, formatLocation } from './snippet';\nimport { SubmoduleReference, SubmoduleReferenceMap } from './submodule-reference';\nimport { snippetKey } from './tablets/key';\nimport { ORIGINAL_SNIPPET_KEY } from './tablets/schema';\nimport { TranslatedSnippet } from './tablets/tablets';\nimport { SyntaxKindCounter } from './typescript/syntax-kind-counter';\nimport { TypeScriptCompiler, CompilationResult } from './typescript/ts-compiler';\nimport { Spans } from './typescript/visible-spans';\nimport { annotateStrictDiagnostic, File, hasStrictBranding, mkDict } from './util';\n\nexport function translateTypeScript(\n  source: File,\n  visitor: AstHandler<any>,\n  options: SnippetTranslatorOptions = {},\n): TranslateResult {\n  const translator = new SnippetTranslator(\n    { visibleSource: source.contents, location: { api: { api: 'file', fileName: source.fileName } } },\n    options,\n  );\n  const translated = translator.renderUsing(visitor);\n\n  return {\n    translation: translated,\n    diagnostics: translator.diagnostics.map(rosettaDiagFromTypescript),\n  };\n}\n\n/**\n * Translate one or more TypeScript snippets into other languages\n *\n * Can be configured to fully typecheck the samples, or perform only syntactical\n * translation.\n */\nexport class Translator {\n  private readonly compiler = new TypeScriptCompiler();\n  // eslint-disable-next-line @typescript-eslint/explicit-member-accessibility\n  #diagnostics: ts.Diagnostic[] = [];\n\n  public constructor(private readonly includeCompilerDiagnostics: boolean) {}\n\n  public translate(snip: TypeScriptSnippet, languages: readonly TargetLanguage[] = Object.values(TargetLanguage)) {\n    logging.debug(`Translating ${snippetKey(snip)} ${inspect(snip.parameters ?? {})}`);\n    const translator = this.translatorFor(snip);\n\n    const translations = mkDict(\n      languages.flatMap((lang, idx, array) => {\n        if (array.slice(0, idx).includes(lang)) {\n          // This language was duplicated in the request... we'll skip that here...\n          return [];\n        }\n        const languageConverterFactory = TARGET_LANGUAGES[lang];\n        const translated = translator.renderUsing(languageConverterFactory.createVisitor());\n        return [[lang, { source: translated, version: languageConverterFactory.version }] as const];\n      }),\n    );\n\n    if (snip.parameters?.infused === undefined) {\n      this.#diagnostics.push(...translator.diagnostics);\n    }\n\n    return TranslatedSnippet.fromSchema({\n      translations: {\n        ...translations,\n        [ORIGINAL_SNIPPET_KEY]: { source: snip.visibleSource, version: '0' },\n      },\n      location: snip.location,\n      didCompile: translator.didSuccessfullyCompile,\n      fqnsReferenced: translator.fqnsReferenced(),\n      fullSource: completeSource(snip),\n      syntaxKindCounter: translator.syntaxKindCounter(),\n    });\n  }\n\n  public get diagnostics(): readonly RosettaDiagnostic[] {\n    return ts.sortAndDeduplicateDiagnostics(this.#diagnostics).map(rosettaDiagFromTypescript);\n  }\n\n  /**\n   * Return the snippet translator for the given snippet\n   *\n   * We used to cache these, but each translator holds on to quite a bit of memory,\n   * so we don't do that anymore.\n   */\n  public translatorFor(snippet: TypeScriptSnippet) {\n    const translator = new SnippetTranslator(snippet, {\n      compiler: this.compiler,\n      includeCompilerDiagnostics: this.includeCompilerDiagnostics,\n    });\n    return translator;\n  }\n}\n\nexport interface SnippetTranslatorOptions extends AstRendererOptions {\n  /**\n   * Re-use the given compiler if given\n   */\n  readonly compiler?: TypeScriptCompiler;\n\n  /**\n   * Include compiler errors in return diagnostics\n   *\n   * If false, only translation diagnostics will be returned.\n   *\n   * @default false\n   */\n  readonly includeCompilerDiagnostics?: boolean;\n}\n\nexport interface TranslateResult {\n  translation: string;\n  diagnostics: readonly RosettaDiagnostic[];\n}\n\n/**\n * A translation of a TypeScript diagnostic into a data-only representation for Rosetta\n *\n * We cannot use the original `ts.Diagnostic` since it holds on to way too much\n * state (the source file and by extension the entire parse tree), which grows\n * too big to be properly serialized by a worker and also takes too much memory.\n *\n * Reduce it down to only the information we need.\n */\nexport interface RosettaDiagnostic {\n  /**\n   * If this is an error diagnostic or not\n   */\n  readonly isError: boolean;\n\n  /**\n   * If the diagnostic was emitted from an assembly that has its 'strict' flag set\n   */\n  readonly isFromStrictAssembly: boolean;\n\n  /**\n   * The formatted message, ready to be printed (will have colors and newlines in it)\n   *\n   * Ends in a newline.\n   */\n  readonly formattedMessage: string;\n}\n\nexport function makeRosettaDiagnostic(isError: boolean, formattedMessage: string): RosettaDiagnostic {\n  return { isError, formattedMessage, isFromStrictAssembly: false };\n}\n\n/**\n * Translate a single TypeScript snippet\n */\nexport class SnippetTranslator {\n  public readonly translateDiagnostics: ts.Diagnostic[] = [];\n  public readonly compileDiagnostics: ts.Diagnostic[] = [];\n  private readonly visibleSpans: Spans;\n  private readonly compilation!: CompilationResult;\n  private readonly tryCompile: boolean;\n  private readonly submoduleReferences: SubmoduleReferenceMap;\n\n  public constructor(snippet: TypeScriptSnippet, private readonly options: SnippetTranslatorOptions = {}) {\n    const compiler = options.compiler ?? new TypeScriptCompiler();\n    const source = completeSource(snippet);\n    const fakeCurrentDirectory = snippet.parameters?.[SnippetParameters.$COMPILATION_DIRECTORY] ?? process.cwd();\n    this.compilation = compiler.compileInMemory(\n      removeSlashes(formatLocation(snippet.location)),\n      source,\n      fakeCurrentDirectory,\n    );\n\n    // Respect '/// !hide' and '/// !show' directives\n    this.visibleSpans = Spans.visibleSpansFromSource(source);\n\n    // Find submodule references on explicit imports\n    this.submoduleReferences = SubmoduleReference.inSourceFile(\n      this.compilation.rootFile,\n      this.compilation.program.getTypeChecker(),\n    );\n\n    // This makes it about 5x slower, so only do it on demand\n    // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing\n    this.tryCompile = (options.includeCompilerDiagnostics || snippet.strict) ?? false;\n    if (this.tryCompile) {\n      const program = this.compilation.program;\n      const diagnostics = [\n        ...neverThrowing(program.getGlobalDiagnostics)(),\n        ...neverThrowing(program.getSyntacticDiagnostics)(this.compilation.rootFile),\n        ...neverThrowing(program.getDeclarationDiagnostics)(this.compilation.rootFile),\n        ...neverThrowing(program.getSemanticDiagnostics)(this.compilation.rootFile),\n      ];\n      if (snippet.strict) {\n        // In a strict assembly, so we'll need to brand all diagnostics here...\n        for (const diag of diagnostics) {\n          annotateStrictDiagnostic(diag);\n        }\n      }\n      this.compileDiagnostics.push(...diagnostics);\n    }\n\n    /**\n     * Intercepts all exceptions thrown by the wrapped call, and logs them to\n     * console.error instead of re-throwing, then returns an empty array. This\n     * is here to avoid compiler crashes due to broken code examples that cause\n     * the TypeScript compiler to hit a \"Debug Failure\".\n     */\n    function neverThrowing<A extends unknown[], R>(call: (...args: A) => readonly R[]): (...args: A) => readonly R[] {\n      return (...args: A) => {\n        try {\n          return call(...args);\n        } catch (err: any) {\n          const isExpectedTypescriptError = err.message.includes('Debug Failure');\n\n          if (!isExpectedTypescriptError) {\n            console.error(`Failed to execute ${call.name}: ${err}`);\n          }\n\n          return [];\n        }\n      };\n    }\n  }\n\n  /**\n   * Returns a boolean if compilation was attempted, and undefined if it was not.\n   */\n  public get didSuccessfullyCompile() {\n    return this.tryCompile ? this.compileDiagnostics.length === 0 : undefined;\n  }\n\n  public renderUsing(visitor: AstHandler<any>) {\n    const converter = new AstRenderer(\n      this.compilation.rootFile,\n      this.compilation.program.getTypeChecker(),\n      visitor,\n      this.options,\n      // If we support transitive submodule access, don't provide a submodule reference map.\n      supportsTransitiveSubmoduleAccess(visitor.language) ? undefined : this.submoduleReferences,\n    );\n    const converted = converter.convert(this.compilation.rootFile);\n    this.translateDiagnostics.push(...filterVisibleDiagnostics(converter.diagnostics, this.visibleSpans));\n    return renderTree(converted, { indentChar: visitor.indentChar, visibleSpans: this.visibleSpans });\n  }\n\n  public syntaxKindCounter(): Partial<Record<ts.SyntaxKind, number>> {\n    const kindCounter = new SyntaxKindCounter(this.visibleSpans);\n    return kindCounter.countKinds(this.compilation.rootFile);\n  }\n\n  public fqnsReferenced() {\n    const visitor = new RecordReferencesVisitor(this.visibleSpans);\n    const converter = new AstRenderer(\n      this.compilation.rootFile,\n      this.compilation.program.getTypeChecker(),\n      visitor,\n      this.options,\n      this.submoduleReferences,\n    );\n    converter.convert(this.compilation.rootFile);\n    return visitor.fqnsReferenced();\n  }\n\n  public get diagnostics(): readonly ts.Diagnostic[] {\n    return ts.sortAndDeduplicateDiagnostics(this.compileDiagnostics.concat(this.translateDiagnostics));\n  }\n}\n\n/**\n * Hide diagnostics that are rosetta-sourced if they are reported against a non-visible span\n */\nfunction filterVisibleDiagnostics(diags: readonly ts.Diagnostic[], visibleSpans: Spans): ts.Diagnostic[] {\n  return diags.filter((d) => d.source !== 'rosetta' || d.start === undefined || visibleSpans.containsPosition(d.start));\n}\n\n/**\n * Turn TypeScript diagnostics into Rosetta diagnostics\n */\nexport function rosettaDiagFromTypescript(diag: ts.Diagnostic): RosettaDiagnostic {\n  return {\n    isError: diag.category === ts.DiagnosticCategory.Error,\n    isFromStrictAssembly: hasStrictBranding(diag),\n    formattedMessage: ts.formatDiagnosticsWithColorAndContext([diag], DIAG_HOST),\n  };\n}\n\nconst DIAG_HOST = {\n  getCurrentDirectory() {\n    return '.';\n  },\n  getCanonicalFileName(fileName: string) {\n    return fileName;\n  },\n  getNewLine() {\n    return '\\n';\n  },\n};\n\n/**\n * Remove slashes from a \"where\" description, as the TS compiler will interpret it as a directory\n * and we can't have that for compiling literate files\n */\nfunction removeSlashes(x: string) {\n  return x.replace(/\\/|\\\\/g, '.');\n}\n"]}

package/lib/translate_all.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.translateAll = void 0;
+exports.translateAll = translateAll;
 const os = require("node:os");
 const path = require("node:path");
 const workerpool = require("workerpool");
@@ -46,7 +46,6 @@ async function translateAll(snippets, includeCompilerDiagnostics) {
         void pool.terminate();
     }
 }
-exports.translateAll = translateAll;
 function batchSnippets(snippets, includeCompilerDiagnostics, batchSize = 10) {
     const ret = [];
     for (let i = 0; i < snippets.length; i += batchSize) {