Add local ApiLink registry snapshots

docs/xplat/src/lib/platform-context.ts

@@ -27,16 +27,29 @@ export interface ApiPackageConfig {
      */
     noPackagePrefix?: boolean;
     /**
-     * Optional suffix appended to the class name before lowercasing, e.g.
-     * Angular DV packages append "Component" so `CategoryChart` resolves to
-     * `igniteui_angular_charts.igxcategorychartcomponent.html`.
-     * Only applied when `prefixed={true}`.
+     * When true the class name casing is preserved as-is (no .toLowerCase()).
+     * New api-docs routes use PascalCase symbol names.
+     */
+    preserveCase?: boolean;
+    /**
+     * Preferred class-name suffix used by ApiLink. The generated registry tries
+     * both the suffixed and unsuffixed names, so this does not mean every API
+     * symbol is expected to have the suffix.
      */
     classSuffix?: string;
+    /**
+     * When true, member anchor names are PascalCase (first letter uppercased).
+     * Blazor API docs use PascalCase anchors.
+     */
+    pascalCaseMembers?: boolean;
 }
 
 export interface PlatformContext {
     name: PlatformName;
+    /** Optional compact ApiLink symbol index loaded by the docs host at build time. */
+    apiLinkIndex?: {
+        symbols?: Record<string, unknown>;
+    };
     /** Lower-case slug used in URLs, e.g. "angular" */
     lower: string;
     /** Component class prefix, e.g. "Igx" / "Igr" / "Igc" / "Igb" */
@@ -67,23 +80,81 @@ export interface PlatformContext {
     };
 }
 
