jsii 5.9.44 → 6.0.0

package/lib/directives.js

@@ -1,13 +1,40 @@
 "use strict";
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _a, _Directives_CACHE;
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Directives = void 0;
-const ts = require("typescript");
+const ts = __importStar(require("typescript"));
 const jsii_diagnostic_1 = require("./jsii-diagnostic");
 /**
  * TSDoc-style directives that can be attached to a symbol.
@@ -21,22 +48,29 @@ class Directives {
      *                     emitted when parsing directives.
      */
     static of(node, onDiagnostic) {
-        const found = __classPrivateFieldGet(_a, _a, "f", _Directives_CACHE).get(node);
+        const found = Directives.#CACHE.get(node);
         if (found != null) {
             return found;
         }
-        const directives = new _a(node, onDiagnostic);
-        __classPrivateFieldGet(_a, _a, "f", _Directives_CACHE).set(node, directives);
+        const directives = new Directives(node, onDiagnostic);
+        Directives.#CACHE.set(node, directives);
         return directives;
     }
+    static #CACHE = new WeakMap();
+    /** Whether the node has the `@internal` JSDoc tag. */
+    tsInternal;
+    /** Whether the node has the `@jsii ignore` directive set. */
+    ignore;
+    /** Whether the node has the `@jsii struct` directive set. */
+    struct;
+    /** Suppression codes from `@jsii suppress <code>` directives. */
+    suppressions = [];
     constructor(node, onDiagnostic) {
-        /** Suppression codes from `@jsii suppress <code>` directives. */
-        this.suppressions = [];
         const suppressions = [];
         for (const tag of ts.getJSDocTags(node)) {
             switch (tag.tagName.text) {
                 case 'internal':
-                    this.tsInternal ?? (this.tsInternal = tag);
+                    this.tsInternal ??= tag;
                     break;
                 case 'jsii':
                     const comments = getComments(tag);
@@ -48,7 +82,7 @@ class Directives {
                         const [subcommand, ...rest] = text.split(/\s+/);
                         switch (subcommand) {
                             case 'ignore':
-                                this.ignore ?? (this.ignore = jsdocNode);
+                                this.ignore ??= jsdocNode;
                                 break;
                             case 'suppress': {
                                 const code = rest[0];
@@ -70,8 +104,6 @@ class Directives {
     }
 }
 exports.Directives = Directives;
-_a = Directives;
-_Directives_CACHE = { value: new WeakMap() };
 function getComments(tag) {
     if (tag.comment == null) {
         return [];

package/lib/directives.js.map

@@ -1 +1 @@
-{"version":3,"file":"directives.js","sourceRoot":"","sources":["../src/directives.ts"],"names":[],"mappings":"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","sourcesContent":["import * as ts from 'typescript';\nimport { JsiiDiagnostic } from './jsii-diagnostic';\n\n/**\n * TSDoc-style directives that can be attached to a symbol.\n */\nexport class Directives {\n  /**\n   * Obtains the `Directives` for a given TypeScript AST node.\n   *\n   * @param node         the node for which directives are requested.\n   * @param onDiagnostic a callback invoked whenever a diagnostic message is\n   *                     emitted when parsing directives.\n   */\n  public static of(node: ts.Node, onDiagnostic: (diag: JsiiDiagnostic) => void): Directives {\n    const found = Directives.#CACHE.get(node);\n    if (found != null) {\n      return found;\n    }\n\n    const directives = new Directives(node, onDiagnostic);\n    Directives.#CACHE.set(node, directives);\n    return directives;\n  }\n\n  static readonly #CACHE = new WeakMap<ts.Node, Directives>();\n\n  /** Whether the node has the `@internal` JSDoc tag. */\n  public readonly tsInternal?: ts.JSDocTag;\n  /** Whether the node has the `@jsii ignore` directive set. */\n  public readonly ignore?: ts.JSDocComment | ts.JSDocTag;\n  /** Whether the node has the `@jsii struct` directive set. */\n  public readonly struct?: ts.JSDocComment | ts.JSDocTag;\n  /** Suppression codes from `@jsii suppress <code>` directives. */\n  public readonly suppressions: readonly string[] = [];\n\n  private constructor(node: ts.Node, onDiagnostic: (diag: JsiiDiagnostic) => void) {\n    const suppressions: string[] = [];\n    for (const tag of ts.getJSDocTags(node)) {\n      switch (tag.tagName.text) {\n        case 'internal':\n          this.tsInternal ??= tag;\n          break;\n        case 'jsii':\n          const comments = getComments(tag);\n          if (comments.length === 0) {\n            onDiagnostic(JsiiDiagnostic.JSII_2000_MISSING_DIRECTIVE_ARGUMENT.create(tag));\n            continue;\n          }\n          for (const { text, jsdocNode } of comments) {\n            const [subcommand, ...rest] = text.split(/\\s+/);\n            switch (subcommand) {\n              case 'ignore':\n                this.ignore ??= jsdocNode;\n                break;\n              case 'suppress': {\n                const code = rest[0];\n                if (code) {\n                  suppressions.push(code);\n                }\n                break;\n              }\n              default:\n                onDiagnostic(JsiiDiagnostic.JSII_2999_UNKNOWN_DIRECTIVE.create(jsdocNode, text));\n                break;\n            }\n          }\n          break;\n        default: // Ignore\n      }\n    }\n    this.suppressions = suppressions;\n  }\n}\n\nfunction getComments(tag: ts.JSDocTag): Comment[] {\n  if (tag.comment == null) {\n    return [];\n  }\n\n  if (typeof tag.comment === 'string') {\n    const text = tag.comment.trim();\n    return text\n      ? text.split(/[\\n,]/).flatMap((line) => {\n          line = line.trim();\n          return line ? [{ text: line, jsdocNode: tag }] : [];\n        })\n      : [];\n  }\n\n  // Possible per the type signature in the compiler, however not sure in which conditions.\n  return tag.comment.flatMap((jsdocNode): Comment[] => {\n    let text: string;\n    switch (jsdocNode.kind) {\n      case ts.SyntaxKind.JSDocText:\n        text = jsdocNode.text;\n        break;\n      case ts.SyntaxKind.JSDocLink:\n      case ts.SyntaxKind.JSDocLinkCode:\n      case ts.SyntaxKind.JSDocLinkPlain:\n        text = jsdocNode.name\n          ? `${jsdocNode.name.getText(jsdocNode.name.getSourceFile())}: ${jsdocNode.text}`\n          : jsdocNode.text;\n        break;\n    }\n    text = text.trim();\n    return text ? [{ text, jsdocNode }] : [];\n  });\n}\n\ninterface Comment {\n  readonly text: string;\n  readonly jsdocNode: ts.JSDocComment | ts.JSDocTag;\n}\n"]}
+{"version":3,"file":"directives.js","sourceRoot":"","sources":["../src/directives.ts"],"names":[],"mappings":"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","sourcesContent":["import * as ts from 'typescript';\nimport { JsiiDiagnostic } from './jsii-diagnostic';\n\n/**\n * TSDoc-style directives that can be attached to a symbol.\n */\nexport class Directives {\n  /**\n   * Obtains the `Directives` for a given TypeScript AST node.\n   *\n   * @param node         the node for which directives are requested.\n   * @param onDiagnostic a callback invoked whenever a diagnostic message is\n   *                     emitted when parsing directives.\n   */\n  public static of(node: ts.Node, onDiagnostic: (diag: JsiiDiagnostic) => void): Directives {\n    const found = Directives.#CACHE.get(node);\n    if (found != null) {\n      return found;\n    }\n\n    const directives = new Directives(node, onDiagnostic);\n    Directives.#CACHE.set(node, directives);\n    return directives;\n  }\n\n  static readonly #CACHE = new WeakMap<ts.Node, Directives>();\n\n  /** Whether the node has the `@internal` JSDoc tag. */\n  public readonly tsInternal?: ts.JSDocTag;\n  /** Whether the node has the `@jsii ignore` directive set. */\n  public readonly ignore?: ts.JSDocComment | ts.JSDocTag;\n  /** Whether the node has the `@jsii struct` directive set. */\n  public readonly struct?: ts.JSDocComment | ts.JSDocTag;\n  /** Suppression codes from `@jsii suppress <code>` directives. */\n  public readonly suppressions: readonly string[] = [];\n\n  private constructor(node: ts.Node, onDiagnostic: (diag: JsiiDiagnostic) => void) {\n    const suppressions: string[] = [];\n    for (const tag of ts.getJSDocTags(node)) {\n      switch (tag.tagName.text) {\n        case 'internal':\n          this.tsInternal ??= tag;\n          break;\n        case 'jsii':\n          const comments = getComments(tag);\n          if (comments.length === 0) {\n            onDiagnostic(JsiiDiagnostic.JSII_2000_MISSING_DIRECTIVE_ARGUMENT.create(tag));\n            continue;\n          }\n          for (const { text, jsdocNode } of comments) {\n            const [subcommand, ...rest] = text.split(/\\s+/);\n            switch (subcommand) {\n              case 'ignore':\n                this.ignore ??= jsdocNode;\n                break;\n              case 'suppress': {\n                const code = rest[0];\n                if (code) {\n                  suppressions.push(code);\n                }\n                break;\n              }\n              default:\n                onDiagnostic(JsiiDiagnostic.JSII_2999_UNKNOWN_DIRECTIVE.create(jsdocNode, text));\n                break;\n            }\n          }\n          break;\n        default: // Ignore\n      }\n    }\n    this.suppressions = suppressions;\n  }\n}\n\nfunction getComments(tag: ts.JSDocTag): Comment[] {\n  if (tag.comment == null) {\n    return [];\n  }\n\n  if (typeof tag.comment === 'string') {\n    const text = tag.comment.trim();\n    return text\n      ? text.split(/[\\n,]/).flatMap((line) => {\n          line = line.trim();\n          return line ? [{ text: line, jsdocNode: tag }] : [];\n        })\n      : [];\n  }\n\n  // Possible per the type signature in the compiler, however not sure in which conditions.\n  return tag.comment.flatMap((jsdocNode): Comment[] => {\n    let text: string;\n    switch (jsdocNode.kind) {\n      case ts.SyntaxKind.JSDocText:\n        text = jsdocNode.text;\n        break;\n      case ts.SyntaxKind.JSDocLink:\n      case ts.SyntaxKind.JSDocLinkCode:\n      case ts.SyntaxKind.JSDocLinkPlain:\n        text = jsdocNode.name\n          ? `${jsdocNode.name.getText(jsdocNode.name.getSourceFile())}: ${jsdocNode.text}`\n          : jsdocNode.text;\n        break;\n    }\n    text = text.trim();\n    return text ? [{ text, jsdocNode }] : [];\n  });\n}\n\ninterface Comment {\n  readonly text: string;\n  readonly jsdocNode: ts.JSDocComment | ts.JSDocTag;\n}\n"]}

package/lib/docs.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseSymbolDocumentation = parseSymbolDocumentation;
 exports.getReferencedDocParams = getReferencedDocParams;
@@ -35,8 +68,8 @@ exports.splitSummary = splitSummary;
  *
  * https://github.com/Microsoft/tsdoc/blob/master/api-demo/src/advancedDemo.ts
  */
-const spec = require("@jsii/spec");
-const ts = require("typescript");
+const spec = __importStar(require("@jsii/spec"));
+const ts = __importStar(require("typescript"));
 /**
  * Tags that we recognize
  */
@@ -239,14 +272,13 @@ function parseStability(s, diagnostics) {
  * We do this until we encounter a supported @ keyword.
  */
 function reabsorbExampleTags(tags) {
-    var _a;
     const ret = [...tags];
     let i = 0;
     while (i < ret.length) {
         if (ret[i].name === 'example') {
             while (i + 1 < ret.length && !RECOGNIZED_TAGS.has(ret[i + 1].name)) {
                 // Incorrectly classified as @tag, absorb back into example
-                (_a = ret[i]).text ?? (_a.text = []);
+                ret[i].text ??= [];
                 ret[i].text.push({
                     text: `@${ret[i + 1].name}${ret[i + 1].text}`,
                     kind: '',

package/lib/docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs.js","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Doc Comment parsing\n *\n * I tried using TSDoc here.\n *\n * Pro:\n * - Future standard.\n * - Does validating parsing and complains on failure.\n * - Has a more flexible interpretation of the @example tag (starts in text mode).\n *\n * Con:\n * - Different tags from JSDoc (@defaultValue instead of @default, \"@param name\n *   description\" instead \"@param name description\".\n * - @example tag has a different interpretation than VSCode and JSDoc\n *   (VSCode/JSDoc starts in code mode), which is confusing for syntax\n *   highlighting in the editor.\n * - Allows no unknown tags.\n * - Wants to be in charge of parsing TypeScript, integrating into other build is\n *   possible but harder.\n * - Parse to a DOM with no easy way to roundtrip back to equivalent MarkDown.\n *\n * Especially the last point: while parsing to and storing the parsed docs DOM\n * in the jsii assembly is superior in the long term (for example for\n * converting to different output formats, JavaDoc, C# docs, refdocs which all\n * accept slightly different syntaxes), right now we can get 80% of the bang\n * for 10% of the buck by just reading, storing and reproducing MarkDown, which\n * is Readable Enough(tm).\n *\n * If we ever want to attempt TSDoc again, this would be a good place to look at:\n *\n * https://github.com/Microsoft/tsdoc/blob/master/api-demo/src/advancedDemo.ts\n */\nimport * as spec from '@jsii/spec';\nimport * as ts from 'typescript';\n\n/**\n * Tags that we recognize\n */\nenum DocTag {\n  PARAM = 'param',\n  DEFAULT = 'default',\n  DEFAULT_VALUE = 'defaultValue',\n  DEPRECATED = 'deprecated',\n  RETURNS = 'returns',\n  RETURN = 'return',\n  STABLE = 'stable',\n  EXPERIMENTAL = 'experimental',\n  SEE = 'see',\n  SUBCLASSABLE = 'subclassable',\n  EXAMPLE = 'example',\n  STABILITY = 'stability',\n  STRUCT = 'struct',\n\n  // Not forwarded, this is compiler-internal.\n  JSII = 'jsii',\n}\n\nconst RECOGNIZED_TAGS: ReadonlySet<String> = new Set(Object.values(DocTag));\n\n/**\n * Parse all doc comments that apply to a symbol into JSIIDocs format\n */\nexport function parseSymbolDocumentation(sym: ts.Symbol, typeChecker: ts.TypeChecker): DocsParsingResult {\n  const comment = ts.displayPartsToString(sym.getDocumentationComment(typeChecker)).trim();\n  const tags = reabsorbExampleTags(sym.getJsDocTags());\n\n  // Right here we'll just guess that the first declaration site is the most important one.\n  return parseDocParts(comment, tags);\n}\n\n/**\n * Return the list of parameter names that are referenced in the docstring for this symbol\n */\nexport function getReferencedDocParams(sym: ts.Symbol): string[] {\n  const ret = new Array<string>();\n  for (const tag of sym.getJsDocTags()) {\n    if (tag.name === DocTag.PARAM) {\n      const parts = ts.displayPartsToString(tag.text).split(' ');\n      ret.push(parts[0]);\n    }\n  }\n  return ret;\n}\n\nfunction parseDocParts(comments: string | undefined, tags: ts.JSDocTagInfo[]): DocsParsingResult {\n  const diagnostics = new Array<string>();\n  const docs: spec.Docs = {};\n  const hints: TypeSystemHints = {};\n\n  [docs.summary, docs.remarks] = splitSummary(comments);\n\n  const tagNames = new Map<string, string | undefined>();\n  for (const tag of tags) {\n    // 'param' gets parsed as a tag and as a comment for a method\n    // 'jsii' is internal-only and shouldn't surface in the API doc\n    if (tag.name !== DocTag.PARAM && tag.name !== DocTag.JSII) {\n      tagNames.set(tag.name, tag.text && ts.displayPartsToString(tag.text));\n    }\n  }\n\n  function eatTag(...names: string[]): string | undefined {\n    for (const name of names) {\n      if (tagNames.has(name)) {\n        const ret = tagNames.get(name);\n        tagNames.delete(name);\n        return ret ?? '';\n      }\n    }\n    return undefined;\n  }\n\n  if (eatTag(DocTag.STRUCT) != null) {\n    hints.struct = true;\n  }\n\n  docs.default = eatTag(DocTag.DEFAULT, DocTag.DEFAULT_VALUE);\n  docs.deprecated = eatTag(DocTag.DEPRECATED);\n  docs.example = eatTag(DocTag.EXAMPLE);\n  docs.returns = eatTag(DocTag.RETURNS, DocTag.RETURN);\n  docs.see = eatTag(DocTag.SEE);\n  docs.subclassable = eatTag(DocTag.SUBCLASSABLE) !== undefined ? true : undefined;\n\n  docs.stability = parseStability(eatTag(DocTag.STABILITY), diagnostics);\n  //  @experimental is a shorthand for '@stability experimental', same for '@stable'\n  const experimental = eatTag(DocTag.EXPERIMENTAL) !== undefined;\n  const stable = eatTag(DocTag.STABLE) !== undefined;\n  // Can't combine them\n  if (countBools(docs.stability !== undefined, experimental, stable) > 1) {\n    diagnostics.push('Use only one of @stability, @experimental or @stable');\n  }\n  if (experimental) {\n    docs.stability = spec.Stability.Experimental;\n  }\n  if (stable) {\n    docs.stability = spec.Stability.Stable;\n  }\n\n  // Can combine '@stability deprecated' with '@deprecated <reason>'\n  if (docs.deprecated !== undefined) {\n    if (docs.stability !== undefined && docs.stability !== spec.Stability.Deprecated) {\n      diagnostics.push(\"@deprecated tag requires '@stability deprecated' or no @stability at all.\");\n    }\n    docs.stability = spec.Stability.Deprecated;\n  }\n\n  if (docs.example?.includes('```')) {\n    // This is currently what the JSDoc standard expects, and VSCode highlights it in\n    // this way as well. TSDoc disagrees and says that examples start in text mode\n    // which I tend to agree with, but that hasn't become a widely used standard yet.\n    //\n    // So we conform to existing reality.\n    diagnostics.push('@example must be code only, no code block fences allowed.');\n  }\n\n  if (docs.deprecated?.trim() === '') {\n    diagnostics.push('@deprecated tag needs a reason and/or suggested alternatives.');\n  }\n\n  if (tagNames.size > 0) {\n    docs.custom = {};\n    for (const [key, value] of tagNames.entries()) {\n      docs.custom[key] = value ?? 'true'; // Key must have a value or it will be stripped from the assembly\n    }\n  }\n\n  return { docs, diagnostics, hints };\n}\n\nexport interface DocsParsingResult {\n  docs: spec.Docs;\n  hints: TypeSystemHints;\n  diagnostics?: string[];\n}\n\nexport interface TypeSystemHints {\n  /**\n   * Only present on interfaces. This indicates that interface must be handled as a struct/data type\n   * even through it's name starts with a capital letter `I`.\n   */\n  struct?: boolean;\n}\n\n/**\n * Split the doc comment into summary and remarks\n *\n * Normally, we'd expect people to split into a summary line and detail lines using paragraph\n * markers. However, a LOT of people do not do this, and just paste a giant comment block into\n * the docstring. If we detect that situation, we will try and extract the first sentence (using\n * a period) as the summary.\n */\nexport function splitSummary(docBlock: string | undefined): [string | undefined, string | undefined] {\n  if (!docBlock) {\n    return [undefined, undefined];\n  }\n  const summary = summaryLine(docBlock);\n  const remarks = uberTrim(docBlock.slice(summary.length));\n  return [endWithPeriod(noNewlines(summary.trim())), remarks];\n}\n\n/**\n * Replace newlines with spaces for use in tables\n */\nfunction noNewlines(s: string) {\n  return s.replace(/\\r?\\n/g, ' ');\n}\n\nfunction endWithPeriod(s: string) {\n  return ENDS_WITH_PUNCTUATION_REGEX.test(s) ? s : `${s}.`;\n}\n\n/**\n * Trims a string and turns it into `undefined` if the result would have been an\n * empty string.\n */\nfunction uberTrim(str: string): string | undefined {\n  str = str.trim();\n  return str === '' ? undefined : str;\n}\n\nconst SUMMARY_MAX_WORDS = 20;\n\n/**\n * Find the summary line for a doc comment\n *\n * In principle we'll take the first paragraph, but if there are no paragraphs\n * (because people don't put in paragraph breaks) or the first paragraph is too\n * long, we'll take the first sentence (terminated by a punctuation).\n */\nfunction summaryLine(str: string) {\n  const paras = str.split(/(\\r?\\n){2}/);\n  if (paras.length > 1 && paras[0].split(' ').length < SUMMARY_MAX_WORDS) {\n    return paras[0];\n  }\n\n  const m = FIRST_SENTENCE_REGEX.exec(str);\n  if (m) {\n    return m[1];\n  }\n\n  return paras[0];\n}\n\nconst PUNCTUATION = ['!', '?', '.', ';'].map((s) => `\\\\${s}`).join('');\nconst ENDS_WITH_PUNCTUATION_REGEX = new RegExp(`[${PUNCTUATION}]$`);\nconst FIRST_SENTENCE_REGEX = new RegExp(`^([^${PUNCTUATION}]+[${PUNCTUATION}][ \\n\\r])`); // Needs a whitespace after the punctuation.\n\nfunction intBool(x: boolean): number {\n  return x ? 1 : 0;\n}\n\nfunction countBools(...x: boolean[]) {\n  return x.map(intBool).reduce((a, b) => a + b, 0);\n}\n\nfunction parseStability(s: string | undefined, diagnostics: string[]): spec.Stability | undefined {\n  if (s === undefined) {\n    return undefined;\n  }\n\n  switch (s) {\n    case 'stable':\n      return spec.Stability.Stable;\n    case 'experimental':\n      return spec.Stability.Experimental;\n    case 'external':\n      return spec.Stability.External;\n    case 'deprecated':\n      return spec.Stability.Deprecated;\n  }\n  diagnostics.push(`Unrecognized @stability: '${s}'`);\n  return undefined;\n}\n\n/**\n * Unrecognized tags that follow an '@ example' tag will be absorbed back into the example value\n *\n * The TypeScript parser by itself is naive and will start parsing a new tag there.\n *\n * We do this until we encounter a supported @ keyword.\n */\nfunction reabsorbExampleTags(tags: ts.JSDocTagInfo[]): ts.JSDocTagInfo[] {\n  const ret = [...tags];\n\n  let i = 0;\n  while (i < ret.length) {\n    if (ret[i].name === 'example') {\n      while (i + 1 < ret.length && !RECOGNIZED_TAGS.has(ret[i + 1].name)) {\n        // Incorrectly classified as @tag, absorb back into example\n        ret[i].text ??= [];\n        ret[i].text!.push({\n          text: `@${ret[i + 1].name}${ret[i + 1].text}`,\n          kind: '',\n        });\n        ret.splice(i + 1, 1);\n      }\n    }\n    i++;\n  }\n\n  return ret;\n}\n"]}
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Doc Comment parsing\n *\n * I tried using TSDoc here.\n *\n * Pro:\n * - Future standard.\n * - Does validating parsing and complains on failure.\n * - Has a more flexible interpretation of the @example tag (starts in text mode).\n *\n * Con:\n * - Different tags from JSDoc (@defaultValue instead of @default, \"@param name\n *   description\" instead \"@param name description\".\n * - @example tag has a different interpretation than VSCode and JSDoc\n *   (VSCode/JSDoc starts in code mode), which is confusing for syntax\n *   highlighting in the editor.\n * - Allows no unknown tags.\n * - Wants to be in charge of parsing TypeScript, integrating into other build is\n *   possible but harder.\n * - Parse to a DOM with no easy way to roundtrip back to equivalent MarkDown.\n *\n * Especially the last point: while parsing to and storing the parsed docs DOM\n * in the jsii assembly is superior in the long term (for example for\n * converting to different output formats, JavaDoc, C# docs, refdocs which all\n * accept slightly different syntaxes), right now we can get 80% of the bang\n * for 10% of the buck by just reading, storing and reproducing MarkDown, which\n * is Readable Enough(tm).\n *\n * If we ever want to attempt TSDoc again, this would be a good place to look at:\n *\n * https://github.com/Microsoft/tsdoc/blob/master/api-demo/src/advancedDemo.ts\n */\nimport * as spec from '@jsii/spec';\nimport * as ts from 'typescript';\n\n/**\n * Tags that we recognize\n */\nenum DocTag {\n  PARAM = 'param',\n  DEFAULT = 'default',\n  DEFAULT_VALUE = 'defaultValue',\n  DEPRECATED = 'deprecated',\n  RETURNS = 'returns',\n  RETURN = 'return',\n  STABLE = 'stable',\n  EXPERIMENTAL = 'experimental',\n  SEE = 'see',\n  SUBCLASSABLE = 'subclassable',\n  EXAMPLE = 'example',\n  STABILITY = 'stability',\n  STRUCT = 'struct',\n\n  // Not forwarded, this is compiler-internal.\n  JSII = 'jsii',\n}\n\nconst RECOGNIZED_TAGS: ReadonlySet<String> = new Set(Object.values(DocTag));\n\n/**\n * Parse all doc comments that apply to a symbol into JSIIDocs format\n */\nexport function parseSymbolDocumentation(sym: ts.Symbol, typeChecker: ts.TypeChecker): DocsParsingResult {\n  const comment = ts.displayPartsToString(sym.getDocumentationComment(typeChecker)).trim();\n  const tags = reabsorbExampleTags(sym.getJsDocTags());\n\n  // Right here we'll just guess that the first declaration site is the most important one.\n  return parseDocParts(comment, tags);\n}\n\n/**\n * Return the list of parameter names that are referenced in the docstring for this symbol\n */\nexport function getReferencedDocParams(sym: ts.Symbol): string[] {\n  const ret = new Array<string>();\n  for (const tag of sym.getJsDocTags()) {\n    if (tag.name === DocTag.PARAM) {\n      const parts = ts.displayPartsToString(tag.text).split(' ');\n      ret.push(parts[0]);\n    }\n  }\n  return ret;\n}\n\nfunction parseDocParts(comments: string | undefined, tags: ts.JSDocTagInfo[]): DocsParsingResult {\n  const diagnostics = new Array<string>();\n  const docs: spec.Docs = {};\n  const hints: TypeSystemHints = {};\n\n  [docs.summary, docs.remarks] = splitSummary(comments);\n\n  const tagNames = new Map<string, string | undefined>();\n  for (const tag of tags) {\n    // 'param' gets parsed as a tag and as a comment for a method\n    // 'jsii' is internal-only and shouldn't surface in the API doc\n    if (tag.name !== DocTag.PARAM && tag.name !== DocTag.JSII) {\n      tagNames.set(tag.name, tag.text && ts.displayPartsToString(tag.text));\n    }\n  }\n\n  function eatTag(...names: string[]): string | undefined {\n    for (const name of names) {\n      if (tagNames.has(name)) {\n        const ret = tagNames.get(name);\n        tagNames.delete(name);\n        return ret ?? '';\n      }\n    }\n    return undefined;\n  }\n\n  if (eatTag(DocTag.STRUCT) != null) {\n    hints.struct = true;\n  }\n\n  docs.default = eatTag(DocTag.DEFAULT, DocTag.DEFAULT_VALUE);\n  docs.deprecated = eatTag(DocTag.DEPRECATED);\n  docs.example = eatTag(DocTag.EXAMPLE);\n  docs.returns = eatTag(DocTag.RETURNS, DocTag.RETURN);\n  docs.see = eatTag(DocTag.SEE);\n  docs.subclassable = eatTag(DocTag.SUBCLASSABLE) !== undefined ? true : undefined;\n\n  docs.stability = parseStability(eatTag(DocTag.STABILITY), diagnostics);\n  //  @experimental is a shorthand for '@stability experimental', same for '@stable'\n  const experimental = eatTag(DocTag.EXPERIMENTAL) !== undefined;\n  const stable = eatTag(DocTag.STABLE) !== undefined;\n  // Can't combine them\n  if (countBools(docs.stability !== undefined, experimental, stable) > 1) {\n    diagnostics.push('Use only one of @stability, @experimental or @stable');\n  }\n  if (experimental) {\n    docs.stability = spec.Stability.Experimental;\n  }\n  if (stable) {\n    docs.stability = spec.Stability.Stable;\n  }\n\n  // Can combine '@stability deprecated' with '@deprecated <reason>'\n  if (docs.deprecated !== undefined) {\n    if (docs.stability !== undefined && docs.stability !== spec.Stability.Deprecated) {\n      diagnostics.push(\"@deprecated tag requires '@stability deprecated' or no @stability at all.\");\n    }\n    docs.stability = spec.Stability.Deprecated;\n  }\n\n  if (docs.example?.includes('```')) {\n    // This is currently what the JSDoc standard expects, and VSCode highlights it in\n    // this way as well. TSDoc disagrees and says that examples start in text mode\n    // which I tend to agree with, but that hasn't become a widely used standard yet.\n    //\n    // So we conform to existing reality.\n    diagnostics.push('@example must be code only, no code block fences allowed.');\n  }\n\n  if (docs.deprecated?.trim() === '') {\n    diagnostics.push('@deprecated tag needs a reason and/or suggested alternatives.');\n  }\n\n  if (tagNames.size > 0) {\n    docs.custom = {};\n    for (const [key, value] of tagNames.entries()) {\n      docs.custom[key] = value ?? 'true'; // Key must have a value or it will be stripped from the assembly\n    }\n  }\n\n  return { docs, diagnostics, hints };\n}\n\nexport interface DocsParsingResult {\n  docs: spec.Docs;\n  hints: TypeSystemHints;\n  diagnostics?: string[];\n}\n\nexport interface TypeSystemHints {\n  /**\n   * Only present on interfaces. This indicates that interface must be handled as a struct/data type\n   * even through it's name starts with a capital letter `I`.\n   */\n  struct?: boolean;\n}\n\n/**\n * Split the doc comment into summary and remarks\n *\n * Normally, we'd expect people to split into a summary line and detail lines using paragraph\n * markers. However, a LOT of people do not do this, and just paste a giant comment block into\n * the docstring. If we detect that situation, we will try and extract the first sentence (using\n * a period) as the summary.\n */\nexport function splitSummary(docBlock: string | undefined): [string | undefined, string | undefined] {\n  if (!docBlock) {\n    return [undefined, undefined];\n  }\n  const summary = summaryLine(docBlock);\n  const remarks = uberTrim(docBlock.slice(summary.length));\n  return [endWithPeriod(noNewlines(summary.trim())), remarks];\n}\n\n/**\n * Replace newlines with spaces for use in tables\n */\nfunction noNewlines(s: string) {\n  return s.replace(/\\r?\\n/g, ' ');\n}\n\nfunction endWithPeriod(s: string) {\n  return ENDS_WITH_PUNCTUATION_REGEX.test(s) ? s : `${s}.`;\n}\n\n/**\n * Trims a string and turns it into `undefined` if the result would have been an\n * empty string.\n */\nfunction uberTrim(str: string): string | undefined {\n  str = str.trim();\n  return str === '' ? undefined : str;\n}\n\nconst SUMMARY_MAX_WORDS = 20;\n\n/**\n * Find the summary line for a doc comment\n *\n * In principle we'll take the first paragraph, but if there are no paragraphs\n * (because people don't put in paragraph breaks) or the first paragraph is too\n * long, we'll take the first sentence (terminated by a punctuation).\n */\nfunction summaryLine(str: string) {\n  const paras = str.split(/(\\r?\\n){2}/);\n  if (paras.length > 1 && paras[0].split(' ').length < SUMMARY_MAX_WORDS) {\n    return paras[0];\n  }\n\n  const m = FIRST_SENTENCE_REGEX.exec(str);\n  if (m) {\n    return m[1];\n  }\n\n  return paras[0];\n}\n\nconst PUNCTUATION = ['!', '?', '.', ';'].map((s) => `\\\\${s}`).join('');\nconst ENDS_WITH_PUNCTUATION_REGEX = new RegExp(`[${PUNCTUATION}]$`);\nconst FIRST_SENTENCE_REGEX = new RegExp(`^([^${PUNCTUATION}]+[${PUNCTUATION}][ \\n\\r])`); // Needs a whitespace after the punctuation.\n\nfunction intBool(x: boolean): number {\n  return x ? 1 : 0;\n}\n\nfunction countBools(...x: boolean[]) {\n  return x.map(intBool).reduce((a, b) => a + b, 0);\n}\n\nfunction parseStability(s: string | undefined, diagnostics: string[]): spec.Stability | undefined {\n  if (s === undefined) {\n    return undefined;\n  }\n\n  switch (s) {\n    case 'stable':\n      return spec.Stability.Stable;\n    case 'experimental':\n      return spec.Stability.Experimental;\n    case 'external':\n      return spec.Stability.External;\n    case 'deprecated':\n      return spec.Stability.Deprecated;\n  }\n  diagnostics.push(`Unrecognized @stability: '${s}'`);\n  return undefined;\n}\n\n/**\n * Unrecognized tags that follow an '@ example' tag will be absorbed back into the example value\n *\n * The TypeScript parser by itself is naive and will start parsing a new tag there.\n *\n * We do this until we encounter a supported @ keyword.\n */\nfunction reabsorbExampleTags(tags: ts.JSDocTagInfo[]): ts.JSDocTagInfo[] {\n  const ret = [...tags];\n\n  let i = 0;\n  while (i < ret.length) {\n    if (ret[i].name === 'example') {\n      while (i + 1 < ret.length && !RECOGNIZED_TAGS.has(ret[i + 1].name)) {\n        // Incorrectly classified as @tag, absorb back into example\n        ret[i].text ??= [];\n        ret[i].text!.push({\n          text: `@${ret[i + 1].name}${ret[i + 1].text}`,\n          kind: '',\n        });\n        ret.splice(i + 1, 1);\n      }\n    }\n    i++;\n  }\n\n  return ret;\n}\n"]}

package/lib/helpers.js

@@ -6,14 +6,47 @@
  * the JSII compiler to test something need to share this code, so might as
  * well put it in one reusable place.
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TestWorkspace = exports.ASSEMBLY_FEATURES_SUPPORTED = void 0;
 exports.sourceToAssemblyHelper = sourceToAssemblyHelper;
 exports.compileJsiiForTest = compileJsiiForTest;
 exports.normalizeConfigPath = normalizeConfigPath;
-const fs = require("node:fs");
-const os = require("node:os");
-const path = require("node:path");
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
 const spec_1 = require("@jsii/spec");
 const typescript_1 = require("typescript");
 const compiler_1 = require("./compiler");
@@ -175,6 +208,7 @@ function isOptionsObject(x) {
  * An NPM-ready workspace where we can install test-compile dependencies and compile new assemblies
  */
 class TestWorkspace {
+    rootDirectory;
     /**
      * Create a new workspace.
      *
@@ -197,9 +231,9 @@ class TestWorkspace {
             ws.cleanup();
         }
     }
+    installed = new Set();
     constructor(rootDirectory) {
         this.rootDirectory = rootDirectory;
-        this.installed = new Set();
     }
     /**
      * Add a test-compiled jsii assembly as a dependency

package/lib/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAoCH,wDASC;AA4DD,gDAsFC;AA2MD,kDAKC;AA7YD,8BAA8B;AAC9B,8BAA8B;AAC9B,kCAAkC;AAClC,qCAA8E;AAE9E,2CAA4D;AAE5D,yCAAuD;AACvD,iDAA8D;AAC9D,mCAAsD;AAUtD;;GAEG;AACU,QAAA,2BAA2B,GAAuB,CAAC,oBAAoB,EAAE,2BAA2B,CAAC,CAAC;AAEnH;;;;;;;;;GASG;AACH,SAAgB,sBAAsB,CACpC,MAAoC,EACpC,OAA+D;IAE/D,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC;AACzB,CAAC;AAkDD;;;;;;;;;GASG;AACH,SAAgB,kBAAkB,CAChC,MAA+D,EAC/D,OAA0C,EAC1C,eAAgE;IAEhE,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,cAAc,GAClB,eAAe,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAElH,oFAAoF;IACpF,+EAA+E;IAC/E,OAAO,cAAc,CAAC,GAAG,EAAE;QACzB,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACzD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,eAAe,CAClD,UAAU,EACV,OAAO,OAAO,KAAK,UAAU;YAC3B,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE;gBACL,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,WAAW,IAAI,OAAO,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC;YACxE,CAAC,CACN,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,mBAAQ,CAAC;YAC5B,WAAW;YACX,GAAG,eAAe;SACnB,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,+BAAkB,CAAC,KAAK,CAAC,CAAC;QAE7F,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,EAAE,kBAAkB,EAAE,CAAC;YAChE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CAAC,IAAA,wBAAgB,EAAC,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;gBAChE,yEAAyE;YAC3E,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;YAChD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,EAAE,kBAAkB,EAAE,CAAC;gBAC/D,OAAO;oBACL,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,UAAU,CAAC,WAAW;iBACD,CAAC;YACvC,CAAC;YACD,MAAM,IAAI,iBAAS,CAAC,4BAA4B,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,QAAQ,GAAG,IAAA,2BAAoB,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,mCAA2B,CAAC,CAAC;QACzF,MAAM,KAAK,GAA2B,EAAE,CAAC;QAEzC,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3C,IAAI,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC9C,IAAI,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACjD,IAAI,WAAW,CAAC,GAAG,EAAE,MAAM,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;gBACxD,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACnD,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACvD,CAAC;YAED,4CAA4C;YAC5C,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/D,4CAA4C;YAC5C,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAEjE,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;YAC7C,IAAI,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACpC,4CAA4C;gBAC5C,KAAK,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE;oBAC1D,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,SAAS;YACf,QAAQ;YACR,KAAK;YACL,WAAW;YACX,gBAAgB,EAAE,eAAe,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;YACrF,WAAW,EAAE,UAAU,CAAC,WAAW;SACF,CAAC;IACtC,CAAC,CAAuB,CAAC;AAC3B,CAAC;AAMD,SAAS,SAAS,CAAI,KAAc;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC;IACpB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,6EAA6E;IAC7E,OAAO,CAAoB,KAAc,EAAK,EAAE;QAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC;YACH,OAAO,KAAK,EAAE,CAAC;QACjB,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,eAAe,CACtB,KAAa,EACb,EAA+B;IAE/B,MAAM,WAAW,GAAgB;QAC/B,KAAK;QACL,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,OAAO,CAAC;QAChD,IAAI,EAAE,SAAS,EAAE,uDAAuD;QACxE,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QAC5B,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,iCAAiC,EAAE;QACnE,IAAI,EAAE,EAAE;KACT,CAAC;IAEF,IAAI,EAAE,EAAE,CAAC;QACP,EAAE,CAAC,WAAW,CAAC,CAAC;IAClB,CAAC;IAED,EAAE,CAAC,aAAa,CACd,cAAc,EACd,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAS,EAAE,CAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EACxD,OAAO,CACR,CAAC;IAEF,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,8BAAe,EAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AACtC,CAAC;AAqCD,SAAS,eAAe,CACtB,CAAoE;IAEpE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAa,aAAa;IACxB;;;;OAIG;IACI,MAAM,CAAC,MAAM;QAClB,MAAM,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;QAC5E,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,aAAa,CAAI,KAA+B;QAC5D,MAAM,EAAE,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,OAAO,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAID,YAAoC,aAAqB;QAArB,kBAAa,GAAb,aAAa,CAAQ;QAFxC,cAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEa,CAAC;IAE7D;;OAEG;IACI,aAAa,CAAC,kBAAwC;QAC3D,IAAI,kBAAkB,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,IAAI,iBAAS,CAAC,oDAAoD,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,iBAAS,CACjB,2BAA2B,kBAAkB,CAAC,QAAQ,CAAC,IAAI,qDAAqD,CACjH,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAErD,+EAA+E;QAC/E,0EAA0E;QAC1E,kEAAkE;QAClE,EAAE;QACF,qEAAqE;QACrE,6BAA6B;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,EAAE,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/F,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1C,IAAA,oBAAa,EAAC,MAAM,EAAE,kBAAkB,CAAC,QAAQ,EAAE;YACjD,QAAQ,EAAE,kBAAkB,CAAC,gBAAgB;SAC9C,CAAC,CAAC;QACH,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EACjC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EACvD,OAAO,CACR,CAAC;QAEF,KAAK,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAChF,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE;gBACtD,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;YACH,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAEM,aAAa,CAAC,IAAY;QAC/B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,iBAAS,CAAC,4BAA4B,IAAI,sBAAsB,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IAC7D,CAAC;IAEM,OAAO;QACZ,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;CACF;AA/ED,sCA+EC;AAKD;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CAAC,IAAY,EAAE,eAAwB;IACxE,IAAI,eAAe,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACjE,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;AAC9C,CAAC","sourcesContent":["/**\n * Helper routines for use with the jsii compiler\n *\n * These are mostly used for testing, but all projects that need to exercise\n * the JSII compiler to test something need to share this code, so might as\n * well put it in one reusable place.\n */\n\nimport * as fs from 'node:fs';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\nimport { PackageJson, loadAssemblyFromPath, writeAssembly } from '@jsii/spec';\nimport * as spec from '@jsii/spec';\nimport { Diagnostic, DiagnosticCategory } from 'typescript';\n\nimport { Compiler, CompilerOptions } from './compiler';\nimport { loadProjectInfo, ProjectInfo } from './project-info';\nimport { formatDiagnostic, JsiiError } from './utils';\n\n/**\n * A set of source files for `sourceToAssemblyHelper`, at least containing 'index.ts'\n */\nexport type MultipleSourceFiles = {\n  'index.ts': string;\n  [name: string]: string;\n};\n\n/**\n * Assembly features supported by this compiler\n */\nexport const ASSEMBLY_FEATURES_SUPPORTED: spec.JsiiFeature[] = ['intersection-types', 'class-covariant-overrides'];\n\n/**\n * Compile a piece of source and return the JSII assembly for it\n *\n * Only usable for trivial cases and tests.\n *\n * @param source can either be a single `string` (the content of `index.ts`), or\n *               a map of fileName to content, which *must* include `index.ts`.\n * @param options accepts a callback for historical reasons but really expects to\n *                take an options object.\n */\nexport function sourceToAssemblyHelper(\n  source: string | MultipleSourceFiles,\n  options?: TestCompilationOptions | ((obj: PackageJson) => void),\n): spec.Assembly {\n  const result = compileJsiiForTest(source, options);\n  if (result.type !== 'success') {\n    throw new Error('Compilation failed');\n  }\n  return result.assembly;\n}\n\nexport type HelperCompilationOut = HelperCompilationResult | HelperCompilationFailure;\n\n/**\n * Successful output of a compilation command (for testing)\n *\n * A better name would have been `HelperCompilationSuccess`, but the name is part of\n * the public API surface, so we keep it like this.\n */\nexport interface HelperCompilationResult {\n  readonly type: 'success';\n\n  /**\n   * The generated assembly\n   */\n  readonly assembly: spec.Assembly;\n\n  /**\n   * Generated .js/.d.ts file(s)\n   */\n  readonly files: Record<string, string>;\n\n  /**\n   * The packageInfo used\n   */\n  readonly packageJson: PackageJson;\n\n  /**\n   * Whether to compress the assembly file\n   */\n  readonly compressAssembly: boolean;\n\n  /**\n   * Diagnostics that occurred during compilation\n   */\n  readonly diagnostics: readonly Diagnostic[];\n}\n\nexport interface HelperCompilationFailure {\n  readonly type: 'failure';\n\n  /**\n   * Diagnostics that occurred during compilation\n   *\n   * Contains at least one error.\n   */\n  readonly diagnostics: readonly Diagnostic[];\n}\n\n/**\n * Compile a piece of source and return the assembly and compiled sources for it\n *\n * Only usable for trivial cases and tests.\n *\n * @param source can either be a single `string` (the content of `index.ts`), or\n *               a map of fileName to content, which *must* include `index.ts`.\n * @param options accepts a callback for historical reasons but really expects to\n *                take an options object.\n */\nexport function compileJsiiForTest<O extends TestCompilationOptions>(\n  source: string | { 'index.ts': string; [name: string]: string },\n  options?: O | ((obj: PackageJson) => void),\n  compilerOptions?: Omit<CompilerOptions, 'projectInfo' | 'watch'>,\n): ResultOrSuccess<O> {\n  if (typeof source === 'string') {\n    source = { 'index.ts': source };\n  }\n\n  const inSomeLocation =\n    isOptionsObject(options) && options.compilationDirectory ? inOtherDir(options.compilationDirectory) : inTempDir;\n\n  // Easiest way to get the source into the compiler is to write it to disk somewhere.\n  // I guess we could make an in-memory compiler host but that seems like work...\n  return inSomeLocation(() => {\n    for (const [fileName, content] of Object.entries(source)) {\n      fs.mkdirSync(path.dirname(fileName), { recursive: true });\n      fs.writeFileSync(fileName, content, { encoding: 'utf-8' });\n    }\n    const { projectInfo, packageJson } = makeProjectInfo(\n      'index.ts',\n      typeof options === 'function'\n        ? options\n        : (pi) => {\n            Object.assign(pi, options?.packageJson ?? options?.projectInfo ?? {});\n          },\n    );\n    const compiler = new Compiler({\n      projectInfo,\n      ...compilerOptions,\n    });\n    const emitResult = compiler.emit();\n\n    const errors = emitResult.diagnostics.filter((d) => d.category === DiagnosticCategory.Error);\n\n    if (typeof options !== 'object' || !options?.captureDiagnostics) {\n      for (const error of errors) {\n        console.error(formatDiagnostic(error, projectInfo.projectRoot));\n        // logDiagnostic() doesn't work out of the box, so console.error() it is.\n      }\n    }\n\n    if (errors.length > 0 || emitResult.emitSkipped) {\n      if (typeof options === 'object' && options?.captureDiagnostics) {\n        return {\n          type: 'failure',\n          diagnostics: emitResult.diagnostics,\n        } satisfies HelperCompilationFailure;\n      }\n      throw new JsiiError('There were compiler errors');\n    }\n\n    const assembly = loadAssemblyFromPath(process.cwd(), false, ASSEMBLY_FEATURES_SUPPORTED);\n    const files: Record<string, string> = {};\n\n    for (const filename of Object.keys(source)) {\n      let jsFile = filename.replace(/\\.ts$/, '.js');\n      let dtsFile = filename.replace(/\\.ts$/, '.d.ts');\n      if (projectInfo.tsc?.outDir && filename !== 'README.md') {\n        jsFile = path.join(projectInfo.tsc.outDir, jsFile);\n        dtsFile = path.join(projectInfo.tsc.outDir, dtsFile);\n      }\n\n      // eslint-disable-next-line no-await-in-loop\n      files[jsFile] = fs.readFileSync(jsFile, { encoding: 'utf-8' });\n      // eslint-disable-next-line no-await-in-loop\n      files[dtsFile] = fs.readFileSync(dtsFile, { encoding: 'utf-8' });\n\n      const warningsFileName = '.warnings.jsii.js';\n      if (fs.existsSync(warningsFileName)) {\n        // eslint-disable-next-line no-await-in-loop\n        files[warningsFileName] = fs.readFileSync(warningsFileName, {\n          encoding: 'utf-8',\n        });\n      }\n    }\n\n    return {\n      type: 'success',\n      assembly,\n      files,\n      packageJson,\n      compressAssembly: isOptionsObject(options) && options.compressAssembly ? true : false,\n      diagnostics: emitResult.diagnostics,\n    } satisfies HelperCompilationResult;\n  }) as ResultOrSuccess<O>;\n}\n\ntype ResultOrSuccess<O extends TestCompilationOptions> = O['captureDiagnostics'] extends true\n  ? HelperCompilationOut\n  : HelperCompilationResult;\n\nfunction inTempDir<T>(block: () => T): T {\n  const origDir = process.cwd();\n  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'jsii'));\n  process.chdir(tmpDir);\n  const ret = block();\n  process.chdir(origDir);\n  fs.rmSync(tmpDir, { force: true, recursive: true });\n  return ret;\n}\n\nfunction inOtherDir(dir: string) {\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-constraint\n  return <T extends unknown>(block: () => T): T => {\n    const origDir = process.cwd();\n    process.chdir(dir);\n    try {\n      return block();\n    } finally {\n      process.chdir(origDir);\n    }\n  };\n}\n\n/**\n * Obtain project info so we can call the compiler\n *\n * Creating this directly in-memory leads to slightly different behavior from calling\n * jsii from the command-line, and I don't want to figure out right now.\n *\n * Most consistent behavior seems to be to write a package.json to disk and\n * then calling the same functions as the CLI would.\n */\nfunction makeProjectInfo(\n  types: string,\n  cb?: (obj: PackageJson) => void,\n): { projectInfo: ProjectInfo; packageJson: PackageJson } {\n  const packageJson: PackageJson = {\n    types,\n    main: types.replace(/(?:\\.d)?\\.ts(x?)/, '.js$1'),\n    name: 'testpkg', // That's what package.json would tell if we look up...\n    version: '0.0.1',\n    license: 'Apache-2.0',\n    author: { name: 'John Doe' },\n    repository: { type: 'git', url: 'https://github.com/aws/jsii.git' },\n    jsii: {},\n  };\n\n  if (cb) {\n    cb(packageJson);\n  }\n\n  fs.writeFileSync(\n    'package.json',\n    JSON.stringify(packageJson, (_: string, v: any) => v, 2),\n    'utf-8',\n  );\n\n  const { projectInfo } = loadProjectInfo(path.resolve(process.cwd(), '.'));\n  return { projectInfo, packageJson };\n}\n\nexport interface TestCompilationOptions {\n  /**\n   * The directory in which we write and compile the files\n   */\n  readonly compilationDirectory?: string;\n\n  /**\n   * Parts of projectInfo to override (package name etc)\n   *\n   * @deprecated Prefer using `packageJson` instead.\n   */\n  readonly projectInfo?: Partial<PackageJson>;\n\n  /**\n   * Parts of projectInfo to override (package name etc)\n   *\n   * @default - Use some default values\n   */\n  readonly packageJson?: Partial<PackageJson>;\n\n  /**\n   * Whether to compress the assembly file.\n   *\n   * @default false\n   */\n  readonly compressAssembly?: boolean;\n\n  /**\n   * Whether or not to print the diagnostics\n   *\n   * @default false\n   */\n  readonly captureDiagnostics?: boolean;\n}\n\nfunction isOptionsObject(\n  x: TestCompilationOptions | ((obj: PackageJson) => void) | undefined,\n): x is TestCompilationOptions {\n  return x ? typeof x === 'object' : false;\n}\n\n/**\n * An NPM-ready workspace where we can install test-compile dependencies and compile new assemblies\n */\nexport class TestWorkspace {\n  /**\n   * Create a new workspace.\n   *\n   * Creates a temporary directory, don't forget to call cleanUp\n   */\n  public static create(): TestWorkspace {\n    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'jsii-testworkspace'));\n    fs.mkdirSync(tmpDir, { recursive: true });\n    return new TestWorkspace(tmpDir);\n  }\n\n  /**\n   * Execute a block with a temporary workspace\n   */\n  public static withWorkspace<A>(block: (ws: TestWorkspace) => A): A {\n    const ws = TestWorkspace.create();\n    try {\n      return block(ws);\n    } finally {\n      ws.cleanup();\n    }\n  }\n\n  private readonly installed = new Set<string>();\n\n  private constructor(public readonly rootDirectory: string) {}\n\n  /**\n   * Add a test-compiled jsii assembly as a dependency\n   */\n  public addDependency(dependencyAssembly: HelperCompilationOut) {\n    if (dependencyAssembly.type !== 'success') {\n      throw new JsiiError('Cannot add dependency: assembly compilation failed');\n    }\n\n    if (this.installed.has(dependencyAssembly.assembly.name)) {\n      throw new JsiiError(\n        `A dependency with name '${dependencyAssembly.assembly.name}' was already installed. Give one a different name.`,\n      );\n    }\n    this.installed.add(dependencyAssembly.assembly.name);\n\n    // The following is silly, however: the helper has compiled the given source to\n    // an assembly, and output files, and then removed their traces from disk.\n    // We need those files back on disk, so write them back out again.\n    //\n    // We will drop them in 'node_modules/<name>' so they can be imported\n    // as if they were installed.\n    const modDir = path.join(this.rootDirectory, 'node_modules', dependencyAssembly.assembly.name);\n    fs.mkdirSync(modDir, { recursive: true });\n\n    writeAssembly(modDir, dependencyAssembly.assembly, {\n      compress: dependencyAssembly.compressAssembly,\n    });\n    fs.writeFileSync(\n      path.join(modDir, 'package.json'),\n      JSON.stringify(dependencyAssembly.packageJson, null, 2),\n      'utf-8',\n    );\n\n    for (const [fileName, fileContents] of Object.entries(dependencyAssembly.files)) {\n      fs.mkdirSync(path.dirname(path.join(modDir, fileName)), {\n        recursive: true,\n      });\n      fs.writeFileSync(path.join(modDir, fileName), fileContents);\n    }\n  }\n\n  public dependencyDir(name: string) {\n    if (!this.installed.has(name)) {\n      throw new JsiiError(`No dependency with name '${name}' has been installed`);\n    }\n    return path.join(this.rootDirectory, 'node_modules', name);\n  }\n\n  public cleanup() {\n    fs.rmSync(this.rootDirectory, { force: true, recursive: true });\n  }\n}\n\n// Alias for backwards compatibility\nexport type PackageInfo = PackageJson;\n\n/**\n * TSConfig paths can either be relative to the project or absolute.\n * This function normalizes paths to be relative to the provided root.\n * After normalization, code using these paths can be much simpler.\n *\n * @param root the project root\n * @param pathToNormalize the path to normalize, might be empty\n */\nexport function normalizeConfigPath(root: string, pathToNormalize?: string): string | undefined {\n  if (pathToNormalize == null || !path.isAbsolute(pathToNormalize)) {\n    return pathToNormalize;\n  }\n  return path.relative(root, pathToNormalize);\n}\n"]}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCH,wDASC;AA4DD,gDAsFC;AA2MD,kDAKC;AA7YD,4CAA8B;AAC9B,4CAA8B;AAC9B,gDAAkC;AAClC,qCAA8E;AAE9E,2CAA4D;AAE5D,yCAAuD;AACvD,iDAA8D;AAC9D,mCAAsD;AAUtD;;GAEG;AACU,QAAA,2BAA2B,GAAuB,CAAC,oBAAoB,EAAE,2BAA2B,CAAC,CAAC;AAEnH;;;;;;;;;GASG;AACH,SAAgB,sBAAsB,CACpC,MAAoC,EACpC,OAA+D;IAE/D,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC;AACzB,CAAC;AAkDD;;;;;;;;;GASG;AACH,SAAgB,kBAAkB,CAChC,MAA+D,EAC/D,OAA0C,EAC1C,eAAgE;IAEhE,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,cAAc,GAClB,eAAe,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAElH,oFAAoF;IACpF,+EAA+E;IAC/E,OAAO,cAAc,CAAC,GAAG,EAAE;QACzB,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACzD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,eAAe,CAClD,UAAU,EACV,OAAO,OAAO,KAAK,UAAU;YAC3B,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE;gBACL,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,WAAW,IAAI,OAAO,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC;YACxE,CAAC,CACN,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,mBAAQ,CAAC;YAC5B,WAAW;YACX,GAAG,eAAe;SACnB,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,+BAAkB,CAAC,KAAK,CAAC,CAAC;QAE7F,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,EAAE,kBAAkB,EAAE,CAAC;YAChE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CAAC,IAAA,wBAAgB,EAAC,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;gBAChE,yEAAyE;YAC3E,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;YAChD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,EAAE,kBAAkB,EAAE,CAAC;gBAC/D,OAAO;oBACL,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,UAAU,CAAC,WAAW;iBACD,CAAC;YACvC,CAAC;YACD,MAAM,IAAI,iBAAS,CAAC,4BAA4B,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,QAAQ,GAAG,IAAA,2BAAoB,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,mCAA2B,CAAC,CAAC;QACzF,MAAM,KAAK,GAA2B,EAAE,CAAC;QAEzC,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3C,IAAI,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC9C,IAAI,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACjD,IAAI,WAAW,CAAC,GAAG,EAAE,MAAM,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;gBACxD,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACnD,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACvD,CAAC;YAED,4CAA4C;YAC5C,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/D,4CAA4C;YAC5C,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAEjE,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;YAC7C,IAAI,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACpC,4CAA4C;gBAC5C,KAAK,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE;oBAC1D,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,SAAS;YACf,QAAQ;YACR,KAAK;YACL,WAAW;YACX,gBAAgB,EAAE,eAAe,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;YACrF,WAAW,EAAE,UAAU,CAAC,WAAW;SACF,CAAC;IACtC,CAAC,CAAuB,CAAC;AAC3B,CAAC;AAMD,SAAS,SAAS,CAAI,KAAc;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC;IACpB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,6EAA6E;IAC7E,OAAO,CAAoB,KAAc,EAAK,EAAE;QAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC;YACH,OAAO,KAAK,EAAE,CAAC;QACjB,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,eAAe,CACtB,KAAa,EACb,EAA+B;IAE/B,MAAM,WAAW,GAAgB;QAC/B,KAAK;QACL,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,OAAO,CAAC;QAChD,IAAI,EAAE,SAAS,EAAE,uDAAuD;QACxE,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QAC5B,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,iCAAiC,EAAE;QACnE,IAAI,EAAE,EAAE;KACT,CAAC;IAEF,IAAI,EAAE,EAAE,CAAC;QACP,EAAE,CAAC,WAAW,CAAC,CAAC;IAClB,CAAC;IAED,EAAE,CAAC,aAAa,CACd,cAAc,EACd,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAS,EAAE,CAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EACxD,OAAO,CACR,CAAC;IAEF,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,8BAAe,EAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AACtC,CAAC;AAqCD,SAAS,eAAe,CACtB,CAAoE;IAEpE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAa,aAAa;IA0BY;IAzBpC;;;;OAIG;IACI,MAAM,CAAC,MAAM;QAClB,MAAM,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;QAC5E,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,aAAa,CAAI,KAA+B;QAC5D,MAAM,EAAE,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,OAAO,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAEgB,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/C,YAAoC,aAAqB;QAArB,kBAAa,GAAb,aAAa,CAAQ;IAAG,CAAC;IAE7D;;OAEG;IACI,aAAa,CAAC,kBAAwC;QAC3D,IAAI,kBAAkB,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,IAAI,iBAAS,CAAC,oDAAoD,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,iBAAS,CACjB,2BAA2B,kBAAkB,CAAC,QAAQ,CAAC,IAAI,qDAAqD,CACjH,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAErD,+EAA+E;QAC/E,0EAA0E;QAC1E,kEAAkE;QAClE,EAAE;QACF,qEAAqE;QACrE,6BAA6B;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,EAAE,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/F,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1C,IAAA,oBAAa,EAAC,MAAM,EAAE,kBAAkB,CAAC,QAAQ,EAAE;YACjD,QAAQ,EAAE,kBAAkB,CAAC,gBAAgB;SAC9C,CAAC,CAAC;QACH,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EACjC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EACvD,OAAO,CACR,CAAC;QAEF,KAAK,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAChF,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE;gBACtD,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;YACH,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAEM,aAAa,CAAC,IAAY;QAC/B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,iBAAS,CAAC,4BAA4B,IAAI,sBAAsB,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IAC7D,CAAC;IAEM,OAAO;QACZ,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;CACF;AA/ED,sCA+EC;AAKD;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CAAC,IAAY,EAAE,eAAwB;IACxE,IAAI,eAAe,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACjE,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;AAC9C,CAAC","sourcesContent":["/**\n * Helper routines for use with the jsii compiler\n *\n * These are mostly used for testing, but all projects that need to exercise\n * the JSII compiler to test something need to share this code, so might as\n * well put it in one reusable place.\n */\n\nimport * as fs from 'node:fs';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\nimport { PackageJson, loadAssemblyFromPath, writeAssembly } from '@jsii/spec';\nimport * as spec from '@jsii/spec';\nimport { Diagnostic, DiagnosticCategory } from 'typescript';\n\nimport { Compiler, CompilerOptions } from './compiler';\nimport { loadProjectInfo, ProjectInfo } from './project-info';\nimport { formatDiagnostic, JsiiError } from './utils';\n\n/**\n * A set of source files for `sourceToAssemblyHelper`, at least containing 'index.ts'\n */\nexport type MultipleSourceFiles = {\n  'index.ts': string;\n  [name: string]: string;\n};\n\n/**\n * Assembly features supported by this compiler\n */\nexport const ASSEMBLY_FEATURES_SUPPORTED: spec.JsiiFeature[] = ['intersection-types', 'class-covariant-overrides'];\n\n/**\n * Compile a piece of source and return the JSII assembly for it\n *\n * Only usable for trivial cases and tests.\n *\n * @param source can either be a single `string` (the content of `index.ts`), or\n *               a map of fileName to content, which *must* include `index.ts`.\n * @param options accepts a callback for historical reasons but really expects to\n *                take an options object.\n */\nexport function sourceToAssemblyHelper(\n  source: string | MultipleSourceFiles,\n  options?: TestCompilationOptions | ((obj: PackageJson) => void),\n): spec.Assembly {\n  const result = compileJsiiForTest(source, options);\n  if (result.type !== 'success') {\n    throw new Error('Compilation failed');\n  }\n  return result.assembly;\n}\n\nexport type HelperCompilationOut = HelperCompilationResult | HelperCompilationFailure;\n\n/**\n * Successful output of a compilation command (for testing)\n *\n * A better name would have been `HelperCompilationSuccess`, but the name is part of\n * the public API surface, so we keep it like this.\n */\nexport interface HelperCompilationResult {\n  readonly type: 'success';\n\n  /**\n   * The generated assembly\n   */\n  readonly assembly: spec.Assembly;\n\n  /**\n   * Generated .js/.d.ts file(s)\n   */\n  readonly files: Record<string, string>;\n\n  /**\n   * The packageInfo used\n   */\n  readonly packageJson: PackageJson;\n\n  /**\n   * Whether to compress the assembly file\n   */\n  readonly compressAssembly: boolean;\n\n  /**\n   * Diagnostics that occurred during compilation\n   */\n  readonly diagnostics: readonly Diagnostic[];\n}\n\nexport interface HelperCompilationFailure {\n  readonly type: 'failure';\n\n  /**\n   * Diagnostics that occurred during compilation\n   *\n   * Contains at least one error.\n   */\n  readonly diagnostics: readonly Diagnostic[];\n}\n\n/**\n * Compile a piece of source and return the assembly and compiled sources for it\n *\n * Only usable for trivial cases and tests.\n *\n * @param source can either be a single `string` (the content of `index.ts`), or\n *               a map of fileName to content, which *must* include `index.ts`.\n * @param options accepts a callback for historical reasons but really expects to\n *                take an options object.\n */\nexport function compileJsiiForTest<O extends TestCompilationOptions>(\n  source: string | { 'index.ts': string; [name: string]: string },\n  options?: O | ((obj: PackageJson) => void),\n  compilerOptions?: Omit<CompilerOptions, 'projectInfo' | 'watch'>,\n): ResultOrSuccess<O> {\n  if (typeof source === 'string') {\n    source = { 'index.ts': source };\n  }\n\n  const inSomeLocation =\n    isOptionsObject(options) && options.compilationDirectory ? inOtherDir(options.compilationDirectory) : inTempDir;\n\n  // Easiest way to get the source into the compiler is to write it to disk somewhere.\n  // I guess we could make an in-memory compiler host but that seems like work...\n  return inSomeLocation(() => {\n    for (const [fileName, content] of Object.entries(source)) {\n      fs.mkdirSync(path.dirname(fileName), { recursive: true });\n      fs.writeFileSync(fileName, content, { encoding: 'utf-8' });\n    }\n    const { projectInfo, packageJson } = makeProjectInfo(\n      'index.ts',\n      typeof options === 'function'\n        ? options\n        : (pi) => {\n            Object.assign(pi, options?.packageJson ?? options?.projectInfo ?? {});\n          },\n    );\n    const compiler = new Compiler({\n      projectInfo,\n      ...compilerOptions,\n    });\n    const emitResult = compiler.emit();\n\n    const errors = emitResult.diagnostics.filter((d) => d.category === DiagnosticCategory.Error);\n\n    if (typeof options !== 'object' || !options?.captureDiagnostics) {\n      for (const error of errors) {\n        console.error(formatDiagnostic(error, projectInfo.projectRoot));\n        // logDiagnostic() doesn't work out of the box, so console.error() it is.\n      }\n    }\n\n    if (errors.length > 0 || emitResult.emitSkipped) {\n      if (typeof options === 'object' && options?.captureDiagnostics) {\n        return {\n          type: 'failure',\n          diagnostics: emitResult.diagnostics,\n        } satisfies HelperCompilationFailure;\n      }\n      throw new JsiiError('There were compiler errors');\n    }\n\n    const assembly = loadAssemblyFromPath(process.cwd(), false, ASSEMBLY_FEATURES_SUPPORTED);\n    const files: Record<string, string> = {};\n\n    for (const filename of Object.keys(source)) {\n      let jsFile = filename.replace(/\\.ts$/, '.js');\n      let dtsFile = filename.replace(/\\.ts$/, '.d.ts');\n      if (projectInfo.tsc?.outDir && filename !== 'README.md') {\n        jsFile = path.join(projectInfo.tsc.outDir, jsFile);\n        dtsFile = path.join(projectInfo.tsc.outDir, dtsFile);\n      }\n\n      // eslint-disable-next-line no-await-in-loop\n      files[jsFile] = fs.readFileSync(jsFile, { encoding: 'utf-8' });\n      // eslint-disable-next-line no-await-in-loop\n      files[dtsFile] = fs.readFileSync(dtsFile, { encoding: 'utf-8' });\n\n      const warningsFileName = '.warnings.jsii.js';\n      if (fs.existsSync(warningsFileName)) {\n        // eslint-disable-next-line no-await-in-loop\n        files[warningsFileName] = fs.readFileSync(warningsFileName, {\n          encoding: 'utf-8',\n        });\n      }\n    }\n\n    return {\n      type: 'success',\n      assembly,\n      files,\n      packageJson,\n      compressAssembly: isOptionsObject(options) && options.compressAssembly ? true : false,\n      diagnostics: emitResult.diagnostics,\n    } satisfies HelperCompilationResult;\n  }) as ResultOrSuccess<O>;\n}\n\ntype ResultOrSuccess<O extends TestCompilationOptions> = O['captureDiagnostics'] extends true\n  ? HelperCompilationOut\n  : HelperCompilationResult;\n\nfunction inTempDir<T>(block: () => T): T {\n  const origDir = process.cwd();\n  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'jsii'));\n  process.chdir(tmpDir);\n  const ret = block();\n  process.chdir(origDir);\n  fs.rmSync(tmpDir, { force: true, recursive: true });\n  return ret;\n}\n\nfunction inOtherDir(dir: string) {\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-constraint\n  return <T extends unknown>(block: () => T): T => {\n    const origDir = process.cwd();\n    process.chdir(dir);\n    try {\n      return block();\n    } finally {\n      process.chdir(origDir);\n    }\n  };\n}\n\n/**\n * Obtain project info so we can call the compiler\n *\n * Creating this directly in-memory leads to slightly different behavior from calling\n * jsii from the command-line, and I don't want to figure out right now.\n *\n * Most consistent behavior seems to be to write a package.json to disk and\n * then calling the same functions as the CLI would.\n */\nfunction makeProjectInfo(\n  types: string,\n  cb?: (obj: PackageJson) => void,\n): { projectInfo: ProjectInfo; packageJson: PackageJson } {\n  const packageJson: PackageJson = {\n    types,\n    main: types.replace(/(?:\\.d)?\\.ts(x?)/, '.js$1'),\n    name: 'testpkg', // That's what package.json would tell if we look up...\n    version: '0.0.1',\n    license: 'Apache-2.0',\n    author: { name: 'John Doe' },\n    repository: { type: 'git', url: 'https://github.com/aws/jsii.git' },\n    jsii: {},\n  };\n\n  if (cb) {\n    cb(packageJson);\n  }\n\n  fs.writeFileSync(\n    'package.json',\n    JSON.stringify(packageJson, (_: string, v: any) => v, 2),\n    'utf-8',\n  );\n\n  const { projectInfo } = loadProjectInfo(path.resolve(process.cwd(), '.'));\n  return { projectInfo, packageJson };\n}\n\nexport interface TestCompilationOptions {\n  /**\n   * The directory in which we write and compile the files\n   */\n  readonly compilationDirectory?: string;\n\n  /**\n   * Parts of projectInfo to override (package name etc)\n   *\n   * @deprecated Prefer using `packageJson` instead.\n   */\n  readonly projectInfo?: Partial<PackageJson>;\n\n  /**\n   * Parts of projectInfo to override (package name etc)\n   *\n   * @default - Use some default values\n   */\n  readonly packageJson?: Partial<PackageJson>;\n\n  /**\n   * Whether to compress the assembly file.\n   *\n   * @default false\n   */\n  readonly compressAssembly?: boolean;\n\n  /**\n   * Whether or not to print the diagnostics\n   *\n   * @default false\n   */\n  readonly captureDiagnostics?: boolean;\n}\n\nfunction isOptionsObject(\n  x: TestCompilationOptions | ((obj: PackageJson) => void) | undefined,\n): x is TestCompilationOptions {\n  return x ? typeof x === 'object' : false;\n}\n\n/**\n * An NPM-ready workspace where we can install test-compile dependencies and compile new assemblies\n */\nexport class TestWorkspace {\n  /**\n   * Create a new workspace.\n   *\n   * Creates a temporary directory, don't forget to call cleanUp\n   */\n  public static create(): TestWorkspace {\n    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'jsii-testworkspace'));\n    fs.mkdirSync(tmpDir, { recursive: true });\n    return new TestWorkspace(tmpDir);\n  }\n\n  /**\n   * Execute a block with a temporary workspace\n   */\n  public static withWorkspace<A>(block: (ws: TestWorkspace) => A): A {\n    const ws = TestWorkspace.create();\n    try {\n      return block(ws);\n    } finally {\n      ws.cleanup();\n    }\n  }\n\n  private readonly installed = new Set<string>();\n\n  private constructor(public readonly rootDirectory: string) {}\n\n  /**\n   * Add a test-compiled jsii assembly as a dependency\n   */\n  public addDependency(dependencyAssembly: HelperCompilationOut) {\n    if (dependencyAssembly.type !== 'success') {\n      throw new JsiiError('Cannot add dependency: assembly compilation failed');\n    }\n\n    if (this.installed.has(dependencyAssembly.assembly.name)) {\n      throw new JsiiError(\n        `A dependency with name '${dependencyAssembly.assembly.name}' was already installed. Give one a different name.`,\n      );\n    }\n    this.installed.add(dependencyAssembly.assembly.name);\n\n    // The following is silly, however: the helper has compiled the given source to\n    // an assembly, and output files, and then removed their traces from disk.\n    // We need those files back on disk, so write them back out again.\n    //\n    // We will drop them in 'node_modules/<name>' so they can be imported\n    // as if they were installed.\n    const modDir = path.join(this.rootDirectory, 'node_modules', dependencyAssembly.assembly.name);\n    fs.mkdirSync(modDir, { recursive: true });\n\n    writeAssembly(modDir, dependencyAssembly.assembly, {\n      compress: dependencyAssembly.compressAssembly,\n    });\n    fs.writeFileSync(\n      path.join(modDir, 'package.json'),\n      JSON.stringify(dependencyAssembly.packageJson, null, 2),\n      'utf-8',\n    );\n\n    for (const [fileName, fileContents] of Object.entries(dependencyAssembly.files)) {\n      fs.mkdirSync(path.dirname(path.join(modDir, fileName)), {\n        recursive: true,\n      });\n      fs.writeFileSync(path.join(modDir, fileName), fileContents);\n    }\n  }\n\n  public dependencyDir(name: string) {\n    if (!this.installed.has(name)) {\n      throw new JsiiError(`No dependency with name '${name}' has been installed`);\n    }\n    return path.join(this.rootDirectory, 'node_modules', name);\n  }\n\n  public cleanup() {\n    fs.rmSync(this.rootDirectory, { force: true, recursive: true });\n  }\n}\n\n// Alias for backwards compatibility\nexport type PackageInfo = PackageJson;\n\n/**\n * TSConfig paths can either be relative to the project or absolute.\n * This function normalizes paths to be relative to the provided root.\n * After normalization, code using these paths can be much simpler.\n *\n * @param root the project root\n * @param pathToNormalize the path to normalize, might be empty\n */\nexport function normalizeConfigPath(root: string, pathToNormalize?: string): string | undefined {\n  if (pathToNormalize == null || !path.isAbsolute(pathToNormalize)) {\n    return pathToNormalize;\n  }\n  return path.relative(root, pathToNormalize);\n}\n"]}