feat(*): adding jQuery deploy

.github/skills/xplat-docs-api-links/SKILL.md → .github/skills/api-link/SKILL.md

@@ -1,20 +1,25 @@
 ---
-name: xplat-docs-api-links
-description: "Reference guide for adding and fixing ApiLink and ApiRef components in xplat MDX documentation files. Covers pkg, type, kind, member, prefixed, suffix, and label props; platform prefix mapping (Igr/Igx/Igc/Igb); kind values from TypeDoc JSON; utility class suffix rules; excel library special rules (prefixed={false}, IgniteUI.Blazor.Documents.Excel); dock manager slot members; and MDX parse error from JSX in comments. Use when an agent needs to add, fix, or audit ApiLink/ApiRef calls in MDX files."
+name: api-link
+description: "Reference guide for adding and fixing ApiLink and ApiRef components in MDX documentation files. Covers all platforms: Angular, React, WebComponents, Blazor (TypeDoc URLs) and jQuery (jQueryApiUrl). Covers pkg, type, kind, member, section, prefixed, suffix, and label props; platform prefix mapping (Igr/Igx/Igc/Igb); kind values from TypeDoc JSON; utility class suffix rules; excel library special rules; dock manager slot members; jQuery widget/class URL patterns; and MDX parse error from JSX in comments. Use when an agent needs to add, fix, or audit ApiLink/ApiRef calls in MDX files."
 user-invocable: true
 ---
 
 # AI Agent Guide — Updating ApiLink & ApiRef in MDX Files
 
 ## Context
 
-The MDX files in this folder are shared across four platforms: **Angular, React, WebComponents, Blazor**. The `<ApiLink>` and `<ApiRef>` components resolve to the correct platform-specific URL at build time from a single MDX source.
+The `<ApiLink>` and `<ApiRef>` components resolve to the correct platform-specific API URL at build time.
 
-> **Key insight:** The `type=`, `member=`, `pkg=`, and `kind=` attributes are **identical for all platforms**. Fixing an ApiLink fixes it for all four platforms simultaneously. Only the generated URL differs per platform.
+- **Angular, React, WebComponents, Blazor** (`docs/angular`, `docs/xplat`) — TypeDoc URLs, resolved from hardcoded `docRoot` values in `platform-context.ts` (host swapped per environment: `staging.infragistics.com` for staging, `www.infragistics.com` for production). Steps 1–9 below apply to all four of these platforms.
+- **jQuery** (`docs/jquery`) — URL resolved from `jQueryApiUrl` in `environment.json` at build time. Different URL structure — see the **jQuery API Links** section below.
+
+**Shared MDX files** (`docs/xplat`) are built for all four TypeDoc platforms from a single source. Fixing an `<ApiLink>` there fixes it for Angular, React, WebComponents, and Blazor simultaneously.
+
+**Angular-specific MDX files** (`docs/angular`) are built only for Angular. The same `<ApiLink>` props, `pkg` keys, and `kind` rules from Steps 1–9 apply — the only difference is that there is no multi-platform concern.
 
 ---
 
-## Step 1 — Locate the API Source Data
+## Step 1 — Locate the API Source Data (xplat platforms)
 
 The `api-docs` project (sibling to this docs repository) contains TypeDoc JSON files that are the **authoritative source** for which class owns which member. Find the project by its folder name `api-docs` — the exact path on disk depends on the machine.
 Alternatively get the source from this github repository - https://github.com/IgniteUI/api-docs
@@ -60,7 +65,7 @@ Each JSON file is a TypeDoc reflection tree. Top-level `children` contains all e
 
 ---
 
