sroucheray · Dec 7, 2022 · Dec 7, 2022 · Dec 7, 2022 · Dec 7, 2022 · Dec 7, 2022
diff --git a/.agents/agents/rapidoc-core.md b/.agents/agents/rapidoc-core.md
@@ -7,13 +7,13 @@ You are a specialist agent dedicated to `packages/rapidoc` — the core Lit-base
 
 ## Workspace Scope & Key Paths
 - **Package Directory**: `packages/rapidoc`
-- **Component Entry**: `packages/rapidoc/src/index.js`
-- **Main Custom Element**: `packages/rapidoc/src/rapidoc.js`
+- **Component Entry**: `packages/rapidoc/src/index.ts`
+- **Main Custom Element**: `packages/rapidoc/src/rapidoc.ts`
 - **Parser & Schema Utilities**:
-  - `packages/rapidoc/src/utils/spec-parser.js`
-  - `packages/rapidoc/src/utils/schema-ast.js`
-  - `packages/rapidoc/src/utils/schema-utils.js`
-  - `packages/rapidoc/src/utils/mock-interceptor.js`
+  - `packages/rapidoc/src/utils/spec-parser.ts`
+  - `packages/rapidoc/src/utils/schema-ast.ts`
+  - `packages/rapidoc/src/utils/schema-utils.ts`
+  - `packages/rapidoc/src/utils/mock-interceptor.ts`
 - **Sub-templates**: `packages/rapidoc/src/templates/`
 - **Styles**: `packages/rapidoc/src/styles/`
 - **Tests**: `tests/unit/*.test.js`, `tests/perf/benchmark.js`

diff --git a/README.md b/README.md
@@ -121,7 +121,7 @@ npm run dev
 npm run stop
 ```
 - Open `http://localhost:4321` in your browser.
-- **Live Unminified ES Modules:** In development mode (`npm run dev`), the Astro dev server bypasses pre-compiled production bundles and serves live ES modules directly from `packages/rapidoc/src/index.js`.
+- **Live Unminified ES Modules:** In development mode (`npm run dev`), the Astro dev server bypasses pre-compiled production bundles and serves live ES modules directly from `packages/rapidoc/src/index.ts`.
 - **Full DevTools & Console Visibility:** All `console.log`, `console.warn`, `console.error`, and `debugger` breakpoints remain completely intact with original file names and exact line numbers (e.g., `rapidoc.js:516`).
 - **Instant Browser Reloading:** Component changes in `packages/rapidoc/src/` trigger immediate hot reloads without waiting for a full Rollup/Vite compilation cycle.
 
@@ -159,7 +159,7 @@ Astro documentation and example pages include the component via `<script type="m
 
 1. **During Local Development (`npm run dev`):**
    - The Astro dev server middleware (in `docs/astro.config.mjs`) **intercepts** all requests for `/rapidoc/rapidoc-min.js` (and `/rapidoc/rapidoc.js`).
-   - Instead of reading any pre-built static file, it directly imports and serves `packages/rapidoc/src/index.js` live through Vite's module pipeline.
+   - Instead of reading any pre-built static file, it directly imports and serves `packages/rapidoc/src/index.ts` live through Vite's module pipeline.
    - You get instant HMR, unminified source code, active `console.*` logging, and sourcemaps with exact line numbers in browser DevTools. Neither `dist/` nor `generated-docs/` is served during development.
 
 2. **During Production Site Build (`npm run build:docs` / `npm run build`):**
@@ -200,7 +200,7 @@ All primary commands can be run from the root of the repository:
 #### Code Quality & Formatting
 | Command | Workspace | Description |
 |---|---|---|
-| `npm run lint` | `rapidoc` | Runs ESLint on `packages/rapidoc/src/**/*.js` with Lit rules. |
+| `npm run lint` | `rapidoc` | Runs ESLint on `packages/rapidoc/src/**/*.{js,ts}` with Lit rules. |
 | `npm run analyze` | `rapidoc` | Runs Lit Analyzer to validate custom element templates and bindings. |
 | `npm run format` | Monorepo | Checks code formatting against `.prettierrc` across packages and docs. |
 | `npm run format-fix` | Monorepo | Automatically formats code using Prettier across packages and docs. |

diff --git a/docs/AGENTS.md b/docs/AGENTS.md
@@ -27,14 +27,14 @@ The `docs/astro.config.mjs` integrates Vite plugins that bridge `docs` and `pack
    - Checks if `packages/rapidoc/dist/rapidoc-min.js` exists. If missing, triggers a Vite build of `packages/rapidoc`.
    - Copies `rapidoc-min.js` into `docs/dist/rapidoc/` and `docs/generated-docs/rapidoc/`.
 2. **Live Unminified Source in Dev (`serve-rapidoc-in-dev`)**:
-   - Dev middleware dynamically serves live unminified ESM directly from `packages/rapidoc/src/index.js` at `/rapidoc/rapidoc-min.js` and `/rapidoc/rapidoc.js`.
+   - Dev middleware dynamically serves live unminified ESM directly from `packages/rapidoc/src/index.ts` at `/rapidoc/rapidoc-min.js` and `/rapidoc/rapidoc.js`.
    - Preserves all `console.*` outputs, `debugger` breakpoints, and sourcemaps with exact line numbers for effortless debugging.
    - Watches `packages/rapidoc/src/` and triggers instant browser reload upon changes without needing slow bundle recompilation.
    - Watches `src/page-data/**/*.yaml` and triggers module cache invalidation and reload upon change.
 3. **Aliases**:
    - `~` resolves to `packages/rapidoc/src`
