jsii-rosetta 1.76.0 → 4.9.0-dev.0

package/lib/o-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"o-tree.js","sourceRoot":"","sources":["../src/o-tree.ts"],"names":[],"mappings":"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","sourcesContent":["import { Spans } from './typescript/visible-spans';\n\nexport interface OTreeOptions {\n  /**\n   * Adjust indentation with the given number\n   *\n   * Indentation affects children.\n   *\n   * @default 0\n   */\n  indent?: number;\n\n  /**\n   * Separate children with the given string\n   *\n   * @default ''\n   */\n  separator?: string;\n\n  /**\n   * Whether trailing separators should be output. This imples children will be\n   * writen each on a new line.\n   *\n   * @default false\n   */\n  trailingSeparator?: boolean;\n\n  /**\n   * Suffix the token after outdenting\n   *\n   * @default ''\n   */\n  suffix?: string;\n\n  /**\n   * Whether this part of the generated syntax is okay to insert newlines and comments\n   *\n   * @default false\n   */\n  canBreakLine?: boolean;\n\n  /**\n   * If set, a unique key which will cause only one node with the given key to be rendered.\n   *\n   * The outermost key is the one that will be rendered.\n   *\n   * Used to make it easier to keep the state necessary to render comments\n   * only once in the output tree, rather than keep the state in the\n   * language rendered.\n   *\n   * @default No conditional rendering\n   */\n  renderOnce?: string;\n}\n\n/**\n * \"Output\" Tree\n *\n * Tree-like structure that holds sequences of trees and strings, which\n * can be rendered to an output sink.\n */\nexport class OTree implements OTree {\n  public static simplify(xs: Array<OTree | string | undefined>): Array<OTree | string> {\n    return xs.filter(notUndefined).filter(notEmpty);\n  }\n\n  public readonly attachComment: boolean;\n\n  private readonly prefix: Array<OTree | string>;\n  private readonly children: Array<OTree | string>;\n  private span?: Span;\n\n  public constructor(\n    prefix: Array<OTree | string | undefined>,\n    children?: Array<OTree | string | undefined>,\n    private readonly options: OTreeOptions = {},\n  ) {\n    this.prefix = OTree.simplify(prefix);\n    this.children = OTree.simplify(children ?? []);\n    this.attachComment = !!options.canBreakLine;\n  }\n\n  /**\n   * Set the span in the source file this tree node relates to\n   */\n  public setSpan(start: number, end: number) {\n    this.span = { start, end };\n  }\n\n  public write(sink: OTreeSink) {\n    if (!sink.tagOnce(this.options.renderOnce)) {\n      return;\n    }\n\n    const meVisible = sink.renderingForSpan(this.span);\n\n    for (const x of this.prefix) {\n      sink.write(x);\n    }\n\n    const popIndent = sink.requestIndentChange(meVisible ? this.options.indent ?? 0 : 0);\n    let mark = sink.mark();\n\n    for (const child of this.children ?? []) {\n      if (this.options.separator) {\n        if (this.options.trailingSeparator) {\n          sink.ensureNewLine();\n        } else if (mark.wroteNonWhitespaceSinceMark) {\n          sink.write(this.options.separator);\n        }\n      }\n      mark = sink.mark();\n\n      sink.write(child);\n\n      if (this.options.separator && this.options.trailingSeparator) {\n        sink.write(this.options.separator.trimEnd());\n      }\n    }\n\n    popIndent();\n\n    if (this.options.suffix) {\n      if (this.options.separator && this.options.trailingSeparator) {\n        sink.ensureNewLine();\n      }\n      sink.renderingForSpan(this.span);\n      sink.write(this.options.suffix);\n    }\n  }\n\n  public get isEmpty() {\n    return this.prefix.length + this.children.length === 0;\n  }\n\n  public toString() {\n    return `<INCORRECTLY STRINGIFIED ${this.prefix.toString()}>`;\n  }\n}\n\nexport const NO_SYNTAX = new OTree([]);\n\nexport class UnknownSyntax extends OTree {}\n\nexport interface SinkMark {\n  readonly wroteNonWhitespaceSinceMark: boolean;\n}\n\nexport interface OTreeSinkOptions {\n  /**\n   * @default ' '\n   */\n  indentChar?: ' ' | '\\t';\n  visibleSpans?: Spans;\n}\n\ninterface ConditionalNewLine {\n  readonly conditionalNewLine: {\n    readonly indent: number;\n  };\n}\n\n/**\n * Output sink for OTree objects\n *\n * Maintains state about what has been rendered supports suppressing code\n * fragments based on their tagged source location.\n *\n * Basically: manages the state that was too hard to manage in the\n * tree :).\n */\nexport class OTreeSink {\n  private readonly indentChar: ' ' | '\\t';\n  private readonly indentLevels: number[] = [0];\n  private readonly fragments = new Array<string | ConditionalNewLine>();\n  private readonly singletonsRendered = new Set<string>();\n  private pendingIndentChange = 0;\n  private rendering = true;\n\n  public constructor(private readonly options: OTreeSinkOptions = {}) {\n    this.indentChar = options.indentChar ?? ' ';\n  }\n\n  public tagOnce(key: string | undefined): boolean {\n    if (key === undefined) {\n      return true;\n    }\n    if (this.singletonsRendered.has(key)) {\n      return false;\n    }\n    this.singletonsRendered.add(key);\n    return true;\n  }\n\n  /**\n   * Get a mark for the current sink output location\n   *\n   * Marks can be used to query about things that have been written to output.\n   */\n  public mark(): SinkMark {\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    const self = this;\n    const markIndex = this.fragments.length;\n\n    return {\n      get wroteNonWhitespaceSinceMark(): boolean {\n        return self.fragments.slice(markIndex).some((s) => typeof s !== 'object' && /[^\\s]/.exec(s) != null);\n      },\n    };\n  }\n\n  public write(text: string | OTree) {\n    if (text instanceof OTree) {\n      text.write(this);\n    } else {\n      if (!this.rendering) {\n        return;\n      }\n\n      if (containsNewline(text)) {\n        this.applyPendingIndentChange();\n      }\n      this.append(text.replace(/\\n/g, `\\n${this.indentChar.repeat(this.currentIndent)}`));\n    }\n  }\n\n  /**\n   * Ensures the following tokens will be output on a new line (emits a new line\n   * and indent unless immediately preceded or followed by a newline, ignoring\n   * surrounding white space).\n   */\n  public ensureNewLine(): void {\n    this.applyPendingIndentChange();\n    this.fragments.push({ conditionalNewLine: { indent: this.currentIndent } });\n  }\n\n  public renderingForSpan(span?: Span): boolean {\n    if (span && this.options.visibleSpans) {\n      this.rendering = this.options.visibleSpans.fullyContainsSpan(span);\n    }\n    return this.rendering;\n  }\n\n  public requestIndentChange(x: number): () => void {\n    if (x === 0) {\n      return () => undefined;\n    }\n\n    this.pendingIndentChange = x;\n    const currentIndentState = this.indentLevels.length;\n\n    // Return a pop function which will reset to the current indent state,\n    // regardless of whether the indent was actually applied or not.\n    return () => {\n      this.indentLevels.splice(currentIndentState);\n      this.pendingIndentChange = 0;\n    };\n  }\n\n  public toString() {\n    // Strip trailing whitespace from every line, and empty lines from the start and end\n    return this.fragments\n      .map((item, index, fragments) => {\n        if (typeof item !== 'object') {\n          return item;\n        }\n        const ignore = '';\n\n        const leading = fragments.slice(0, index).reverse();\n        for (const fragment of leading) {\n          if (typeof fragment === 'object') {\n            // We don't emit if there was already a conditional newline just before\n            return ignore;\n          }\n          // If there's a trailing newline, then we don't emit this one\n          if (/\\n\\s*$/m.exec(fragment)) {\n            return ignore;\n          }\n          // If it contained non-whitespace characters, we need to check trailing data...\n          if (/[^\\s]/.exec(fragment)) {\n            break;\n          }\n        }\n\n        const newlineAndIndent = `\\n${this.indentChar.repeat(item.conditionalNewLine.indent)}`;\n\n        const trailing = fragments.slice(index + 1);\n        for (const fragment of trailing) {\n          if (typeof fragment === 'object') {\n            // We're the first of a sequence, so we must emit (unless we returned earlier, of course)\n            return newlineAndIndent;\n          }\n          // If there's a leading newline, then we don't emit this one\n          if (/^\\s*\\n/m.exec(fragment)) {\n            return ignore;\n          }\n          // If it contained non-whitespace characters, we emit this one\n          if (/[^\\s]/.exec(fragment)) {\n            return newlineAndIndent;\n          }\n        }\n\n        return ignore;\n      })\n      .join('')\n      .replace(/[ \\t]+$/gm, '')\n      .replace(/^\\n+/, '')\n      .replace(/\\n+$/, '');\n  }\n\n  private append(x: string) {\n    this.fragments.push(x);\n  }\n\n  private applyPendingIndentChange() {\n    if (this.pendingIndentChange !== 0) {\n      this.indentLevels.push(this.currentIndent + this.pendingIndentChange);\n      this.pendingIndentChange = 0;\n    }\n  }\n\n  private get currentIndent() {\n    return this.indentLevels[this.indentLevels.length - 1];\n  }\n}\n\nfunction notUndefined<T>(x: T | undefined): x is T {\n  return x !== undefined;\n}\n\nfunction notEmpty(x: OTree | string) {\n  return x instanceof OTree ? !x.isEmpty : x !== '';\n}\n\nexport function renderTree(tree: OTree, options?: OTreeSinkOptions): string {\n  const sink = new OTreeSink(options);\n  tree.write(sink);\n  return sink.toString();\n}\n\nfunction containsNewline(x: string) {\n  return x.includes('\\n');\n}\n\nexport interface Span {\n  readonly start: number;\n  readonly end: number;\n}\n"]}

