feat(ts): add TypeScript typings and type-check tests

.config/prettierignore

@@ -1,10 +1,11 @@
 .config
-.github
-.vscode
-docs
-es6
-js-legacy
-node_modules
-screenshots
-LICENSE
-package-lock.json
+../.github
+../.vscode
+../docs
+../es6
+../js-legacy
+../node_modules
+../screenshots
+../LICENSE
+../package-lock.json
+../types/generated

.config/rollup.config.js

@@ -25,13 +25,15 @@ export default [
     {
         input: 'src/plugins/jsmind.draggable-node.js',
         output: {
+            name: 'jsMindDraggableNode',
             file: 'es6/jsmind.draggable-node.js',
             format: 'umd',
             banner: '/**\n* @license BSD-3-Clause\n* @copyright 2014-2025 hizzgdev@163.com\n*\n* Project Home:\n*   https://github.com/hizzgdev/jsmind/\n*/',
             sourcemap: true,
             globals: {
                 jsmind: 'jsMind',
             },
+            exports: 'named',
         },
         external: ['jsmind'],
         plugins: [
@@ -48,6 +50,7 @@ export default [
     {
         input: 'src/plugins/jsmind.screenshot.js',
         output: {
+            name: 'jsMindScreenshot',
             file: 'es6/jsmind.screenshot.js',
             format: 'umd',
             banner: '/**\n* @license BSD-3-Clause\n* @copyright 2014-2025 hizzgdev@163.com\n*\n* Project Home:\n*   https://github.com/hizzgdev/jsmind/\n*/',
@@ -56,6 +59,7 @@ export default [
                 'jsmind': 'jsMind',
                 'dom-to-image': 'domtoimage',
             },
+            exports: 'named',
         },
         external: ['jsmind', 'dom-to-image'],
         plugins: [

.github/workflows/npm-publish.yml

@@ -15,7 +15,7 @@ jobs:
       - uses: actions/setup-node@v3
         with:
           node-version: 18.x
-      - run: npm ci
+      - run: npm ci && npm run gen:dts:check
       - run: npm test
 
   publish-npm:
@@ -28,7 +28,7 @@ jobs:
           node-version: 18.x
           registry-url: https://registry.npmjs.org/
       - run: npm ci
-      - run: npm run build
+      - run: npm run gen:dts && npm run build
       - run: npm publish
         env:
           NODE_AUTH_TOKEN: ${{secrets.npm_token}}

.gitignore

@@ -2,3 +2,4 @@
 node_modules/
 es6/*.js
 es6/*.js.map
+types/generated/

CHANGELOG.md

@@ -0,0 +1,40 @@
+## Changelog / 变更日志
+
+### 2025-08-10
+
+-   Added
+
+    -   Central typings entry `types/index.d.ts` and regenerated declaration files under `types/generated/` for core and plugins (dom, format, graph, layout_provider, mind, node, option, plugin, shortcut_provider, util, view_provider, draggable-node, screenshot).
+    -   Declaration build config `tsconfig.decls.json` and npm scripts: `gen:dts`, `gen:dts:check`.
+    -   TypeScript typings validation: `tests/unit/typescript.types.test.js` with fixture `tests/fixtures/typescript-test.ts` using TypeScript Compiler API.
+
+-   Changed
+
+    -   Updated `package.json` to expose `types` via `types/index.d.ts` and added scripts for generating/checking declarations.
+    -   Enriched JSDoc and in-source documentation across core modules and plugins to improve generated typings (data_provider, dom, format, graph, layout_provider, mind, node, option, plugin, util, view_provider, draggable-node, screenshot).
+    -   Updated `tsconfig.json` strictness and paths; CI updated to run `npm run gen:dts` before build and include `gen:dts:check` in install pipeline.
+    -   Dev dependencies refreshed, adding `typescript`, `tsd-jsdoc`, and updating various `@types/*`, jest, jsdoc toolchain packages.
+
+-   Removed
+
+    -   Legacy type files under `types/` (`jsmind.d.ts`, `jsmind.draggable-node.d.ts`, `jsmind.screenshot.d.ts`) in favor of `types/generated/`.
+
+-   Notes
+
+    -   Running `npm test` now validates both runtime tests and TypeScript definitions. Consumers can rely on the aggregated public typings from the package root; plugin typings are exposed under `plugins/` paths.
+
+### 2025-08-09
+
+-   Added
+
+    -   TypeScript support: publish `.d.ts` for core and plugins (`es6/jsmind.d.ts`, `es6/jsmind.draggable-node.d.ts`, `es6/jsmind.screenshot.d.ts`).
+    -   Type checking in CI: added Jest test `tests/unit/typescript.types.test.js` using TypeScript Compiler API to verify typings with `tsconfig.json` (noEmit).
+
+-   Changed
+
+    -   Updated root `package.json` to expose `types` and proper `exports` fields for typings.
+
+-   Notes
+
+    -   The TS example `example/typescript-test.ts` is included in `tsconfig.json#includes` for compile-time verification.
+    -   Running `npm test` will now validate TypeScript definitions.