Function luaAliasExpr

src/resolution/name-matcher.ts:1607–1638

(rhs: string, site: LuaSite, context: ResolutionContext, depth: number)

const luaMembers = (chain: string): string[] => chain.split('.').map((s) => s.trim()).filter(Boolean);

function luaAliasExpr(rhs: string, site: LuaSite, context: ResolutionContext, depth: number): Node | null | undefined {
  const req = LUA_REQUIRE_ALIAS.exec(rhs);
  if (req) return luaModuleMember(req[2]!, luaMembers(req[3]!), site.node, context, depth);
  const named = LUA_NAME_ALIAS.exec(rhs);
  if (!named) return undefined;
  const root = named[1]!;
  const path = luaMembers(named[2]!);
  const rootDecl = root === site.name ? null : luaLocalDecl(root, site.file, site.line - 1, context);
  if (rootDecl) {
    const module = LUA_REQUIRE_ALIAS.exec(rootDecl.signature!.replace(/^\s*=\s*/, '').trim());
    if (module && path.length > 0) return luaModuleMember(module[2]!, [...luaMembers(module[3]!), ...path], rootDecl, context, depth);
    return undefined;
  }
  if (path.length === 0) return LUA_GLOBAL_FUNCTIONS.has(root) ? null : undefined;
  if (!LUA_LIBRARY_TABLES.has(root)) {
    // A member of a global table the host provides — kong's `local clear_header =
    // kong.response.clear_header` — is the one method of a table named after its holder.
    const member = path[path.length - 1]!;
    const holder = path.length > 1 ? path[path.length - 2]! : root;
    const owned = context.getNodesByName(member).filter((n) =>
      (n.language === 'lua' || n.language === 'luau') && n.kind === 'method' && sharesReceiverWord(holder, n) &&
      !(isTestPath(n.filePath) && !isTestPath(site.file)));
    return owned.length === 1 ? owned[0]! : undefined;
  }
  if (path.length !== 1) return undefined;
  // A library function the project patches itself (kong's `ngx.sleep`) is the project's —
  // a test's stand-in (`function ngx.get_phase()` in a spec) only for that test.
  const patched = context.getNodesByName(path[0]!).filter((n) =>
    (n.kind === 'function' || n.kind === 'method') && n.qualifiedName.split(/::|\./)[0] === root &&
    (n.filePath === site.file || !isTestPath(n.filePath)));
  return patched.length === 1 ? patched[0]! : null;
}

/** Per-context memo: `file\0a.b` → what that module member is. */
const LUA_MEMBERS = new WeakMap<ResolutionContext, Map<string, Node | null | undefined>>();