package/lib/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"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","sourcesContent":["import * as ts from 'typescript';\n\nimport { TargetLanguage } from './languages';\nimport { NO_SYNTAX, OTree, UnknownSyntax, Span } from './o-tree';\nimport { SubmoduleReference, SubmoduleReferenceMap } from './submodule-reference';\nimport {\n  commentRangeFromTextRange,\n  extractMaskingVoidExpression,\n  extractShowingVoidExpression,\n  nodeChildren,\n  repeatNewlines,\n  scanText,\n} from './typescript/ast-utils';\nimport { analyzeImportDeclaration, analyzeImportEquals, ImportStatement } from './typescript/imports';\nimport { typeOfExpression, inferredTypeOfExpression } from './typescript/types';\n\n/**\n * Render a TypeScript AST to some other representation (encoded in OTrees)\n *\n * Dispatch the actual conversion to a specific handler which will get the\n * appropriate method called for particular AST nodes. The handler may use\n * context to modify its own operations when traversing the tree hierarchy,\n * the type of which should be expressed via the C parameter.\n */\nexport class AstRenderer<C> {\n  public readonly diagnostics = new Array<ts.Diagnostic>();\n  public readonly currentContext: C;\n\n  public constructor(\n    private readonly sourceFile: ts.SourceFile,\n    public readonly typeChecker: ts.TypeChecker,\n    private readonly handler: AstHandler<C>,\n    private readonly options: AstRendererOptions = {},\n    public readonly submoduleReferences: SubmoduleReferenceMap = new Map(),\n  ) {\n    this.currentContext = handler.defaultContext;\n  }\n\n  /**\n   * Merge the new context with the current context and create a new Converter from it\n   */\n  public updateContext(contextUpdate: Partial<C>): AstRenderer<C> {\n    const newContext = this.handler.mergeContext(this.currentContext, contextUpdate);\n\n    // Use prototypal inheritance to create a version of 'this' in which only\n    // 'currentContext' is updated.\n    return Object.assign(Object.create(this), {\n      currentContext: newContext,\n    });\n  }\n\n  /**\n   * Convert a single node to an OTree\n   */\n  public convert(node: ts.Node | undefined): OTree {\n    if (node === undefined) {\n      return NO_SYNTAX;\n    }\n\n    // Basic transform of node\n    const transformed = this.dispatch(node);\n    transformed.setSpan(node.getStart(this.sourceFile), node.getEnd());\n    if (!transformed.attachComment) {\n      return transformed;\n    }\n\n    const withTrivia = this.attachLeadingTrivia(node, transformed);\n    withTrivia.setSpan(node.getStart(this.sourceFile), node.getEnd());\n    return withTrivia;\n  }\n\n  /**\n   * Convert a set of nodes, filtering out hidden nodes\n   */\n  public convertAll(nodes: readonly ts.Node[]): OTree[] {\n    return filterVisible(nodes).map(this.convert.bind(this));\n  }\n\n  public convertWithModifier(\n    nodes: readonly ts.Node[],\n    makeContext: (context: this, node: ts.Node, index: number) => AstRenderer<C>,\n  ): OTree[] {\n    const vis = assignVisibility(nodes);\n    const result = new Array<OTree>();\n    for (const [idx, { node, visible, maskingVoid }] of vis.entries()) {\n      const renderedNode = visible ? node : maskingVoid;\n      if (renderedNode) {\n        const context = makeContext(this, renderedNode, idx);\n        result.push(context.convert(renderedNode));\n      }\n    }\n    return result;\n  }\n\n  /**\n   * Convert a set of nodes, but update the context for the last one.\n   *\n   * Takes visibility into account.\n   */\n  public convertLastDifferently(nodes: readonly ts.Node[], lastContext: C): OTree[] {\n    const lastConverter = this.updateContext(lastContext);\n\n    const convert = this.convert.bind(this);\n    const lastConvert = lastConverter.convert.bind(lastConverter);\n\n    const ret: OTree[] = [];\n\n    const vis = assignVisibility(nodes);\n    for (let i = 0; i < vis.length; i++) {\n      const whichConvert = i === vis.length - 1 ? lastConvert : convert;\n\n      const node = vis[i].visible ? vis[i].node : vis[i].maskingVoid;\n      if (node) {\n        ret.push(whichConvert(node));\n      }\n    }\n\n    return ret;\n  }\n\n  public getPosition(node: ts.Node): Span {\n    return {\n      start: node.getStart(this.sourceFile),\n      end: node.getEnd(),\n    };\n  }\n\n  public textOf(node: ts.Node): string {\n    return node.getText(this.sourceFile);\n  }\n\n  public textAt(pos: number, end: number): string {\n    return this.sourceFile.text.substring(pos, end);\n  }\n\n  /**\n   * Infer type of expression by the argument it is assigned to\n   *\n   * If the type of the expression can include undefined (if the value is\n   * optional), `undefined` will be removed from the union.\n   *\n   * (Will return undefined for object literals not unified with a declared type)\n   *\n   * @deprecated Use `inferredTypeOfExpression` instead\n   */\n  public inferredTypeOfExpression(node: ts.Expression) {\n    return inferredTypeOfExpression(this.typeChecker, node);\n  }\n\n  /**\n   * Type of expression from the text of the expression\n   *\n   * (Will return a map type for object literals)\n   *\n   * @deprecated Use `typeOfExpression` directly\n   */\n  public typeOfExpression(node: ts.Expression): ts.Type {\n    return typeOfExpression(this.typeChecker, node);\n  }\n\n  public typeOfType(node: ts.TypeNode): ts.Type {\n    return this.typeChecker.getTypeFromTypeNode(node);\n  }\n\n  public typeToString(type: ts.Type) {\n    return this.typeChecker.typeToString(type);\n  }\n\n  public report(node: ts.Node, messageText: string, category: ts.DiagnosticCategory = ts.DiagnosticCategory.Error) {\n    this.diagnostics.push({\n      category,\n      code: 0,\n      source: 'rosetta',\n      messageText,\n      file: this.sourceFile,\n      start: node.getStart(this.sourceFile),\n      length: node.getWidth(this.sourceFile),\n    });\n  }\n\n  public reportUnsupported(node: ts.Node, language: TargetLanguage | undefined): void {\n    const nodeKind = ts.SyntaxKind[node.kind];\n    // tslint:disable-next-line:max-line-length\n    if (language) {\n      this.report(\n        node,\n        `This TypeScript feature (${nodeKind}) is not supported in examples because we cannot translate it to ${language}. Please rewrite this example.`,\n      );\n    } else {\n      this.report(\n        node,\n        `This TypeScript feature (${nodeKind}) is not supported in examples. Please rewrite this example.`,\n      );\n    }\n  }\n\n  /**\n   * Whether there is non-whitespace on the same line before the given position\n   */\n  public codeOnLineBefore(pos: number) {\n    const text = this.sourceFile.text;\n    while (pos > 0) {\n      const c = text[--pos];\n      if (c === '\\n') {\n        return false;\n      }\n      if (c !== ' ' && c !== '\\r' && c !== '\\t') {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  /**\n   * Return a newline if the given node is preceded by at least one newline\n   *\n   * Used to mirror newline use between matchin brackets (such as { ... } and [ ... ]).\n   */\n  public mirrorNewlineBefore(viz?: ts.Node, suffix = '', otherwise = ''): string {\n    if (viz === undefined) {\n      return suffix;\n    }\n\n    // Return a newline if the given node is preceded by newlines\n    const leadingRanges = scanText(this.sourceFile.text, viz.getFullStart(), viz.getStart(this.sourceFile));\n    const newlines = [];\n\n    for (const range of leadingRanges) {\n      if (range.type === 'other') {\n        newlines.push(repeatNewlines(this.sourceFile.text.substring(range.pos, range.end)));\n      }\n    }\n\n    return (newlines.join('').length > 0 ? '\\n' : otherwise) + suffix;\n  }\n\n  /**\n   * Dispatch node to handler\n   */\n  private dispatch(tree: ts.Node): OTree {\n    const visitor = this.handler;\n\n    // Using a switch on tree.kind + forced down-casting, because this is significantly faster than\n    // doing a cascade of `if` statements with the `ts.is<NodeType>` functions, since `tree.kind` is\n    // effectively integers, and this switch statement is hence optimizable to a jump table. This is\n    // a VERY significant enhancement to the debugging experience, too.\n    switch (tree.kind) {\n      case ts.SyntaxKind.EmptyStatement:\n        // Additional semicolon where it doesn't belong.\n        return NO_SYNTAX;\n      case ts.SyntaxKind.SourceFile:\n        return visitor.sourceFile(tree as ts.SourceFile, this);\n      case ts.SyntaxKind.ImportEqualsDeclaration:\n        return visitor.importStatement(analyzeImportEquals(tree as ts.ImportEqualsDeclaration, this), this);\n      case ts.SyntaxKind.ImportDeclaration:\n        return new OTree(\n          [],\n          analyzeImportDeclaration(tree as ts.ImportDeclaration, this, this.submoduleReferences).map((import_) =>\n            visitor.importStatement(import_, this),\n          ),\n          { canBreakLine: true, separator: '\\n' },\n        );\n      case ts.SyntaxKind.StringLiteral:\n      case ts.SyntaxKind.NoSubstitutionTemplateLiteral:\n        return visitor.stringLiteral(tree as ts.StringLiteral | ts.NoSubstitutionTemplateLiteral, this);\n      case ts.SyntaxKind.NumericLiteral:\n        return visitor.numericLiteral(tree as ts.NumericLiteral, this);\n      case ts.SyntaxKind.FunctionDeclaration:\n        return visitor.functionDeclaration(tree as ts.FunctionDeclaration, this);\n      case ts.SyntaxKind.Identifier:\n        return visitor.identifier(tree as ts.Identifier, this);\n      case ts.SyntaxKind.Block:\n        return visitor.block(tree as ts.Block, this);\n      case ts.SyntaxKind.Parameter:\n        return visitor.parameterDeclaration(tree as ts.ParameterDeclaration, this);\n      case ts.SyntaxKind.ReturnStatement:\n        return visitor.returnStatement(tree as ts.ReturnStatement, this);\n      case ts.SyntaxKind.BinaryExpression:\n        return visitor.binaryExpression(tree as ts.BinaryExpression, this);\n      case ts.SyntaxKind.IfStatement:\n        return visitor.ifStatement(tree as ts.IfStatement, this);\n      case ts.SyntaxKind.PropertyAccessExpression:\n        const submoduleReference = this.submoduleReferences?.get(tree as ts.PropertyAccessExpression);\n        return visitor.propertyAccessExpression(tree as ts.PropertyAccessExpression, this, submoduleReference);\n      case ts.SyntaxKind.AwaitExpression:\n        return visitor.awaitExpression(tree as ts.AwaitExpression, this);\n      case ts.SyntaxKind.CallExpression:\n        return visitor.callExpression(tree as ts.CallExpression, this);\n      case ts.SyntaxKind.ExpressionStatement:\n        return visitor.expressionStatement(tree as ts.ExpressionStatement, this);\n      case ts.SyntaxKind.ObjectLiteralExpression:\n        return visitor.objectLiteralExpression(tree as ts.ObjectLiteralExpression, this);\n      case ts.SyntaxKind.NewExpression:\n        return visitor.newExpression(tree as ts.NewExpression, this);\n      case ts.SyntaxKind.PropertyAssignment:\n        return visitor.propertyAssignment(tree as ts.PropertyAssignment, this);\n      case ts.SyntaxKind.VariableStatement:\n        return visitor.variableStatement(tree as ts.VariableStatement, this);\n      case ts.SyntaxKind.VariableDeclarationList:\n        return visitor.variableDeclarationList(tree as ts.VariableDeclarationList, this);\n      case ts.SyntaxKind.VariableDeclaration:\n        return visitor.variableDeclaration(tree as ts.VariableDeclaration, this);\n      case ts.SyntaxKind.ArrayLiteralExpression:\n        return visitor.arrayLiteralExpression(tree as ts.ArrayLiteralExpression, this);\n      case ts.SyntaxKind.ShorthandPropertyAssignment:\n        return visitor.shorthandPropertyAssignment(tree as ts.ShorthandPropertyAssignment, this);\n      case ts.SyntaxKind.ForOfStatement:\n        return visitor.forOfStatement(tree as ts.ForOfStatement, this);\n      case ts.SyntaxKind.ClassDeclaration:\n        return visitor.classDeclaration(tree as ts.ClassDeclaration, this);\n      case ts.SyntaxKind.Constructor:\n        return visitor.constructorDeclaration(tree as ts.ConstructorDeclaration, this);\n      case ts.SyntaxKind.PropertyDeclaration:\n        return visitor.propertyDeclaration(tree as ts.PropertyDeclaration, this);\n      case ts.SyntaxKind.ComputedPropertyName:\n        return visitor.computedPropertyName((tree as ts.ComputedPropertyName).expression, this);\n      case ts.SyntaxKind.MethodDeclaration:\n        return visitor.methodDeclaration(tree as ts.MethodDeclaration, this);\n      case ts.SyntaxKind.InterfaceDeclaration:\n        return visitor.interfaceDeclaration(tree as ts.InterfaceDeclaration, this);\n      case ts.SyntaxKind.PropertySignature:\n        return visitor.propertySignature(tree as ts.PropertySignature, this);\n      case ts.SyntaxKind.MethodSignature:\n        return visitor.methodSignature(tree as ts.MethodSignature, this);\n      case ts.SyntaxKind.AsExpression:\n        return visitor.asExpression(tree as ts.AsExpression, this);\n      case ts.SyntaxKind.PrefixUnaryExpression:\n        return visitor.prefixUnaryExpression(tree as ts.PrefixUnaryExpression, this);\n      case ts.SyntaxKind.SpreadAssignment:\n        if (this.textOf(tree) === '...') {\n          return visitor.ellipsis(tree as ts.SpreadAssignment, this);\n        }\n        return visitor.spreadAssignment(tree as ts.SpreadAssignment, this);\n      case ts.SyntaxKind.SpreadElement:\n        if (this.textOf(tree) === '...') {\n          return visitor.ellipsis(tree as ts.SpreadElement, this);\n        }\n        return visitor.spreadElement(tree as ts.SpreadElement, this);\n      case ts.SyntaxKind.ElementAccessExpression:\n        return visitor.elementAccessExpression(tree as ts.ElementAccessExpression, this);\n      case ts.SyntaxKind.TemplateExpression:\n        return visitor.templateExpression(tree as ts.TemplateExpression, this);\n      case ts.SyntaxKind.NonNullExpression:\n        return visitor.nonNullExpression(tree as ts.NonNullExpression, this);\n      case ts.SyntaxKind.ParenthesizedExpression:\n        return visitor.parenthesizedExpression(tree as ts.ParenthesizedExpression, this);\n      case ts.SyntaxKind.VoidExpression:\n        return visitor.maskingVoidExpression(tree as ts.VoidExpression, this);\n      case ts.SyntaxKind.JSDocComment:\n        return visitor.jsDoc(tree as ts.JSDoc, this);\n      default:\n        if (ts.isToken(tree)) {\n          return visitor.token(tree, this);\n        }\n        this.reportUnsupported(tree, undefined);\n    }\n\n    if (this.options.bestEffort !== false) {\n      // When doing best-effort conversion and we don't understand the node type, just return the complete text of it as-is\n      return new OTree([this.textOf(tree)]);\n    }\n    // Otherwise, show a placeholder indicating we don't recognize the type\n    const nodeKind = ts.SyntaxKind[tree.kind];\n    return new UnknownSyntax(\n      [`<${nodeKind} ${this.textOf(tree)}>`],\n      ['\\n', ...nodeChildren(tree).map(this.convert.bind(this))],\n      {\n        indent: 2,\n      },\n    );\n  }\n\n  /**\n   * Attach any leading whitespace and comments to the given output tree\n   *\n   * Regardless of whether it's declared to be able to accept such or not.\n   */\n  private attachLeadingTrivia(node: ts.Node, transformed: OTree): OTree {\n    // Add comments and leading whitespace\n    const leadingRanges = scanText(this.sourceFile.text, node.getFullStart(), node.getStart(this.sourceFile));\n\n    const precede: OTree[] = [];\n    for (const range of leadingRanges) {\n      let trivia: OTree | undefined = undefined;\n      switch (range.type) {\n        case 'other':\n          trivia = new OTree([repeatNewlines(this.sourceFile.text.substring(range.pos, range.end))], [], {\n            renderOnce: `ws-${range.pos}`,\n          });\n          break;\n        case 'linecomment':\n        case 'blockcomment':\n          trivia = this.handler.commentRange(\n            commentSyntaxFromCommentRange(commentRangeFromTextRange(range), this),\n            this,\n          );\n          break;\n\n        case 'directive':\n          break;\n      }\n      if (trivia != null) {\n        // Set spans on comments to make sure their visibility is toggled correctly.\n        trivia.setSpan(range.pos, range.end);\n        precede.push(trivia);\n      }\n    }\n\n    // FIXME: No trailing comments for now, they're too tricky\n\n    if (precede.length > 0 && !transformed.isEmpty) {\n      return new OTree([...precede, transformed], [], { canBreakLine: true });\n    }\n    return transformed;\n  }\n}\n\n/**\n * Interface for AST handlers\n *\n * C is the type of hierarchical context the handler uses. Context\n * needs 2 operations: a constructor for a default context, and a\n * merge operation to combine 2 contexts to yield a new one.\n *\n * Otherwise, the handler should return an OTree for every type\n * of AST node.\n */\nexport interface AstHandler<C> {\n  readonly language: TargetLanguage;\n\n  readonly defaultContext: C;\n  readonly indentChar?: ' ' | '\\t';\n  mergeContext(old: C, update: Partial<C>): C;\n\n  sourceFile(node: ts.SourceFile, context: AstRenderer<C>): OTree;\n  commentRange(node: CommentSyntax, context: AstRenderer<C>): OTree;\n  importStatement(node: ImportStatement, context: AstRenderer<C>): OTree;\n  stringLiteral(node: ts.StringLiteral | ts.NoSubstitutionTemplateLiteral, children: AstRenderer<C>): OTree;\n  numericLiteral(node: ts.NumericLiteral, children: AstRenderer<C>): OTree;\n  functionDeclaration(node: ts.FunctionDeclaration, children: AstRenderer<C>): OTree;\n  identifier(node: ts.Identifier, children: AstRenderer<C>): OTree;\n  block(node: ts.Block, children: AstRenderer<C>): OTree;\n  parameterDeclaration(node: ts.ParameterDeclaration, children: AstRenderer<C>): OTree;\n  returnStatement(node: ts.ReturnStatement, context: AstRenderer<C>): OTree;\n  binaryExpression(node: ts.BinaryExpression, context: AstRenderer<C>): OTree;\n  ifStatement(node: ts.IfStatement, context: AstRenderer<C>): OTree;\n  propertyAccessExpression(\n    node: ts.PropertyAccessExpression,\n    context: AstRenderer<C>,\n    submoduleReference: SubmoduleReference | undefined,\n  ): OTree;\n  awaitExpression(node: ts.AwaitExpression, context: AstRenderer<C>): OTree;\n  callExpression(node: ts.CallExpression, context: AstRenderer<C>): OTree;\n  expressionStatement(node: ts.ExpressionStatement, context: AstRenderer<C>): OTree;\n  token<A extends ts.SyntaxKind>(node: ts.Token<A>, context: AstRenderer<C>): OTree;\n  objectLiteralExpression(node: ts.ObjectLiteralExpression, context: AstRenderer<C>): OTree;\n  newExpression(node: ts.NewExpression, context: AstRenderer<C>): OTree;\n  propertyAssignment(node: ts.PropertyAssignment, context: AstRenderer<C>): OTree;\n  variableStatement(node: ts.VariableStatement, context: AstRenderer<C>): OTree;\n  variableDeclarationList(node: ts.VariableDeclarationList, context: AstRenderer<C>): OTree;\n  variableDeclaration(node: ts.VariableDeclaration, context: AstRenderer<C>): OTree;\n  jsDoc(node: ts.JSDoc, context: AstRenderer<C>): OTree;\n  arrayLiteralExpression(node: ts.ArrayLiteralExpression, context: AstRenderer<C>): OTree;\n  shorthandPropertyAssignment(node: ts.ShorthandPropertyAssignment, context: AstRenderer<C>): OTree;\n  forOfStatement(node: ts.ForOfStatement, context: AstRenderer<C>): OTree;\n  classDeclaration(node: ts.ClassDeclaration, context: AstRenderer<C>): OTree;\n  constructorDeclaration(node: ts.ConstructorDeclaration, context: AstRenderer<C>): OTree;\n  propertyDeclaration(node: ts.PropertyDeclaration, context: AstRenderer<C>): OTree;\n  computedPropertyName(node: ts.Expression, context: AstRenderer<C>): OTree;\n  methodDeclaration(node: ts.MethodDeclaration, context: AstRenderer<C>): OTree;\n  interfaceDeclaration(node: ts.InterfaceDeclaration, context: AstRenderer<C>): OTree;\n  propertySignature(node: ts.PropertySignature, context: AstRenderer<C>): OTree;\n  methodSignature(node: ts.MethodSignature, context: AstRenderer<C>): OTree;\n  asExpression(node: ts.AsExpression, context: AstRenderer<C>): OTree;\n  prefixUnaryExpression(node: ts.PrefixUnaryExpression, context: AstRenderer<C>): OTree;\n  spreadElement(node: ts.SpreadElement, context: AstRenderer<C>): OTree;\n  spreadAssignment(node: ts.SpreadAssignment, context: AstRenderer<C>): OTree;\n  templateExpression(node: ts.TemplateExpression, context: AstRenderer<C>): OTree;\n  nonNullExpression(node: ts.NonNullExpression, context: AstRenderer<C>): OTree;\n  parenthesizedExpression(node: ts.ParenthesizedExpression, context: AstRenderer<C>): OTree;\n  maskingVoidExpression(node: ts.VoidExpression, context: AstRenderer<C>): OTree;\n  elementAccessExpression(node: ts.ElementAccessExpression, context: AstRenderer<C>): OTree;\n\n  // Not a node, called when we recognize a spread element/assignment that is only\n  // '...' and nothing else.\n  ellipsis(node: ts.SpreadElement | ts.SpreadAssignment, context: AstRenderer<C>): OTree;\n}\n\nexport function nimpl<C>(node: ts.Node, context: AstRenderer<C>, options: { additionalInfo?: string } = {}) {\n  const children = nodeChildren(node).map((c) => context.convert(c));\n\n  let syntaxKind = ts.SyntaxKind[node.kind];\n  if (syntaxKind === 'FirstPunctuation') {\n    // These have the same identifier but this name is more descriptive\n    syntaxKind = 'OpenBraceToken';\n  }\n\n  const parts = [`(${syntaxKind}`];\n  if (options.additionalInfo) {\n    parts.push(`{${options.additionalInfo}}`);\n  }\n  parts.push(context.textOf(node));\n\n  return new UnknownSyntax([parts.join(' ')], children.length > 0 ? ['\\n', ...children] : [], {\n    indent: 2,\n    suffix: ')',\n    separator: '\\n',\n    canBreakLine: true,\n  });\n}\n\nexport interface AstRendererOptions {\n  /**\n   * If enabled, don't translate the text of unknown nodes\n   *\n   * @default true\n   */\n  bestEffort?: boolean;\n}\n\ninterface ClassifiedNode {\n  node: ts.Node;\n  visible: boolean;\n  maskingVoid?: ts.VoidExpression;\n}\n\nfunction filterVisible(nodes: readonly ts.Node[]): ts.Node[] {\n  return assignVisibility(nodes)\n    .map((c) => (c.visible ? c.node : c.maskingVoid))\n    .filter(notUndefined);\n}\n\nfunction assignVisibility(nodes: readonly ts.Node[]): ClassifiedNode[] {\n  const ret: ClassifiedNode[] = [];\n\n  let visible = true;\n  for (const node of nodes) {\n    const maskingVoid = extractMaskingVoidExpression(node);\n    if (visible && maskingVoid) {\n      visible = false;\n    }\n\n    ret.push({ node, maskingVoid, visible });\n\n    if (!visible) {\n      const showing = extractShowingVoidExpression(node);\n      if (showing) {\n        visible = true;\n      }\n    }\n  }\n\n  return ret;\n}\n\nfunction notUndefined<A>(x: A | undefined): x is A {\n  return x !== undefined;\n}\n\n/**\n * Our own representation of comments\n *\n * (So we can synthesize 'em\n */\nexport interface CommentSyntax {\n  pos: number;\n  text: string;\n  hasTrailingNewLine?: boolean;\n  kind: ts.CommentKind;\n\n  /**\n   * Whether it's at the end of a code line (so we can render a separating space)\n   */\n  isTrailing?: boolean;\n}\n\nfunction commentSyntaxFromCommentRange(rng: ts.CommentRange, renderer: AstRenderer<any>): CommentSyntax {\n  return {\n    hasTrailingNewLine: rng.hasTrailingNewLine,\n    kind: rng.kind,\n    pos: rng.pos,\n    text: renderer.textAt(rng.pos, rng.end),\n    isTrailing: renderer.codeOnLineBefore(rng.pos),\n  };\n}\n"]}