-## Step 2 — Understand the MDX ApiLink Syntax
+## Step 2 — Understand the MDX ApiLink Syntax (xplat)
 
 ```mdx
 <ApiLink pkg="grids" type="TypeName" kind="class" member="memberName" prefixed={false} label="DisplayText" />
@@ -352,7 +357,96 @@ Fix: replace JSX numeric props with string values inside comments:
 
 ---
 
-## Step 8 — Fix Pattern
+## jQuery API Links
+
+jQuery docs live in `docs/jquery/` and use a completely different URL structure from the TypeDoc platforms.
+
+### How it works
+
+The jQuery build resolves `ApiLink` URLs from `jQueryApiUrl` in `docs/jquery/src/content/en/environment.json`:
+
+| Build mode | `jQueryApiUrl` |
+|---|---|
+| development | `https://www.infragistics.com/products/ignite-ui/docs/api/js` |
+| staging | `https://staging.infragistics.com/products/ignite-ui/docs/api/js` |
+| production | `https://www.infragistics.com/products/ignite-ui/docs/api/js` |
+
+Platform is identified via `docs/jquery/.platform.json` (`"platform": "jQuery"`). The build reads this file, resolves to the `jQuery` platform context, and `ApiLink.astro` uses `getEnvVars().jQueryApiUrl` as the base URL.
+
+### jQuery URL structure
+
+```
+{jQueryApiUrl}/{namespace}.{widgetName}[#{section}:{member}]
+```
+
+- **`namespace`**: `ui` for jQuery UI widgets (default), `ig` for standalone classes/datasources
+- **`widgetName`**: the widget or class name as-is (e.g. `igCombo`, `igGrid`, `igBulletGraph`, `OlapXmlaDataSource`)
+- **`section`**: `options`, `events`, or `methods` — only used when `member` is present
+- **`member`**: the specific option/event/method name
+
+### jQuery `<ApiLink>` props
+
+| Attribute | Notes |
+|---|---|
+| `type` | Widget or class name as it appears in the jQuery API URL (e.g. `"igCombo"`, `"igBulletGraph"`, `"OlapXmlaDataSource"`). No platform prefix — jQuery has none. |
+| `pkg` | `"core"` (default) → `ui.` namespace. `"ig"` → `ig.` namespace. |
+| `section` | `"options"` \| `"events"` \| `"methods"`. Required when `member` is set for the anchor to be appended. |
+| `member` | The option, event, or method name. Combined with `section` to produce `#section:member`. |
+| `label` | Override display text. Recommended — defaults to `type.member` which may not match the original link text. |
+| `kind`, `prefixed`, `suffix` | Not applicable for jQuery. Ignored. |
+
+### Examples
+
+```mdx
+import ApiLink from 'docs-template/components/mdx/ApiLink.astro';
+
+<!-- Link to a widget page -->
+<ApiLink type="igCombo" label="igCombo" />
+<!-- → https://www.infragistics.com/products/ignite-ui/docs/api/js/ui.igCombo -->
+
+<!-- Widget option -->
+<ApiLink type="igCombo" member="itemTemplate" section="options" label="itemTemplate" />
+<!-- → …/ui.igCombo#options:itemTemplate -->
+
+<!-- Widget event -->
+<ApiLink type="igCombo" member="activeItemChanged" section="events" label="activeItemChanged" />
+<!-- → …/ui.igCombo#events:activeItemChanged -->
+
+<!-- Widget method -->
+<ApiLink type="igGrid" member="dataBind" section="methods" label="dataBind" />
+<!-- → …/ui.igGrid#methods:dataBind -->
+
+<!-- ig. namespace class (datasource, non-widget) -->
+<ApiLink pkg="ig" type="OlapXmlaDataSource" label="OlapXmlaDataSource" />
+<!-- → …/ig.OlapXmlaDataSource -->
+```
+
+### Replacing `{environment:jQueryApiUrl}` tokens
+
+Old raw link in MDX:
+```mdx
+[`itemTemplate`]({environment:jQueryApiUrl}/ui.igcombo#options:itemTemplate)
+```
+
+Replacement with `<ApiLink>`:
+```mdx
+<ApiLink type="igCombo" member="itemTemplate" section="options" label="itemTemplate" />
+```
+
+Note: the old raw URLs often use all-lowercase widget names (e.g. `ui.igcombo`). The jQuery API site accepts both, but use the camelCase form in `ApiLink` `type=` for consistency (e.g. `"igCombo"` not `"igcombo"`).
+
+### Configuration files
+
+| File | Role |
+|---|---|
+| `docs/jquery/.platform.json` | Identifies the jQuery platform (`"platform": "jQuery"`) so `getPlatformContext()` returns the jQuery context |
+| `docs/jquery/src/content/en/environment.json` | Contains `jQueryApiUrl` per build mode (development / staging / production) |
+| `src/lib/platform-context.ts` | `jQuery` entry in `PLATFORMS` — `prefix: ''`, `apiPackages.core` (ui. namespace), `apiPackages.ig` (ig. namespace) |
+| `src/components/mdx/ApiLink.astro` | jQuery branch: reads `getEnvVars().jQueryApiUrl`, builds `{baseUrl}/{ns}.{type}[#{section}:{member}]` |
+
+---
+
+## Step 8 — Fix Pattern (xplat)
 
 ### Column-level fix
 
