Function resolvePageRef

packages/dev/mcp/shared/src/page-manager.ts:63–103

(library: Library, pageName: string)

}

export async function resolvePageRef(library: Library, pageName: string): Promise<PageInfo> {
  await buildPageIndex(library);

  if (pageCache.has(pageName)) {
    return pageCache.get(pageName)!;
  }

  const baseUrl = getLibraryBaseUrl(library);

  if (pageName.includes('/')) {
    const normalized = pageName.replace(/\\/g, '/');
    const prefix = normalized.split('/', 1)[0];
    if (prefix !== library) {
      throw new Error(`Page '${pageName}' is not in the '${library}' library.`);
    }
    const maybe = pageCache.get(normalized);
    if (maybe) {
      return maybe;
    }
    const filePath = `${baseUrl}/${normalized}.md`;
    const stub: PageInfo = {
      key: normalized,
      name: path.basename(normalized),
      description: undefined,
      filePath,
      sections: []
    };
    pageCache.set(stub.key, stub);
    return stub;
  }

  const key = `${library}/${pageName}`;
  const maybe = pageCache.get(key);
  if (maybe) {
    return maybe;
  }
  const filePath = `${baseUrl}/${key}.md`;
  const stub: PageInfo = {key, name: pageName, description: undefined, filePath, sections: []};
  pageCache.set(stub.key, stub);
  return stub;
}