package/lib/rosetta-reader.js.map

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

package/lib/rosetta-translator.d.ts

@@ -67,7 +67,7 @@ export declare class RosettaTranslator {
     translateAll(snippets: TypeScriptSnippet[], addToTablet?: boolean): Promise<TranslateAllResult>;
     translateAll(snippets: TypeScriptSnippet[], options?: TranslateAllOptions): Promise<TranslateAllResult>;
 }
-export declare type CacheHit = {
+export type CacheHit = {
     readonly type: 'miss';
 } | {
     readonly type: 'hit';

package/lib/rosetta-translator.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RosettaTranslator = void 0;
-const fs_1 = require("fs");
+const node_fs_1 = require("node:fs");
 const fingerprinting_1 = require("./jsii/fingerprinting");
 const languages_1 = require("./languages");
 const logging = require("./logging");
@@ -131,7 +131,7 @@ class RosettaTranslator {
         finally {
             process.chdir(origDir);
             if (cleanCompilationDir) {
-                await fs_1.promises.rm(compilationDirectory, { force: true, recursive: true });
+                await node_fs_1.promises.rm(compilationDirectory, { force: true, recursive: true });
             }
         }
         const fingerprinted = result.translatedSnippets.map((snippet) => snippet.withFingerprint(this.fingerprinter.fingerprintAll(snippet.fqnsReferenced())));

package/lib/rosetta-translator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rosetta-translator.js","sourceRoot":"","sources":["../src/rosetta-translator.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fs } from 'node:fs';\nimport * as spec from '@jsii/spec';\n\nimport { TypeFingerprinter } from './jsii/fingerprinting';\nimport { TARGET_LANGUAGES } from './languages';\nimport * as logging from './logging';\nimport { TypeScriptSnippet, completeSource } from './snippet';\nimport { collectDependencies, validateAvailableDependencies, prepareDependencyDirectory } from './snippet-dependencies';\nimport { snippetKey } from './tablets/key';\nimport { LanguageTablet, TranslatedSnippet } from './tablets/tablets';\nimport { translateAll, TranslateAllResult } from './translate_all';\n\nexport interface RosettaTranslatorOptions {\n  /**\n   * Assemblies to use for fingerprinting\n   *\n   * The set of assemblies here are used to invalidate the cache. Any types that are\n   * used in snippets are looked up in this set of assemblies. If found, their type\n   * information is fingerprinted and compared to the type information at the time\n   * compilation of the cached sample. If different, this is considered to be a cache\n   * miss.\n   *\n   * You must use the same set of assemblies when generating and reading the cache\n   * file, otherwise the fingerprint is guaranteed to be different and the cache will\n   * be useless (e.g. if you generate the cache WITH assembly information but\n   * read it without, or vice versa).\n   *\n   * @default No assemblies.\n   */\n  readonly assemblies?: spec.Assembly[];\n\n  /**\n   * Whether to include compiler diagnostics in the compilation results.\n   *\n   * @default false\n   */\n  readonly includeCompilerDiagnostics?: boolean;\n\n  /**\n   * Allow reading dirty translations from cache\n   *\n   * @default false\n   */\n  readonly allowDirtyTranslations?: boolean;\n}\n\n/**\n * Entry point for consumers that want to translate code on-the-fly\n *\n * If you want to generate and translate code on-the-fly, in ways that cannot\n * be achieved by the rosetta CLI, use this class.\n */\nexport class RosettaTranslator {\n  /**\n   * Tablet with fresh translations\n   *\n   * All new translations (not read from cache) are added to this tablet.\n   */\n  public readonly tablet = new LanguageTablet();\n\n  public readonly cache = new LanguageTablet();\n\n  private readonly fingerprinter: TypeFingerprinter;\n  private readonly includeCompilerDiagnostics: boolean;\n  private readonly allowDirtyTranslations: boolean;\n\n  public constructor(options: RosettaTranslatorOptions = {}) {\n    this.fingerprinter = new TypeFingerprinter(options?.assemblies ?? []);\n    this.includeCompilerDiagnostics = options.includeCompilerDiagnostics ?? false;\n    this.allowDirtyTranslations = options.allowDirtyTranslations ?? false;\n  }\n\n  /**\n   * @deprecated use `addToCache` instead\n   */\n  public async loadCache(fileName: string) {\n    try {\n      await this.cache.load(fileName);\n    } catch (e: any) {\n      logging.warn(`Error reading cache ${fileName}: ${e.message}`);\n    }\n  }\n\n  public async addToCache(filename: string) {\n    const tab = await LanguageTablet.fromOptionalFile(filename);\n    this.cache.addTablet(tab);\n  }\n\n  public addTabletsToCache(...tablets: LanguageTablet[]) {\n    for (const tab of tablets) {\n      this.cache.addTablet(tab);\n    }\n  }\n\n  public hasCache() {\n    return this.cache.count > 0;\n  }\n\n  /**\n   * For all the given snippets, try to read translations from the cache\n   *\n   * Will remove the cached snippets from the input array.\n   */\n  public readFromCache(snippets: TypeScriptSnippet[], addToTablet = true, compiledOnly = false): ReadFromCacheResults {\n    const translations = new Array<TranslatedSnippet>();\n    const remaining = new Array<TypeScriptSnippet>();\n\n    let infusedCount = 0;\n    let dirtyCount = 0;\n    let dirtySourceCount = 0;\n    let dirtyTypesCount = 0;\n    let dirtyTranslatorCount = 0;\n    let dirtyDidntCompile = 0;\n\n    for (const snippet of snippets) {\n      const fromCache = tryReadFromCache(snippet, this.cache, this.fingerprinter, compiledOnly);\n      switch (fromCache.type) {\n        case 'hit':\n          if (addToTablet) {\n            this.tablet.addSnippet(fromCache.snippet);\n          }\n          translations.push(fromCache.snippet);\n\n          infusedCount += fromCache.infused ? 1 : 0;\n          break;\n\n        case 'dirty':\n          dirtyCount += 1;\n          dirtySourceCount += fromCache.dirtySource ? 1 : 0;\n          dirtyTranslatorCount += fromCache.dirtyTranslator ? 1 : 0;\n          dirtyTypesCount += fromCache.dirtyTypes ? 1 : 0;\n          dirtyDidntCompile += fromCache.dirtyDidntCompile ? 1 : 0;\n\n          if (this.allowDirtyTranslations) {\n            translations.push(fromCache.translation);\n          } else {\n            remaining.push(snippet);\n          }\n          break;\n\n        case 'miss':\n          remaining.push(snippet);\n          break;\n      }\n    }\n\n    return {\n      translations,\n      remaining,\n      infusedCount,\n      dirtyCount,\n      dirtySourceCount,\n      dirtyTranslatorCount,\n      dirtyTypesCount,\n      dirtyDidntCompile,\n    };\n  }\n\n  public async translateAll(snippets: TypeScriptSnippet[], addToTablet?: boolean): Promise<TranslateAllResult>;\n  public async translateAll(snippets: TypeScriptSnippet[], options?: TranslateAllOptions): Promise<TranslateAllResult>;\n  public async translateAll(\n    snippets: TypeScriptSnippet[],\n    optionsOrAddToTablet?: boolean | TranslateAllOptions,\n  ): Promise<TranslateAllResult> {\n    const options =\n      optionsOrAddToTablet && typeof optionsOrAddToTablet === 'object'\n        ? optionsOrAddToTablet\n        : { addToTablet: optionsOrAddToTablet };\n\n    const exampleDependencies = collectDependencies(snippets);\n\n    let compilationDirectory;\n    let cleanCompilationDir = false;\n    if (options?.compilationDirectory) {\n      // If the user provided a directory, we're going to trust-but-confirm.\n      await validateAvailableDependencies(options.compilationDirectory, exampleDependencies);\n      compilationDirectory = options.compilationDirectory;\n    } else {\n      compilationDirectory = await prepareDependencyDirectory(exampleDependencies);\n      cleanCompilationDir = true;\n    }\n\n    const origDir = process.cwd();\n    // Easiest way to get a fixed working directory (for sources) in is to chdir\n    process.chdir(compilationDirectory);\n\n    let result;\n    try {\n      result = await translateAll(snippets, this.includeCompilerDiagnostics);\n    } finally {\n      process.chdir(origDir);\n      if (cleanCompilationDir) {\n        await fs.rm(compilationDirectory, { force: true, recursive: true });\n      }\n    }\n\n    const fingerprinted = result.translatedSnippets.map((snippet) =>\n      snippet.withFingerprint(this.fingerprinter.fingerprintAll(snippet.fqnsReferenced())),\n    );\n\n    if (options?.addToTablet ?? true) {\n      for (const translation of fingerprinted) {\n        this.tablet.addSnippet(translation);\n      }\n    }\n\n    return {\n      translatedSnippets: fingerprinted,\n      diagnostics: result.diagnostics,\n    };\n  }\n}\n\n/**\n * Try to find the translation for the given snippet in the given cache\n *\n * Rules for cacheability are:\n * - id is the same (== visible source didn't change)\n * - complete source is the same (== fixture didn't change)\n * - all types involved have the same fingerprint (== API surface didn't change)\n * - the versions of all translations match the versions on the available translators (== translator itself didn't change)\n *\n * For the versions check: we could have selectively picked some translations\n * from the cache while performing others. However, since the big work is in\n * parsing the TypeScript, and the rendering itself is peanutes (assumption), it\n * doesn't really make a lot of difference.  So, for simplification's sake,\n * we'll regen all translations if there's at least one that's outdated.\n */\nfunction tryReadFromCache(\n  sourceSnippet: TypeScriptSnippet,\n  cache: LanguageTablet,\n  fingerprinter: TypeFingerprinter,\n  compiledOnly: boolean,\n): CacheHit {\n  const fromCache = cache.tryGetSnippet(snippetKey(sourceSnippet));\n\n  if (!fromCache) {\n    return { type: 'miss' };\n  }\n\n  // infused snippets won't pass the full source check or the fingerprinter\n  // but there is no reason to try to recompile it, so return cached snippet\n  // if there exists one.\n  if (isInfused(sourceSnippet)) {\n    return { type: 'hit', snippet: fromCache, infused: true };\n  }\n\n  const dirtySource = completeSource(sourceSnippet) !== fromCache.snippet.fullSource;\n  const dirtyTranslator = !Object.entries(TARGET_LANGUAGES).every(\n    ([lang, translator]) => fromCache.snippet.translations?.[lang]?.version === translator.version,\n  );\n  const dirtyTypes = fingerprinter.fingerprintAll(fromCache.fqnsReferenced()) !== fromCache.snippet.fqnsFingerprint;\n  const dirtyDidntCompile = compiledOnly && !fromCache.snippet.didCompile;\n\n  if (dirtySource || dirtyTranslator || dirtyTypes || dirtyDidntCompile) {\n    return { type: 'dirty', translation: fromCache, dirtySource, dirtyTranslator, dirtyTypes, dirtyDidntCompile };\n  }\n  return { type: 'hit', snippet: fromCache, infused: false };\n}\n\nexport type CacheHit =\n  | { readonly type: 'miss' }\n  | { readonly type: 'hit'; readonly snippet: TranslatedSnippet; readonly infused: boolean }\n  | {\n      readonly type: 'dirty';\n      readonly translation: TranslatedSnippet;\n      readonly dirtySource: boolean;\n      readonly dirtyTranslator: boolean;\n      readonly dirtyTypes: boolean;\n      readonly dirtyDidntCompile: boolean;\n    };\n\nfunction isInfused(snippet: TypeScriptSnippet) {\n  return snippet.parameters?.infused !== undefined;\n}\n\nexport interface ReadFromCacheResults {\n  /**\n   * Successful translations\n   */\n  readonly translations: TranslatedSnippet[];\n\n  /**\n   * Successful but dirty hits\n   */\n  readonly remaining: TypeScriptSnippet[];\n\n  /**\n   * How many successfully hit translations were infused\n   */\n  readonly infusedCount: number;\n\n  readonly dirtyCount: number;\n\n  // Counts for dirtiness (a single snippet may be dirty for more than one reason)\n  readonly dirtySourceCount: number;\n  readonly dirtyTranslatorCount: number;\n  readonly dirtyTypesCount: number;\n  readonly dirtyDidntCompile: number;\n}\n\nexport interface TranslateAllOptions {\n  /**\n   * @default - Create a temporary directory with all necessary packages\n   */\n  readonly compilationDirectory?: string;\n\n  /**\n   * @default true\n   */\n  readonly addToTablet?: boolean;\n}\n"]}

package/lib/snippet-dependencies.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.prepareDependencyDirectory = exports.validateAvailableDependencies = exports.collectDependencies = void 0;
-const cp = require("child_process");
+const cp = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
 const fastGlob = require("fast-glob");
-const fs_1 = require("fs");
-const fs = require("fs");
-const os = require("os");
-const path = require("path");
 const semver = require("semver");
 const semver_intersect_1 = require("semver-intersect");
 const find_utils_1 = require("./find-utils");
@@ -90,7 +90,7 @@ async function prepareDependencyDirectory(deps) {
         .filter(isConcrete)
         .map((x) => x.resolvedDirectory);
     const monorepoPackages = await scanMonoRepos(concreteDirs);
-    const tmpDir = await fs_1.promises.mkdtemp(path.join(os.tmpdir(), 'rosetta'));
+    const tmpDir = await node_fs_1.promises.mkdtemp(path.join(os.tmpdir(), 'rosetta'));
     logging.info(`Preparing dependency closure at ${tmpDir}`);
     // Resolved symbolic packages against monorepo
     const resolvedDeps = (0, util_1.mkDict)(Object.entries(deps).map(([name, dep]) => [
@@ -119,8 +119,8 @@ async function prepareDependencyDirectory(deps) {
             const target = path.join(modDir, name);
             if (!(await (0, util_1.pathExists)(target))) {
                 // Package could be namespaced, so ensure the namespace dir exists
-                await fs_1.promises.mkdir(path.dirname(target), { recursive: true });
-                await fs_1.promises.symlink(source, target, 'dir');
+                await node_fs_1.promises.mkdir(path.dirname(target), { recursive: true });
+                await node_fs_1.promises.symlink(source, target, 'dir');
             }
         }));
     }
@@ -144,7 +144,7 @@ async function scanMonoRepos(startingDirs) {
     const results = (0, util_1.mkDict)((await Promise.all(packageDirectories.map(async (directory) => {
         const pjLocation = path.join(directory, 'package.json');
         return (await (0, util_1.pathExists)(pjLocation))
-            ? [[JSON.parse(await fs_1.promises.readFile(pjLocation, 'utf-8')).name, directory]]
+            ? [[JSON.parse(await node_fs_1.promises.readFile(pjLocation, 'utf-8')).name, directory]]
             : [];
     }))).flat());
     logging.debug(`Found ${Object.keys(results).length} packages in monorepo: ${(0, util_1.formatList)(Object.keys(results))}`);
@@ -155,16 +155,16 @@ async function findMonoRepoGlobs(startingDir) {
     // Lerna monorepo
     const lernaJsonDir = await (0, find_utils_1.findUp)(startingDir, async (dir) => (0, util_1.pathExists)(path.join(dir, 'lerna.json')));
     if (lernaJsonDir) {
-        const lernaJson = JSON.parse(await fs_1.promises.readFile(path.join(lernaJsonDir, 'lerna.json'), 'utf-8'));
+        const lernaJson = JSON.parse(await node_fs_1.promises.readFile(path.join(lernaJsonDir, 'lerna.json'), 'utf-8'));
         for (const glob of lernaJson?.packages ?? []) {
             ret.add(path.join(lernaJsonDir, glob));
         }
     }
     // Yarn monorepo
     const yarnWsDir = await (0, find_utils_1.findUp)(startingDir, async (dir) => (await (0, util_1.pathExists)(path.join(dir, 'package.json'))) &&
-        JSON.parse(await fs_1.promises.readFile(path.join(dir, 'package.json'), 'utf-8'))?.workspaces !== undefined);
+        JSON.parse(await node_fs_1.promises.readFile(path.join(dir, 'package.json'), 'utf-8'))?.workspaces !== undefined);
     if (yarnWsDir) {
-        const yarnWs = JSON.parse(await fs_1.promises.readFile(path.join(yarnWsDir, 'package.json'), 'utf-8'));
+        const yarnWs = JSON.parse(await node_fs_1.promises.readFile(path.join(yarnWsDir, 'package.json'), 'utf-8'));
         for (const glob of yarnWs.workspaces?.packages ?? []) {
             ret.add(path.join(yarnWsDir, glob));
         }

package/lib/snippet-dependencies.js.map

@@ -0,0 +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 * as fastGlob from 'fast-glob';\nimport * as semver from 'semver';\nimport { intersect } from 'semver-intersect';\n\nimport { findDependencyDirectory, findUp } from './find-utils';\nimport * as logging from './logging';\nimport { TypeScriptSnippet, CompilationDependency } from './snippet';\nimport { mkDict, formatList, pathExists } from './util';\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\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: intersect(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)) {\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  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 * 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}`);\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  // Use 'npm install' only for the symbolic packages. For the concrete packages,\n  // npm is going to try and find transitive dependencies as well and it won't know\n  // about monorepos.\n  const symbolicInstalls = Object.entries(resolvedDeps).flatMap(([name, dep]) =>\n    isSymbolic(dep) ? [`${name}@${dep.versionRange}`] : [],\n  );\n  const linkedInstalls = mkDict(\n    Object.entries(resolvedDeps).flatMap(([name, dep]) =>\n      isConcrete(dep) ? [[name, dep.resolvedDirectory] as const] : [],\n    ),\n  );\n\n  // Run 'npm install' on it\n  if (symbolicInstalls.length > 0) {\n    logging.debug(`Installing example dependencies: ${symbolicInstalls.join(' ')}`);\n    cp.execSync(`npm install ${symbolicInstalls.join(' ')}`, { cwd: tmpDir, encoding: 'utf-8' });\n  }\n\n  // Symlink the rest\n  if (Object.keys(linkedInstalls).length > 0) {\n    logging.debug(`Symlinking example dependencies: ${Object.values(linkedInstalls).join(' ')}`);\n    const modDir = path.join(tmpDir, 'node_modules');\n    await Promise.all(\n      Object.entries(linkedInstalls).map(async ([name, source]) => {\n        const target = path.join(modDir, name);\n        if (!(await pathExists(target))) {\n          // Package could be namespaced, so ensure the namespace dir exists\n          await fsPromises.mkdir(path.dirname(target), { recursive: true });\n          await fsPromises.symlink(source, target, 'dir');\n        }\n      }),\n    );\n  }\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 isSymbolic(x: CompilationDependency): x is Extract<CompilationDependency, { type: 'symbolic' }> {\n  return x.type === 'symbolic';\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.d.ts

@@ -1,5 +1,5 @@
 import { TranslatedSnippet } from './tablets/tablets';
-export declare type SnippetSelector = (snippets: TranslatedSnippet[]) => TranslatedSnippet;
+export type SnippetSelector = (snippets: TranslatedSnippet[]) => TranslatedSnippet;
 /**
  * Returns the longest available snippet.
  */

package/lib/snippet-selectors.js

@@ -42,10 +42,10 @@ function meanLength(snippets) {
     if (snippets.length === 0) {
         throw new Error('meanLength: array cannot be empty');
     }
-    const mean = snippets.reduce((x, y) => x + y.originalSource.source.length, 0) / snippets.length;
+    const meanLen = snippets.reduce((x, y) => x + y.originalSource.source.length, 0) / snippets.length;
     const snippetScores = [];
     for (const snippet of snippets) {
-        snippetScores.push({ snippet: snippet, score: Math.abs(snippet.originalSource.source.length - mean) });
+        snippetScores.push({ snippet: snippet, score: Math.abs(snippet.originalSource.source.length - meanLen) });
     }
     return getMinScore(snippetScores).snippet;
 }

package/lib/snippet-selectors.js.map

@@ -0,0 +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"]}

package/lib/snippet.d.ts

@@ -34,7 +34,7 @@ export interface TypeScriptSnippet {
      */
     readonly compilationDependencies?: Record<string, CompilationDependency>;
 }
-export declare type CompilationDependency = {
+export type CompilationDependency = {
     readonly type: 'concrete';
     readonly resolvedDirectory: string;
 } | {
@@ -69,7 +69,7 @@ export interface SnippetLocation {
  * 'initializer-parameter' variant).
  */
 export declare const INITIALIZER_METHOD_NAME = "<initializer>";
-export declare type ApiLocation = {
+export type ApiLocation = {
     readonly api: 'file';
     readonly fileName: string;
 } | {
@@ -91,7 +91,7 @@ export declare type ApiLocation = {
     readonly methodName: string | typeof INITIALIZER_METHOD_NAME;
     readonly parameterName: string;
 };
-export declare type FieldLocation = {
+export type FieldLocation = {
     readonly field: 'markdown';
     readonly line: number;
 } | {

package/lib/snippet.js

@@ -94,11 +94,11 @@ exports.typeScriptSnippetFromSource = typeScriptSnippetFromSource;
  */
 function typeScriptSnippetFromCompleteSource(typeScriptSource, location, strict, parameters = {}) {
     const [source, sourceParameters] = parametersFromSourceDirectives(typeScriptSource);
-    const completeSource = source.trimRight();
-    const visibleSource = (0, visible_spans_1.trimCompleteSourceToVisible)(completeSource);
+    const completeSrc = source.trimRight();
+    const visibleSource = (0, visible_spans_1.trimCompleteSourceToVisible)(completeSrc);
     return {
         visibleSource,
-        completeSource: visibleSource !== completeSource ? completeSource : undefined,
+        completeSource: visibleSource !== completeSrc ? completeSrc : undefined,
         location,
         parameters: Object.assign({}, parameters, sourceParameters),
         strict,
@@ -150,8 +150,8 @@ function parseKeyValueList(parameters) {
 exports.parseKeyValueList = parseKeyValueList;
 function parseMetadataLine(metadata) {
     return parseKeyValueList(parseMetadata(metadata));
-    function parseMetadata(metadata) {
-        return metadata
+    function parseMetadata(md) {
+        return md
             .trim()
             .split(' ')
             .map((s) => s.trim())

package/lib/snippet.js.map

@@ -0,0 +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.\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.map

@@ -0,0 +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"]}

package/lib/submodule-reference.d.ts

@@ -1,5 +1,5 @@
 import * as ts from 'typescript';
-export declare type SubmoduleReferenceMap = ReadonlyMap<ts.PropertyAccessExpression | ts.LeftHandSideExpression | ts.Identifier | ts.PrivateIdentifier, SubmoduleReference>;
+export type SubmoduleReferenceMap = ReadonlyMap<ts.PropertyAccessExpression | ts.LeftHandSideExpression | ts.Identifier | ts.PrivateIdentifier, SubmoduleReference>;
 export declare class SubmoduleReference {
     readonly root: ts.Symbol;
     readonly submoduleChain: ts.LeftHandSideExpression | ts.Identifier | ts.PrivateIdentifier;

package/lib/submodule-reference.js

@@ -3,11 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SubmoduleReference = void 0;
 const ts = require("typescript");
 class SubmoduleReference {
-    constructor(root, submoduleChain, path) {
-        this.root = root;
-        this.submoduleChain = submoduleChain;
-        this.path = path;
-    }
     static inSourceFile(sourceFile, typeChecker) {
         const importDeclarations = sourceFile.statements
             .filter((stmt) => ts.isImportDeclaration(stmt))
@@ -44,6 +39,11 @@ class SubmoduleReference {
         }
         return map;
     }
+    constructor(root, submoduleChain, path) {
+        this.root = root;
+        this.submoduleChain = submoduleChain;
+        this.path = path;
+    }
     get lastNode() {
         if (this.path.length === 0) {
             const node = this.root.valueDeclaration ?? this.root.declarations[0];
@@ -84,19 +84,19 @@ function importedSymbolsFrom(decl, sourceFile, typeChecker) {
     }
     if (namedBindings != null) {
         if (ts.isNamespaceImport(namedBindings)) {
-            const { name } = namedBindings;
-            const symbol = typeChecker.getSymbolAtLocation(name);
+            const { name: bindingName } = namedBindings;
+            const symbol = typeChecker.getSymbolAtLocation(bindingName);
             if (symbol == null) {
-                throw new Error(`No symbol was defined for node ${name.getText(sourceFile)}`);
+                throw new Error(`No symbol was defined for node ${bindingName.getText(sourceFile)}`);
             }
             imports.push(symbol);
         }
         else {
             for (const specifier of namedBindings.elements) {
-                const { name } = specifier;
-                const symbol = typeChecker.getSymbolAtLocation(name);
+                const { name: specifierName } = specifier;
+                const symbol = typeChecker.getSymbolAtLocation(specifierName);
                 if (symbol == null) {
-                    throw new Error(`No symbol was defined for node ${name.getText(sourceFile)}`);
+                    throw new Error(`No symbol was defined for node ${specifierName.getText(sourceFile)}`);
                 }
                 imports.push(symbol);
             }

package/lib/submodule-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submodule-reference.js","sourceRoot":"","sources":["../src/submodule-reference.ts"],"names":[],"mappings":"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","sourcesContent":["import * as ts from 'typescript';\n\nexport type SubmoduleReferenceMap = ReadonlyMap<\n  ts.PropertyAccessExpression | ts.LeftHandSideExpression | ts.Identifier | ts.PrivateIdentifier,\n  SubmoduleReference\n>;\n\nexport class SubmoduleReference {\n  public static inSourceFile(sourceFile: ts.SourceFile, typeChecker: ts.TypeChecker): SubmoduleReferenceMap {\n    const importDeclarations = sourceFile.statements\n      .filter((stmt) => ts.isImportDeclaration(stmt))\n      .flatMap((stmt) => importedSymbolsFrom(stmt as ts.ImportDeclaration, sourceFile, typeChecker));\n\n    return SubmoduleReference.inNode(sourceFile, typeChecker, new Set(importDeclarations));\n  }\n\n  private static inNode(\n    node: ts.Node,\n    typeChecker: ts.TypeChecker,\n    importDeclarations: ReadonlySet<ts.Symbol>,\n    map = new Map<\n      ts.PropertyAccessExpression | ts.LeftHandSideExpression | ts.Identifier | ts.PrivateIdentifier,\n      SubmoduleReference\n    >(),\n  ): Map<\n    ts.PropertyAccessExpression | ts.LeftHandSideExpression | ts.Identifier | ts.PrivateIdentifier,\n    SubmoduleReference\n  > {\n    if (ts.isPropertyAccessExpression(node)) {\n      const [head, ...tail] = propertyPath(node);\n      const symbol = typeChecker.getSymbolAtLocation(head.name);\n      if (symbol && importDeclarations.has(symbol)) {\n        // This is a reference within an imported namespace, so we need to record that...\n        const firstNonNamespace = tail.findIndex((item) => !isLikelyNamespace(item.name, typeChecker));\n        if (firstNonNamespace < 0) {\n          map.set(node.expression, new SubmoduleReference(symbol, node.expression, []));\n        } else {\n          const tailEnd = tail[firstNonNamespace].expression;\n          const path = tail.slice(0, firstNonNamespace).map((item) => item.name);\n          map.set(tailEnd, new SubmoduleReference(symbol, tailEnd, path));\n        }\n      }\n\n      return map;\n    }\n\n    // Faster than ||-ing a bung of if statements to avoid traversing uninteresting nodes...\n    switch (node.kind) {\n      case ts.SyntaxKind.ImportDeclaration:\n      case ts.SyntaxKind.ExportDeclaration:\n        break;\n      default:\n        for (const child of node.getChildren()) {\n          map = SubmoduleReference.inNode(child, typeChecker, importDeclarations, map);\n        }\n    }\n\n    return map;\n  }\n\n  private constructor(\n    public readonly root: ts.Symbol,\n    public readonly submoduleChain: ts.LeftHandSideExpression | ts.Identifier | ts.PrivateIdentifier,\n    public readonly path: readonly ts.Node[],\n  ) {}\n\n  public get lastNode(): ts.Node {\n    if (this.path.length === 0) {\n      const node = this.root.valueDeclaration ?? this.root.declarations![0];\n      return ts.isNamespaceImport(node) || ts.isImportSpecifier(node) ? node.name : node;\n    }\n    return this.path[this.path.length - 1];\n  }\n\n  public toString(): string {\n    return `${this.constructor.name}<root=${this.root.name}, path=${JSON.stringify(\n      this.path.map((item) => item.getText(item.getSourceFile())),\n    )}>`;\n  }\n}\n\n/**\n * Determines what symbols are imported by the given TypeScript import\n * delcaration, in the context of the specified file, using the provided type\n * checker.\n *\n * @param decl        an import declaration.\n * @param sourceFile  the source file that contains the import declaration.\n * @param typeChecker a TypeChecker instance valid for the provided source file.\n *\n * @returns the (possibly empty) list of symbols imported by this declaration.\n */\nfunction importedSymbolsFrom(\n  decl: ts.ImportDeclaration,\n  sourceFile: ts.SourceFile,\n  typeChecker: ts.TypeChecker,\n): ts.Symbol[] {\n  const { importClause } = decl;\n\n  if (importClause == null) {\n    // This is a \"for side effects\" import, which isn't relevant for our business here...\n    return [];\n  }\n\n  const { name, namedBindings } = importClause;\n  const imports = new Array<ts.Symbol>();\n\n  if (name != null) {\n    const symbol = typeChecker.getSymbolAtLocation(name);\n    if (symbol == null) {\n      throw new Error(`No symbol was defined for node ${name.getText(sourceFile)}`);\n    }\n    imports.push(symbol);\n  }\n  if (namedBindings != null) {\n    if (ts.isNamespaceImport(namedBindings)) {\n      const { name: bindingName } = namedBindings;\n      const symbol = typeChecker.getSymbolAtLocation(bindingName);\n      if (symbol == null) {\n        throw new Error(`No symbol was defined for node ${bindingName.getText(sourceFile)}`);\n      }\n      imports.push(symbol);\n    } else {\n      for (const specifier of namedBindings.elements) {\n        const { name: specifierName } = specifier;\n        const symbol = typeChecker.getSymbolAtLocation(specifierName);\n        if (symbol == null) {\n          throw new Error(`No symbol was defined for node ${specifierName.getText(sourceFile)}`);\n        }\n        imports.push(symbol);\n      }\n    }\n  }\n\n  return imports;\n}\n\ninterface PathEntry {\n  readonly name: ts.Identifier | ts.PrivateIdentifier | ts.LeftHandSideExpression;\n  readonly expression: ts.LeftHandSideExpression;\n}\n\nfunction propertyPath(node: ts.PropertyAccessExpression): readonly PathEntry[] {\n  const { expression, name } = node;\n  if (!ts.isPropertyAccessExpression(expression)) {\n    return [\n      { name: expression, expression },\n      { name, expression },\n    ];\n  }\n  return [...propertyPath(expression), { name, expression }];\n}\n\n/**\n * A heuristic to determine whether the provided node likely refers to some\n * namespace.\n *\n * @param node        the node to be checked.\n * @param typeChecker a type checker that can obtain symbols for this node.\n *\n * @returns true if the node likely refers to a namespace name.\n */\nfunction isLikelyNamespace(node: ts.Node, typeChecker: ts.TypeChecker): boolean {\n  if (!ts.isIdentifier(node)) {\n    return false;\n  }\n\n  // If the identifier was bound to a symbol, we can inspect the declarations of\n  // it to validate they are all module or namespace declarations.\n  const symbol = typeChecker.getSymbolAtLocation(node);\n  if (symbol != null) {\n    return (\n      symbol.declarations!.length > 0 &&\n      symbol.declarations!.every(\n        (decl) => ts.isModuleDeclaration(decl) || ts.isNamespaceExport(decl) || ts.isNamespaceImport(decl),\n      )\n    );\n  }\n\n  // We understand this is likely a namespace if the name does not start with\n  // upper-case letter.\n  return !startsWithUpperCase(node.text);\n}\n\nfunction startsWithUpperCase(text: string): boolean {\n  return text.length > 0 && text[0] === text[0].toUpperCase();\n}\n"]}

package/lib/tablets/key.js

@@ -1,15 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.snippetKey = void 0;
-const crypto = require("crypto");
-const record_references_1 = require("../languages/record-references");
+const crypto = require("node:crypto");
+const record_references_version_1 = require("../languages/record-references-version");
 const snippet_1 = require("../snippet");
 /**
  * Determine the key for a code block
  */
 function snippetKey(snippet) {
     const h = crypto.createHash('sha256');
-    h.update(String(record_references_1.RecordReferencesVisitor.VERSION));
+    h.update(String(record_references_version_1.RECORD_REFERENCES_VERSION));
     // Mix in API location to distinguish between similar snippets
     h.update((0, snippet_1.renderApiLocation)(snippet.location.api));
     h.update(':');

package/lib/tablets/key.js.map

@@ -0,0 +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"]}