@@ -412,9 +506,11 @@ Rules:
 
 | File | Role |
 |---|---|
-| `src/components/mdx/ApiLink.astro` | ApiLink component — URL generation logic |
+| `src/components/mdx/ApiLink.astro` | ApiLink component — URL generation logic (xplat TypeDoc + jQuery) |
 | `src/components/mdx/ApiRef.astro` | ApiRef component |
-| `src/lib/platform-context.ts` | Platform config, `docRoot` URLs per platform, prefix mapping |
+| `src/lib/platform-context.ts` | Platform config, `docRoot` URLs per platform, prefix mapping, jQuery placeholder packages |
+| `docs/jquery/.platform.json` | jQuery platform identifier |
+| `docs/jquery/src/content/en/environment.json` | jQuery environment URLs including `jQueryApiUrl` |
 | `api-docs/src/data/react/igniteui-react-grids.json` | TypeDoc JSON — React grids (primary reference) |
 | `api-docs/src/data/react/igniteui-react.json` | TypeDoc JSON — React core |
 | `api-docs/src/data/angular/igniteui-angular-21.0.x.json` | TypeDoc JSON — Angular |

.github/workflows/_cd-deploy.yml

@@ -3,6 +3,10 @@ name: _CD Deploy (reusable)
 on:
   workflow_call:
     inputs:
+      platform:
+        description: 'Platform to build (angular, react, wc, blazor, jquery)'
+        required: true
+        type: string
       locale:
         description: 'Locale to build (en or jp)'
         required: true
@@ -26,43 +30,39 @@ jobs:
     name: Build and Deploy
     runs-on: ubuntu-latest
 
-    strategy:
-      matrix:
-        platform: ['angular', 'react', 'wc', 'blazor']
-
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           ref: ${{ inputs.target_ref }}
           clean: true
           fetch-tags: true
           fetch-depth: 0
 
-      - name: Setup Node.js 22.x
-        uses: actions/setup-node@v4
+      - name: Setup Node.js 24.x
+        uses: actions/setup-node@v6
         with:
-          node-version: '22.x'
+          node-version: '24.x'
 
       - name: Install dependencies
         run: npm ci
 
-      - name: Build Documentation for ${{ matrix.platform }} (${{ inputs.locale }})
-        run: npm run build:${{ env.BUILD_TYPE }}:${{ matrix.platform }}:${{ inputs.locale }}
+      - name: Build Documentation for ${{ inputs.platform }} (${{ inputs.locale }})
+        run: npm run build:${{ env.BUILD_TYPE }}:${{ inputs.platform }}:${{ inputs.locale }}
 
       - name: Package build
         run: |
           LOCALE="${{ inputs.locale }}"
-          DIST_DIR="dist/${{ matrix.platform }}$([[ "$LOCALE" == 'en' ]] && echo '' || echo "-$LOCALE")"
+          DIST_DIR="dist/${{ inputs.platform }}$([[ "$LOCALE" == 'en' ]] && echo '' || echo "-$LOCALE")"
           cd "$DIST_DIR"
