@oicl-lit/analyzer 0.14.1

package/lib/model.js

@@ -0,0 +1,392 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+export class PackageInfo {
+    constructor(init) {
+        this.name = init.name;
+        this.rootDir = init.rootDir;
+        this.packageJson = init.packageJson;
+    }
+}
+export class Package extends PackageInfo {
+    constructor(init) {
+        super(init);
+        this.modules = init.modules;
+    }
+    /**
+     * Returns a list of modules in this package containing LitElement
+     * declarations, along with the filtered list of LitElementDeclarations.
+     */
+    getLitElementModules() {
+        const modules = [];
+        for (const module of this.modules) {
+            const declarations = module.declarations.filter((d) => d.isLitElementDeclaration());
+            if (declarations.length > 0) {
+                modules.push({
+                    module,
+                    declarations,
+                });
+            }
+        }
+        return modules;
+    }
+}
+export class Module {
+    constructor(init) {
+        /**
+         * Private storage for all declarations within this module, memoized
+         * in `get declarations()` getter.
+         */
+        this._declarations = undefined;
+        this.sourceFile = init.sourceFile;
+        this.sourcePath = init.sourcePath;
+        this.jsPath = init.jsPath;
+        this.packageJson = init.packageJson;
+        this._declarationMap = init.declarationMap;
+        this.dependencies = init.dependencies;
+        this._exportMap = init.exportMap;
+        this._finalizeExports = init.finalizeExports;
+        this.description = init.description;
+        this.summary = init.summary;
+        this.deprecated = init.deprecated;
+    }
+    /**
+     * Ensures the list of exports includes the names of all reexports
+     * from other modules.
+     */
+    _ensureExportsFinalized() {
+        if (this._finalizeExports !== undefined) {
+            this._finalizeExports();
+            this._finalizeExports = undefined;
+        }
+    }
+    /**
+     * Returns names of all exported declarations.
+     */
+    get exportNames() {
+        this._ensureExportsFinalized();
+        return Array.from(this._exportMap.keys());
+    }
+    /**
+     * Given an exported symbol name, returns a Declaration if it was
+     * defined in this module, or a Reference if it was imported from
+     * another module.
+     */
+    getExport(name) {
+        this._ensureExportsFinalized();
+        const exp = this._exportMap.get(name);
+        if (exp === undefined) {
+            throw new Error(`Module ${this.sourcePath} did not contain an export named ${name}`);
+        }
+        else if (exp instanceof Reference) {
+            return exp;
+        }
+        else {
+            return this.getDeclaration(exp);
+        }
+    }
+    /**
+     * Return Reference for given export name.
+     *
+     * For references to local declarations, the module will be undefined.
+     * For re-exports, the Reference will point to a package & module.
+     */
+    getExportReference(name) {
+        const exp = this.getExport(name);
+        if (exp instanceof Declaration) {
+            return new Reference({ name: exp.name, dereference: () => exp });
+        }
+        else {
+            return exp;
+        }
+    }
+    /**
+     * Given an exported symbol name, returns the concrete Declaration
+     * for that symbol, following it through any re-exports.
+     */
+    getResolvedExport(name) {
+        let exp = this.getExport(name);
+        while (exp instanceof Reference) {
+            exp = exp.dereference();
+        }
+        return exp;
+    }
+    /**
+     * Returns a `Declaration` model for the given name in top-level module scope.
+     *
+     * Note, the name is local to the module, and the declaration may be exported
+     * from with a different name. The declaration is always concrete, and will
+     * never be a `Reference`.
+     */
+    getDeclaration(name) {
+        let dec = this._declarationMap.get(name);
+        if (dec === undefined) {
+            throw new Error(`Module ${this.sourcePath} did not contain a declaration named ${name}`);
+        }
+        // Overwrite a factory with its output (a `Declaration` model) on first
+        // request
+        if (typeof dec === 'function') {
+            this._declarationMap.set(name, (dec = dec()));
+        }
+        return dec;
+    }
+    /**
+     * Returns a list of all Declarations locally defined in this module.
+     */
+    get declarations() {
+        return (this._declarations ??= Array.from(this._declarationMap.keys()).map((name) => this.getDeclaration(name)));
+    }
+    /**
+     * Returns all custom elements registered in this module.
+     */
+    getCustomElementExports() {
+        return this.declarations.filter((d) => d.isLitElementDeclaration() && d.tagname !== undefined);
+    }
+}
+export class Declaration {
+    constructor(init) {
+        this.name = init.name;
+        this.description = init.description;
+        this.summary = init.summary;
+        this.deprecated = init.deprecated;
+        this.node = init.node;
+    }
+    isVariableDeclaration() {
+        return this instanceof VariableDeclaration;
+    }
+    isClassDeclaration() {
+        return this instanceof ClassDeclaration;
+    }
+    isLitElementDeclaration() {
+        return this instanceof LitElementDeclaration;
+    }
+    isFunctionDeclaration() {
+        return this instanceof FunctionDeclaration;
+    }
+    isMixinDeclaration() {
+        return this instanceof MixinDeclaration;
+    }
+    isClassField() {
+        return this instanceof ClassField;
+    }
+    isClassMethod() {
+        return this instanceof ClassMethod;
+    }
+    isCustomElementDeclaration() {
+        return this instanceof CustomElementDeclaration;
+    }
+}
+export class VariableDeclaration extends Declaration {
+    constructor(init) {
+        super(init);
+        this.type = init.type;
+    }
+}
+export class FunctionDeclaration extends Declaration {
+    constructor(init) {
+        super(init);
+        this.parameters = init.parameters;
+        this.return = init.return;
+        this.overloads = init.overloads;
+    }
+}
+export class FunctionOverloadDeclaration extends FunctionDeclaration {
+    constructor(init) {
+        super(init);
+    }
+}
+export class ClassMethod extends FunctionDeclaration {
+    constructor(init) {
+        super(init);
+        this.static = init.static;
+        this.privacy = init.privacy;
+        this.inheritedFrom = init.inheritedFrom;
+        this.source = init.source;
+        this.node = init.node;
+    }
+}
+export class ClassField extends Declaration {
+    constructor(init) {
+        super(init);
+        this.static = init.static;
+        this.privacy = init.privacy;
+        this.inheritedFrom = init.inheritedFrom;
+        this.source = init.source;
+        this.type = init.type;
+        this.default = init.default;
+        this.readonly = init.readonly;
+    }
+}
+export class ClassDeclaration extends Declaration {
+    constructor(init) {
+        super(init);
+        this._heritage = undefined;
+        this.node = init.node;
+        this._getHeritage = init.getHeritage;
+        this._fieldMap = init.fieldMap ?? new Map();
+        this._staticFieldMap = init.staticFieldMap ?? new Map();
+        this._methodMap = init.methodMap ?? new Map();
+        this._staticMethodMap = init.staticMethodMap ?? new Map();
+    }
+    /**
+     * Returns this class's `ClassHeritage` model, with references to its
+     * `superClass` and `mixins`.
+     */
+    get heritage() {
+        return (this._heritage ??= this._getHeritage());
+    }
+    /**
+     * Returns iterator of the non-static `ClassField`s defined on the immediate
+     * class (excluding any inherited members).
+     */
+    get fields() {
+        return this._fieldMap.values();
+    }
+    /**
+     * Returns iterator of the static `ClassField`s defined on the immediate class
+     * (excluding any inherited members).
+     */
+    get staticFields() {
+        return this._staticFieldMap.values();
+    }
+    /**
+     * Returns iterator of the non-static `ClassMethod`s defined on the immediate
+     * class (excluding any inherited members).
+     */
+    get methods() {
+        return this._methodMap.values();
+    }
+    /**
+     * Returns iterator of the static `ClassMethod`s defined on the immediate
+     * class (excluding any inherited members).
+     */
+    get staticMethods() {
+        return this._staticMethodMap.values();
+    }
+    /**
+     * Returns a non-static `ClassField` model the given name defined on the
+     * immediate class (excluding any inherited members).
+     */
+    getField(name) {
+        return this._fieldMap.get(name);
+    }
+    /**
+     * Returns a static `ClassField` model the given name defined on the immediate
+     * class (excluding any inherited members).
+     */
+    getStaticField(name) {
+        return this._staticFieldMap.get(name);
+    }
+    /**
+     * Returns a non-static `ClassMethod` model for the given name defined on the
+     * immediate class (excluding any inherited members).
+     */
+    getMethod(name) {
+        return this._methodMap.get(name);
+    }
+    /**
+     * Returns a static `ClassMethod` model for the given name defined on the
+     * immediate class (excluding any inherited members).
+     */
+    getStaticMethod(name) {
+        return this._staticMethodMap.get(name);
+    }
+    /**
+     * Returns a `ClassField` or `ClassMethod` model for the given name defined on
+     * the immediate class (excluding any inherited members).
+     *
+     * Note that if a field and method of the same name were defined (error is TS,
+     * but possible in JS), the `ClassField` will be returned from this method, as
+     * it takes precedence by virtue of being an instance property (vs. a method,
+     * which is defined on the prototype).
+     */
+    getMember(name) {
+        return this.getField(name) ?? this.getMethod(name);
+    }
+}
+export class MixinDeclaration extends FunctionDeclaration {
+    constructor(init) {
+        super(init);
+        this.classDeclaration = init.classDeclaration;
+        this.superClassArgIndex = init.superClassArgIndex;
+    }
+}
+export class CustomElementDeclaration extends ClassDeclaration {
+    constructor(init) {
+        super(init);
+        this.tagname = init.tagname;
+        this.events = init.events;
+        this.slots = init.slots;
+        this.cssProperties = init.cssProperties;
+        this.cssParts = init.cssParts;
+    }
+}
+export class LitElementDeclaration extends CustomElementDeclaration {
+    constructor(init) {
+        super(init);
+        this.reactiveProperties = init.reactiveProperties;
+    }
+}
+export class Reference {
+    constructor(init) {
+        this._model = undefined;
+        this.name = init.name;
+        this.package = init.package;
+        this.module = init.module;
+        this.isGlobal = init.isGlobal ?? false;
+        this._dereference = init.dereference ?? (() => undefined);
+    }
+    get moduleSpecifier() {
+        const separator = this.package && this.module ? '/' : '';
+        return this.isGlobal
+            ? undefined
+            : (this.package || '') + separator + (this.module || '');
+    }
+    /**
+     * Returns the Declaration model that this reference points to, optionally
+     * validating (and casting) it to be of a given type by passing a model
+     * constructor.
+     */
+    dereference(type) {
+        const model = (this._model ??= this._dereference());
+        if (type !== undefined && model !== undefined && !(model instanceof type)) {
+            throw new Error(`Expected reference to ${this.name} in module ${this.moduleSpecifier} to be of type ${type.name}`);
+        }
+        return model;
+    }
+}
+export class Type {
+    constructor(init) {
+        this._references = undefined;
+        this.type = init.type;
+        this.text = init.text;
+        this._getReferences = init.getReferences;
+    }
+    get references() {
+        return (this._references ??= this._getReferences());
+    }
+}
+/**
+ * Returns a deduped / coalesced string of import statements required to load
+ * the given references.
+ * TODO(kschaaf): Probably want to accept info about existing imports to dedupe
+ * with.
+ */
+export const getImportsStringForReferences = (references) => {
+    const modules = new Map();
+    for (const { moduleSpecifier, name, isGlobal } of references) {
+        if (!isGlobal) {
+            let namesForModule = modules.get(moduleSpecifier);
+            if (namesForModule === undefined) {
+                modules.set(moduleSpecifier, (namesForModule = new Set()));
+            }
+            namesForModule.add(name);
+        }
+    }
+    return Array.from(modules)
+        .map(([moduleSpecifier, namesForModule]) => `import {${Array.from(namesForModule).join(', ')}} from '${moduleSpecifier}';`)
+        .join('\n');
+};
+//# sourceMappingURL=model.js.map

