Add commands and logic to combine json apis from all blazor dlls for astro api docs

.gitignore

@@ -12,6 +12,9 @@ _site
 _site/**
 _site/*.*
 node_modules
+api-json
+api-raw
+dist
 
 # excluding IG assemblies and xml files
 src/*.dll

IgniteUI.Blazor.GridLite.filterConfig.yml

@@ -0,0 +1,16 @@
+apiRules:
+- exclude:
+    uidRegex: ^IgniteUI\.Blazor\.Controls\._Imports$
+    type: Class
+- exclude:
+    uidRegex: ^\<
+    type: Class
+- exclude:
+    hasAttribute:
+      uid: System.Runtime.CompilerServices.CompilerGeneratedAttribute
+- include:
+    uidRegex: ^IgniteUI\.Blazor
+    type: Namespace
+- exclude:
+    uidRegex: .
+    type: Namespace

IgniteUI.Blazor.filterConfig.yml

@@ -0,0 +1,10 @@
+apiRules:
+- exclude:
+    uidRegex: ^IgniteUI\.Blazor\._Imports$
+    type: Class
+- exclude:
+    uidRegex: ^IgniteUI\.Blazor\.Controls\.Description
+    type: Namespace
+- exclude:
+    uidRegex: ^System\.Runtime\.CompilerServices\.
+    type: Class

api-templates/ManagedReference.json.primary.js

@@ -0,0 +1,14 @@
+exports.transform = function (model) {
+  if (model && model.inheritedMembers) {
+    model.inheritedMembers.forEach(function (member) {
+      if (member.uid) {
+        // Strip method parameters (everything from first '(') before finding the class name
+        var parenIndex = member.uid.indexOf('(');
+        var uidWithoutParams = parenIndex > 0 ? member.uid.substring(0, parenIndex) : member.uid;
+        var lastDot = uidWithoutParams.lastIndexOf('.');
+        member.inheritedFromClass = lastDot > 0 ? uidWithoutParams.substring(0, lastDot) : uidWithoutParams;
+      }
+    });
+  }
+  return model;
+};

api-templates/ManagedReference.json.primary.tmpl

@@ -0,0 +1,133 @@
+{
+  "uid": "{{uid}}",
+  "id": 0,
+  "name": "{{name.0.value}}",
+  "fullName": "{{fullName.0.value}}",
+  "namespace": "{{namespace.uid}}",
+  "kindString": "{{type}}",
+  "comment": {
+    "summary": [
+					{
+						"kindString": "text",
+						"text": "{{summary}}"
+					},
+					{
+						"kindString": "code",
+						"text": "{{syntax.content.0.value}}"
+					}
+				]
+  },
+  "inheritance": [
+    {{#if inheritance}}
+    {{#each inheritance}}
+    {
+      "uid": "{{uid}}",
+      "id": 0,
+      "name": "{{name.0.value}}"
+    }{{#unless @last}},{{/unless}}
+    {{/each}}
+    {{/if}}
+  ],
+  "implements": [
+    {{#if implements}}
+    {{#each implements}}
+    {
+      "uid": "{{uid}}",
+      "id": 0,
+      "name": "{{name.0.value}}"
+    }{{#unless @last}},{{/unless}}
+    {{/each}}
+    {{/if}}
+  ],
+  "children": [
+    {{#if inheritedMembers}}
+    {{#each inheritedMembers}}
+    {
+      "uid": "{{uid}}",
+      "id": 0,
+      "name": "{{name.0.value}}",
+      "fullName": "{{fullName.0.value}}",
+      "kindString": "{{type}}",
+      "inheritedFrom": "{{inheritedFromClass}}",
+      "comment": {
+        "summary": [
+					{
+						"kindString": "text",
+						"text": "{{summary}}"
+					},
+					{
+						"kindString": "code",
+						"text": "{{syntax.content.0.value}}"
+					}
+				]
+      },
+      {{#if syntax}}
+      "syntax": {
+        "parameters": [
+          {{#if syntax.parameters}}
+          {{#each syntax.parameters}}
+          {
+            "name": "{{id}}",
+            "type": "{{type.name.0.value}}",
+            "fullTypeName": "{{type.fullName.0.value}}"
+          }{{#unless @last}},{{/unless}}
+          {{/each}}
+          {{/if}}
+        ],
+        "return": {
+          {{#if syntax.return}}
+          "type": "{{syntax.return.type.name.0.value}}",
+          "fullTypeName": "{{syntax.return.type.fullName.0.value}}"
+          {{/if}}
+        }
+      }
+      {{/if}}
+    }{{#unless @last}},{{/unless}}
+    {{/each}}
+    {{/if}}
+    {{#if children}}
+    {{#each children}}
+    {
+      "uid": "{{uid}}",
+      "id": 0,
+      "name": "{{name.0.value}}",
+      "fullName": "{{fullName.0.value}}",
+      "kindString": "{{type}}",
+      "comment": {
+        "summary": [
+					{
+						"kindString": "text",
+						"text": "{{summary}}"
+					},
+					{
+						"kindString": "code",
+						"text": "{{syntax.content.0.value}}"
+					}
+				]
+      },
+      {{#if syntax}}
+      "syntax": {
+        "parameters": [
+          {{#if syntax.parameters}}
+          {{#each syntax.parameters}}
+          {
+            "name": "{{id}}",
+            "type": "{{type.name.0.value}}",
+            "fullTypeName": "{{type.fullName.0.value}}"
+          }{{#unless @last}},{{/unless}}
+          {{/each}}
+          {{/if}}
+        ],
+        "return": {
+          {{#if syntax.return}}
+          "type": "{{syntax.return.type.name.0.value}}",
+          "fullTypeName": "{{syntax.return.type.fullName.0.value}}"
+          {{/if}}
+        }
+      }
+      {{/if}}
+    }{{#unless @last}},{{/unless}}
+    {{/each}}
+    {{/if}}
+  ]
+}

api-templates/Toc.json.primary.tmpl

@@ -0,0 +1,13 @@
+{
+"name": "{{_assemblyName}}",
+"children": [
+    {{#each items}}
+    {
+        "uid": "{{topicUid}}",
+        "name": "{{name}}",
+        "href": "{{topicHref}}",
+        "kindString": "{{type}}"
+    }{{#unless @last}},{{/unless}}
+    {{/each}}
+]
+}

app/blazor-app.csproj

@@ -1,32 +1,54 @@
-<Project Sdk="Microsoft.NET.Sdk.BlazorWebAssembly">
+<Project Sdk="Microsoft.NET.Sdk.BlazorWebAssembly">
 
   <PropertyGroup>
     <TargetFramework>net6.0</TargetFramework>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
-      <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
+    <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
   </PropertyGroup>
 
   <ItemGroup>
     <PackageReference Include="IgniteUI.Blazor" Version="25.1.86" />
     <PackageReference Include="IgniteUI.Blazor.Documents.Core" Version="25.1.86" />
     <PackageReference Include="IgniteUI.Blazor.Documents.Excel" Version="25.1.86" />
+    <!-- These packages don't have net6.0 TFM, so we reference the DLLs directly below -->
+    <PackageReference Include="IgniteUI.Blazor.GridLite" Version="0.6.0" ExcludeAssets="all" GeneratePathProperty="true" />
+    <PackageReference Include="IgniteUI.Blazor.Lite" Version="0.0.1" ExcludeAssets="all" GeneratePathProperty="true" />
     <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly" Version="6.0.2" />
     <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly.DevServer" Version="6.0.2" PrivateAssets="all" />
   </ItemGroup>
 
+  <!-- Direct reference to the net8.0 DLLs since no net6.0 version exists -->
+  <ItemGroup>
+    <Reference Include="IgniteUI.Blazor.Lite">
+      <HintPath>$(PkgIgniteUI_Blazor_Lite)\lib\net8.0\IgniteUI.Blazor.Lite.dll</HintPath>
+      <Private>true</Private>
+    </Reference>
+    <Reference Include="IgniteUI.Blazor.GridLite">
+      <HintPath>$(PkgIgniteUI_Blazor_GridLite)\lib\net8.0\IgniteUI.Blazor.GridLite.dll</HintPath>
+      <Private>true</Private>
+    </Reference>
+  </ItemGroup>
+
+  <!-- Remove all static web assets from IgniteUI.Blazor.Lite to prevent duplicate asset errors with IgniteUI.Blazor -->
+  <Target Name="RemoveDuplicateLiteAssets" BeforeTargets="ResolveStaticWebAssetsInputs;GenerateStaticWebAssetsManifest">
     <ItemGroup>
-        <Content Include="$(NuGetPackageRoot)\IgniteUI.Blazor\25.1.86\lib\net6.0\IgniteUI.Blazor.xml">
-            <Link>IgniteUI.Blazor.xml</Link>
-            <CopyToOutputDirectory>Always</CopyToOutputDirectory>
-        </Content>
-        <Content Include="$(NuGetPackageRoot)\IgniteUI.Blazor.Documents.Core\25.1.86\lib\net6.0\IgniteUI.Blazor.Documents.Core.xml">
-            <Link>IgniteUI.Blazor.Documents.Core.xml</Link>
-            <CopyToOutputDirectory>Always</CopyToOutputDirectory>
-        </Content>
-        <Content Include="$(NuGetPackageRoot)\IgniteUI.Blazor.Documents.Excel\25.1.86\lib\net6.0\IgniteUI.Blazor.Documents.Excel.xml">
-            <Link>IgniteUI.Blazor.Documents.Excel.xml</Link>
-            <CopyToOutputDirectory>Always</CopyToOutputDirectory>
-        </Content>
+      <StaticWebAsset Remove="@(StaticWebAsset)" Condition="'%(SourceId)' == 'IgniteUI.Blazor.Lite'" />
     </ItemGroup>
+  </Target>
+
+  <ItemGroup>
+    <Content Include="$(NuGetPackageRoot)\IgniteUI.Blazor\25.1.86\lib\net6.0\IgniteUI.Blazor.xml">
+      <Link>IgniteUI.Blazor.xml</Link>
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </Content>
+    <Content Include="$(NuGetPackageRoot)\IgniteUI.Blazor.Documents.Core\25.1.86\lib\net6.0\IgniteUI.Blazor.Documents.Core.xml">
+      <Link>IgniteUI.Blazor.Documents.Core.xml</Link>
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </Content>
+    <Content Include="$(NuGetPackageRoot)\IgniteUI.Blazor.Documents.Excel\25.1.86\lib\net6.0\IgniteUI.Blazor.Documents.Excel.xml">
+      <Link>IgniteUI.Blazor.Documents.Excel.xml</Link>
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </Content>
+  </ItemGroup>
 </Project>

docfx-build-IgniteUI.Blazor.Documents.Core.json

@@ -0,0 +1,30 @@
+{
+  "metadata": [
+    {
+      "src": [
+        {
+          "files": [
+            "src/IgniteUI.Blazor.Documents.Core.dll"
+          ]
+        }
+      ],
+      "dest": "api"
+    }
+  ],
+  "build": {
+    "template": ["api-templates"],
+    "globalMetadata": {
+      "_assemblyName": "IgniteUI.Blazor.Documents.Core"
+    },
+    "content": [
+      {
+        "files": [
+          "api/**.yml",
+          "api/toc.yml"
+        ]
+      }
+    ],
+    "rawModelOutputFolder": "api-raw",
+    "dest": "api-json"
+  }
+}

docfx-build-IgniteUI.Blazor.Documents.Excel.json

@@ -0,0 +1,30 @@
+{
+  "metadata": [
+    {
+      "src": [
+        {
+          "files": [
+            "src/IgniteUI.Blazor.Documents.Excel.dll"
+          ]
+        }
+      ],
+      "dest": "api"
+    }
+  ],
+  "build": {
+    "template": ["api-templates"],
+    "globalMetadata": {
+      "_assemblyName": "IgniteUI.Blazor.Documents.Excel"
+    },
+    "content": [
+      {
+        "files": [
+          "api/**.yml",
+          "api/toc.yml"
+        ]
+      }
+    ],
+    "rawModelOutputFolder": "api-raw",
+    "dest": "api-json"
+  }
+}

docfx-build-IgniteUI.Blazor.GridLite.json

@@ -0,0 +1,31 @@
+{
+  "metadata": [
+    {
+      "src": [
+        {
+          "files": [
+            "src/IgniteUI.Blazor.GridLite.dll"
+          ]
+        }
+      ],
+      "dest": "api",
+      "filter": "IgniteUI.Blazor.GridLite.filterConfig.yml"
+    }
+  ],
+  "build": {
+    "template": ["api-templates"],
+    "globalMetadata": {
+      "_assemblyName": "IgniteUI.Blazor.GridLite"
+    },
+    "content": [
+      {
+        "files": [
+          "api/**.yml",
+          "api/toc.yml"
+        ]
+      }
+    ],
+    "rawModelOutputFolder": "api-raw",
+    "dest": "api-json"
+  }
+}

docfx-build-IgniteUI.Blazor.Lite.json

@@ -0,0 +1,30 @@
+{
+  "metadata": [
+    {
+      "src": [
+        {
+          "files": [
+            "src/IgniteUI.Blazor.Lite.dll"
+          ]
+        }
+      ],
+      "dest": "api"
+    }
+  ],
+  "build": {
+    "template": ["api-templates"],
+    "globalMetadata": {
+      "_assemblyName": "IgniteUI.Blazor.Lite"
+    },
+    "content": [
+      {
+        "files": [
+          "api/**.yml",
+          "api/toc.yml"
+        ]
+      }
+    ],
+    "rawModelOutputFolder": "api-raw",
+    "dest": "api-json"
+  }
+}