-   - `~/rapidoc` resolves to `packages/rapidoc/src/rapidoc.js`
-   - `rapidoc` resolves to `packages/rapidoc/src/index.js`
+   - `~/rapidoc` resolves to `packages/rapidoc/src/rapidoc.ts`
+   - `rapidoc` resolves to `packages/rapidoc/src/index.ts`
 
 ---
 

diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
@@ -130,10 +130,10 @@ export default defineConfig({
     resolve: {
       alias: {
         '~': rapidocSrcPath,
-        '~/rapidoc': resolve(rapidocSrcPath, 'rapidoc.js'),
-        '~/rapidoc-mini': resolve(rapidocSrcPath, 'rapidoc-mini.js'),
-        '~/oauth-receiver': resolve(rapidocSrcPath, 'oauth-receiver.js'),
-        rapidoc: resolve(rapidocSrcPath, 'index.js'),
+        '~/rapidoc': resolve(rapidocSrcPath, 'rapidoc.ts'),
+        '~/rapidoc-mini': resolve(rapidocSrcPath, 'rapidoc-mini.ts'),
+        '~/oauth-receiver': resolve(rapidocSrcPath, 'oauth-receiver.ts'),
+        rapidoc: resolve(rapidocSrcPath, 'index.ts'),
       },
     },
     server: {
@@ -179,7 +179,7 @@ export default defineConfig({
             if (pathname === '/rapidoc/rapidoc-min.js' || pathname === '/rapidoc/rapidoc.js') {
               res.setHeader('Content-Type', 'application/javascript; charset=utf-8');
               res.setHeader('Cache-Control', 'no-cache');
-              res.end(`import '/@fs${resolve(rapidocSrcPath, 'index.js')}';\n`);
+              res.end(`import '/@fs${resolve(rapidocSrcPath, 'index.ts')}';\n`);
               return;
             }
             next();

diff --git a/docs/src/page-data/rapidoc-build-info.json b/docs/src/page-data/rapidoc-build-info.json
@@ -3,19 +3,19 @@
   "version": "10.1.0",
   "versionTag": "v10.1.0",
   "versionShort": "v10.1",
-  "buildTime": "2026-10-06T10:10:24.057Z",
+  "buildTime": "2026-10-09T20:03:31.232Z",
   "bundle": {
     "minified": {
-      "bytes": 503029,
-      "formatted": "491 KB",
-      "kb": 491,
-      "exactKb": 491.2
+      "bytes": 510630,
+      "formatted": "499 KB",
+      "kb": 499,
+      "exactKb": 498.7
     },
     "gzip": {
-      "bytes": 132830,
-      "formatted": "130 KB",
-      "kb": 130,
-      "exactKb": 129.7
+      "bytes": 135442,
+      "formatted": "132 KB",
+      "kb": 132,
+      "exactKb": 132.3
     }
   }
 }
diff --git a/docs/src/page-data/rapidoc-build-info.yaml b/docs/src/page-data/rapidoc-build-info.yaml
@@ -3,15 +3,15 @@ name: "rapidoc"
 version: "10.1.0"
 versionTag: "v10.1.0"
 versionShort: "v10.1"
-buildTime: "2026-10-06T10:10:24.057Z"
+buildTime: "2026-10-09T20:03:31.232Z"
 bundle:
   minified:
-    bytes: 503029
-    formatted: "491 KB"
-    kb: 491
-    exactKb: 491.2
+    bytes: 510630
+    formatted: "499 KB"
+    kb: 499
+    exactKb: 498.7
   gzip:
-    bytes: 132830
-    formatted: "130 KB"
-    kb: 130
-    exactKb: 129.7
+    bytes: 135442
+    formatted: "132 KB"
+    kb: 132
+    exactKb: 132.3
diff --git a/eslint.config.js b/eslint.config.js
@@ -1,4 +1,5 @@
 import globals from 'globals';
+import tseslint from 'typescript-eslint';
 import pluginJs from '@eslint/js';
 import { configs as litConfigs } from 'eslint-plugin-lit';
 import eslintConfigPrettier from 'eslint-config-prettier';
@@ -17,8 +18,9 @@ export default [
   },
   pluginJs.configs.recommended, // ESLint recommended
   litConfigs['flat/recommended'], // Lit recommended
+  ...tseslint.configs.recommended.map((config) => ({ ...config, files: ['**/*.ts'] })), // TypeScript recommended (ts files only)
   {
-    files: ['**/*.js'],
+    files: ['**/*.js', '**/*.ts'],
     plugins: {
       prettier: eslintPluginPrettier, // Add Prettier plugin
     },
@@ -36,6 +38,8 @@ export default [
       ],
       ...eslintConfigPrettier.rules, // Disable conflicting ESLint rules
       'lit/attribute-value-entities': 'off',
+      // OpenAPI documents are deeply dynamic; `any` is tolerated (warned) where precise typing is impractical
+      '@typescript-eslint/no-explicit-any': 'warn',
       'no-useless-assignment': 'warn',
       'no-console': process.env.NODE_ENV === 'production' ? 'warn' : 'off',
       'no-debugger': process.env.NODE_ENV === 'production' ? 'warn' : 'off',