Migrate core JavaScript to TypeScript (#2582)

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

docs/.build/vite.config.mjs

@@ -1,15 +0,0 @@
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { createViteConfig } from '../../.build/vite.config.helper.mjs'
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-
-export default createViteConfig({
-	entry: path.resolve(__dirname, '../js/docs.js'),
-	name: 'docs',
-	fileName: () => 'docs.js',
-	formats: ['es'],
-	outDir: path.resolve(__dirname, '../dist/js'),
-	banner: undefined
-})
-

docs/.build/vite.config.ts

@@ -0,0 +1,25 @@
+import path from 'node:path'
+import process from 'node:process'
+import { fileURLToPath } from 'node:url'
+import { existsSync } from 'node:fs'
+import { createViteConfig } from '../../.build/vite.config.helper'
+import getBanner from '../../shared/banner/index.mjs'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+const MINIFY = process.env.MINIFY === 'true'
+
+// Try .ts first, fallback to .js for gradual migration
+const entryPath = path.resolve(__dirname, '../js/docs')
+const entry = existsSync(`${entryPath}.ts`) ? `${entryPath}.ts` : `${entryPath}.js`
+
+export default createViteConfig({
+	entry: entry,
+	name: 'docs',
+	fileName: () => MINIFY ? 'docs.min.js' : 'docs.js',
+	formats: ['es'],
+	outDir: path.resolve(__dirname, '../dist/js'),
+	banner: undefined,
+	minify: MINIFY
+})
+

docs/js/docs.ts

@@ -1,8 +1,9 @@
-import docsearch from '@docsearch/js';
+import docsearch from '@docsearch/js'
 
 docsearch({
 	container: '#docsearch',
 	appId: "NE1EGTYLS9",
 	indexName: "tabler",
 	apiKey: "016353235ef1dd32a6c392be0e939058",
-});
+})
+

docs/package.json

@@ -7,12 +7,12 @@
     "build": "pnpm run clean && pnpm run build-assets && pnpm run html",
     "build-assets": "concurrently \"pnpm run js\" \"pnpm run css\"",
     "html": "eleventy",
-    "js": "pnpm run js-compile && pnpm run js-minify",
-    "js-compile": "vite build --config .build/vite.config.mjs",
-    "js-minify": "pnpm run js-minify-docs",
-    "js-minify-docs": "terser --compress passes=2 --mangle --comments \"/^!/\" --source-map \"content=dist/js/docs.js.map,includeSources,url=docs.min.js.map\" --output dist/js/docs.min.js dist/js/docs.js",
-    "css": "pnpm run css-compile && pnpm run css-prefix && pnpm run css-minify",
-    "css-compile": "sass scss/:dist/css/ --no-source-map --load-path=./node_modules",
+    "js": "pnpm run js-build && pnpm run js-build-min",
+    "js-build": "vite build --config .build/vite.config.ts",
+    "js-build-min": "pnpm run js-build-min-docs",
+    "js-build-min-docs": "cross-env MINIFY=true vite build --config .build/vite.config.ts",
+    "css": "pnpm run css-build && pnpm run css-prefix && pnpm run css-minify",
+    "css-build": "sass scss/:dist/css/ --no-source-map --load-path=./node_modules",
     "css-prefix": "postcss --config .build/postcss.config.mjs --replace \"dist/css/*.css\" \"!dist/css/*.rtl*.css\" \"!dist/css/*.min.css\"",
     "css-minify": "cleancss -O1 --format breakWith=lf --with-rebase --source-map --source-map-inline-sources --output dist/css/ --batch --batch-suffix \".min\" \"dist/css/*.css\" \"!dist/css/*.min.css\" \"!dist/css/*rtl*.css\"",
     "dev": "pnpm run clean && pnpm run watch",