doc: also explain the possibility to use this plugin with DESCRIBE queries

Author: MathiasVDA

README.md

@@ -3,7 +3,7 @@
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![npm version](https://img.shields.io/npm/v/yasgui-graph-plugin.svg)](https://www.npmjs.com/package/yasgui-graph-plugin)
 
-A YASGUI plugin for visualizing SPARQL CONSTRUCT query results as interactive graphs with nodes (subjects/objects) and edges (predicates).
+A YASGUI plugin for visualizing SPARQL CONSTRUCT and DESCRIBE query results as interactive graphs with nodes (subjects/objects) and edges (predicates).
 
 ## ✨ Features
 
@@ -66,8 +66,9 @@ const yasgui = new Yasgui(document.getElementById('yasgui'), {
 });
 ```
 
-### Sample CONSTRUCT Query
+### Sample Queries
 
+**CONSTRUCT Query:**
 ```sparql
 PREFIX ex: <http://example.org/>
 PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
@@ -82,6 +83,14 @@ CONSTRUCT {
 WHERE {}
 ```
 
+**DESCRIBE Query:**
+```sparql
+PREFIX ex: <http://example.org/>
+
+# Returns all triples about the specified resources
+DESCRIBE ex:Alice ex:Bob
+```
+
 After running the query, click the **"Graph"** tab to see the visualization.
 
 ## 🎮 User Guide

demo/index.html

@@ -111,8 +111,8 @@ <h2 onclick="toggleInstructions()">
     </h2>
     <div class="instructions-content collapsed">
       <ul>
-        <li>Click the <strong>"Graph"</strong> tab after running a CONSTRUCT query</li>
-        <li><strong>Sample queries</strong> are pre-loaded (see tabs: Basic, Ontology, Blank Nodes, Multiple Edges)</li>
+        <li>Click the <strong>"Graph"</strong> tab after running a CONSTRUCT or DESCRIBE query</li>
+        <li><strong>Sample queries</strong> are pre-loaded (see tabs: Basic, Ontology, Blank Nodes, Multiple Edges, DESCRIBE)</li>
         <li><strong>Navigate</strong>: Mouse wheel to zoom, drag background to pan, click "Zoom to Fit" button</li>
         <li><strong>Reorganize</strong>: Drag individual nodes to rearrange the layout</li>
         <li><strong>Inspect</strong>: Hover over nodes/edges to see full details (300ms delay)</li>
@@ -225,7 +225,7 @@ <h2 onclick="toggleInstructions()">
         getOriginalResponseAsString: () => '',
         getOriginalResponse: () => null,
         getError: () => null,
-        getContentType: () => 'application/sparql-results+json'
+        getContentType: () => 'text/turtle'
       };
     }
 
@@ -234,7 +234,8 @@ <h2 onclick="toggleInstructions()">
       { name: 'Basic Graph', query: queries.basic },
       { name: 'Ontology', query: queries.ontology },
       { name: 'Blank Nodes', query: queries.blankNodes },
-      { name: 'Multiple Edges', query: queries.multiplePredicates }
+      { name: 'Multiple Edges', query: queries.multiplePredicates },
+      { name: 'DESCRIBE Query', query: queries.describe }
     ];
 
     // Clear default tab

demo/queries.js

@@ -56,5 +56,12 @@ CONSTRUCT {
   ex:Person2 ex:knows ex:Person3 .
   ex:Person3 ex:knows ex:Person1 .
 }
-WHERE {}`
+WHERE {}`,
+
+  describe: `PREFIX ex: <http://example.org/>
+PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
+PREFIX foaf: <http://xmlns.com/foaf/0.1/>
+
+# DESCRIBE returns all triples about a resource
+DESCRIBE ex:Alice ex:Bob`
 };

package-lock.json

@@ -2,7 +2,7 @@
   "name": "@matdata/yasgui-graph-plugin",
   "private": false,
   "version": "0.1.0",
-  "description": "YASGUI plugin for visualizing SPARQL CONSTRUCT query results as interactive graphs",
+  "description": "YASGUI plugin for visualizing SPARQL CONSTRUCT and DESCRIBE query results as interactive graphs",
   "main": "dist/yasgui-graph-plugin.min.js",
   "scripts": {
     "dev": "vite",

package.json

@@ -7,7 +7,7 @@
 
 ## Summary
 
-**Primary Requirement**: Create a YASGUI plugin that visualizes SPARQL CONSTRUCT query results as interactive graphs with nodes (subjects/objects) and edges (predicates), supporting zoom, drag, tooltips and color coding by node type.
+**Primary Requirement**: Create a YASGUI plugin that visualizes SPARQL CONSTRUCT and DESCRIBE query results as interactive graphs with nodes (subjects/objects) and edges (predicates), supporting zoom, drag, tooltips and color coding by node type.
 
 **Technical Approach**: Implement a YASR plugin class following the yasgui-geo pattern (constructor, canHandleResults, draw, getIcon methods) using vis-network v9.x for graph rendering. Parse RDF triples from bindings format, transform to vis-network DataSets with color-coded nodes (grey literals, green rdf:type objects, blue other URIs), apply prefix abbreviation, and leverage vis-network's built-in force-directed layout and interaction. Build with esbuild to UMD format for `Yasgui.Yasr.registerPlugin()` registration.
 

specs/001-construct-graph-viz/plan.md

@@ -66,7 +66,7 @@ const yasgui = new Yasgui(document.getElementById('yasgui'), {
 
 ## Basic Usage
 
-### 1. Execute CONSTRUCT Query
+### 1. Execute CONSTRUCT or DESCRIBE Query
 
 The plugin automatically activates for SPARQL CONSTRUCT queries that return triples:
 

specs/001-construct-graph-viz/quickstart.md

@@ -3,7 +3,7 @@
 **Feature Branch**: `001-construct-graph-viz`  
 **Created**: 2025-12-05  
 **Status**: Draft  
-**Input**: User description: "Visualize SPARQL CONSTRUCT query results as interactive graphs with nodes (subjects/objects) and edges (predicates), supporting zoom, drag, tooltips and color coding"
+**Input**: User description: "Visualize SPARQL CONSTRUCT and DESCRIBE query results as interactive graphs with nodes (subjects/objects) and edges (predicates), supporting zoom, drag, tooltips and color coding"
 
 ## Clarifications
 
@@ -105,7 +105,7 @@ While exploring the graph, the user wants to see detailed information about node
 
 #### Data Parsing & Graph Construction
 
-- **FR-001**: Plugin MUST detect when YASR receives CONSTRUCT query results (as opposed to SELECT/ASK/DESCRIBE)
+- **FR-001**: Plugin MUST detect when YASR receives CONSTRUCT or DESCRIBE query results (as opposed to SELECT/ASK)
 - **FR-002**: Plugin MUST parse RDF triples from SPARQL results and extract subject, predicate, object for each triple
 - **FR-003**: Plugin MUST create graph nodes for all unique subjects and objects appearing in triples
 - **FR-004**: Plugin MUST create graph edges for predicates connecting subject nodes to object nodes

specs/001-construct-graph-viz/spec.md

@@ -39,7 +39,7 @@
 - [X] T010 [P] Implement getNodeColor(node, triples) in src/colorUtils.js to determine color: #FFFF00 (blank nodes), #808080 (literals), #00FF00 (rdf:type objects), #0000FF (other URIs)
 - [X] T011 [P] Implement getDefaultNetworkOptions() in src/networkConfig.js returning vis-network config: physics enabled with 200 max iterations, interactions (drag/zoom/pan/hover), autoResize, 100% width/height
 - [X] T012 Create GraphPlugin class skeleton in src/GraphPlugin.js with constructor(yasr), priority=20, label='Graph', and placeholder methods: canHandleResults(), draw(), getIcon()
-- [X] T013 Implement GraphPlugin.canHandleResults() to detect CONSTRUCT results by checking for subject/predicate/object variables in this.yasr.results
+- [X] T013 Implement GraphPlugin.canHandleResults() to detect CONSTRUCT and DESCRIBE results by checking for subject/predicate/object variables in this.yasr.results
 - [X] T014 Implement GraphPlugin.getIcon() to return Font Awesome icon element (fa-project-diagram) for YASR tab
 - [X] T015 Export GraphPlugin and auto-register with Yasgui.Yasr.registerPlugin('graph', GraphPlugin) in src/index.js (UMD compatibility)
 

specs/001-construct-graph-viz/tasks.md

@@ -37,7 +37,7 @@ class GraphPlugin {
 
   /**
    * Check if plugin can handle the current results
-   * @returns {boolean} True if results are from CONSTRUCT query
+   * @returns {boolean} True if results are from CONSTRUCT or DESCRIBE query
    */
   canHandleResults() {
     if (!this.yasr || !this.yasr.results) return false;
@@ -49,7 +49,7 @@ class GraphPlugin {
       const bindings = results.getBindings();
       if (bindings && bindings.length > 0) {
         const firstBinding = bindings[0];
-        // CONSTRUCT results have subject, predicate, object variables
+        // CONSTRUCT and DESCRIBE results have subject, predicate, object variables
         return (
           firstBinding.subject !== undefined &&
           firstBinding.predicate !== undefined &&