+function getBuildMode(): string {
+    return process.env.DOCS_ENV ?? process.env.NODE_ENV ?? 'development';
+}
+
+function getApiDocsBaseUrl(): string {
+    const value = process.env.API_DOCS_BASE_URL
+        ?? (getBuildMode() === 'staging'
+            ? 'https://staging.infragistics.com/api'
+            : getBuildMode() === 'production'
+                ? 'https://www.infragistics.com/api'
+                : 'https://staging.infragistics.com/api');
+    const trimmed = value.replace(/\/+$/, '');
+    return trimmed.endsWith('/api') ? trimmed : `${trimmed}/api`;
+}
+
+const API_DOCS_BASE_URL = getApiDocsBaseUrl();
+
+function getApiLinkIndexName(): string {
+    return process.env.API_LINK_INDEX_VERSION
+        ?? (getBuildMode() === 'production' ? 'prod-latest' : 'staging-latest');
+}
+
+function apiDocsPlatformPath(platform: PlatformName): string {
+    return platform === 'WebComponents' ? 'webcomponents' : platform.toLowerCase();
+}
+
+function apiDocRoot(platform: PlatformName, packageId: string): string {
+    return `${API_DOCS_BASE_URL}/${apiDocsPlatformPath(platform)}/${packageId}/latest`;
+}
+
+function apiPackage(platform: PlatformName, packageId: string, options: Partial<ApiPackageConfig> = {}): ApiPackageConfig {
+    return {
+        docRoot: apiDocRoot(platform, packageId),
+        packageId,
+        noPackagePrefix: true,
+        preserveCase: true,
+        ...options,
+    };
+}
+
+function loadApiLinkIndex(platform: PlatformName): PlatformContext['apiLinkIndex'] {
+    try {
+        const file = path.resolve(
+            process.cwd(),
+            'src',
+            'data',
+            'api-link-index',
+            apiDocsPlatformPath(platform),
+            `${getApiLinkIndexName()}.json`
+        );
+        if (!fs.existsSync(file)) return undefined;
+        return JSON.parse(fs.readFileSync(file, 'utf-8'));
+    } catch {
+        return undefined;
+    }
+}
+
 const PLATFORMS: Record<PlatformName, PlatformContext> = {
     Angular: {
         name: 'Angular',
+        apiLinkIndex: loadApiLinkIndex('Angular'),
         lower: 'angular',
         prefix: 'Igx',
         productName: 'Ignite UI for Angular',
         productSpinal: 'ignite-ui-angular',
         apiPackages: {
-            core:        { docRoot: 'https://www.infragistics.com/products/ignite-ui-angular/docs/typescript/latest',     packageId: 'igniteui-angular',            noPackagePrefix: true },
-            charts:      { docRoot: 'https://www.infragistics.com/products/ignite-ui-angular/api/docs/typescript/latest', packageId: 'igniteui_angular_charts',      classSuffix: 'Component' },
-            grids:       { docRoot: 'https://www.infragistics.com/products/ignite-ui-angular/docs/typescript/latest',     packageId: 'igniteui-angular-grids',       noPackagePrefix: true },
-            gauges:      { docRoot: 'https://www.infragistics.com/products/ignite-ui-angular/api/docs/typescript/latest', packageId: 'igniteui_angular_gauges',      classSuffix: 'Component' },
-            maps:        { docRoot: 'https://www.infragistics.com/products/ignite-ui-angular/api/docs/typescript/latest', packageId: 'igniteui_angular_maps',        classSuffix: 'Component' },
-            excel:       { docRoot: 'https://www.infragistics.com/products/ignite-ui-angular/api/docs/typescript/latest', packageId: 'igniteui_angular_excel',       classSuffix: 'Component' },
-            spreadsheet: { docRoot: 'https://www.infragistics.com/products/ignite-ui-angular/api/docs/typescript/latest', packageId: 'igniteui_angular_spreadsheet', classSuffix: 'Component' },
-            inputs:      { docRoot: 'https://www.infragistics.com/products/ignite-ui-angular/docs/typescript/latest',     packageId: 'igniteui-angular',             noPackagePrefix: true },
-            layouts:     { docRoot: 'https://www.infragistics.com/products/ignite-ui-angular/docs/typescript/latest',     packageId: 'igniteui-angular',             noPackagePrefix: true },
+            core:        apiPackage('Angular', 'igniteui-angular', { classSuffix: 'Component' }),
+            charts:      apiPackage('Angular', 'igniteui-angular-charts', { classSuffix: 'Component' }),
+            grids:       apiPackage('Angular', 'igniteui-angular', { classSuffix: 'Component' }),
+            gauges:      apiPackage('Angular', 'igniteui-angular-gauges', { classSuffix: 'Component' }),
+            maps:        apiPackage('Angular', 'igniteui-angular-maps', { classSuffix: 'Component' }),
+            excel:       apiPackage('Angular', 'igniteui-angular-excel', { classSuffix: 'Component' }),
+            spreadsheet: apiPackage('Angular', 'igniteui-angular-spreadsheet', { classSuffix: 'Component' }),
+            inputs:      apiPackage('Angular', 'igniteui-angular', { classSuffix: 'Component' }),
+            layouts:     apiPackage('Angular', 'igniteui-angular', { classSuffix: 'Component' }),
         },
         packages: {
             common: 'igniteui-angular',
@@ -100,21 +171,23 @@ const PLATFORMS: Record<PlatformName, PlatformContext> = {
     },
     React: {
         name: 'React',
+        apiLinkIndex: loadApiLinkIndex('React'),
         lower: 'react',
         prefix: 'Igr',
         productName: 'Ignite UI for React',
         productSpinal: 'ignite-ui-react',
         apiPackages: {
-            core:        { docRoot: 'https://www.infragistics.com/products/ignite-ui-react/docs/typescript/latest',     packageId: 'igniteui-react' },
-            charts:      { docRoot: 'https://www.infragistics.com/products/ignite-ui-react/api/docs/typescript/latest', packageId: 'igniteui_react_charts' },
-            grids:       { docRoot: 'https://www.infragistics.com/products/ignite-ui-react/docs/typescript/latest',     packageId: 'igniteui-react-grids' },
-            gauges:      { docRoot: 'https://www.infragistics.com/products/ignite-ui-react/api/docs/typescript/latest', packageId: 'igniteui_react_gauges' },
-            maps:        { docRoot: 'https://www.infragistics.com/products/ignite-ui-react/api/docs/typescript/latest', packageId: 'igniteui_react_maps' },
-            inputs:      { docRoot: 'https://www.infragistics.com/products/ignite-ui-react/api/docs/typescript/latest', packageId: 'igniteui_react_inputs' },
-            layouts:     { docRoot: 'https://www.infragistics.com/products/ignite-ui-react/api/docs/typescript/latest', packageId: 'igniteui_react_layouts' },
-            excel:       { docRoot: 'https://www.infragistics.com/products/ignite-ui-react/api/docs/typescript/latest', packageId: 'igniteui_react_excel' },
-            spreadsheet: { docRoot: 'https://www.infragistics.com/products/ignite-ui-react/api/docs/typescript/latest', packageId: 'igniteui_react_spreadsheet' },
-            datasources: { docRoot: 'https://www.infragistics.com/products/ignite-ui-react/api/docs/typescript/latest', packageId: 'igniteui_react_datasources' },
+            core:        apiPackage('React', 'igniteui-react'),
+            charts:      apiPackage('React', 'igniteui-react-charts'),
+            grids:       apiPackage('React', 'igniteui-react-grids'),
+            gauges:      apiPackage('React', 'igniteui-react-gauges'),
+            maps:        apiPackage('React', 'igniteui-react-maps'),
+            inputs:      apiPackage('React', 'igniteui-react-inputs'),
+            layouts:     apiPackage('React', 'igniteui-react-layouts'),
+            excel:       apiPackage('React', 'igniteui-react-excel'),
+            spreadsheet: apiPackage('React', 'igniteui-react-spreadsheet'),
+            datasources: apiPackage('React', 'igniteui-react-datasources'),
+            dockmanager: apiPackage('React', 'igniteui-react-dockmanager'),
         },
         packages: {
             common: '@infragistics/igniteui-react',
@@ -131,21 +204,24 @@ const PLATFORMS: Record<PlatformName, PlatformContext> = {
     },
     WebComponents: {
         name: 'WebComponents',
+        apiLinkIndex: loadApiLinkIndex('WebComponents'),
         lower: 'webcomponents',
         prefix: 'Igc',
         productName: 'Ignite UI for Web Components',
         productSpinal: 'ignite-ui-web-components',
         apiPackages: {
-            core:        { docRoot: 'https://www.infragistics.com/products/ignite-ui-web-components/docs/typescript/latest',     packageId: 'igniteui-webcomponents' },
-            charts:      { docRoot: 'https://www.infragistics.com/products/ignite-ui-web-components/api/docs/typescript/latest', packageId: 'igniteui_webcomponents_charts' },
-            grids:       { docRoot: 'https://www.infragistics.com/products/ignite-ui-web-components/api/docs/typescript/latest', packageId: 'igniteui_webcomponents_data_grids' },
-            gauges:      { docRoot: 'https://www.infragistics.com/products/ignite-ui-web-components/api/docs/typescript/latest', packageId: 'igniteui_webcomponents_gauges' },
-            maps:        { docRoot: 'https://www.infragistics.com/products/ignite-ui-web-components/api/docs/typescript/latest', packageId: 'igniteui_webcomponents_maps' },
-            inputs:      { docRoot: 'https://www.infragistics.com/products/ignite-ui-web-components/api/docs/typescript/latest', packageId: 'igniteui_webcomponents_inputs' },
-            layouts:     { docRoot: 'https://www.infragistics.com/products/ignite-ui-web-components/api/docs/typescript/latest', packageId: 'igniteui_webcomponents_layouts' },
-            excel:       { docRoot: 'https://www.infragistics.com/products/ignite-ui-web-components/api/docs/typescript/latest', packageId: 'igniteui_webcomponents_excel' },
-            spreadsheet: { docRoot: 'https://www.infragistics.com/products/ignite-ui-web-components/api/docs/typescript/latest', packageId: 'igniteui_webcomponents_spreadsheet' },
-            datasources: { docRoot: 'https://www.infragistics.com/products/ignite-ui-web-components/api/docs/typescript/latest', packageId: 'igniteui_webcomponents_datasources' },
+            core:        apiPackage('WebComponents', 'igniteui-webcomponents', { classSuffix: 'Component' }),
+            charts:      apiPackage('WebComponents', 'igniteui-webcomponents-charts', { classSuffix: 'Component' }),
+            grids:       apiPackage('WebComponents', 'igniteui-webcomponents-grids', { classSuffix: 'Component' }),
+            gauges:      apiPackage('WebComponents', 'igniteui-webcomponents-gauges', { classSuffix: 'Component' }),
+            maps:        apiPackage('WebComponents', 'igniteui-webcomponents-maps', { classSuffix: 'Component' }),
+            inputs:      apiPackage('WebComponents', 'igniteui-webcomponents-inputs', { classSuffix: 'Component' }),
+            layouts:     apiPackage('WebComponents', 'igniteui-webcomponents-layouts', { classSuffix: 'Component' }),
+            excel:       apiPackage('WebComponents', 'igniteui-webcomponents-excel', { classSuffix: 'Component' }),
+            spreadsheet: apiPackage('WebComponents', 'igniteui-webcomponents-spreadsheet', { classSuffix: 'Component' }),
+            datasources: apiPackage('WebComponents', 'igniteui-webcomponents-datasources', { classSuffix: 'Component' }),
+            dockmanager: apiPackage('WebComponents', 'igniteui-dockmanager', { classSuffix: 'Component' }),
+            gridlite:    apiPackage('WebComponents', 'igniteui-grid-lite', { classSuffix: 'Component' }),
         },
         packages: {
             common: 'igniteui-webcomponents',
@@ -162,18 +238,22 @@ const PLATFORMS: Record<PlatformName, PlatformContext> = {
     },
     Blazor: {
         name: 'Blazor',
+        apiLinkIndex: loadApiLinkIndex('Blazor'),
         lower: 'blazor',
         prefix: 'Igb',
         productName: 'Ignite UI for Blazor',
         productSpinal: 'ignite-ui-blazor',
         apiPackages: {
-            core:        { docRoot: 'https://www.infragistics.com/products/ignite-ui-blazor/docs/typescript/latest',     packageId: 'igniteui-blazor' },
-            charts:      { docRoot: 'https://www.infragistics.com/products/ignite-ui-blazor/api/docs/typescript/latest', packageId: 'igniteui_blazor_charts' },
-            grids:       { docRoot: 'https://www.infragistics.com/products/ignite-ui-blazor/api/docs/typescript/latest', packageId: 'igniteui_blazor_data_grids' },
-            gauges:      { docRoot: 'https://www.infragistics.com/products/ignite-ui-blazor/api/docs/typescript/latest', packageId: 'igniteui_blazor_gauges' },
-            maps:        { docRoot: 'https://www.infragistics.com/products/ignite-ui-blazor/api/docs/typescript/latest', packageId: 'igniteui_blazor_maps' },
-            excel:       { docRoot: 'https://www.infragistics.com/products/ignite-ui-blazor/api/docs/typescript/latest', packageId: 'igniteui_blazor_excel' },
-            spreadsheet: { docRoot: 'https://www.infragistics.com/products/ignite-ui-blazor/api/docs/typescript/latest', packageId: 'igniteui_blazor_spreadsheet' },
+            core:          apiPackage('Blazor', 'IgniteUI.Blazor', { pascalCaseMembers: true }),
+            charts:        apiPackage('Blazor', 'IgniteUI.Blazor', { pascalCaseMembers: true }),
+            grids:         apiPackage('Blazor', 'IgniteUI.Blazor', { pascalCaseMembers: true }),
+            gauges:        apiPackage('Blazor', 'IgniteUI.Blazor', { pascalCaseMembers: true }),
+            maps:          apiPackage('Blazor', 'IgniteUI.Blazor', { pascalCaseMembers: true }),
+            excel:         apiPackage('Blazor', 'IgniteUI.Blazor.Documents.Excel', { pascalCaseMembers: true }),
+            spreadsheet:   apiPackage('Blazor', 'IgniteUI.Blazor', { pascalCaseMembers: true }),
+            documentsCore: apiPackage('Blazor', 'IgniteUI.Blazor.Documents.Core', { pascalCaseMembers: true }),
+            lite:          apiPackage('Blazor', 'IgniteUI.Blazor.Lite', { pascalCaseMembers: true }),
+            gridlite:      apiPackage('Blazor', 'IgniteUI.Blazor.GridLite', { pascalCaseMembers: true }),
         },
         packages: {
             common: 'IgniteUI.Blazor',

src/data/api-link-index/manifest.json

@@ -0,0 +1,8 @@
+{
+    "files": [
+        "angular/staging-latest.json",
+        "blazor/staging-latest.json",
+        "react/staging-latest.json",
+        "webcomponents/staging-latest.json"
+    ]
+}

src/lib/platform-context.ts

@@ -160,6 +160,37 @@
 let _ctx: PlatformContext | null = null;
 let _env: Record<string, string> | null = null;
 
+
+function getBuildMode(): string {
+    return process.env.DOCS_ENV ?? process.env.NODE_ENV ?? 'development';
+}
+
+function getApiDocsBaseUrl(): string {
+    const mode = getBuildMode();
+    const value = process.env.API_DOCS_BASE_URL
+        ?? (mode === 'production'
+            ? 'https://www.infragistics.com/api'
+            : 'https://staging.infragistics.com/api');
+
+    const trimmed = value.replace(/\/+$/, '');
+    return trimmed.endsWith('/api') ? trimmed : `${trimmed}/api`;
+}
+
+function getApiLinkIndexName(): string {
+    return process.env.API_LINK_INDEX_VERSION
+        ?? (getBuildMode() === 'production' ? 'prod-latest' : 'staging-latest');
+}
+
+function loadApiLinkIndex(platformSlug: string): PlatformContext['apiLinkIndex'] {
+    try {
+        const file = path.resolve(process.cwd(), 'src', 'data', 'api-link-index', platformSlug, `${getApiLinkIndexName()}.json`);
+        if (!fs.existsSync(file)) return undefined;
+        return JSON.parse(fs.readFileSync(file, 'utf-8'));
+    } catch {
+        return undefined;
+    }
+}
+
 /**
  * Returns the platform context for the current build.
  * Resolution order: PLATFORM env var → .platform.json → 'React' default.
@@ -186,17 +217,21 @@
         } catch { /* use default */ }
     }
 
-    const mode = process.env.DOCS_ENV ?? process.env.NODE_ENV ?? 'development';
-    const apiHost = mode === 'production'
-        ? 'https://www.infragistics.com'
-        : 'https://staging.infragistics.com';
+    const apiDocsBaseUrl = getApiDocsBaseUrl();
+
     const base = PLATFORMS[name];
     _ctx = {
         ...base,
+        apiLinkIndex: loadApiLinkIndex(base.lower),
         apiPackages: Object.fromEntries(
             Object.entries(base.apiPackages).map(([key, pkg]) => [
                 key,
-                { ...pkg, docRoot: pkg.docRoot.replace('https://staging.infragistics.com', apiHost) },
+                {
+                    ...pkg,
+                    docRoot: pkg.docRoot
+                        .replace('https://staging.infragistics.com/api', apiDocsBaseUrl)
+                        .replace(/\/latest$/, '/latest'),
+                },
             ])
         ),
     };
@@ -216,7 +251,7 @@
 
     const { name } = getPlatformContext();
     const lang = process.env.LANG_CODE ?? 'en';
-    const mode = process.env.DOCS_ENV ?? process.env.NODE_ENV ?? 'development';
+    const mode = getBuildMode();
 
     // Primary: generated/environment.json (written by generate.mjs when present)
     try {