-          zip -r ../../${{ env.BUILD_TYPE }}_${{ matrix.platform }}_${{ inputs.locale }}.zip .
+          zip -r ../../${{ env.BUILD_TYPE }}_${{ inputs.platform }}_${{ inputs.locale }}.zip .
           cd ../..
 
       - name: Upload artifact
         uses: actions/upload-artifact@v4
         with:
-          name: igniteui-docs-${{ matrix.platform }}-${{ inputs.locale }}
-          path: ${{ env.BUILD_TYPE }}_${{ matrix.platform }}_${{ inputs.locale }}.zip
+          name: igniteui-docs-${{ inputs.platform }}-${{ inputs.locale }}
+          path: ${{ env.BUILD_TYPE }}_${{ inputs.platform }}_${{ inputs.locale }}.zip
           retention-days: 1
 
       - name: Trigger Deploy Workflow in IgniteUI Actions
@@ -77,11 +77,12 @@ jobs:
               client_payload: {
                 calling_branch: "${{ inputs.target_ref }}",
                 environment: "${{ env.BUILD_TYPE }}",
-                artifact_name: "igniteui-docs-${{ matrix.platform }}-${{ inputs.locale }}",
-                base_href: "docs-${{ matrix.platform }}-new",
-                platform: "${{ matrix.platform }}",
+                artifact_name: "igniteui-docs-${{ inputs.platform }}-${{ inputs.locale }}",
+                base_href: "docs-${{ inputs.platform }}-new",
+                platform: "${{ inputs.platform }}",
                 repository: "${{ github.repository }}",
                 run_id: "${{ github.run_id }}",
-                locale: "${{ inputs.locale }}"
+                locale: "${{ inputs.locale }}",
+                deploy_igniteui: ${{ inputs.platform == 'jquery' }}
               }
             });

.github/workflows/cd-angular-en.yml

@@ -0,0 +1,34 @@
+name: Build And Deploy Angular Documentation EN
+
+permissions:
+  contents: read
+
+on:
+  push:
+    branches:
+      - vnext
+      - master
+    paths-ignore:
+      - 'docs/jquery/**'
+      - 'docs/xplat/**'
+      - 'docs/wpf/**'
+      - 'docs/winforms/**'
+      - 'docs/aspnet/**'
+      - '**/jp/**'
+      - '**/kr/**'
+  workflow_dispatch:
+    inputs:
+      branch:
+        description: 'Branch to checkout'
+        type: string
+        default: 'vnext'
+
+jobs:
+  deploy:
+    uses: ./.github/workflows/_cd-deploy.yml
+    with:
+      locale: en
+      platform: angular
+      target_ref: ${{ github.event.inputs.branch && (startsWith(github.event.inputs.branch, 'refs/') && github.event.inputs.branch || format('refs/heads/{0}', github.event.inputs.branch)) || github.ref }}
+    secrets:
+      CLASSIC_PAT_GITHUB: ${{ secrets.CLASSIC_PAT_GITHUB }}

.github/workflows/cd-angular-jp.yml

@@ -0,0 +1,34 @@
+name: Build And Deploy Angular Documentation JP
+
+permissions:
+  contents: read
+
+on:
+  push:
+    branches:
+      - vnext
+      - master
+    paths-ignore:
+      - 'docs/jquery/**'
+      - 'docs/xplat/**'
+      - 'docs/wpf/**'
+      - 'docs/winforms/**'
+      - 'docs/aspnet/**'
+      - '**/en/**'
+      - '**/kr/**'
+  workflow_dispatch:
+    inputs:
+      branch:
+        description: 'Branch to checkout'
+        type: string
+        default: 'vnext'
+
+jobs:
+  deploy:
+    uses: ./.github/workflows/_cd-deploy.yml
+    with:
+      locale: jp
+      platform: angular
+      target_ref: ${{ github.event.inputs.branch && (startsWith(github.event.inputs.branch, 'refs/') && github.event.inputs.branch || format('refs/heads/{0}', github.event.inputs.branch)) || github.ref }}
+    secrets:
+      CLASSIC_PAT_GITHUB: ${{ secrets.CLASSIC_PAT_GITHUB }}

