chore: include TypeScript declaration file

Author: MathiasVDA

.github/workflows/publish.yml

@@ -36,5 +36,19 @@ jobs:
           TAG_VERSION=${TAG_VERSION#v}
           npm version $TAG_VERSION --no-git-tag-version --allow-same-version
 
+      - name: Check if version already published
+        id: check
+        run: |
+          PACKAGE_NAME=$(node -p "require('./package.json').name")
+          VERSION=$(node -p "require('./package.json').version")
+          if npm view "$PACKAGE_NAME@$VERSION" version 2>/dev/null; then
+            echo "Version $VERSION already published, skipping"
+            echo "skip=true" >> $GITHUB_OUTPUT
+          else
+            echo "Version $VERSION not published yet"
+            echo "skip=false" >> $GITHUB_OUTPUT
+          fi
+
       - name: Publish to npm
+        if: steps.check.outputs.skip != 'true'
         run: npm publish --provenance --access public

esbuild.config.js

@@ -1,4 +1,6 @@
 const esbuild = require('esbuild');
+const fs = require('fs');
+const path = require('path');
 
 // Build configurations for different module formats
 const builds = [
@@ -47,13 +49,73 @@ const builds = [
   },
 ];
 
+// TypeScript declaration content
+const typeDeclaration = `// Type definitions for @matdata/yasgui-graph-plugin
+// Project: https://github.com/Matdata-eu/yasgui-graph-plugin
+
+declare module '@matdata/yasgui-graph-plugin' {
+  import type { default as Yasr } from '@zazuko/yasgui/build/ts/yasr';
+
+  /**
+   * YASGUI plugin for visualizing SPARQL CONSTRUCT and DESCRIBE query results as interactive graphs
+   */
+  export default class GraphPlugin {
+    /**
+     * Creates a new GraphPlugin instance
+     * @param yasr - The YASR instance
+     */
+    constructor(yasr: typeof Yasr);
+
+    /**
+     * Plugin priority (higher = shown first in tabs)
+     */
+    static get priority(): number;
+
+    /**
+     * Plugin label for tab display
+     */
+    static get label(): string;
+
+    /**
+     * Check if plugin can handle the current results
+     * @returns True if results are from CONSTRUCT or DESCRIBE query
+     */
+    canHandleResults(): boolean;
+
+    /**
+     * Render the graph visualization
+     */
+    draw(): void;
+
+    /**
+     * Download the current visualization as PNG
+     */
+    download(): void;
+
+    /**
+     * Get vis-network configuration options
+     * @returns Network options for vis-network
+     */
+    getNetworkOptions(): any;
+  }
+}
+`;
+
 // Build all formats
 Promise.all(builds.map(config => esbuild.build(config)))
   .then(() => {
+    // Create TypeScript declaration file
+    const distDir = path.join(__dirname, 'dist');
+    if (!fs.existsSync(distDir)) {
+      fs.mkdirSync(distDir, { recursive: true });
+    }
+    fs.writeFileSync(path.join(distDir, 'index.d.ts'), typeDeclaration);
+    
     console.log('✅ Build complete:');
     console.log('   - dist/yasgui-graph-plugin.esm.js (ES Module for bundlers)');
     console.log('   - dist/yasgui-graph-plugin.cjs.js (CommonJS for Node.js)');
     console.log('   - dist/yasgui-graph-plugin.min.js (IIFE for browsers/unpkg)');
+    console.log('   - dist/index.d.ts (TypeScript declarations)');
   })
   .catch((err) => {
     console.error('❌ Build failed:', err);

package.json

@@ -6,6 +6,7 @@
   "main": "dist/yasgui-graph-plugin.cjs.js",
   "module": "dist/yasgui-graph-plugin.esm.js",
   "unpkg": "dist/yasgui-graph-plugin.min.js",
+  "types": "dist/index.d.ts",
   "files": [
     "dist",
     "README.md",