Migrate kg-default-nodes to TypeScript

- Remove Rollup build (rollup.config.mjs, rollup-plugin-svg, @babel/*)
- Move lib/ to src/, rename .js to .ts
- Add tsconfig.json (strict, NodeNext, ESM)
- Add "type": "module" to package.json
- Convert 100 source files and 36 test files to ESM with Lexical types
- Inline SVG import in AtLinkNode (replaces rollup-plugin-svg)
- Replace .eslintrc.js with eslint.config.js (flat config)
- Output to build/ via tsc (replaces cjs/ and es/ dirs)
- 668 tests passing

Author: kevinansfield

packages/kg-default-nodes/eslint.config.mjs

@@ -1,45 +1,41 @@
-import {fixupPluginRules} from '@eslint/compat';
 import eslint from '@eslint/js';
+import {defineConfig} from 'eslint/config';
 import ghostPlugin from 'eslint-plugin-ghost';
-import globals from 'globals';
+import tseslint from 'typescript-eslint';
 
-const ghost = fixupPluginRules(ghostPlugin);
-
-export default [
-    {ignores: ['build/**', 'cjs/**', 'es/**']},
-    eslint.configs.recommended,
-    {
-        files: ['**/*.{js,mjs}'],
-        plugins: {ghost},
-        languageOptions: {
-            globals: {
-                ...globals.node,
-                ...globals.browser
-            }
-        },
-        rules: {
-            ...ghostPlugin.configs.node.rules,
-            // match ESLint 8 behavior for catch clause variables
-            'no-unused-vars': ['error', {caughtErrors: 'none'}],
-            // disable rules incompatible with ESLint 9 flat config
-            'ghost/filenames/match-exported-class': 'off',
-            'ghost/filenames/match-exported': 'off',
-            'ghost/filenames/match-regex': 'off'
-        }
+export default defineConfig([
+  { ignores: ['build/**'] },
+  {
+    files: ['**/*.ts'],
+    extends: [
+      eslint.configs.recommended,
+      tseslint.configs.recommended,
+    ],
+    languageOptions: {
+      parserOptions: { ecmaVersion: 2022, sourceType: 'module' },
+    },
+    plugins: { ghost: ghostPlugin },
+    rules: {
+      ...ghostPlugin.configs.ts.rules,
+      '@typescript-eslint/no-explicit-any': 'error',
+    },
+  },
+  {
+    files: ['src/**/*.ts'],
+    rules: {
+      '@typescript-eslint/no-unsafe-declaration-merging': 'off',
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_', varsIgnorePattern: '^_' }],
+    },
+  },
+  {
+    files: ['test/**/*.ts'],
+    rules: {
+      ...ghostPlugin.configs['ts-test'].rules,
+      'ghost/mocha/no-global-tests': 'off',
+      'ghost/mocha/handle-done-callback': 'off',
+      'ghost/mocha/no-mocha-arrows': 'off',
+      'ghost/mocha/max-top-level-suites': 'off',
+      'ghost/mocha/no-setup-in-describe': 'off',
     },
-    {
-        files: ['test/**/*.{js,mjs}'],
-        plugins: {ghost},
-        languageOptions: {
-            globals: {
-                ...globals.node,
-                ...globals.mocha,
-                should: true,
-                sinon: true
-            }
-        },
-        rules: {
-            ...ghostPlugin.configs.test.rules
-        }
-    }
-];
+  },
+]);

packages/kg-default-nodes/index.js

@@ -4,44 +4,56 @@
   "repository": "https://github.com/TryGhost/Koenig/tree/main/packages/kg-default-nodes",
   "author": "Ghost Foundation",
   "license": "MIT",
-  "main": "cjs/kg-default-nodes.js",
-  "module": "es/kg-default-nodes.js",
-  "source": "lib/kg-default-nodes.js",
+  "main": "build/cjs/index.js",
+  "module": "build/esm/index.js",
+  "types": "build/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/esm/index.d.ts",
+      "import": "./build/esm/index.js",
+      "require": "./build/cjs/index.js"
+    }
+  },
   "scripts": {
-    "dev": "rollup -c -w",
-    "build": "rollup -c",
-    "prepare": "NODE_ENV=production yarn build",
-    "pretest": "yarn build",
-    "test:unit": "NODE_ENV=testing c8 --all --check-coverage --reporter text --reporter cobertura mocha './test/**/*.test.*js'",
+    "dev": "tsc --watch --preserveWatchOutput",
+    "build": "tsc && tsc -p tsconfig.cjs.json && echo '{\"type\":\"module\"}' > build/esm/package.json",
+    "prepare": "tsc && tsc -p tsconfig.cjs.json && echo '{\"type\":\"module\"}' > build/esm/package.json",
+    "pretest": "tsc && tsc -p tsconfig.cjs.json && echo '{\"type\":\"module\"}' > build/esm/package.json && tsc -p tsconfig.test.json",
+    "test:unit": "NODE_ENV=testing c8 --src src --all --check-coverage --reporter text --reporter cobertura mocha --require tsx './test/**/*.test.ts'",
     "test": "yarn test:unit",
-    "test:no-coverage": "yarn pretest && mocha './test/**/*.test.*js'",
-    "lint": "eslint . --cache"
+    "lint:code": "eslint src/ --cache",
+    "lint": "yarn lint:code && yarn lint:test",
+    "lint:test": "eslint test/ --cache"
   },
   "files": [
     "LICENSE",
     "README.md",
-    "cjs/",
-    "es/",
-    "lib/"
+    "build"
   ],
   "publishConfig": {
     "access": "public"
   },
   "devDependencies": {
-    "@babel/eslint-parser": "7.28.6",
-    "@babel/plugin-syntax-import-assertions": "^7.27.1",
+    "@eslint/js": "9.39.4",
     "@lexical/headless": "0.13.1",
     "@lexical/html": "0.13.1",
     "@prettier/sync": "^0.6.0",
-    "@rollup/plugin-babel": "7.0.0",
+    "@types/jsdom": "^21.1.7",
+    "@types/lodash": "^4.17.24",
+    "@types/luxon": "^3.6.2",
+    "@types/mocha": "10.0.10",
+    "@types/node": "24.12.0",
+    "@types/should": "^13.0.0",
+    "@types/sinon": "21.0.0",
     "c8": "11.0.0",
     "html-minifier": "^4.0.0",
     "mocha": "11.7.5",
     "prettier": "3.8.1",
-    "rollup": "4.59.0",
-    "rollup-plugin-svg": "2.0.0",
     "should": "13.2.3",
-    "sinon": "21.0.3"
+    "sinon": "21.0.3",
+    "tsx": "4.21.0",
+    "typescript": "5.8.3",
+    "typescript-eslint": "8.57.0"
   },
   "dependencies": {
     "@lexical/clipboard": "0.13.1",

packages/kg-default-nodes/package.json

@@ -0,0 +1,13 @@
+/* c8 ignore start */
+import {DecoratorNode} from 'lexical';
+
+export class KoenigDecoratorNode extends DecoratorNode<unknown> {
+    decorate(): unknown {
+        return null;
+    }
+}
+
+export function $isKoenigCard(node: unknown): node is KoenigDecoratorNode {
+    return node instanceof KoenigDecoratorNode;
+}
+/* c8 ignore end */