.github/workflows/cd-en.yml → .github/workflows/cd-jquery-en.yml

@@ -1,4 +1,4 @@
-name: Build And Deploy Documentation EN
+name: Build And Deploy jQuery Documentation EN
 
 permissions:
   contents: read
@@ -9,6 +9,11 @@ on:
       - vnext
       - master
     paths-ignore:
+      - 'docs/angular/**'
+      - 'docs/xplat/**'
+      - 'docs/wpf/**'
+      - 'docs/winforms/**'
+      - 'docs/aspnet/**'
       - '**/jp/**'
       - '**/kr/**'
   workflow_dispatch:
@@ -23,6 +28,7 @@ jobs:
     uses: ./.github/workflows/_cd-deploy.yml
     with:
       locale: en
+      platform: jquery
       target_ref: ${{ github.event.inputs.branch && (startsWith(github.event.inputs.branch, 'refs/') && github.event.inputs.branch || format('refs/heads/{0}', github.event.inputs.branch)) || github.ref }}
     secrets:
       CLASSIC_PAT_GITHUB: ${{ secrets.CLASSIC_PAT_GITHUB }}

.github/workflows/cd-jp.yml → .github/workflows/cd-jquery-jp.yml

@@ -1,4 +1,4 @@
-name: Build And Deploy Documentation JP
+name: Build And Deploy jQuery Documentation JP
 
 permissions:
   contents: read
@@ -9,6 +9,11 @@ on:
       - vnext
       - master
     paths-ignore:
+      - 'docs/angular/**'
+      - 'docs/xplat/**'
+      - 'docs/wpf/**'
+      - 'docs/winforms/**'
+      - 'docs/aspnet/**'
       - '**/en/**'
       - '**/kr/**'
   workflow_dispatch:
@@ -23,6 +28,7 @@ jobs:
     uses: ./.github/workflows/_cd-deploy.yml
     with:
       locale: jp
+      platform: jquery
       target_ref: ${{ github.event.inputs.branch && (startsWith(github.event.inputs.branch, 'refs/') && github.event.inputs.branch || format('refs/heads/{0}', github.event.inputs.branch)) || github.ref }}
     secrets:
       CLASSIC_PAT_GITHUB: ${{ secrets.CLASSIC_PAT_GITHUB }}

.github/workflows/cd-xplat-en.yml

@@ -0,0 +1,38 @@
+name: Build And Deploy XPlat Documentation EN
+
+permissions:
+  contents: read
+
+on:
+  push:
+    branches:
+      - vnext
+      - master
+    paths-ignore:
+      - 'docs/jquery/**'
+      - 'docs/angular/**'
+      - 'docs/wpf/**'
+      - 'docs/winforms/**'
+      - 'docs/aspnet/**'
+      - '**/jp/**'
+      - '**/kr/**'
+  workflow_dispatch:
+    inputs:
+      branch:
+        description: 'Branch to checkout'
+        type: string
+        default: 'vnext'
+
+jobs:
+  deploy:
+    strategy:
+      matrix:
+        platform: ['react', 'wc', 'blazor']
+
+    uses: ./.github/workflows/_cd-deploy.yml
+    with:
+      locale: en
+      platform: ${{ matrix.platform }}
+      target_ref: ${{ github.event.inputs.branch && (startsWith(github.event.inputs.branch, 'refs/') && github.event.inputs.branch || format('refs/heads/{0}', github.event.inputs.branch)) || github.ref }}
+    secrets:
+      CLASSIC_PAT_GITHUB: ${{ secrets.CLASSIC_PAT_GITHUB }}