package/lib/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/lib/model.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @license\n * Copyright 2022 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nimport type ts from 'typescript';\nimport {AbsolutePath, PackagePath} from './paths.js';\n\nimport {IPackageJson as PackageJson} from 'package-json-type';\nexport {PackageJson};\n\nexport type TypeScript = typeof ts;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type Constructor<T> = new (...args: any[]) => T;\n\n/**\n * Return type of `getLitElementModules`: contains a module and filtered list of\n * LitElementDeclarations contained within it.\n */\nexport type ModuleWithLitElementDeclarations = {\n  module: Module;\n  declarations: LitElementDeclaration[];\n};\n\nexport interface PackageInfoInit {\n  name: string;\n  rootDir: AbsolutePath;\n  packageJson: PackageJson;\n}\n\nexport class PackageInfo {\n  readonly name: string;\n  readonly rootDir: AbsolutePath;\n  readonly packageJson: PackageJson;\n\n  constructor(init: PackageInfoInit) {\n    this.name = init.name;\n    this.rootDir = init.rootDir;\n    this.packageJson = init.packageJson;\n  }\n}\n\nexport interface PackageInit extends PackageInfo {\n  modules: ReadonlyArray<Module>;\n}\n\nexport class Package extends PackageInfo {\n  readonly modules: ReadonlyArray<Module>;\n\n  constructor(init: PackageInit) {\n    super(init);\n    this.modules = init.modules;\n  }\n\n  /**\n   * Returns a list of modules in this package containing LitElement\n   * declarations, along with the filtered list of LitElementDeclarations.\n   */\n  getLitElementModules() {\n    const modules: {module: Module; declarations: LitElementDeclaration[]}[] =\n      [];\n    for (const module of this.modules) {\n      const declarations = module.declarations.filter((d) =>\n        d.isLitElementDeclaration()\n      ) as LitElementDeclaration[];\n      if (declarations.length > 0) {\n        modules.push({\n          module,\n          declarations,\n        });\n      }\n    }\n    return modules;\n  }\n}\n\nexport type LocalNameOrReference = string | Reference;\nexport type ExportMap = Map<string, LocalNameOrReference>;\nexport type DeclarationMap = Map<string, Declaration | (() => Declaration)>;\n\nexport interface ModuleInit extends DeprecatableDescribed {\n  sourceFile: ts.SourceFile;\n  sourcePath: PackagePath;\n  jsPath: PackagePath;\n  packageJson: PackageJson;\n  declarationMap: DeclarationMap;\n  exportMap: ExportMap;\n  dependencies: Set<AbsolutePath>;\n  finalizeExports?: () => void;\n}\n\nexport interface ModuleInfo {\n  sourcePath: PackagePath;\n  jsPath: PackagePath;\n  packageJson: PackageJson;\n}\n\nexport class Module {\n  /**\n   * The TS AST node for the file\n   */\n  readonly sourceFile: ts.SourceFile;\n  /**\n   * The path to the source file for this module. In a TS project, this will be\n   * a .ts file. In a JS project, this will be the same as `jsPath`.\n   */\n  readonly sourcePath: PackagePath;\n  /**\n   * The path to the javascript file for this module. In a TS project, this will\n   * be the output location of the compiler for the given `sourcePath`. In a JS\n   * project this will be the same as `sourcePath`.\n   */\n  readonly jsPath: PackagePath;\n  /**\n   * A map of names to models or model factories for all Declarations in this module.\n   */\n  private readonly _declarationMap: DeclarationMap;\n  /**\n   * Private storage for all declarations within this module, memoized\n   * in `get declarations()` getter.\n   */\n  private _declarations: Declaration[] | undefined = undefined;\n  /**\n   * A set of all dependencies of this module, as module absolute paths.\n   */\n  readonly dependencies: Set<AbsolutePath>;\n  /**\n   * The package.json contents for the package containing this module.\n   */\n  readonly packageJson: PackageJson;\n  /**\n   * A map of exported names to local declaration names or References, in\n   * the case of re-exported symbols.\n   */\n  private readonly _exportMap: ExportMap;\n  /**\n   * A list of module paths for all wildcard re-exports\n   */\n  private _finalizeExports: (() => void) | undefined;\n  /**\n   * The module's user-facing description.\n   */\n  readonly description?: string | undefined;\n  /**\n   * The module's user-facing summary.\n   */\n  readonly summary?: string | undefined;\n  /**\n   * The module's user-facing deprecation status.\n   */\n  readonly deprecated?: string | boolean | undefined;\n\n  constructor(init: ModuleInit) {\n    this.sourceFile = init.sourceFile;\n    this.sourcePath = init.sourcePath;\n    this.jsPath = init.jsPath;\n    this.packageJson = init.packageJson;\n    this._declarationMap = init.declarationMap;\n    this.dependencies = init.dependencies;\n    this._exportMap = init.exportMap;\n    this._finalizeExports = init.finalizeExports;\n    this.description = init.description;\n    this.summary = init.summary;\n    this.deprecated = init.deprecated;\n  }\n\n  /**\n   * Ensures the list of exports includes the names of all reexports\n   * from other modules.\n   */\n  private _ensureExportsFinalized() {\n    if (this._finalizeExports !== undefined) {\n      this._finalizeExports();\n      this._finalizeExports = undefined;\n    }\n  }\n\n  /**\n   * Returns names of all exported declarations.\n   */\n  get exportNames() {\n    this._ensureExportsFinalized();\n    return Array.from(this._exportMap.keys());\n  }\n\n  /**\n   * Given an exported symbol name, returns a Declaration if it was\n   * defined in this module, or a Reference if it was imported from\n   * another module.\n   */\n  getExport(name: string): Declaration | Reference {\n    this._ensureExportsFinalized();\n    const exp = this._exportMap.get(name);\n    if (exp === undefined) {\n      throw new Error(\n        `Module ${this.sourcePath} did not contain an export named ${name}`\n      );\n    } else if (exp instanceof Reference) {\n      return exp;\n    } else {\n      return this.getDeclaration(exp);\n    }\n  }\n\n  /**\n   * Return Reference for given export name.\n   *\n   * For references to local declarations, the module will be undefined.\n   * For re-exports, the Reference will point to a package & module.\n   */\n  getExportReference(name: string): Reference {\n    const exp = this.getExport(name);\n    if (exp instanceof Declaration) {\n      return new Reference({name: exp.name, dereference: () => exp});\n    } else {\n      return exp;\n    }\n  }\n\n  /**\n   * Given an exported symbol name, returns the concrete Declaration\n   * for that symbol, following it through any re-exports.\n   */\n  getResolvedExport(name: string): Declaration {\n    let exp = this.getExport(name);\n    while (exp instanceof Reference) {\n      exp = exp.dereference();\n    }\n    return exp as Declaration;\n  }\n\n  /**\n   * Returns a `Declaration` model for the given name in top-level module scope.\n   *\n   * Note, the name is local to the module, and the declaration may be exported\n   * from with a different name. The declaration is always concrete, and will\n   * never be a `Reference`.\n   */\n  getDeclaration(name: string): Declaration {\n    let dec = this._declarationMap.get(name);\n    if (dec === undefined) {\n      throw new Error(\n        `Module ${this.sourcePath} did not contain a declaration named ${name}`\n      );\n    }\n    // Overwrite a factory with its output (a `Declaration` model) on first\n    // request\n    if (typeof dec === 'function') {\n      this._declarationMap.set(name, (dec = dec()));\n    }\n    return dec;\n  }\n\n  /**\n   * Returns a list of all Declarations locally defined in this module.\n   */\n  get declarations() {\n    return (this._declarations ??= Array.from(this._declarationMap.keys()).map(\n      (name) => this.getDeclaration(name)\n    ));\n  }\n\n  /**\n   * Returns all custom elements registered in this module.\n   */\n  getCustomElementExports(): LitElementExport[] {\n    return this.declarations.filter(\n      (d) => d.isLitElementDeclaration() && d.tagname !== undefined\n    ) as LitElementExport[];\n  }\n}\n\ninterface DeclarationInit extends DeprecatableDescribed {\n  name: string;\n  node: ts.Node;\n}\n\nexport abstract class Declaration {\n  readonly name: string;\n  readonly description?: string | undefined;\n  readonly summary?: string | undefined;\n  readonly deprecated?: string | boolean | undefined;\n  readonly node: ts.Node;\n\n  constructor(init: DeclarationInit) {\n    this.name = init.name;\n    this.description = init.description;\n    this.summary = init.summary;\n    this.deprecated = init.deprecated;\n    this.node = init.node;\n  }\n\n  isVariableDeclaration(): this is VariableDeclaration {\n    return this instanceof VariableDeclaration;\n  }\n\n  isClassDeclaration(): this is ClassDeclaration {\n    return this instanceof ClassDeclaration;\n  }\n\n  isLitElementDeclaration(): this is LitElementDeclaration {\n    return this instanceof LitElementDeclaration;\n  }\n\n  isFunctionDeclaration(): this is FunctionDeclaration {\n    return this instanceof FunctionDeclaration;\n  }\n\n  isMixinDeclaration(): this is MixinDeclaration {\n    return this instanceof MixinDeclaration;\n  }\n\n  isClassField(): this is ClassField {\n    return this instanceof ClassField;\n  }\n\n  isClassMethod(): this is ClassMethod {\n    return this instanceof ClassMethod;\n  }\n\n  isCustomElementDeclaration(): this is CustomElementDeclaration {\n    return this instanceof CustomElementDeclaration;\n  }\n}\n\nexport interface VariableDeclarationInit extends DeclarationInit {\n  node: ts.VariableDeclaration | ts.ExportAssignment | ts.EnumDeclaration;\n  type: Type | undefined;\n}\n\nexport class VariableDeclaration extends Declaration {\n  readonly type: Type | undefined;\n  declare readonly node:\n    | ts.VariableDeclaration\n    | ts.ExportAssignment\n    | ts.EnumDeclaration;\n\n  constructor(init: VariableDeclarationInit) {\n    super(init);\n    this.type = init.type;\n  }\n}\n\nexport interface FunctionLikeInit extends DeclarationInit {\n  name: string;\n  parameters?: Parameter[] | undefined;\n  return?: Return | undefined;\n  overloads?: FunctionOverloadDeclaration[] | undefined;\n  node: ts.FunctionLikeDeclaration;\n}\n\nexport class FunctionDeclaration extends Declaration {\n  parameters?: Parameter[] | undefined;\n  return?: Return | undefined;\n  overloads?: FunctionOverloadDeclaration[] | undefined;\n  declare readonly node: ts.FunctionLikeDeclaration;\n\n  constructor(init: FunctionLikeInit) {\n    super(init);\n    this.parameters = init.parameters;\n    this.return = init.return;\n    this.overloads = init.overloads;\n  }\n}\n\nexport interface FunctionLikeOverloadInit extends FunctionLikeInit {\n  overloads?: undefined;\n}\n\nexport class FunctionOverloadDeclaration extends FunctionDeclaration {\n  override overloads: undefined;\n  constructor(init: FunctionLikeOverloadInit) {\n    super(init);\n  }\n}\n\nexport type Privacy = 'public' | 'private' | 'protected';\n\nexport interface SourceReference {\n  href: string;\n}\n\nexport interface ClassMethodInit extends FunctionLikeInit {\n  static?: boolean | undefined;\n  privacy?: Privacy | undefined;\n  inheritedFrom?: Reference | undefined;\n  source?: SourceReference | undefined;\n  node: ts.MethodDeclaration;\n}\n\nexport class ClassMethod extends FunctionDeclaration {\n  static?: boolean | undefined;\n  privacy?: Privacy | undefined;\n  inheritedFrom?: Reference | undefined;\n  source?: SourceReference | undefined;\n  override readonly node: ts.MethodDeclaration;\n\n  constructor(init: ClassMethodInit) {\n    super(init);\n    this.static = init.static;\n    this.privacy = init.privacy;\n    this.inheritedFrom = init.inheritedFrom;\n    this.source = init.source;\n    this.node = init.node;\n  }\n}\n\nexport interface ClassFieldInit extends DeclarationInit, PropertyLike {\n  static?: boolean | undefined;\n  privacy?: Privacy | undefined;\n  inheritedFrom?: Reference | undefined;\n  source?: SourceReference | undefined;\n  readonly?: boolean | undefined;\n  node:\n    | ts.PropertyDeclaration\n    | ts.AssignmentExpression<ts.EqualsToken>\n    | ts.AccessorDeclaration;\n}\n\nexport class ClassField extends Declaration {\n  static?: boolean | undefined;\n  privacy?: Privacy | undefined;\n  inheritedFrom?: Reference | undefined;\n  source?: SourceReference | undefined;\n  readonly?: boolean | undefined;\n  type?: Type | undefined;\n  default?: string | undefined;\n  declare node:\n    | ts.PropertyDeclaration\n    | ts.AssignmentExpression<ts.EqualsToken>\n    | ts.AccessorDeclaration;\n\n  constructor(init: ClassFieldInit) {\n    super(init);\n    this.static = init.static;\n    this.privacy = init.privacy;\n    this.inheritedFrom = init.inheritedFrom;\n    this.source = init.source;\n    this.type = init.type;\n    this.default = init.default;\n    this.readonly = init.readonly;\n  }\n}\n\nexport type ClassHeritage = {\n  mixins: Reference[];\n  superClass: Reference | undefined;\n};\n\nexport interface ClassDeclarationInit extends DeclarationInit {\n  node: ts.ClassDeclaration | ts.ClassLikeDeclaration | ts.CallExpression;\n  getHeritage: () => ClassHeritage;\n  fieldMap?: Map<string, ClassField> | undefined;\n  staticFieldMap?: Map<string, ClassField> | undefined;\n  methodMap?: Map<string, ClassMethod> | undefined;\n  staticMethodMap?: Map<string, ClassMethod> | undefined;\n}\n\nexport class ClassDeclaration extends Declaration {\n  private _getHeritage: () => ClassHeritage;\n  private _heritage: ClassHeritage | undefined = undefined;\n  readonly _fieldMap: Map<string, ClassField>;\n  readonly _staticFieldMap: Map<string, ClassField>;\n  readonly _methodMap: Map<string, ClassMethod>;\n  readonly _staticMethodMap: Map<string, ClassMethod>;\n  override readonly node: ts.ClassLikeDeclaration | ts.CallExpression;\n\n  constructor(init: ClassDeclarationInit) {\n    super(init);\n    this.node = init.node;\n    this._getHeritage = init.getHeritage;\n    this._fieldMap = init.fieldMap ?? new Map();\n    this._staticFieldMap = init.staticFieldMap ?? new Map();\n    this._methodMap = init.methodMap ?? new Map();\n    this._staticMethodMap = init.staticMethodMap ?? new Map();\n  }\n\n  /**\n   * Returns this class's `ClassHeritage` model, with references to its\n   * `superClass` and `mixins`.\n   */\n  get heritage(): ClassHeritage {\n    return (this._heritage ??= this._getHeritage());\n  }\n\n  /**\n   * Returns iterator of the non-static `ClassField`s defined on the immediate\n   * class (excluding any inherited members).\n   */\n  get fields(): IterableIterator<ClassField> {\n    return this._fieldMap.values();\n  }\n\n  /**\n   * Returns iterator of the static `ClassField`s defined on the immediate class\n   * (excluding any inherited members).\n   */\n  get staticFields(): IterableIterator<ClassField> {\n    return this._staticFieldMap.values();\n  }\n\n  /**\n   * Returns iterator of the non-static `ClassMethod`s defined on the immediate\n   * class (excluding any inherited members).\n   */\n  get methods(): IterableIterator<ClassMethod> {\n    return this._methodMap.values();\n  }\n\n  /**\n   * Returns iterator of the static `ClassMethod`s defined on the immediate\n   * class (excluding any inherited members).\n   */\n  get staticMethods(): IterableIterator<ClassMethod> {\n    return this._staticMethodMap.values();\n  }\n\n  /**\n   * Returns a non-static `ClassField` model the given name defined on the\n   * immediate class (excluding any inherited members).\n   */\n  getField(name: string): ClassField | undefined {\n    return this._fieldMap.get(name);\n  }\n\n  /**\n   * Returns a static `ClassField` model the given name defined on the immediate\n   * class (excluding any inherited members).\n   */\n  getStaticField(name: string): ClassField | undefined {\n    return this._staticFieldMap.get(name);\n  }\n\n  /**\n   * Returns a non-static `ClassMethod` model for the given name defined on the\n   * immediate class (excluding any inherited members).\n   */\n  getMethod(name: string): ClassMethod | undefined {\n    return this._methodMap.get(name);\n  }\n\n  /**\n   * Returns a static `ClassMethod` model for the given name defined on the\n   * immediate class (excluding any inherited members).\n   */\n  getStaticMethod(name: string): ClassMethod | undefined {\n    return this._staticMethodMap.get(name);\n  }\n\n  /**\n   * Returns a `ClassField` or `ClassMethod` model for the given name defined on\n   * the immediate class (excluding any inherited members).\n   *\n   * Note that if a field and method of the same name were defined (error is TS,\n   * but possible in JS), the `ClassField` will be returned from this method, as\n   * it takes precedence by virtue of being an instance property (vs. a method,\n   * which is defined on the prototype).\n   */\n  getMember(name: string): ClassMethod | ClassField | undefined {\n    return this.getField(name) ?? this.getMethod(name);\n  }\n}\n\nexport interface MixinDeclarationInit extends FunctionLikeInit {\n  classDeclaration: ClassDeclaration;\n  superClassArgIndex: number;\n}\n\nexport class MixinDeclaration extends FunctionDeclaration {\n  readonly classDeclaration: ClassDeclaration;\n  readonly superClassArgIndex: number;\n  constructor(init: MixinDeclarationInit) {\n    super(init);\n    this.classDeclaration = init.classDeclaration;\n    this.superClassArgIndex = init.superClassArgIndex;\n  }\n}\n\nexport interface Described {\n  description?: string | undefined;\n  summary?: string | undefined;\n}\n\nexport interface NamedDescribed extends Described {\n  name: string;\n  default?: string;\n}\n\nexport interface CSSPropertyInfo extends NamedDescribed {\n  syntax?: string;\n}\n\nexport interface TypedNamedDescribed extends NamedDescribed {\n  type?: string;\n}\n\nexport interface DeprecatableDescribed extends Described {\n  deprecated?: string | boolean | undefined;\n}\n\ninterface CustomElementDeclarationInit extends ClassDeclarationInit {\n  tagname: string | undefined;\n  events: Map<string, Event>;\n  slots: Map<string, NamedDescribed>;\n  cssProperties: Map<string, CSSPropertyInfo>;\n  cssParts: Map<string, NamedDescribed>;\n}\n\ninterface LitElementDeclarationInit extends CustomElementDeclarationInit {\n  reactiveProperties: Map<string, ReactiveProperty>;\n}\n\nexport class CustomElementDeclaration extends ClassDeclaration {\n  /**\n   * The element's tag name, if one is associated with this class declaration,\n   * such as with a `@customElement()` decorator or `customElements.define()`\n   * call int he same module.\n   *\n   * This is undefined if the element has no associated custom element\n   * registration in the same module. This class might be intended for use as a\n   * base class or with scoped custom element registries.\n   */\n  readonly tagname: string | undefined;\n  readonly events: Map<string, Event>;\n  readonly slots: Map<string, NamedDescribed>;\n  readonly cssProperties: Map<string, CSSPropertyInfo>;\n  readonly cssParts: Map<string, NamedDescribed>;\n\n  constructor(init: CustomElementDeclarationInit) {\n    super(init);\n    this.tagname = init.tagname;\n    this.events = init.events;\n    this.slots = init.slots;\n    this.cssProperties = init.cssProperties;\n    this.cssParts = init.cssParts;\n  }\n}\n\nexport class LitElementDeclaration extends CustomElementDeclaration {\n  readonly reactiveProperties: Map<string, ReactiveProperty>;\n\n  constructor(init: LitElementDeclarationInit) {\n    super(init);\n    this.reactiveProperties = init.reactiveProperties;\n  }\n}\n\n/**\n * A LitElementDeclaration that has been globally registered with a tagname.\n */\nexport interface LitElementExport extends LitElementDeclaration {\n  tagname: string;\n}\n\nexport interface PropertyLike extends DeprecatableDescribed {\n  name: string;\n  node: ts.Node;\n  type: Type | undefined;\n  default?: string | undefined;\n}\n\nexport interface Return {\n  type?: Type | undefined;\n  summary?: string | undefined;\n  description?: string | undefined;\n}\n\nexport interface Parameter extends PropertyLike {\n  node: ts.ParameterDeclaration;\n  optional?: boolean | undefined;\n  rest?: boolean | undefined;\n}\n\nexport interface ReactiveProperty extends PropertyLike {\n  /**\n   * The property declaration.\n   *\n   * A ts.PropertyDeclaration if the property was declared as a class field,\n   * or a ts.PropertyAssignment if the property was declared in a static\n   * properties block.\n   */\n  node: ts.PropertyDeclaration | ts.PropertyAssignment;\n\n  optionsNode: ts.ObjectLiteralExpression | undefined;\n\n  reflect: boolean;\n\n  // TODO(justinfagnani): should we convert into attribute name?\n  attribute: boolean | string | undefined;\n\n  /**\n   * The test of the `type` property option.\n   *\n   * This is really only useful if the type is one of the well known types:\n   * String, Number, or Boolean.\n   */\n  typeOption: string | undefined;\n\n  /**\n   * The Node for the `converter` option if present.\n   *\n   * This is mostly useful to know whether the `type` option can be interpreted\n   * with the default semantics or not.\n   */\n  converter: ts.Node | undefined;\n\n  // TODO(justinfagnani): hasChanged?\n}\n\nexport interface Event {\n  name: string;\n  description: string | undefined;\n  summary: string | undefined;\n  type: Type | undefined;\n}\n\nexport interface LitModule {\n  module: Module;\n  elements: LitElementDeclaration[];\n}\n\nexport interface ReferenceInit {\n  name: string;\n  package?: string | undefined;\n  module?: string | undefined;\n  isGlobal?: boolean;\n  dereference?: () => Declaration | undefined;\n}\n\nexport class Reference {\n  readonly name: string;\n  readonly package: string | undefined;\n  readonly module: string | undefined;\n  readonly isGlobal: boolean;\n  private readonly _dereference: () => Declaration | undefined;\n  private _model: Declaration | undefined = undefined;\n  constructor(init: ReferenceInit) {\n    this.name = init.name;\n    this.package = init.package;\n    this.module = init.module;\n    this.isGlobal = init.isGlobal ?? false;\n    this._dereference = init.dereference ?? (() => undefined);\n  }\n\n  get moduleSpecifier() {\n    const separator = this.package && this.module ? '/' : '';\n    return this.isGlobal\n      ? undefined\n      : (this.package || '') + separator + (this.module || '');\n  }\n\n  /**\n   * Returns the Declaration model that this reference points to, optionally\n   * validating (and casting) it to be of a given type by passing a model\n   * constructor.\n   */\n  dereference<T extends Declaration>(type?: Constructor<T> | undefined): T {\n    const model = (this._model ??= this._dereference());\n    if (type !== undefined && model !== undefined && !(model instanceof type)) {\n      throw new Error(\n        `Expected reference to ${this.name} in module ${this.moduleSpecifier} to be of type ${type.name}`\n      );\n    }\n    return model as T;\n  }\n}\n\nexport interface TypeInit {\n  type: ts.Type;\n  text: string;\n  getReferences: () => Reference[];\n}\n\nexport class Type {\n  type: ts.Type;\n  text: string;\n  private _getReferences: () => Reference[];\n  private _references: Reference[] | undefined = undefined;\n\n  constructor(init: TypeInit) {\n    this.type = init.type;\n    this.text = init.text;\n    this._getReferences = init.getReferences;\n  }\n\n  get references() {\n    return (this._references ??= this._getReferences());\n  }\n}\n\n/**\n * Returns a deduped / coalesced string of import statements required to load\n * the given references.\n * TODO(kschaaf): Probably want to accept info about existing imports to dedupe\n * with.\n */\nexport const getImportsStringForReferences = (references: Reference[]) => {\n  const modules = new Map<string, Set<string>>();\n  for (const {moduleSpecifier, name, isGlobal} of references) {\n    if (!isGlobal) {\n      let namesForModule = modules.get(moduleSpecifier!);\n      if (namesForModule === undefined) {\n        modules.set(moduleSpecifier!, (namesForModule = new Set()));\n      }\n      namesForModule.add(name);\n    }\n  }\n  return Array.from(modules)\n    .map(\n      ([moduleSpecifier, namesForModule]) =>\n        `import {${Array.from(namesForModule).join(\n          ', '\n        )}} from '${moduleSpecifier}';`\n    )\n    .join('\\n');\n};\n\nexport interface AnalyzerInterface {\n  moduleCache: Map<AbsolutePath, Module>;\n  typescript: TypeScript;\n  program: ts.Program;\n  commandLine: ts.ParsedCommandLine;\n  fs: Pick<\n    ts.System,\n    | 'readDirectory'\n    | 'readFile'\n    | 'realpath'\n    | 'fileExists'\n    | 'useCaseSensitiveFileNames'\n  >;\n  path: Pick<\n    typeof import('path'),\n    | 'join'\n    | 'relative'\n    | 'dirname'\n    | 'basename'\n    | 'dirname'\n    | 'parse'\n    | 'normalize'\n    | 'isAbsolute'\n    | 'sep'\n  >;\n\n  addDiagnostic(diagnostic: ts.Diagnostic): void;\n  getDiagnostics(): IterableIterator<ts.Diagnostic>;\n}\n\n/**\n * The name, model factory, and export information about a given declaration.\n */\nexport type DeclarationInfo = {\n  name: string;\n  node: ts.Node;\n  factory: () => Declaration;\n  isExport?: boolean;\n};\n"]}

package/lib/package-analyzer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+import { AbsolutePath } from './paths.js';
+import { Analyzer } from './analyzer.js';
+export interface AnalyzerOptions {
+    /**
+     * Glob of source files to exclude from project during analysis.
+     *
+     * Useful for excluding things source like test folders that might otherwise
+     * be included in a project's tsconfig.
+     */
+    exclude?: string[];
+}
+/**
+ * Returns an analyzer for a Lit npm package based on a filesystem path.
+ *
+ * The path may specify a package root folder, or a specific tsconfig file. When
+ * specifying a folder, if no tsconfig.json file is found directly in the root
+ * folder, the project will be analyzed as JavaScript.
+ */
+export declare const createPackageAnalyzer: (packagePath: AbsolutePath, options?: AnalyzerOptions) => Analyzer;
+//# sourceMappingURL=package-analyzer.d.ts.map

package/lib/package-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-analyzer.d.ts","sourceRoot":"","sources":["../src/lib/package-analyzer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAC,YAAY,EAAC,MAAM,YAAY,CAAC;AAExC,OAAO,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AAEvC,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,aAAa,YAAY,EACzB,UAAS,eAAoB,aAsF9B,CAAC"}

package/lib/package-analyzer.js

@@ -0,0 +1,81 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+import ts from 'typescript';
+import * as path from 'path';
+import { Analyzer } from './analyzer.js';
+/**
+ * Returns an analyzer for a Lit npm package based on a filesystem path.
+ *
+ * The path may specify a package root folder, or a specific tsconfig file. When
+ * specifying a folder, if no tsconfig.json file is found directly in the root
+ * folder, the project will be analyzed as JavaScript.
+ */
+export const createPackageAnalyzer = (packagePath, options = {}) => {
+    // This logic accepts either a path to folder containing a tsconfig.json
+    // directly inside it or a path to a specific tsconfig file. If no tsconfig
+    // file is found, we fallback to creating a JavaScript program.
+    const isDirectory = ts.sys.directoryExists(packagePath);
+    const configFileName = isDirectory
+        ? path.join(packagePath, 'tsconfig.json')
+        : packagePath;
+    let commandLine;
+    if (ts.sys.fileExists(configFileName)) {
+        const configFile = ts.readConfigFile(configFileName, ts.sys.readFile);
+        if (options.exclude !== undefined) {
+            (configFile.config.exclude ??= []).push(...options.exclude);
+        }
+        commandLine = ts.parseJsonConfigFileContent(configFile.config /* json */, ts.sys /* host */, isDirectory ? packagePath : path.dirname(packagePath) /* basePath */, {} /* existingOptions */, configFileName /* configFileName */);
+    }
+    else if (isDirectory) {
+        console.info(`No tsconfig.json found; assuming package is JavaScript.`);
+        commandLine = ts.parseJsonConfigFileContent({
+            compilerOptions: {
+                // TODO(kschaaf): probably want to make this configurable
+                module: 'es2021',
+                lib: ['es2021', 'DOM'],
+                allowJs: true,
+                skipLibCheck: true,
+                skipDefaultLibCheck: true,
+                // With `allowJs: true`, the program will automatically include every
+                // .d.ts file under node_modules/@types regardless of whether the
+                // program imported modules associated with those types, which can
+                // dramatically slow down the program analysis (this does not
+                // automatically happen when allowJs is false). For now, eliminating
+                // `typeRoots` fixes the automatic over-inclusion of .d.ts files as
+                // long as nodeResolution is properly set (it will still import .d.ts
+                // files into the project as expected based on imports). It may
+                // however cause a failure to find definitely-typed .d.ts files for
+                // imports in a JS project, but it seems unlikely these would be
+                // installed anyway.
+                typeRoots: [],
+                moduleResolution: 'node',
+            },
+            include: ['**/*.js'],
+            exclude: options.exclude ?? [],
+        }, ts.sys /* host */, packagePath /* basePath */);
+    }
+    else {
+        throw new Error(`The specified path '${packagePath}' was not a folder or a tsconfig file.`);
+    }
+    // Ensure that `parent` nodes are set in the AST by creating a compiler
+    // host with this configuration; without these, `getText()` and other
+    // API's that require crawling up the AST tree to find the source file
+    // text may fail
+    const compilerHost = ts.createCompilerHost(commandLine.options, 
+    /* setParentNodes */ true);
+    const program = ts.createProgram(commandLine.fileNames, commandLine.options, compilerHost, undefined, commandLine.errors);
+    const analyzer = new Analyzer({
+        getProgram: () => program,
+        typescript: ts,
+        fs: ts.sys,
+        path,
+    });
+    for (const diagnostic of program.getSyntacticDiagnostics()) {
+        analyzer.addDiagnostic(diagnostic);
+    }
+    return analyzer;
+};
+//# sourceMappingURL=package-analyzer.js.map

package/lib/package-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-analyzer.js","sourceRoot":"","sources":["../src/lib/package-analyzer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @license\n * Copyright 2022 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nimport ts from 'typescript';\nimport {AbsolutePath} from './paths.js';\nimport * as path from 'path';\nimport {Analyzer} from './analyzer.js';\n\nexport interface AnalyzerOptions {\n  /**\n   * Glob of source files to exclude from project during analysis.\n   *\n   * Useful for excluding things source like test folders that might otherwise\n   * be included in a project's tsconfig.\n   */\n  exclude?: string[];\n}\n\n/**\n * Returns an analyzer for a Lit npm package based on a filesystem path.\n *\n * The path may specify a package root folder, or a specific tsconfig file. When\n * specifying a folder, if no tsconfig.json file is found directly in the root\n * folder, the project will be analyzed as JavaScript.\n */\nexport const createPackageAnalyzer = (\n  packagePath: AbsolutePath,\n  options: AnalyzerOptions = {}\n) => {\n  // This logic accepts either a path to folder containing a tsconfig.json\n  // directly inside it or a path to a specific tsconfig file. If no tsconfig\n  // file is found, we fallback to creating a JavaScript program.\n  const isDirectory = ts.sys.directoryExists(packagePath);\n  const configFileName = isDirectory\n    ? path.join(packagePath, 'tsconfig.json')\n    : packagePath;\n  let commandLine: ts.ParsedCommandLine;\n  if (ts.sys.fileExists(configFileName)) {\n    const configFile = ts.readConfigFile(configFileName, ts.sys.readFile);\n    if (options.exclude !== undefined) {\n      (configFile.config.exclude ??= []).push(...options.exclude);\n    }\n    commandLine = ts.parseJsonConfigFileContent(\n      configFile.config /* json */,\n      ts.sys /* host */,\n      isDirectory ? packagePath : path.dirname(packagePath) /* basePath */,\n      {} /* existingOptions */,\n      configFileName /* configFileName */\n    );\n  } else if (isDirectory) {\n    console.info(`No tsconfig.json found; assuming package is JavaScript.`);\n    commandLine = ts.parseJsonConfigFileContent(\n      {\n        compilerOptions: {\n          // TODO(kschaaf): probably want to make this configurable\n          module: 'es2021',\n          lib: ['es2021', 'DOM'],\n          allowJs: true,\n          skipLibCheck: true,\n          skipDefaultLibCheck: true,\n          // With `allowJs: true`, the program will automatically include every\n          // .d.ts file under node_modules/@types regardless of whether the\n          // program imported modules associated with those types, which can\n          // dramatically slow down the program analysis (this does not\n          // automatically happen when allowJs is false). For now, eliminating\n          // `typeRoots` fixes the automatic over-inclusion of .d.ts files as\n          // long as nodeResolution is properly set (it will still import .d.ts\n          // files into the project as expected based on imports). It may\n          // however cause a failure to find definitely-typed .d.ts files for\n          // imports in a JS project, but it seems unlikely these would be\n          // installed anyway.\n          typeRoots: [],\n          moduleResolution: 'node',\n        },\n        include: ['**/*.js'],\n        exclude: options.exclude ?? [],\n      },\n      ts.sys /* host */,\n      packagePath /* basePath */\n    );\n  } else {\n    throw new Error(\n      `The specified path '${packagePath}' was not a folder or a tsconfig file.`\n    );\n  }\n\n  // Ensure that `parent` nodes are set in the AST by creating a compiler\n  // host with this configuration; without these, `getText()` and other\n  // API's that require crawling up the AST tree to find the source file\n  // text may fail\n  const compilerHost = ts.createCompilerHost(\n    commandLine.options,\n    /* setParentNodes */ true\n  );\n  const program = ts.createProgram(\n    commandLine.fileNames,\n    commandLine.options,\n    compilerHost,\n    undefined,\n    commandLine.errors\n  );\n\n  const analyzer = new Analyzer({\n    getProgram: () => program,\n    typescript: ts,\n    fs: ts.sys,\n    path,\n  });\n  for (const diagnostic of program.getSyntacticDiagnostics()) {\n    analyzer.addDiagnostic(diagnostic);\n  }\n\n  return analyzer;\n};\n"]}

package/lib/paths.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+import { AnalyzerInterface } from './model.js';
+/**
+ * An absolute path
+ */
+export type AbsolutePath = string & {
+    __absolutePathBrand: never;
+};
+/**
+ * A path relative to a package root
+ */
+export type PackagePath = string & {
+    __packagePathBrand: never;
+};
+/**
+ * Convert an absolute path to a package-relative path
+ */
+export declare const absoluteToPackage: (path: AbsolutePath, packageRoot: AbsolutePath, seperator: string) => PackagePath;
+export declare const resolveExtension: (path: AbsolutePath, analyzer: AnalyzerInterface, extensions?: string[]) => string;
+//# sourceMappingURL=paths.d.ts.map

package/lib/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/lib/paths.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,iBAAiB,EAAC,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAClC,mBAAmB,EAAE,KAAK,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IACjC,kBAAkB,EAAE,KAAK,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,YAAY,EAClB,aAAa,YAAY,EACzB,WAAW,MAAM,KAChB,WAaF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,MAAM,YAAY,EAClB,UAAU,iBAAiB,EAC3B,qBAA0B,WAY3B,CAAC"}

package/lib/paths.js

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * Convert an absolute path to a package-relative path
+ */
+export const absoluteToPackage = (path, packageRoot, seperator) => {
+    if (!path.startsWith(packageRoot)) {
+        throw new Error(`path ${path} is not contained in ${packageRoot}`);
+    }
+    let packagePath = path.substring(packageRoot.length);
+    if (!packageRoot.endsWith(seperator)) {
+        // Make sure we don't have path='/abc/def' and root='/ab'
+        if (!packagePath.startsWith(seperator)) {
+            throw new Error(`path ${path} is not contained in ${packageRoot}`);
+        }
+        packagePath = packagePath.substring(1, packagePath.length);
+    }
+    return packagePath;
+};
+export const resolveExtension = (path, analyzer, extensions = ['js', 'mjs']) => {
+    if (analyzer.fs.fileExists(path)) {
+        return path;
+    }
+    for (const ext of extensions) {
+        const fileName = `${path}.${ext}`;
+        if (analyzer.fs.fileExists(fileName)) {
+            return fileName;
+        }
+    }
+    throw new Error(`Could not resolve ${path} to a file on disk.`);
+};
+//# sourceMappingURL=paths.js.map